多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

remote-jobs 仓库公司档案解析:以 Spoqa 为例的远程友好企业数据模型与贡献指南

remote-jobs 仓库公司档案解析:以 Spoqa 为例的远程友好企业数据模型与贡献指南 数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载本篇文章以 remote-jobs 仓库中的 Spoqa 公司档案 为样本拆解该目录项目如何用「Frontmatter 元数据 Markdown 正文」两个层次描述一家远程友好科技公司并延伸讲解字段校验、页面渲染、社区贡献与链接维护的完整闭环。读完本文你将能读懂任意一份公司档案的结构掌握提交或维护这类档案所需的全部字段约定与工作流。从一份公司档案看 remote-jobs 的数据组织方式remote-jobs即 remoteintech.company 站点的源码仓库是一个由社区维护的远程友好科技公司目录。目录中的每一家公司对应src/companies/目录下的一个 Markdown 文件文件名为公司 slug例如spoqa.md。整个站点由 Eleventy 构建集合配置 通过collection.getFilteredByGlob(./src/companies/**/*.md)一次性读取所有公司档案再按标题字母序、地区、技术标签、加入时间等维度重新组织成页面数据。Spoqa 公司档案 是该目录中一份典型的亚太地区asia-pacific档案它的文件结构分为两大部分Frontmatter---包裹的 YAML 区块机器可读的标准化元数据用于分类、检索与排序Markdown 正文以##小节组织的人类可读信息用于最终页面展示。下面分别深入这两部分。Frontmatter机器可读的标准化元数据Frontmatter 是公司档案的核心骨架站点所有分类、筛选、排序逻辑都依赖它。以 spoqa.md 为例--- title: Spoqa, Inc. slug: spoqa-inc website: https://spoqa.co.kr/ careers_url: https://spoqa.co.kr/careers/#recruit region: asia-pacific remote_policy: remote-friendly company_size: small technologies: - java - javascript - ml - mobile - python addedAt: 2015-10-15 updatedAt: 2022-08-20 ---各字段的语义与取值范围如下以 contributing 指南 与 标签定义 为准字段含义本档案取值title展示用公司全名Spoqa, Inc.slugURL 标识须与文件名对应spoqa-incwebsite官网地址https://spoqa.co.kr/careers_url招聘页面地址https://spoqa.co.kr/careers/#recruitregion招聘地区取worldwide/americas/europe/americas-europe/asia-pacific/otherasia-pacificremote_policy远程政策取fully-remote/remote-first/hybrid/remote-friendlyremote-friendlycompany_size规模档位取tiny(1-10) /small(11-50) /medium(51-200) /large(201-1000) /enterprise(1000)smalltechnologies标准化的技术标签列表java、javascript、ml、mobile、pythonaddedAt加入目录日期2015-10-15updatedAt最近更新日期2022-08-20这些取值并非自由字符串而是受控枚举。单一事实来源在 标签定义文件它定义了地区、远程政策、公司规模与技术四类标签的展示文案并被 companyHelpers.js 重新导出供 JavaScript 集合逻辑和 Nunjucks 模板共同使用。例如remote-friendly在页面上会显示为 Remote Friendlyasia-pacific显示为 Asia Pacificml显示为 ML/AI。addedAt与updatedAt两个日期字段还直接驱动站点的最近加入栏目集合配置 中的getRecentCompanies会按addedAt倒序取出最近 12 家公司页面页脚则由 公司布局模板 读取updatedAt渲染 Last updated 信息。一个值得注意的数据口径问题对比 spoqa.md 的两处规模信息可以发现口径差异Frontmatter 中company_size: small按 标签定义 对应 11-50 人而正文 ## Company size 小节写的是 50-100 人。这提示读者Frontmatter 的档位是粗粒度分类用于筛选聚合正文的数字才是精确信息二者在部分历史档案中可能存在轻微不一致——这正是该目录持续接受社区校对的原因之一见下文如何贡献。Markdown 正文面向读者的信息小节Frontmatter 之下正文按固定模板组织。根据 contributing 指南标准模板要求依次包含Company blurb、Company size、Remote status、Region、Company technologies、Office locations、How to apply七个小节。Spoqa 档案完整遵循了这一模板。Company blurb公司简介Spoqa provides a tablet-based membership application named Dodo Point. Also, Spoqa has a partnership with Carry Protocol.这段简介是公司的核心描述。它还有一层隐藏用途companies.11tydata.js 中的eleventyComputed.description会自动从## Company blurb标题后的首段提取文本剥离 Markdown 链接语法、去掉星号下划线等格式符号压缩空白后截断到约 155 个字符作为页面的 meta description 输出。这意味着简介写得好不好直接决定该页面在搜索引擎结果里的摘要质量。Remote status远程状态——本文档的实践亮点We are now providing full remote system for employees. If you want to work remotely, just share your plan to your team and its ok. Every information should be shared by online (Slack, Jira, and Confluence) so that you can do every tasks remotely.Spoqa 的远程实践描述包含两条核心信息低门槛协作模式员工想远程办公只需向团队同步计划即可无需复杂审批全在线信息流日常沟通Slack、项目管理Jira、知识沉淀Confluence全部线上化保证任何任务可异地完成。这与 Frontmatter 中remote_policy: remote-friendly远程友好的档位定位一致说明该字段的语义是支持远程、但不强制全员远程。Region地区与 Office locations办公地点档案声明业务地区为韩国与日本并列出三个实体办公室首尔Gangnam-gu、釜山Haeundae-gu与东京Shibuya。目录规范要求列出实体办公室位置若完全远程则写 None。这条信息与 Frontmatter 的region: asia-pacific呼应——集合配置 中的getCompaniesByRegion正是依据该字段把公司归入亚太分组。Company technologies技术栈的双层表达值得注意的是Spoqa 档案存在两套技术描述Frontmatter 中的受控标签java、javascript、ml、mobile、python用于聚合筛选取值须在 标签定义 的tech映射内正文小节的自由文本Python、Swift、Kotlin、React、HTML5、SCSS、Solidity用于页面展示的具体技术栈。从源码结构看页面布局 company.njk 会读取 Frontmatter 的technologies数组渲染为 Tech Stack 标签区每个标签链接到/browse/{tech}/浏览页而正文自由文本则原样渲染在简介内容区。两套信息互相补充前者保证可机器聚合后者保留真实细节。档案如何渲染成页面公司档案并非裸 Markdown而是通过 公司布局模板 渲染。该模板的行为包括若存在careers_url则优先渲染 Apply Now 按钮否则渲染 Visit Website 按钮链接指向website根据region与remote_policy渲染可点击的筛选标签分别链接到/browse/{region}/与/browse/{remote_policy}/标签文案取自 标签定义将正文content与 Frontmatter 的technologies标签区组合输出并设置schema: Organization结构化数据页脚根据updatedAt展示最近更新时间。此外所有公司档案共享 companies.json 中声明的layout: company保证渲染模板全局一致。站点还通过 集合配置 的getCompanyTags把每家公司按技术、地区、远程政策三类维度聚合供浏览页使用。如何贡献或维护一份公司档案如果你要新增一家公司contributing 指南 给出完整流程在src/companies/下新建company-name.md按指南中的模板填充 Frontmatter 与七个正文小节字段取值须符合受控枚举地区、远程政策、公司规模、技术标签本地运行npm run build:11ty验证构建通过提交 Pull Request。若发现某家公司信息过时例如 Spoqa 的updatedAt停留在 2022-08-20可以在对应公司页面点击 Edit on GitHub 按钮直接修订后提 PR。目录对收录有明确门槛例如必须能核实信息、公司直接雇佣员工、提供真实的远程岗位、careers_url指向公司自己的招聘页而非推销服务页等。链接健康档案数据质量的自动化保障公司档案中的网址Frontmatter 的website、careers_url与正文链接会随时间失效仓库为此准备了独立的维护脚本管线详见 scripts/README.md./scripts/check-links.sh # 全量扫描 src/companies/*.md 中所有外链输出 link-check-results.csv node scripts/fix-links.mjs # 依据扫描结果生成 link-fix-plan.md 修复计划 node scripts/fix-links.mjs --reverify --apply # 复核被限流的行并应用安全修复扫描结果会按OK、HTTPS_UPGRADE、CAREERS_DEAD、NOT_FOUND、PARKED等类别分类其中CAREERS_DEAD招聘页已失效会被自动移除careers_url字段PARKED与DEAD_DNS的档案甚至会被建议整体删除。这正是像 Spoqa 这类 2015 年加入、2022 年最后更新的历史档案得以长期保持数据新鲜度的机制保障。小结通过 Spoqa 公司档案 这一个样本可以完整看到 remote-jobs 目录的数据模型Frontmatter 承载可聚合的标准化分类地区、远程政策、规模、技术标签、时间戳Markdown 正文承载可阅读的详细描述远程状态、办公地点、技术栈、申请方式二者经 公司布局模板 渲染为统一的公司页面再被 集合配置 按多种维度聚合。理解这一模型后你既能快速读懂目录中任意一家公司档案也能按照 contributing 指南 以同样的模板规范提交新档案或修订旧档案。赞分享数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载相关推荐remote-jobs 仓库公司档案深度解析以 IDoneThis 档案为例看远程友好公司的目录数据结构remote jobs 仓库公司档案深度解析以 IDoneThis 档案为例看远程友好公司的目录数据结构 remote jobsRemote In Tech数据集gogcli 实战使用 gog drive changes start-token 获取 Drive 变更起始页令牌gogcli 实战使用 gog drive changes start token 获取 Drive 变更起始页令牌 gog drive changes st数据集remote-jobs 公司档案深度解析以 Predict Mobile 为例的远程友好型企业数据结构与渲染链路remote jobs 公司档案深度解析以 Predict Mobile 为例的远程友好型企业数据结构与渲染链路 Predict Mobile 是 remot数据集上一篇Nile运行时环境详解轻松掌握跨平台部署的关键技术下一篇32B模型效率革命IBM Granite 4.0-H-Small FP8动态量化技术重塑企业级AI部署创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表