From 743dbdb64759e32c3a5d6254eceb8ac6158bd1a9 Mon Sep 17 00:00:00 2001 From: Selma Vidimlic Husic Date: Fri, 5 Jan 2024 17:09:20 +0100 Subject: [PATCH 1/7] Style database update added --- .../introduction/general_tools.rst | 3 +++ .../introduction/qgis_configuration.rst | 25 +++++++++++++++++++ 2 files changed, 28 insertions(+) diff --git a/docs/user_manual/introduction/general_tools.rst b/docs/user_manual/introduction/general_tools.rst index b1d7a294a9c..0239f545dcb 100644 --- a/docs/user_manual/introduction/general_tools.rst +++ b/docs/user_manual/introduction/general_tools.rst @@ -510,6 +510,9 @@ From a drop-down list of current layers in the layer panel, select an item and: layer style in the current project: you can therefore cancel or restore to any state by selecting it in the list and clicking :guilabel:`Apply`. +In the :guilabel:`Layer Styling` panel you can also choose to press the +:guilabel:`Save Symbol` button to add the symbol being edited to the :ref:`style_database`. + Another powerful feature of this panel is the |checkbox| :guilabel:`Live update` checkbox. Tick it to render your changes immediately on the map canvas: you no longer need to click the :guilabel:`Apply` button. diff --git a/docs/user_manual/introduction/qgis_configuration.rst b/docs/user_manual/introduction/qgis_configuration.rst index ebb95946067..f10304e668e 100644 --- a/docs/user_manual/introduction/qgis_configuration.rst +++ b/docs/user_manual/introduction/qgis_configuration.rst @@ -1835,6 +1835,9 @@ Under |symbology| :guilabel:`Styles` tab, you can configure symbols and colors inherent to the project, allowing to safely share the project among different machines. +Default symbols +............... + The :guilabel:`Default Symbols` group lets you control how new layers will be drawn in the project when they do not have an existing :file:`.qml` style defined. You can set :guilabel:`Marker`, :guilabel:`Line`, :guilabel:`Fill` to @@ -1843,6 +1846,9 @@ Ramp` and :guilabel:`Text Format` (e.g. when enabling labeling). Any of these items can be reset using the :guilabel:`Clear` entry from the corresponding drop-down widget. +Options +....... + In the :guilabel:`Options` group, you can: * Apply a default :guilabel:`Opacity` to new layers @@ -1858,6 +1864,9 @@ In the :guilabel:`Options` group, you can: .. _project_colors: +Project Colors +.............. + There is also an additional section where you can define specific colors for the running project. Like the :ref:`global colors `, you can: @@ -1890,6 +1899,20 @@ These colors are identified as :guilabel:`Project colors` and listed as part of #. Update the project color once and the change is reflected EVERYWHERE it's in use. +.. _style_database: + +Style Database +.............. + +QGIS enables you to link projects to multiple style databases. When project +is loaded, symbol and lable style selectors display all symbols from linked +styles, and each project has its own sytle database to store project specific +symbols and text formats. +In the :guilabel:`Style Database` section you can choose to +|symbologyAdd| :guilabel:`Add` or |symbologyRemove| :guilabel:`Remove` +style database or you can |newPage| :guilabel:`Create new style database`. + + .. _project_data_source_properties: Data Sources Properties @@ -2687,6 +2710,8 @@ in the QGIS user profile. :width: 1.5em .. |measureBearing| image:: /static/common/mActionMeasureBearing.png :width: 1.5em +.. |newPage| image:: /static/common/mActionNewPage.png + :width: 1.5em .. |nix| image:: /static/common/nix.png :width: 1em .. |offsetCurve| image:: /static/common/mActionOffsetCurve.png From 190c49f772a514b7dd759907dd4898750fdba9e9 Mon Sep 17 00:00:00 2001 From: Selma Vidimlic Husic Date: Fri, 19 Jan 2024 12:25:33 +0100 Subject: [PATCH 2/7] Changes in the qgis_configuration file, more details about style databases added --- .../introduction/qgis_configuration.rst | 21 +++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/docs/user_manual/introduction/qgis_configuration.rst b/docs/user_manual/introduction/qgis_configuration.rst index f10304e668e..47e23f802cc 100644 --- a/docs/user_manual/introduction/qgis_configuration.rst +++ b/docs/user_manual/introduction/qgis_configuration.rst @@ -1904,13 +1904,26 @@ These colors are identified as :guilabel:`Project colors` and listed as part of Style Database .............. -QGIS enables you to link projects to multiple style databases. When project -is loaded, symbol and lable style selectors display all symbols from linked -styles, and each project has its own sytle database to store project specific -symbols and text formats. +A style database in QGIS is a structured repository designed to store symbols, +text formats, and other styling elements. It serves as a centralized location +where you can organize and manage your symbology resources efficiently. +You can create a dedicated style database for a specific client, housing +symbols tailored to that client's need. This ensures a clean and organized +approach, without cluttering the default style database. +In multi-user environments, it's possible to store project-specific styles +in a shared location. By linking a project to these styles, all users within +the project gain access to common symbology, eliminating the need for +manual import or updates to individual local style database. +Storing symbols in a project file offers a practical solution, preventing users +from overcrowding their global style database with project-specific symbology. +This approach guarantees that other users working on the same project immediately +have access to all the necessary symbology upon loading the project. + In the :guilabel:`Style Database` section you can choose to |symbologyAdd| :guilabel:`Add` or |symbologyRemove| :guilabel:`Remove` style database or you can |newPage| :guilabel:`Create new style database`. +When you add or remove a style database in this section, the changes will +be automatically reflected in the |symbology| :guilabel:`Symbology Properties`. .. _project_data_source_properties: From ba2cf370f93780069ffd802fca47b050ab41f2af Mon Sep 17 00:00:00 2001 From: selmaVH1 Date: Fri, 9 Feb 2024 15:15:30 +0100 Subject: [PATCH 3/7] Adding infos about drop-down menu and style database --- .../style_library/style_manager.rst | 66 +++++++++++-------- .../style_library/symbol_selector.rst | 2 +- 2 files changed, 38 insertions(+), 30 deletions(-) diff --git a/docs/user_manual/style_library/style_manager.rst b/docs/user_manual/style_library/style_manager.rst index 21b79ea9d65..4ed64d7468b 100644 --- a/docs/user_manual/style_library/style_manager.rst +++ b/docs/user_manual/style_library/style_manager.rst @@ -49,36 +49,12 @@ You can open that modeless dialog either: Organizing style items ---------------------- -The :guilabel:`Style Manager` dialog displays in its center a frame with -previewed items organized into tabs: - -* :guilabel:`All` for a complete collection of point, linear and surface symbols - and label settings as well as predefined color ramps and text formats; -* |pointLayer| :guilabel:`Marker` for point symbols only; -* |lineLayer| :guilabel:`Line` for linear symbols only; -* |polygonLayer| :guilabel:`Fill` for surface symbols only; -* |color| :guilabel:`Color ramp`; -* |text| :guilabel:`Text format` to manage :ref:`text formats `, - which store the font, color, buffers, shadows, and backgrounds of texts - (i.e. all the formatting parts of the label settings, which for instance can - be used in layouts); -* |labelingSingle| :guilabel:`Label settings` to manage :ref:`label settings - `, which include the text formats and some layer-type specific - settings such as label placement, priority, callouts, rendering... -* |legend| :guilabel:`Legend Patch Shapes` to manage custom legend patch - shapes, which include :guilabel:`Marker`, :guilabel:`Line` and - :guilabel:`Fill` geometries. -* |3d| :guilabel:`3D Symbols` to configure symbols with :ref:`3D properties - <3dsymbols>` (extrusion, shading, altitude, ...) for the features to render - in a :ref:`3D Map view ` +In the upper left corner ot the :guilabel:`Style Manager` dialog, within +the drop-down menu, you can choose the style database you want to connect to. +There are also options to |symbologyAdd| :sup:`Add existing style database to project` +and |newPage| :sup:`Create new style database` (see more :ref:`Style database `). -You can arrange the Styles in |iconView| :guilabel:`Icon View` or in -|openTable| :guilabel:`List View` on the bottom right side. In both views -the tooltip shows a larger instance of the style. -The thumbnail size slider at the left of the icons helps you adjust the actual -thumbnail sizes in the dialog, for a better preview of the symbols! - -For each family of items, you can organize the elements into different categories, +For each style database, you can organize the elements into different categories, listed in the panel on the left: * **Favorites**: displayed by default when configuring an item, it shows an @@ -126,6 +102,36 @@ To remove a tag or a smart group, right-click on it and select the |symbologyRem :guilabel:`Remove` button. Note that this does not delete the items grouped in the category. +The :guilabel:`Style Manager` dialog displays in its center a frame with +previewed items organized into tabs: + +* :guilabel:`All` for a complete collection of point, linear and surface symbols + and label settings as well as predefined color ramps and text formats; +* |pointLayer| :guilabel:`Marker` for point symbols only; +* |lineLayer| :guilabel:`Line` for linear symbols only; +* |polygonLayer| :guilabel:`Fill` for surface symbols only; +* |color| :guilabel:`Color ramp`; +* |text| :guilabel:`Text format` to manage :ref:`text formats `, + which store the font, color, buffers, shadows, and backgrounds of texts + (i.e. all the formatting parts of the label settings, which for instance can + be used in layouts); +* |labelingSingle| :guilabel:`Label settings` to manage :ref:`label settings + `, which include the text formats and some layer-type specific + settings such as label placement, priority, callouts, rendering... +* |legend| :guilabel:`Legend Patch Shapes` to manage custom legend patch + shapes, which include :guilabel:`Marker`, :guilabel:`Line` and + :guilabel:`Fill` geometries. +* |3d| :guilabel:`3D Symbols` to configure symbols with :ref:`3D properties + <3dsymbols>` (extrusion, shading, altitude, ...) for the features to render + in a :ref:`3D Map view ` + +You can arrange the Styles in |iconView| :guilabel:`Icon View` or in +|openTable| :guilabel:`List View` on the bottom right side. In both views +the tooltip shows a larger instance of the style. +The thumbnail size slider at the left of the icons helps you adjust the actual +thumbnail sizes in the dialog, for a better preview of the symbols! + + Adding, editing or removing an item ----------------------------------- @@ -412,6 +418,8 @@ back to the :guilabel:`New Legend Patch Shape` dialog to keep creating new shape :width: 1.2em .. |lineLayer| image:: /static/common/mIconLineLayer.png :width: 1.5em +.. |newPage| image:: /static/common/mActionNewPage.png + :width: 1.5em .. |openTable| image:: /static/common/mActionOpenTable.png :width: 1.5em .. |pointLayer| image:: /static/common/mIconPointLayer.png diff --git a/docs/user_manual/style_library/symbol_selector.rst b/docs/user_manual/style_library/symbol_selector.rst index 2ff1211ecf8..dc929e44a37 100644 --- a/docs/user_manual/style_library/symbol_selector.rst +++ b/docs/user_manual/style_library/symbol_selector.rst @@ -100,7 +100,7 @@ You can setup some parameters that apply to the global symbol: * or as icon preview using the |iconView| :sup:`Icon View` button. * Press the :guilabel:`Save Symbol` button to add the symbol being edited to the - symbols library. + symbols library or style database. * With the :guilabel:`Advanced` |selectString| option, you can: * for line and fill symbols, :guilabel:`Clip features to canvas extent`. From 62d2c97bd4b41f875a4525aa6101676ccc17d97a Mon Sep 17 00:00:00 2001 From: selmaVH1 Date: Fri, 1 Mar 2024 16:56:37 +0100 Subject: [PATCH 4/7] Add details about drop-down menu in the style manager --- docs/user_manual/style_library/style_manager.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/user_manual/style_library/style_manager.rst b/docs/user_manual/style_library/style_manager.rst index 4ed64d7468b..d996620050c 100644 --- a/docs/user_manual/style_library/style_manager.rst +++ b/docs/user_manual/style_library/style_manager.rst @@ -51,6 +51,11 @@ Organizing style items In the upper left corner ot the :guilabel:`Style Manager` dialog, within the drop-down menu, you can choose the style database you want to connect to. +If you choose :guilabel:`Default` you will be connected to the default style database +where you can find all available default style items and the ones that you saved in this database. +Choosing :guilabel:`Project Styles` will connect you to the Project Style database +where you can find only symbols that you saved in this database. +If you created more style databases, they will be listed in the drop-down menu. There are also options to |symbologyAdd| :sup:`Add existing style database to project` and |newPage| :sup:`Create new style database` (see more :ref:`Style database `). From 5b1f57c69dc72eacff008b9b9bfe1469ea5802ec Mon Sep 17 00:00:00 2001 From: selmaVH1 Date: Fri, 1 Mar 2024 17:27:12 +0100 Subject: [PATCH 5/7] Save symbol button update --- docs/user_manual/style_library/symbol_selector.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/user_manual/style_library/symbol_selector.rst b/docs/user_manual/style_library/symbol_selector.rst index dc929e44a37..d390b21b936 100644 --- a/docs/user_manual/style_library/symbol_selector.rst +++ b/docs/user_manual/style_library/symbol_selector.rst @@ -99,8 +99,10 @@ You can setup some parameters that apply to the global symbol: |openTable| :sup:`List View` button below the frame; * or as icon preview using the |iconView| :sup:`Icon View` button. -* Press the :guilabel:`Save Symbol` button to add the symbol being edited to the - symbols library or style database. +* Press the :guilabel:`Save Symbol` button to open the :guilabel:`Save New Symbol` dialog. + Here, you can choose the :guilabel:`Destination` where you want to add the symbol being edited, + give it a :guilabel:`Name` and add :guilabel:`Tag(s)`. + You also have the option to |checkbox| :sup:`Add to favorites` your new symbol. * With the :guilabel:`Advanced` |selectString| option, you can: * for line and fill symbols, :guilabel:`Clip features to canvas extent`. From 18f2aa674ad445a3451d316ba308b9bf814612d5 Mon Sep 17 00:00:00 2001 From: Harrissou Sant-anna Date: Fri, 8 Mar 2024 12:18:30 +0100 Subject: [PATCH 6/7] Remove misleading text --- docs/user_manual/introduction/general_tools.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/user_manual/introduction/general_tools.rst b/docs/user_manual/introduction/general_tools.rst index 0239f545dcb..b1d7a294a9c 100644 --- a/docs/user_manual/introduction/general_tools.rst +++ b/docs/user_manual/introduction/general_tools.rst @@ -510,9 +510,6 @@ From a drop-down list of current layers in the layer panel, select an item and: layer style in the current project: you can therefore cancel or restore to any state by selecting it in the list and clicking :guilabel:`Apply`. -In the :guilabel:`Layer Styling` panel you can also choose to press the -:guilabel:`Save Symbol` button to add the symbol being edited to the :ref:`style_database`. - Another powerful feature of this panel is the |checkbox| :guilabel:`Live update` checkbox. Tick it to render your changes immediately on the map canvas: you no longer need to click the :guilabel:`Apply` button. From 0010fa55f5ff71fb990884b0ff5d65d3c36301c2 Mon Sep 17 00:00:00 2001 From: Harrissou Sant-anna Date: Fri, 8 Mar 2024 12:18:59 +0100 Subject: [PATCH 7/7] Fix typo --- docs/user_manual/style_library/style_manager.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user_manual/style_library/style_manager.rst b/docs/user_manual/style_library/style_manager.rst index d996620050c..4a54852a6ea 100644 --- a/docs/user_manual/style_library/style_manager.rst +++ b/docs/user_manual/style_library/style_manager.rst @@ -49,7 +49,7 @@ You can open that modeless dialog either: Organizing style items ---------------------- -In the upper left corner ot the :guilabel:`Style Manager` dialog, within +In the upper left corner of the :guilabel:`Style Manager` dialog, within the drop-down menu, you can choose the style database you want to connect to. If you choose :guilabel:`Default` you will be connected to the default style database where you can find all available default style items and the ones that you saved in this database.