Coalition Technologies 完全远程档案解析:Remote In Tech 远程公司目录的数据结构与全球雇佣实践
Coalition Technologies 完全远程档案解析:Remote In Tech 远程公司目录的数据结构与全球雇佣实践
Coalition Technologies 是 Remote In Tech(remoteintech.company)社区维护远程友好科技公司目录中的一份典型公司档案,本文以其档案 coalition-technologies.md 为骨架,完整拆解其 Frontmatter 元数据、正文小节约定,并结合仓库中的标签体系、布局模板、集合聚合逻辑与贡献规范,说明一份“全球范围、完全远程”的公司档案是如何被定义、校验、渲染并参与目录检索的。读完本文,你将掌握该目录公司档案的完整数据模型、字段枚举取值,以及从 Markdown 数据文件到页面输出的完整链路。
档案概览:一份公司档案在目录中长什么样
src/companies/ 目录下每个公司对应一个独立的 Markdown 数据文件,文件名即 slug(如 coalition-technologies.md),文件由两部分组成:以 --- 包裹的 YAML Frontmatter 元数据,以及正文中若干个以 ## 开头的说明小节。Coalition Technologies 的档案同时包含两类内容,是观察该目录数据约定的完整样本:
---
title: "Coalition Technologies"
slug: coalition-technologies
website: https://coalitiontechnologies.com/
careers_url: https://coalitiontechnologies.com/jobs
region: worldwide
remote_policy: fully-remote
company_size: large
technologies:
- ml
addedAt: 2022-10-29
updatedAt: 2022-10-29
---
正文部分则依次提供了 ## Company blurb、## Company size、## Remote status、## Region、## Company technologies、## Office locations、## How to apply 七个信息块。按 CONTRIBUTING.md 的约定,Company blurb、Remote status、How to apply 是三个必需小节,其余为可选但常用小节——本档案恰好全部提供,可作为新档案的完整对照模板。
Frontmatter 字段逐项解读:从数据到标签的映射
档案的元数据字段并非自由文本,而是受目录集中定义的枚举约束。这些枚举的“单一事实来源”位于 src/_data/labels.js,它同时被 JS 侧(经 src/_data/companyHelpers.js 导出)和 Nunjucks 模板侧(作为 labels.* 全局数据)使用。
title/slug:展示名称与文件标识。slug: coalition-technologies必须与文件名coalition-technologies.md一致,这是 CONTRIBUTING.md 的硬性要求,也是目录按字母排序、生成浏览链接的基础。website/careers_url:官网与招聘页。在 company.njk 布局中,页面按钮的逻辑是优先取careers_url渲染“Apply Now”,否则回退到website渲染“Visit Website”,因此档案指向的是公司自己的招聘页而非对外售卖服务的页面(后者是维护者拒绝收录的理由之一)。region: worldwide:招聘地理范围。labels.js中region的合法取值为worldwide(Worldwide)、americas、europe、americas-europe、asia-pacific、other。Coalition 的全球招聘定位决定了它归类到worldwide,页面右上角会渲染出对应的 Region 标签,并链接到/browse/worldwide/聚合页。remote_policy: fully-remote:远程工作制度。labels.js定义四种取值:fully-remote(Fully Remote)、remote-first(Remote First)、hybrid(Hybrid)、remote-friendly(Remote Friendly)。“我们的全球员工 100% 远程”这一档案陈述,正是fully-remote在语义上的精确匹配。company_size: large:规模档位。取值及区间为tiny(1-10)、small(11-50)、medium(51-200)、large(201-1000)、enterprise(1000+)。档案正文“201-500 Employees”与large档位的“201-1000”区间一致。technologies: <a href="https://link.gitcode.com/i/1d59baef2c784db6e3256bce7b1afe69" target="_blank">ml]:技术标签列表。枚举见labels.js的tech映射,ml渲染为 “ML/AI”。多个技术可并列,目录会据此在 [collections.js 中生成“按技术浏览”的聚合分组。addedAt/updatedAt:收录与更新时间,由维护者管理,社区 PR 不需要携带这两个字段(见 CONTRIBUTING.md)。它们驱动“最近新增”集合排序,并在 company.njk 页脚以 “Last updated: MMMM D, YYYY” 格式展示。
正文七个小节:信息组织的固定骨架
对照 CONTRIBUTING.md 的“Required Sections”,可以看清本档案正文各小节承担的信息职责:
| 小节 | 内容 | 类别 |
|---|---|---|
## Company blurb |
公司定位与业务介绍:metrics-driven 数字代理公司、灵活工作选项、成长晋升机会、历史上发布过全球远程与自由职业岗位 | 必需 |
## Company size |
201-500 名员工 | 可选 |
## Remote status |
“Our global workforce is 100% remote.”——完全远程的官方陈述 | 必需 |
## Region |
Worldwide(全球招聘) | 可选 |
## Company technologies |
专注 SEO、PPC、邮件营销、社交媒体营销与网页设计开发 | 可选 |
## Office locations |
100% 远程,总部位于洛杉矶 | 可选 |
## How to apply |
引导到官方 Careers 页面查看开放职位 | 必需 |
值得注意的信息一致性:正文 Company size 与 Frontmatter company_size、正文 Region 与 region: worldwide、正文 Remote status 与 remote_policy: fully-remote 相互印证,这正是维护者审核档案时关注的数据自洽性——一份新档案若能像本档案一样做到元数据与正文彼此对齐,通过验证机器人(Validate Company Profiles GitHub Action)的概率会显著提高。
从 Markdown 到页面的渲染链路
档案文件本身不包含任何展示层代码,输出完全由目录的 Eleventy 数据级联驱动:
- 布局绑定:
src/companies/companies.json声明"layout": "company",使目录下所有档案自动套用 src/_layouts/company.njk,并启用schema: Organization的 JSON-LD 结构化数据。 - Meta 描述自动生成:src/companies/companies.11tydata.js 通过
eleventyComputed.description正则提取## Company blurb小节的内容,剥离 Markdown 链接语法、星号、反引号,压缩空白后截断至约 155 字符,并优先在句号边界截断。这意味着 Coalition 档案的 blurb 会直接转化为页面的搜索引擎描述,blurb 写得信息密度越高,页面的检索表现越好。 - 头部元信息渲染:company.njk 输出标题、基于
careers_url/website的申请按钮、Region 与 Remote Policy 标签(文案取自labels.region/labels.remotePolicy),正文区由{{ content | safe }}注入档案 Markdown 渲染结果,technologies则在文末追加 Tech Stack 标签区,每项链接到/browse/{tech}/。
在目录中的检索与聚合
一份档案的价值不仅在于自身页面,还在于它如何被目录的集合逻辑索引:
- collections.js 的
getCompaniesByRegion按region字段把公司分组——worldwide分组中会包含 Coalition Technologies; - collections.js 的
getCompaniesByTech遍历technologies数组建立技术索引——ml标签下同样能找到它; - collections.js 的
getRecentCompanies依据addedAt降序取最近 12 家,因此addedAt越新,档案越可能出现在首页“最近新增”区域; - collections.js 的
getCompanyTags从集合派生技术/地区/远程政策三类标签数据,供浏览页统计每个标签下的公司数与公司列表。
由源码结构可以推断,region、remote_policy、technologies 三个字段是档案进入聚合体系的唯一入口,字段取值是否落在 labels.js 枚举内,直接决定标签文案、分组正确性与浏览页的可用性。
如何维护与新增类似档案
本档案可以作为新公司档案的完整范本。按 README.md 与 CONTRIBUTING.md 的流程:
- 在
src/companies/新建{slug}.md,保证slug与文件名一致,并填写上文模板所示 Frontmatter; - 正文至少包含
## Company blurb、## Remote status、## How to apply三个必需小节,careers_url指向公司自有招聘页; - 本地运行
npm install、npm run build(需 Node.js 22+)验证构建通过后提交 PR; - 由 Validate Company Profiles GitHub Action 自动校验字段合法性、必备小节与旧文件格式,未通过时会阻塞合并。
目录对收录有明确边界:公司需直接雇佣员工(不接受训练营、人力中介代发岗位)、提供真实可远程的受薪/计时岗位、处于科技行业,且申请方式不能是纯佣金或独立承包商销售机会。像 Coalition Technologies 这样“100% 远程 + 全球招聘 + 员工规模 201-500”的组合,正是 fully-remote / worldwide / large 三个枚举值同时命中的典型案例。
小结
通过拆解 coalition-technologies.md 可以得出:Remote In Tech 的每份公司档案都是“结构化元数据 + 固定小节正文”的复合数据文档。元数据经 labels.js 枚举约束后,驱动按钮、标签、浏览聚合、最近新增等全站功能;正文则在 company.njk 布局与 companies.11tydata.js 的自动描述机制下直接构成页面主体与 SEO 文本。若你正在为目录贡献新公司,或希望理解这类社区维护目录的数据组织方式,本档案与其背后的数据级联即是最完整的参考起点。