ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

从 Manifold 档案读懂 Remote In Tech:远程公司目录的 frontmatter 规范与页面渲染原理

从 Manifold 档案读懂 Remote In Tech:远程公司目录的 frontmatter 规范与页面渲染原理 数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载Manifold 是 Remote In Tech 社区远程公司目录中的一份经典档案它完整展示了「远程友好型科技公司」如何被结构化记录、校验并被静态站点渲染出来。本文将逐字段拆解这份档案结合仓库中的标签定义、页面模板与集合逻辑讲解一份公司档案从 Markdown 数据到最终 HTML 页面的完整链路读完你既能看懂 Manifold 的团队与远程实践也能掌握为同类公司新增或维护档案的实操方法。Manifold 是谁Company blurb 解读manifold.md的正文第一节## Company blurb给出了对 Manifold 的定位Were an ambitious and well-funded startup, making it compelling for developers to break their deployments free from the closed ecosystems of cloud providers. We connect applications, wherever they are hosted, to independent cloud services made by developers who care.这段描述传达了两个关键信息Manifold 是一家资金充足的创业公司核心产品是让开发者把部署从云厂商的封闭生态中解放出来并将「托管在任何位置的应用」连接到「由开发者维护的独立云服务」。团队背景上文档提到多数成员与开源世界联系紧密曾效力于 Heroku、Salesforce、Red Hat、Canonical 等公司——这也解释了档案技术栈中大量云原生与开源工具的出现。档案元数据frontmatter 结构详解与目录中其他约 850 家公司档案一致Manifold 的所有结构化元数据都存放在文件开头的 YAML frontmatter 中--- title: Manifold slug: manifold website: https://manifold.co region: other remote_policy: hybrid company_size: small technologies: - devops - go - javascript - sql addedAt: 2017-07-04 updatedAt: 2018-04-16 ---各字段的取值约束与含义如下字段合法值定义在 src/_data/labels.js 中是全仓库唯一的标签来源字段本档案取值含义允许取值labels.js / CONTRIBUTING.mdtitleManifold公司显示名称任意字符串slugmanifold页面与文件名标识必须与文件名manifold.md一致任意小写 slugwebsitehttps://manifold.co公司官网任意合法 URLregionother招聘地区worldwide/americas/europe/americas-europe/asia-pacific/otherremote_policyhybrid远程政策fully-remote/remote-first/hybrid/remote-friendlycompany_sizesmall公司规模档位tiny(1-10) /small(11-50) /medium(51-200) /large(201-1000) /enterprise(1000)technologiesdevops, go, javascript, sql技术标签slug见 labels.js 的tech映射共 25 个合法值addedAt/updatedAt2017-07-04/2018-04-16收录与更新时间由维护者管理PR 中勿自行填写注意technologies存储的是机器可读的 slug而不是展示文本。例如本档案中的devops、go、javascript、sql会分别被 labels.js 映射为DevOps、Go、JavaScript、SQL再渲染到页面上。而正文## Company technologies一节列出的则是人类可读的技术栈描述React、Go、Postgres、Swagger、Terraform、Kubernetes、Manifold、Git 与 GitHub二者互为补充frontmatter 用于分类与筛选正文用于详细说明。团队规模与远程状态正文## Company size与## Remote status两节补充了量化的团队信息团队规模约 25 人截至 2018 年 1 月与 frontmatter 中company_size: small11-50 人档位一致。远程状态文档明确标注 Strongly supported强烈支持远程。约 50% 成员位于加拿大哈利法克斯Halifax的总部办公室少数在旧金山其余成员完全远程办公管理层exec team则分散在 Halifax、旧金山与远程三个位置。这种「部分分布式 管理层跨地点」的组织形态正是档案中remote_policy: hybrid的由来——它既不是fully-remote的纯远程也不是remote-friendly的仅宽容态度而是混合办公模式。该取值会被 src/_layouts/company.njk 渲染为一个指向/browse/hybrid/的标签链接方便访客按远程政策浏览同类公司。跨时区协作Region 字段的实战含义## Region一节给出了具体的时间协作范围UTC-9 to UTC1. Time shifting at the boundaries is typically necessary.即团队成员横跨从 UTC-9如美国西海岸/阿拉斯加时区到 UTC1如中欧时区的约 10 个时区边界时区的成员通常需要做时间错位time shifting来保证重叠工作时间。这与 frontmatter 中region: other的归类一致——它并不局限于某个大洲因此被归入「Other」而非americas或europe。在 src/_config/collections.js 的按地区分组逻辑中region缺失或未识别的公司统一落入other分组。技术栈清单Company technologies正文的## Company technologies罗列了 Manifold 的完整技术栈React前端Go后端主力Postgres数据库SwaggerAPI 文档与契约Terraform基础设施即代码Kubernetes容器编排Manifold自家平台产品同时出现在技术栈中Git 和 GitHub协作与版本控制这份清单解释了 frontmatter 中go、devops、javascript、sql四个技术标签的来源Go 与 DevOps 是核心JavaScript 对应 React 前端SQL 对应 Postgres 数据层。在页面渲染时company.njk 模板 会遍历 frontmatter 的technologies数组为每项生成指向/browse/{tech}/的标签链接访客点击即可发现使用相同技术的其他远程公司。办公地点与应聘方式## Office locations明确了两处实体办公点总部HQ加拿大新斯科舍省哈利法克斯Halifax, NS旧金山办公室San Francisco## How to apply一节指向 Manifold 官方招聘页面。从数据结构看Manifold 档案的 frontmatter 中并未设置careers_url字段因此 company.njk 模板 中的主按钮会按careers_url or website的优先级回退到website公司官网按钮文案也相应显示为 Visit Website 而非 Apply Now。这一细节提示维护者想让求职者直达投递入口应在 frontmatter 中显式补充careers_url。档案如何变成页面渲染链路全景Manifold 档案从 Markdown 到 HTML 的渲染链路由 Eleventy 驱动核心节点如下数据加载src/companies/companies.json 为整个目录统一指定layout: companysrc/companies/companies.11tydata.js 为每份档案自动生成 SEO meta description——它从## Company blurb标题后截取正文、剥离 Markdown 语法并截断到约 155 字符。页面模板src/_layouts/company.njk 读取 frontmatter 渲染标题、地区标签、远程政策标签、技术栈标签以及 Last updated由updatedAt格式化信息。集合组织src/_config/collections.js 中的getAllCompanies将所有档案按标题字母序排列getCompaniesByRegion与getCompaniesByTech则按地区/技术分组供/browse/页面与标签页使用getRecentCompanies依据addedAt选出最近 12 家新收录公司。标签映射所有展示文本最终都经由 src/_data/companyHelpers.js 的getRegionLabel、getRemotePolicyLabel、getCompanySizeLabel、getTechLabel从 labels.js 取词保证枚举值有且仅有一个权威来源。因此Manifold 档案中的每一个字段都不是「死数据」而是会被目录的首页、浏览页、标签页、站点地图sitemap与搜索索引复用的结构化实体。为同类公司新增档案的实操指引若你想为一家与 Manifold 类似的远程友好型科技公司补充档案可参照 CONTRIBUTING.md 与 src/pages/contributing.md 中的规范在src/companies/下新建{slug}.md确保文件名与 frontmatter 的slug一致填写 frontmatter 模板title、slug、website、careers_url、region、remote_policy、company_size、technologies正文必须包含三个必需小节## Company blurb、## Remote status、## How to apply## Company size、## Region、## Company technologies、## Office locations为常用可选小节Manifold 档案全部包含是很好的完整范例运行npm run build验证构建通过需 Node.js 22详见 README.md提交 PR由 GitHub Action 的校验机器人检查字段合法性与内容完整性。同时注意目录的收录边界只收录半远程到全远程的科技公司、直接雇佣员工、提供真正的远程职位薪资制或时薪制不含纯佣金销售岗且careers_url必须指向公司自身的招聘页面。小结Manifold 档案是理解 Remote In Tech 目录数据模型的最佳样本之一frontmatter 提供机器可读的分类维度地区、远程政策、规模、技术栈正文小节提供求职者关心的人文信息团队规模、远程程度、时区、办公室、应聘方式而 company.njk 模板与 collections.js 集合逻辑把二者无缝衔接成可浏览、可筛选、可检索的页面。对照src/companies/manifold.md逐字段阅读即可举一反三地掌握整个目录的档案规范。赞分享数据集【免费下载链接】remote-jobsSource for remoteintech.company — a community-maintained directory of remote-friendly tech companies项目地址https://gitcode.com/GitHub_Trending/re/remote-jobs点击查看免费下载相关推荐SeaTunnel BosFile Source 连接器从百度云 BOS 对象存储读取数据的完整实战指南SeaTunnel BosFile Source 连接器从百度云 BOS 对象存储读取数据的完整实战指南 本文以 SeaTunnel 官方文档 docs/en数据集解读 IBM 远程工作档案Remote In Tech 公司目录的数据模型与渲染原理解读 IBM 远程工作档案Remote In Tech 公司目录的数据模型与渲染原理 IBM国际商业机器公司是全球科技行业的标志性企业而本仓库 remo数据集DataCamp 远程友好公司档案全解析从 frontmatter 字段到 Remote In Tech 目录渲染管线DataCamp 远程友好公司档案全解析从 frontmatter 字段到 Remote In Tech 目录渲染管线 本文以 Remote In Tech数据集创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表