5. Substitutions
5.1. Usage
To ease the use of icons in QGIS manuals, replacements are defined
for each icon in /source/substitutions.txt
file at QGIS-Documentation repository and some of these substitutions
are listed below.
Thus, when you want to use an icon from QGIS application in the documentation
there is a big chance that there is already a substitution that can/should be used.
If no replacement exists:
check the documentation repository whether the icon is available in
/static/common
folder. If no image, then you need to find and copy the icon image file from QGIS repository (often under default themes folder) and paste (in.png
format) under/static/common
folder. For convenience and update, it’s advised to keep filename when possible.create the reference to the substitution in the
/substitutions.txt
file following the example below. The replacement text should be derived from file name and in camelCase:.. |dataSourceManager| image:: /static/common/mActionDataSourceManager.png :width: 1.5em .. |splitLayer| image:: /static/common/split_layer.png :width: 1.5em
Update the target section(s) of the docs, using your new substitution.
(optional but highly desirable) add the substitution to the list below.
Add the new substitution reference in the substitutions list at the end of the file(s) it is used in, or run the convenient
scripts/find_set_subst.py
script.# from the repository main folder python3 scripts/find_set_subst.py
5.2. Common Substitutions
Below are given some icons and their substitution to use when writing documentation. Can be used/found in many places in manuals.
5.2.1. Platform Icons
Icon |
Substitution |
Icon |
Substitution |
---|---|---|---|
|
|||
|
|
||
|
|
5.4. Other basic icons
Icon |
Substitution |
Icon |
Substitution |
---|---|---|---|
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
5.5. Attribute Table
Icon |
Substitution |
Icon |
Substitution |
---|---|---|---|
|
|
||
|
|
||
|
|||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|||
|
5.6. Projections and Georeferencer
Icon |
Substitution |
Icon |
Substitution |
---|---|---|---|
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
5.7. Print Layout
Icon |
Substitution |
Icon |
Substitution |
---|---|---|---|
|
|
||
|
|||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
5.8. Layer Properties
Icon |
Substitution |
Icon |
Substitution |
---|---|---|---|
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|||
|
|
5.9. Plugins
5.9.1. Processing
Icon |
Substitution |
Icon |
Substitution |
---|---|---|---|
|
|
||
|
|
||
|
|||
|
|
||
|
|
||
|
|
||
|
|||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
5.9.2. Various Core Plugins
Standard provided with basic install, but not loaded with initial install
Icon |
Substitution |
Icon |
Substitution |
---|---|---|---|
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
5.9.3. Grass integration
Icon |
Substitution |
Icon |
Substitution |
---|---|---|---|
|
|
||
|
|
||
|
|