解析 Codea IT 公司档案：Remote In Tech 目录中全远程小团队的档案结构与数据规范

• 数据集

导读

本文以 remoteintech.company（Remote In Tech）社区维护的远程友好技术公司目录中的一份典型档案 —— Codea IT 档案 为样本，逐项拆解该档案的 frontmatter 字段、正文小节与数据规范，并结合 labels.js、company.njk、companies.11tydata.js 等仓库源码，说明一份公司档案从 Markdown 源文件到可检索页面、再到按地区/技术/远程政策分组的完整数据链路。读完本文，你将掌握该目录中公司档案的写作规范、字段取值规则、元描述自动生成机制，以及如何在仓库中查阅与核对这类档案。

一、档案概览：一份典型的远程友好公司条目

Codea IT 是 Remote In Tech 目录中一份结构完整的公司档案。与仓库中数百家公司档案（如 src/companies/ 下的10up.md、automattic.md等）一致，它由两部分组成：

1. YAML frontmatter：承载结构化元数据（标题、站点、地区、远程政策、公司规模、技术栈、日期）；
2. Markdown 正文：按约定的小节标题（## Company blurb等）书写公司描述、远程状态与申请方式。

该档案登记的公司为**全远程（fully-remote）、微小规模（tiny，约 10 人）、服务全球（worldwide）**的 IT 定制开发公司，办公室位于阿根廷布宜诺斯艾利斯。下文将逐字段解读其数据含义与取值规范。

二、frontmatter 字段逐项拆解

档案顶部 frontmatter 如下：

--- title: "Codea IT" slug: codea-it website: https://www.codeait.com/ region: worldwide remote_policy: fully-remote company_size: tiny technologies: - dotnet - java - javascript - ml - mobile - nosql - php - python - ruby - sql addedAt: 2016-10-31 updatedAt: 2018-04-16 ---

对照 CONTRIBUTING.md 中给出的 frontmatter 模板与合法取值表，可得到如下字段规范：

几点值得注意的细节：

• slug 一致性：CONTRIBUTING.md 明确规定文件名必须与slug值一致，例如slug: example-co对应src/companies/example-co.md。Codea IT 的档案正是codea-it与codea-it.md的对应案例。
• 规模档位的映射：company_size: tiny在 labels.js 中被映射为人类可读的 "1-10 employees"，这正是档案正文 "Company size: ~10" 所对应的档位。
• 技术标签必须取自受控词表：frontmatter 中的technologies使用的是dotnet、java、ml、nosql等标签键（key），而非展示名；其人类可读展示名（如.NET、Java、ML/AI、NoSQL）由 labels.js 统一映射。
• 日期字段由维护者管理：addedAt: 2016-10-31与updatedAt: 2018-04-16属于维护者字段，CONTRIBUTING.md 明确要求贡献者在 PR 中不要包含这两项。

三、正文小节：档案的完整信息骨架

Codea IT 档案正文共 7 个小节，覆盖了 CONTRIBUTING.md 要求的全部必填节（## Company blurb、## Remote status、## How to apply）与常用可选节。逐节解读如下。

Company blurb（公司简介）

We are a company that provides a full range of services and products within the IT industry.

We focus on custom development: corporate solutions, mobile, web and desktop applications. In our wide range of services we maintain high quality standards, adding real value and derencial in our daily work.

Our focus is on strategically assist our clients in achieving their business goals through the right combination of knowledge and ability.

该节是档案的"灵魂"，不仅面向读者，还被构建系统直接消费：meta 描述（description）正是从## Company blurb小节自动抽取生成的。见 companies.11tydata.js 的实现逻辑：

1. 用正则##\s*Company\s*blurb\s*\n+([\s\S]*?)(?=\n##|$)定位 blurb 文本；
2. 依次剥离 Markdown 链接语法text、星号/下划线/反引号，并将换行与连续空格折叠为单空格；
3. 截断至约 155 字符：优先在句号边界截断，其次在空格边界加省略号，从而生成符合搜索引擎习惯的 meta 描述。

这意味着 blurb 写得越清晰，生成的 meta 描述质量越高——这是该目录对每个公司档案的通用处理，并非 Codea IT 特例。

Company size（公司规模）

~10

对应 frontmatter 中company_size: tiny（1-10 人）。档案正文与结构化字段互为印证：页面模板中可由标签展示规模档位，正文则提供更精确的人数。

Remote status（远程状态）

The team is remote across most functions within the company.

该节是必填节之一，说明公司对远程工作的具体态度。Codea IT 的表述说明其大部分职能岗位均支持远程，与 frontmatter 的remote_policy: fully-remote（全远程）一致。

Region（地区）

Worldwide

worldwide是 labels.js 中地区词表的合法取值，展示为 "Worldwide"。该值同时决定了公司在worldwide地区浏览页中的归属（见下文集合分组逻辑）。

Company technologies（公司技术栈）

AngularJS, Node.js, Android (Java), iOS (Objective-c, Swift), HTML5, CSS, JavaScript, PHP, Ruby, React, Wordpress, C#, Sails.js, Python, .NET, MongoDB, Postgres, SQL

正文给出了自由文本形态的完整技术清单（未被词表约束，因此包含 Sails.js、Wordpress、AngularJS 等受控词表之外的明细），而 frontmatter 中的technologies则提供结构化标签供站点分组使用。二者互补：前者服务于人类读者，后者服务于机器检索与浏览页聚合。

Office locations（办公室地址）

Buenos Aires, Argentina

虽为全远程公司，档案仍记录了实体办公室所在地——阿根廷布宜诺斯艾利斯。这在该目录中很常见：region: worldwide描述招聘地域，office locations 则记录实际注册/办公地。

How to apply（如何申请）

Contact us

申请方式指向公司官网联系页。页面模板 company.njk 会优先使用careers_url（若提供则按钮显示 "Apply Now"），否则回退到website（显示 "Visit Website"）。Codea IT 档案未提供careers_url，因此页面顶部按钮将指向官网。

四、渲染链路：一份档案如何变成可检索页面

仓库采用 Eleventy 静态站点构建（见 README.md），公司档案的渲染与组织由以下环节串联：

1. 布局：所有公司档案通过 companies.json 统一指定layout: company，最终套用 company.njk 模板。该模板渲染标题、Meta 区（访问/申请按钮 + 地区与远程政策标签）、正文内容（{{ content | safe }}）、Tech Stack 标签区以及底部 "Last updated"（基于updatedAt经formatDate格式化，如 Codea IT 的2018-04-16）。

2. 集合：构建时通过 collections.js 中的getFilteredByGlob('./src/companies/**/*.md')抓取全部公司档案（含 codea-it.md），并派生多种集合：

   • getAllCompanies：按标题字母序排序的完整列表；
   • getCompaniesByRegion：按region分组（worldwide归入 Worldwide 组）；
   • getCompaniesByTech：按technologies标签分组（dotnet、java、ml、nosql、sql、mobile、php、python、ruby、javascript各自归组）；
   • getCompanyTags：聚合生成technology/region/remote-policy三类浏览标签。

3. 标签展示：模板中的.tag--region、.tag--policy、.tag--tech分别从labels.region[region]、labels.remotePolicy[remote_policy]、labels.tech[tech]取展示名，并链接到对应浏览页（如/browse/worldwide/、/browse/fully-remote/、/browse/dotnet/）。

4. meta 描述：如第三节所述，由 companies.11tydata.js 自动从 blurb 生成，无需手动书写description字段。

五、档案质量要点与查阅方式

从 Codea IT 档案可以总结出该目录对一份合格公司档案的基本要求（依据 CONTRIBUTING.md）：

• 必填三节：## Company blurb、## Remote status、## How to apply缺一不可；Codea IT 全部满足，且补充了## Company size、## Region、## Company technologies、## Office locations等可选节，使档案信息密度更高。
• 信息可核实：档案要求"要么是公司员工、要么能以其他方式核实信息"；website与申请链接必须指向公司自有页面。
• frontmatter 字段合法：region、remote_policy、company_size、technologies均须取受控词表值，否则标签展示与分组会出现异常。
• 自动校验：修改公司档案的 PR 会触发 "Validate Company Profiles" 工作流自动检查并评论问题。

如需查阅或核对仓库中的档案，只需浏览 src/companies/ 目录，按slug定位文件（如 codea-it.md）；本地构建可执行npm install后使用npm run start（开发服务器）或npm run build（生产构建，需 Node.js 22+），详见 README.md。

六、小结

Codea IT 档案是 Remote In Tech 目录"小而完整"的样本：它以 10 个受控标签 + 7 个正文小节，完整刻画了一家全远程、约 10 人、服务全球的 IT 定制开发公司，并天然契合站点的标签分组、meta 描述生成与可检索浏览机制。对想要理解该目录数据规范、或向目录提交新公司的读者而言，这份档案提供了可直接对照的实例：frontmatter 决定结构与检索入口，正文决定可读性与 SEO 质量，二者缺一不可。

• 数据集