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| |