企业官网建设流程全解析

• 数据集

本文以 src/companies/redmonk.md 这份公司档案为骨架，讲解 remoteintech.company 目录中"远程友好科技公司"档案的标准结构与完整内容：从 frontmatter 字段、正文必选章节到站点渲染、自动化校验的完整链路。读完你将掌握本仓库公司档案的字段语义、合法取值、提交与构建流程，并能独立读懂或维护任意一份src/companies/*.md档案。

RedMonk 是谁：开发者视角的行业分析机构

依据档案中的Company blurb原文，RedMonk 是一家"面向开发者的行业分析机构"（developer-focused industry analyst firm），其业务形态围绕开发者展开，典型场景包括：

• 数据驱动决策：梳理公开的技术采用数据（public adoption numbers），为产品团队选择新支持的编程语言提供建议；
• 开发者营销：帮助市场团队打磨开发者友好的沟通话术；
• 趋势研判：帮助高级管理层理解新兴的开发者主导趋势（emerging developer-led trends）及其影响。

一句话概括：RedMonk 存在的意义，是帮助各类公司理解开发者、并与开发者协作。

档案结构总览：frontmatter + 七个 Markdown 章节

redmonk.md是仓库标准的公司档案文件，由两部分组成：文件头部的 YAML frontmatter 与正文的##章节。先看完整 frontmatter：

--- title: "RedMonk" slug: redmonk website: https://redmonk.com careers_url: https://redmonk.com/about/ region: worldwide remote_policy: fully-remote company_size: tiny addedAt: 2018-04-24 updatedAt: 2020-10-31 ---

正文部分共七个##章节：Company blurb、Company size、Remote status、Region、Company technologies、Office locations、How to apply。其中前三个（blurb、Remote status、How to apply）是 CONTRIBUTING.md 中规定的必选章节，其余为常用可选章节。校验脚本 .github/scripts/validate-companies.js 的REQUIRED_SECTIONS = ["Company blurb", "Remote status", "How to apply"]与之一一对应，缺一即无法通过 CI 校验。

Frontmatter 字段逐项解析：合法取值与渲染逻辑

每个字段都由仓库的单一事实来源 src/_data/labels.js 定义合法取值，并由 src/_data/companyHelpers.js 提供标签映射查询函数。

校验脚本 .github/scripts/validate-companies.js 正是从labels.js读取键集合生成VALID_REGIONS、VALID_REMOTE_POLICIES、VALID_COMPANY_SIZES、VALID_TECHNOLOGIES，再配合REQUIRED_FIELDS = ["title", "slug", "website", "region", "remote_policy", "company_size"]校验必填字段——新增一个标签只需改一处（labels.js），校验与渲染同步生效，这是该仓库"单一事实来源"设计的核心体现。

正文七个章节的内容细节

Company blurb：公司定位

本档案完整保留了 blurb 原文，描述 RedMonk 作为开发者行业分析机构的三类核心业务：为产品团队提供语言选型数据建议、帮助营销团队打造开发者友好话术、协助管理层理解开发者主导的新趋势。

blurb 还有一个重要作用：如果档案未显式设置description，src/companies/companies.11tydata.js 的eleventyComputed会自动截取## Company blurb标题后的段落，清洗掉 Markdown 标记（链接、加粗、反引号）后截断到约 155 字符生成页面 meta description——先尝试在句号处截断，否则在空格处截断并追加省略号。

Company size：tiny 分档，团队约 7 人

正文写明 "7 team members shown on the team page"，即团队页面公示约 7 名成员。frontmatter 中company_size: tiny对应 labels.js 中tiny → '1-10 employees'，渲染时通过getCompanySizeLabel映射为可读文案。这也解释了为什么公司规模与"实际团队人数"是两套信息：前者是目录统一分档，后者是档案中的自由描述。

Remote status：时区即远程边界

"Check the time zone." 是整份档案最精炼的远程政策描述——RedMonk 允许全球远程协作，但协作前提是对时区保持敏感。这与remote_policy: fully-remote的定性一致：无需打卡、不受办公地点约束，但异步协作的纪律（时区意识）仍然是隐含要求。

Region：worldwide，全球招聘

region: worldwide表明招聘范围覆盖全球。在 src/_config/collections.js 的getCompaniesByRegion中，region字段直接决定档案归属哪个地域浏览分组；worldwide也是默认兜底值（company.data.region || 'other'）。

Company technologies：研究型机构的技术栈

正文描述为 "Software ecosystems and convergence, research and technology trends"——注意 RedMonk 的技术定位不是某个具体语言或框架，而是软件生态与融合、研究与技术趋势。这也是它与其他技术公司档案（如 automattic.md 声明 JavaScript/PHP/Spark/Kafka 等具体技术栈）的显著差异。本档案 frontmatter 未声明technologies数组，因此在站点渲染时（见 src/_layouts/company.njk 的{% if technologies and technologies.length > 0 %}判断）不会出现 "Tech Stack" 标签区块。

Office locations：波特兰办公室

RedMonk 95 High Street Suite 206 Portland, ME 04101

档案注明实体办公地址位于美国缅因州波特兰市。公司拥有注册办公室，但远程政策仍是 fully-remote，这恰好说明"有办公室"与"全员远程"并不冲突——许多远程友好公司的实体地址仅用于注册、会议与偶尔的线下聚会。

How to apply：不常有岗位开放

We don't always have job openings. See the Work at RedMonk for more information.

这段明确了两点：一是 RedMonk并非常年招聘，二是申请入口统一指向careers_url对应的官方页面。careers_url在渲染时优先级高于website——company.njk 中的按钮逻辑为careers_url or website，有招聘页则显示 "Apply Now"，否则显示 "Visit Website"。对于这类"间歇性招聘"的公司，求职者应主动关注其招聘页动态，而非依赖第三方渠道。

档案如何被站点消费：渲染、排序与标签链路

一份src/companies/*.md档案在构建期会经过完整的数据管线：

1. 集合收集：collections.js 通过getFilteredByGlob('./src/companies/**/*.md')收录全部档案，getAllCompanies按标题字母序排序生成公司列表页；
2. 页面渲染：src/_layouts/company.njk 将 frontmatter 渲染为：title→ H1 渐变标题、careers_url or website→ 主按钮、region→ 地域标签（链接到/browse/{region}/）、remote_policy→ 政策标签、technologies→ Tech Stack 区块、updatedAt→ 页脚 "Last updated: {{ updatedAt | formatDate('MMMM D, YYYY') }}"。RedMonk 档案updatedAt: 2020-10-31，站点会如实显示该更新日期；
3. 标签聚合：getCompanyTags从每份档案的technologies、region、remote_policy字段动态聚合浏览标签，因此 RedMonk 会自动出现在 "Worldwide" 地域与 "Fully Remote" 远程政策两个标签页下。

自动化校验：档案质量如何被 CI 保障

当提交涉及src/companies/**的 PR 时，工作流 .github/workflows/validate-companies.yml 会运行Validate Company Profiles校验，检查项包括：

• 必填字段（title、slug、website、region、remote_policy、company_size）是否齐全；
• slug与文件名是否一致；
• 字段取值是否属于 labels.js 定义的合法枚举；
• 必选章节（Company blurb、Remote status、How to apply）是否存在。

RedMonk 档案完全符合上述全部约束，可作为新增档案的对照范本。若想本地验证，可按 README.md 的说明在仓库根目录执行：

npm install # 安装依赖（需要 Node.js 22+） npm run build # 生产构建，确认档案能正常编译 npm run start # 本地开发服务器，支持热更新，可直接预览档案页面

小结：从一份档案看目录型项目的设计精髓

redmonk.md看似只是一份约 30 行的 Markdown，实则是整个 remoteintech.company 目录体系的最小单元：frontmatter 承载结构化元数据（地域、远程政策、规模、技术栈），正文承载人类可读的叙述信息，而 labels.js、companyHelpers.js、collections.js、company.njk 与 validate-companies.js 则分别负责取值约束、标签映射、集合聚合、页面渲染与质量门禁。对求职者而言，RedMonk 是一家"全球远程、团队约 7 人、关注开发者生态趋势、按需招聘"的行业分析机构——读懂档案背后的数据模型，比只看 blurb 本身更能帮你快速评估一家远程公司的协作形态与申请时机。

• 数据集