Как определить страницу ngdoc root/overview?

Question

У меня есть страница рабочей документации с документацией API и Учебное пособие раздел. Когда я нажимаю Учебник в навигационной панели, в области содержимого появляется пустая страница, а в строке заголовка браузера указано «core-js: Error: Page Not Found!». Такое же поведение можно наблюдать и для API Documentation.

Какой файл будет загружен, когда будет нажата ссылка главной панели навигации (или основного элемента палитры)? Как это поведение можно настроить в Gruntfile.js?

Я использовал инструменты разработки Firefox для мониторинга запроса ajax для соответствующего файла, но не вижу запроса, когда я нажимаю ссылку Tutorial. Я попробовал несколько опций в Gruntfile.js и попытался поместить файл tutorial.html в свой сгенерированный каталог документации - без успеха.

Невозможно иметь контент на страницах корневых разделов?

Я настроил черновую задачу, чтобы открыть страницу интро, когда ссылка проекта ядро-JS основной навигационной панели была нажата, я был бы признателен за это поведение для 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 
    } 
} 

Answer 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.