如何在YUIDoc生成的文档上定义自定义主页面

Question

我一直在玩YUIDoc，我觉得很棒。

顺便说一句，我找不到为自动生成的文档站点定义自己的主页内容的方法（自动生成的index.html中的自定义内容）。

如何定义主页面内容 - 如果可行，当然 - ？

提前谢谢！

Answer 1

YUI Doc非常容易理解，所以理论上这应该很容易：

Fork YUI Doc或修改您当前的YUI文档安装。

• 在yuidoc/themes下添加您自己的主题。复制默认主题可能是一个很好的起点，或复制您要覆盖的部分/文件。
• 在index.handlebars中添加自定义内容。
• 您还可以更改main.handlebars以包含自定义CSS，JS和/或标记。

当您现在构建文档时，请使用--themedir开关来使用新主题：

$ yuidoc --themedir ./mytheme

了解更多：On YUI Doc theming。