数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载Remote In TechREADME.md 与 CONTRIBUTING.md 中说明的 community-maintained 目录以每个公司一个 Markdown 档案文件的方式管理远程友好科技公司的结构化信息。本文以目录中的 Conversio 档案 为实例逐项拆解其 frontmatter 字段与正文章节的含义、取值规范并结合仓库中的标签定义、页面布局与集合逻辑说明这份档案从数据文件到网页的全部链路。读完本文你将掌握该目录公司档案的完整 schema、可控词表与渲染机制能够独立读懂任何一份.md档案并具备按相同规范新增档案的能力。一、档案概览一份公司档案里到底有什么conversio.md 是典型的 Remote In Tech 公司档案由两部分组成位于文件头部的 YAML frontmatter元数据以及以##小节组织的 Markdown 正文。这份档案记录的信息如下类别字段值标识titleConversio标识slugconversio连接websitehttps://conversio.com区域regionworldwide远程策略remote_policyfully-remote规模company_sizetiny技术栈technologiesjavascript、nosql时间线addedAt/updatedAt2017-02-23 / 2018-04-16规模正文Company size0-20远程状态正文Remote statusMade Around The World with no geographic limit区域正文RegionWorldwide技术正文Company technologiesNode.JS、MongoDB办公地正文Office locationsDevonshire House, 60 Goswell Road, London, EC1M 7AD, United Kingdom申请正文How to applyadiiconversio.com可以看到同一份档案的信息在 frontmatter 与正文中成对出现frontmatter 提供机器可读的受控值正文提供给人阅读的自然语言描述。这正是该目录数据与展示分离的设计基础。二、frontmatter 字段详解受控词表与取值规范档案的元数据必须遵守 CONTRIBUTING.md 中定义的模板与合法值。对照该模板Conversio 档案中每个字段都可以映射到规范--- title: Conversio slug: conversio website: https://conversio.com region: worldwide remote_policy: fully-remote company_size: tiny technologies: - javascript - nosql addedAt: 2017-02-23 updatedAt: 2018-04-16 ---2.1 受控字段与合法取值依据 CONTRIBUTING.md 的Valid Field Values表字段合法值Conversio 取值regionworldwide、americas、europe、americas-europe、asia-pacific、otherworldwideremote_policyfully-remote、remote-first、hybrid、remote-friendlyfully-remotecompany_sizetiny(1-10)、small(11-50)、medium(51-200)、large(201-1000)、enterprise(1000)tinytechnologies词表见下javascript、nosql这些 slug 的显示文案统一由 src/_data/labels.js 管理它是单一事实来源该文件注释明确写道 single source of truth。例如region的worldwide显示为 Worldwideremote_policy的fully-remote显示为 Fully Remotecompany_size的tiny显示为 1-10 employees注意这是受控标签与正文里 Conversio 自述的 0-20 是两种表述口径技术词表中包含javascript→JavaScript、nosql→NoSQL而nodejs→Node.js 也是合法值——Conversio 档案 frontmatter 选择了javascript与nosql两个更宽泛的 slug正文中则以 Node.JS、MongoDB 做了更具体的说明。2.2 时间字段由维护者管理CONTRIBUTING.md 特别注明TheaddedAtandupdatedAtdate fields are managed by maintainers — please dont include them in your PR。这意味着新增公司时不应自行填写这两个日期Conversio 档案中的addedAt: 2017-02-23与updatedAt: 2018-04-16是由维护者写入的入库与最后更新时间。三、正文章节档案的信息主体档案正文由若干固定##小节构成。CONTRIBUTING.md 规定## Company blurb、## Remote status、## How to apply为必需小节## Company size、## Region、## Company technologies为常用可选小节## Office locations亦属于档案允许包含的信息。Conversio 档案完整包含了以上全部小节。3.1 Company blurb公司简介档案原文记录为Conversios all-in-one dashboard run your marketing, so that you have more time to run your fdd这段文案被 companies.11tydata.js 自动抽取用作公司页面的 meta description该文件通过正则/##\s*Company\s*blurb\s*\n([\s\S]*?)(?\n##|$)/i定位 ## Company blurb 标题后的段落再依次清除 Markdown 链接语法、*_ 强调符号、压缩换行与空格最后截断至约 155 字符优先在句号边界截断其次在空格处截断并追加...。因此blurb 小节不仅是给人看的一句话介绍更是 SEO 元数据的直接数据源。3.2 Company size / Remote status / Region## Company size0-20自述规模## Remote statusMade Around The World with no geographic limit —— 这是全球无地域限制的远程宣言与 frontmatter 中remote_policy: fully-remote、region: worldwide相互印证## RegionWorldwide再次与region: worldwide保持一致。值得注意的细节是虽然远程策略是全球无地域限制档案仍记录了位于伦敦的实体办公地址Devonshire House, 60 Goswell Road, London, EC1M 7AD, United Kingdom。这展示了该目录档案对远程公司 实体注册地址两种信息的并存记录能力。3.3 Company technologies公司技术栈正文以自然语言列出 Node.JS、MongoDB而 frontmatter 以受控 slugjavascript、nosql标注。这种双写模式在站点的浏览页中意义重大/browse/{{ tech }}/等标签页完全依赖 frontmatter 的technologies数组进行归类见下文集合逻辑正文的表述则服务于人工阅读。3.4 How to apply如何申请档案给出的申请方式是邮箱adiiconversio.com这也是目录早期档案的常见形态。需要注意 CONTRIBUTING.md 的现代规范建议使用careers_url指向公司自己的招聘页points at the companys own careers page且目录不接受把服务推销页当作招聘入口Conversio 档案没有设置careers_url字段因此布局会回退到website作为主按钮链接。四、从档案到网页渲染与展示链路公司档案被 src/_layouts/company.njk 渲染为完整页面其关键映射包括主操作按钮优先取careers_url否则回退到website——Conversio 未定义careers_url故按钮文案为 Visit Website 并指向其官网元信息标签region渲染为指向/browse/{region}/的标签文案取labels.region[region]即 Worldwideremote_policy渲染为指向/browse/{remote_policy}/的标签文案取labels.remotePolicy[remote_policy]即 Fully RemoteTech Stack 区块遍历 frontmatter 的technologies数组为每个技术生成指向/browse/{tech}/的标签文案取labels.tech[tech]即 JavaScript、NoSQL页脚时间戳updatedAt经formatDate(MMMM D, YYYY)过滤器格式化后显示为 Last updated: April 16, 2018 之类的文本——该过滤器定义于 src/_config/filters/dates.jsdayjs(date).format(format)并经由 src/_config/filters.js 注册到模板页脚还包含返回全部公司的链接以及由page.fileSlug动态拼接的 Edit on GitHub 编辑入口。五、档案如何进入站点集合src/_config/collections.js 以getFilteredByGlob(./src/companies/**/*.md)一次性加载全部公司档案结果会被缓存以避免约 850 个档案被重复过滤并派生多个集合getAllCompanies按title字母序排列全部公司供 companies.njk 列表页使用getCompaniesByRegion/getCompaniesByTech按 frontmatter 的region与technologies分组——Conversio 因此会出现在 Worldwide 区域组与 JavaScript、NoSQL 技术组中getFeaturedCompanies从 src/_data/companyHelpers.js 中人工精选的featuredCompanySlugs名单随机挑选 8 家展示在首页Conversio 不在该名单内getRecentCompanies按addedAt倒序取最近 12 家。此外getCompanyTags函数把每份档案的title、slug、website、region、remote_policy、technologies聚合为带计数与标签文案的浏览页数据其显示标签同样来自 labels.js。这解释了为什么 frontmatter 必须使用受控词表集合、分组、标签页与页面文案全部依赖这些 slug 的一致性。六、档案的构建与验证流程档案修改后需通过构建与自动校验方可合并本地构建README.md 给出npm install、npm run start带热重载的开发服务器、npm run build生产构建三条命令并要求 Node.js 22新增档案时需在 src/companies 下创建{slug}.md文件名必须与 frontmatter 的slug一致提交 PR 后由 Validate Company Profiles GitHub Action 自动校验机器人会在 PR 上评论问题并阻止合并直至通过。七、总结从一份档案看整个目录的工程化设计以 conversio.md 为样本可以看到Remote In Tech 的公司档案并不只是一段公司介绍而是一套前后端贯通的微型数据模型frontmatter 承担机器语义region、remote_policy、company_size、technologies全部映射到 labels.js 的受控词表驱动分组、浏览页与标签渲染正文承担人读语义blurb、remote status、如何申请等小节同时服务于读者阅读与 companies.11tydata.js 自动生成的 meta description布局与集合负责呈现company.njk 将字段渲染为按钮、标签与页脚collections.js 将档案汇入区域、技术、精选、最新等多个集合。读懂这份 schema你就掌握了阅读目录中任意一家公司档案的方法若要为新的远程友好公司提交档案CONTRIBUTING.md 中的模板、合法值表与校验规则即是你的完整 checklist。赞分享数据集【免费下载链接】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 公司档案解析以 Algorand 为例读懂远程友好型科技公司数据格式Remote In Tech 公司档案解析以 Algorand 为例读懂远程友好型科技公司数据格式 导读 src/companies/algorand.md数据集Remote In Tech 公司档案解析以 Basecamp 为例的远程友好科技公司目录数据模型Remote In Tech 公司档案解析以 Basecamp 为例的远程友好科技公司目录数据模型 Basecamp 是远程工作领域的标志性公司也是本仓库数据集Remote In Tech 公司档案解析以 Art Logic 为例读懂远程友好型公司的结构化数据与站点呈现Remote In Tech 公司档案解析以 Art Logic 为例读懂远程友好型公司的结构化数据与站点呈现 本篇技术指南以远程科技公司目录 remo数据集创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考