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 покрывает это.