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.hallot@libreoffice.org>
Tested-by: Jenkins

3 files changed, 153 insertions, 26 deletions

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>