|
- Sphinx — Sphinx documentation
These sections cover various topics in using and extending Sphinx for various use-cases They are a comprehensive guide to using Sphinx in many contexts and assume more knowledge of Sphinx
- Installing Sphinx — Sphinx documentation
You may install a global version of Sphinx into your system using OS-specific package managers However, be aware that this is less flexible and you may run into compatibility issues if you want to work across different projects
- Getting started — Sphinx documentation
Much of Sphinx’s power comes from the richness of its default plain-text markup format, reStructuredText, along with its significant extensibility capabilities The goal of this document is to give you a quick taste of what Sphinx is and how you might use it
- Build your first project — Sphinx documentation
In this tutorial you will build a simple documentation project using Sphinx, and view it in your browser as HTML The project will include narrative, handwritten documentation, as well as autogenerated API documentation
- Sphinxを使う — Sphinx documentation
このガイドでは、Sphinxを使用する方法を説明し、Sphinxのインストール、最初のSphinxプロジェクトの設定から、Sphinxが提供するいくつかの高度な機能の使用までを網羅しています。
- Sphinx documentation contents
sphinx ext apidoc – Generate API documentation from Python packages sphinx ext autodoc – Include documentation from docstrings sphinx ext autosectionlabel – Allow referencing sections by their title sphinx ext autosummary – Generate autodoc summaries sphinx ext coverage – Collect doc coverage stats sphinx ext doctest – Test snippets
- Automatic documentation generation from code - Sphinx doc
Sphinx provides yet another level of automation: the autosummary extension The autosummary directive generates documents that contain all the necessary autodoc directives
- Cross-references — Sphinx documentation
Sphinx supports various cross-referencing roles to create links to other elements in the documentation In general, writing :role:`target` creates a link to the object called target of the type indicated by role
|
|
|