组织Docco页面的更好方法

Question

我有一个大型主干样式的应用程序(大约100个文件)，我正在尝试选择最好的方法来自动化文档。

我正在用多科 (用格朗特-多科2)做实验，但我遇到了一些问题。有了所有的文件，我的列表在左边，然后向下通过窗口，没有办法滚动。是否有可能将它们分组，也许是以下拉的方式？

另外，是否有可能生成索引页或什么的？Docco似乎做了我想做的一切的99%，但这两件事让我发疯了！

Answer 1

好吧，我还没有找到一种方法来生成一个完整的目录。

然而，我找到了一种方法来阻止疯狂的滚动。

如果#jump_page是在docco.css中定义的，则将其更改为：

 #jump_page {
    padding: 5px 0 3px;
    margin: 0 0 25px 25px;
    max-height:750px;
    overflow: scroll;
 }

然后，我拿起修改过的样式表，使用docco选项传入其中。

这不是最好的解决方案，但它将设置一个最大的高度，并允许滚动，因此，如果您有大量的文件，您想要文档，您可以更快地导航它们。

Answer 2

到目前为止，这可能是不相关的，但是有一个名为多科哈士奇的项目，您应该检查它。就像做项目的文档。

来自他们的README.md：

一个简化的静态站点生成器，用于基于Docco的项目文档。“哈士奇”，因为它比Docco更大，更不规则，就像你在西尔斯买的哈士奇牛仔裤。