remote-jobs 公司档案实战：Olo 远程工作数据画像与 Eleventy 渲染链路解析

• 数据集

在社区维护的远程友好技术公司目录 remote-jobs（即 Remote In Tech 站点源码）中，每一家公司都以一份结构化的 Markdown 档案存在。Olo 的公司档案是这类档案的标准范本之一：它既包含可被站点自动渲染的 frontmatter 元数据（远程政策、地区、规模、技术栈），也包含供读者直接阅读的 Markdown 正文（公司简介、远程状态、申请方式）。阅读本文后，你将掌握如何读懂并校验一份公司档案的数据字段、了解这些字段在 Eleventy 构建管线中的渲染链路，以及如何基于同一模板沉淀新的远程公司条目。

档案结构总览：frontmatter 元数据 + 正文段落

Olo 档案采用 remote-jobs 全仓库统一的公司档案格式：文件头部是 YAML frontmatter，负责承载机器可读的结构化数据；---分隔线之后是 Markdown 正文，承载人类可读的详细说明。该格式的规范定义见 CONTRIBUTING.md。

Olo 档案的完整 frontmatter 如下（原文照录）：

--- title: "Olo" slug: olo website: https://www.olo.com/ region: americas remote_policy: remote-friendly company_size: medium technologies: - cloud - dotnet - javascript - search - sql addedAt: 2017-09-18 updatedAt: 2018-04-16 ---

其中各个字段的含义、取值与展示标签可对照下表理解：

值得注意的一致性：company_size: medium在 labels.js 中定义为51-200 employees，而档案正文声明员工数为 100-150 人，两者完全吻合；technologies字段是标签化后的精简集合，而正文的 "Company technologies" 小节则给出了更完整的真实技术栈细节，二者互补而非重复。

公司画像正文：一份远程友好型餐饮数字化公司的完整记录

Olo 档案正文包含六个小节，覆盖了 CONTRIBUTING.md 要求的全部必备小节（## Company blurb、## Remote status、## How to apply），并补充了规模、区域、技术栈与办公地信息。以下按原文完整还原并逐节解读：

Company blurb：公司定位与使命

Reliable, fast, and secure digital ordering solutions for multi-location restaurants. Our mission, the same as it was when we started in 2005: give customers better, faster, and more personal service from the restaurants they love.

Olo 的核心业务是为多门店（multi-location）连锁餐饮企业提供可靠、快速、安全的数字化点单解决方案。值得注意的是，档案以一句话点明公司自 2005 年成立以来的使命未变，这一"2005 年至今"的时间锚点说明 Olo 是一家在餐饮科技赛道深耕多年的公司。

这一小节在构建管线中还有一层特殊作用：根据 companies.11tydata.js 的eleventyComputed逻辑，站点会自动从## Company blurb小节提取正文、清洗掉 Markdown 语法，并截断到约 155 字符，作为该公司页面的 meta description，供搜索引擎摘要使用。

Company size：规模与远程占比

100-150 employees. 47% of which (as of Fall 2017) are remote.

档案记录了 Olo 员工总数在 100-150 人之间，其中 47%（截至 2017 年秋季的数据）为远程员工——这正是company_size: medium（51-200 人）这一档位的依据来源。

Remote status：工程团队的高度远程化

With over 65% of our engineering staff remote, we've evolved into a culture that is flexible, hard-working, and dedicated to becoming a more effective distributed team. See our culture map for a more detailed view of our company values.

正文明确指出 Olo 超过 65% 的工程岗位为远程，并强调公司已经由此演进出一种灵活、勤奋、致力于打造更高效分布式团队的文化。全公司 47% 与工程团队 65%+ 这两组数据并列，勾勒出"公司整体远程友好、工程部门高度分布式"的画像，这也是其被标记为remote-friendly（远程友好，而非 fully-remote 完全远程）的实证依据。

Region、Company technologies 与 Office locations

## Region USA ## Company technologies Primarily .NET stack. C#, F#, SQL, Elasticsearch, node.js, Ember, React, AWS. ## Office locations NYC

这三小节补充了关键地理与技术信息：

• 区域：总部位于美国（frontmatter 中以region: americas归类）；
• 技术栈：以 .NET 生态为主——C#、F#、SQL、Elasticsearch、node.js、Ember、React、AWS。这也解释了 frontmatter 中technologies标签为何包含dotnet、sql、search（对应 Elasticsearch）、javascript（对应 node.js/Ember/React）与cloud（对应 AWS）；
• 办公地点：纽约（NYC），与"远程友好 + 美国区域"的定位一致——公司有实体办公室，但允许员工远程协作。

How to apply：申请入口

## How to apply Current Job postings will be displayed at https://www.olo.com/company/#careers.

档案将应聘指引指向官网公司页面的#careers锚点，即求职者需到 Olo 官网的 careers 区域查看最新在招职位。这一小节是 CONTRIBUTING.md 规定的必备小节，保证了每份档案对求职者都有直接可执行的下一步动作。

从数据到页面：公司档案的 Eleventy 渲染链路

Olo 这份档案之所以能以结构化的方式展示，依赖仓库中一整套构建配置。理解这条链路，就能明白每个字段最终如何变成页面上的元素。

1. 布局绑定：companies.json 中定义了{ "layout": "company" }，因此src/companies/*.md下的所有档案统一使用 company.njk 作为布局模板。
2. 标签渲染：在 company.njk 中，region与remote_policy字段被渲染为可点击的筛选标签（/browse/americas/、/browse/remote-friendly/），technologies数组被渲染为 "Tech Stack" 小节下的一组技术标签（如/browse/dotnet/、/browse/sql/），每个标签的展示文案由 labels.js 中的映射表提供。这意味着读者可以从任意一家公司档案一键跳转到同区域、同远程政策、同技术栈的公司列表。
3. 结构化数据：Organization.njk 利用title、website字段输出 schema.org 的OrganizationJSON-LD 结构化数据，帮助搜索引擎更准确地理解该页面的实体信息。
4. 集合聚合：collections.js 通过getFilteredByGlob('./src/companies/**/*.md')收集全部档案，并按title排序生成公司目录；addedAt字段则驱动 "Recently added" 集合，region与technologies驱动按区域、按技术栈的分组浏览页。
5. 更新足迹：页面页脚通过updatedAt字段展示 "Last updated" 日期，company.njk 中还提供了指向 GitHub 的 "Edit on GitHub" 入口，便于社区成员修正档案中的过时信息。

数据时效性：一份"历史档案"的合理读法

Olo 档案的addedAt为 2017-09-18、updatedAt为 2018-04-16，正文中的远程占比（47%、65%+）也明确标注了"as of Fall 2017"的时间口径。也就是说，这份档案反映的是 2017-2018 年间的公司状态，阅读时应将其视为历史时点快照而非当下数据。这正是该目录的社区维护属性决定的：档案的质量取决于维护者的更新节奏。仓库为此提供了一套链接维护流水线（见 scripts/README.md）：check-links.sh会扫描src/companies/*.md中全部出站 URL 并记录 HTTP 状态到link-check-results.csv，fix-links.mjs则对失效链接进行分类（如CAREERS_DEAD、NOT_FOUND、REBRAND等）并生成修复计划，以此缓解档案随时间的腐化。

如何基于同一模板沉淀新档案

如果你希望为一家远程友好的技术公司创建档案，CONTRIBUTING.md 提供了明确的模板与校验规则，Olo 档案正是该模板的合规实例：

--- title: "Example Co" slug: example-co website: https://example.com careers_url: https://example.com/careers region: worldwide remote_policy: fully-remote company_size: small technologies: - javascript - python ---

实操步骤为：在src/companies/{slug}.md新建文件（slug必须与文件名一致）→ 填写 frontmatter 与正文（正文必须包含## Company blurb、## Remote status、## How to apply三个必备小节）→ 运行npm run build（见 README.md，需要 Node.js 22+）验证构建 → 提交 PR。字段取值有严格白名单：region可选worldwide/americas/europe/americas-europe/asia-pacific/other；remote_policy可选fully-remote/remote-first/hybrid/remote-friendly；company_size分tiny（1-10）/small（11-50）/medium（51-200）/large（201-1000）/enterprise（1000+）五档。addedAt与updatedAt由维护者管理，贡献者无需填写。

小结

Olo 档案是理解 remote-jobs 目录体系的一个完整样本：frontmatter 提供了可被筛选、聚合、自动生成 meta description 与 JSON-LD 结构化数据的机器字段，正文则以"公司简介—远程状态—申请方式"的固定骨架承载人类可读的细节，二者经 company.njk、labels.js、companies.11tydata.js 等构建组件协同渲染，最终形成远程求职者可直接浏览与跳转的公司页面。对于研究远程工作数据或希望贡献新档案的读者，这份档案既是一份数据样本，也是一份格式范本。

• 数据集