Pour faciliter l’utilisation d’icônes dans les manuels de QGIS, le fichier /source/conf.py
dans le dépôt QGIS-Documentation contient un texte de substitution pour chaque fichier d’icône. Certaines de ces substitutions sont listées ci-après. De fait, lorsque vous voulez utiliser une icône de QGIS dans la documentation, il y a de grandes chances qu’une solution de substitution existe déjà et puisse/doive être utilisée.
Si aucun remplacement n’existe :
vérifier dans le dépôt de documentation si l’icône est disponible dans le dossier /resources/en/docs/common
. S’il n’y a aucune image, alors il faudra trouver et copier l’image de l’icône depuis le Depôt QGIS (souvent dans le répertoire https://github.com/qgis/QGIS/tree/master/images/themes/default) et le coller (au format .png
) dans le dossier /resources/en/docs/common
. Par praticité et pour les mises à jour, il est recommandé de conserver les noms de fichiers autant que possible.
créer la référence à la substitution dans le fichier /source/conf.py
en suivant l’exemple ci dessous. Le texte de remplacement devra être en casse Camel :
.. |splitLayer| image:: /static/common/split_layer.png
:width: 1.5em
(facultatif mais souhaitable) ajoutez l’icône et sa référence dans la liste ci-dessous.
Ci-dessous quelques icônes et leur substitution quand on écrit de la documentation. Vous les trouverez dans de nombreux endroits dans les manuels.
Icône |
Substitution |
---|---|
![]() |
|nix| |
![]() |
|osx| |
![]() |
|win| |
Icône |
Substitution | Icône |
Substitution |
---|---|---|---|
![]() |
|fileNew| |
![]() |
|fileOpen| |
![]() |
|fileSave| |
![]() |
|fileSaveAs| |
![]() |
|fileExit| |
Icône |
Substitution | Icône |
Substitution |
---|---|---|---|
![]() |
|saveEdits| |
||
![]() |
|undo| |
![]() |
|redo| |
![]() |
|editCopy| |
![]() |
|editPaste| |
![]() |
|editCut| |
Icône |
Substitution | Icône |
Substitution |
---|---|---|---|
![]() |
|expandTree| |
![]() |
|collapseTree| |
![]() |
|expandNewTree| |
![]() |
|propertyItem| |
![]() |
|deselectAll| |
![]() |
|editCopy| |
![]() |
|filePrint| |
![]() |
|propertiesWidget| |
Icône |
Substitution | Icône |
Substitution |
---|---|---|---|
![]() |
|labeling| |
![]() |
|textAnnotation| |
![]() |
|annotation| |
![]() |
|formAnnotation| |
Icônes utilisées dans le composeur :
Icônes utilisées dans la fenêtre Propriétés de la couche :
Fournies avec l’installation de base, mais non chargées lors de l’installation initiale
Icône |
Substitution | Icône |
Substitution |
---|---|---|---|
![]() |
|grass| |
||
![]() |
|grassTools| |
![]() |
|grassNewMapset| |
![]() |
|grassOpenMapset| |
![]() |
|grassCloseMapset| |
![]() |
|grassRegion| |
![]() |
|grassSetRegion| |
Icône |
Substitution | Icône |
Substitution |
---|---|---|---|
![]() |
|eventBrowser| |
![]() |
|eventId| |
![]() |
|evisConnect| |
![]() |
|evisFile| |