其他¶

Cross-referencing:

:doc:`parrot`
:doc:`/people` or :doc:`../people`
like usual: :doc:`Monty Python members </people>`

Cross-referencing:

:abbr:
:command:
:dfn:
:file:
    ... is installed in :file:`/usr/lib/python2.{x}/site-packages` ...
:guilabel:
:kbd:
:mailheader:
:makevar:
:manpage:
:menuselection:
    :menuselection:`Start --> Programs`
:mimetype:
:newsgroup:
:program:
:regexp:
:samp:

abbr:
command:
dfn:
file:: … is installed in /usr/lib/python2.x/site-packages …
guilabel:
kbd:
mailheader:
makevar:
manpage:
menuselection:: Start ‣ Programs
mimetype:
newsgroup:
program:
regexp:
samp:

Substitutions:

|release|
|version|
|today|

V1.7.20
V1.7.20
2024 年 10 月 31 日

Meta-information markup:

.. sectionauthor:: name <email>
.. sectionauthor:: Guido van Rossum <guido@python.org>
.. codeauthor:: name <email>

Index-generating markup:

.. index:: <entries>
// 例
.. index::
   single: execution; context
   module: __main__
   module: sys
   triple: module; search; path

The execution context
---------------------

...

索引与查询:

* :ref:`genindex`
* :ref:`search`

其他:

.. productionlist::
   try_stmt: try1_stmt | try2_stmt
   try1_stmt: "try" ":" `suite`
            : ("except" [`expression` ["," `target`]] ":" `suite`)+
            : ["else" ":" `suite`]
            : ["finally" ":" `suite`]
   try2_stmt: "try" ":" `suite`
            : "finally" ":" `suite`

try_stmt  ::=  try1_stmt | try2_stmt
try1_stmt ::=  "try" ":" suite
               ("except" [expression ["," target]] ":" suite)+
               ["else" ":" suite]
               ["finally" ":" suite]
try2_stmt ::=  "try" ":" suite
               "finally" ":" suite

other¶

Sphinx extension to add project links to the sidebar: https://github.com/westurner/sphinxcontrib-srclinks