ocaml/ocaml.org

ocaml.org网站构建环境镜像

概述

本镜像提供ocaml.org网站的完整构建环境，用于本地构建和开发该网站。主要面向开发者和内容贡献者，支持静态页面生成、依赖管理及本地预览，无需外部文件或数据库服务器。

核心功能与特性

• 静态页面架构：网站由纯静态页面组成，可完全在本地独立构建运行
• 自动化依赖管理：通过make deps命令自动安装所需OPAM包及系统依赖
• 高效构建流程：支持并行构建（make -j）以提高构建速度，生成完整网站至ocaml.org目录
• 便捷内容编辑：提供本地预览能力，支持直接编辑Markdown内容并实时查看效果

使用场景

• 网站内容贡献者：编辑页面内容并本地预览修改效果
• 网站开发者：调整网站模板、样式或构建脚本进行功能开发
• 部署准备：生成静态网站文件用于ocaml.org网站部署前测试

使用方法

基本构建流程

1. 启动容器（假设本地项目路径为/path/to/ocaml.org）：

   bash
   docker run -v /path/to/ocaml.org:/app -w /app [镜像名称]
   

2. 安装依赖：

   bash
   make deps
   

   注：依赖通过OPAM管理，具体包信息详见项目根目录opam文件

3. 构建网站：

   bash
   make  # 基础构建，生成ocaml.org目录
   # 或使用并行构建加速（根据CPU核心数调整）
   make -j 8  # 示例：使用8个并行任务
   

4. 清理构建产物：

   bash
   make clean
   

目录结构说明

• site/：网站核心内容目录，包含Markdown格式的页面文件，构建时转换为HTML
• template/：网站样式模板目录，构建时应用于site/中的页面，引用格式为template/模板文件名
• script/：构建脚本目录，包含网站生成所需的各类辅助脚本

联系方式

• 一般讨论：发送邮件至infrastructure邮件列表
• 问题反馈：在https://github.com/ocaml/ocaml.org%E6%8F%90%E4%BA%A4issue
• 代码贡献：Fork仓库并提交pull request