在前端开发中，我们经常需要使用静态网站生成器来帮助我们构建站点和应用程序。noddity-static-server 是一种 npm 包，它可以帮助我们实现简单的静态站点生成器。在本文中，我们将学习如何使用 noddity-static-server 来创建一个静态站点。
noddity-static-server 简介
noddity-static-server 是一个静态网站生成器，它基于 Node.js 开发。它包括多个插件，可以帮助我们构建有各种不同需求的静态网站。其中最常见的插件是 noddity 和 static-server。
- noddity 可以帮助我们使用 Markdown 建立文章。
- static-server 可以帮助我们启动一个 HTTP 服务器来服务静态文件。
noddity-static-server 安装
安装 noddity-static-server 最简单的方法是通过 npm（Node.js 包管理器）来完成，命令如下：
npm install -g noddity-static-server
我们可以在全局范围内安装 noddity-static-server，这将使我们可以使用该命令行工具来启动 HTTP 服务器。
使用步骤
我们将按照以下步骤使用 noddity-static-server 来创建一个简单静态站点：
- 创建一个文件夹。
- 在文件夹中创建一个配置文件。
- 创建一个文章目录。
- 在文章目录中编写文章。
- 使用 noddity-static-server 启动 HTTP 服务器。
建立文件夹
我们首先要建立一个文件夹，该文件夹将包含整个站点的所有文件。我们将在该文件夹中创建一个配置文件和文章目录。
mkdir myblog cd myblog
建立配置文件
在 myblog 文件夹中，我们将创建一个 config.json 文件，该文件允许我们配置站点URL，以及插件和模板等设置。
-- -------------------- ---- -------
-
---------- ----
----------------- -
------------------ ------------
--
---------------- -
----------- ----------
---------- -
-------- ---- ----- --------------
-
-
-baseUrl：站点 URL 的基本路径。noddityOptions：noddity 插件的选项。articleFilename：文章文件名，该插件将根据此选项查找 Markdown 文章。staticOptions：static-server 插件的选项。serveDir：我们的文章目录。rewrite：由于 static-server 必须返回 index.html 文件，我们需要一个重写规则来确保此行为。
建立文章目录
在 myblog 文件夹中，我们将创建一个名为 "content" 的文件夹，并在其中创建至少一个 Markdown 文件作为我们站点的第一篇文章。
mkdir content cd content echo '# Welcome' > article.md
运行服务器
在终端中，我们可以使用以下命令来启动服务器。
noddity-static-server --config ../config.json
现在，我们将在浏览器中访问 http://localhost:8080，应该能看到刚刚写的欢迎页面。
深入学习
除基础用法外，noddity-static-server 还有更多的用途。这里只介绍一些示例用法。
编写文章
noddity 插件可以让我们在 Markdown 中编写文章。文章会按照日期降序排列。例如，我们可以将如下代码保存在 content/2019/10/01-article.md，根据日期和标题生成文件名。
--- title: Title of the article date: 2019-10-01 --- # 正文
制作模板
noddity-static-server 插件提供了一个名为 "noddity-static-server/render" 的模块，可以让我们编写自定义模板。下面的代码展示了一个简单的模板，它包括了一个标题和一个循环。
-- -------------------- ---- -------
--------- -----
----- ----------
------
----- ----------------
------------------------
-------
------
------- ----------
-----------------------
---------
-------
-------嵌套模板
通过使用 noddity-static-server，我们可以创建嵌套模板，每个模板都可以包含多个面板。下面的代码展示了一个模板，其中包含了两个面板，一个用于导航，一个用于内容。
-- -------------------- ---- -------
--------- -----
----- ----------
------
----- ----------------
------------------------
-------
------
--- -----
--- ---------
-------
-------
---- ------------------- ---
-----
----
------ ----------------------
-----
------
---- ----------------------- ---
------- ---------
------------------
-------------------------
---------总结
通过本文，我们学习了如何安装和使用 noddity-static-server。我们还介绍了一些高级用法，例如如何使用 noddity 和 static-server 插件，如何编写文章和模板，并显示如何编写嵌套模板。这将为我们的站点构建过程提供更多的灵活性，有助于我们更好地满足不同需求。如果您是前端开发人员，应该尝试一下 noddity-static-server。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005601781e8991b448de365