ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

Remote In Tech 远程公司档案格式全解析:以 Thinkful 档案为例

Remote In Tech 远程公司档案格式全解析:以 Thinkful 档案为例 数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载Thinkful 是 Remote In Techremoteintech.company 为完整样本拆解其 Frontmatter 数据模型、正文章节规范、页面渲染链路与质量保障机制。读完本文你将掌握如何在src/companies/下编写一份通过自动校验、可被按地区/远程策略/技术栈检索的远程公司档案并能用本地命令验证构建结果。Thinkful 档案内容总览src/companies/thinkful.md是一份结构完整的公司档案正文依次包含公司简介、规模、远程状态、区域、技术栈、办公地点与申请方式七个部分核心内容如下Company blurbThinkful 是一种新型学校通过行业专家的 1-on-1 辅导为有抱负的人带来高增长的科技职业发展路径。Company size50–100 人。Remote status公司赋予所有员工随时随地工作的自由。Region面向全球招聘员工主要分布在美国同时在欧洲和拉丁美洲也有分布。Company technologiesReact、Angular、Vue.js、Python。Office locations55 Prospect St, Brooklyn, NY 11201。How to apply引导求职者访问其官方招聘页即 Frontmatter 中careers_url指向的路径。这份档案同时携带由addedAt: 2018-02-28与updatedAt: 2018-04-16组成的维护时间戳说明它自 2018 年初被收录、同年 4 月做过一次更新。Frontmatter 数据模型拆解Thinkful 档案的 Frontmatter 完整保留了该目录统一约定的字段结构是所有公司档案约 850 个文件共享的机器可读层--- title: Thinkful slug: thinkful website: https://www.thinkful.com/ careers_url: https://www.thinkful.com/about/careers/ region: worldwide remote_policy: fully-remote company_size: small technologies: - javascript - python addedAt: 2018-02-28 updatedAt: 2018-04-16 ---各字段的含义与取值约束如下表枚举值来自 CONTRIBUTING.md 的字段值表与 src/_data/labels.js 的标签定义字段类型Thinkful 取值说明 / 允许取值title字符串Thinkful公司展示名slug字符串thinkful必须与文件名{slug}.md一致决定页面 URLwebsiteURLhttps://www.thinkful.com/公司官网careers_urlURLhttps://www.thinkful.com/about/careers/招聘页页面模板会据此优先渲染 Apply Now 按钮region枚举worldwideworldwide/americas/europe/americas-europe/asia-pacific/otherremote_policy枚举fully-remotefully-remote/remote-first/hybrid/remote-friendlycompany_size枚举smalltiny(1-10) /small(11-50) /medium(51-200) /large(201-1000) /enterprise(1000)technologies数组javascript,python合法取值见 labels.js 的 tech 表如react、nodejs、go、rust、kubernetes等addedAt/updatedAt日期2018-02-28 / 2018-04-16由维护者管理贡献 PR 时不要填写见 CONTRIBUTING.md其中region、remote_policy、company_size、technologies的值会被渲染成可点击的标签用于按维度浏览公司。标签的值 → 展示文案映射统一收敛在 src/_data/labels.js 中例如worldwide → Worldwide、fully-remote → Fully Remote、javascript → JavaScript并由 src/_data/companyHelpers.js 以regionLabels、remotePolicyLabels、companySizeLabels、techLabels的形式导出给 JS 侧使用模板侧则通过全局数据级联以labels.*读取做到单一事实来源。值得注意的一个数据口径差异Thinkful 档案正文声明公司规模为 50–100 人而 Frontmatter 的company_size: small按 labels.js 定义对应 11–50 人区间——这类正文与结构化字段的不一致正是校验与人工审核要关注的对象。正文章节规范必备与可选结构按 CONTRIBUTING.md 的约定正文必须包含三个##章节Thinkful 档案恰好完整命中## Company blurb—— 一句话概括公司做什么该档案用一句英文描述 Thinkful 的 1-on-1 教学模式## Remote status—— 公司的远程工作文化Thinkful 的表述是给所有员工自由选择工作地点的权利## How to apply—— 指向招聘页或申请说明Thinkful 直接引导访问官方招聘页。以下章节为常用可选结构Thinkful 档案全部覆盖## Company size规模、## Region招聘区域注明美国为主、欧洲与拉美有分布、## Company technologies技术栈列表React、Angular、Vue.js、Python。一个容易混淆的点正文的## Company technologies是给人读的散文列表而检索用的结构化标签来自 Frontmatter 的technologies数组。以 Thinkful 为例Frontmatter 只收录了javascript与python两个合法枚举值正文却列出了 React、Angular、Vue.js、Python 四项渲染时标签系统只会使用 Frontmatter 数组见下文渲染链路正文列表仅作为信息补充。从数据到页面渲染链路源码级解读一份公司档案最终落地为 /companies/{slug}/ 页面背后是一条清晰的数据流水线1. 自动生成 meta description—— src/companies/companies.11tydata.js 的eleventyComputed会从正文中正则匹配## Company blurb段落剥离 Markdown 链接标记后按句号边界截断到约 155 字符作为页面的description元数据若找不到 blurb 章节则回退取 Frontmatter 之后的第一个段落。2. 集合分组—— src/_config/collections.js 通过getFilteredByGlob(./src/companies/**/*.md)读取全部档案并做了缓存以避免对约 850 个文件做 6 次过滤进而派生出多个视图getAllCompanies按标题字母序排列的完整列表getCompaniesByRegion按region字段分组Thinkful 因region: worldwide归入 Worldwide 组getCompaniesByTech按technologies数组展开分组Thinkful 同时出现在 JavaScript 与 Python 两组getRecentCompanies按addedAt倒序取最近新增的 12 家。3. 页面模板渲染—— src/_layouts/company.njk 负责最终呈现当careers_url存在时渲染主按钮 Apply Nowregion与remote_policy分别渲染为地区标签与远程策略标签指向 /browse/{region}/ 与 /browse/{remote_policy}/ 浏览页technologies数组则渲染为 Tech Stack 章节的标签标签文案回退逻辑为labels.tech[tech] or tech——这意味着 Thinkful 正文中的 Angular、Vue.js 若出现在 Frontmatter 中且不在 labels 映射里会以原始字符串显示。页脚还会用updatedAt显示 Last updated 时间。质量保障自动校验与链接维护新增或修改公司档案时仓库内置了两层保障Thinkful 档案也遵循同样的规范PR 自动校验—— .github/workflows/validate-companies.yml 会在 PR 触及src/companies/**时触发通过 GitHub API 获取变更文件过滤掉删除操作避免 ENOENT对每个文件执行.github/scripts/validate-companies.js再将错误/警告以机器人评论形式回帖存在错误时直接令 PR 失败exit 1。校验还负责识别旧格式文件company-profiles/并提示迁移到新格式。因此新增档案前务必对照 CONTRIBUTING.md 的模板与字段值表逐项自查。链接腐烂治理—— 维护脚本见 scripts/README.md。./scripts/check-links.sh会爬取src/companies/*.md中 Frontmatter 与正文的全部外链记录 HTTP 状态与重定向终点到link-check-results.csvnode scripts/fix-links.mjs --apply再据此自动修复可安全处理的类别如HTTPS_UPGRADE、SAFE_REDIRECT而REBRAND、NOT_FOUND、PARKED等类别需要人工复核——这保证收录的website/careers_url长期有效避免档案指向失效页面。本地查看与构建该仓库同时是站点源码基于 Eleventy详见 README.md可在本地直接构建验证档案效果npm install # 安装依赖 npm run start # 开发服务器支持热重载 npm run build # 生产构建构建环境要求 Node.js 22。构建完成后即可在本地站点上访问 Thinkful 档案页核对 Apply Now 按钮、Worldwide / Fully Remote 标签、Tech Stack 标签与 Last updated 时间的渲染是否符合预期。小结Thinkful 档案是 Remote In Tech 目录数据规范的一个完整缩影Frontmatter 承载机器可读的结构化字段地区、远程策略、规模、技术栈正文承载人读的简介与申请指引二者再经由集合分组、模板渲染与自动化校验最终成为目录中一个可检索、可维护、可追溯的远程公司条目。若要在该仓库新增公司参照 CONTRIBUTING.md 的模板以 Thinkful 档案为范例填写src/companies/{slug}.md并运行npm run build验证即可。赞分享数据集【免费下载链接】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 公司档案解析以 LeadIQ 的完全远程实践为例Remote In Tech 公司档案解析以 LeadIQ 的完全远程实践为例 本文以社区维护的远程友好科技公司目录 Remote In Tech即本仓库数据集Remote In Tech 公司档案Company Profile文档格式与渲染机制解析——以 DuckDuckGo 全远程档案为案例Remote In Tech 公司档案Company Profile文档格式与渲染机制解析——以 DuckDuckGo 全远程档案为案例 导读 remo数据集Remote In Tech 公司档案解析以 Algorand 为例读懂远程友好型科技公司数据格式Remote In Tech 公司档案解析以 Algorand 为例读懂远程友好型科技公司数据格式 导读 src/companies/algorand.md数据集上一篇RevancedXposed终极指南如何彻底拦截YouTube与YT Music广告解锁后台播放下一篇OpenResume第三方集成指南如何扩展平台功能创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进