mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
Consistently use sentence case for headings (#12987)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
This commit is contained in:
parent
886bb945af
commit
6cf3f9238e
@ -89,7 +89,7 @@ To see an example of use of these objects, refer to
|
|||||||
|
|
||||||
.. _build-phases:
|
.. _build-phases:
|
||||||
|
|
||||||
Build Phases
|
Build phases
|
||||||
------------
|
------------
|
||||||
|
|
||||||
One thing that is vital in order to understand extension mechanisms is the way
|
One thing that is vital in order to understand extension mechanisms is the way
|
||||||
|
@ -137,8 +137,8 @@ creating and building your own documentation from scratch.
|
|||||||
|
|
||||||
.. _user-guides:
|
.. _user-guides:
|
||||||
|
|
||||||
User Guides
|
User guide
|
||||||
===========
|
==========
|
||||||
|
|
||||||
These sections cover various topics in using and extending Sphinx for various
|
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
|
use-cases. They are a comprehensive guide to using Sphinx in many contexts and
|
||||||
@ -147,7 +147,7 @@ starting with :ref:`get-started`.
|
|||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 2
|
:maxdepth: 2
|
||||||
:caption: User Guides
|
:caption: User guide
|
||||||
|
|
||||||
usage/index
|
usage/index
|
||||||
development/index
|
development/index
|
||||||
|
@ -1,9 +1,9 @@
|
|||||||
Command-Line Tools
|
Command-line tools
|
||||||
==================
|
==================
|
||||||
|
|
||||||
These are the applications provided as part of Sphinx.
|
These are the applications provided as part of Sphinx.
|
||||||
|
|
||||||
Core Applications
|
Core applications
|
||||||
-----------------
|
-----------------
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
@ -12,7 +12,7 @@ Core Applications
|
|||||||
sphinx-quickstart
|
sphinx-quickstart
|
||||||
sphinx-build
|
sphinx-build
|
||||||
|
|
||||||
Additional Applications
|
Additional applications
|
||||||
-----------------------
|
-----------------------
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
.. currentmodule:: sphinxcontrib.websupport
|
.. currentmodule:: sphinxcontrib.websupport
|
||||||
|
|
||||||
The WebSupport Class
|
The WebSupport class
|
||||||
====================
|
====================
|
||||||
|
|
||||||
.. class:: WebSupport
|
.. class:: WebSupport
|
||||||
|
@ -3,8 +3,8 @@
|
|||||||
Web Support Quick Start
|
Web Support Quick Start
|
||||||
=======================
|
=======================
|
||||||
|
|
||||||
Building Documentation Data
|
Building documentation data
|
||||||
----------------------------
|
---------------------------
|
||||||
|
|
||||||
To make use of the web support package in your application you'll need to build
|
To make use of the web support package in your application you'll need to build
|
||||||
the data it uses. This data includes pickle files representing documents,
|
the data it uses. This data includes pickle files representing documents,
|
||||||
@ -33,7 +33,7 @@ called "static" and contains static files that should be served from "/static".
|
|||||||
:class:`~.WebSupport` object.
|
:class:`~.WebSupport` object.
|
||||||
|
|
||||||
|
|
||||||
Integrating Sphinx Documents Into Your Webapp
|
Integrating Sphinx documents into your web-app
|
||||||
----------------------------------------------
|
----------------------------------------------
|
||||||
|
|
||||||
Now that the data is built, it's time to do something useful with it. Start off
|
Now that the data is built, it's time to do something useful with it. Start off
|
||||||
@ -145,7 +145,7 @@ add this data to the ``COMMENT_OPTIONS`` that are used in the template.
|
|||||||
@app.route('/docs/<path:docname>')
|
@app.route('/docs/<path:docname>')
|
||||||
|
|
||||||
|
|
||||||
Performing Searches
|
Performing searches
|
||||||
-------------------
|
-------------------
|
||||||
|
|
||||||
To use the search form built-in to the Sphinx sidebar, create a function to
|
To use the search form built-in to the Sphinx sidebar, create a function to
|
||||||
@ -167,7 +167,7 @@ returns a context dict in the same format that :meth:`~.WebSupport.get_document`
|
|||||||
does.
|
does.
|
||||||
|
|
||||||
|
|
||||||
Comments & Proposals
|
Comments & proposals
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
Now that this is done it's time to define the functions that handle the AJAX
|
Now that this is done it's time to define the functions that handle the AJAX
|
||||||
@ -217,7 +217,7 @@ and will handle user votes on comments::
|
|||||||
return "success"
|
return "success"
|
||||||
|
|
||||||
|
|
||||||
Comment Moderation
|
Comment moderation
|
||||||
------------------
|
------------------
|
||||||
|
|
||||||
By default, all comments added through :meth:`~.WebSupport.add_comment` are
|
By default, all comments added through :meth:`~.WebSupport.add_comment` are
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
.. currentmodule:: sphinxcontrib.websupport.search
|
.. currentmodule:: sphinxcontrib.websupport.search
|
||||||
|
|
||||||
Search Adapters
|
Search adapters
|
||||||
===============
|
===============
|
||||||
|
|
||||||
To create a custom search adapter you will need to subclass the
|
To create a custom search adapter you will need to subclass the
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
.. currentmodule:: sphinxcontrib.websupport.storage
|
.. currentmodule:: sphinxcontrib.websupport.storage
|
||||||
|
|
||||||
Storage Backends
|
Storage backends
|
||||||
================
|
================
|
||||||
|
|
||||||
To create a custom storage backend you will need to subclass the
|
To create a custom storage backend you will need to subclass the
|
||||||
|
@ -1,5 +1,5 @@
|
|||||||
===============
|
===============
|
||||||
Getting Started
|
Getting started
|
||||||
===============
|
===============
|
||||||
|
|
||||||
Sphinx is a *documentation generator* or a tool that translates a set of plain
|
Sphinx is a *documentation generator* or a tool that translates a set of plain
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
.. _html-themes:
|
.. _html-themes:
|
||||||
|
|
||||||
HTML Theming
|
HTML theming
|
||||||
============
|
============
|
||||||
|
|
||||||
Sphinx provides a number of builders for HTML and HTML-based formats.
|
Sphinx provides a number of builders for HTML and HTML-based formats.
|
||||||
|
Loading…
Reference in New Issue
Block a user