修改grunt-ngDocs模板

Question

如何修改由咕噜咕噜声生成的网站的外观和感觉模板？

最后的目标是将生成的文档集成到网站中。

例如，我们希望为每个主题显示以下选项卡

• 演示(重点关注最终的用户呈现)
• 代码(用于开发人员)

要做到这一点，我们需要修改ngDocs使用的模板，但是如何修改呢？

Answer 1

要创建不同的选项卡，只需向ngdocs任务添加另一个目标：

ngdocs: {
  options: {        
    ...
    startPage: '/code' // this is displayed first
    ...        
  },
  demo: {
    src: ['path/to/demo/files'],
    title: 'Demo'
  },
  code: {
    src: ['path/to/code/files'],
    title: 'Code'
  }
}

现在，关于自定义模板。

您可以提供自己的模板文件和CSS文件。

您甚至可以创建一个自定义导航模板。

Answer 2

您可以使用您自己的css文件提供的模板样式，每次生成文档时都可以复制该模板。

看到https://www.npmjs.com/package/grunt-ngdocs#styles了吗？中，您可以在选项对象中指定样式，该选项对象用于在“咕噜”中弱化文档。