AllLangHelp_swriter.mk                    |    1 
 source/text/shared/01/05210200.xhp        |   63 ++++++++++++++-------
 source/text/shared/01/themesdialog.xhp    |   26 ++++++--
 source/text/swriter/01/sidebar_design.xhp |   90 ++++++++++++++++++++++++++++++
 4 files changed, 154 insertions(+), 26 deletions(-)

New commits:
commit e9d4aba7ef8015a50cfe78c611632b445573a874
Author:     Dione Maddern <dionemadd...@gmail.com>
AuthorDate: Tue Nov 12 11:44:55 2024 -0500
Commit:     Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Tue Nov 12 18:22:30 2024 +0100

    tdf#162504 Add help page for Design sidebar deck
    
    Add new file source/text/swriter/01/sidebar_design.xhp to describe the
    features of the Display sidebar deck.
    
    In AllLangHelp_swriter.mk
    - Add new file source/text/swriter/01/sidebar_design.xhp to repository
    
    In source/text/shared/01/05210200.xhp
    Add section tags to allow content to easily be linked and embedded in
    other pages.
    
    In source/text/shared/01/themesdialog.xhp
    Add section tags to allow content to easily be linked and embedded in
    other pages.
    
    Change-Id: Ic6566b6b1c2a3a6a92d22b2f49b9220cef4bd03c
    Reviewed-on: https://gerrit.libreoffice.org/c/help/+/176493
    Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
    Tested-by: Jenkins

diff --git a/AllLangHelp_swriter.mk b/AllLangHelp_swriter.mk
index c6ead90660..2efd1dd4d3 100644
--- a/AllLangHelp_swriter.mk
+++ b/AllLangHelp_swriter.mk
@@ -203,6 +203,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,swriter,\
     helpcontent2/source/text/swriter/01/select_text \
     helpcontent2/source/text/swriter/01/show_whitespace \
     helpcontent2/source/text/swriter/01/sidebar_comments \
+    helpcontent2/source/text/swriter/01/sidebar_design \
     helpcontent2/source/text/swriter/01/sidebar_quickfind \
     helpcontent2/source/text/swriter/01/SpotlightMenu \
     helpcontent2/source/text/swriter/01/SpotlightCharStyles \
diff --git a/source/text/shared/01/05210200.xhp 
b/source/text/shared/01/05210200.xhp
index dafde66c1f..bb8924095b 100644
--- a/source/text/shared/01/05210200.xhp
+++ b/source/text/shared/01/05210200.xhp
@@ -49,30 +49,55 @@
     <h2 id="hd_id931578758906569">Colors</h2>
 
     <section id="quickcolor">
-        <h3 id="hd_id551578758911321">Palette</h3>
-    <paragraph role="paragraph" id="par_id411578758922329">Select the color 
palette in the list box to pick the color for the selected object. The palette 
color set displays below.</paragraph>
+        <section id="palette">
+        <h3 id="hd_id551578758911321"><variable 
id="palette_hd">Palette</variable></h3>
+        <section id="palette_content"><paragraph role="paragraph" 
id="par_id411578758922329">Select the color palette in the list box to pick the 
color for the selected object. The palette color set displays 
below.</paragraph></section>
     <note id="par_id441641431603505">The <emph>Theme colors</emph> palette 
shows the theme colors from the current theme, if the document has any.</note>
     <note id="par_id441641431603506">The <emph>Document colors</emph> palette 
shows the colors used in the current document.</note>
-    <h3 id="hd_id981578758969146">Recent colors</h3>
-    <paragraph role="paragraph" id="par_id751578758975939">Displays the recent 
selected colors.</paragraph>
     </section>
-    <h3 id="hd_id41578758979874">Custom Palette</h3>
-    <paragraph role="paragraph" id="par_id641578758985603">Click 
<widget>Add</widget> to open a dialog to set a name for the custom color. The 
palette changes to "custom".</paragraph>
-    <paragraph role="paragraph" id="par_id191578758991563">Click 
<widget>Delete</widget> to delete the color from the custom palette.</paragraph>
-    <note id="par_id921578758048450">You cannot add or delete colors of the 
palettes provided by your installation.</note>
-
-    <h2 id="hd_id991578758873888">Active</h2>
-    <paragraph role="paragraph" id="par_id361578758881241">Displays the 
current active color for the object. Red, blue and green components values and 
the color value in hexadecimal notation are displayed just below.</paragraph>
-    <h2 id="hd_id801578758863952">New</h2>
-    <paragraph role="paragraph" id="par_id271578758868425">Displays the new 
color for the object that will be applied when you click <widget>OK</widget>. 
</paragraph>
-    <h3 id="hd_id701578758840552">R, G and B</h3>
-    <paragraph role="paragraph" id="par_id691578758845984">The values of the 
red, blue and green components of the new color. You can define the new color 
by entering the red, green and blue values in the respective <emph>R</emph>, 
<emph>G</emph> and <emph>B</emph> spin boxes. Allowed values are 0 to 
255.</paragraph>
-    <h3 id="hd_id591578758836544">Hex</h3>
-    <paragraph role="paragraph" id="par_id121578758850944">The color value in 
hexadecimal notation. You can enter the hexadecimal value in the 
<emph>Hex</emph> text box.</paragraph>
+    <section id="recent_colors">
+        <h3 id="hd_id981578758969146"><variable id="recent_colors_hd">Recent 
colors</variable></h3>
+    <section id="recent_colors_content"><paragraph role="paragraph" 
id="par_id751578758975939">Displays the recent selected 
colors.</paragraph></section>
+    </section>
+        </section>
+    <section id="custom_palette">
+        <h3 id="hd_id41578758979874"><variable id="custom_palette_hd">Custom 
Palette</variable></h3>
+        <section id="custom_palette_content">
+            <paragraph role="paragraph" id="par_id641578758985603">Click 
<widget>Add</widget> to open a dialog to set a name for the custom color. The 
palette changes to "custom".</paragraph>
+            <paragraph role="paragraph" id="par_id191578758991563">Click 
<widget>Delete</widget> to delete the color from the custom palette.</paragraph>
+            <note id="par_id921578758048450">You cannot add or delete colors 
of the palettes provided by your installation.</note>
+        </section>
+    </section>
 
+    <section id="active">
+        <h2 id="hd_id991578758873888"><variable 
id="active_hd">Active</variable></h2>
+        <section id="active_content">
+            <paragraph role="paragraph" id="par_id361578758881241">Displays 
the current active color for the object. Red, blue and green components values 
and the color value in hexadecimal notation are displayed just 
below.</paragraph>
+        </section>
+    </section>
+    <section id="new">
+        <h2 id="hd_id801578758863952"><variable id="new_hd">New</variable></h2>
+        <section id="_content">
+            <paragraph role="paragraph" id="par_id271578758868425">Displays 
the new color for the object that will be applied when you click 
<widget>OK</widget>. </paragraph>
+        </section>
+    </section>
+    <section id="rgb">
+        <h3 id="hd_id701578758840552"><variable id="rgb_hd">R, G and 
B</variable></h3>
+        <section id="rgb_content">
+            <paragraph role="paragraph" id="par_id691578758845984">The values 
of the red, blue and green components of the new color. You can define the new 
color by entering the red, green and blue values in the respective 
<emph>R</emph>, <emph>G</emph> and <emph>B</emph> spin boxes. Allowed values 
are 0 to 255.</paragraph>
+        </section>
+    </section>
+    <section id="hex">
+        <h3 id="hd_id591578758836544"><variable id="hex_hd">Hex</variable></h3>
+        <section id="_content">
+            <paragraph role="paragraph" id="par_id121578758850944">The color 
value in hexadecimal notation. You can enter the hexadecimal value in the 
<emph>Hex</emph> text box.</paragraph>
+        </section>
+    </section>
     <section id="colorpicker">
-    <h3 id="hd_id891578758832248">Pick</h3>
-    <paragraph role="paragraph" id="par_id131578758826856">Opens the <link 
href="text/shared/optionen/01010501.xhp">color picker dialog</link> for a 
graphical selection of the desired color.</paragraph>
+        <h3 id="hd_id891578758832248"><variable 
id="colorpicker_hd">Pick</variable></h3>
+        <section id="colorpicker_content">
+            <paragraph role="paragraph" id="par_id131578758826856">Opens the 
<link href="text/shared/optionen/01010501.xhp">color picker dialog</link> for a 
graphical selection of the desired color.</paragraph>
+        </section>
     </section>
     <embed href="text/shared/00/00000001.xhp#reset2"/>
     <section id="relatedtopics">
diff --git a/source/text/shared/01/themesdialog.xhp 
b/source/text/shared/01/themesdialog.xhp
index c374955425..402e9eb22c 100644
--- a/source/text/shared/01/themesdialog.xhp
+++ b/source/text/shared/01/themesdialog.xhp
@@ -32,18 +32,30 @@
     <embed href="text/shared/00/00000004.xhp#from_sidebar"/>
     <paragraph role="paragraph" id="par_id171691100137681">Open the 
<menuitem>Design</menuitem> panel.</paragraph>
 </section>
-<paragraph role="paragraph" id="par_id261691098998130"><emph>Theme 
colors</emph> is a set of twelve colors, each color has 5 variations computed 
internally, defined by their RGB-value and only the RGB-value is written to 
document file. A color of an object can be defined by a reference into a color 
of the <emph>Theme colors</emph> set. This reference is done by keyword or 
index, depending on the context. </paragraph>
-
+<section id="theme_colors">
+    <h2 id="hd_id941731093524972"><variable id="theme_colors_hd">Theme 
colors</variable></h2>
+    <section id="theme_ colors_content">
+        <paragraph role="paragraph" id="par_id261691098998130"><emph>Theme 
colors</emph> is a set of twelve colors, each color has 5 variations computed 
internally, defined by their RGB-value and only the RGB-value is written to 
document file. A color of an object can be defined by a reference into a color 
of the <emph>Theme colors</emph> set. This reference is done by keyword or 
index, depending on the context. </paragraph>
+    </section>
+    </section>
 <note id="par_id881691098989192">You need to save the document with the <link 
href="text/shared/00/00000021.xhp">ODF 1.3 extended</link> format or later to 
use themes.</note>
 
 <note id="par_id861691097260314">The new feature has been mainly implemented 
for the import and export filter with MS Office.</note>
 <bookmark 
branch="hid/hid/svx/ui/themedialog/ThemeDialog/valueset_theme_colors" 
id="bm_id61691100989077" localize="false"/>
-<h2 id="hd_id921691098481523">Available themes</h2>
-<paragraph role="paragraph" id="par_id571691098618999">Display the set of 
available themes for the document. To apply a theme to the document, double 
click on the selected theme.</paragraph>
-<tip id="par_id671691099443625">The top left theme in the Available Themes 
area is the current applied theme.</tip>
+<section id="available_themes">
+    <h2 id="hd_id921691098481523"><variable id="available_themes_hd">Available 
themes</variable></h2>
+<section id="available_themes_content">
+    <paragraph role="paragraph" id="par_id571691098618999">Display the set of 
available themes for the document. To apply a theme to the document, double 
click on the selected theme.</paragraph>
+    <tip id="par_id671691099443625">The top left theme in the Available Themes 
area is the current applied theme.</tip>
+</section>
+</section>
 <bookmark branch="hid/hid/svx/ui/themedialog/ThemeDialog/button_add" 
id="bm_id121691101002582" localize="false"/>
-<h2 id="hd_id21691098637039">Add</h2>
-<paragraph role="paragraph" id="par_id621691099005944">Opens the <link 
href="text/shared/01/themescolordialog.xhp"><emph>Theme Color 
Dialog</emph></link> to define the theme name and the colors of the selected 
new theme.</paragraph>
+<section id="add">
+    <h2 id="hd_id21691098637039"><variable id="add_hd">Add</variable></h2>
+    <section id="add_content">
+        <paragraph role="paragraph" id="par_id621691099005944">Opens the <link 
href="text/shared/01/themescolordialog.xhp"><emph>Theme Color 
Dialog</emph></link> to define the theme name and the colors of the selected 
new theme.</paragraph>
+    </section>
+</section>
 
 <section id="relatedtopics">
     <paragraph role="paragraph" id="par_id611691100380708" 
localize="false"><embedvar href="text/shared/01/themescolordialog.xhp#h1" 
markup="ignore"/></paragraph>
diff --git a/source/text/swriter/01/sidebar_design.xhp 
b/source/text/swriter/01/sidebar_design.xhp
new file mode 100644
index 0000000000..a6b1bf3a81
--- /dev/null
+++ b/source/text/swriter/01/sidebar_design.xhp
@@ -0,0 +1,90 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<helpdocument version="1.0">
+    <!--
+    * This file is part of the LibreOffice project.
+    *
+    * This Source Code Form is subject to the terms of the Mozilla Public
+    * License, v. 2.0. If a copy of the MPL was not distributed with this
+    * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+    *
+    -->
+
+    <meta>
+        <topic id="textswriter01sidebar_designxhp" indexer="include" 
status="PUBLISH">
+        <title id="tit">Design</title>
+        <filename>/text/swriter/01/sidebar_design.xhp</filename>
+    </topic>
+</meta>
+<body>
+<bookmark branch="index" id="bm_id431731354972745">
+    <bookmark_value>sidebar;design</bookmark_value>
+    <bookmark_value>sidebar;themes</bookmark_value>
+    <bookmark_value>sidebar;style preset</bookmark_value>
+    <bookmark_value>design;sidebar</bookmark_value>
+    <bookmark_value>design;apply preset</bookmark_value>
+    <bookmark_value>design;apply theme</bookmark_value>
+    <bookmark_value>theme;apply</bookmark_value>
+    <bookmark_value>theme;apply colors</bookmark_value>
+    <bookmark_value>style;preset</bookmark_value>
+    <bookmark_value>style;apply preset</bookmark_value>
+</bookmark>
+<bookmark branch="hid/SIDEBAR_SWDESIGNDECK" id="bm_id481730999700059" 
localize="false"/>
+<section id="design">
+    <h1 id="hd_id241730999156090"><variable id="h1"><link 
href="text/swriter/01/sidebar_design.xhp">Design</link></variable></h1>
+    <section id="design_content">
+        <paragraph role="paragraph" id="par_id41731360269715">Use the 
<menuitem>Design</menuitem> deck of the Sidebar to apply a Theme or Style 
Preset to the document.</paragraph>
+    </section>
+    </section>
+    <section id="howtoget">
+        <embed href="text/shared/00/00000004.xhp#from_sidebar"/>
+        <table id="tbl_id131730999636785">
+        <tablerow>
+          <tablecell>
+              <paragraph id="par_id3148533" role="paragraph"><image 
id="img_id211730999653719" src="cmd/lc_designerdialog.svg" width="1cm" 
height="1cm"><alt id="alt_id951730999658190">Icon 
Design</alt></image></paragraph>
+          </tablecell>
+          <tablecell>
+            <paragraph id="par_id3153534" role="paragraph">Design</paragraph>
+          </tablecell>
+        </tablerow>
+      </table>
+    </section>
+    <section id="enable_experimental_features">
+        <note id="par_id81727707460279">This is an experimental feature. To 
enable experimental features, open the <link 
href="text/shared/optionen/01000000.xhp"><menuitem>Options</menuitem></link> 
dialog, choose <menuitem>%PRODUCTNAME - Advanced</menuitem>, and check the 
<link href="text/shared/optionen/java.xhp#enable_experimental_features">Enable 
experimental features</link> checkbox.</note>
+        </section>
+      <section id="experimental_features_warning">
+          <warning id="par_id861731360885245">Experimental features may be 
unstable, incomplete, or contain known bugs.</warning>
+        </section>
+    <section id="themes">
+        <h2 id="hd_id911731007514929"><variable 
id="themes_hd">Themes</variable></h2>
+        <section id="themes_content">
+            <paragraph id="par_id501731007514929" role="paragraph">Select a 
<link href="/text/shared/01/themesdialog.xhp">theme</link> to apply to the 
document.</paragraph>
+        </section>
+        <section id="colors">
+            <h3 id="hd_id1001731007643102"><variable 
id="colors_hd">Colors</variable></h3>
+            <section id="colors_content">
+                <paragraph id="par_id891731007643103" role="paragraph">Use the 
<menuitem>Colors</menuitem> pane to select <link 
href="/text/shared/01/themesdialog.xhp#theme_colors">theme colors</link> to 
apply to the document.</paragraph>
+            </section>
+        </section>
+        <bookmark branch="hid/modules/swriter/ui/sidebartheme/apply" 
id="bm_id911731092367092" localize="false"/>
+        <section id="apply">
+            <h3 id="hd_id131731009135520"><variable 
id="apply_hd">Apply</variable></h3>
+            <section id="apply_content">
+                <paragraph id="par_id101731009135520" role="paragraph">Applies 
the color palette selected in the <link 
href="text/swriter/01/sidebar_design.xhp#colors"><menuitem>Colors</menuitem></link>
 pane.</paragraph>
+            </section>
+        </section>
+        <section id="style presets">
+            <h2 id="hd_id591731007650337"><variable 
id="style_presets_hd">Style Presets</variable></h2>
+            <section id="style_presets_content">
+                <paragraph id="par_id791731007650338" role="paragraph">Use the 
<menuitem>Style Presets</menuitem> pane to select a style preset to apply to 
the document.</paragraph>
+            </section>
+            </section>
+    </section>
+    <section id="relatedtopics">
+        <embed href="/text/shared/01/05210200.xhp#colorpageh1"/>
+        <embed href="text/shared/01/styles.xhp#styles_h1"/>
+        <embed href="/text/shared/01/themesdialog.xhp#h1"/>
+        <embed 
href="/text/swriter/guide/templates_styles.xhp#templates_styles"/>
+        <embed href="text/shared/guide/usingthemes.xhp#h1"/>
+    </section>
+</body>
+</helpdocument>

Reply via email to