Кто-то генерировал с помощью Doxygen HTML-документацию из Thrift Idl? - PullRequest
0 голосов
/ 05 июня 2019

Я пытаюсь сгенерировать HTML-файл документации из Thrift IDL.Это пример .idl enter image description here

Сгенерированный HTML выглядит так:

enter image description here

Тампредупреждение: example.idl: 1: предупреждение: член pad0 (переменная) класса Session не задокументирован.

Кто-нибудь знает, как правильно сгенерировать документацию?

Спасибоadvance.

  1. doxygen 1.8.15
  2. Это экономичный idl-файл с;в конце определения переменной example.zip
  3. Это оригинальный idl-файл Thrift example-original.zip
  4. Это конфигурацияфайл Doxyfile.zip
  5. thrift 0.11.0 может генерировать документацию HTML thrift -gen html yourfile.thrift, но thrift 0.12.0 не может, это вывод

[ПРЕДУПРЕЖДЕНИЕ: поколение: 1] Невозможно получить генератор для "html"

[ПРЕДУПРЕЖДЕНИЕ: поколение: 1] Невозможно получить генератор для "html: standalone".

1 Ответ

0 голосов
/ 07 июня 2019

Как @ Альберт скажи здесь дооксиген 7029

Есть несколько способов понять, что такое кислород, например ::100100

  • Создать (и поддерживать) фильтр INPUT_FILTER (/ FILTER_PATTERNS), который преобразует формат Apache Thrift IDL в формат, понятный для doxygen

Это в принципе может быть написано на любом языке, пользователь должен иметь возможность запустить его (поэтому может потребоваться установить для него несколько пакетов). Некоторые подсказки в этом направлении см. http://www.doxygen.nl/helpers.html

  • написать (и поддерживать) отдельный синтаксический анализатор («сканер» и «код») для него.

См. Существующие сканеры / парсеры кода в каталоге src doxygen

Есть несколько языков, которые используют свои собственные синтаксические анализаторы. Фортран, питон, VHDL.

...