5. 置換参照と定義

5.1. 利用方法 

QGISマニュアルでアイコンを手軽に使えるように、アイコンの置換が QGIS-Documentationリポジトリの /source/substitutions.txt ファイルで定義されています。そこで定義されている置換のいくつかを以下に示します。このためドキュメント中でQGISアプリケーションのアイコンを使用したい場合は、使用できる、あるいは使用すべき置換がすでにある可能性が大きいです。

置換が存在しない場合は、以下のようにして追加することができます。

目的のアイコン画像があるかどうか、ドキュメンテーションリポジトリの /static/common フォルダ内を確認してください。画像がない場合は、 QGISリポジトリからアイコン画像ファイルを探して（ https://github.com/qgis/QGIS/blob/release-3_22/images/themes/default フォルダにあることが多いです）、 /static/common フォルダに .png フォーマットでコピーします。利便性と後の更新のことを考えると、ファイル名は可能な限り元のままにしておくことを勧めます。
以下の例に従って、置換への参照を /source/substitutions.txt ファイルに作成します。置換テキストはキャメルケースにする必要があります。
```
.. |splitLayer| image:: /static/common/split_layer.png
   :width: 1.5em
```
scripts/find_set_subst.py スクリプトを実行してrstファイル中の置換定義を更新し、新しい置換が含まれるようにしてください。
（オプション）以下のリストに、アイコンおよびその置換への参照を追加します。

5.2. 一般的な置換 

以下はドキュメントを書くときに使われるアイコンとその置換です。マニュアルの多くの場所で使用されているのを見ることができるでしょう。

5.2.1. プラットフォームアイコン 

アイコン	置き換え	アイコン	置き換え
	`\|logo\|`
	`\|kde\|`		`\|nix\|`
	`\|osx\|`		`\|win\|`

5.2.2. メニューアイテム 

置き換え	アイコン	置き換え
`\|checkbox\|`		`\|unchecked\|`
`\|radioButtonOn\|`		`\|radioButtonOff\|`
`\|selectNumber\|`		`\|selectString\|`
`\|selectColor\|`		`\|selectColorRamp\|`
`\|tab\|`	°	`\|degrees\|`
`\|inputText\|`		`\|slider\|`

5.3. ツールバーボタンアイコン 

5.3.1. レイヤー管理と全体図 

アイコン	置き換え	アイコン	置き換え
	`\|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. ファイル 

アイコン	置き換え	アイコン	置き換え
	`\|fileNew\|`		`\|fileOpen\|`
	`\|fileSave\|`		`\|fileSaveAs\|`
	`\|fileExit\|`

5.3.3. 編集 

アイコン	置き換え	アイコン	置き換え
	`\|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. 識別結果 

アイコン	置き換え	アイコン	置き換え
	`\|expandTree\|`		`\|collapseTree\|`
	`\|expandNewTree\|`		`\|formView\|`
	`\|deselectAll\|`		`\|editCopy\|`
	`\|filePrint\|`
	`\|identifyByRectangle\|`		`\|identifyByPolygon\|`
	`\|identifyByFreehand\|`		`\|identifyByRadius\|`

5.3.5. デジタイズと高度なデジタイジング 

アイコン	置き換え	アイコン	置き換え
	`\|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 

アイコン	置き換え	アイコン	置き換え
	`\|meshDigitizing\|`		`\|meshReindex\|`
	`\|meshSelectExpression\|`		`\|meshSelectPolygon\|`
	`\|meshTransformByExpression\|`		`\|meshEditForceByVectorLines\|`
	`\|vertexCoordinates\|`

5.3.7. 地図ナビゲーションと属性 

アイコン	置き換え	アイコン	置き換え
	`\|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. 選択と式 

アイコン	置き換え	アイコン	置き換え
	`\|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. ラベルとダイヤグラム 

アイコン	置き換え	アイコン	置き換え
	`\|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. 整飾 

アイコン	置き換え	アイコン	置き換え
	`\|copyrightLabel\|`		`\|addGrid\|`
	`\|titleLabel\|`		`\|northArrow\|`
	`\|scaleBar\|`		`\|addMap\|`
	`\|addImage\|`

5.3.11. ヘルプ 

アイコン	置き換え	アイコン	置き換え
	`\|helpContents\|`		`\|qgisHomePage\|`
	`\|success\|`
	`\|helpSponsors\|`		`\|contextHelp\|`

5.3.12. 色 

アイコン	置き換え	アイコン	置き換え
	`\|colorBox\|`		`\|colorPicker\|`
	`\|colorSwatches\|`		`\|colorWheel\|`

5.4. 他の基本的アイコン 

アイコン	置き換え	アイコン	置き換え
	`\|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. 属性テーブル 

アイコン	置き換え	アイコン	置き換え
	`\|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. 投影とジオリファレンサ 

アイコン	置き換え	アイコン	置き換え
	`\|geographic\|`		`\|crs\|`
	`\|customProjection\|`		`\|setProjection\|`
	`\|projectionDisabled\|`		`\|projectionEnabled\|`
	`\|transformation\|`		`\|gdalScript\|`
	`\|georefRun\|`		`\|pencil\|`
	`\|linkQGisToGeoref\|`		`\|linkGeorefToQGis\|`
	`\|fullHistogramStretch\|`

5.7. 印刷レイアウト 

アイコン	置き換え	アイコン	置き換え
	`\|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. レイヤプロパティ 

アイコン	置き換え	アイコン	置き換え
	`\|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. プラグイン 

5.9.1. プロセシング 

アイコン	置き換え	アイコン	置き換え
	`\|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. コア・プラグインのいろいろ 

基本インストールで標準で提供されます。しかし初期状態ではロードはされていません。

アイコン	置き換え	アイコン	置き換え
	`\|showPluginManager\|`		`\|installPluginFromZip\|`
	`\|pythonFile\|`		`\|runConsole\|`
	`\|showEditorConsole\|`		`\|clearConsole\|`
	`\|offlineEditingCopy\|`		`\|offlineEditingSync\|`
	`\|plugin\|`		`\|metasearch\|`
	`\|geometryChecker\|`		`\|topologyChecker\|`
	`\|fromSelectedFeature\|`		`\|sqlQueryBuilder\|`

5.9.3. Grass 統合 

アイコン	置き換え	アイコン	置き換え
	`\|grassLogo\|`		`\|grassRegion\|`
	`\|grassTools\|`		`\|grassNewMapset\|`
	`\|grassOpenMapset\|`		`\|grassCloseMapset\|`

アイコン	置き換え	アイコン	置き換え
	`\|logo\|`
	`\|kde\|`		`\|nix\|`
	`\|osx\|`		`\|win\|`

置き換え	アイコン	置き換え
`\|checkbox\|`		`\|unchecked\|`
`\|radioButtonOn\|`		`\|radioButtonOff\|`
`\|selectNumber\|`		`\|selectString\|`
`\|selectColor\|`		`\|selectColorRamp\|`
`\|tab\|`	°	`\|degrees\|`
`\|inputText\|`		`\|slider\|`

アイコン	置き換え	アイコン	置き換え
	`\|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\|`

アイコン	置き換え	アイコン	置き換え
	`\|fileNew\|`		`\|fileOpen\|`
	`\|fileSave\|`		`\|fileSaveAs\|`
	`\|fileExit\|`

アイコン	置き換え	アイコン	置き換え
	`\|undo\|`		`\|redo\|`
	`\|editCopy\|`		`\|editPaste\|`
	`\|editCut\|`		`\|saveEdits\|`
	`\|editableEdits\|`
	`\|circle2Points\|`		`\|circle2TangentsPoint\|`
	`\|circle3Points\|`		`\|circle3Tangents\|`
	`\|circleCenterPoint\|`		`\|ellipseCenter2Points\|`
	`\|ellipseCenterPoint\|`		`\|ellipseExtent\|`
	`\|ellipseFoci\|`		`\|rectangle3PointsDistance\|`
	`\|rectangle3PointsProjected\|`		`\|rectangleCenter\|`
	`\|rectangleExtent\|`		`\|regularPolygon2Points\|`
	`\|regularPolygonCenterCorner\|`		`\|regularPolygonCenterPoint\|`