remote-jobs 公司档案格式完全解读:从 Aerolab 档案看 remoteintech.company 目录的数据模型与构建流程

发布时间:2026/10/2 12:44:59
remote-jobs 公司档案格式完全解读:从 Aerolab 档案看 remoteintech.company 目录的数据模型与构建流程 数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载remoteintech.company 是一个社区维护的远程友好科技公司目录其数据源就是本仓库中每个公司一份的 Markdown 档案文件。本文以 Aerolab 公司档案 为完整案例逐字段拆解档案的 frontmatter 与正文结构并结合src/_config、src/_data、src/_layouts中的源码讲清一条公司档案从写入到最终渲染成页面的完整链路。读完你将掌握该目录的档案规范、字段取值约束、构建消费方式以及如何按同一套规范新增一家公司。一、一份公司档案的骨架frontmatter Markdown 正文remote-jobs 仓库中每家公司对应src/companies/目录下的一个.md文件Aerolab 档案 即其中一例。档案由两部分构成YAML frontmatter结构化元数据负责承载可被构建系统检索、分类、聚合的字段标题、区域、远程政策、公司规模、技术栈、日期等Markdown 正文以##小节组织的人类可读信息描述公司业务、远程状态、规模、区域、技术、办公地点与申请方式。Aerolab 档案的 frontmatter 原文如下--- title: Aerolab slug: aerolab website: https://aerolab.co/ careers_url: http://careers.aerolab.co/ region: americas remote_policy: remote-friendly company_size: small technologies: - javascript addedAt: 2018-04-24 updatedAt: 2018-10-20 ---正文则依次包含## Company blurb、## Company size、## Remote status、## Region、## Company technologies、## Office locations、## How to apply共 7 个小节。其中 CONTRIBUTING.md 明确规定## Company blurb、## Remote status、## How to apply三个小节为必填其余为常用可选小节——Aerolab 档案恰好是一个必填齐全、可选丰富的规范样例。二、frontmatter 字段逐一解析值与取值约束结合 CONTRIBUTING.md 的字段取值表 与 labels.js全站标签的唯一事实来源下表汇总了 Aerolab 档案中每个字段的实际取值及其合法范围字段Aerolab 实际值合法取值CONTRIBUTING.md / labels.js用途titleAerolab任意公司名页面 H1 标题、页面标题slugaerolab须与文件名一致决定档案路径src/companies/aerolab.mdwebsiteaerolab.co站点地址任意 URLschema.org 组织数据中的urlcareers_urlcareers.aerolab.co须指向公司自己的招聘页生成 Apply Now 按钮与sameAs结构化数据regionamericasworldwide/americas/europe/americas-europe/asia-pacific/other区域分类与浏览页分组remote_policyremote-friendlyfully-remote/remote-first/hybrid/remote-friendly远程政策分类company_sizesmalltiny(1-10) /small(11-50) /medium(51-200) /large(201-1000) /enterprise(1000)规模分类标签technologies[javascript]25 个受控值javascript、typescript、react、nodejs、python、ruby、go、java、php、rust、dotnet、elixir、scala、swift、cloud、devops、docker、kubernetes、mobile、data、ml、sql、postgres、nosql、search技术栈分类标签addedAt/updatedAt2018-04-24/2018-10-20由维护者管理贡献者 PR 中不要包含新公司排序与页脚更新时间值得注意的两处细节标签使用规范化的枚举值而非自由文本。Aerolab 正文中明确写了 JavaScript, using ES7, React, Node.JS但technologies数组只登记了javascript这一个受控标签——正文负责承载细节受控字段负责分类聚合。这正是该目录结构化元数据 人类可读正文双轨设计的关键。字段与正文可能存在粒度差异。frontmatter 的region: americas在 labels.js 中渲染为 Americas而正文## Region小节写的是更具体的 Latin America。这是目录中常见的正常现象结构化字段用于归类浏览正文用于精确描述。三、正文小节的结构规范与必填要求Aerolab 档案的正文是理解目录撰写规范的绝佳样本逐节对照 CONTRIBUTING.md 的要求如下3.1## Company blurb必填Were a team of quirky yet lovable UX Wizards and Tech Geniuses. We create websites and apps, provide digital branding services and a consulting service to help customers define their product, strategy and roadmap from a user perspective.这段简介描述公司业务网站与应用开发、数字品牌服务、以用户视角定义产品/战略/路线图的咨询服务。它的作用不只是展示见下文源码分析构建时会从该小节自动抽取内容生成页面的 meta description。3.2## Company size可选20-50正文给出人数区间frontmatter 中则用枚举值small对应 labels.js 的 11-50 employees 标签。二者互补区间文本给人读枚举值给分类系统用。3.3## Remote status必填Work from home options available.说明公司的远程程度。结合 frontmatter 的remote_policy: remote-friendly渲染为 Remote Friendly读者可以在浏览页按政策粒度筛选出此类公司。3.4## Region可选Latin America正文中的具体区域描述与 frontmatter 的region: americas对应如 3.2 所述属于不同粒度。3.5## Company technologies可选Development: JavaScript, using ES7, React, Node.JS Design: Sketch, InVision, Marvel正文按岗位类别Development / Design详细罗列工具链是对technologies: [javascript]受控标签的丰富补充。3.6## Office locations可选Buenos Aires, Argentina注明实体办公地点。对于远程友好而非 fully-remote公司这一信息对求职者判断工作形态很有价值。3.7## How to apply必填http://careers.aerolab.co/提供申请入口对应 frontmatter 的careers_url字段。四、源码级消费链路一条档案如何变成页面档案文件本身只是数据真正让它成为可浏览、可搜索、带结构化数据的页面依赖src/_config与src/_layouts中的构建逻辑。下面按数据流顺序说明。4.1 集合构建档案如何被收集与分组collections.js 通过collection.getFilteredByGlob(./src/companies/**/*.md)抓取全部公司档案并对结果做了缓存以规避重复过滤约 850 条数据然后派生多种集合getAllCompanies按title字母序排序产出公司总列表getCompaniesByRegion按region字段分组如 Aerolab 归入americas组getCompaniesByTech按technologies数组分组Aerolab 归入javascript组getRecentCompanies按addedAt倒序取前 12 家Aerolab 的addedAt: 2018-04-24即参与此排序getFeaturedCompanies从 companyHelpers.js 中手工精选的featuredCompanySlugs列表中随机洗牌取 8 家展示于首页。region、remote_policy、technologies三组标签的浏览数据则由getCompanyTags统一聚合生成labels.js 中的标签映射会贯穿渲染全程。4.2 布局渲染company.njk 如何使用字段companies.json 将所有公司档案统一指定layout: company实际渲染模板为 company.njk。该模板对字段的消费方式直接决定了档案内容的呈现形态careers_url || website决定主按钮文案与链接有careers_url时显示 Apply Now否则退化为 Visit Websiteregion、remote_policy分别渲染为指向/browse/{region}/、/browse/{remote_policy}/的分类标签technologies数组逐项渲染为指向/browse/{tech}/的 Tech Stack 标签区标签文案来自labels.tech[tech]如javascript→ JavaScriptupdatedAt经formatDate(MMMM D, YYYY)过滤后在页脚显示 Last updated: ...Aerolab 会显示 2018-10-20 的更新时间。4.3 自动 meta descriptionCompany blurb 的二次利用companies.11tydata.js 是公司页面的 computed data 逻辑它展示了 blurb 小节如何被自动化消费若档案未显式设置description则用正则/##\s*Company\s*blurb\s*\n([\s\S]*?)(?\n##|$)/i从原始 Markdown 中提取 Company blurb 标题后的文本依次剥离 Markdown 链接语法、* _ 等标记、压缩换行与连续空格截断至约 155 字符优先在句号处断句其次在空格处断句并追加省略号。也就是说Aerolab 档案第一段 blurb 文本会自动成为其页面的 meta description——这正是社区维护模式下保证每条档案都有合格 SEO 描述的低成本手段。4.4 结构化数据schema.org OrganizationOrganization.njk 为每个公司页面输出 JSON-LD 结构化数据{ context: https://schema.org, type: Organization, name: Aerolab, url: https://aerolab.co/, sameAs: [http://careers.aerolab.co/] }name取自titleurl取自website存在careers_url时作为sameAs输出——档案中的每一条链接都被纳入机器可读的组织实体声明便于搜索引擎与 Agent 准确理解页面归属。五、可复制模板如何按同一规范新增一家公司档案结合 CONTRIBUTING.md 与 Aerolab 这一完整样例新增档案的最小步骤为在src/companies/下创建{slug}.md文件名必须与 frontmatter 的slug值一致如slug: aerolab→src/companies/aerolab.md按模板填写 frontmatter标题、slug、网站、招聘页、区域、远程政策、规模、技术栈正文至少包含## Company blurb、## Remote status、## How to apply三个必填小节可选补充规模、区域、技术、办公地点等运行npm run build验证构建通过仓库要求 Node.js 22开发可用npm run start启动热重载服务详见 README.md提交 Pull Request由 Validate Company Profiles 校验工作流自动审查格式。特别注意addedAt与updatedAt由维护者管理贡献者不应在 PR 中携带careers_url必须指向公司自己的招聘页而非面向客户的服务销售页。这些边界约束都在 CONTRIBUTING.md 中有明确说明。六、小结一份档案 一份结构化数据契约通过 Aerolab 档案这条完整链路可以看到remoteintech.company 的公司档案是一份结构化数据契约frontmatter 用受控枚举值支撑分类浏览、聚合排序与机器可读结构化数据Markdown 正文用人类可读小节承载业务细节与申请指引两者经由 collections.js、company.njk、companies.11tydata.js 等构建模块被消费为完整页面。理解了这份契约你既能读懂目录中任何一家公司的档案也能按同一标准贡献新的远程友好公司。赞分享数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载相关推荐从 Functionize 档案看 fully-remote 公司数据模型Remote In Tech 目录公司档案的结构与解析从 Functionize 档案看 fully remote 公司数据模型Remote In Tech 目录公司档案的结构与解析 导读 本篇以开源仓库 rem数据集从 Atento 档案看 remoteintech.company 的数据组织范式remote-jobs 仓库中远程友好型公司档案的结构化解析从 Atento 档案看 remoteintech.company 的数据组织范式remote jobs 仓库中远程友好型公司档案的结构化解析 本文以 Ate数据集从 Coingape 档案看 remote-jobs 目录体系remote-friendly 科技公司档案的数据规范与渲染流程从 Coingape 档案看 remote jobs 目录体系remote friendly 科技公司档案的数据规范与渲染流程 本篇文章以仓库中一份真实存在的数据集创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询