- 数据集
【免费下载链接】remote-jobs
Source for remoteintech.company — a community-maintained directory of remote-friendly tech companies
本指南以仓库中 Let's Encrypt 企业档案 为核心,剖析 remoteintech.company(Remote In Tech)社区维护的远程友好科技企业目录中,一家非营利证书颁发机构(CA)的档案是如何编写的。读完你不仅能看懂这份档案的每个字段含义,还能掌握该目录统一的 frontmatter 模板、标签体系与源码层面的检索机制,并据此判断 Let's Encrypt 这类"远程友好"组织在该项目中的定位。
档案概览:文件本身与数据来源
本仓库中 Let's Encrypt 的档案位于 src/companies/lets-encrypt.md,其内容与站点主文档 README.md 的定位一致——这份档案正是构成 remoteintech.company 描述的流程提交新档案。
该档案全文非常简短,由两部分构成:
- YAML frontmatter:结构化的机器可读元数据(标题、slug、官网、招聘页、区域、远程政策、加入与更新时间);
- Markdown 正文:
## Company blurb(公司简介)与## How to apply(如何申请)两个必填小节。
这份档案体现的是"远程友好"目录中一个特殊类型——非营利、面向公众利益的互联网基础设施机构,其远程政策被标记为remote-friendly,而非 Fully Remote。
Frontmatter 字段逐项解析
src/companies/lets-encrypt.md的 frontmatter 原文如下:
--- title: "Let's Encrypt" slug: let-s-encrypt website: https://letsencrypt.org careers_url: https://letsencrypt.org/jobs/ region: other remote_policy: remote-friendly addedAt: 2015-10-13 updatedAt: 2018-06-24 ---对照 CONTRIBUTING.md 中给出的字段规范,可逐项解读:
| 字段 | 取值 | 含义与约束 |
|---|---|---|
title | Let's Encrypt | 展示名称,也用于按字母序排序(见 collections.js 的getAllCompanies) |
slug | let-s-encrypt | 必须与文件名一致:{slug}→src/companies/let-s-encrypt.md(本仓库中为lets-encrypt.md,注意文件名与 slug 存在历史差异) |
website | https://letsencrypt.org | 公司官网,用于按钮跳转 |
careers_url | https://letsencrypt.org/jobs/ | 招聘页 URL。有值时代替website显示 "Apply Now" 按钮(见 company.njk) |
region | other | 允许值:worldwide、americas、europe、americas-europe、asia-pacific、other |
remote_policy | remote-friendly | 允许值:fully-remote、remote-first、hybrid、remote-friendly |
addedAt | 2015-10-13 | 加入目录日期,由维护者管理,社区 PR 不应自行填写 |
updatedAt | 2018-06-24 | 最后更新时间,在 company.njk 中经formatDate过滤器格式化展示 |
值得注意的是:该档案未填写company_size与technologies字段。这在目录中是合法的——CONTRIBUTING.md 列出的必填字段仅为region、remote_policy等 frontmatter 基础项,而## Remote status属于必填正文小节之一(本档案中未提供该小节,属于较早期的简版档案格式)。
region: other的语义
对照 labels.js,other的展示标签为 "Other"。getCompaniesByRegion(见 collections.js)会按region字段将公司分组,other分组下会包含如 Let's Encrypt 这类不在六大洲常驻招聘、或主要面向全球但无明确地理偏好的机构。浏览页面 URL 形如/browse/other/。
remote_policy: remote-friendly的语义
对照 labels.js,remote-friendly的展示标签为 "Remote Friendly",与 Fully Remote、Remote First、Hybrid 并列。它表示:公司并不保证全员远程,但确实存在可远程完成的职位机会。对 Let's Encrypt 这类以基础设施工程为主的非营利机构而言,这是对其真实用工形态的保守且准确的标注——CONTRIBUTING.md 也要求"公司必须提供真实的远程工作机会(带薪或按小时计酬的可远程岗位)"才能入列。
正文结构:Company blurb 与 How to apply
档案正文只有两个小节,均符合 CONTRIBUTING.md 的"必填小节"要求:
Company blurb(必填)
原文要点:Let's Encrypt 是免费、自动化、开放的证书颁发机构,由 Internet Security Research Group(ISRG)运营;ISRG 是加州公益公司,且被 IRS 认定为《国内税收法》501(c)(3) 条款下的免税组织。
这段简介是该档案中信息密度最高的部分,包含三个可验证的事实主张:
- 业务性质:免费、自动化、开放 CA;
- 运营主体:ISRG;
- 法律身份:加州公益公司 + 美国联邦 501(c)(3) 免税资格。
该 blurb 还会被 companies.11tydata.js 的eleventyComputed.description逻辑自动提取:它用正则/##\s*Company\s*blurb\s*\n+([\s\S]*?)(?=\n##|$)/i截取## Company blurb标题后的段落,剥离 markdown 链接语法、*/_/`等字符,将换行压缩为空格,并截断到约 155 字符生成 meta description。若匹配不到 blurb 标题,则回退取 frontmatter 之后的第一个非标题段落。
How to apply(必填)
原文仅一个链接:[Let's Encrypt](https://letsencrypt.org/jobs/)。在渲染层面,company.njk 优先使用careers_url作为主按钮(显示 "Apply Now"),因此求职者真正的主入口是 frontmatter 中的careers_url而非正文链接。
渲染链路:从 Markdown 档案到页面
完整链路可概括为:
- companies.json 为所有
src/companies/*.md指定layout: company; - company.njk 在
base.njk(src/_layouts/base.njk)基础上渲染出页面骨架:标题、主按钮、区域/政策标签、正文、Tech Stack 区块、更新时间; - 标签(tag)的展示标签来自 labels.js,通过 companyHelpers.js 导出后在模板中以
labels.region[region]、labels.remotePolicy[remote_policy]读取; - collections.js 中的
getCompaniesByRegion、getCompanyTags等集合函数把公司按区域、政策聚合,生成/browse/{region}/、/browse/{remote_policy}/等浏览页面。
由于该档案未声明technologies,页面不会渲染 "Tech Stack" 区块(company.njk 要求technologies非空数组才输出)。
检索视角:这份档案对 Agent 与搜索引擎的价值
从 Agent/LLM/搜索引擎的可检索性出发,这份档案提供了结构化的数据契约:
- 机器可读的决策字段:
remote_policy、region是精确枚举值,可直接参与过滤查询,无需解析自然语言; - 统一生成 meta 描述:
companies.11tydata.js保证每个公司页面都有约 155 字符的描述文本,利于搜索引擎索引; - 浏览页聚合:
/browse/other/与/browse/remote-friendly/将同类公司聚合,形成稳定的分类入口(见 collections.js 的getCompaniesByRegion与getCompanyTags)。
但需注意该档案自身的局限:正文缺失## Remote status、## Company size、## Region、## Company technologies等常用小节,且未提供company_size字段,相比 Buffer 档案(具备完整小节)信息密度较低。对检索而言,"Remote Friendly + Other 区域 + 非营利 CA"这一组合依然能构成精准的筛选结果。
如何验证与本地构建
若要在本地查看该档案的渲染效果:
npm install # 安装依赖(需 Node.js 22+,见 README.md) npm run start # 开发服务器,带热重载 npm run build # 生产构建构建后即可在生成的页面中看到该档案以 company.njk 模板渲染的完整形态,包括 "Apply Now" 按钮指向https://letsencrypt.org/jobs/、区域标签 "Other"、政策标签 "Remote Friendly" 以及底部的 "Last updated: June 24, 2018"(由formatDate过滤器按MMMM D, YYYY格式输出,见 src/_config/filters/dates.js)。
- 数据集
【免费下载链接】remote-jobs
Source for remoteintech.company — a community-maintained directory of remote-friendly tech companies
相关推荐
CircleCI 公司档案解析:远程友好科技公司目录(remote-jobs)中的数据建模与检索实践
CircleCI 公司档案解析:远程友好科技公司目录(remote jobs)中的数据建模与检索实践 导读 本文以开源仓库 GitHub_Trending/re
数据集remote-jobs 中的 Litmus 公司档案:远程友好公司目录的数据建模、渲染与检索实践
remote jobs 中的 Litmus 公司档案:远程友好公司目录的数据建模、渲染与检索实践 这是一篇基于 remote jobs 开源仓库(remotei
数据集数据处理与实时分析:架构设计与性能调优
数据处理与实时分析:架构设计与性能调优 在当今数据驱动的业务环境中,企业面临着实时数据处理与复杂分析的双重挑战。当用户投诉数据查询延迟超过5秒,当实时监控大屏出
数据集
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考