在前端开发领域，构建静态网站是非常常见的任务。而一个好的静态网站构建工具可以极大地提高开发效率和代码可维护性。在这篇文章中，我想向大家介绍一个优秀的 npm 包——makestatic-html-standard，它可以帮助您更轻松地构建标准的 HTML 静态网站。
makestatic-html-standard 简介
makestatic-html-standard 是一个基于 Node.js 的 npm 包，它提供了一个简洁的、易于使用的命令行界面（CLI），使开发者可以快速生成标准的 HTML 静态网站。
makestatic-html-standard 支持以下特性：
- 通过自定义模板生成自定义的 HTML 文件
- 自动化代码优化（如 JavaScript 和 CSS 的压缩）
- 支持自定义的文档结构和布局
- 自动化生成站点导航和网站地图
- 多语言支持
makestatic-html-standard 安装
在开始使用 makestatic-html-standard 之前，您需要先安装 Node.js 和 npm 工具。安装完成之后，您可以使用以下命令来安装 makestatic-html-standard：
npm install makestatic-html-standard --save-dev
makestatic-html-standard 使用教程
接下来，我将为大家详细介绍如何使用 makestatic-html-standard 构建标准的 HTML 静态网站。
初始化项目
在您的项目根目录下执行以下命令，初始化 makestatic-html-standard 配置文件：
npx makestatic init
执行完成后，会自动创建名为 makestatic.json 的配置文件。您可以在该文件中配置您的网站参数和相关选项，如下所示：
-- -------------------- ---- ------- - -------- --- ------ --------- ---------- --------------------------- ------------------ ------- ------------------- ---------- ------------------ ----- ------------ ------ ------ --------------- ---------------------- --------------- ---------------------- ----------- -------- --------------- --- ------------------ --------------- ------------ ----- ----------- ---- -
解释一下各个参数的含义：
- title: 您的网站标题。
- baseUrl: 您的网站基础 URL。
- outputDirectory: 生成的 HTML 文件输出目录，默认为 dist。
- contentDirectory: 您的文档目录。
- defaultLanguage: 默认语言。
- languages: 您想要支持的语言。
- pageTemplate: 页面模板路径。
- postTemplate: 文章模板路径。
- homePage: 首页的 URI。
- postsPerPage: 每页文章的数量。
- googleAnalytics: Google Analytics 跟踪 ID。
- prerender: 是否启用预渲染。
- compress: 是否压缩生成的 HTML、CSS 和 JavaScript。
创建页面和文章
创建 HTML 页面和博客文章非常容易。您只需要在 contentDirectory 目录下创建一个文件夹，并在文件夹中添加一个名为 index.md 的 Markdown 文件，就可以创建一个 HTML 页面。同时，在 contentDirectory 目录下创建一个名为 _posts 的文件夹，然后在该目录下添加 Markdown 文件，即可创建博客文章。
比如，如果您想创建一个页面，您可以执行以下命令：
npx makestatic page about
执行完成后，makestatic-html-standard 将自动在 contentDirectory 目录下创建名为 about 的文件夹，以及一个名为 index.md 的 Markdown 文件，该文件将作为该页面的渲染模板。
同样地，如果您想创建一篇名为 "Hello World" 的博客文章，您可以执行以下命令：
npx makestatic post "Hello World"
执行完成后，makestatic-html-standard 将自动在 _posts 目录下创建一个名为 hello-world.md 的 Markdown 文件，该文件将作为该文章的渲染模板。
生成静态网站
在配置文件设置好之后，您可以按照以下步骤来生成静态网站。
- 清空输出目录：
npx makestatic clean
- 构建站点：
npx makestatic build
构建完成后，您将在输出目录中找到生成的 HTML 静态网站，您可以通过浏览器打开 index.html 查看结果。
- 本地服务器测试
您可以直接打开生成的 HTML 文件查看，但是这种方式很不方便，更好的方式是在本地创建一个 HTTP 服务器，以便更方便地预览网站。您可以使用以下命令来启动本地服务器：
npx makestatic serve
然后在浏览器中访问 http://localhost:8000/，即可预览您的静态网站。
配置自定义模板
除了默认提供的模板之外，您还可以使用自己的模板。 makestatic-html-standard 使用 Handlebars 作为渲染引擎，因此您需要编写自己的 Handlebars 模板。
您需要在 makestatic.json 文件中更新 pageTemplate 或 postTemplate 字段，指向您的自定义模板：
{
"pageTemplate": "path/to/your/custom/template.html",
"postTemplate": "path/to/your/custom/template.html"
}总结
在这篇文章中，我介绍了 makestatic-html-standard 的基本用法，以及自定义模板的方法。通过本文的介绍，您现在应该已经熟悉了这个优秀的 npm 包，并且可以使用它来快速构建标准的 HTML 静态网站。如您有任何问题或建议，请在评论区留言。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600572c781e8991b448e8edf