2

我有一个包含API 文档部分和教程部分的工作文档页面。当我在面包屑导航中单击Tutorial时，内容区域中会出现一个空白页面，并且浏览器标题栏显示“core-js: Error: Page Not Found!”。对于API 文档按钮，可以观察到相同的行为。

单击主导航栏链接（或主面包屑项）时将加载什么文件？如何在 Gruntfile.js 中配置此行为？

我使用 Firefox 开发工具来监控相应文件的 ajax 请求，但是当我单击教程链接时没有看到请求。我在 Gruntfile.js 中尝试了几个选项，并尝试将 tutorial.html 文件放入我生成的文档目录中 - 没有成功。

根部分的页面上不可能有内容吗？

我将 grunt 任务配置为在单击主导航栏的项目链接core-js时打开Intro页面，我希望Tutorial链接的这种行为，但我更希望有一个特定的Tutorial页面。

我当前的 Gruntfile 代码：

ngdocs: {
    options: {
        dest: 'doc/generated',
        html5Mode: false,
        startPage: '/tutorial/intro',
        title: 'core-js',
        titleLink: '/#/tutorial/intro',
        bestMatch: true
    },
    api: {
        title: 'API Documentation',
        src: config.doc.files.api
    },
    tutorial: {
        title: 'Tutorial',
        src: config.doc.files.tutorial
    }
}
4

1 回答 1

1

我假设它config.doc.files.api设置为一个文件名数组。可以肯定的是，它应该解析为：

api: {
   title: 'API Documentation',
   src: ['./foo.js', 'bar.js']
}

文件路径是相对于 grunt 文件的。要创建概览页面，只需创建一个文件（例如“tutorial.txt”）：

/**
 * @ngdoc overview
 * @name index
 * @description your text here
 */

并将文件添加到src该部分的数组中api。

于 2016-10-14T03:07:53.833 回答