mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
41 lines
1.6 KiB
ReStructuredText
41 lines
1.6 KiB
ReStructuredText
:mod:`sphinx.ext.viewcode` -- Add links to highlighted source code
|
|
==================================================================
|
|
|
|
.. module:: sphinx.ext.viewcode
|
|
:synopsis: Add links to a highlighted version of the source code.
|
|
.. moduleauthor:: Georg Brandl
|
|
|
|
.. versionadded:: 1.0
|
|
|
|
|
|
This extension looks at your Python object descriptions (``.. class::``,
|
|
``.. function::`` etc.) and tries to find the source files where the objects are
|
|
contained. When found, a separate HTML page will be output for each module with
|
|
a highlighted version of the source code, and a link will be added to all object
|
|
descriptions that leads to the source code of the described object. A link back
|
|
from the source to the description will also be inserted.
|
|
|
|
There are currently no configuration values for this extension; you just need to
|
|
add ``'sphinx.ext.viewcode'`` to your :confval:`extensions` value for it to
|
|
work.
|
|
|
|
There is also an additional config value:
|
|
|
|
.. confval:: viewcode_import
|
|
|
|
If this is ``True``, viewcode extension will follow alias objects that
|
|
imported from another module such as functions, classes and attributes.
|
|
As side effects, this option
|
|
else they produce nothing. The default is ``True``.
|
|
|
|
.. warning::
|
|
|
|
:confval:`viewcode_import` **imports** the modules to be followed real
|
|
location. If any modules have side effects on import, these will be
|
|
executed by ``viewcode`` when ``sphinx-build`` is run.
|
|
|
|
If you document scripts (as opposed to library modules), make sure their
|
|
main routine is protected by a ``if __name__ == '__main__'`` condition.
|
|
|
|
.. versionadded:: 1.3
|