Browsing Hawaiian translation

3.

This is a list in progress as I work on the user manual. There are a number of things for which I created conventions. I want to keep them in a central space so that others have access to them and that I can refer to them as well. ;-)

4.

The list is not in any particular order.

5.

Screenshots

6.

are placed using the "figure" directive.

7.

always include alt text and a figure description. The latter will be numbered in the PDF export. That sets them apart from the text.

8.

are generally placed above a list if they are part of step-by-step instructions.

9.

should have as few instructions as possible about the steps that are to be taken in them. Preferably, only the step numbers so that they can be exchanged more easily and the text of the steps is translatable because it is text and not part of the image. That could also mean that translators can translate the steps but don't immediately have to change the screenshots.

10.

get callouts that are created in Gimp with the `script <https://mahara.org/view/view.php?id=60234>`_ that Iñaki adapted.

11.

that have callouts refer to the steps that need to be taken and that are explained below the figure.

12.

should only show the necessary area and not the entire screen or URL address bars etc. where not necessary.