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:

  1. 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 https://github.com/qgis/QGIS/blob/release-3_16/images/themes/default folder) and paste (in .png format) under /static/common folder. For convenience and update, it’s advised to keep filename when possible.

  2. create the reference to the substitution in the /source/substitutions.txt file following the example below. The replacement text should be in camelCase:

    .. |splitLayer| image:: /static/common/split_layer.png
       :width: 1.5em
    
  3. run the scripts/find_set_subst.py script to update the substitution definitions in the rst files and include the new substitution(s).

  4. (optional) add the reference to the icon and its substitution to the list below.

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

Икона

Substitution

Икона

Substitution

logo

|logo|

kde

|kde|

nix

|nix|

osx

|osx|

win

|win|

5.3. Toolbar Button Icons

5.3.1. Manage Layers and overview

Икона

Substitution

Икона

Substitution

dataSourceManager

|dataSourceManager|

addOgrLayer

|addOgrLayer|

addDb2Layer

|addDb2Layer|

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|

dbManager

|dbManager|

gdal

|gdal|

geoPackage

|geoPackage|

spatialite

|spatialite|

virtualLayer

|virtualLayer|

wms

|wms|

wcs

|wcs|

wfs

|wfs|

dbSchema

|dbSchema|

inOverview

|inOverview|

addAllToOverview

|addAllToOverview|

removeAllOVerview

|removeAllOVerview|

removeLayer

|removeLayer|

showAllLayers

|showAllLayers|

hideAllLayers

|hideAllLayers|

showMapTheme

|showMapTheme|

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|

5.3.2. File

Икона

Substitution

Икона

Substitution

fileNew

|fileNew|

fileOpen

|fileOpen|

fileSave

|fileSave|

fileSaveAs

|fileSaveAs|

fileExit

|fileExit|

5.3.3. Редакция

Икона

Substitution

Икона

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

Икона

Substitution

Икона

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. Digitizing and Advanced Digitizing

Икона

Substitution

Икона

Substitution

cad

|cad|

cadConstruction

|cadConstruction|

cadParallel

|cadParallel|

cadPerpendicular

|cadPerpendicular|

toggleEditing

|toggleEditing|

allEdits

|allEdits|

tracing

|tracing|

snapping

|snapping|

capturePoint

|capturePoint|

capturePolygon

|capturePolygon|

captureLine

|captureLine|

deleteSelectedFeatures

|deleteSelectedFeatures|

circularStringCurvePoint

|circularStringCurvePoint|

circularStringRadius

|circularStringRadius|

vertexTool

|vertexTool|

vertexToolActiveLayer

|vertexToolActiveLayer|

moveFeature

|moveFeature|

moveFeatureCopy

|moveFeatureCopy|

moveFeatureLine

|moveFeatureLine|

moveFeatureCopyLine

|moveFeatureCopyLine|

moveFeaturePoint

|moveFeaturePoint|

moveFeatureCopyPoint

|moveFeatureCopyPoint|

rotateFeature

|rotateFeature|

rotatePointSymbols

|rotatePointSymbols|

offsetCurve

|offsetCurve|

offsetPointSymbols

|offsetPointSymbols|

simplifyFeatures

|simplifyFeatures|

reshape

|reshape|

addRing

|addRing|

addPart

|addPart|

fillRing

|fillRing|

deleteRing

|deleteRing|

deletePart

|deletePart|

mergeFeatures

|mergeFeatures|

mergeFeatAttributes

|mergeFeatAttributes|

splitFeatures

|splitFeatures|

splitParts

|splitParts|

reverseLine

|reverseLine|

5.3.6. Map Navigation and attributes

Икона

Substitution

Икона

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|

measureAngle

|measureAngle|

newMap

|newMap|

new3DMap

|new3DMap|

tiltUp

|tiltUp|

tiltDown

|tiltDown|

3dNavigation

|3dNavigation|

play

|play|

5.3.7. Selection and Expressions

Икона

Substitution

Икона

Substitution

selectRectangle

|selectRectangle|

selectPolygon

|selectPolygon|

selectFreehand

|selectFreehand|

selectRadius

|selectRadius|

selectAll

|selectAll|

deselectAll

|deselectAll|

invertSelection

|invertSelection|

expressionSelect

|expressionSelect|

deselectActiveLayer

|deselectActiveLayer|

algorithmSelectLocation

|algorithmSelectLocation|

selectAllTree

|selectAllTree|

select

|select|

formSelect

|formSelect|

dataDefined

|dataDefined|

expression

|expression|

dataDefineOn

|dataDefineOn|

dataDefineExpressionOn

|dataDefineExpressionOn|

dataDefineError

|dataDefineError|

dataDefineExpressionError

|dataDefineExpressionError|

addExpression

|addExpression|

expressionFilter

|expressionFilter|

filterMap

|filterMap|

5.3.8. Labels and Diagrams

Икона

Substitution

Икона

Substitution

labeling

|labeling|

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|

autoPlacement

|autoPlacement|

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.9. Decorations

Икона

Substitution

Икона

Substitution

copyrightLabel

|copyrightLabel|

addGrid

|addGrid|

titleLabel

|titleLabel|

northArrow

|northArrow|

scaleBar

|scaleBar|

addMap

|addMap|

addImage

|addImage|

5.3.10. Помощ

Икона

Substitution

Икона

Substitution

helpContents

|helpContents|

qgisHomePage

|qgisHomePage|

success

|success|

helpSponsors

|helpSponsors|

contextHelp

|contextHelp|

5.3.11. Цветове

Икона

Substitution

Икона

Substitution

colorBox

|colorBox|

colorPicker

|colorPicker|

colorSwatches

|colorSwatches|

colorWheel

|colorWheel|

5.4. Other basic icons

Икона

Substitution

Икона

Substitution

arrowDown

|arrowDown|

arrowUp

|arrowUp|

signPlus

|signPlus|

signMinus

|signMinus|

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|

3dconfigure

|3dconfigure|

deleteSelected

|deleteSelected|

browserExpand

|browserExpand|

browserCollapse

|browserCollapse|

codeEditor

|codeEditor|

5.5. Атрибутивна таблица

Икона

Substitution

Икона

Substitution

openTable

|openTable|

selectedToTop

|selectedToTop|

selectAll

|selectAll|

invertSelection

|invertSelection|

panToSelected

|panToSelected|

zoomToSelected

|zoomToSelected|

copySelected

|copySelected|

editPaste

|editPaste|

expressionSelect

|expressionSelect|

deleteSelectedFeatures

|deleteSelectedFeatures|

newAttribute

|newAttribute|

deleteAttribute

|deleteAttribute|

newTableRow

|newTableRow|

calculateField

|calculateField|

refresh

|refresh|

formView

|formView|

conditionalFormatting

|conditionalFormatting|

multiEdit

|multiEdit|

dock

|dock|

actionRun

|actionRun|

duplicateFeature

|duplicateFeature|

panTo

|panTo|

highlightFeature

|highlightFeature|

5.6. Projections and Georeferencer

Икона

Substitution

Икона

Substitution

geographic

|geographic|

crs

|crs|

customProjection

|customProjection|

setProjection

|setProjection|

projectionDisabled

|projectionDisabled|

projectionEnabled

|projectionEnabled|

transformation

|transformation|

georefRun

|georefRun|

pencil

|pencil|

linkQGisToGeoref

|linkQGisToGeoref|

linkGeorefToQGis

|linkGeorefToQGis|

fullHistogramStretch

|fullHistogramStretch|

5.8. Layer Properties

Икона

Substitution

Икона

Substitution

symbology

|symbology|

labeling

|labeling|

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|

meshcontours

|meshcontours|

meshcontoursoff

|meshcontoursoff|

meshvectors

|meshvectors|

meshvectorsoff

|meshvectorsoff|

meshframe

|meshframe|

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. Добавки

5.9.1. Processing

Икона

Substitution

Икона

Substitution

processing

|processing|

processingModel

|processingModel|

processingHistory

|processingHistory|

processingResult

|processingResult|

processSelected

|processSelected|

processingHelp

|processingHelp|

saveAsPython

|saveAsPython|

processingOutput

|processingOutput|

qgsProjectFile

|qgsProjectFile|

addToProject

|addToProject|

integer

|integer|

mean

|mean|

layerExtent

|layerExtent|

randomSelection

|randomSelection|

vectorGrid

|vectorGrid|

convexHull

|convexHull|

buffer

|buffer|

intersect

|intersect|

union

|union|

symDifference

|symDifference|

clip

|clip|

difference

|difference|

dissolve

|dissolve|

checkGeometry

|checkGeometry|

exportGeometry

|exportGeometry|

delaunay

|delaunay|

centroids

|centroids|

toLines

|toLines|

extractNodes

|extractNodes|

splitLayer

|splitLayer|

heatmap

|heatmap|

showRasterCalculator

|showRasterCalculator|

showMeshCalculator

|showMeshCalculator|

5.9.2. Various Core Plugins

Standard provided with basic install, but not loaded with initial install

Икона

Substitution

Икона

Substitution

showPluginManager

|showPluginManager|

installPluginFromZip

|installPluginFromZip|

pythonFile

|pythonFile|

runConsole

|runConsole|

showEditorConsole

|showEditorConsole|

clearConsole

|clearConsole|

offlineEditingCopy

|offlineEditingCopy|

offlineEditingSync

|offlineEditingSync|

plugin

|plugin|

interpolation

|interpolation|

gdalScript

|gdalScript|

metasearch

|metasearch|

geometryChecker

|geometryChecker|

topologyChecker

|topologyChecker|

fromSelectedFeature

|fromSelectedFeature|

sqlQueryBuilder

|sqlQueryBuilder|

5.9.3. Grass integration

Икона

Substitution

Икона

Substitution

grass

|grass|

grassRegion

|grassRegion|

grassTools

|grassTools|

grassNewMapset

|grassNewMapset|

grassOpenMapset

|grassOpenMapset|

grassCloseMapset

|grassCloseMapset|