Coalition Technologies 完全远程档案解析:Remote In Tech 远程公司目录的数据结构与全球雇佣实践

原创2026-10-01 14:31:011,863 阅读
文章标签:数据集

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 数据级联驱动:

  1. 布局绑定:src/companies/companies.json 声明 "layout": "company",使目录下所有档案自动套用 src/_layouts/company.njk,并启用 schema: Organization 的 JSON-LD 结构化数据。
  2. Meta 描述自动生成:src/companies/companies.11tydata.js 通过 eleventyComputed.description 正则提取 ## Company blurb 小节的内容,剥离 Markdown 链接语法、星号、反引号,压缩空白后截断至约 155 字符,并优先在句号边界截断。这意味着 Coalition 档案的 blurb 会直接转化为页面的搜索引擎描述,blurb 写得信息密度越高,页面的检索表现越好。
  3. 头部元信息渲染: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 的流程:

  1. 在 src/companies/ 新建 {slug}.md,保证 slug 与文件名一致,并填写上文模板所示 Frontmatter;
  2. 正文至少包含 ## Company blurb、## Remote status、## How to apply 三个必需小节,careers_url 指向公司自有招聘页;
  3. 本地运行 npm install、npm run build(需 Node.js 22+)验证构建通过后提交 PR;
  4. 由 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 文本。若你正在为目录贡献新公司,或希望理解这类社区维护目录的数据组织方式,本档案与其背后的数据级联即是最完整的参考起点。

登录后查看全文
remote-jobs