|
|
61.
|
|
|
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
|
|
|
62.
|
|
|
should only show the necessary area and not the entire screen or URL address bars etc. where not necessary.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:67
|
|
|
63.
|
|
|
Most screenshots are added with the *figure* directive.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:69
|
|
|
64.
|
|
|
.. image:: images/figure_directive.* 
:alt: Example of including a screenshot |
|
|
represents a line break.
Start a new line in the equivalent position in the translation.
|
|
|
represents a space character.
Enter a space in the equivalent position in the translation.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:74
|
|
|
65.
|
|
|
Example of including a screenshot
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:74
|
|
|
66.
|
|
|
The first line provides the path to the file.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:76
|
|
|
67.
|
|
|
The \* replaces the file extension and Sphinx chooses the file that is most appropriate. Thus, files could have different image extensions, or you could have the same screenshots in different file formats that are then chosen by the programme to best suit the end format of the manual.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:79
|
|
|
68.
|
|
|
For the Mahara user manual we use .png files in general as we work with screenshots. It is still good to use the \* instead of the .png extension in case the file format is changed at some point.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:83
|
|
|
69.
|
|
|
The second line represents the alt text that is displayed when hovering over the image, when no images are displayed or when viewing the page via a screen reader.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:83
|
|
|
70.
|
|
|
The third line must follow an empty line. This is the text that is displayed below the screenshot as figure description. In the PDF output, the descriptions will be numbered continuously.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
../source/documentation_info.rst:84
|
