Documenteer
  • Forum
  • Docs
  • LSST.org →

Navigation

  • next »
  • « previous |
  • Documenteer »
  • Sphinx extensions provided by Documenteer »
  • The autocppapi extension for listing Doxylink C++ APIs through Doxylink

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.

On this page

  • The autocppapi extension for listing Doxylink C++ APIs through Doxylink
    • autocppapi directive
    • Configurations

  Back to Top

Created using Sphinx 3.4.3. Page design is based on Astropy's bootstrap-astropy theme in astropy-helpers.
LSST documentation is proudly served through the Fastly CDN.

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

Financial support for LSST comes from the National Science Foundation (NSF) through Cooperative Agreement No. 1258333, the Department of Energy (DOE) Office of Science under Contract No. DE-AC02-76SF00515, and private funding raised by the LSST Corporation. The NSF-funded LSST Project Office for construction was established as an operating center under management of the Association of Universities for Research in Astronomy (AURA). The DOE-funded effort to build the LSST camera is managed by the SLAC National Accelerator Laboratory (SLAC).