探索优雅的静态网站生成器 —— Clayoven

项目简介

Clayoven 是一个精心打造的静态网站生成器，专注于简洁高效的设计和强大的功能集。它由一个九年磨一剑的过程孕育而来，最初是为了支持 开发者个人网站 的扩展而创建的。无论是数学笔记、软件相关文章还是广泛读者群体的内容，Clayoven 都能轻松应对。其源文件采用名为 "claytext" 的自定义格式编写，旨在实现优雅与速度并存。

对于文档，你可以查阅 RDoc 文档以获取更详细的信息。

技术剖析

• 精简！约700行高质量、注释详尽的 Ruby 代码。
• 自带的 VSCode 插件 vsclay 提供了美丽的语法高亮和易于扩展的标记语言。
• 通过 Git 历史自动获取时间戳，并在移动文件时保持记录。
• 利用 MathJaX 和 XyJaX 进行服务器端渲染数学公式，包括协变图。

应用场景

• 个人博客 - 创建拥有丰富数学公式的个性化博客。
• 在线教程或课程 - 为学生提供直观易懂的带有实时渲染的数学表达式的学习材料。
• 技术文档 - 构建清晰、整洁的技术文档站点，支持自动化更新。

独特之处

• 小巧且强大 - 整个项目仅700行左右的代码，但功能全面，性能卓越。
• 高度可扩展的标记语言 - 自定义的 claytext 格式让写作变得简单且美观。
• 智能化的时间管理 - 利用 Git 历史数据，轻松跟踪修改和发布日期。
• 一键式数学公式渲染 - 集成 MathJaX 和 XyJaX，为你的页面添加复杂的数学表达式。

开始体验

由于未发布 gem，你可以克隆仓库、运行 bundle 安装依赖，然后将 bin/clayoven 添加到 PATH 中。使用 clayoven init 初始化新项目。推荐安装 VSCode 扩展 vsclay，以获得语法高亮、MathJaX 智能提示等功能。

使用指南

• clayoven 用于增量构建基于当前 Git 存储库的状态的 HTML 文件。
• clayoven aggressive 对整个网站进行全量重建，偶尔执行即可。
• clayoven httpd 可以预览本地网站。

结语

Clayoven 以其独特的优势和强大的功能，使得建立和维护复杂内容的静态网站变得更加容易和愉快。无论你是技术博主、教育工作者还是文档撰写者，Clayoven 都值得你尝试。立即加入我们，开启您的静态网站之旅吧！