解读 Remote In Tech 远程友好公司档案：以 Novoda 的混合远程实践为范例

本篇技术指南以开源仓库 remote-jobs（remoteintech.company 站点源码）中的 Novoda 公司档案 为核心样本，系统讲解社区维护型远程工作目录中"一份公司档案"从 Markdown 编写、frontmatter 元数据定义，到被 Eleventy 渲染为可浏览公司页面的完整链路。读者将掌握该目录中公司档案的字段规范、远程政策与地区标签的取值语义，以及档案数据如何被站点用于分类浏览、搜索与 SEO 元描述生成。

档案概览：frontmatter 元数据层

每一份公司档案都位于 src/companies/{slug}.md，其中 {slug} 必须与 frontmatter 中的 slug 值一致（例如 slug: novoda 对应文件 src/companies/novoda.md）。Novoda 档案的开头定义了站点消费所需的全部元数据：

---
title: "Novoda"
slug: novoda
website: https://www.novoda.com/
region: europe
remote_policy: hybrid
company_size: enterprise
technologies:
  - mobile
addedAt: 2016-05-02
updatedAt: 2022-10-03
---

对照 CONTRIBUTING.md 中的提交模板与合法取值表，可以逐字段理解其语义：

字段	Novoda 取值	合法取值（来自 CONTRIBUTING.md）
region	europe	worldwide、americas、europe、americas-europe、asia-pacific、other
remote_policy	hybrid	fully-remote、remote-first、hybrid、remote-friendly
company_size	enterprise	tiny（1-10）、small（11-50）、medium（51-200）、large（201-1000）、enterprise（1000+）
technologies	mobile	javascript、react、python、go、mobile、data、ml 等 25 个枚举值

addedAt 与 updatedAt 由维护者管理，贡献者在 PR 中不应自行包含。Novoda 档案的 addedAt: 2016-05-02 表明它自目录早期（2016 年）即被收录，updatedAt: 2022-10-03 记录最近一次信息核验时间。

Company blurb：公司简介与自动 SEO 元描述

正文第一个必需章节是 ## Company blurb，CONTRIBUTING.md 要求所有档案必须包含该章节。Novoda 的简介为：

Novoda is an independent, fast-paced, high-growth company. We’re a closely-knit family from diverse disciplines and believe software enables a human, interconnected future. Proudly, we provide great clients with amazing technologies to better serve their customers.

这段简介不只是展示在公司页面顶部，还会被站点自动加工为 SEO meta description。在 src/companies/companies.11tydata.js 中，eleventyComputed.description 会通过正则 ##\s*Company\s*blurb\s*\n+([\s\S]*?)... 抓取 blurb 文本，随后依次去除 Markdown 链接语法、星号/下划线/反引号，将换行与连续空格折叠为单个空格，并截断到约 155 字符（优先在句号或空格处断句，不足时以 ... 结尾）。这意味着：写档案时，## Company blurb 段落的质量直接决定了该页面在搜索引擎中的元描述质量——Novoda 档案没有显式设置 description 字段，因此其简介会被原样用于生成元描述。

Company size 与 company_size：正文与字段的两种呈现

Novoda 档案在正文中写有 ## Company size，内容为 "Small Enterprise"（小型企业级团队），而 frontmatter 中 company_size: enterprise 对应的展示文案在 src/_data/labels.js 中定义为 'enterprise': '1000+ employees'。二者在页面上以不同途径呈现：正文段落原样渲染在内容区，而 frontmatter 字段主要服务于标签与分类逻辑（由 src/_data/companyHelpers.js 的 getCompanySizeLabel 解析）。这种"正文叙述 + 字段枚举"的双轨结构是该目录档案的通用写法——正文用于人性化叙述，字段用于结构化数据消费。

Remote status：混合远程政策（hybrid）的档案化表达

## Remote status 同样是必需章节，它描述了公司的远程工作方式。Novoda 的远程政策原文：

All employees are allowed to work remotely as they desire or when needed. We also have people working remotely full time. New employees have to work an experience-dependent minimum amount of time from an onsite office before full remote will be considered.

We use hangouts for all meetings and other tools like Slack, Basecamp, and Google communities. All work is documented online to really enable remote developers to work to the best of their abilities.

这段文字体现了 hybrid 政策的核心特征：全员可按需远程、有全职远程员工，但新员工需先在线下办公室工作一段"依经验而定"的时间，方可转为完全远程——这正是"混合办公"与"全远程"（fully-remote）的关键区别。同时它披露了远程协作的具体工具栈（Hangouts 会议、Slack、Basecamp、Google 社区）以及"所有工作在线文档化"这一支撑远程开发的关键实践。

在数据层，remote_policy: hybrid 会被 src/_layouts/company.njk 渲染为一个指向 /browse/hybrid/ 的标签，标签文案来自 labels.js 的 remotePolicy 映射（'hybrid': 'Hybrid'），颜色样式对应 tag--policy。求职者浏览 /browse/hybrid/ 即可聚合所有采用混合远程政策的公司。

Region 与办公室分布：地区标签与集合分组

frontmatter 的 region: europe 经 labels.js 映射为 "Europe"，并在页面头部渲染为 tag--region 样式的地区标签，链接到 /browse/europe/。正文的 ## Region 与 ## Office locations 章节则给出更详细的地理信息：

We have offices in Barcelona, Berlin, Liverpool, and London, with remote workers in Europe.

即公司拥有巴塞罗那、柏林、利物浦、伦敦四个办公室，远程员工分布于欧洲各地——这与 region: europe 的枚举值一致，说明"地区"字段描述的是招聘/办公的地理范围，而非单一总部所在地。

地区字段在站点层面的消费逻辑位于 src/_config/collections.js：getCompaniesByRegion 遍历全部公司档案，将 region 字段（缺失时回退为 other）作为分组键构建"地区 → 公司列表"的映射；getCompanyTags 则同时为 technology、region、remote-policy 三类维度生成带计数（count）与公司列表的标签数据，供 /browse/ 页面使用。

Company technologies：技术标签与浏览入口

正文 ## Company technologies 的内容为 "Android, iOS, and anything mobile."，frontmatter 中以枚举值 mobile 表达。在 src/_layouts/company.njk 中，technologies 数组会被渲染为独立的 Tech Stack 章节：

{% if technologies and technologies.length > 0 %}
  <section class="company-profile__tech">
    <h2>Tech Stack</h2>
    {% for tech in technologies %}
      <a href="/browse/{{ tech }}/" class="tag tag--tech">{{ labels.tech[tech] or tech }}</a>
    {% endfor %}
  </section>
{% endif %}

mobile 经 labels.js 映射为 "Mobile"，链接到 /browse/mobile/。集合层 collections.js 的 getCompaniesByTech 会把所有声明了 mobile 的公司聚合到同一技术分组，getAllCompanies 则负责按标题字母序生成完整公司列表。因此，求职者按技术栈浏览时，能快速找到 Novoda 这类以 Android/iOS 移动端开发为核心的公司。

公司页面的完整渲染链路

综合来看，一份 Novoda 档案从源码到页面的链路如下：

1. companies.json 为该目录下所有档案指定 layout: company；
2. companies.11tydata.js 计算未显式设置的 description（SEO 元描述）；
3. company.njk 渲染页面：标题区展示公司名与"Visit Website"按钮（website 字段）、地区/政策标签、Tech Stack 章节，页脚展示 updatedAt 格式化后的"Last updated"日期（由 formatDate 过滤器格式化为如 "October 3, 2022"）；
4. collections.js 将档案纳入按字母排序的公司集合、按地区/技术分组、按 addedAt 排序的最近新增集合，以及标签聚合数据；
5. 运行 npm run build 生成静态站点（Node.js 22+ 环境，参见 README.md）。

页面头部按钮优先取 careers_url，未设置时才回退到 website——Novoda 档案仅声明了 website，因此按钮文案为 "Visit Website"，指向 https://www.novoda.com/。

How to apply：申请流程的档案化约定

最后一个必需章节是 ## How to apply，Novoda 的写法是：

Work with us. We could be perfect for each other.

Meaningful work and caring people are the main ingredients for creating the best software on the planet. We’d love for you to help us craft truly exceptional digital experiences.

https://www.novoda.com/hiring

CONTRIBUTING.md 规定该章节必须包含招聘页面链接或申请说明，并额外要求 careers_url 必须指向公司自己的招聘页，而不是销售服务的页面。注意 Novoda 档案把招聘链接直接写进了正文 Markdown，而非放在 frontmatter 的 careers_url 字段——这是档案中可以接受的写法，但若维护者希望页面按钮直接显示 "Apply Now"，则应将招聘链接提升为 careers_url 字段（参见 CONTRIBUTING.md 中的 frontmatter 模板）。

从单份档案看社区目录的维护模式

通过 Novoda 这一样本可以总结该仓库的公司档案规范：

• 结构约束：正文必须包含 ## Company blurb、## Remote status、## How to apply 三个章节，## Company size、## Region、## Company technologies 可选但常用；
• 枚举约束：region、remote_policy、company_size、technologies 必须使用 labels.js 与 CONTRIBUTING.md 中定义的合法取值，否则无法被标签与浏览页面正确聚合；
• 验证机制：涉及公司档案的 PR 会由 "Validate Company Profiles" 自动化检查（CONTRIBUTING.md），格式不符会被拦截；
• 信息真实性：目录仅收录"半远程至全远程"的技术相关公司，要求提交者能核实信息，且公司必须提供真实的远程岗位。

对求职者而言，阅读这类档案时应同时关注三处：frontmatter 中的 remote_policy（判断远程灵活度）、## Remote status 正文（判断入职初期的驻场要求等细节）、以及 ## How to apply（获取官方申请入口）；对开发者而言，src/companies/ 下每一份 .md 档案都是理解该目录数据模型的最小单元，companies.11tydata.js、company.njk、collections.js 三者共同定义了这些档案的完整生命周期。