|
|
28.
|
|
|
Admonitions in use are
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:100
|
|
|
29.
|
|
|
**note**: for anything that should receive a bit more attention
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:102
|
|
|
30.
|
|
|
Notes can be placed directly within a bulleted list. As usual, an empty line before and after the note must be placed and the admonition must be indented by 3 spaces.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:105
|
|
|
31.
|
|
|
**warning**: for anything that needs to be done with caution
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:107
|
|
|
32.
|
|
|
Try not to put everything into an admonition because then the truly important information is lost.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:110
|
|
|
33.
|
|
|
**seealso**: for references to other documents if they need special attention. References to other documents can also be included in the text inline.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:112
|
|
|
34.
|
|
|
The `Sphinx user documentation <http://sphinx.pocoo.org/>`_ is a great place to deepend your knowledge and understanding of using rST with Sphinx. If you have any questions, you can also check out the `Sphinx discussion group <http://groups.google.com/group/sphinx-dev/>`_.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:117
|
|
|
35.
|
|
|
**todo**: for keeping a running ToDo list
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:67
|
|
|
36.
|
|
|
Conventions
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:120
|
|
|
37.
|
|
|
Each section that is related to a navigation menu item should have the path listed, e.g. *Content → Files*. It is best if you copy the arrow to get the correct one.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:124
|
