从 Alami 公司档案看 remoteintech.company 的远程友好目录结构与字段约定

• 数据集

本篇技术指南以 src/companies/alami.md 这份公司档案为样本，剖析 Remote In Tech（remoteintech.company）社区维护目录中"远程友好公司"档案的完整结构：从前置元数据（frontmatter）字段、枚举值语义，到标签渲染与浏览页的生成链路。读完你将掌握该仓库的档案格式规范、字段取值规则，以及如何像 Alami 档案一样规范地描述一家公司的远程政策与技术栈。

一、Alami 档案：一份典型的远程友好公司画像

src/companies/alami.md是仓库中 800+ 份公司档案之一，它完整覆盖了 Remote In Tech 目录要求的所有核心字段，是理解该目录数据模型的理想样本。档案正文分为六个标准章节：

• Company blurb：Alami 定位为"通过符合道德规范的 P2P 借贷实现目标"，将出资方与小微企业主通过符合伦理要求的项目连接起来，追求更公平、更透明的金融。
• Company size：员工规模 500+。
• Remote status：两条明确的远程政策——"永久远程，在家或咖啡馆办公均可"；以及"四天工作周，周五至周日为周末，以便留出更多时间用于礼拜与家庭"。
• Region：印尼、东南亚。
• Company technologies：Go、Java、Spring Boot、Kotlin、JavaScript、Python。
• Office locations：总部在印尼雅加达，但团队 100% 远程，#WorkFromAnywhere。
• How to apply：通过官网招聘页申请（字段值记录于 frontmatter 的careers_url）。

这六部分与仓库的贡献规范 CONTRIBUTING.md 中定义的结构完全对应，其中## Company blurb、## Remote status、## How to apply是必填章节，其余为常用可选章节。

二、frontmatter 元数据：档案的数据骨架

Alami 档案开头的 YAML frontmatter 是整份档案的数据骨架，它直接决定了公司档案在网站上的分类、标签与检索表现：

--- title: "Alami" slug: alami website: https://alamisharia.co.id/en/ careers_url: https://alamisharia.co.id/en/career/ region: asia-pacific remote_policy: remote-friendly company_size: large technologies: - go - java - javascript - python addedAt: 2022-10-16 updatedAt: 2022-10-16 ---

其中每个字段都有严格的取值约束，枚举值的权威定义位于 src/_data/labels.js，这也是 JS 侧与 Nunjucks 模板侧共同的"单一事实来源"（single source of truth）：

几点值得注意的语义细节：

• remote_policy: remote-friendly属于四档远程政策之一，经 src/_data/labels.js 映射后显示为 "Remote Friendly"，与fully-remote（Fully Remote）、remote-first（Remote First）、hybrid（Hybrid）并列。Alami 的正文虽然强调"100% 远程、永久远程"，但目录对其归类仍为 remote-friendly，说明该字段描述的是公司整体政策基调而非单一岗位形态。
• technologies字段只列出目录已收录的标签：Alami 正文技术栈里写到了 Spring Boot 与 Kotlin，但 frontmatter 只声明了go、java、javascript、python四个，因为标签系统只支持 src/_data/labels.jstech映射中定义的枚举（仓库尚无 spring-boot / kotlin 标签）。这体现了该目录"有限受控词表"的设计哲学。
• slug必须与文件名一致：如 CONTRIBUTING.md 所述，slug: alami对应文件src/companies/alami.md，二者必须匹配。
• addedAt/updatedAt：Alami 于 2022-10-16 添加并同日更新，这两个日期字段由维护者管理，普通贡献者提交 PR 时不应自行填写（见 CONTRIBUTING.md）。

三、从元数据到页面的渲染链路

档案的 frontmatter 并不会原样堆在页面上，而是经由 src/companies/companies.json 指定的company布局（即 src/_layouts/company.njk）驱动渲染。该模板的核心逻辑：

1. 申请按钮：优先取careers_url渲染 "Apply Now" 按钮，否则回退到website渲染 "Visit Website"；
2. 分类标签：region、remote_policy分别渲染为可点击的tag--region与tag--policy标签，链接指向/browse/{值}/浏览页；technologies数组中每个值渲染为tag--tech技术标签，同样链接到/browse/{tech}/；
3. 文本标签查询：labels.region[region]、labels.remotePolicy[remote_policy]、labels.tech[tech]直接从 src/_data/labels.js 取显示名，找不到时回退到原始值。

因此，Alami 档案中的region: asia-pacific会渲染为 "Asia Pacific" 标签并链接到/browse/asia-pacific/，remote_policy: remote-friendly渲染为 "Remote Friendly" 并链接到/browse/remote-friendly/，四个技术标签分别链接到对应的技术浏览页。这一整套标签体系由 src/_config/collections.js 中的集合定义支撑，配合 src/pages/tags.njk（/browse/总览）与 src/pages/tag.njk（单个标签页）完成按地区、远程政策、技术栈三种维度的过滤浏览。

此外，src/companies/companies.11tydata.js 会为每个公司页自动计算 meta description：它优先提取## Company blurb标题下的正文，剥除 Markdown 链接与强调符号，合并换行，并在 155 字符处按句号或空格智能截断。Alami 档案的简介因此会直接成为该页面在搜索引擎中的摘要来源——这解释了为什么每条档案的 blurb 都要求"一句话讲清公司做什么"。

四、如何新增与维护一份公司档案

如果你希望为目录补充新公司，或想理解 Alami 这类档案的录入流程，CONTRIBUTING.md 给出了标准路径：

1. 在src/companies/{slug}.md新建文件，slug必须与 frontmatter 中的slug值一致；
2. 填写 frontmatter（模板与字段规则见上文表格）并撰写 Markdown 正文，必须包含## Company blurb、## Remote status、## How to apply三个章节；
3. 运行npm run build验证构建通过；
4. 提交 PR，仓库的Validate Company Profiles工作流会自动校验档案格式并阻塞不合规的合并。

目录的收录门槛（CONTRIBUTING.md）也解释了 Alami 档案为何能通过审核：公司直接雇佣员工而非中介代招、提供真实的远程岗位（全职/按时的可远程工作）、属于科技行业、careers_url指向公司自己的招聘页。像 Alami 这样的"道德 P2P 借贷金融科技公司 + 永久远程 + 四天工作周"画像，正是 Remote In Tech 目录收录的典型样本——它既展示了东南亚市场在远程用工上的独特实践（围绕礼拜与家庭设计的周末安排），也完整演示了该目录"半远程到全远程友好公司清单"的定位如何落地为结构化数据。

五、小结

从src/companies/alami.md这一份档案出发，可以提炼出 Remote In Tech 目录的核心技术要点：

• 受控词表驱动的分类体系：region / remote_policy / company_size / technologies 全部限定在 src/_data/labels.js 定义的枚举内，既保证了数据一致性，又让/browse/浏览页可以按统一维度聚合；
• 元数据即内容：frontmatter 直接驱动按钮、标签、meta 描述与 SEO 摘要的生成，正文负责补充人读的细节（远程政策、办公地点、申请方式）；
• 社区化维护流程：档案格式由贡献规范约束，PR 自动校验，维护者负责addedAt/updatedAt日期管理。

对于想要理解该目录数据模型、或准备向其中添加公司档案的开发者，Alami 档案是一份值得对照的完整范本。

• 数据集