Doxygen: Не удается установить файл.docset в Xcode5

Я создал документацию Doxygen для проекта Objective-C/C (без C++), запустив:

doxygen

,,, а затем в выходной каталог:

make

В результате получается файл с именем MyProject.docset., Файл прекрасно устанавливается, например, в Dash.app, однако он не дает никакой документации по Xcode. Я пробовал следующее:

  • Копировать в ~ / Библиотека / Разработчик / Общий / Документы
  • Скопируйте в / Applications / Xcode.,,, / Docsets
  • Щелкните правой кнопкой мыши, откройте с Xcode

Согласно Apple, полностью поддерживаются следующие системы документации:

  • Headerdoc
  • Doxygen

Я попытался установить документацию Appledoc, и она отлично работает.

1 ответ

Решение

Если вы говорите об иерархии содержимого документа: Xcode 5 изменил формат метаданных для описания узлов. В предыдущих версиях они использовали плоский список файлов tokens.xml, но в Xcode 5 формат представлял собой структуру папок с файлами xml в качестве листов. Результатом является docset, который все еще должен быть доступен для поиска, но не отображать никаких узлов при просмотре в боковой панели документов Xcode. Dash по-прежнему поддерживает старый формат, поэтому документация там выглядит нормально. Что касается appledoc, эта проблема GitHub покрывает это.

Другие вопросы по тегам