数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载本篇技术指南以 remoteintech.companyRemote In Tech开源仓库中的公司档案src/companies/nettl-edinburgh.md为对象完整解析该公司档案的 frontmatter 字段、正文章节结构、字段合法取值以及这些数据在 Eleventy 构建管线中如何被消费与渲染。读者读完可掌握如何在 Remote In Tech 目录中新增/维护一家远程友好科技公司档案的完整套路并理解companies集合、标签系统与公司页布局的底层工作原理。一、档案概览一份标准的远程友好公司条目长什么样src/companies/nettl-edinburgh.md是 Remote In Tech 目录中一份典型的公司档案。该仓库维护着数百份类似的 Markdown 档案全部位于 src/companies/ 目录每份档案由两部分组成YAML frontmatter结构化元数据与Markdown 正文面向读者的叙述内容。Nettl Edinburgh 档案的 frontmatter 如下--- title: Nettl Edinburgh slug: nettl-edinburgh website: https://www.webdesignedinburgh.com region: worldwide remote_policy: fully-remote company_size: tiny technologies: - infrastructure - linux - php - sql addedAt: 2017-05-23 updatedAt: 2022-10-03 ---这份元数据揭示了该公司的几个关键事实slug: nettl-edinburgh决定了档案文件名必须为src/companies/nettl-edinburgh.md这是仓库的硬性约定见 CONTRIBUTING.md{slug}必须与 frontmatter 中的slug值一致。region: worldwide表示该公司的远程岗位面向全球招聘不限地域。remote_policy: fully-remote属于完全远程政策是目录中最严格的远程等级。company_size: tiny对应labels.js中的定义即 1-10 人规模。technologies标注了infrastructure、linux、php、sql四项技术标签。正文部分则由## Company blurb、## Company size、## Remote status、## Region、## Company technologies、## Office locations、## How to apply七个章节组成其中前三个章节blurb、Remote status、How to apply是仓库强制要求的必填章节其余为可选章节——这一点在 CONTRIBUTING.md 的 Required Sections 一节有明确规定。二、frontmatter 字段详解与合法取值根据 CONTRIBUTING.md 中的 Valid Field Values 表格以及 src/_data/labels.js 中维护的标签单一事实源各字段的合法取值如下字段合法取值Nettl Edinburgh 取值regionworldwide、americas、europe、americas-europe、asia-pacific、otherworldwideremote_policyfully-remote、remote-first、hybrid、remote-friendlyfully-remotecompany_sizetiny1-10、small11-50、medium51-200、large201-1000、enterprise1000tinytechnologiesjavascript、typescript、react、nodejs、python、ruby、go、java、php、rust、dotnet、elixir、scala、swift、cloud、devops、docker、kubernetes、mobile、data、ml、sql、postgres、nosql、search等infrastructure、linux、php、sql需要特别指出两点technologies字段的取值集合在持续扩展。Nettl Edinburgh 档案使用的infrastructure、linux标签目前并未出现在 CONTRIBUTING.md 的列举清单中但 src/_data/labels.js 的注释明确指出它是单一事实源single source of truth被 JS 侧companyHelpers.js和 Nunjucks 模板侧labels.*共同引用。从源码结构看技术标签集合是开放式的只要标签系统能消费即可但未被 labels 收录的标签会以原始 slug 形式直接展示在页面上labels.tech[tech] or tech的回退逻辑。addedAt与updatedAt由维护者管理。CONTRIBUTING.md 明确要求贡献者不要在 PR 中包含这两个日期字段——Nettl Edinburgh 档案中addedAt: 2017-05-23、updatedAt: 2022-10-03即由维护者维护它们会被站点用于展示最后更新时间以及最近新增公司等排序逻辑。三、正文章节结构必填项与可选项Nettl Edinburgh 档案完整覆盖了目录要求的正文结构是学习公司档案写作规范的理想范本必填章节## Company blurb公司简介用 2-3 句话说明公司业务。Nettl Edinburgh 的 blurb 描述了其位于苏格兰爱丁堡市中心的网站设计代理公司 曼彻斯特 Nettl HQ 技术团队的双地结构以及从小型单页站到大型电商站的业务范围。## Remote status说明公司如何开展远程工作。该档案指出其员工分布于曼彻斯特英格兰、莫斯科俄罗斯、波士顿美国三地。## How to apply应聘方式。该档案给出了邮箱hellonettledinburgh.com并附官网链接。可选但常用的章节## Company size约 10 名员工与 frontmatter 中company_size: tiny1-10 人互相印证。## RegionWorldwide员工从美洲到欧洲均有分布。## Company technologiesWordPress、Linux、Apache、PHP、MySQL。## Office locations苏格兰爱丁堡、格拉斯哥格林诺克两个线下办公点。这些章节中的信息并非孤立存在## Region、## Company technologies等章节内容与 frontmatter 字段存在语义对应关系正文是面向读者的自然语言叙述frontmatter 是面向机器的结构化数据。四、数据如何被消费集合、标签与渲染管线公司档案并不直接以原始 Markdown 呈现而是经过 Eleventy 的集合系统、标签系统和布局模板三层加工。以下代码证据来自仓库源码可完整还原一份档案的生命周期。4.1 集合构建companies集合src/_config/collections.js 通过getFilteredByGlob(./src/companies/**/*.md)抓取全部公司档案源码注释提到约 850 家并使用缓存避免重复过滤进而派生出多个集合getAllCompanies按标题字母序排序供/companies/列表页使用。getFeaturedCompanies从 src/_data/companyHelpers.js 中的featuredCompanySlugs精选名单automattic、stripe、netlify、github 等 8 家随机洗牌后取 8 家展示在首页。getRecentCompanies依据 frontmatter 中的addedAt字段降序排序取最近 12 家。getCompaniesByRegion/getCompaniesByTech分别按region与technologies字段分组。以 Nettl Edinburgh 为例其region: worldwide会使其进入worldwide分组technologies数组中的每一项都会被getCompaniesByTech挂到对应技术标签下。这些分组结果正是站内/browse/{region}/、/browse/{tech}/浏览页面的数据来源。4.2 标签体系labels.js与companyHelpers.jssrc/_data/labels.js 定义了 region、remotePolicy、companySize、tech 四组标签的展示文案。而 src/_data/companyHelpers.js 将这些标签重新导出并提供了getRegionLabel、getRemotePolicyLabel、getCompanySizeLabel、getTechLabel四个取值函数其回退逻辑为labels[slug] || slug || 默认值——即未被收录的取值会原样展示或回退到默认文案。例如remote_policy: fully-remote会通过remotePolicyLabels[fully-remote]渲染为 Fully Remote若未来出现新的标签值而 labels 未同步更新则会直接显示原始值这也解释了为何 CONTRIBUTING.md 要求region、remote_policy、company_size必须使用受限枚举值。4.3 页面渲染company.njk布局src/_layouts/company.njk 是公司档案的专属布局frontmatter 中layout: company由 src/companies/companies.json 统一注入。该模板负责渲染标题、主按钮优先取careers_url否则取websiteNettl Edinburgh 未设careers_url故显示 Visit Website根据region与remote_policy渲染可跳转的区域/政策标签遍历technologies数组渲染技术标签对应模板中的company-profile__tech区块在页脚展示updatedAt并格式化为 MMMM D, YYYY 形式Nettl Edinburgh 会显示 October 3, 2022引入Organization结构化数据 schemasrc/_includes/schemas/Organization.njk便于搜索引擎理解公司实体信息。4.4 Meta 描述自动生成src/companies/companies.11tydata.js 通过eleventyComputed.description自动为每个公司页面生成 meta description它优先提取## Company blurb章节后的文本剥离 Markdown 语法链接转纯文本、去除*/_/、合并多余空白并截断至约 155 字符优先在句号处截断。这意味着 Nettl Edinburgh 档案的 blurb 文本质量会直接影响其页面的搜索引擎描述是内容维护中值得重视的隐性机制。五、从这份档案反推如何新增/维护公司档案结合 CONTRIBUTING.md 与 Nettl Edinburgh 档案新增一家公司档案的完整流程是在src/companies/下创建{slug}.md文件确保文件名与 frontmatter 的slug一致填写 frontmattertitle、slug、website必填region、remote_policy、company_size、technologies按合法枚举取值addedAt/updatedAt留给维护者编写正文必须包含## Company blurb、## Remote status、## How to apply三个章节可补充## Company size、## Region、## Company technologies、## Office locations等本地运行npm run build验证构建需 Node.js 22见 README.md提交 PR由 Validate Company Profiles GitHub Action 自动校验机器人会在 PR 中评论需要修复的问题未解决前会阻止合并。维护者会拒绝内容过于单薄、不符合远程友好科技公司收录标准、存在重复条目或业务含害的公司档案。Nettl Edinburgh 档案自 2017 年收录、2022 年更新始终符合标准可视为一份规范的长期存活档案样例。六、小结一份档案的完整生命周期从nettl-edinburgh.md出发我们可以梳理出 Remote In Tech 目录中一份公司档案的完整生命周期创作按 CONTRIBUTING.md 模板填写 frontmatter 与正文章节校验GitHub Action 自动校验字段合法性、必填章节与旧格式兼容性构建Eleventy 通过 src/_config/collections.js 将其归入公司集合按 region/technology 分组供浏览页与首页消费渲染src/_layouts/company.njk 将 frontmatter 映射为页面按钮、区域/政策/技术标签与更新日期src/companies/companies.11tydata.js 自动生成 SEO meta description维护维护者通过updatedAt字段追踪档案新鲜度公司业务不再符合标准时整份移除。对于希望贡献该目录的开发者而言src/companies/nettl-edinburgh.md是一份字段完整、章节规范、数据自洽的参考样例对于希望理解 Eleventy 数据流与标签系统的工程师而言它又是一条贯穿 frontmatter → 集合 → 标签 → 布局的完整链路入口值得顺着 companies.11tydata.js 与 collections.js 继续深入阅读。赞分享数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载相关推荐FoundationDB 同集群恢复数据验证方案validate_restore 审计的设计、实现与实战指南FoundationDB 同集群恢复数据验证方案validate_restore 审计的设计、实现与实战指南 本篇文章基于 FoundationDB 仓库内的数据集Remote In Tech 公司档案结构详解以 Help Scout 的 remote-first 档案为例Remote In Tech 公司档案结构详解以 Help Scout 的 remote first 档案为例 Help Scout 档案 src/comp数据集Remote In Tech 公司档案数据解剖以 Figma 混合办公档案为例Remote In Tech 公司档案数据解剖以 Figma 混合办公档案为例 Remote In Tech本仓库 remoteintech.company数据集上一篇微信聊天记录怎么永久保存用 WeChatMsg 三步导出并生成年度聊天报告下一篇魔兽争霸III终极辅助工具免费开源的游戏体验增强指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考