企业官网建设流程全解析

• 数据集

导读

本文以 src/companies/a-1-auto-transport.md 这份完整的公司档案（company profile）为标本，系统讲解 remote-jobs（Remote In Tech）仓库中公司条目的数据组织方式：frontmatter 字段及其合法取值、Markdown 正文必须包含的章节、字段如何驱动站点渲染与索引，以及档案如何通过构建与自动化校验进入目录。读完本文，你将掌握 remote-jobs 仓库公司档案的完整数据结构，并理解 A-1 Auto Transport 这样一个"全球范围、完全远程、小型规模"的物流技术公司档案是如何被收录、渲染与展示的。

一、档案文档的整体结构

src/companies/目录下的每个.md文件即一个公司档案，A-1 Auto Transport 的档案由两部分组成：

1. YAML frontmatter：机器可读的结构化元数据，用于分类、索引与渲染；
2. Markdown 正文：以##二级标题组织的可读内容，描述公司背景、远程政策、技术栈与申请方式。

两者的职责边界很清晰：frontmatter 决定了"这个公司如何被归类、打标签、排序"，正文决定了"读者在页面上看到什么内容"。根据 CONTRIBUTING.md 的规范，正文必须包含## Company blurb、## Remote status、## How to apply三个必需章节，其余如## Company size、## Region、## Company technologies为常用可选章节——A-1 的档案正是按此模板写成的完整示例。

二、Frontmatter 字段逐一解析

A-1 Auto Transport 档案的 frontmatter 完整保留了目录的核心字段，逐项说明如下：

字段合法取值与标签映射

这些枚举值并非随意填写，而是受 src/_data/labels.js 这一"单一事实来源"约束。该文件集中定义了四组标签映射，既是 Nunjucks 模板（通过全局数据级联以labels.*访问）的翻译表，也被companyHelpers.js重新导出供 JS 端（collections.js等）使用：

• region：worldwide（Worldwide）、americas、europe、americas-europe、asia-pacific、other；
• remote_policy：fully-remote（Fully Remote）、remote-first、hybrid、remote-friendly；
• company_size：tiny（1-10 人）、small（11-50 人）、medium（51-200 人）、large（201-1000 人）、enterprise（1000+ 人）；
• tech：javascript、php、sql、ml（ML/AI）、api等 25 个受支持技术标签。

A-1 Auto Transport 的remote_policy: fully-remote在页面上会显示为 "Fully Remote" 标签，company_size: small对应的中文档位说明为 11–50 人（档案正文中自称 "20-50+"，与small档位一致），technologies中的ml会显示为 "ML/AI"。可见 frontmatter 是站内分类、浏览与标签系统的数据源头。

三、正文章节规范与完整内容

3.1 Company blurb（公司简介）

A-1 Auto Transport 的简介部分（同时也是元描述生成的依据）写道：

A1 Auto Transport is a leading global logistics and auto shipping company committed to innovation, efficiency, and reliability in transport solutions.

"Shipping the World, One Vehicle at a Time"—— 这家公司拥有超过 30 年的汽车运输行业经验，业务覆盖美国本土与全球，从个人车辆到商业车队都能提供安全、准时、可靠的托运服务。它并非单纯的运输公司，而是一家以技术驱动的物流服务商，专注于优化运营、为货运与汽车物流的未来构建数字化解决方案。

值得注意的一点：## Company blurb章节会被 src/companies/companies.11tydata.js 中的 Eleventy 计算数据（eleventyComputed.description）自动提取，用于生成页面的 meta description。该逻辑先用正则##\s*Company\s*blurb定位简介区，再清理 Markdown 链接语法、去除*、_、`符号、压缩空白，最终截断到约 155 字符（优先在句号处截断，否则按空格截断并追加...）。也就是说，这份简介不仅是页面正文，还直接决定搜索引擎结果中的描述文本。

3.2 Company size（公司规模）

档案注明公司规模为20-50+人，对应 frontmatter 中的company_size: small（11–50 人）档位。

3.3 Remote status（远程状态）

这是 remote-jobs 目录的核心信息，A-1 档案区分了两类远程协作对象：

• Tech Workers（技术工作者）：公司始终在寻找愿意解决运输行业真实挑战的协作者、工程师与物流技术爱好者，鼓励探索其平台并提出新想法；
• App-based Drivers（App 平台司机）：同时招募经验丰富的独立承包商司机加入全国及国际车辆托运团队。要求具备至少 10 万英里（100k miles）的运输专业经验，或完成过认证的专业培训项目。

3.4 Region（区域）

招聘与业务区域为Worldwide（全球），与 frontmatter 的region: worldwide一致。在页面渲染中，该值会生成一个指向/browse/worldwide/的区域标签链接。

3.5 Company technologies（公司技术栈）

档案列出的核心技术栈为：

• Laravel Framework（PHP）
• Vue.js（Javascript）
• Tailwind（CSS）
• MySQL、Redis
• NGINX、S3

同时，公司把 GitHub 用作中心化的协作与开源平台，主要用途包括：

• 开源物流工具（Opensource Logistics Tools）：面向内部物流优化的自定义脚本、API 与工具集；
• 客户端 UI 框架（Clientside UI Frameworks）：运费估算器、运输跟踪界面等功能的示例集成；
• 研发与创新（R&D and Innovation）：针对预测性路线规划、实时跟踪、自动定价的原型与概念验证；
• 协作（Collaboration）：与汽车运输生态中的伙伴共享内部框架与 API。

从技术栈可以推断，A-1 的物流数字化业务以 Laravel/PHP 为后端主框架、Vue.js + Tailwind 构建前端、MySQL + Redis 承载数据与缓存，NGINX 与 S3 分别承担 Web 服务与对象存储——是一套典型的中小型全栈 Web 技术体系，其 GitHub 开源方向（物流 API、运费估算、实时跟踪、自动定价）也与这份档案的技术标签（api、infrastructure、ml、sql）一一对应。

3.6 Office locations（办公地点）

实体办公地址位于Aptos, California, USA（美国加州 Aptos）——但远程政策为fully-remote，说明这更多是公司注册/总部所在地而非员工工作地约束。

3.7 How to apply（如何申请）

• 申请方式：通过邮件联系employment@a1autotransport.com了解当前开放的职位；
• 明确要求：请勿通过电话联系询问职位机会。

该档案未设置careers_url字段，因此在 src/_layouts/company.njk 中，页面的主按钮会回退到website（{% set buttonUrl = careers_url or website %}），即按钮文案显示 "Visit Website"，指向公司官网。

四、从 Markdown 到公司页面的渲染链路

档案文件本身并不包含 HTML，站点构建时由 Eleventy 负责转换。整条链路如下：

1. 数据收集：src/_config/collections.js 通过collection.getFilteredByGlob('./src/companies/**/*.md')抓取全部公司档案（结果会被缓存，避免约 850 个条目被重复过滤 6 次）；
2. 元数据计算：src/companies/companies.11tydata.js 为该目录下所有档案注入eleventyComputed.description，即前文所述的 blurb 自动摘要；
3. 布局渲染：src/_layouts/company.njk 以Organizationschema 渲染档案，包含返回列表链接、标题、基于careers_url or website的主按钮、region/remote_policy标签、正文内容（{{ content | safe }}）、技术栈标签区块以及基于updatedAt的 "Last updated" 日期展示；
4. 索引与分类：同一份collections.js还提供getAllCompanies（按标题字母排序）、getCompaniesByRegion（按区域分组）、getCompaniesByTech（按技术标签分组）、getRecentCompanies（按addedAt倒序取最近 12 家）等集合，A-1 Auto Transport 会因其worldwide区域与javascript、ml等技术标签被归入对应的浏览页面。

五、档案的构建与校验

5.1 本地构建

根据 README.md，remote-jobs 基于 Eleventy 构建，需要Node.js 22+，常用命令为：

npm install # 安装依赖 npm run start # 开发服务器，支持热更新 npm run build # 生产构建

修改或新增公司档案后运行npm run build即可验证构建是否通过。

5.2 自动化校验

按照 CONTRIBUTING.md，涉及公司文件的 PR 会被Validate Company ProfilesGitHub Action 自动校验，机器人会在 PR 上指出问题并在解决前阻止合并。校验覆盖：

• slug与文件名是否一致；
• frontmatter 字段取值是否合法（对照上文的枚举表）；
• 正文是否包含三个必需章节；
• 是否属于"较旧的文件格式"（如company-profiles/目录或改动 README 的旧式提交）。

5.3 收录标准与注意事项

目录只收录"半远程至完全远程、处于或接近科技行业"的公司，且要求满足：提交者能核实信息、公司直接雇佣员工（不含培训机构、招聘中介或外包平台）、提供真实的远程工作机会（不含纯佣金或独立承包商销售岗）、careers_url指向公司自有招聘页。A-1 Auto Transport 档案中面向 "App-based Drivers" 的独立承包商招募描述，恰好体现了该目录在"远程技术岗"与"非技术远程机会"之间的收录边界讨论点——目录核心价值仍是科技类远程岗位。

六、小结

A-1 Auto Transport 的档案是 remote-jobs 仓库中一份结构完整、覆盖所有必需章节的标准公司档案：fully-remote远程政策、worldwide全球区域、small（20-50+ 人）规模、六项技术标签（PHP/SQL/JavaScript/ML/API/基础设施），外加清晰的远程招募方向（技术工作者 + 经验丰富的平台司机）与邮件申请通道。通过它可以看到整个仓库的数据流设计：frontmatter 是分类与标签的数据源（由 src/_data/labels.js 约束取值），正文由 src/companies/companies.11tydata.js 自动提炼为 meta description，再由 src/_layouts/company.njk 渲染成可浏览的公司页面，最终被 src/_config/collections.js 汇总进区域、技术、最近收录等各类索引。对于想要向该目录贡献新公司档案的读者，CONTRIBUTING.md 的 frontmatter 模板与本档案即可作为最直接的参考样例。

• 数据集