Ctrl+K
Logo image Logo image

Documenteer

Site Navigation

  • Project guides
  • Sphinx extensions
  • Development
  • Change Log
  • Rubin docs

Site Navigation

  • Project guides
  • Sphinx extensions
  • Development
  • Change Log
  • Rubin docs

Section Navigation

  • Sphinx extensions for the LSST Science Pipelines task framework
  • The autocppapi extension for listing Doxylink C++ APIs through Doxylink
  • Jira reference roles
  • LSST document reference roles
  • The remote code block extension
  • Package toctree extension for LSST Stack documentation
  • BibTeX style extension for LSST
  • The autodocreset extension for resetting automodapi’s autodoc enhancements

The autocppapi extension for listing Doxylink C++ APIs through Doxylink#

Documenteer provides an autocppapi directive that serves a similar role as automodapi, but instead provides a listing of APIs in a C++ namespace. The autocppapi works with Doxylink to link to APIs in a Doxygen site.

To use this directive, add the documenteer.ext.autocppapi extension to your conf.py file:

extensions = [..., "sphinxcontrib.doxylink", "documenteer.ext.autocppapi"]

Important

The autocppapi extension needs Doxylink to be installed and also included in the extensions listing. If you installed autocppapi through the “pipelines” extra, Doxylink will be installed for you. Doxylink is automatically configured in Pipelines documentation builds to point to a Doxygen site that’s embedded during the build process (see Overview of the pipelines.lsst.io build system). Otherwise, you can manually add Doxylink to your project’s depenencies:

pip install sphinxcontrib-doxylink

autocppapi directive#

.. autocppapi:: namespace#

Create a listing of APIs associated with the given namespace. The listing is broken into subsections for each type of API:

  • Classes

  • Structs

  • Variables

  • Defines

Each listed item is a link into the Doxygen C++ API reference.

Example

.. autocppapi:: lsst::afw::image

This example produces a listing of APIs associated with the lsst::afw::image namespace. In order to use autocppapi like this, without additional options, you need to set the documenteer_autocppapi_doxylink_role configuration value in your conf.py file.

Options

:doxylink-role: role-name

Set this option to the name of the Doxylink role instead of using the documenteer_autocppapi_doxylink_role configuration variable.

Configurations#

documenteer_autocppapi_doxylink_role

Set this configuration variable to the name of the Doxylink role. As an example, this is how pipelines.lsst.io configures the extension:

doxylink = {"lsstcc": ("_doxygen/doxygen.tag", "cpp-api")}

documenteer_autocppapi_doxylink_role = "lsstcc"

To override this configuration on a per-autocppapi directive basis, you can use the directive’s :doxylink-role: option instead.

previous

Sphinx extensions for the LSST Science Pipelines task framework

next

Jira reference roles

On this page
  • autocppapi directive
  • Configurations

© Copyright 2015-2022 Association of Universities for Research in Astronomy, Inc. (AURA).

Created using Sphinx 5.1.1.