本地辅助脚本

render-local-preview.rb

将一篇带 Jekyll Front Matter 的博客草稿或文章渲染成可以直接在浏览器中打开的独立 HTML 文件。

脚本会：

• 从 Front Matter 读取 title、description、category 和 reading_time；
• 读取 _includes/styles.css、_includes/sections.css 和 _includes/about.css；
• 把站点样式、文章元数据和正文组合成完整 HTML；
• 在页面中标记“本地预览 · 尚未发布”。

使用方法

从仓库根目录执行：

ruby scripts/render-local-preview.rb \
  _drafts/2026-08-17-example.html \
  outputs/example-preview.html

参数说明：

1. 第一个参数是源文章路径，文件必须包含有效的 Jekyll Front Matter。
2. 第二个参数是输出 HTML 路径，目标目录需要事先存在。

脚本成功后会在终端输出生成文件的路径。直接使用浏览器打开该 HTML 即可预览。

使用边界

这个脚本不运行完整的 Jekyll，也不会模拟 GitHub Pages 的全部插件、Liquid 处理、SEO 标签和站点导航数据。它适合检查文章正文、代码块、表格、流程图和局部 CSS；正式发布后仍需检查 GitHub Pages 构建结果与公开页面。

scripts/ 应纳入版本管理。outputs/ 是可重新生成的本地产物，不应提交到 Git。