Sphinx extension for Doxygen entries.
Project description
Doxysummary
A Sphinx extension for creating autosummary with entries from xml files generated by Doxygen.
Installation
To install doxysummary:
$ pip install .
To build examples:
$ cd example
$ doxygen Doxyfile
$ make html
To compile the doc:
$ cd docs
$ make html
Usage
In conf.py
, add sphinx_doxysummary
to the list of extensions, and set the
config variable doxygen_xml
to the list of locations of xml files:
extensions = [...
'sphinx_doxysummary',
...
]
doxygen_xml = ['./xml'] # each directory corresponds to one Doxygen project
Then in the input rst file, add the following directive:
.. doxysummary::
:toctree: generated
:template: cppclass.rst
spam::Foo # this is comment
Bar
~a_long_name_space::MyClass # only MyClass appears in the summary table
Note:
- Anything placed after
#
is line comment. - Display non-scoped name in the summary table by placing a
~
at the beginning of the entry
Options
-
:template:
(optional) : name of the template. -
:toctree:
(optional) : directory in which rst files are generated. -
:scope:
(optional) : current scope (namespace, class, enum, etc) of the items... doxysummary:: :toctree: generated :template: cppclass.rst :scope: fruit Cherry # as same as fruit::Cherry Orange # as same as fruit::Orange
From version 1.2.0, user can customize the displayed name of the item in the autosummary table with aliasing:
.. doxysummary::
:toctree: generated
:template: cppclass.rst
fruit::Cherry "CppCherry"
fruit::Orange "CppOrange" # display name is CppOrange and CppCherry
Note: Alias containing space is not recommended.
New in version 2.2.0: function overloading is officially supported.
.. doxysummary::
:toctree: generated
func_overload()
func_overload(int a) "func_overload(int)"
func_overload(char,char)
func_overload(std::vector<double>)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sphinx_doxysummary-2.3.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cb4caaf75a2a3eb0cbaaadcf6dfb2f09d016f1514ea69a2104f6775920b5ecb9 |
|
MD5 | e9f13fc0f15ace1fef29c806bd04cb06 |
|
BLAKE2b-256 | 5f39f9f241fec5da049689d0d10553eff339574adab6d0a1f84053c4c8318bca |