5. Sostituzioni

5.1. Uso 

Per facilitare l’uso delle icone nei manuali QGIS, le sostituzioni sono definite per ogni icona nel file /source/substitutions.txt al repository QGIS-Documentation e alcune di queste sostituzioni sono elencate qui sotto. Così, quando vuoi usare un’icona dell’applicazione QGIS nella documentazione c’è una buona probabilità che ci sia già una sostituzione che può/deve essere usata.

Se non esiste alcuna sostituzione:

controlla nel repository della documentazione se l’icona è disponibile nella cartella /static/common. Se non c’è un’immagine, allora devi trovare e copiare il file immagine dell’icona dal repository QGIS (spesso sotto la cartella https://github.com/qgis/QGIS/blob/release-3_22/images/themes/default) e incollarlo (in formato .png) nella cartella /static/common. Per semplicità e aggiornamento, si consiglia di mantenere il nome del file quando possibile.
crea il riferimento alla sostituzione nel file /source/substitutions.txt seguendo l’esempio seguente. Il testo di sostituzione dovrebbe essere in lettere maiuscole:
```
.. |splitLayer| image:: /static/common/split_layer.png
   :width: 1.5em
```
esegui lo script scripts/find_set_subst.py per aggiornare le definizioni di sostituzione nei file rst e includere la nuova sostituzione(i).
(opzionale) aggiungi il riferimento all’icona e la sua sostituzione nell’elenco sottostante.

5.2. Sostituzioni comuni 

Di seguito sono date alcune icone e la loro sostituzione da usare quando si scrive la documentazione. Possono essere usate/trovate in molti posti nei manuali.

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\|`
	`\|addRasterLayer\|`		`\|addMssqlLayer\|`
	`\|addDelimitedTextLayer\|`		`\|addSpatiaLiteLayer\|`
	`\|addPostgisLayer\|`		`\|addOracleLayer\|`
	`\|addAfsLayer\|`		`\|addAmsLayer\|`
	`\|addMeshLayer\|`
	`\|addVectorTileLayer\|`		`\|addXyzLayer\|`
	`\|addVirtualLayer\|`		`\|addWmsLayer\|`
	`\|addWcsLayer\|`		`\|addWfsLayer\|`
	`\|newVectorLayer\|`		`\|newSpatiaLiteLayer\|`
	`\|newGeoPackageLayer\|`		`\|createMemory\|`
	`\|newVirtualLayer\|`		`\|newMeshLayer\|`
	`\|dbManager\|`		`\|gdal\|`
	`\|geoPackage\|`		`\|spatialite\|`
	`\|virtualLayer\|`		`\|wms\|`
	`\|wcs\|`		`\|wfs\|`
	`\|dbSchema\|`
	`\|inOverview\|`		`\|addAllToOverview\|`
	`\|removeAllFromOverview\|`		`\|removeLayer\|`
	`\|showAllLayers\|`		`\|hideAllLayers\|`
	`\|showPresets\|`		`\|showSelectedLayers\|`
	`\|hideSelectedLayers\|`		`\|hideDeselectedLayers\|`
	`\|toggleAllLayers\|`		`\|toggleSelectedLayers\|`
	`\|addLayer\|`
	`\|indicatorTemporal\|`		`\|indicatorNonRemovable\|`
	`\|indicatorEmbedded\|`		`\|indicatorFilter\|`
	`\|indicatorMemory\|`		`\|indicatorNoCRS\|`
	`\|indicatorBadLayer\|`		`\|favourites\|`
	`\|indicatorLayerError\|`		`\|indicatorNotes\|`
	`\|indicatorLowAccuracy\|`		`\|indicatorOffline\|`

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\|`
	`\|floater\|`
	`\|toggleEditing\|`		`\|allEdits\|`
	`\|tracing\|`		`\|snapping\|`
	`\|capturePoint\|`		`\|capturePolygon\|`
	`\|captureLine\|`		`\|deleteSelectedFeatures\|`
	`\|circularStringCurvePoint\|`		`\|circularStringRadius\|`
	`\|vertexTool\|`		`\|vertexToolActiveLayer\|`
	`\|digitizeWithSegment\|`		`\|digitizeShape\|`
	`\|streamingDigitize\|`		`\|digitizeWithCurve\|`
	`\|moveFeature\|`		`\|moveFeatureCopy\|`
	`\|moveFeatureLine\|`		`\|moveFeatureCopyLine\|`
	`\|moveFeaturePoint\|`		`\|moveFeatureCopyPoint\|`
	`\|rotateFeature\|`		`\|rotatePointSymbols\|`
	`\|scaleFeature\|`
	`\|offsetCurve\|`		`\|offsetPointSymbols\|`
	`\|simplify\|`		`\|reshape\|`
	`\|addRing\|`		`\|addPart\|`
	`\|fillRing\|`
	`\|deleteRing\|`		`\|deletePart\|`
	`\|mergeFeatures\|`		`\|mergeFeatureAttributes\|`
	`\|splitFeatures\|`		`\|splitParts\|`
	`\|reverseLine\|`
	`\|allowIntersections\|`		`\|avoidIntersectionsCurrentLayer\|`
	`\|avoidIntersectionsLayers\|`		`\|snappingSelf\|`

5.3.6. Mesh 

Icona	Sostituzione	Icona	Sostituzione
	`\|meshDigitizing\|`		`\|meshReindex\|`
	`\|meshSelectExpression\|`		`\|meshSelectPolygon\|`
	`\|meshTransformByExpression\|`		`\|meshEditForceByVectorLines\|`
	`\|vertexCoordinates\|`

5.3.7. 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\|`
	`\|measureBearing\|`		`\|measureAngle\|`
	`\|newMap\|`		`\|new3DMap\|`
	`\|tiltUp\|`		`\|tiltDown\|`
	`\|3dNavigation\|`		`\|play\|`
	`\|temporal`		`\|temporalNavigationOff\|`
	`\|temporalNavigationFixedRange\|`		`\|temporalNavigationAnimated\|`

5.3.8. Selezione ed Espressioni 

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

5.3.9. Etichette e Diagrammi 

Icona	Sostituzione	Icona	Sostituzione
	`\|labelingSingle\|`		`\|labelingNone\|`
	`\|labelingRuleBased\|`		`\|labelingObstacle\|`
	`\|piechart\|`		`\|diagramNone\|`
	`\|text\|`		`\|histogram\|`
	`\|stackedBar\|`
	`\|annotation\|`		`\|textAnnotation\|`
	`\|formAnnotation\|`		`\|htmlAnnotation\|`
	`\|svgAnnotation\|`		`\|autoPlacementSettings\|`
	`\|labelbackground\|`		`\|labelbuffer\|`
	`\|labelformatting\|`		`\|labelplacement\|`
	`\|labelshadow\|`		`\|render\|`
	`\|labelcallout\|`
	`\|labelAnchorCenter\|`		`\|labelAnchorCustom\|`
	`\|labelAnchorEnd\|`		`\|labelAnchorStart\|`
	`\|pinLabels\|`		`\|showHideLabels\|`
	`\|moveLabel\|`		`\|rotateLabel\|`
	`\|showPinnedLabels\|`		`\|showUnplacedLabel\|`
	`\|changeLabelProperties\|`

5.3.10. Decorazioni 

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

5.3.11. Guida 

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

5.3.12. Colori 

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

5.4. Altre icone di base 

Icona	Sostituzione	Icona	Sostituzione
	`\|arrowDown\|`		`\|arrowUp\|`
	`\|symbologyAdd\|`		`\|symbologyRemove\|`
	`\|projectProperties\|`		`\|options\|`
	`\|interfaceCustomization\|`		`\|keyboardShortcuts\|`
	`\|copyrightLabel\|`		`\|northArrow\|`
	`\|scaleBar\|`		`\|tracking\|`
	`\|gpsImporter\|`		`\|gpsTrackBarChart\|`
	`\|folder\|`		`\|extents\|`
	`\|settings\|`		`\|start\|`
	`\|properties\|`		`\|deleteSelected\|`
	`\|browserExpand\|`		`\|browserCollapse\|`
	`\|codeEditor\|`		`\|add\|`
	`\|relations\|`

5.5. Tabella degli attributi 

Icona	Sostituzione	Icona	Sostituzione
	`\|openTable\|`		`\|openTableSelected\|`
	`\|openTableVisible\|`		`\|openTableEdited\|`
	`\|selectedToTop\|`
	`\|selectAll\|`		`\|invertSelection\|`
	`\|panToSelected\|`		`\|zoomToSelected\|`
	`\|copySelected\|`		`\|editPaste\|`
	`\|expressionSelect\|`		`\|deleteSelectedFeatures\|`
	`\|newAttribute\|`		`\|deleteAttribute\|`
	`\|editTable\|`
	`\|newTableRow\|`		`\|calculateField\|`
	`\|refresh\|`		`\|formView\|`
	`\|conditionalFormatting\|`		`\|multiEdit\|`
	`\|dock\|`		`\|actionRun\|`
	`\|duplicateFeature\|`		`\|zoomTo\|`
	`\|panTo\|`		`\|highlightFeature\|`
	`\|handleStoreFilterExpressionChecked\|`
	`\|handleStoreFilterExpressionUnchecked\|`

5.6. Proiezioni e Georeferenziatore 

Icona	Sostituzione	Icona	Sostituzione
	`\|geographic\|`		`\|crs\|`
	`\|customProjection\|`		`\|setProjection\|`
	`\|projectionDisabled\|`		`\|projectionEnabled\|`
	`\|transformation\|`		`\|gdalScript\|`
	`\|georefRun\|`		`\|pencil\|`
	`\|linkQGisToGeoref\|`		`\|linkGeorefToQGis\|`
	`\|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\|`
	`\|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\|`
	`\|lockRepeating\|`		`\|lockedGray\|`
	`\|groupItems\|`

5.8. Proprietà Layer 

Icona	Sostituzione	Icona	Sostituzione
	`\|symbology\|`		`\|labelingSingle\|`
	`\|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\|`
	`\|mergedFeatures\|`
	`\|meshcontours\|`		`\|meshcontoursoff\|`
	`\|meshvectors\|`		`\|meshvectorsoff\|`
	`\|meshframe\|`		`\|meshaveraging\|`
	`\|sum\|`		`\|sort\|`
	`\|paintEffects\|`		`\|mapIdentification\|`
	`\|styleManager\|`		`\|iconView\|`
	`\|joinNotEditable\|`		`\|joinedLayerNotEditable\|`
	`\|joinHasNotUpsertOnEdit\|`		`\|filterTableFields\|`
	`\|symbologyEdit\|`
	`\|sharingImport\|`		`\|sharingExport\|`

5.9. Plugin 

5.9.1. Processing 

Icona	Sostituzione	Icona	Sostituzione
	`\|processingAlgorithm\|`		`\|processingModel\|`
	`\|processingHistory\|`		`\|processingResult\|`
	`\|processSelected\|`		`\|editHelpContent\|`
	`\|saveAsPython\|`		`\|modelOutput\|`
	`\|qgsProjectFile\|`		`\|addToProject\|`
	`\|fieldInteger\|`
	`\|meanCoordinates\|`		`\|extractLayerExtent\|`
	`\|selectRandom\|`		`\|vectorGrid\|`
	`\|convexHull\|`		`\|buffer\|`
	`\|intersect\|`		`\|union\|`
	`\|symmetricalDifference\|`		`\|clip\|`
	`\|difference\|`		`\|dissolve\|`
	`\|checkGeometry\|`		`\|exportGeometry\|`
	`\|delaunay\|`		`\|centroids\|`
	`\|polygonToLine\|`		`\|extractVertices\|`
	`\|splitLayer\|`		`\|heatmap\|`
	`\|showRasterCalculator\|`		`\|showMeshCalculator\|`
	`\|regularPoints\|`

5.9.2. Varie Plugin di Base 

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\|`		`\|metasearch\|`
	`\|geometryChecker\|`		`\|topologyChecker\|`
	`\|fromSelectedFeature\|`		`\|sqlQueryBuilder\|`

5.9.3. Integrazione con GRASS 

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

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\|`
	`\|addRasterLayer\|`		`\|addMssqlLayer\|`
	`\|addDelimitedTextLayer\|`		`\|addSpatiaLiteLayer\|`
	`\|addPostgisLayer\|`		`\|addOracleLayer\|`
	`\|addAfsLayer\|`		`\|addAmsLayer\|`
	`\|addMeshLayer\|`
	`\|addVectorTileLayer\|`		`\|addXyzLayer\|`
	`\|addVirtualLayer\|`		`\|addWmsLayer\|`
	`\|addWcsLayer\|`		`\|addWfsLayer\|`
	`\|newVectorLayer\|`		`\|newSpatiaLiteLayer\|`
	`\|newGeoPackageLayer\|`		`\|createMemory\|`
	`\|newVirtualLayer\|`		`\|newMeshLayer\|`
	`\|dbManager\|`		`\|gdal\|`
	`\|geoPackage\|`		`\|spatialite\|`
	`\|virtualLayer\|`		`\|wms\|`
	`\|wcs\|`		`\|wfs\|`
	`\|dbSchema\|`
	`\|inOverview\|`		`\|addAllToOverview\|`
	`\|removeAllFromOverview\|`		`\|removeLayer\|`
	`\|showAllLayers\|`		`\|hideAllLayers\|`
	`\|showPresets\|`		`\|showSelectedLayers\|`
	`\|hideSelectedLayers\|`		`\|hideDeselectedLayers\|`
	`\|toggleAllLayers\|`		`\|toggleSelectedLayers\|`
	`\|addLayer\|`
	`\|indicatorTemporal\|`		`\|indicatorNonRemovable\|`
	`\|indicatorEmbedded\|`		`\|indicatorFilter\|`
	`\|indicatorMemory\|`		`\|indicatorNoCRS\|`
	`\|indicatorBadLayer\|`		`\|favourites\|`
	`\|indicatorLayerError\|`		`\|indicatorNotes\|`
	`\|indicatorLowAccuracy\|`		`\|indicatorOffline\|`

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