新闻详情

新闻详情

首页 / 资讯中心 / 详情

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),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

OpenRig开源驾驶舱:用铝型材自制千元级模拟赛车支架 2026/10/2 14:14:45

OpenRig开源驾驶舱:用铝型材自制千元级模拟赛车支架

如果你也厌倦了那种把方向盘夹在桌沿、一打方向桌子就跟着晃的凑合玩法,OpenRig 大概能给你一个在家里搭起真正赛车模拟驾驶舱的低成本答案。这个项目最初就是一套对外开放的驾驶舱图纸——骨架用标准铝型材,安装只用内六角扳手和电钻,不碰焊…

阅读更多 →
OpenRig开源座舱搭建实战:铝型材DIY模拟赛车平台的完整攻略 2026/10/2 14:14:45

OpenRig开源座舱搭建实战:铝型材DIY模拟赛车平台的完整攻略

最近一直在琢磨家里那套模拟赛车设备到底怎么升级。以前用桌椅板凳拼出来的“临时驾驶舱”,跑跑公路赛还行,一上真实山道就露馅:刹车踏板会往前跑、方向盘顶在桌子边缘、座椅随着身体一起晃,玩两个小时下来腰先罢工。后来在社群翻…

阅读更多 →
Linux read 命令详解:从标准输入读取变量的 shell 交互基石 2026/10/2 14:14:39

Linux read 命令详解:从标准输入读取变量的 shell 交互基石

文档教程 【免费下载链接】linux-command Linux命令大全搜索工具,内容包含Linux命令手册、详解、学习、搜集。https://git.io/linux 项目地址: https://gitcode.com/GitHub_Trending/linux/linux-command 点击查看 免费下载 read 是 Linux Shell 内置命…

阅读更多 →
2514张头盔检测数据集:VOC转YOLO训练与mAP提升避坑指南 2026/10/2 14:14:38

2514张头盔检测数据集:VOC转YOLO训练与mAP提升避坑指南

简介:这份资源面向计算机视觉开发者、交通安全算法研究者及高校相关课题学生,提供摩托车与电动车骑乘人员佩戴头盔的检测数据集,可用于目标检测模型训练、头盔合规性识别与智能交通场景落地。压缩包共收录2000个文件,以VOC格式的X…

阅读更多 →
GitHub Trending高效阅读指南:筛选优质开源项目与避坑实践 2026/10/2 14:14:19

GitHub Trending高效阅读指南:筛选优质开源项目与避坑实践

每天早上打开 GitHub Trending 已经成了我进入工作状态前的固定动作。与其说是看项目,不如说是在观察整个开源社区今天把注意力放在哪里——2026年9月30日的日榜也不例外。榜单上 AI 应用类仓库依旧占据相当篇幅,数据工程、开发者工具、命令行效率插件也…

阅读更多 →
皮安级微弱电流测量全解析:从漏电流抑制到嵌入式皮安计模块实践 2026/10/2 14:14:19

皮安级微弱电流测量全解析:从漏电流抑制到嵌入式皮安计模块实践

一说到"测电流",很多工程师觉得这是基本功。但如果目标变成1皮安——也就是10的负12次方安培——事情的性质就完全变了。1皮安意味着每秒只有大约600万个电子流过检测点,而一段PCB走线表面粘了点助焊剂残留、一块绝缘材料吸了潮、甚至连接器内…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉