工具，用于从标记生成技术文档网站

Question

我正在寻找一个工具来生成一个静态网站来存放一些内部文档，比如开发技巧，我们使用的工具，一些简单的教程等等。我们的想法是在团队之间分享，相当非正式。

我相信有很多工具在外面，实际上，尝试选择一个工具是相当困难的。rmarkdown / blogdown看上去很酷，但我以前从未听说过。Github Markdown呈现看起来很有趣(但不是静态的)，当然有数以百计的博客工具，还有很多可以通过代码生成站点(狮身人面像、氧气)。

更具体的要求：

• 尽可能简单，最好在一个命令行中创建网站文件。我们不需要一个完整的WordPress设置。
• 很好的渲染，特别是对于代码。我喜欢给前男友渲染。
• 在文件之间导航的可能性。
• 支持良好的社区/大社区。
• 如果可能的话，可定制的外观和a给予更多的控制布局等。不过，这不是首要任务。
• 一般情况下，如果有一天我想要更好的控制，我就可以改变工具。

你们有什么建议吗？

PS :我选择减价是因为它似乎是最常见的，而且我已经知道/使用它了，但是我可以休息或做任何事情。

Answer 1

如果有人感兴趣的话，我开始使用Hugo和雨果-格克多

• 从盒子里看上去很棒
• 非常容易安装/构建/部署
• 随意定制(尽管我尽量不浪费太多时间)

​

​

显然，这是个人的选择，其他解决方案，如@cyrus提到的docsify，甚至github wiki也可以。

Answer 2

文档化也许能满足你的需要。

​

​

​

​

尽可能简单，最好在一个命令行中创建网站文件。

docsify站点在一个命令中创建。

docsify init ./docs

在文件之间导航的可能性。

有一个侧边栏可以在文件之间导航。

支持良好的社区/大社区。

这是一个17.3公里的项目。目前有160个撰稿人(2021年4月16日)。

很好的渲染，特别是对于代码。 如果可能的话，可定制的外观和一个给予更多的布局控制。

是可定制的。您可以在可怕的Docsify上找到由docsify创建的网站和docsify的主题。

一般情况下，如果有一天我想要更好的控制，我就可以改变工具。

别担心。许多工具支持Markdown。您可以随时更改该工具。