5. Sostituzioni¶

5.1. Uso ¶

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:

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_10/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.
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
```
run the scripts/find_set_subst.py script to update the substitution definitions in the rst files and include the new substitution(s).
(optional) add the reference to the icon and its substitution to the list below.

5.2. Sostituzioni comuni ¶

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. Icone di piattaforma ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|logo\|`
	`\|kde\|`		`\|nix\|`
	`\|osx\|`		`\|win\|`

5.2.2. Oggetti del menu ¶

Sostituzione	Icona	Sostituzione
`\|checkbox\|`		`\|unchecked\|`
`\|radioButtonOn\|`		`\|radioButtonOff\|`
`\|selectNumber\|`		`\|selectString\|`
`\|selectColor\|`		`\|selectColorRamp\|`
`\|tab\|`	°	`\|degrees\|`
`\|inputText\|`		`\|slider\|`

5.3. Icone nel menu della barra degli strumenti ¶

5.3.1. Gestione layer e panoramica ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|dataSourceManager\|`
	`\|addOgrLayer\|`		`\|addDb2Layer\|`
	`\|addRasterLayer\|`		`\|addMssqlLayer\|`
	`\|addDelimitedTextLayer\|`		`\|addSpatiaLiteLayer\|`
	`\|addPostgisLayer\|`		`\|addOracleLayer\|`
	`\|addAfsLayer\|`		`\|addAmsLayer\|`
	`\|addMeshLayer\|`
	`\|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\|`
	`\|addLayer\|`
	`\|indicatorEmbedded\|`		`\|indicatorFilter\|`
	`\|indicatorMemory\|`		`\|indicatorNoCRS\|`
	`\|indicatorBadLayer\|`		`\|favourites\|`

5.3.2. File ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|fileNew\|`		`\|fileOpen\|`
	`\|fileSave\|`		`\|fileSaveAs\|`
	`\|fileExit\|`

5.3.3. Modifica ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|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 ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|expandTree\|`		`\|collapseTree\|`
	`\|expandNewTree\|`		`\|formView\|`
	`\|deselectAll\|`		`\|editCopy\|`
	`\|filePrint\|`
	`\|identifyByRectangle\|`		`\|identifyByPolygon\|`
	`\|identifyByFreehand\|`		`\|identifyByRadius\|`

5.3.5. Digitalizzazione e digitalizzazione avanzata ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|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. Orientazione della mappa e attributi ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|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 ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|selectRectangle\|`		`\|selectPolygon\|`
	`\|selectFreehand\|`		`\|selectRadius\|`
	`\|selectAll\|`		`\|deselectAll\|`
	`\|invertSelection\|`		`\|expressionSelect\|`
	`\|selectAllTree\|`		`\|select\|`
	`\|formSelect\|`		`\|dataDefined\|`
	`\|expression\|`		`\|dataDefineOn\|`
	`\|dataDefineExpressionOn\|`		`\|dataDefineError\|`
	`\|dataDefineExpressionError\|`
	`\|addExpression\|`
	`\|expressionFilter\|`		`\|filterMap\|`

5.3.8. Labels and Diagrams ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|labeling\|`		`\|labelingNone\|`
	`\|labelingRuleBased\|`		`\|labelingObstacle\|`
	`\|piechart\|`		`\|diagramNone\|`
	`\|text\|`		`\|histogram\|`
	`\|annotation\|`		`\|textAnnotation\|`
	`\|formAnnotation\|`		`\|htmlAnnotation\|`
	`\|svgAnnotation\|`		`\|autoPlacement\|`
	`\|labelbackground\|`		`\|labelbuffer\|`
	`\|labelformatting\|`		`\|labelplacement\|`
	`\|labelshadow\|`		`\|render\|`
	`\|labelcallout\|`
	`\|pinLabels\|`		`\|showHideLabels\|`
	`\|moveLabel\|`		`\|rotateLabel\|`
	`\|showPinnedLabels\|`		`\|showUnplacedLabel\|`
	`\|changeLabelProperties\|`

5.3.9. Decorazioni ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|copyrightLabel\|`		`\|addGrid\|`
	`\|titleLabel\|`		`\|northArrow\|`
	`\|scaleBar\|`		`\|addMap\|`
	`\|addImage\|`

5.3.10. Guida ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|helpContents\|`		`\|qgisHomePage\|`
	`\|success\|`
	`\|helpSponsors\|`		`\|contextHelp\|`

5.3.11. Colori ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|colorBox\|`		`\|colorPicker\|`
	`\|colorSwatches\|`		`\|colorWheel\|`

5.4. Altre icone di base ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|arrowDown\|`		`\|arrowUp\|`
	`\|signPlus\|`		`\|signMinus\|`
	`\|projectProperties\|`		`\|options\|`
	`\|interfaceCustomization\|`		`\|keyboardShortcuts\|`
	`\|copyrightLabel\|`		`\|northArrow\|`
	`\|scaleBar\|`		`\|tracking\|`
	`\|gpsImporter\|`		`\|gpsTrackBarChart\|`
	`\|folder\|`		`\|extents\|`
	`\|settings\|`		`\|start\|`
	`\|3dconfigure\|`		`\|deleteSelected\|`
	`\|browserExpand\|`		`\|browserCollapse\|`

5.5. Tabella degli attributi ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|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. Proiezioni e Georeferenziatore ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|geographic\|`		`\|crs\|`
	`\|customProjection\|`		`\|setProjection\|`
	`\|projectionDisabled\|`		`\|projectionEnabled\|`
	`\|georefRun\|`		`\|pencil\|`
	`\|linkQGisToGeoref\|`		`\|linkGeorefToQGis\|`
	`\|coordinateCapture\|`		`\|fullHistogramStretch\|`

5.7. Layout di stampa ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|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\|`
	`\|addImage\|`		`\|addTable\|`
	`\|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. Layer Properties ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|symbology\|`		`\|labeling\|`
	`\|sourceFields\|`		`\|general\|`
	`\|metadata\|`		`\|action\|`
	`\|display\|`		`\|rendering\|`
	`\|join\|`		`\|diagram\|`
	`\|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\|`

5.9. Plugin ¶

5.9.1. Processing ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|processing\|`		`\|processingModel\|`
	`\|processingHistory\|`		`\|processingResult\|`
	`\|processSelected\|`
	`\|qgsProjectFile\|`		`\|addToProject\|`
	`\|mean\|`		`\|layerExtent\|`
	`\|randomSelection\|`		`\|vectorGrid\|`
	`\|convexHull\|`		`\|buffer\|`
	`\|intersect\|`		`\|union\|`
	`\|symDifference\|`		`\|clip\|`
	`\|difference\|`		`\|dissolve\|`
	`\|checkGeometry\|`		`\|exportGeometry\|`
	`\|delaunay\|`		`\|centroids\|`
	`\|toLines\|`		`\|extractNodes\|`
	`\|splitLayer\|`
	`\|showRasterCalculator\|`		`\|heatmap\|`
	`\|showMeshCalculator\|`

5.9.2. Various Core Plugins ¶

Standard forniti con l’installazione di base, ma non caricate con l’installazione iniziale

Icona	Sostituzione	Icona	Sostituzione
	`\|showPluginManager\|`		`\|installPluginFromZip\|`
	`\|pythonFile\|`		`\|runConsole\|`
	`\|showEditorConsole\|`		`\|clearConsole\|`
	`\|offlineEditingCopy\|`		`\|offlineEditingSync\|`
	`\|plugin\|`		`\|interpolation\|`
	`\|gdalScript\|`		`\|metasearch\|`
	`\|geometryChecker\|`		`\|topologyChecker\|`
	`\|fromSelectedFeature\|`		`\|sqlQueryBuilder\|`

5.9.3. Integrazione con GRASS GIS ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|grass\|`		`\|grassRegion\|`
	`\|grassTools\|`		`\|grassNewMapset\|`
	`\|grassOpenMapset\|`		`\|grassCloseMapset\|`

5.9.4. Plugin eVis ¶

Icona	Sostituzione	Icona	Sostituzione
	`\|eventBrowser\|`		`\|eventId\|`
	`\|evisConnect\|`

Icona	Sostituzione	Icona	Sostituzione
	`\|logo\|`
	`\|kde\|`		`\|nix\|`
	`\|osx\|`		`\|win\|`

Sostituzione	Icona	Sostituzione
`\|checkbox\|`		`\|unchecked\|`
`\|radioButtonOn\|`		`\|radioButtonOff\|`
`\|selectNumber\|`		`\|selectString\|`
`\|selectColor\|`		`\|selectColorRamp\|`
`\|tab\|`	°	`\|degrees\|`
`\|inputText\|`		`\|slider\|`

Icona	Sostituzione	Icona	Sostituzione
	`\|dataSourceManager\|`
	`\|addOgrLayer\|`		`\|addDb2Layer\|`
	`\|addRasterLayer\|`		`\|addMssqlLayer\|`
	`\|addDelimitedTextLayer\|`		`\|addSpatiaLiteLayer\|`
	`\|addPostgisLayer\|`		`\|addOracleLayer\|`
	`\|addAfsLayer\|`		`\|addAmsLayer\|`
	`\|addMeshLayer\|`
	`\|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\|`
	`\|addLayer\|`
	`\|indicatorEmbedded\|`		`\|indicatorFilter\|`
	`\|indicatorMemory\|`		`\|indicatorNoCRS\|`
	`\|indicatorBadLayer\|`		`\|favourites\|`

Icona	Sostituzione	Icona	Sostituzione
	`\|fileNew\|`		`\|fileOpen\|`
	`\|fileSave\|`		`\|fileSaveAs\|`
	`\|fileExit\|`

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