企业官网建设流程全解析

• 数据集

导读

本文以社区维护的远程友好科技公司目录项目remote-jobs（即 remoteintech.company 的源码仓库）中的公司档案 prominent-edge.md 为切入点，完整解读一份公司档案文档的组成结构：frontmatter 元数据如何驱动站点分类、Markdown 正文各小节承载哪些信息、以及这些字段在 Eleventy 构建体系中如何被消费与渲染。读完本文，你将掌握该目录项目的公司数据建模规范、字段合法取值与底层渲染链路，并能据此理解或维护任意一份公司档案。

档案文档整体结构：frontmatter + 标准小节

在 remote-jobs 仓库中，每一家公司的档案都是一个独立的 Markdown 文件，存放在src/companies/目录下，文件名即公司的 slug。Prominent Edge 的档案文件为 src/companies/prominent-edge.md，它由两部分组成：

1. YAML frontmatter 元数据块（文件头部---包裹的区域），承担结构化数据的职责；
2. Markdown 正文小节（以##开头的标准段落），承担人类可读的描述性信息的职责。

这种"元数据 + 正文"的双层结构是仓库对所有公司档案的统一约定，其模板与必填字段规范记录在 CONTRIBUTING.md 中：正文必须包含## Company blurb、## Remote status、## How to apply三个小节，## Company size、## Region、## Company technologies为常用可选小节。Prominent Edge 的档案恰好完整覆盖了全部推荐小节，是一份结构齐全的样例。

Frontmatter 元数据：八项字段与取值规范

Prominent Edge 的 frontmatter 完整展示了该目录项目支持的元数据字段：

--- title: "Prominent Edge" slug: prominent-edge website: https://prominentedge.com/careers region: other remote_policy: fully-remote company_size: small technologies: - cloud - javascript - nosql - sql addedAt: 2020-08-20 updatedAt: 2020-08-20 ---

对照 CONTRIBUTING.md 中的合法取值表，各字段的含义如下：

值得注意的细节：Prominent Edge 档案中的technologies采用的是目录项目的受控标签体系（如cloud、javascript、nosql、sql），而不是自由文本。这些标签的集中定义位于 src/_data/labels.js，其中tech映射表把nosql映射为NoSQL、sql映射为SQL、cloud映射为Cloud，region映射表把other映射为Other，remotePolicy把fully-remote映射为Fully Remote，companySize把small映射为11-50 employees。也就是说，frontmatter 中存的是机器可读的 slug，展示时由构建体系换算成人类可读的标签。

正文小节：从 blurb 到应聘入口

Company blurb：公司的核心简介

## Company blurb Prominent Edge is a mission-focused leader that builds impactful digital solutions and products that improve customer outcomes. We build impactful digital solutions using secure open source technologies. - Web & Mobile - User Experience - Geospatial Solutions (GIS) - DevOps & Automation - Data Analytics & Visualization

该小节给出公司的定位（使命驱动的数字解决方案提供商）与技术方向列表（Web 与移动端、用户体验、GIS 地理空间解决方案、DevOps 与自动化、数据分析与可视化）。这段 blurb 不仅是页面正文，还被构建系统自动加工为搜索引擎 meta description：在 src/companies/companies.11tydata.js 中，Eleventy 的eleventyComputed.description会从页面原始内容里正则匹配## Company blurb之后的文本，剥离 Markdown 链接与强调符号、压缩空白，再截断到约 155 字符生成页面描述。这意味着公司档案无需手工编写 description，blurb 即是其来源。

Company size 与 Remote status：远程文化与规模

## Company size ~25 ## Remote status We have been a fully remote company since our start in 2014. We are heavy on providing a remote-friendly culture. We have daily lightning talks, show and tells, and round tables. We generally meet up for annual retreats in places like Yosemite, Puerto Rico, and Puerto Vallarta. We have flex hours, letting you establish a schedule that works best for you. We let you choose the holidays you'd like to celebrate, any day of the year, accommodating other countries and cultures.

~25的员工规模与 frontmatter 中company_size: small（11-50 人）互相印证。Remote status 小节则具体描述了这家 2014 年成立起即全远程的公司的远程文化实践：每日闪电演讲（lightning talks）、show and tell 与圆桌讨论等仪式化活动，年度线下 retreat，弹性工时，以及可自选假期的跨文化制度。这些细节是求职者评估远程体验的重要一手信息，也是该档案区别于空泛模板的核心内容。

Region：招聘时区与资质要求

## Region We hire internationally within +/- 6 hours from Eastern Time. We prefer US citizenship, as some of our work requires it.

该小节给出了具体的招聘边界：全球招聘但要求候选人与美东时间（Eastern Time）时差在 ±6 小时以内，且部分涉密/合规工作倾向于美国公民。这一"时区 + 资质"双重约束也与 frontmatter 的region: other标签相呼应——它不属于americas/europe等地理大区，而是跨时区招聘的"其他"类型。

Company technologies：实际技术栈清单

## Company technologies - React, React Native, Vue.js, Angular - Node, Python/Django, Java, Scala, GoLang - Postgres, Elasticsearch, RDS - AWS, Azure, GCP - Serverless Framework / Lambda - Distributed Computing, Spark, Hadoop, Accumulo, HBase, Cassandra - Mapbox, OpenLayers, GeoServer

这是正文中最具信息密度的部分，它比 frontmatter 中的四个受控标签（cloud、javascript、nosql、sql）更为细粒度：

• 前端：React、React Native、Vue.js、Angular；
• 后端：Node、Python/Django、Java、Scala、GoLang；
• 存储与检索：Postgres、Elasticsearch、AWS RDS（对应sql/nosql标签）；
• 云平台：AWS、Azure、GCP（对应cloud标签）；
• 无服务器：Serverless Framework / Lambda；
• 大数据与分布式计算：Spark、Hadoop、Accumulo、HBase、Cassandra；
• GIS 地理空间：Mapbox、OpenLayers、GeoServer——与 blurb 中的 Geospatial Solutions 业务方向直接对应。

档案也明确说明：该列表基于客户项目需求与技术负责人决策，实际使用技术栈会动态变化。在仓库中，GIS 方向并非孤例，src/companies/下另有 cartodb、geo-jobe、mapbox 等档案同样涉及地理空间技术，可见这是该目录中一个成体系的细分技术主题。

Office locations 与 How to apply

## Office locations While our headquarters is in Nokesville, VA, USA, we do not have an office. ## How to apply Fill out an application for your favorite role on our careers page: https://prominentedge.com/careers

最后两个小节澄清了一个关键事实：公司注册总部位于美国弗吉尼亚州 Nokesville，但不设实体办公室——这与其 2014 年起的全远程定位完全一致；应聘入口统一指向其 careers 页面。## How to apply是 CONTRIBUTING.md 明确要求的必填小节，保证每份档案都能引导求职者直达申请渠道。

档案如何被站点消费：从 Markdown 到公司页面

一份档案文档最终如何变成网站上的公司详情页，可以通过仓库的构建代码还原出完整链路：

1. 收集阶段：在 src/_config/collections.js 中，getFilteredByGlob('./src/companies/**/*.md')将全部公司档案收拢为集合，并按title字母序排序形成公司列表；getCompaniesByRegion与getCompaniesByTech则分别按region和technologies字段对公司分组，用于生成/browse/{region}/、/browse/{tech}/等浏览页面——这正是region: other、remote_policy: fully-remote这些字段被设为可控取值的原因，它们必须能被分组逻辑精确匹配。
2. 元数据加工：companies.11tydata.js中的eleventyComputed为每个公司页面自动计算description（源自 blurb，见上文）。
3. 渲染阶段：布局文件 src/_layouts/company.njk 负责最终输出。它根据careers_url或website生成 "Apply Now"/"Visit Website" 按钮，把region、remote_policy渲染为可点击的分类标签（跳转到对应浏览页），将technologies逐个渲染为 Tech Stack 标签，并在页脚展示updatedAt格式化后的最后更新时间。
4. 标签映射：页面上的所有标签文本都来自 src/_data/labels.js 这一"单一事实来源"，它同时被 Nunjucks 模板（通过全局labels.*）与 JS 侧（通过 src/_data/companyHelpers.js 重新导出的regionLabels、techLabels等）消费，保证整站展示口径一致。

从源码结构可以推断，frontmatter 字段的设计原则是"机器可读、可控枚举、可聚合"：region、remote_policy、company_size、technologies全部是有界取值，使站点能够稳定地按维度聚类与浏览；而正文 Markdown 则承担自由描述的职责，二者互补构成了这份档案文档的完整信息模型。

如何本地查看与校验公司档案

该仓库是 remoteintech.company 的源码（项目描述与 README.md 均有说明），如需本地查看档案渲染效果，可执行：

npm install # 安装依赖 npm run start # 启动开发服务器（热重载） npm run build # 生产构建

需要 Node.js 22+ 环境。新增或修改公司档案时，应遵循 CONTRIBUTING.md 的流程：在src/companies/{slug}.md创建文件、填写 frontmatter 与必填小节、运行npm run build验证构建通过；addedAt/updatedAt日期字段由维护者管理，提交 PR 时无需自行填写。仓库内还提供 scripts/check-links.sh 与 scripts/fix-links.mjs 等链接检查脚本，可用于校验档案中的外链有效性（详见 scripts/README.md）。

小结

以 Prominent Edge 档案为样本可以看出，remote-jobs 目录项目的每份公司文档都遵循统一的"frontmatter 受控元数据 + 标准 Markdown 小节"双轨结构：前者为分类、浏览、SEO 描述等机器消费场景提供稳定可枚举的字段，后者为求职者提供规模、远程文化、时区要求、技术栈与应聘入口等深度信息。理解这一模型，就等于掌握了阅读与维护该目录中任意一份公司档案（包括 mapbox.md、cartodb.md 等同主题档案）的方法论。

• 数据集