Browsing Spanish translation

72.

before ``:index:`` and ``:ref:`` and when the index entry or reference ends.

73.

before ``*`` when it is followed by a word and after the closing ``*``, e.g. ``*word*`` because that indicates that the formatting is changed to *word*. The same goes for words that begin and end with ``**``.

74.

Each section that is related to a navigation menu item should have the path listed, e.g. *Main menu → Create → Files*. It is best if you copy the arrow to get the correct one.

75.

Buttons such as *Save* or *Copy page* and also portfolio sections such as *Create*, *Share* etc. are highlighted as emphasized text (with a single \*).

76.

Little buttons can be included in the text like |edit|, |manage|. They are added through a substitution. All replacements are kept in the file *shortcuts.rstext* which is included in each file in which a substitution is used by placing "``.. include:: /shortcuts.rstext``" in the first line of the file. Substitutions are referenced in the text as "``*Edit* button |edit|``" for example pointing out what the action is that you do with them. Translators should not edit the substitution "``|edit|``" itself, but only change "``*Edit* button``" taking care to include the \* again without placing any spaces between the \* and the text to ensure that the word appears highlighted.

77.

An index entry should be created for each section.

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:

79.

``:index:`Decide on the sort order <single: New in Mahara 19.04; Sort order of files in the "Folder" block>```

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 ">`".

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.