Netris 公司档案深度解析：Remote In Tech 目录中远程友好公司数据模型的完整实践

本文以 Netris 公司档案 为实例，完整拆解 Remote In Tech（remoteintech.company）开源仓库中「远程友好科技公司」档案的撰写规范、frontmatter 数据模型、站点渲染管线与标签聚合机制。读完本文，你将掌握如何阅读、校验并贡献一份符合社区标准的公司档案，理解一个 Markdown 文件如何被 Eleventy 构建成可被搜索引擎与结构化数据识别的公司页面。

档案全景：netris.md 的结构与定位

src/companies/netris.md 是仓库 800+ 公司档案中的标准样本之一，位于 src/companies/ 目录。它由两部分组成：文件顶部的 YAML frontmatter（机器可读的结构化元数据）与文件主体的 Markdown 章节（人类可读的描述内容）。

Netris 档案的 frontmatter 如下（节选自 src/companies/netris.md）：

---
title: "Netris"
slug: netris
website: https://www.netris.io
region: worldwide
remote_policy: hybrid
company_size: small
technologies:
  - linux
  - python
addedAt: 2021-06-16
updatedAt: 2023-04-11
---

该档案登记了一家总部位于美国、提供网络管理平台（Automatic NetOps，用于数据中心与边缘计算的基础设施部署简化）的公司，规模 20+ 人，支持混合办公、全球范围招聘。其技术栈覆盖 Linux、Python、C++、FRR（Free Range Routing）、SONiC、Cumulus Linux、DPDK、Switchdev、Mellanox、Edgecore 等网络基础设施技术。

frontmatter 字段详解：从 slug 到 remote_policy

仓库维护方在 CONTRIBUTING.md 中给出了完整的 frontmatter 模板与合法取值表，Netris 档案中的每个字段都可以对照校验：

字段	取值	Netris 实际值
title	公司显示名	Netris
slug	与文件名一致（{slug}.md）	netris
website	官网 URL	https://www.netris.io
region	worldwide / americas / europe / americas-europe / asia-pacific / other	worldwide
remote_policy	fully-remote / remote-first / hybrid / remote-friendly	hybrid
company_size	tiny(1-10) / small(11-50) / medium(51-200) / large(201-1000) / enterprise(1000+)	small（对应 20+ 员工）
technologies	枚举自 javascript/python/go/rust 等 24 项	linux、python
addedAt / updatedAt	维护者管理的时间戳	2021-06-16 / 2023-04-11

字段的合法取值并非散落在各档案中，而是由 src/_data/labels.js 集中定义——它是 region、remotePolicy、companySize、tech 四类标签的「单一事实来源」（single source of truth），JS 侧通过 companyHelpers.js 重新导出，模板侧通过全局数据级联以 labels.* 访问。例如 hybrid 映射为展示文案 Hybrid，small 映射为 11-50 employees，worldwide 映射为 Worldwide。这意味着档案中的枚举值一旦写错，页面会直接回退显示原始字符串，而不会自动纠错。

此外，src/companies/companies.json 为整个目录统一指定了布局 company，因此所有公司档案共享同一套渲染模板，无需在单个档案里重复声明。

正文章节规范：blurb、Remote status 与 How to apply

根据 CONTRIBUTING.md，档案正文必须包含三个 ## 标题，Netris 档案逐一遵守：

• ## Company blurb：一句话说明公司业务。Netris 描述为「开发并支持网络管理平台，提供 Automatic NetOps，简化数据中心与边缘计算环境的基础设施部署」。该段落不仅展示给访客，还会被自动提取为页面 meta description（见下节）。
• ## Remote status：Netris 写明「Work remotely from home or a local office」，即居家办公与本地办公室结合，与其 frontmatter 中的 hybrid 策略一致——正文与元数据互相印证。
• ## How to apply：Netris 指向其官方招聘页 https://www.netris.io/jobs/。仓库要求 careers_url 或申请链接必须指向公司自己的招聘页，而非外包或售卖服务的页面。

可选章节如 ## Company size（Netris 填写 20+）、## Region（Worldwide）、## Company technologies（完整列出 10 项网络技术）以及 ## Office locations（Santa Clara、New York City、Armenia 三地）也在 Netris 档案中得到充分使用，为求职者提供了多维度的决策信息。

从 Markdown 到页面：数据在站点中的流转链路

一份 netris.md 在构建时会经历完整的处理管线，理解这条链路有助于排查档案呈现问题：

1. meta description 自动生成：src/companies/companies.11tydata.js 通过 eleventyComputed 为每个公司页面计算 description。其逻辑是先正则匹配正文中 ## Company blurb 之后的文本，剥除 Markdown 链接、*/_/反引号等标记，压缩空白后截断到 155 字符（优先在句号边界截断），作为搜索引擎摘要。Netris 的 blurb 恰好落在 155 字符内，因此会完整呈现。只有当 data.description 已被显式设置时才跳过计算。

2. 布局渲染：src/_layouts/company.njk 是档案的统一呈现模板。它根据 frontmatter 生成主按钮——优先取 careers_url 显示 "Apply Now"，否则取 website 显示 "Visit Website"；region 与 remote_policy 被渲染为指向 /browse/{region}/、/browse/{remote_policy}/ 的标签链接；technologies 数组中的每一项都渲染为指向 /browse/{tech}/ 的技术标签。因此 Netris 页面会自动获得 Worldwide 区域标签、Hybrid 策略标签以及 Linux、Python 技术标签，用户可点击跳转到对应分类浏览页。

3. 结构化数据：公司页面的 <head> 会通过 src/_includes/schemas/Organization.njk 输出 application/ld+json 的 schema.org Organization 结构化数据，name 取自 title、url 取自 website，若存在 careers_url 还会写入 sameAs。这让搜索引擎能直接识别公司实体的名称与官网关系。

4. 集合聚合：src/_config/collections.js 是聚合层的核心——getAllCompanies 按标题字母序生成完整公司列表；getCompaniesByRegion 按 region 分组（键缺失时归入 other）；getCompaniesByTech 遍历每家公司的 technologies 数组归组；getRecentCompanies 按 addedAt 倒序取最近 12 家；getFeaturedCompanies 从 companyHelpers.js 的精选名单（automattic、stripe、netlify、github 等）中随机洗牌后取 8 家展示在首页。Netris 的 worldwide、linux、python 等字段正是通过这些集合被纳入分类浏览与标签页的。getCompanyTags 则直接从集合派生三类标签（technology / region / remote-policy），并按公司数量降序排列，驱动 /browse/ 目录页。

5. 构建验证：贡献者修改档案后需运行 npm run build（见 README.md，要求 Node.js 22+），仓库的 Validate Company Profiles GitHub Action 会自动校验 frontmatter 取值与必需章节，机器人会在 PR 上列出问题并阻塞合并直到修复。这正是上述字段表与章节规范能长期保持一致性的保障。

实战要点：如何理解与维护一份公司档案

围绕 Netris 档案，可以总结出三条可复用的实践准则：

1. 元数据与正文互为印证：frontmatter 的 remote_policy: hybrid 与正文 ## Remote status 的描述必须自洽；company_size: small 与 ## Company size 的 20+ 也应一致（对应 11-50 employees 的枚举区间）。
2. 链接指向必须合规：website 指向官网，申请链接指向公司自有招聘页；若公司有独立招聘域名，应通过 frontmatter 中的 careers_url 字段声明，页面主按钮会自动切换为 "Apply Now"。
3. 善用分类枚举以提升可检索性：region、remote_policy、company_size、technologies 四个字段共同决定公司在目录中的分类归属与标签页曝光，是求职者按地区、远程程度、技术栈筛选公司的核心依据。

Netris 档案完整覆盖了 CONTRIBUTING.md 定义的全部必选与常用可选章节，其 frontmatter 全部落在合法取值范围内，是一个可以直接作为新档案撰写范本的典型样本。对读者而言，理解这份档案的字段语义与渲染链路，就等于掌握了整个 remoteintech.company 目录的数据建模方式。