|
|
77.
|
|
|
An index entry should be created for each section.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:138
|
|
|
78.
|
|
|
New features receive an index entry as well in the form "single: New in Mahara x, [the functionality that is new]". Index entries can be placed either above an entire section or inline. Inline is preferable for small functional changes so that readers are directly taken to the new functionality. This can be done like so:
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:128
|
|
|
79.
|
|
|
``:index:`Decide on the sort order <single: New in Mahara 19.04; Sort order of files in the "Folder" block>```
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:0
|
|
|
80.
|
|
|
If there is not a punctuation mark just before ":index:" and/or after ">`", you have to insert a space just before ":index:" and/or after ">`".
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:144
|
|
|
81.
|
|
|
Long sections like the administration are broken up into several pages to make the editing more manageable instead of having everything on one very long page.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:146
|
|
|
82.
|
|
|
reStructuredText does not have a set hierarchy of heading levels. They depend on the individual files. However, to be consistent, the following convention exists:
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:147
|
|
|
83.
|
|
|
Heading 1, e.g. 1.: ===============
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:149
|
|
|
84.
|
|
|
Heading 2, e.g. 1.1.: ---------------
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:150
|
|
|
85.
|
|
|
Heading 3, e.g. 1.1.1.: ~~~~~~~~~~~~~~~
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:151
|
|
|
86.
|
|
|
Heading 4, e.g. 1.1.1.1.: ^^^^^^^^^^^^^^^
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:152
|
