PyCharm 2016.3 Help

Generating Reference Documentation

PyCharm helps produce the formatted API documentation, using the following documentation generators:

Generating Reference Documentation Using DocUtils

To generate docutils documentation

  1. Select DocUtil task run/debug configuration, and change it as required: specify the configuration name, input and output directories, and optional keys.
  2. Launch this run/debug configuration, as described in the section Running Applications.

Generating Reference Documentation Using Sphinx

To create initial infrastructure for Sphinx documentation

  1. On the main menu, choose Tools | Sphinx quickstart.
  2. If the Sphinx working directory is not specified in the Python Integrated Tools page, the Set working directory dialog box opens, suggesting you to specify the path to the documentation.
    /help/img/idea/2016.3/py_sphinx_working_directory.png
  3. In the console that opens in PyCharm, answer the questions provided by the sphinx-quickstart utility. In particular, specify the source directory, where the generated conf.py file will be stored. If, answering this question, you just press Enter, PyCharm will use either the path you've specified in the previous step, or the path specified in the Sphinx working directory field of the Python Integrated Tools page.

To generate Sphinx documentation

  1. Select Sphinx task run/debug configuration, and change it as required: specify the configuration name, input and output directories.
  2. Launch this run/debug configuration, as described in the section Running Applications.

See Also

Last modified: 23 December 2016