Я пытаюсь использовать doxygen, дышать и sphinx для генерации документации для библиотеки C #. Это под виндой. Основная структура каталогов:
docs
index.rst
conf.py
xml
xml output from doxygen
Я сталкиваюсь со следующей ошибкой при выполнении make.bat html:
C: \ Programming \ J4JLogging \ J4JLogging \ docs \ index.rst: 25: ПРЕДУПРЕЖДЕНИЕ: doxygeninterface: Не удалось найти класс "IJ4JLoggerConfiguration" в выводе doxygen xml для проекта "J4JLogger" из каталога: ./xml
Вот содержимое conf.py
# import os
# import sys
# sys.path.insert(0, os.path.abspath('.'))
project = 'J4JLogger'
copyright = '2019, Mark Olbert'
author = 'Mark Olbert'
extensions = [ "breathe" ]
breathe_projects = {
"J4JLogger": "./xml"
}
breathe_default_project = "J4JLogger"
templates_path = ['_templates']
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
html_theme = 'sphinx_rtd_theme'
html_static_path = ['_static']
и вот содержимое index.rst:
.. J4JLogger documentation master file, created by
sphinx-quickstart on Tue Jun 11 16:33:34 2019.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Welcome to J4JLogger's documentation!
=====================================
.. toctree::
:maxdepth: 2
:caption: Contents:
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
Docs
====
.. doxygeninterface:: IJ4JLoggerConfiguration
:members:
Содержимое папки xml, созданной doxygen, выглядит следующим образом:
![enter image description here](https://i.stack.imgur.com/RLhnO.png)