Skip to main content

AsciiDoxy generates API documentation from Doxygen XML output to AsciiDoc.

Project description

    ___              _ _ ____
   /   |  __________(_|_) __ \____  _  ____  __
  / /| | / ___/ ___/ / / / / / __ \| |/_/ / / /
 / ___ |(__  ) /__/ / / /_/ / /_/ />  </ /_/ /
/_/  |_/____/\___/_/_/_____/\____/_/|_|\__, /
                                      /____/

[ Home | What is AsciiDoxy? | Getting started | Reference documentation | Examples | Contributing | Changelog | GitHub ]

License pip downloads PyPI - Python Version PyPI

AsciiDoxy generates API documentation from Doxygen XML output to AsciiDoc. AsciiDoctor is then used to create HTML or PDF documentation that can be published online.

Supported languages:

  • C++
  • Java
  • Objective-C
  • Python (using doxypypy)
  • Swift (transcoded from Objective-C only)
  • Kotlin (transcoded from Java only)

Features:

  • API documentation generation.
  • Collecting API reference information from remote and local sources.
  • Single and multipage HTML output.
  • Single page PDF output.
  • Transcoding: showing how to use elements written in one language in another compatible language.

Credits

Inspiration for creating AsciiDoxy was found in this article by Sy Brand: https://devblogs.microsoft.com/cppblog/clear-functional-c-documentation-with-sphinx-breathe-doxygen-cmake/

Before going public on GitHub, several people inside TomTom contributed to the internal version of AsciiDoxy. Many thanks to:

  • Andy Salter
  • Arkadiusz Skalski
  • Lukasz Glowcyk
  • Nebojsa Mrmak
  • Niels van der Schans
  • Robert Gernert
  • Tomasz Maj

The python package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asciidoxy-0.8.0.tar.gz (725.9 kB view details)

Uploaded Source

Built Distribution

asciidoxy-0.8.0-py2.py3-none-any.whl (135.2 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file asciidoxy-0.8.0.tar.gz.

File metadata

  • Download URL: asciidoxy-0.8.0.tar.gz
  • Upload date:
  • Size: 725.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

File hashes

Hashes for asciidoxy-0.8.0.tar.gz
Algorithm Hash digest
SHA256 614f0e07e72f219a3bd8bb242337ce2b69d2d87a6e0d4a45870e4f22977bf0f5
MD5 e1c42beeee1bc5af97344d0198c3831d
BLAKE2b-256 1b9869b6e05df7ae34d205cae491df5968f83a57b4ed18ead514f1113eca354f

See more details on using hashes here.

File details

Details for the file asciidoxy-0.8.0-py2.py3-none-any.whl.

File metadata

  • Download URL: asciidoxy-0.8.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 135.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

File hashes

Hashes for asciidoxy-0.8.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 42917905e9c4a499da40d39877d577fa62e9b00cb20ad4f5e726e619ef1c3ec1
MD5 11259dd9ea1ef3541aaf9f412d9fd7e0
BLAKE2b-256 ae11be33698c0f66ee5c3d4ada3218e32d07a9ba9ab8f0d44c3f2ce3dad89bcb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page