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 :

  1. 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_22/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.

  2. 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
    
  3. 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).

  4. (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

|logo|

kde

|kde|

nix

|nix|

osx

|osx|

win

|win|

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

|dataSourceManager|

addOgrLayer

|addOgrLayer|

addRasterLayer

|addRasterLayer|

addMssqlLayer

|addMssqlLayer|

addDelimitedTextLayer

|addDelimitedTextLayer|

addSpatiaLiteLayer

|addSpatiaLiteLayer|

addPostgisLayer

|addPostgisLayer|

addOracleLayer

|addOracleLayer|

addAfsLayer

|addAfsLayer|

addAmsLayer

|addAmsLayer|

addMeshLayer

|addMeshLayer|

addVectorTileLayer

|addVectorTileLayer|

addXyzLayer

|addXyzLayer|

addVirtualLayer

|addVirtualLayer|

addWmsLayer

|addWmsLayer|

addWcsLayer

|addWcsLayer|

addWfsLayer

|addWfsLayer|

newVectorLayer

|newVectorLayer|

newSpatiaLiteLayer

|newSpatiaLiteLayer|

newGeoPackageLayer

|newGeoPackageLayer|

createMemory

|createMemory|

newVirtualLayer

|newVirtualLayer|

newMeshLayer

|newMeshLayer|

dbManager

|dbManager|

gdal

|gdal|

geoPackage

|geoPackage|

spatialite

|spatialite|

virtualLayer

|virtualLayer|

wms

|wms|

wcs

|wcs|

wfs

|wfs|

dbSchema

|dbSchema|

inOverview

|inOverview|

addAllToOverview

|addAllToOverview|

removeAllFromOverview

|removeAllFromOverview|

removeLayer

|removeLayer|

showAllLayers

|showAllLayers|

hideAllLayers

|hideAllLayers|

showPresets

|showPresets|

showSelectedLayers

|showSelectedLayers|

hideSelectedLayers

|hideSelectedLayers|

hideDeselectedLayers

|hideDeselectedLayers|

toggleAllLayers

|toggleAllLayers|

toggleSelectedLayers

|toggleSelectedLayers|

addLayer

|addLayer|

indicatorTemporal

|indicatorTemporal|

indicatorNonRemovable

|indicatorNonRemovable|

indicatorEmbedded

|indicatorEmbedded|

indicatorFilter

|indicatorFilter|

indicatorMemory

|indicatorMemory|

indicatorNoCRS

|indicatorNoCRS|

indicatorBadLayer

|indicatorBadLayer|

favourites

|favourites|

indicatorLayerError

|indicatorLayerError|

indicatorNotes

|indicatorNotes|

indicatorLowAccuracy

|indicatorLowAccuracy|

indicatorOffline

|indicatorOffline|

5.3.2. Fichier

Icône

Substitution

Icône

Substitution

fileNew

|fileNew|

fileOpen

|fileOpen|

fileSave

|fileSave|

fileSaveAs

|fileSaveAs|

fileExit

|fileExit|

5.3.3. Éditer

Icône

Substitution

Icône

Substitution

undo

|undo|

redo

|redo|

editCopy

|editCopy|

editPaste

|editPaste|

editCut

|editCut|

saveEdits

|saveEdits|

editableEdits

|editableEdits|

circle2Points

|circle2Points|

circle2TangentsPoint

|circle2TangentsPoint|

circle3Points

|circle3Points|

circle3Tangents

|circle3Tangents|

circleCenterPoint

|circleCenterPoint|

ellipseCenter2Points

|ellipseCenter2Points|

ellipseCenterPoint

|ellipseCenterPoint|

ellipseExtent

|ellipseExtent|

ellipseFoci

|ellipseFoci|

rectangle3PointsDistance

|rectangle3PointsDistance|

rectangle3PointsProjected

|rectangle3PointsProjected|

rectangleCenter

|rectangleCenter|

rectangleExtent

|rectangleExtent|

regularPolygon2Points

|regularPolygon2Points|

regularPolygonCenterCorner

|regularPolygonCenterCorner|

regularPolygonCenterPoint

|regularPolygonCenterPoint|

5.3.4. Identity result

Icône

Substitution

Icône

Substitution

expandTree

|expandTree|

collapseTree

|collapseTree|

expandNewTree

|expandNewTree|

formView

|formView|

deselectAll

|deselectAll|

editCopy

|editCopy|

filePrint

|filePrint|

identifyByRectangle

|identifyByRectangle|

identifyByPolygon

|identifyByPolygon|

identifyByFreehand

|identifyByFreehand|

identifyByRadius

|identifyByRadius|

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

Icône

Substitution

Icône

Substitution

cad

|cad|

cadConstruction

|cadConstruction|

cadParallel

|cadParallel|

cadPerpendicular

|cadPerpendicular|

floater

|floater|

toggleEditing

|toggleEditing|

allEdits

|allEdits|

tracing

|tracing|

snapping

|snapping|

capturePoint

|capturePoint|

capturePolygon

|capturePolygon|

captureLine

|captureLine|

deleteSelectedFeatures

|deleteSelectedFeatures|

circularStringCurvePoint

|circularStringCurvePoint|

circularStringRadius

|circularStringRadius|

vertexTool

|vertexTool|

vertexToolActiveLayer

|vertexToolActiveLayer|

streamingDigitize

|streamingDigitize|

digitizeWithCurve

|digitizeWithCurve|

moveFeature

|moveFeature|

moveFeatureCopy

|moveFeatureCopy|

moveFeatureLine

|moveFeatureLine|

moveFeatureCopyLine

|moveFeatureCopyLine|

moveFeaturePoint

|moveFeaturePoint|

moveFeatureCopyPoint

|moveFeatureCopyPoint|

rotateFeature

|rotateFeature|

rotatePointSymbols

|rotatePointSymbols|

scaleFeature

|scaleFeature|

offsetCurve

|offsetCurve|

offsetPointSymbols

|offsetPointSymbols|

simplify

|simplify|

reshape

|reshape|

addRing

|addRing|

addPart

|addPart|

fillRing

|fillRing|

deleteRing

|deleteRing|

deletePart

|deletePart|

mergeFeatures

|mergeFeatures|

mergeFeatureAttributes

|mergeFeatureAttributes|

splitFeatures

|splitFeatures|

splitParts

|splitParts|

reverseLine

|reverseLine|

allowIntersections

|allowIntersections|

avoidIntersectionsCurrentLayer

|avoidIntersectionsCurrentLayer|

avoidIntersectionsLayers

|avoidIntersectionsLayers|

snappingSelf

|snappingSelf|

5.3.6. Mesh

Icône

Substitution

Icône

Substitution

meshDigitizing

|meshDigitizing|

meshreindex

|meshreindex|

meshSelectExpression

|meshSelectExpression|

meshSelectPolygon

|meshSelectPolygon|

meshTransformByExpression

|meshTransformByExpression|

meshEditForceByVectorLines

|meshEditForceByVectorLines|

5.3.7. Navigateur de cartes et Attributs

Icône

Substitution

Icône

Substitution

pan

|pan|

panToSelected

|panToSelected|

zoomIn

|zoomIn|

zoomOut

|zoomOut|

zoomActual

|zoomActual|

zoomFullExtent

|zoomFullExtent|

zoomToLayer

|zoomToLayer|

zoomToSelected

|zoomToSelected|

zoomLast

|zoomLast|

zoomNext

|zoomNext|

refresh

|refresh|

identify

|identify|

mapTips

|mapTips|

showBookmarks

|showBookmarks|

newBookmark

|newBookmark|

measure

|measure|

measureArea

|measureArea|

measureBearing

|measureBearing|

measureAngle

|measureAngle|

newMap

|newMap|

new3DMap

|new3DMap|

tiltUp

|tiltUp|

tiltDown

|tiltDown|

3dNavigation

|3dNavigation|

play

|play|

temporal

|temporal

temporalNavigationOff

|temporalNavigationOff|

temporalNavigationFixedRange

|temporalNavigationFixedRange|

temporalNavigationAnimated

|temporalNavigationAnimated|

5.3.8. Selection and Expressions

Icône

Substitution

Icône

Substitution

selectRectangle

|selectRectangle|

selectPolygon

|selectPolygon|

selectFreehand

|selectFreehand|

selectRadius

|selectRadius|

selectAll

|selectAll|

deselectAll

|deselectAll|

invertSelection

|invertSelection|

expressionSelect

|expressionSelect|

deselectActiveLayer

|deselectActiveLayer|

selectLocation

|selectLocation|

selectAllTree

|selectAllTree|

select

|select|

formSelect

|formSelect|

dataDefine

|dataDefine|

expression

|expression|

dataDefineOn

|dataDefineOn|

dataDefineExpressionOn

|dataDefineExpressionOn|

dataDefineError

|dataDefineError|

dataDefineExpressionError

|dataDefineExpressionError|

addExpression

|addExpression|

expressionFilter

|expressionFilter|

filterMap

|filterMap|

5.3.9. Étiquettes et Diagrammes

Icône

Substitution

Icône

Substitution

labelingSingle

|labelingSingle|

labelingNone

|labelingNone|

labelingRuleBased

|labelingRuleBased|

labelingObstacle

|labelingObstacle|

piechart

|piechart|

diagramNone

|diagramNone|

text

|text|

histogram

|histogram|

stackedBar

|stackedBar|

annotation

|annotation|

textAnnotation

|textAnnotation|

formAnnotation

|formAnnotation|

htmlAnnotation

|htmlAnnotation|

svgAnnotation

|svgAnnotation|

autoPlacementSettings

|autoPlacementSettings|

labelbackground

|labelbackground|

labelbuffer

|labelbuffer|

labelformatting

|labelformatting|

labelplacement

|labelplacement|

labelshadow

|labelshadow|

render

|render|

labelcallout

|labelcallout|

labelAnchorCenter

|labelAnchorCenter|

labelAnchorCustom

|labelAnchorCustom|

labelAnchorEnd

|labelAnchorEnd|

labelAnchorStart

|labelAnchorStart|

pinLabels

|pinLabels|

showHideLabels

|showHideLabels|

moveLabel

|moveLabel|

rotateLabel

|rotateLabel|

showPinnedLabels

|showPinnedLabels|

showUnplacedLabel

|showUnplacedLabel|

changeLabelProperties

|changeLabelProperties|

5.3.10. Décorations

Icône

Substitution

Icône

Substitution

copyrightLabel

|copyrightLabel|

addGrid

|addGrid|

titleLabel

|titleLabel|

northArrow

|northArrow|

scaleBar

|scaleBar|

addMap

|addMap|

addImage

|addImage|

5.3.11. Help

Icône

Substitution

Icône

Substitution

helpContents

|helpContents|

qgisHomePage

|qgisHomePage|

success

|success|

helpSponsors

|helpSponsors|

contextHelp

|contextHelp|

5.3.12. Couleurs

Icône

Substitution

Icône

Substitution

colorBox

|colorBox|

colorPicker

|colorPicker|

colorSwatches

|colorSwatches|

colorWheel

|colorWheel|

5.4. Autres icônes de base

Icône

Substitution

Icône

Substitution

arrowDown

|arrowDown|

arrowUp

|arrowUp|

symbologyAdd

|symbologyAdd|

symbologyRemove

|symbologyRemove|

projectProperties

|projectProperties|

options

|options|

interfaceCustomization

|interfaceCustomization|

keyboardShortcuts

|keyboardShortcuts|

copyrightLabel

|copyrightLabel|

northArrow

|northArrow|

scaleBar

|scaleBar|

tracking

|tracking|

gpsImporter

|gpsImporter|

gpsTrackBarChart

|gpsTrackBarChart|

folder

|folder|

extents

|extents|

settings

|settings|

start

|start|

properties

|properties|

deleteSelected

|deleteSelected|

browserExpand

|browserExpand|

browserCollapse

|browserCollapse|

codeEditor

|codeEditor|

add

|add|

relations

|relations|

5.5. Table attributaire

Icône

Substitution

Icône

Substitution

openTable

|openTable|

openTableSelected

|openTableSelected|

openTableVisible

|openTableVisible|

openTableEdited

|openTableEdited|

selectedToTop

|selectedToTop|

selectAll

|selectAll|

invertSelection

|invertSelection|

panToSelected

|panToSelected|

zoomToSelected

|zoomToSelected|

copySelected

|copySelected|

editPaste

|editPaste|

expressionSelect

|expressionSelect|

deleteSelectedFeatures

|deleteSelectedFeatures|

newAttribute

|newAttribute|

deleteAttribute

|deleteAttribute|

editTable

|editTable|

newTableRow

|newTableRow|

calculateField

|calculateField|

refresh

|refresh|

formView

|formView|

conditionalFormatting

|conditionalFormatting|

multiEdit

|multiEdit|

dock

|dock|

actionRun

|actionRun|

duplicateFeature

|duplicateFeature|

zoomTo

|zoomTo|

panTo

|panTo|

highlightFeature

|highlightFeature|

handleStoreFilterExpressionChecked

|handleStoreFilterExpressionChecked|

handleStoreFilterExpressionUnchecked

|handleStoreFilterExpressionUnchecked|

5.6. Projections et Géoréférenceur

Icône

Substitution

Icône

Substitution

geographic

|geographic|

crs

|crs|

customProjection

|customProjection|

setProjection

|setProjection|

projectionDisabled

|projectionDisabled|

projectionEnabled

|projectionEnabled|

transformation

|transformation|

gdalScript

|gdalScript|

georefRun

|georefRun|

pencil

|pencil|

linkQGisToGeoref

|linkQGisToGeoref|

linkGeorefToQGis

|linkGeorefToQGis|

fullHistogramStretch

|fullHistogramStretch|

5.8. Propriétés des couches

Icône

Substitution

Icône

Substitution

symbology

|symbology|

labelingSingle

|labelingSingle|

sourceFields

|sourceFields|

general

|general|

metadata

|metadata|

action

|action|

display

|display|

rendering

|rendering|

join

|join|

diagram

|diagram|

labelmask

|labelmask|

temporal

|temporal|

legend

|legend|

dependencies

|dependencies|

3d

|3d|

system

|system|

editMetadata

|editMetadata|

overlay

|overlay|

digitizing

|digitizing|

auxiliaryStorage

|auxiliaryStorage|

history

|history|

stylePreset

|stylePreset|

search

|search|

pyramids

|pyramids|

transparency

|transparency|

rasterHistogram

|rasterHistogram|

singleSymbol

|singleSymbol|

nullSymbol

|nullSymbol|

graduatedSymbol

|graduatedSymbol|

categorizedSymbol

|categorizedSymbol|

25dSymbol

|25dSymbol|

ruleBasedSymbol

|ruleBasedSymbol|

invertedSymbol

|invertedSymbol|

heatmapSymbol

|heatmapSymbol|

pointDisplacementSymbol

|pointDisplacementSymbol|

pointClusterSymbol

|pointClusterSymbol|

mergedFeatures

|mergedFeatures|

meshcontours

|meshcontours|

meshcontoursoff

|meshcontoursoff|

meshvectors

|meshvectors|

meshvectorsoff

|meshvectorsoff|

meshframe

|meshframe|

meshaveraging

|meshaveraging|

sum

|sum|

sort

|sort|

paintEffects

|paintEffects|

mapIdentification

|mapIdentification|

styleManager

|styleManager|

iconView

|iconView|

joinNotEditable

|joinNotEditable|

joinedLayerNotEditable

|joinedLayerNotEditable|

joinHasNotUpsertOnEdit

|joinHasNotUpsertOnEdit|

filterTableFields

|filterTableFields|

symbologyEdit

|symbologyEdit|

sharingImport

|sharingImport|

sharingExport

|sharingExport|

5.9. Extensions

5.9.1. Traitements

Icône

Substitution

Icône

Substitution

processingAlgorithm

|processingAlgorithm|

processingModel

|processingModel|

processingHistory

|processingHistory|

processingResult

|processingResult|

processSelected

|processSelected|

editHelpContent

|editHelpContent|

saveAsPython

|saveAsPython|

modelOutput

|modelOutput|

qgsProjectFile

|qgsProjectFile|

addToProject

|addToProject|

fieldInteger

|fieldInteger|

meanCoordinates

|meanCoordinates|

extractLayerExtent

|extractLayerExtent|

selectRandom

|selectRandom|

vectorGrid

|vectorGrid|

convexHull

|convexHull|

buffer

|buffer|

intersect

|intersect|

union

|union|

symmetricalDifference

|symmetricalDifference|

clip

|clip|

difference

|difference|

dissolve

|dissolve|

checkGeometry

|checkGeometry|

exportGeometry

|exportGeometry|

delaunay

|delaunay|

centroids

|centroids|

polygonToLine

|polygonToLine|

extractVertices

|extractVertices|

splitLayer

|splitLayer|

heatmap

|heatmap|

showRasterCalculator

|showRasterCalculator|

showMeshCalculator

|showMeshCalculator|

regularPoints

|regularPoints|

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

|showPluginManager|

installPluginFromZip

|installPluginFromZip|

pythonFile

|pythonFile|

runConsole

|runConsole|

showEditorConsole

|showEditorConsole|

clearConsole

|clearConsole|

offlineEditingCopy

|offlineEditingCopy|

offlineEditingSync

|offlineEditingSync|

plugin

|plugin|

metasearch

|metasearch|

geometryChecker

|geometryChecker|

topologyChecker

|topologyChecker|

fromSelectedFeature

|fromSelectedFeature|

sqlQueryBuilder

|sqlQueryBuilder|

5.9.3. Intégration GRASS

Icône

Substitution

Icône

Substitution

grassLogo

|grassLogo|

grassRegion

|grassRegion|

grassTools

|grassTools|

grassNewMapset

|grassNewMapset|

grassOpenMapset

|grassOpenMapset|

grassCloseMapset

|grassCloseMapset|