数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载Remote In Techremoteintech.company是一个由社区维护的远程友好科技公司目录其网站源码全部保存在本仓库中。本篇文章以目录中 Canonical 的公司档案 src/companies/canonical.md 为主体逐层拆解这份档案如何用 frontmatter 数据层与 Markdown 内容层记录一家公司的远程工作信息并顺着 Eleventy 的构建管线讲清楚这份档案如何被渲染成公司详情页、如何被聚合进区域/技术浏览体系。读完你将掌握该目录公司档案的完整数据结构、合法字段取值、渲染原理与新增/维护一家公司的实操流程。档案总览一份公司档案由哪两部分组成src/companies/canonical.md 是目录中 Canonical 公司的唯一数据源全文共 47 行结构上分为两个层次YAML frontmatter第 1–15 行机器可读的结构化数据包括公司名称、官网、招聘页、招聘区域、远程政策、公司规模、技术栈以及加入/更新时间Markdown 正文第 17–47 行面向读者的自然语言内容按##二级标题组织包括 Company blurb、Company size、Remote status、Region、Company technologies、Office locations、How to apply 共七个章节。这种「frontmatter 负责结构化、正文负责可读性」的设计是整个目录 800 家公司档案的统一约定。从 CONTRIBUTING.md 可以确认新增公司时{slug}.md的文件名必须与 frontmatter 中的slug值保持一致正文则必须包含## Company blurb、## Remote status、## How to apply三个必选章节## Company size、## Region、## Company technologies为常用可选章节。数据层剖析canonical.md 的 frontmatter 字段逐项解读以下是 Canonical 档案 frontmatter 的完整字段以及它们在目录体系中的含义与合法取值字段值含义合法取值依据 CONTRIBUTING.mdtitleCanonical公司显示名同时用于详情页 H1、卡片标题与 meta 信息自由文本slugcanonicalURL 标识必须与文件名一致小写连字符命名websiteCanonical 官网公司官网地址卡片与详情页展示合法 URLcareers_urlCanonical 招聘页招聘入口详情页渲染为 Apply Now 按钮指向公司自有招聘页regionworldwide招聘覆盖区域worldwide、americas、europe、americas-europe、asia-pacific、otherremote_policyfully-remote远程工作政策fully-remote、remote-first、hybrid、remote-friendlycompany_sizelarge公司规模档位tiny(1-10)、small(11-50)、medium(51-200)、large(201-1000)、enterprise(1000)technologiescloud、javascript、mobile技术栈标签见 CONTRIBUTING 枚举含react、python、go、kubernetes、data、ml、sql等 25 项addedAt2015-10-13档案加入日期由维护者管理updatedAt2022-10-18档案最后更新日期由维护者管理值得注意两点其一region、remote_policy、company_size、technologies都是受控枚举并非自由填写这保证了浏览页分组与统计的一致性其二addedAt/updatedAt由维护者统一管理社区贡献者提交 PR 时不需要包含这两个字段见 CONTRIBUTING.md 中的说明。这些枚举值的展示文案并不散落在各档案里而是集中在单一数据源 src/_data/labels.js 中。例如region: worldwide会被映射为 Worldwideremote_policy: fully-remote映射为 Fully Remotecompany_size: large映射为 201-1000 employeestechnologies中的cloud、javascript、mobile分别映射为 Cloud、JavaScript、Mobile。该文件在 src/_data/companyHelpers.js 中被重新导出为regionLabels、remotePolicyLabels、companySizeLabels、techLabels同时通过 Eleventy 的全局数据级联以labels.*形式供 Nunjucks 模板使用实现 JS 与模板两端共享同一份事实来源。内容层解读正文七个章节写什么、为什么这么写Company blurb一句话定位公司Canonical 的 blurb 阐明其使命——相信开源能改变世界公司伴随 Ubuntu 的诞生而创立帮助政府和企业完成 Ubuntu 部署的迁移、管理与支持并联合合作伙伴确保 Ubuntu 在 PC、智能手机、服务器乃至云端可靠运行。这段文字不仅供读者阅读还是详情页 meta description 的来源见下文渲染管线因此要求精炼、信息密度高。Company size与 frontmatter 档位互相印证正文写明 Over 700 employees与 frontmatter 的company_size: large201–1000 人档对应。正文给人具体数字frontmatter 给机器可排序的档位两者互为表里。Remote status 与 Region远程工作属性的核心声明Canonical 的 Remote status 声明其提供覆盖多种岗位的大量远程职位Region 进一步说明招聘范围是Worldwide全球即 home based居家办公并可前往招聘页按地点或岗位检索空缺。这两节是档案被归入「Fully Remote Worldwide」分组的关键依据。Company technologies不止是标签正文说明 Canonical 的产品与技术版图Ubuntu服务器、桌面、移动操作系统以及面向电信和企业客户的三款云运维工具——Landscape帮助管理员经济地部署和管理 Ubuntu 云、Juju与MAAS大幅降低在任何云环境中部署和扩容的时间、成本与复杂度。frontmatter 中的cloud、javascript、mobile三个标签正是从这版图中提炼出来的可检索维度。Office locations 与 How to apply落地信息档案记录了三个法人实体所在地Canonical Ltd英国属地曼岛 Douglas、Canonical Group Ltd英国伦敦、Canonical USA Inc美国马萨诸塞州 Lexington。How to apply 则把求职者导向官方招聘页查看全部在招岗位——注意careers_url指向公司自有招聘页而非外包中介这也是 CONTRIBUTING.md 对收录公司的硬性要求之一。渲染管线从 canonical.md 到公司详情页公司档案所在的 src/companies/companies.json 只有一行配置layout: company它让所有src/companies/*.md档案统一套用 src/_layouts/company.njk 布局。整个渲染过程可分为四步第一步计算 meta description。src/companies/companies.11tydata.js 中的eleventyComputed.description会从档案正文中正则提取## Company blurb标题下的第一段文字剥离 Markdown 链接语法与符号压缩空白后截断到约 155 字符优先在句号处截断生成详情页的 SEO meta 描述。Canonical 的 blurb 恰好符合这一提取规则。第二步渲染头部信息区。company.njk 读取 frontmattercareers_url存在时渲染 Apply Now 主按钮否则回退为 Visit Websiteregion渲染为指向/browse/{region}/的区域标签remote_policy渲染为指向/browse/{remote_policy}/的政策标签。对 Canonical 而言即 Worldwide 与 Fully Remote 两个可点击标签。第三步渲染正文与 Tech Stack。正文经 Markdown 转换后直接注入若technologies非空则在其后追加 Tech Stack 区块每个技术项渲染为指向/browse/{tech}/的标签。Canonical 会得到 Cloud、JavaScript、Mobile 三个技术标签。第四步注入结构化数据。布局声明schema: Organizationsrc/_includes/schemas/Organization.njk 会输出 JSON-LD 格式的Organizationschema包含公司名与官网 URL并在careers_url存在时将其加入sameAs数组——这为搜索引擎与 AI Agent 理解公司实体提供了语义化数据。布局底部还会展示Last updated: {updatedAt}时间戳通过formatDate过滤器格式化Canonical 档案显示为 2022 年 10 月 18 日更新。数据聚合档案如何进入浏览与推荐体系单份档案渲染成详情页只是起点真正让目录可浏览的是 src/_config/collections.js 中基于档案 frontmatter 建立的集合体系getAllCompanies按标题字母序聚合全部 800 档案构成 companies 集合getCompaniesByRegion / getCompaniesByTech按region与technologies分组——Canonical 因region: worldwide进入 Worldwide 组因cloud、javascript、mobile分别进入三个技术组getCompanyTags从档案直接推导technology、region、remote-policy三类标签并统计每个标签下的公司数供浏览页排序展示getRecentCompanies按addedAt倒序取最近加入的 12 家公司用于首页最新公司模块Canonical 的addedAt: 2015-10-13表明它是目录元老级档案getFeaturedCompanies从人工精选的featuredCompanySlugs列表中匹配档案并随机打乱取 8 家展示精选列表定义在 src/_data/companyHelpers.js。在公司列表页中档案会被 src/_includes/partials/company-card.njk 的companyCard宏渲染成卡片显示公司名链接到详情页、区域标签和官网/招聘链接链接地址优先取careers_url其次回退到website。由于getCompanies对./src/companies/**/*.md的 glob 结果做了缓存上述六个集合函数共享同一份内存数据避免了 800 家公司被重复过滤的性能开销见 collections.js 中的注释。实操新增或维护一份 Canonical 式档案的完整流程如果你希望为其他公司新增档案、或修正 Canonical 这类现有档案流程如下详见 CONTRIBUTING.md 与 README.md在src/companies/下创建{slug}.mdslug 与 frontmatter 一致填写 frontmattertitle、slug、website、careers_url、region、remote_policy、company_size、technologies字段取值严格遵循枚举编写正文至少包含## Company blurb、## Remote status、## How to apply三个必选章节本地验证构建仓库要求 Node.js 22依次执行npm install、npm run build开发模式可用npm run start启动带热重载的开发服务器提交 PR由 Validate Company Profiles 机器人自动校验 frontmatter 合法性并反馈问题。需要注意的是维护者会拒绝无实质内容的档案、重复收录的公司以及不再符合收录标准如转为他方代招的公司因此 Canonical 档案这种「blurb 有信息量、字段齐全、招聘链接指向官方页面」的写法正是社区认可的模板范式。小结以 src/companies/canonical.md 为切片可以完整看到 Remote In Tech 目录的数据组织方式frontmatter 的受控枚举region、remote_policy、company_size、technologies保证数据可聚合、可分组正文章节blurb、remote status、region、technologies、office locations、how to apply保证信息对求职者可读company.njk 布局 companies.11tydata.js collections.js 则把每一份 Markdown 档案转化为带结构化数据、可检索、可浏览的完整网页。对想理解静态站点目录型项目或希望贡献公司档案的开发者而言这份档案就是最好的入门样例。赞分享数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载相关推荐Remote In Tech 公司档案深度解析以 Chef 为例读懂远程友好公司数据结构与渲染流程Remote In Tech 公司档案深度解析以 Chef 为例读懂远程友好公司数据结构与渲染流程 导读 src/companies/chef.md 是 Re数据集Remote In Tech 公司档案解析以 Algorand 为例读懂远程友好型科技公司数据格式Remote In Tech 公司档案解析以 Algorand 为例读懂远程友好型科技公司数据格式 导读 src/companies/algorand.md数据集Remote In Tech 公司档案解析以 Conversio 为例读懂远程友好科技公司的结构化数据模型Remote In Tech 公司档案解析以 Conversio 为例读懂远程友好科技公司的结构化数据模型 Remote In Tech README.md数据集创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考