tdf#105122 Initial contents for document themes help

Change-Id: Ia415169020698f53bf6019d546fcd42fd9be31bd Reviewed-on: https://gerrit.libreoffice.org/c/help/+/155329 Tested-by: Jenkins Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
author: Olivier Hallot <olivier.hallot@libreoffice.org> 2023-08-03 23:00:04 -0300
committer: Andras Timar <andras.timar@collabora.com> 2023-10-08 21:19:43 +0200
commit: 0e876794387dcc0777c63bd41c4ea0ecfe402e85 (patch)
tree: b24253a334e329a602ba688afe82346841773a89
parent: 90b7aad666d0338c819b375f574cdbeb74d47037 (diff)
5 files changed, 127 insertions, 6 deletions
diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk
index 4734440d82..153638167b 100644
--- a/AllLangHelp_shared.mk
+++ b/AllLangHelp_shared.mk
@@ -760,6 +760,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\
     helpcontent2/source/text/shared/guide/text_color \
     helpcontent2/source/text/shared/guide/textmode_change \
     helpcontent2/source/text/shared/guide/undo_formatting \
+    helpcontent2/source/text/shared/guide/usingthemes \
     helpcontent2/source/text/shared/guide/version_number \
     helpcontent2/source/text/shared/guide/viewing_file_properties \
     helpcontent2/source/text/shared/guide/workfolder \
diff --git a/source/text/shared/01/themescolordialog.xhp b/source/text/shared/01/themescolordialog.xhp
index 3678269619..569d33cf67 100644
--- a/source/text/shared/01/themescolordialog.xhp
+++ b/source/text/shared/01/themescolordialog.xhp
@@ -16,10 +16,31 @@
     </topic>
 </meta>
 <body>
+<bookmark xml-lang="en-US" branch="index" id="bm_id121691113786345">
+    <bookmark_value>document themes;colors</bookmark_value>
+    <bookmark_value>themes;colors</bookmark_value>
+    <bookmark_value>colors;in document themes</bookmark_value>
+</bookmark>
 <section id="themecolordialogHead">
-    <bookmark id="bm_id921690371871842" branch="hid/svx/ui/themecoloreditdialog/dialogButtons" localize="false"/>
-    <h1 id="hd_id911690371871844"><variable id="h1"><link href="text/shared/01/themescolordialog.xhp">Theme Colors</link></variable></h1>
+    <bookmark id="bm_id921690371871842" branch="hid/svx/ui/themecoloreditdialog/@@nowidget@@" localize="false"/>
+    <h1 id="hd_id911690371871844"><variable id="h1"><link href="text/shared/01/themescolordialog.xhp">Document Theme Colors</link></variable></h1>
+    <paragraph role="paragraph" id="par_id701691103384432">Creates a color theme.</paragraph>
+</section>
+<section id="howtoget">
+    <embed href="text/shared/00/00000004.xhp#from_menu_bar"/>
+    <paragraph role="paragraph" id="par_id441691102910404">Choose <menuitem>Format - Theme</menuitem> and click on <widget>Add</widget>.</paragraph>
+</section>
+<bookmark branch="hid/hid/svx/ui/themecoloreditdialog/entryThemeColorsName" id="bm_id731691103275007" localize="false"/>
+<h2 id="hd_id881691103004581">Name</h2>
+<paragraph role="paragraph" id="par_id361691103011285">Enter the name of the new theme.</paragraph>
+
+<h2 id="hd_id431691103045089">Colors</h2>
+<paragraph role="paragraph" id="par_id971691103121593">For each of the theme named color, select the color in the color drop-down list.</paragraph>
+<paragraph role="paragraph" id="par_id641691113191332" localize="false"><embedvar href="text/shared/guide/usingthemes.xhp#extracolors" markup="ignore"/></paragraph>
+<tip id="par_id731691113704905">Applied user defined theme is saved only in the document. To make it usable for other documents, use themes in document templates.</tip>
+<section id="relatedtopics">
+    <paragraph role="paragraph" id="par_id111691103542338" localize="false"><embedvar href="text/shared/01/themesdialog.xhp#h1" markup="ignore"/></paragraph>
+    <paragraph role="paragraph" id="par_id551691112632895" localize="false"><embedvar href="text/shared/guide/usingthemes.xhp#h1" markup="ignore"/></paragraph>
 </section>
-<embed href="text/shared/need_help.xhp#needhelp"/>
 </body>
 </helpdocument>
diff --git a/source/text/shared/01/themesdialog.xhp b/source/text/shared/01/themesdialog.xhp
index 3b9e6e7674..b92ce22583 100644
--- a/source/text/shared/01/themesdialog.xhp
+++ b/source/text/shared/01/themesdialog.xhp
@@ -8,7 +8,6 @@
     * file, You can obtain one at http://mozilla.org/MPL/2.0/.
     *
     -->
-
     <meta>
         <topic id="textshared01themesdialog" indexer="include" status="PUBLISH">
         <title id="tit">Themes</title>
@@ -16,10 +15,38 @@
     </topic>
 </meta>
 <body>
+<bookmark id="bm_id771690371241991" branch="hid/svx/ui/themedialog/ThemeDialog" localize="false"/>
+<bookmark id="bm_id771690371241992" branch="hid/svx/ui/themedialog/@@nowidget@@" localize="false"/>
+<bookmark xml-lang="en-US" branch="index" id="bm_id971691113956654">
+    <bookmark_value>document themes;choosing</bookmark_value>
+    <bookmark_value>applying document themes</bookmark_value>
+</bookmark>
 <section id="themesHead">
-    <bookmark id="bm_id771690371241991" branch="hid/svx/ui/themedialog/dialogButtons" localize="false"/>
     <h1 id="hd_id931690371241991"><variable id="h1"><link href="text/shared/01/themesdialog.xhp">Themes</link></variable></h1>
+    <paragraph role="paragraph" id="par_id601691097282479">The bundling of color, font and format settings is possible under the concept of <emph>Theme</emph>.</paragraph>
+</section>
+<section id="howtoget">
+    <embed href="text/shared/00/00000004.xhp#from_menu_bar"/>
+    <paragraph role="paragraph" id="par_id101691100079162">Choose <menuitem>Format - Themes</menuitem>.</paragraph>
+    <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, 3 lighter and 2 darker, 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>
+
+<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 theme area is the current applied theme.</tip>
+<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="relatedtopics">
+    <paragraph role="paragraph" id="par_id611691100380708" localize="false"><embedvar href="text/shared/01/themescolordialog.xhp#h1" markup="ignore"/></paragraph>
+    <paragraph role="paragraph" id="par_id551691112632895" localize="false"><embedvar href="text/shared/guide/usingthemes.xhp#h1" markup="ignore"/></paragraph>
 </section>
-<embed href="text/shared/need_help.xhp#needhelp"/>
 </body>
 </helpdocument>
diff --git a/source/text/shared/guide/usingthemes.xhp b/source/text/shared/guide/usingthemes.xhp
new file mode 100644
index 0000000000..df1ab52bd9
--- /dev/null
+++ b/source/text/shared/guide/usingthemes.xhp
@@ -0,0 +1,71 @@
+<?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="textsharedguideusingthemes" indexer="include" status="PUBLISH">
+        <title id="tit">Using Themes</title>
+        <filename>/text/shared/guide/usingthemes.xhp</filename>
+    </topic>
+</meta>
+<body>
+<bookmark xml-lang="en-US" branch="index" id="bm_id21691114004763">
+    <bookmark_value>using;document themes</bookmark_value>
+    <bookmark_value>document themes;using</bookmark_value>
+</bookmark>
+<section id="usingthemesHead">
+    <h1 id="hd_id911691103974397"><variable id="h1"><link href="text/shared/guide/usingthemes.xhp">Using Document Themes</link></variable></h1>
+    <paragraph id="par_id991691103974400" role="paragraph"></paragraph>
+    </section>
+    <paragraph role="paragraph" id="par_id451691109216603">Theme is the concept of bundling color, font and format settings. The colors, fonts and format settings names are hard coded in the document. When switching themes in the document, the elements containing the hardcoded names switch colors, fonts and format settings accordingly to the new theme.</paragraph>
+    <h2 id="hd_id761691104702168">To Apply a Theme to the Document</h2>
+    <list type="ordered">
+        <listitem>
+            <paragraph id="par_id251691104665472"  role="listitem">Choose <menuitem>Format - Themes</menuitem>.</paragraph>
+        </listitem>
+        <listitem>
+            <paragraph id="par_id191691104673439"  role="listitem">Double-click on the theme desired or select the theme and click <widget>OK</widget></paragraph>
+        </listitem>
+    </list>
+    <paragraph role="paragraph" id="par_id91691105048167">All document elements with the hardcoded theme attribute name set will change to the new theme attribute. For example, a heading with font color set as "Dark 2" changes to the new theme "Dark 2" color.</paragraph>
+    <h2 id="hd_id61691109283045">To Add a New Theme</h2>
+    <list type="ordered">
+        <listitem>
+            <paragraph id="par_id901691109354713"  role="listitem">Choose <menuitem>Format - Theme</menuitem> and click on <widget>Add</widget>.</paragraph>
+        </listitem>
+        <listitem>
+            <paragraph id="par_id351691109420290"  role="listitem">Enter a name for the new theme in the <emph>Name</emph> text box.</paragraph>
+        </listitem>
+        <listitem>
+            <paragraph id="par_id191691110090664"  role="listitem">On the color area, choose the main color for each of the 12 hard coded color name of the theme. <variable id="extracolors">%PRODUCTNAME creates 5 additional colors to the theme calculated from the main color. The calculations of the color variants are also hard coded in the theme and you cannot change them, only the main color.</variable> </paragraph>
+        </listitem>
+        <listitem>
+            <paragraph id="par_id811691110231938"  role="listitem">Click <widget>OK</widget> to close the color dialog.</paragraph>
+        </listitem>
+        <listitem>
+            <paragraph id="par_id971691110237308"  role="listitem">Click <widget>OK</widget> or double click the new theme to apply the theme to the document.</paragraph>
+        </listitem>
+    </list>
+    <h2 id="hd_id141691110507439">To Use a Document Theme</h2>
+    <list type="ordered">
+        <listitem>
+            <paragraph id="par_id511691113013612"  role="listitem">Format the document using the hardcoded theme attribute name such as colors, fonts and other format settings.</paragraph>
+        </listitem>
+        <listitem>
+            <paragraph id="par_id671691113042212"  role="listitem">Apply the theme to the document.</paragraph>
+        </listitem>
+    </list>
+
+    <section id="relatedtopics">
+        <paragraph role="paragraph" id="par_id111691103542338" localize="false"><embedvar href="text/shared/01/themesdialog.xhp#h1" markup="ignore"/></paragraph>
+        <paragraph role="paragraph" id="par_id611691100380708" localize="false"><embedvar href="text/shared/01/themescolordialog.xhp#h1" markup="ignore"/></paragraph>
+    </section>
+</body>
+</helpdocument>
diff --git a/source/text/swriter/main0105.xhp b/source/text/swriter/main0105.xhp
index 6921ba51c7..e638f8bd8f 100644
--- a/source/text/swriter/main0105.xhp
+++ b/source/text/swriter/main0105.xhp
@@ -49,6 +49,7 @@
 </section>
 <h2 id="hd_id3145784"><link href="text/shared/01/06050000.xhp">Bullets and Numbering</link></h2>
 <embed href="text/shared/01/06050000.xhp#numauftext"/>
+<embed href="text/shared/01/themesdialog.xhp#themesHead"/>
 <embed href="text/swriter/01/05040000.xhp#PageStyle"/>
 <h2 id="hd_id871602976197055">Title Page</h2>
 <paragraph role="paragraph" id="par_id471602976213270">Opens a dialog where you can design a title page.</paragraph><comment>When a help page is made for Title Page, then the heading and text can be replaced with the embed.</comment>
author	Olivier Hallot <olivier.hallot@libreoffice.org>	2023-08-03 23:00:04 -0300
committer	Andras Timar <andras.timar@collabora.com>	2023-10-08 21:19:43 +0200
commit	0e876794387dcc0777c63bd41c4ea0ecfe402e85 (patch)
tree	b24253a334e329a602ba688afe82346841773a89
parent	90b7aad666d0338c819b375f574cdbeb74d47037 (diff)