静态网站生成器是一种将源文件转换为 HTML、CSS、JavaScript 等静态文件的工具。它们被广泛用于生成博客、文档站点、展示页面等。
t3h-static-site-generator 是一款基于 Node.js 和 Markdown 的静态网站生成器。它可以将 Markdown 文件编译成 HTML、使用 Handlebars 模板渲染页面、支持自定义 CSS 和 JavaScript 等功能，是一款易于使用和定制的静态网站生成器。
本文将介绍如何使用 t3h-static-site-generator 构建一个简单的博客页面。
准备工作
首先需要安装 Node.js 和 npm，安装方法可以参考官方文档。
安装 t3h-static-site-generator：
--- ------- -- -------------------------
创建项目
创建一个新的项目目录：
----- ------- -- -- -------
初始化项目并安装依赖：
--- ---- -- --- ------- ------------------------- ---------- ------ ------------
其中，t3h-static-site-generator 是本次教程使用的静态网站生成器，handlebars 是用于渲染页面的模板引擎，marked 是用于将 Markdown 文件编译成 HTML 的工具，highlight.js 是用于代码高亮的库。
配置
创建一个 src 目录，用于存放源文件。
创建一个模板文件：
--------- -----
------
------
----- ----------------
--------- ----- ----------
----- ---------------- ----------------------
-------
------
-------------
-- ------- --
-------------
------- -----------------------------
-------
-------这是一个简单的 HTML 模板文件，使用 Handlebars 语法嵌入了 title、content 和引入的 CSS、JavaScript 文件。
创建一个配置文件 config.js：
-------------- - - ------ --- ------ ------------ ----- -- -- ------ ---- ----------------------- ------- ------ ---------- --------- ----------- ---- --------- ------------------- -------------- -- -
其中包含了各种配置选项，比如网站的标题、描述、URL、源文件目录、输出目录、静态文件路径等。详细的配置选项可以参考官方文档。
编写 Markdown 文件
在 src 目录下创建一个名为 post.md 的 Markdown 文件：
--- ------ ----- ----- ------------ --- ---------- ------------- ------------------- --------
-------- ---- --------------------- -------- ------ -- ----- ----------
t3h-static-site-generator
--- ------ -------------------------------- -- -- ---- ------ ----- --- ----------------- -- -- ------------------------- ----------------------------------------------------------- ------------------------------------ ------------------------------------------------------------------------------ ---------- -----------------------------------------------------------------------------------------------------------------------------