介绍
documentation-website 是一个使用 markdown 编写文档并生成文档网站的工具，它将 markdown 中的文档内容转化成静态网站，支持自动生成目录、页面跳转、代码高亮等功能。
在前端开发中，我们经常需要编写文档，比如组件文档、工具文档等等。而 documentation-website 可以方便地将 markdown 中的文档转换成可浏览的静态网站，并且提供了多样化的配置和扩展性。
本文将详细介绍 documentation-website 的使用方法，并给出实际的示例代码。
安装
在使用 documentation-website 之前，我们需要先安装它。可以使用 npm 来安装：
$ npm install documentation-website
配置
安装完成后，我们需要进行相应的配置。在项目根目录下创建 documentation.yml，并进行配置。
下面是一个简单的配置示例：
title: My Document
theme:
name: documentation-theme-default
logo:
src: logo.png
home:
title: Welcome to My Document
description: This is my document.
docs:
- file: docs/section1.md
title: Section 1
- file: docs/section2.md
title: Section 2上述配置中，我们指定了文档网站的标题、主题、logo 等信息，并列出了需要生成的 markdown 文档文件。
更多配置项和说明请参考 官方文档。
编写文档
接下来，我们需要编写 markdown 格式的文档。在示例配置中，我们列出了两个 markdown 文件：docs/section1.md 和 docs/section2.md。现在我们来编写这两个文档。
section1.md
# Section 1 这是第一节的内容。
section2.md
# Section 2 这是第二节的内容。
编写好文档后，我们可以在命令行中使用以下命令来生成静态网站：
$ node_modules/.bin/documentation build -c documentation.yml -f html -o docs
其中，-c 参数指定配置文件路径，-f 参数指定输出格式，-o 参数指定输出路径。执行完成后，我们能在指定的输出路径 docs 中看到生成的静态网站。
自定义主题
除了使用 documentation-theme-default 主题外，我们也可以通过自定义主题来改变文档网站的外观。主题可以在配置文件中进行指定，也可以在命令行中进行指定：
$ node_modules/.bin/documentation build -c documentation.yml -t my-theme -f html -o docs
上述命令中，-t 参数指定主题名称。我们需要自定义一个主题，然后在配置文件中进行指定。具体的主题开发请参考 官方文档。
结论
documentation-website 是一个非常实用的工具，可以方便地生成具备良好阅读体验的静态文档网站。在实际开发中，我们可以通过它来快速生成组件文档、API 文档等等，提高代码和文档的可读性和可维护性。
以上便是 documentation-website 的使用教程，希望能对大家有所帮助。
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/600673defb81d47349e53bee