|
15.
|
|
|
Compile the user manual in English only. The following command assumes that you want to compile it for Mahara 15.10: ``make preview MAHARA=15.10``
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:32
|
|
16.
|
|
|
Open the ``index.html`` file in a browser to view the manual. You can find it in the folder ``build/en/15.10``.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:33
|
|
17.
|
|
|
Screenshots
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:58
|
|
18.
|
|
|
are placed using the "figure" directive.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:62
|
|
19.
|
|
|
always include alt text and a figure description. That sets them apart from the text.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:61
|
|
20.
|
|
|
are generally placed above a list if they are part of step-by-step instructions.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:62
|
|
21.
|
|
|
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.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:65
|
|
22.
|
|
|
get callouts that are pre-made and can be found in the Gimp file ``/images_originals/z_callouts.xcf``.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:64
|
|
23.
|
|
|
only get an arrow if an item is to be pointed out but there are no steps involved. The arrow can be found in the file ``/images_originals/z_arrow.png``.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:65
|
|
24.
|
|
|
that have callouts refer to the steps that need to be taken and that are explained below the figure.
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:66
|