5. Substitutions

5.1. Usage 

Pour faciliter l’utilisation d’icônes dans les manuels de QGIS, le fichier /source/substitutions.txt 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érifiez dans le dépôt de documentation si l’icône est disponible dans le dossier /static/common. S’il n’y a aucune image, alors il faudra trouver et copier l’image de l’icône depuis le Dépôt QGIS (souvent dans le répertoire https://github.com/qgis/QGIS/blob/release-3_16/images/themes/default) et le coller (au format .png) dans le dossier /static/common. Par praticité et pour les mises à jour, il est recommandé de conserver les noms de fichiers autant que possible.
créez la référence à la substitution dans le fichier /source/substitutions.txt 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
```
lancez le script scripts/find_set_subst.py pour mettre à jour les définitions des substitutions dans les fichiers rst et inclure la ou les nouvelles substitution(s).
(facultatif mais souhaitable) ajoutez l’icône et sa référence dans la liste ci-dessous.

5.2. Substitutions usuelles 

Ci-dessous quelques icônes et leur substitution quand on écrit de la documentation. Vous les trouverez dans de nombreux endroits dans les manuels.

5.2.1. Icônes de plateforme 

Icône	Substitution	Icône	Substitution
	`\|logo\|`
	`\|kde\|`		`\|nix\|`
	`\|osx\|`		`\|win\|`

5.2.2. Éléments de menu 

Substitution	Icône	Substitution
`\|checkbox\|`		`\|unchecked\|`
`\|radioButtonOn\|`		`\|radioButtonOff\|`
`\|selectNumber\|`		`\|selectString\|`
`\|selectColor\|`		`\|selectColorRamp\|`
`\|tab\|`	°	`\|degrees\|`
`\|inputText\|`		`\|slider\|`

5.3. Icônes de la barre d’outils 

5.3.1. Gestion de couche et aperçu 

Icône	Substitution	Icône	Substitution
	`\|dataSourceManager\|`
	`\|addOgrLayer\|`		`\|addDb2Layer\|`
	`\|addRasterLayer\|`		`\|addMssqlLayer\|`
	`\|addDelimitedTextLayer\|`		`\|addSpatiaLiteLayer\|`
	`\|addPostgisLayer\|`		`\|addOracleLayer\|`
	`\|addAfsLayer\|`		`\|addAmsLayer\|`
	`\|addMeshLayer\|`
	`\|addVectorTileLayer\|`		`\|addXyzLayer\|`
	`\|addVirtualLayer\|`		`\|addWmsLayer\|`
	`\|addWcsLayer\|`		`\|addWfsLayer\|`
	`\|newVectorLayer\|`		`\|newSpatiaLiteLayer\|`
	`\|newGeoPackageLayer\|`		`\|createMemory\|`
	`\|newVirtualLayer\|`
	`\|dbManager\|`		`\|gdal\|`
	`\|geoPackage\|`		`\|spatialite\|`
	`\|virtualLayer\|`		`\|wms\|`
	`\|wcs\|`		`\|wfs\|`
	`\|dbSchema\|`
	`\|inOverview\|`		`\|addAllToOverview\|`
	`\|removeAllOVerview\|`		`\|removeLayer\|`
	`\|showAllLayers\|`		`\|hideAllLayers\|`
	`\|showMapTheme\|`		`\|showSelectedLayers\|`
	`\|hideSelectedLayers\|`		`\|hideDeselectedLayers\|`
	`\|toggleAllLayers\|`		`\|toggleSelectedLayers\|`
	`\|addLayer\|`
	`\|indicatorTemporal\|`		`\|indicatorNonRemovable\|`
	`\|indicatorEmbedded\|`		`\|indicatorFilter\|`
	`\|indicatorMemory\|`		`\|indicatorNoCRS\|`
	`\|indicatorBadLayer\|`		`\|favourites\|`

5.3.2. Fichier 

Icône	Substitution	Icône	Substitution
	`\|fileNew\|`		`\|fileOpen\|`
	`\|fileSave\|`		`\|fileSaveAs\|`
	`\|fileExit\|`

5.3.3. Éditer 

Icône	Substitution	Icône	Substitution
	`\|undo\|`		`\|redo\|`
	`\|editCopy\|`		`\|editPaste\|`
	`\|editCut\|`		`\|saveEdits\|`
	`\|editableEdits\|`
	`\|circle2Points\|`		`\|circle2TangentsPoint\|`
	`\|circle3Points\|`		`\|circle3Tangents\|`
	`\|circleCenterPoint\|`		`\|ellipseCenter2Points\|`
	`\|ellipseCenterPoint\|`		`\|ellipseExtent\|`
	`\|ellipseFoci\|`		`\|rectangle3PointsDistance\|`
	`\|rectangle3PointsProjected\|`		`\|rectangleCenter\|`
	`\|rectangleExtent\|`		`\|regularPolygon2Points\|`
	`\|regularPolygonCenterCorner\|`		`\|regularPolygonCenterPoint\|`

5.3.4. Identity result 

Icône	Substitution	Icône	Substitution
	`\|expandTree\|`		`\|collapseTree\|`
	`\|expandNewTree\|`		`\|formView\|`
	`\|deselectAll\|`		`\|editCopy\|`
	`\|filePrint\|`
	`\|identifyByRectangle\|`		`\|identifyByPolygon\|`
	`\|identifyByFreehand\|`		`\|identifyByRadius\|`

5.3.5. Numérisation et numérisation avancée 

Icône	Substitution	Icône	Substitution
	`\|cad\|`		`\|cadConstruction\|`
	`\|cadParallel\|`		`\|cadPerpendicular\|`
	`\|toggleEditing\|`		`\|allEdits\|`
	`\|tracing\|`		`\|snapping\|`
	`\|capturePoint\|`		`\|capturePolygon\|`
	`\|captureLine\|`		`\|deleteSelectedFeatures\|`
	`\|circularStringCurvePoint\|`		`\|circularStringRadius\|`
	`\|vertexTool\|`		`\|vertexToolActiveLayer\|`
	`\|moveFeature\|`		`\|moveFeatureCopy\|`
	`\|moveFeatureLine\|`		`\|moveFeatureCopyLine\|`
	`\|moveFeaturePoint\|`		`\|moveFeatureCopyPoint\|`
	`\|rotateFeature\|`		`\|rotatePointSymbols\|`
	`\|offsetCurve\|`		`\|offsetPointSymbols\|`
	`\|simplifyFeatures\|`		`\|reshape\|`
	`\|addRing\|`		`\|addPart\|`
	`\|fillRing\|`
	`\|deleteRing\|`		`\|deletePart\|`
	`\|mergeFeatures\|`		`\|mergeFeatAttributes\|`
	`\|splitFeatures\|`		`\|splitParts\|`
	`\|reverseLine\|`

5.3.6. Navigateur de cartes et Attributs 

Icône	Substitution	Icône	Substitution
	`\|pan\|`		`\|panToSelected\|`
	`\|zoomIn\|`		`\|zoomOut\|`
	`\|zoomActual\|`		`\|zoomFullExtent\|`
	`\|zoomToLayer\|`		`\|zoomToSelected\|`
	`\|zoomLast\|`		`\|zoomNext\|`
	`\|refresh\|`
	`\|identify\|`		`\|mapTips\|`
	`\|showBookmarks\|`		`\|newBookmark\|`
	`\|measure\|`		`\|measureArea\|`
	`\|measureAngle\|`
	`\|newMap\|`		`\|new3DMap\|`
	`\|tiltUp\|`		`\|tiltDown\|`
	`\|3dNavigation\|`		`\|play\|`

5.3.7. Selection and Expressions 

Icône	Substitution	Icône	Substitution
	`\|selectRectangle\|`		`\|selectPolygon\|`
	`\|selectFreehand\|`		`\|selectRadius\|`
	`\|selectAll\|`		`\|deselectAll\|`
	`\|invertSelection\|`		`\|expressionSelect\|`
	`\|deselectActiveLayer\|`		`\|algorithmSelectLocation\|`
	`\|selectAllTree\|`		`\|select\|`
	`\|formSelect\|`		`\|dataDefined\|`
	`\|expression\|`		`\|dataDefineOn\|`
	`\|dataDefineExpressionOn\|`		`\|dataDefineError\|`
	`\|dataDefineExpressionError\|`
	`\|addExpression\|`
	`\|expressionFilter\|`		`\|filterMap\|`

5.3.8. Étiquettes et Diagrammes 

Icône	Substitution	Icône	Substitution
	`\|labeling\|`		`\|labelingNone\|`
	`\|labelingRuleBased\|`		`\|labelingObstacle\|`
	`\|piechart\|`		`\|diagramNone\|`
	`\|text\|`		`\|histogram\|`
	`\|stackedBar\|`
	`\|annotation\|`		`\|textAnnotation\|`
	`\|formAnnotation\|`		`\|htmlAnnotation\|`
	`\|svgAnnotation\|`		`\|autoPlacement\|`
	`\|labelbackground\|`		`\|labelbuffer\|`
	`\|labelformatting\|`		`\|labelplacement\|`
	`\|labelshadow\|`		`\|render\|`
	`\|labelcallout\|`
	`\|labelAnchorCenter\|`		`\|labelAnchorCustom\|`
	`\|labelAnchorEnd\|`		`\|labelAnchorStart\|`
	`\|pinLabels\|`		`\|showHideLabels\|`
	`\|moveLabel\|`		`\|rotateLabel\|`
	`\|showPinnedLabels\|`		`\|showUnplacedLabel\|`
	`\|changeLabelProperties\|`

5.3.9. Décorations 

Icône	Substitution	Icône	Substitution
	`\|copyrightLabel\|`		`\|addGrid\|`
	`\|titleLabel\|`		`\|northArrow\|`
	`\|scaleBar\|`		`\|addMap\|`
	`\|addImage\|`

5.3.10. Help 

Icône	Substitution	Icône	Substitution
	`\|helpContents\|`		`\|qgisHomePage\|`
	`\|success\|`
	`\|helpSponsors\|`		`\|contextHelp\|`

5.3.11. Couleurs 

Icône	Substitution	Icône	Substitution
	`\|colorBox\|`		`\|colorPicker\|`
	`\|colorSwatches\|`		`\|colorWheel\|`

5.4. Autres icônes de base 

Icône	Substitution	Icône	Substitution
	`\|arrowDown\|`		`\|arrowUp\|`
	`\|signPlus\|`		`\|signMinus\|`
	`\|projectProperties\|`		`\|options\|`
	`\|interfaceCustomization\|`		`\|keyboardShortcuts\|`
	`\|copyrightLabel\|`		`\|northArrow\|`
	`\|scaleBar\|`		`\|tracking\|`
	`\|gpsImporter\|`		`\|gpsTrackBarChart\|`
	`\|folder\|`		`\|extents\|`
	`\|settings\|`		`\|start\|`
	`\|3dconfigure\|`		`\|deleteSelected\|`
	`\|browserExpand\|`		`\|browserCollapse\|`
	`\|codeEditor\|`

5.5. Table attributaire 

Icône	Substitution	Icône	Substitution
	`\|openTable\|`		`\|selectedToTop\|`
	`\|selectAll\|`		`\|invertSelection\|`
	`\|panToSelected\|`		`\|zoomToSelected\|`
	`\|copySelected\|`		`\|editPaste\|`
	`\|expressionSelect\|`		`\|deleteSelectedFeatures\|`
	`\|newAttribute\|`		`\|deleteAttribute\|`
	`\|newTableRow\|`		`\|calculateField\|`
	`\|refresh\|`		`\|formView\|`
	`\|conditionalFormatting\|`		`\|multiEdit\|`
	`\|dock\|`		`\|actionRun\|`
	`\|duplicateFeature\|`
	`\|panTo\|`		`\|highlightFeature\|`

5.6. Projections et Géoréférenceur 

Icône	Substitution	Icône	Substitution
	`\|geographic\|`		`\|crs\|`
	`\|customProjection\|`		`\|setProjection\|`
	`\|projectionDisabled\|`		`\|projectionEnabled\|`
	`\|transformation\|`
	`\|georefRun\|`		`\|pencil\|`
	`\|linkQGisToGeoref\|`		`\|linkGeorefToQGis\|`
	`\|fullHistogramStretch\|`

5.7. Mise en page de cartes 

Icône	Substitution	Icône	Substitution
	`\|newLayout\|`		`\|layoutManager\|`
	`\|duplicateLayout\|`
	`\|newReport\|`		`\|newPage\|`
	`\|atlasSettings\|`		`\|atlas\|`
	`\|filePrint\|`		`\|saveMapAsImage\|`
	`\|saveAsSVG\|`		`\|saveAsPDF\|`
	`\|addBasicShape\|`		`\|addBasicCircle\|`
	`\|addBasicTriangle\|`		`\|addBasicRectangle\|`
	`\|addNodesShape\|`		`\|editNodesShape\|`
	`\|addPolygon\|`		`\|addPolyline\|`
	`\|addArrow\|`		`\|northArrow\|`
	`\|add3DMap\|`		`\|addMap\|`
	`\|addLegend\|`		`\|addHtml\|`
	`\|addManualTable\|`		`\|addTable\|`
	`\|addImage\|`		`\|addMarker\|`
	`\|label\|`		`\|scaleBar\|`
	`\|select\|`		`\|moveItemContent\|`
	`\|setToCanvasScale\|`		`\|setToCanvasExtent\|`
	`\|viewScaleInCanvas\|`		`\|viewExtentInCanvas\|`
	`\|raiseItems\|`		`\|lowerItems\|`
	`\|moveItemsToTop\|`		`\|moveItemsToBottom\|`
	`\|alignLeft\|`		`\|alignRight\|`
	`\|alignHCenter\|`		`\|alignVCenter\|`
	`\|alignTop\|`		`\|alignBottom\|`
	`\|resizeShortest\|`		`\|resizeTallest\|`
	`\|resizeNarrowest\|`		`\|resizeWidest\|`
	`\|resizeSquare\|`
	`\|lockItems\|`		`\|unlockAll\|`
	`\|locked\|`		`\|unlocked\|`
	`\|lockedRepeat\|`		`\|lockedGray\|`
	`\|groupItems\|`

5.8. Propriétés des couches 

Icône	Substitution	Icône	Substitution
	`\|symbology\|`		`\|labeling\|`
	`\|sourceFields\|`		`\|general\|`
	`\|metadata\|`		`\|action\|`
	`\|display\|`		`\|rendering\|`
	`\|join\|`		`\|diagram\|`
	`\|labelmask\|`		`\|temporal\|`
	`\|legend\|`		`\|dependencies\|`
	`\|3d\|`		`\|system\|`
	`\|editMetadata\|`		`\|overlay\|`
	`\|digitizing\|`		`\|auxiliaryStorage\|`
	`\|history\|`		`\|stylePreset\|`
	`\|search\|`		`\|pyramids\|`
	`\|transparency\|`		`\|rasterHistogram\|`
	`\|singleSymbol\|`		`\|nullSymbol\|`
	`\|graduatedSymbol\|`		`\|categorizedSymbol\|`
	`\|25dSymbol\|`		`\|ruleBasedSymbol\|`
	`\|invertedSymbol\|`		`\|heatmapSymbol\|`
	`\|pointDisplacementSymbol\|`		`\|pointClusterSymbol\|`
	`\|meshcontours\|`		`\|meshcontoursoff\|`
	`\|meshvectors\|`		`\|meshvectorsoff\|`
	`\|meshframe\|`
	`\|sum\|`		`\|sort\|`
	`\|paintEffects\|`		`\|mapIdentification\|`
	`\|styleManager\|`		`\|iconView\|`
	`\|joinNotEditable\|`		`\|joinedLayerNotEditable\|`
	`\|joinHasNotUpsertOnEdit\|`		`\|filterTableFields\|`
	`\|symbologyEdit\|`
	`\|sharingImport\|`		`\|sharingExport\|`

5.9. Extensions 

5.9.1. Traitements 

Icône	Substitution	Icône	Substitution
	`\|processing\|`		`\|processingModel\|`
	`\|processingHistory\|`		`\|processingResult\|`
	`\|processSelected\|`		`\|processingHelp\|`
	`\|saveAsPython\|`		`\|processingOutput\|`
	`\|qgsProjectFile\|`		`\|addToProject\|`
	`\|integer\|`
	`\|mean\|`		`\|layerExtent\|`
	`\|randomSelection\|`		`\|vectorGrid\|`
	`\|convexHull\|`		`\|buffer\|`
	`\|intersect\|`		`\|union\|`
	`\|symDifference\|`		`\|clip\|`
	`\|difference\|`		`\|dissolve\|`
	`\|checkGeometry\|`		`\|exportGeometry\|`
	`\|delaunay\|`		`\|centroids\|`
	`\|toLines\|`		`\|extractNodes\|`
	`\|splitLayer\|`		`\|heatmap\|`
	`\|showRasterCalculator\|`		`\|showMeshCalculator\|`

5.9.2. Diverses extensions principales 

Fournies avec l’installation de base, mais non chargées lors de l’installation initiale

Icône	Substitution	Icône	Substitution
	`\|showPluginManager\|`		`\|installPluginFromZip\|`
	`\|pythonFile\|`		`\|runConsole\|`
	`\|showEditorConsole\|`		`\|clearConsole\|`
	`\|offlineEditingCopy\|`		`\|offlineEditingSync\|`
	`\|plugin\|`		`\|interpolation\|`
	`\|gdalScript\|`		`\|metasearch\|`
	`\|geometryChecker\|`		`\|topologyChecker\|`
	`\|fromSelectedFeature\|`		`\|sqlQueryBuilder\|`

5.9.3. Intégration GRASS 

Icône	Substitution	Icône	Substitution
	`\|grass\|`		`\|grassRegion\|`
	`\|grassTools\|`		`\|grassNewMapset\|`
	`\|grassOpenMapset\|`		`\|grassCloseMapset\|`

Icône	Substitution	Icône	Substitution
	`\|logo\|`
	`\|kde\|`		`\|nix\|`
	`\|osx\|`		`\|win\|`

Substitution	Icône	Substitution
`\|checkbox\|`		`\|unchecked\|`
`\|radioButtonOn\|`		`\|radioButtonOff\|`
`\|selectNumber\|`		`\|selectString\|`
`\|selectColor\|`		`\|selectColorRamp\|`
`\|tab\|`	°	`\|degrees\|`
`\|inputText\|`		`\|slider\|`

Icône	Substitution	Icône	Substitution
	`\|dataSourceManager\|`
	`\|addOgrLayer\|`		`\|addDb2Layer\|`
	`\|addRasterLayer\|`		`\|addMssqlLayer\|`
	`\|addDelimitedTextLayer\|`		`\|addSpatiaLiteLayer\|`
	`\|addPostgisLayer\|`		`\|addOracleLayer\|`
	`\|addAfsLayer\|`		`\|addAmsLayer\|`
	`\|addMeshLayer\|`
	`\|addVectorTileLayer\|`		`\|addXyzLayer\|`
	`\|addVirtualLayer\|`		`\|addWmsLayer\|`
	`\|addWcsLayer\|`		`\|addWfsLayer\|`
	`\|newVectorLayer\|`		`\|newSpatiaLiteLayer\|`
	`\|newGeoPackageLayer\|`		`\|createMemory\|`
	`\|newVirtualLayer\|`
	`\|dbManager\|`		`\|gdal\|`
	`\|geoPackage\|`		`\|spatialite\|`
	`\|virtualLayer\|`		`\|wms\|`
	`\|wcs\|`		`\|wfs\|`
	`\|dbSchema\|`
	`\|inOverview\|`		`\|addAllToOverview\|`
	`\|removeAllOVerview\|`		`\|removeLayer\|`
	`\|showAllLayers\|`		`\|hideAllLayers\|`
	`\|showMapTheme\|`		`\|showSelectedLayers\|`
	`\|hideSelectedLayers\|`		`\|hideDeselectedLayers\|`
	`\|toggleAllLayers\|`		`\|toggleSelectedLayers\|`
	`\|addLayer\|`
	`\|indicatorTemporal\|`		`\|indicatorNonRemovable\|`
	`\|indicatorEmbedded\|`		`\|indicatorFilter\|`
	`\|indicatorMemory\|`		`\|indicatorNoCRS\|`
	`\|indicatorBadLayer\|`		`\|favourites\|`

Icône	Substitution	Icône	Substitution
	`\|fileNew\|`		`\|fileOpen\|`
	`\|fileSave\|`		`\|fileSaveAs\|`
	`\|fileExit\|`

Icône	Substitution	Icône	Substitution
	`\|undo\|`		`\|redo\|`
	`\|editCopy\|`		`\|editPaste\|`
	`\|editCut\|`		`\|saveEdits\|`
	`\|editableEdits\|`
	`\|circle2Points\|`		`\|circle2TangentsPoint\|`
	`\|circle3Points\|`		`\|circle3Tangents\|`
	`\|circleCenterPoint\|`		`\|ellipseCenter2Points\|`
	`\|ellipseCenterPoint\|`		`\|ellipseExtent\|`
	`\|ellipseFoci\|`		`\|rectangle3PointsDistance\|`
	`\|rectangle3PointsProjected\|`		`\|rectangleCenter\|`
	`\|rectangleExtent\|`		`\|regularPolygon2Points\|`
	`\|regularPolygonCenterCorner\|`		`\|regularPolygonCenterPoint\|`