ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

remoteintech.company 公司档案解析:以 I-Stem 为例读懂 frontmatter 字段、远程政策与技术栈标签体系

remoteintech.company 公司档案解析:以 I-Stem 为例读懂 frontmatter 字段、远程政策与技术栈标签体系 数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载在开源仓库 remoteintech.company社区维护的远程友好科技公司目录中每一家公司的条目都以 Markdown 文件形式存放在src/companies/目录下通过 YAML frontmatter 定义结构化元数据、以固定小节的正文描述公司细节。本文以 I-Stem 档案 为完整样本逐字段拆解这类公司档案的书写规范并结合 标签定义、集合构建逻辑 与 渲染模板 的源码实现说明一条目录记录从数据到页面的完整链路。读完本文你将能够独立读懂任何一条公司档案、判断其远程政策与招聘区域并掌握为目录新增或修订条目的规范流程。I-Stem 档案概览一条目录记录长什么样I-Stem 是远程友好科技公司目录中的一员其档案完整位于 src/companies/i-stem.md。它由两部分组成frontmatterYAML 元数据区位于文件顶部---分隔线之间是机器可读的结构化字段正文Markdown 小节区以##标题组织的自然语言描述用于向访客展示公司细节。该档案对应的核心元数据如下--- title: I-Stem slug: i-stem website: https://www.istemai.com/ careers_url: https://wellfound.com/company/i-stem/jobs region: asia-pacific remote_policy: remote-friendly company_size: tiny technologies: - javascript - python addedAt: 2023-10-08 updatedAt: 2023-10-08 ---其中addedAt入库日期与updatedAt最近更新日期均为2023-10-08即该条目自加入目录以来尚未被修订。关键字段逐一解读每个值背后的约束frontmatter 中的字段并非随意填写而是在仓库的标签体系single source of truth中预定义了合法取值。所有合法值集中维护于 src/_data/labels.js同时被 companyHelpers.js 导出供 JS 侧消费并通过全局数据级联以labels.*形式暴露给 Nunjucks 模板。region招聘覆盖地区I-Stem 填写的是asia-pacific。在 labels.js 中region的合法取值与展示标签为取值展示标签worldwideWorldwideamericasAmericaseuropeEuropeamericas-europeAmericas Europeasia-pacificAsia PacificotherOtherI-Stem 的正文 Region 小节进一步写明India表明其招聘覆盖亚太地区、以印度为主。remote_policy远程工作政策I-Stem 的取值为remote-friendly。在 labels.js 中remote_policy定义了四个梯度取值展示标签fully-remoteFully Remoteremote-firstRemote FirsthybridHybridremote-friendlyRemote Friendlyremote-friendly表示公司允许远程工作、但不一定全员远程优先。该值会直接决定档案页上Apply Now主按钮旁的 policy 标签见下文渲染逻辑。company_size公司规模取值为tiny对应 labels.js 中定义的 1-10 employees与正文 Company size 小节的 1-10 people 完全一致。全部规模档位包括取值规模tiny1-10small11-50medium51-200large201-1000enterprise1000technologies技术栈标签I-Stem 声明了javascript与python两项。值得注意的是其正文 Company technologies 小节描述为 Python, Node.js, React.jsfrontmatter 中的javascript标签即对应 React.js/Node.js 生态属于 JavaScript 技术族。技术标签的完整合法取值见 labels.js包括typescript、react、nodejs、go、rust、ml、devops、cloud等 24 项每项都有对应的展示名称如nodejs→ Node.js、ml→ ML/AI。正文小节从 blurb 到申请方式的固定结构I-Stem 档案的正文包含 7 个小节其中三个是 CONTRIBUTING.md 规定的必填小节## Company blurb公司简介必须存在## Remote status远程工作方式说明必须存在## How to apply申请链接或说明必须存在。其余为常用可选小节Company size、Region、Company technologies、Office locations。Company blurb 的自动化利用## Company blurb不仅是给人看的简介还会被自动提取为页面 meta description。companies.11tydata.js 中的 Eleventy computed data 会通过正则##\s*Company\s*blurb\s*\n([\s\S]*?)(?\n##|$)截取该小节文本随后依次执行 Markdown 链接剥离text→text、符号清洗去除*、_、反引号、换行与空白归一化最终截断到约 155 字符并尽量在句号处切断——这正是 I-Stem 的 blurb 会被搜索引擎摘要复用的原因。I-Stem 的 blurb 核心信息由拥有残障亲身经历与数十年无障碍、工程与 AI 经验的残障人士创立坚信技术与社区的力量能够为所有人创造平等体验与机会通过个人和企业级产品、服务与倡议赋能残障人士并帮助组织更好地服务其残障学生、员工与客户。档案如何被索引与渲染从 Markdown 到页面的链路集合Collections层面collections.js 定义了多种公司集合I-Stem 档案会按不同维度被纳入getAllCompanies按title字母序排列全部公司对应 All Companies 列表getRecentCompanies按 frontmatter 的addedAt倒序取最近 12 家I-Stem 于 2023-10-08 入库决定其在最近新增区的曝光时机getCompaniesByRegion按region分组I-Stem 归入asia-pacific组getCompaniesByTech按technologies分组I-Stem 同时出现在 JavaScript 与 Python 两个技术分组中。这些集合采用 memoized 的 glob 匹配./src/companies/**/*.md避免在构建中反复过滤数百条记录。模板Layout层面档案页面由 company.njk 渲染I-Stem 的 frontmatter 各字段在此被消费第 11 行careers_url or website决定主按钮——I-Stem 提供了 careers_url因此按钮文案为Apply Now →否则显示 Visit Website第 17-19 行region渲染为可点击的区域标签链接指向/browse/asia-pacific/第 20-22 行remote_policy渲染为政策标签链接指向/browse/remote-friendly/文案由labels.remotePolicy映射为 Remote Friendly第 29-38 行technologies数组渲染为 Tech Stack 小节每个标签链接到/browse/tech/浏览页第 54-56 行updatedAt经formatDate(MMMM D, YYYY)过滤器输出 Last updated: October 8, 2023。页面还通过schema: Organization注入 Organization.njk 结构化数据供搜索引擎理解公司实体信息。如何通过 I-Stem 档案看懂申请流程I-Stem 的careers_url指向其 Wellfound 招聘页。模板会优先使用 careers_url 生成 Apply Now 按钮且按钮带有data-track-outbound属性用于外链点击追踪正文## How to apply小节则再次给出同一申请入口。这说明一条合规档案要求careers_url必须是公司自己的招聘页面而非出售服务的页面详见 CONTRIBUTING.md 的收录标准。对于求职者从档案页可直接获得完整信息闭环远程政策Remote Friendly、招聘区域Asia Pacific / India、技术栈JavaScript、Python、Node.js、React.js、公司规模1-10 人、办公室位置印度 Pune以及一键跳转的申请入口。复现与扩展如何基于该档案格式新增条目仓库 README 与贡献指南提供了完整的增补流程在src/companies/{slug}.md创建文件slug 必须与 frontmatter 一致按模板填写元数据与必填小节运行npm run build验证构建再提交 PR由自动化的Validate Company ProfilesGitHub Action 校验字段合法性并阻止不合规合并。npm install # 安装依赖 npm run build # 验证档案可正常构建I-Stem 档案正是这一格式的标准示例tiny规模、asia-pacific区域、remote-friendly政策、双技术标签外加七个组织清晰的正文小节。对照 CONTRIBUTING.md 中的 frontmatter 模板 与 合法取值表即可举一反三为目录贡献任何一家满足半远程至全远程友好的科技公司标准的条目。小结通过 I-Stem 这一具体样本可以完整看到 remoteintech.company 目录的三层设计frontmatter 提供结构化事实、labels.js 约束取值并统一展示文案、collections 模板负责索引与渲染。无论你是想快速判断一家公司是否适合远程求职还是希望为社区目录贡献新的公司档案理解这层数据规范都能让检索与维护事半功倍。赞分享数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载相关推荐读懂 remoteintech 公司档案以 Jobsity 为例解析 frontmatter 结构、远程政策标签与 Eleventy 渲染链路读懂 remoteintech 公司档案以 Jobsity 为例解析 frontmatter 结构、远程政策标签与 Eleventy 渲染链路 导读 remo数据集解析 remoteintech.company 公司档案以 Homeflic Wegrow 为例读懂 frontmatter 字段与站点渲染链路解析 remoteintech.company 公司档案以 Homeflic Wegrow 为例读懂 frontmatter 字段与站点渲染链路 remote数据集深度解析 remoteintech.company 公司档案数据规范以 Clevertech 档案为例的 Frontmatter 字段、标签体系与渲染机制深度解析 remoteintech.company 公司档案数据规范以 Clevertech 档案为例的 Frontmatter 字段、标签体系与渲染机制 r数据集上一篇pnpm 修补包失效Unused Patch检测修复解析删除依赖后不再静默更新锁文件下一篇Kivy 应用打包分发许可证合规指南Windows、Linux 与 Android 平台依赖授权清单与核查方法创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表