修改 grunt-ngDocs 模板

Question

如何修改 grunt-ngDocs 生成的网站的外观模板？

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

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

Demo（侧重于最终用户渲染）
代码（针对开发人员）

为此，我们需要修改 ngDocs 使用的模板，但是如何呢？

Answer 1

您可以为自己的 css 文件提供的模板设置样式，您可以在每次生成文档时复制这些文件。

看到https://www.npmjs.com/package/grunt-ngdocs#styles了吗？您可以在用于在 grunt

中初始化文档的选项对象中指定样式

Answer 2

要创建不同的选项卡，只需将另一个 Target 添加到 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'
  }
}

现在，关于自定义模板。

您可以提供自己的 Template file and CSS file。

您甚至可以创建自定义 Navigation Template

修改 grunt-ngDocs 模板

Modifying the grunt-ngDocs template

javascript

documentation

angularjs

gruntjs

ngdoc