简介
API 文档是一个非常重要的工具，它让使用者更好的了解你的 API，并使得使用者更容易上手。
shins 是基于 Slate 的一个定制版，在 Slate 的基础上加入了许多特定于 API 文档的特性和改进，如更好的路由显示，更好的参数显示，和更好的页面样式。
在本教程中，你将学习如何使用 shins 来构建一个类似于官方 API 文档一样的优雅的 API 文档。
安装
首先确保你已经安装了最新版本的 Node.js 和 NPM。然后，你可以通过以下命令来安装 shins
npm install -g shins
这将全局安装 shins，以便你可以随时随地使用它。
如何使用
shins 的使用非常简单，只需执行以下命令：
shins [input] [output]
其中 input 是一个包含 API 文档的 Markdown 文件，output 是生成的 HTML 文件名称。
例如，如果你的 Markdown 文件名为 api.md，而你想要输出的 HTML 文件名为 api.html，你可以执行以下命令：
shins api.md api.html
这将生成一个包含你的 API 文档的 HTML 文件。如果你打开这个文件，你将看到一个类似于下面的页面：
示例代码
为了更好地说明如何使用 shins，下面我们演示一个简单的示例。
我们将首先创建一个名为 api.md 的 Markdown 文件，它的内容如下：
-- -------------------- ---- ------- - --- --------- ---- -- -- --- ---------- -- -------- --- ----- --- --- ------ --- ------ ------ - --- ----- --- ------------ --- ----- --- - ---- -- --- --- ----- ------ - ---- -- --- --- -------- ------ - ---- -- ---展开代码
这个文件包含一个简单的 API 文档，其中包括两个顶级路由和一些路由操作。
接下来，我们尝试生成 HTML。
假设我们执行以下命令：
shins api.md api.html
这将生成一个包含我们的 API 文档的 HTML 文件。
如果你打开它，你将看到一个优雅的 API 文档，其中包含我们定义的所有路由和操作，如下图所示：
正如你所看到的，使用 shins 可以让你的 API 文档看起来非常专业和优雅。如果你想更多地了解 shins，你可以查看官方文档。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67609
