从 Mobile Jazz 档案看 Remote In Tech:公司目录的数据结构与全远程实践
从 Mobile Jazz 档案看 Remote In Tech:公司目录的数据结构与全远程实践
Mobile Jazz 是 Remote In Tech(remoteintech.company 的开源仓库)中收录的一家"全远程(fully-remote)"小型数字创新团队,其完整档案保存在 mobile-jazz.md。本篇将以这份档案为骨架,逐段解析它的 frontmatter 字段、正文章节结构,并结合仓库内的构建管线(companies.11tydata.js、collections.js、company.njk)说明一份 Markdown 公司档案是如何被转换成可浏览、可被搜索引擎与 Agent 理解的目录页面的。读完本篇,你将掌握 Remote In Tech 公司档案的数据规范、标签体系与提交流程,并了解一份真实的全远程团队档案应包含哪些关键信息。
档案速览:一个 fully-remote 的小型数字创新团队
打开 mobile-jazz.md,第一眼看到的是 YAML frontmatter。这份档案的全部结构化元数据如下(原样继承):
---
title: "Mobile Jazz"
slug: mobile-jazz
website: https://mobilejazz.com
careers_url: https://mobilejazz.com/jobs
region: worldwide
remote_policy: fully-remote
company_size: small
addedAt: 2018-12-19
updatedAt: 2018-12-19
---
这些字段构成了档案的"机器可读层":slug 是文件名标识(与文件 mobile-jazz.md 一一对应),website 与 careers_url 分别记录官网与招聘页,region、remote_policy、company_size 则是参与分类浏览的三个核心维度。
字段取值与标签映射
仓库用 labels.js 作为所有标签的单一事实来源,companyHelpers.js 再把这些映射导出给 JS 消费方(如 collections.js)。Mobile Jazz 档案中的三个枚举字段恰好对应:
| frontmatter 字段 | 原始取值 | 对应标签(labels.js 映射) | 语义 |
|---|---|---|---|
region |
worldwide |
Worldwide |
招聘范围覆盖全球 |
remote_policy |
fully-remote |
Fully Remote |
完全远程,无实体办公要求 |
company_size |
small |
11-50 employees |
团队规模 11–50 人 |
其中 company_size: small 与正文里写明的"23 人"完全吻合,这也是该枚举设计的初衷——small 覆盖 11–50 人区间。addedAt 与 updatedAt 均为 2018-12-19,说明档案自添加以来未再变更,目录内容以仓库当前快照为准。
Company blurb:档案的叙述核心与 meta 描述生成
正文第一节是 ## Company blurb,这是整个档案的"人读层"叙述核心,原文如下:
Mobile Jazz is a collective of digital innovators, creating beautiful apps and websites for companies all over the world. We work a little differently to other agencies, our approach is unique and forward thinking, where happiness and morale are our first priority. This applies to both our team and our clients. We know that happy people are more creative, productive, efficient and successful. At Mobile Jazz, we don't work for you, we work with you.
这段简介交代了三个关键信息:业务形态(为全球客户打造应用与网站的"数字创新者集合体")、工作理念(把团队幸福感和士气放在第一位)、合作方式("我们不为你工作,而是与你一起工作")。
blurb 如何被自动加工成 meta 描述
有意思的是,这段 blurb 并不是只用来给人看的。companies.11tydata.js 通过 eleventyComputed 在构建期自动从 Markdown 原文中提取 blurb 并生成页面 description:
- 用正则
/##\s*Company\s*blurb\s*\n+([\s\S]*?)(?=\n##|$)/i匹配## Company blurb标题之后的文本块; - 清除 Markdown 链接语法(
text→text)、剔除*、_、反引号,并把换行与连续空格压平; - 截断到约 155 字符,优先在句号处断句,其次在空格处断句并追加
...。
这意味着像 Mobile Jazz 这样的档案,其 meta description 完全由 blurb 自动生成,无需人工维护——这正是目录"机器可理解性"的第一层保障,让搜索引擎在抓取公司页时能直接获得一段干净、稳定的摘要。
Remote status:从巴塞罗那办公室到全面远程
## Remote status 是档案中最能体现"全远程实践"细节的章节,原文完整继承如下:
We previously had an office in central Barcelona, but have always been remote friendly. In April 2018, we decided to close our office and embrace being fully remote. Our team members are from Argentina, Brazil, Mexico, Spain, England, Germany, Italy, Czech Republic, Croatia, Vietnam and more.
这段叙述包含三层事实:
- 历史路径:Mobile Jazz 并非一开始就全远程,它曾有位于巴塞罗那市中心的办公室,但一直保持"远程友好";2018 年 4 月正式关停办公室,全面转向远程(原文以博客文章记录了这一决策)。
- 当前状态:
remote_policy: fully-remote在 labels.js 中对应Fully Remote,与正文描述一致。 - 团队地理分布:成员来自阿根廷、巴西、墨西哥、西班牙、英国、德国、意大利、捷克、克罗地亚、越南等多个国家,印证了
region: worldwide的全球招聘定位。
仓库内的交叉佐证
同一目录下的 bugfender.md 还提供了有价值的旁证:Bugfender 档案开头写道 "As developers at Mobile Jazz, we've built many apps across all mobile platforms",即 Bugfender 这款移动端日志工具正是由 Mobile Jazz 的开发者们构建的。这说明该团队具备跨移动平台的工程能力,两份档案互为补充,也展示了目录中"母公司/产品公司"关系的记录方式。
Region、Company size 与办公地点:结构化元数据
档案还有三个简短但重要的章节:
## Region
Worldwide
## Office locations
None
结合 frontmatter 的 region: worldwide 与正文 ## Company size 里的 23,可以完整拼出这家公司的画像:全球招聘、完全远程、23 人规模、无实体办公室。## Office locations 明确写 None,这在目录中是一个值得注意的信号——当一家公司声称 fully-remote 却没有列任何办公地点时,说明它确实不再依赖线下空间。
这些字段会在渲染层被 company.njk 消费:region 与 remote_policy 分别渲染为指向 /browse/{region}/ 与 /browse/{remote_policy}/ 的可点击标签(tag),方便用户按地区或远程政策浏览同类公司;updatedAt 则在页脚以 MMMM D, YYYY 格式显示"Last updated"。
How to apply:通过 API 的申请渠道
档案的最后一个必填章节是 ## How to apply,原文为:
You can find our open jobs and apply via our API here: https://mobilejazz.com/jobs
这处细节值得单独强调:Mobile Jazz 提供了 API 式的职位申请渠道——求职者通过其招聘页(即 frontmatter 中 careers_url 指向的页面)浏览开放职位并提交申请,而非传统的邮箱投递。在 company.njk 中,careers_url 的优先级高于 website:只要 careers_url 存在,按钮文案就是 "Apply Now"(否则为 "Visit Website"),并且按钮带 data-track-outbound 属性用于外链点击统计。同理,company-card.njk 在列表卡片上也优先展示 careers_url。
按 CONTRIBUTING.md 的校验规则,careers_url 必须指向公司自己的招聘页面(而非面向客户售卖服务的页面),Mobile Jazz 这份档案完全符合要求。
档案背后的构建机制:从 Markdown 到公司页面
Mobile Jazz 档案能出现在目录中,依靠的是 collections.js 中的一系列集合定义:
getAllCompanies:按title的localeCompare结果对全部src/companies/**/*.md档案做字母排序,Mobile Jazz 因此落在 "M" 区间;getRecentCompanies:按addedAt倒序取前 12 家,作为"最近添加"列表;getCompaniesByRegion/getCompaniesByTech:分别以region和technologies字段对全部公司分组,并预初始化所有合法标签的空数组。
每个公司页的布局由 companies.json 统一指定为 layout: company,并声明 schema: Organization(对应 Organization.njk 结构化数据),让页面在语义上被识别为公司组织。整个过程可以用一条链路概括:
mobile-jazz.md(frontmatter + 正文章节)
→ companies.json 指定 layout: company
→ companies.11tydata.js 从 blurb 生成 meta description
→ collections.js 按 title/addedAt/region 归入各集合
→ company.njk 渲染按钮、标签、Tech Stack、页脚
如何为目录贡献一份类似的档案
如果你也想把一家远程友好的公司收录进 Remote In Tech,CONTRIBUTING.md 给出了完整流程:
- 在
src/companies/{slug}.md新建文件,{slug}必须与 frontmatter 中的slug一致(如slug: mobile-jazz→src/companies/mobile-jazz.md); - 填写 frontmatter(模板与 Mobile Jazz 档案结构相同)并撰写 Markdown 正文;
- 运行
npm run build验证构建(项目要求 Node.js 22+,详见 README.md); - 提交 Pull Request,由 Validate Company Profiles 机器人自动校验并评论问题。
正文必须包含三个 ## 章节:Company blurb、Remote status、How to apply;Company size、Region、Company technologies 为常用可选章节。合法字段值如下:
| 字段 | 合法取值 |
|---|---|
region |
worldwide、americas、europe、americas-europe、asia-pacific、other |
remote_policy |
fully-remote、remote-first、hybrid、remote-friendly |
company_size |
tiny (1-10)、small (11-50)、medium (51-200)、large (201-1000)、enterprise (1000+) |
同时要注意目录的收录门槛:公司必须是"半远程到全远程的技术类公司"、直接雇佣员工(不接受猎头/培训/自由职业平台)、提供真正的远程岗位,且 careers_url 指向自家招聘页。addedAt 与 updatedAt 由维护者管理,无需在 PR 中填写。
小结
Mobile Jazz 档案是理解 Remote In Tech 目录体系的绝佳样本:它在 2018 年完成了从"远程友好 + 实体办公室"到"完全远程 + 全球招聘"的转型,团队覆盖 10 余个国家却没有任何办公室。在仓库层面,这份档案同时演示了 frontmatter 枚举字段(region / remote_policy / company_size)的规范用法、Company blurb 的自动 meta 描述生成,以及 careers_url 驱动的申请入口设计。无论你是想学习远程团队的组织样本,还是准备为目录贡献一份新档案,mobile-jazz.md 及其背后的构建管线都是可以直接参照的完整案例。