前言
随着前端技术不断的发展，包管理工具 npm 也越来越重要。其中，aiden-doc 是一个高效、易用的 npm 包，能够帮助我们更好的管理文档，并生成静态文档网站。
本文将详细介绍 aiden-doc 的使用方法，希望能对前端开发者有所帮助。
安装
首先，我们需要在本地安装 aiden-doc，可以使用以下命令完成安装：
npm install aiden-doc --save-dev
安装完成后，我们需要在 package.json 文件中添加以下配置：
{
"scripts": {
"doc": "aiden-doc build"
}
}这样，在后面我们就可以通过运行 npm run doc 命令来生成文档网站了。
使用
配置文件
我们可以在项目根目录下创建一个 .aiden-doc.js 或 .aiden-doc.json 文件来配置 aiden-doc。它们的配置格式都是一样的，这里我们以 .aiden-doc.js 为例：
-- -------------------- ---- -------
-------------- - -
------ --- ---------- -- ----
------------ ----- -- -- ----------- -- ----
------ ---------- -- ----
------- -------- -- ------
-------- --------------- -- ----------------
-------- - -- -----
-
------ -------- ---
--------- -
-
------ -------- ---
----- ----------------------
--
-
------ -------- ---
----- ----------------------
-
-
--
-
------ -------- ---
----- -------------
-
-
-生成静态文档网站
配置文件完成后，运行以下命令即可生成静态文档网站：
npm run doc
然后我们就可以在输出目录中看到生成的文档网站了。
示例
下面是一个简单的示例：
首先，我们需要创建一个新的 npm 项目，并在其中添加 aiden-doc 依赖。然后，我们在项目根目录下创建一个 .aiden-doc.js 文件，配置如下：
-- -------------------- ---- -------
-------------- - -
------ --- ----- ----------
------------ ----- -- -- ----- -----------
------ ----------
------- ---------
-------- ---------------
-------- -
-
------ -------- ---
--------- -
-
------ -------- ---
----- ----------------------
--
-
------ -------- ---
----- ----------------------
-
-
--
-
------ -------- ---
----- -------------
-
-
-然后，在根目录下创建一个 README.md 文件，内容如下：
# My First Document This is my first document.
接着，我们在根目录下创建一个 chapter1 目录，并在其中创建两个 markdown 文件：section1.md 和 section2.md，内容如下：
-- -------------------- ---- ------- - ------- - ---- -- ------- -- -- ---------- --- ---- -- ---------- ---- -- ---------- --- ---- -- ---------- ---- - ------- - ---- -- ------- --
# Section 2 This is section 2.
最后，在根目录下创建一个 chapter2.md 文件，内容如下：
# Chapter 2 This is chapter 2.
完成上述步骤后，我们运行以下命令：
npm run doc
然后就可以在输出目录 ./docs 中看到生成的静态文档网站了。
结语
通过本文，我们了解了 aiden-doc 的基本使用方法，并了解了如何通过配置文件来自定义文档网站的样式。希望读者能够通过本文获得帮助，更好地管理文档并提高开发效率。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066b5351ab1864dac6694c