
数据集【免费下载链接】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是一个社区维护的开源远程友好科技公司目录整个站点的数据源就是仓库src/companies/目录下数百个 Markdown 公司档案。本文以其中一份典型档案 sticker-mule.md 为完整案例逐字段拆解档案文件的 frontmatter 元数据与正文章节结构并深入对应源码说明这些字段如何被校验、分组、渲染成页面帮助你在阅读或贡献档案时准确理解每一行的含义与约束。档案概览一份公司档案包含什么Sticker Mule 是一家主打快速定制印刷产品的公司其档案 sticker-mule.md 完整覆盖了目录中公司档案的两种组成YAML frontmatter文件头部的---分隔块机器可读的元数据包括标题、slug、官网、招聘页、地区、远程政策、公司规模、技术栈和日期Markdown 正文##二级标题组织的内容人类可读的介绍包括 Company blurb、Company size、Remote status、Region、Company technologies、Office locations、How to apply。仓库的 CONTRIBUTING.md 明确指出所有公司档案统一存放于src/companies/{slug}.md且{slug}必须与 frontmatter 中的slug值一致——这正是 sticker-mule.md 文件名的由来。frontmatter 字段逐一解读Sticker Mule 档案的 frontmatter 是目录结构的标准模板逐字段对照源码说明其约束与用途字段Sticker Mule 取值允许值来源说明titleSticker Mule任意字符串公司显示名称必填slugsticker-mule与文件名一致必须与文件名匹配否则校验失败website公司官网完整 URLhttps://或http://必填careers_url招聘页地址完整 URL用于渲染 Apply Now 按钮regionworldwideworldwide/americas/europe/americas-europe/asia-pacific/other招聘覆盖地区remote_policyfully-remotefully-remote/remote-first/hybrid/remote-friendly远程工作政策company_sizelargetiny(1-10) /small(11-50) /medium(51-200) /large(201-1000) /enterprise(1000)公司规模区间technologiescloud/devops/dotnet/go/graphql/javascript/nosql/python/ruby/sql见下方说明技术栈标签数组addedAt/updatedAt2022-10-05由维护者管理PR 中不要自行添加枚举值单一事实来源 labels.jsregion、remote_policy、company_size、technologies的所有合法取值并非散落在文档中而是集中定义在 src/_data/labels.js 里。该文件注释明确说明它是单一事实来源single source of truth同时服务于两处消费方JavaScript 通过 src/_data/companyHelpers.js 导入复用Nunjucks 模板则经由 Eleventy 数据级联以labels.*形式全局访问。技术标签的完整集合包含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。可以看到 Sticker Mule 档案中的graphql是一个值得注意的点该标签并不在labels.js的tech枚举中渲染时会按 company.njk 中labels.tech[tech] or tech的回退逻辑直接显示原文graphql。日期字段addedAt和updatedAt表示档案的添加与更新时间。在 sticker-mule.md 中两者同为2022-10-05说明该档案自添加以来未再更新。这两项直接决定两个站点功能collections.js 的getRecentCompanies按addedAt倒序筛出最近添加的 12 家公司company.njk 页脚在存在updatedAt时渲染 Last updated: …经formatDate过滤器格式化为如October 5, 2022的样式。正文章节结构与必填约束CONTRIBUTING.md 规定 Markdown 正文必须包含三个##章节Company blurb、Remote status、How to apply。Sticker Mule 档案在此之上还提供了Company size、Region、Company technologies、Office locations等常用可选章节。Company blurb一句话讲清公司做什么blurb 是全站自动生成页面 meta description 的来源。在 companies.11tydata.js 中eleventyComputed.description会通过正则##\s*Company\s*blurb截取该章节文本再做四步清洗移除 Markdown 链接语法text只留文字去掉*、_、反引号换行折叠为空格连续空格压缩为单个。随后按 155 字符上限截断优先在句号处截断要求句号位置超过 50% 长度否则在单词边界截断并补...。Sticker Mule 的 blurb 强调秒级下单、数日收货、免费样稿与免费设计协助最终会被提炼为搜索结果页和分享卡片上的描述文字。Remote status远程现状的证据Sticker Mule 的remote_policy: fully-remote与正文相互印证团队分布在 17 个国家覆盖美国、阿根廷、波黑、巴西、加拿大、克罗地亚、芬兰、法国、德国、危地马拉、印度、意大利、波兰、斯洛伐克、西班牙、瑞典和英国。这一字段值在页面头部会渲染为可点击的Fully Remote标签链接到/browse/fully-remote/聚合页。How to apply引导求职者到招聘页该章节通常放置公司官方招聘入口。在页面渲染时company.njk 会取careers_url or website作为主按钮地址存在careers_url时按钮文案为 Apply Now否则为 Visit Website。注意按钮均带target_blank、relnoopener noreferrer与data-track-outbound属性用于外链安全与出站统计。源码视角档案如何被校验、分组与渲染1. 构建期校验validate-companies.js档案质量的保障来自 .github/scripts/validate-companies.js它由.github/workflows/validate-companies.yml工作流在 PR 中自动运行。对每个src/companies/下的 Markdown 文件该校验器会解析 YAML frontmatter简易逐行解析支持数组项检查title、slug、website、region、remote_policy、company_size六个必填字段用与渲染同源的labels.js枚举校验region、remote_policy、company_size及technologies的每个标签校验slug与文件名一致Sticker Mule 即满足sticker-mule对应sticker-mule.md用new URL()校验website/careers_url必须是https:或http:协议用正则^##\ssection\s*$多行模式检查三个必填章节是否存在并对空 blurb 给出警告。任何错误都会导致 exit code 1从而阻止合并这就是机器人自动注释并拦截 PR的实现机制。2. 数据分组collections.jscollections.js 将全部档案按多种维度聚合getAllCompanies按标题字母序排成全量公司列表getCompaniesByRegion按region分组Sticker Mule 会落入worldwide组getCompaniesByTech按technologies逐项分组它会同时出现在cloud、go、javascript、nosql、python、ruby、sql、devops等多个技术浏览页中getCompanyTags聚合出技术、地区、远程政策三类标签页及其计数供 browse/tag 页面使用。3. 页面渲染company.njk 布局src/_layouts/company.njk 是公司页面的骨架页面 schema 为Organization。其渲染逻辑与 frontmatter 字段一一对应头部h1输出title主按钮取careers_url or websiteregion渲染为/browse/{region}/链接的区域标签remote_policy渲染为/browse/{remote_policy}/链接的政策标签正文内容经content | safe输出存在technologies时额外渲染 Tech Stack 区块每个标签链接到对应技术浏览页页脚显示 Last updated 日期与编辑入口链接。档案的持续维护链接健康检查远程公司档案中website、careers_url及正文内嵌链接会随时间失效仓库为此提供了 scripts/check-links.sh 链接检查脚本。它以 CSV 形式输出每个 URL 的解析结果、最终状态码与说明--refresh重新从全部档案的 frontmatter 与正文中提取 URL--quick仅复检上次非 OK 的 URL保留已通过的记录默认模式全量检查。检查通过 curl 跟随重定向-L区分 404broken link、403/401可能拦截爬虫、5xx服务器错误等状态Sticker Mule 档案中的官网与招聘页地址正是这类脚本持续监控的对象保证目录链接长期可用。结语一份档案一套完整流水线从 sticker-mule.md 这一份档案可以看到 Remote In Tech 目录的全部设计脉络frontmatter 是机器可读的数据契约由 labels.js 统一约束枚举、validate-companies.js 在 PR 期强制校验正文章节是面向求职者的内容载体由 companies.11tydata.js 自动提炼 meta 描述最终 company.njk 与 collections.js 把结构化数据渲染成可浏览、可检索、可按地区与技术过滤的页面再配合 check-links.sh 持续保障外链健康。理解这套档案格式你既能快速读懂目录中任意一家公司也能按 CONTRIBUTING.md 的模板向目录贡献新档案。赞分享数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载相关推荐从 Headforwards 档案解读 Remote In Tech 远程公司目录的数据结构与校验机制从 Headforwards 档案解读 Remote In Tech 远程公司目录的数据结构与校验机制 Headforwards 是收录于 remoteinte数据集Remote In Tech 公司档案解析从 Coodesh 条目看远程友好公司的结构化数据与渲染机制Remote In Tech 公司档案解析从 Coodesh 条目看远程友好公司的结构化数据与渲染机制 导读 本文以 src/companies/coodes数据集从 axios.md 看 Remote In Tech 公司档案的结构规范与渲染机制从 axios.md 看 Remote In Tech 公司档案的结构规范与渲染机制 Remote In Tech remoteintech.company数据集上一篇BabelDOC PDF翻译教程两条命令跑通公式与表格原样保留下一篇还在为PDF转Markdown抓狂这个开源工具让文档解析像喝水一样简单创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考