Prisma 公司档案全解析：Remote In Tech 目录的公司数据模型、字段规范与渲染链路

数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载这篇技术指南以仓库中 Prisma 的真实公司档案 src/companies/prisma.md 为主体样本逐层拆解 Remote In Techremoteintech.company目录中每一份远程友好公司档案的 frontmatter 字段、正文小节规范、合法取值约束以及这些数据从 Markdown 到页面的完整渲染链路。读完你不仅能读懂仓库里任意一份公司档案还能照规范为一家新的远程技术公司撰写并通过校验的档案。从一份公司档案说起Prisma 在 Remote In Tech 中的完整档案Remote In Tech 是一个社区维护的远程友好技术公司目录其网站源码全部保存在当前仓库中。目录中每家公司对应src/companies/下的一个 Markdown 文件文件名即slug。以 Prisma 为例它的完整档案如下--- title: Prisma slug: prisma website: https://www.prisma.io/ careers_url: https://www.prisma.io/careers region: worldwide remote_policy: fully-remote company_size: small technologies: - go - javascript - rust addedAt: 2022-10-19 updatedAt: 2022-10-19 ---正文部分共六个##小节内容完全照录如下Company blurbPrisma unlocks a new level of developer experience when working with databases thanks to its intuitive data model, automated migrations, type-safety auto-completionCompany size50-100Remote statusThe team is globally distributed and everyone can work from any location within the UTC -8 to UTC 3 timezonesRegionWorldwideCompany technologiesTypeScript, Rust, JavaScript, Shell, Go, Node.JSOffice locationsBerlin, GermanyHow to applyCareers page 指向其招聘页这份档案同时具备两层信息YAML frontmatter 是供站点生成与检索使用的结构化数据Markdown 正文是供求职者阅读的人文描述。下面分别拆解。frontmatter 字段逐项拆解目录数据模型的核心每一份公司档案的数据模型由 frontmatter 字段定义CONTRIBUTING.md 给出了完整模板Prisma 档案几乎覆盖了全部字段字段Prisma 取值作用titlePrisma公司显示名称也是档案页h1标题slugprisma与文件名prisma.md一致决定 URLwebsiteprisma.io 官网公司官网地址careers_urlprisma.io/careers招聘页地址优先级高于 websiteregionworldwide招聘覆盖地域remote_policyfully-remote远程办公政策company_sizesmall公司规模档位technologiesgo / javascript / rust技术栈标签数组addedAt/updatedAt2022-10-19维护者管理的日期字段字段的合法取值约束这些字段并非自由填写其取值被 src/_data/labels.jssingle source of truth与 CONTRIBUTING.md 双重约束region仅允许worldwide、americas、europe、americas-europe、asia-pacific、other六种Prisma 的worldwide即 Worldwide与其正文 The team is globally distributed 相互印证。remote_policy仅允许fully-remote、remote-first、hybrid、remote-friendly四种Prisma 取fully-remote对应 Fully Remote。company_size分为tiny(1-10)、small(11-50)、medium(51-200)、large(201-1000)、enterprise(1000) 五档。technologies有 25 个受支持标签javascript、typescript、go、rust、nodejs、python、react等Prisma 的三个标签全部合法。这里可以观察到一份档案内部的口径差异Prisma 的 frontmatter 声明company_size: small按 labels.js 对应 11-50 人而正文 Company size 小节写的是 50-100 人按标签映射应归入medium档 51-200。这类前后不一致在社区维护的目录中时有发生也正是目录维护、校验与更新机制存在的意义。结构化标签如何驱动页面交互frontmatter 中的标签字段不只是一份清单。在渲染层src/_layouts/company.njk 会优先展示careers_url否则回退到website生成 Apply Now 主按钮根据region与remote_policy渲染tag--region、tag--policy样式的可点击标签分别链接到/browse/{region}/与/browse/{remote_policy}/浏览页遍历technologies数组为每项技术渲染tag--tech标签并链接到/browse/{tech}/。也就是说Prisma 档案里的worldwide、fully-remote、go等取值最终都会变成页面上可跳转的过滤标签串起整个目录的浏览体系。正文小节规范必需小节与可选小节CONTRIBUTING.md 明确规定正文必须包含三个##标题小节## Company blurb—— 公司做什么的简短描述## Remote status—— 公司如何开展远程办公## How to apply—— 招聘页链接或申请说明。另有常用可选小节## Company size、## Region、## Company technologies。Prisma 档案正是标准模板的完整示范blurb 一句话概括其数据库开发者体验直观数据模型、自动化迁移、类型安全与自动补全的产品定位Remote status 具体到时区约束——团队全球分布可在 UTC -8 至 UTC 3 时区内任何地点工作这对求职者判断是否与我所在时区重叠至关重要也是 Prisma 档案中最具信息量的描述之一How to apply 直接给出 careers 页面入口。数据如何被渲染成页面computed data 与描述生成公司档案并非简单套模板。 src/companies/companies.11tydata.js 展示了 Eleventy 的eleventyComputed机制如何自动为每个档案生成 meta description优先使用已显式设置的description否则从原始 Markdown 中正则提取## Company blurb标题后的内容对文本做清理剥离 Markdown 链接语法、*_ 符号、合并换行与连续空格截断到约 155 字符并尝试在句号或空格边界处优雅截断超出部分补省略号。这意味着 Prisma 档案无需手写 description其 blurb 会被自动提炼为搜索引擎可见的 meta 描述——这正是博客文章所记录的 SEO 改进的一部分。档案如何进入浏览与检索体系collections.jssrc/_config/collections.js 负责把src/companies/**/*.md下的所有档案组织成可检索集合getAllCompanies按title字母序排成全量列表getRecentCompanies按 frontmatter 的addedAt倒序取最近 12 家Prisma 档案的addedAt: 2022-10-19正是排序依据getCompaniesByRegion按region分组——Prisma 会进入worldwide分组getCompaniesByTech按technologies分组——Prisma 会同时出现在 Go、JavaScript、Rust 三个技术分组下getCompanyTags汇总所有档案的technologies、region、remote_policy生成浏览页标签体系。注意到代码中getCompanies对约 850 份档案做了带缓存的 glob 过滤见 collections.js 中_companyCache的注释避免每个集合重复过滤 6 次——这是大数据量目录站点在构建性能上的一个务实优化。另外src/_data/companyHelpers.js 维护了一份人工精选的featuredCompanySlugsautomattic、stripe、netlify 等 8 家Prisma 虽不在其列但所有档案都会参与按addedAt的最新加入展示。链接健康与档案维护check-links.sh 与 fix-links.mjs社区目录最大的维护成本是失效链接。仓库在 scripts/check-links.sh 与 scripts/fix-links.mjs 中内置了一套自动化的链接健康流水线check-links.sh扫描src/companies/*.md中的所有 outbound URL包括像 Prisma 档案中的website与careers_url输出link-check-results.csvfix-links.mjs --plan将每个 URL 分类为 OK / HTTPS_UPGRADE / SAFE_REDIRECT / REBRAND / NOT_FOUND / PARKED / DEAD_DNS / THROTTLED 等并生成人工审阅计划link-fix-plan.md--reverify用浏览器风格 User-Agent 重验被限流的可疑 URL403/429/999以区分站点真的挂了与只是机器人被拦截--apply仅自动应用最安全的修复删除官网落入域名停放服务parked host的档案、移除已失效的careers_url字段、把相同主机路径下的 http 升级为 https。这个机制解释了为什么src/companies/下的档案需要保持字段干净一个失效的careers_url不仅让求职者白跑一趟还会在链接体检中产生 NOT_FOUND 或 CAREERS_DEAD 记录最终被脚本标记为待清理项。动手实践为一家远程友好公司撰写合规档案参照 Prisma 这份标准档案为新的公司写档案的完整步骤详见 CONTRIBUTING.md在src/companies/{slug}.md新建文件slug必须与 frontmatter 中的slug一致如slug: example-co→src/companies/example-co.md按模板填写 frontmatter字段取值必须落在 labels.js 定义的合法集合内正文补齐三个必需小节## 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 ProfilesGitHub Action 会自动校验档案格式与取值合法性不合规会被拦截。addedAt与updatedAt由维护者管理贡献者不应在 PR 中包含这两个字段。同时注意目录收录门槛公司必须直接雇佣员工不收录中介/自由职业平台、提供真实远程岗位纯佣金销售岗不算、身处或靠近科技行业且careers_url必须指向公司自己的招聘页——Prisma 档案完全符合这些要求。小结一份看似简单的 Prisma 公司档案背后串联了 Remote In Tech 目录的完整技术栈frontmatter 定义结构化数据模型labels.js 约束字段取值companies.11tydata.js 自动生成 meta 描述company.njk 渲染标签与申请按钮collections.js 将其纳入地区/技术/政策浏览体系fix-links.mjs 持续守护其链接健康。理解了这条链路你就能以 Prisma 档案为模板为任意一家远程友好公司写出既合规、又能在目录中被高效检索和呈现的档案。赞分享数据集【免费下载链接】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 公司档案全解从 sardine-ai.md 看远程友好公司条目的字段规范、渲染链路与维护流程Remote In Tech 公司档案全解从 sardine ai.md 看远程友好公司条目的字段规范、渲染链路与维护流程 Sardine.ai 是 Remo数据集从 PicPay 档案读懂 Remote In Tech 远程公司目录的数据模型与渲染链路从 PicPay 档案读懂 Remote In Tech 远程公司目录的数据模型与渲染链路 导读 本文以 src/companies/picpay.md htt数据集Envoy 公司档案解析Remote In Tech 远程友好公司目录的 Frontmatter 数据模型与构建链路Envoy 公司档案解析Remote In Tech 远程友好公司目录的 Frontmatter 数据模型与构建链路 Remote In Tech仓库根目录数据集创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考