Невозможно просмотреть описания сгенерированных документов

Question

Невозможно просмотреть описания сгенерированных документов

0

хотя я могу служить из файловой системы, grunt-ngdocs автоматически генерирует index.html, каждый раз, когда я пытаюсь посмотреть на описание в документации, которую я получаю:

XMLHttpRequest cannot load file:///C:/<file-path> Cross origin requests are only supported for protocol schemes: http, data, chrome, chrome-extension, https, chrome-extension-resource

даже если обе папки docs/partials и docs/partials/api пусты.

Это моя конфигурация grunt-ngdocs

ngdocs: {
       options: {
           dest: 'docs',
           html5Mode: false,
           inlinePartials: true,
           scripts: [
               'bower_components/angular/angular.js',
               'bower_components/angular-animate/angular-animate.js'
           ]
       },
       api: {
           src: ['app/scripts/**/*.js'],
           title: 'Docs'
       }
    }

Что я делаю не так?

заранее спасибо

Gargaroz 27 июль 2016, в 13:04

Источник

Теги:

angularjs

xmlhttprequest

xss

ngdoc

1 ответ

Ещё вопросы

andreboekhorst · Answer 1 · 2016-08-02T11-55-00.000Z

Проблема в том, что вы должны запускать его с сервера. Я использую http-узел узла (https://www.npmjs.com/package/http-server). После его установки просто зайдите в каталог docs/и введите "http-server". Появится следующее сообщение:

Запуск http-сервера, обслуживающего./на: http://0.0.0.0:8080

Теперь вы можете проверить документы на указанном URL (http://0.0.0.0:8080)

Редактировать:

Если вы не хотите загружать его с сервера, вы можете установить параметр inlinePartials в true в файле grunt. Это то, что у меня есть:

ngdocs: {
    options: {
        dest: 'docs', 
        title: "Docs",
        inlinePartials: true
    },
    api: {
      src: ['<%= yeoman.app %>/scripts/**/*.js'],
      title: 'API Documentation'
    }
},

см. (https://github.com/m7r/grunt-ngdocs)

Спасибо за ваш ответ, но факт в том, что я пытался избежать этого решения, так как один из авторов сказал, что ng-docs может обслуживаться через файловую систему ; Более того, я обнаружил в своем роде вопрос, касающийся моего вопроса о grunt serve:dist : можете ли вы сказать мне, можно ли обслужить ngdocs, используя эту задачу Grunt?
Я проверил, есть ли другой способ, и ngdocs позволяет вам сделать все шаблоны встроенными. Это позволит избежать ошибки XMLHttpRequest. Проверьте отредактированный ответ.
Моя проблема у меня есть inlinePartials: true в моем Gruntfile, но я все еще получаю ошибки XMLHttpRequest
Вы знаете, какая у вас версия ngdocs? Встроенные партиалы разрешены только с 0.2.8 (возможно, вы можете проверить package.json)
Кстати, я добавил http-сервер в свои пакеты npm, но ничего не вижу: индексная страница ngdocs загружена правильно, но когда выбирается элемент из левой навигационной панели, чтобы просмотреть его документы, я попадаю в консоль. 404 для его частичного
Наконец я удалил inlinePartials: true и обслужил документы через http-сервер и все нормально. Я все еще разочарован, я не мог найти способ заставить это работать через inlinePartials: true