企业官网建设流程全解析

• 数据集

remoteintech.company（本仓库 remote-jobs 构建的站点）是一个由社区维护的远程友好科技公司目录，其核心数据单元就是src/companies/下的一篇篇公司档案。本文以 src/companies/wombat-security.md 为完整案例，逐字段拆解这套档案格式的 frontmatter 元数据与 Markdown 正文规范，并追踪其在 Eleventy 数据管线（集合、计算属性、标签分类）中的实际流转方式。读完本文，你将掌握该目录公司档案的标准写法、远程政策取值的真实语义，以及这些字段如何驱动页面渲染、浏览分类与 SEO 元信息生成。

档案全景：frontmatter 元数据 + Markdown 正文的双层结构

每份公司档案都是一篇独立的 Markdown 文件，位于 src/companies/ 目录下，由两部分组成：

1. frontmatter（YAML 元数据块）——机器可读的结构化字段，供 Eleventy 构建管线消费；
2. Markdown 正文——以##二级标题组织的人类可读内容。

以wombat-security.md为例，其 frontmatter 完整如下：

--- title: "Wombat Security Technologies" slug: wombat-security-technologies website: https://www.wombatsecurity.com/ careers_url: https://proofpoint.wd5.myworkdayjobs.com/ProofpointCareers/6/refreshFacet/318c8bb6f553100021d223d9780d30be region: americas remote_policy: hybrid company_size: large addedAt: 2018-04-24 updatedAt: 2022-10-03 ---

正文部分则包含## Company blurb、## Company size、## Remote status、## Region、## Office locations、## How to apply六个小节。这套"元数据 + 正文"结构正是仓库 CONTRIBUTING.md 中规定的标准档案模板：slug 必须与文件名一致，正文必须包含Company blurb、Remote status、How to apply三个必备小节，Company size、Region等为常用可选小节。

字段级解析：每个 frontmatter 键的含义与取值范围

档案字段并非随意命名，而是与站点标签系统严格对齐。仓库把取值定义收敛在唯一事实源 src/_data/labels.js 中，并由 src/_data/companyHelpers.js 通过regionLabels、remotePolicyLabels、companySizeLabels等导出供 JS 与模板双端复用。各字段分析如下：

值得注意的细节：company_size的档位划分在 labels.js 中定义，large对应 201–1000 人；而档案正文Company size小节写明 "1,000 - 5,000 (source - Glassdoor)"，二者看似不一致，实则是"结构化档位"与"自由文本补充说明"的关系——frontmatter 供机器分类与标签聚合，正文则保留更精确、附数据来源的说明。

Company blurb：从 CMU 研究孵化到被 Proofpoint 收购

正文首个核心小节## Company blurb负责用 2–3 句话交代公司背景。Wombat 档案的 blurb 提供了完整且时间线清晰的叙述：

• 2008 年 6 月成立：由卡内基梅隆大学（Carnegie Mellon University，CMU）计算机科学学院的三位教授 Drs. Norman Sadeh、Jason Hong、Lorrie Cranor 共同创立，公司源自 CMU 的学术研究；
• 2018 年 3 月被收购：被下一代安全与合规公司 Proofpoint 收购，这一里程碑也被记录在addedAt: 2018-04-24中（档案于收购后约一个月被收录进目录）；
• 品牌演进：公司现名 Proofpoint Security Awareness Training（安全意识培训产品线），Wombat 品牌并入 Proofpoint。

这段 blurb 是档案的"灵魂"，因为它不仅服务人类读者，还被机器消费——src/companies/companies.11tydata.js 中的eleventyComputed.description计算属性会正则匹配## Company blurb标题后的段落（/##\s*Company\s*blurb\s*\n+([\s\S]*?)(?=\n##|$)/i），剥离 Markdown 标记、合并换行后截断至约 155 字符，自动生成页面的 meta description（src/companies/companies.11tydata.js#L9-L60）。也就是说：写好 blurb，就等于同时写好了 SEO 描述，这是该档案格式的一个高杠杆设计。

Remote status 与 hybrid 政策：字段语义与页面渲染

## Remote status小节与 frontmatter 的remote_policy: hybrid共同描述公司的远程工作形态。Wombat 档案的原文说明是：

Some employees work full-time from our offices and some work remotely anywhere in the US or near our other offices (England, France, Netherlands, Madrid and Italy).

这段描述与hybrid标签的语义完全吻合：并非全公司远程（对应fully-remote），也非以远程为默认（对应remote-first），而是"一部分人坐班、一部分人远程"的混合模式，且远程范围受地域限制（仅限美国境内或欧洲各办公室附近）。

在渲染层面，remote_policy和region字段由 src/_layouts/company.njk 消费：region渲染为指向/browse/{region}/的地区标签，remote_policy渲染为指向/browse/{remote_policy}/的政策标签，标签文案经labels.region[region]、labels.remotePolicy[remote_policy]查表（company.njk#L17-L22）。同时，src/_config/collections.js 中的getCompanyTags会遍历全部档案，按region、remote_policy、technologies三个维度聚合出带计数的标签列表（collections.js#L134-L194），驱动站点的浏览/标签页面。

办公地点与招聘入口：文档映射的站点行为

## Office locations与## How to apply两个小节看似简单，却在页面生成中扮演具体角色：

• ## Office locations写明 "Pittsburgh, USA"，与## Region中的 "Offices in USA (Pittsburgh and Denver) and London" 形成互补：前者给出总部位置，后者给出更完整的办公网络；
• ## How to apply提供招聘入口。页面上的 "Apply Now" 主按钮由 company.njk 生成：{% set buttonUrl = careers_url or website %}——优先使用 frontmatter 的careers_url，若未填写则回退到website。对 Wombat 档案而言，careers_url指向 Proofpoint 的 Workday 招聘门户，因此按钮文案固定为 "Apply Now" 而非 "Visit Website"。

此外，updatedAt字段会在档案页脚渲染为 "Last updated" 信息（company.njk#L54-L56），经formatDate过滤器格式化为MMMM D, YYYY形式。

档案如何进入站点：集合、排序与筛选

src/companies/**/*.md下的每份档案会自动汇入 Eleventy 的companies集合，相关集合定义位于 src/_config/collections.js：

• getAllCompanies：按title字母序排序后用于 src/pages/companies.njk 的公司总览网格；
• getRecentCompanies：按addedAt倒序取前 12 家，用于首页"最近收录"区块；
• getCompaniesByRegion/getCompaniesByTech：按地区/技术分组。

在 companies.njk 页面中，每家公司渲染为带data-region、data-name属性的卡片节点，前端脚本根据用户选择的地区下拉框做客户端过滤，并支持 Pagefind 全文搜索（companies.njk#L55-L102）。Wombat 档案因region: americas会被归入 Americas 分组、出现在对应筛选结果中。

验证与维护：一份合格档案的底线

结合 CONTRIBUTING.md 可以提炼出此类档案的质量门槛：

• 格式校验：仓库通过 "Validate Company Profiles" GitHub Action 自动校验涉及公司文件的 PR，检测 slug 与文件名一致性、必备小节缺失、字段取值非法等问题，并提示"older file format"迁移；
• 收录标准：公司须"半远程至全远程友好"且处于科技行业周边，直接雇佣员工（排除招聘代理、自由职业平台），提供真实远程职位（薪资制或时薪制，纯佣金/独立承包不计数），careers_url必须指向公司自有招聘页；
• 维护原则：若公司业务变更导致不再符合收录标准，通常删除档案而非改写；addedAt/updatedAt由维护者管理，贡献者提交 PR 时不应携带这两个字段。

Wombat 档案本身经历了完整的生命周期：2018 年被收购后收录（addedAt），2022 年随品牌演进而更新（updatedAt），正文明确写出 "Today the company name is Proofpoint Security Awareness Training"——这正是社区目录"随公司事实演变而迭代"的典型样本。

小结

src/companies/wombat-security.md虽然只是 remoteintech.company 目录中数百份档案之一，却完整覆盖了这套公司档案格式的全部要素：与标签系统对齐的 frontmatter 枚举值、由 blurb 自动推导的 meta description、被careers_url/website驱动的按钮逻辑、以及按region/remote_policy聚合的浏览分类。理解这份档案，就等于理解了该目录的数据建模方式——无论是作为求职者评估远程机会，还是作为贡献者提交新公司，你都能准确预判每个字段在站点上的最终表现。

• 数据集