AllLangHelp_shared.mk | 1
source/text/shared/01/themescolordialog.xhp | 27 +++++++++-
source/text/shared/01/themesdialog.xhp | 33 +++++++++++--
source/text/shared/guide/usingthemes.xhp | 71 ++++++++++++++++++++++++++++
source/text/swriter/main0105.xhp | 1
5 files changed, 127 insertions(+), 6 deletions(-)
New commits:
commit 3cb6dbe25ae87882ca810a56794a05a65412bf17
Author: Olivier Hallot <olivier.hal...@libreoffice.org>
AuthorDate: Thu Aug 3 23:00:04 2023 -0300
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Fri Aug 4 13:09:29 2023 +0200
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.hal...@libreoffice.org>
diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk
index 74320659ca..4a9f71196d 100644
--- a/AllLangHelp_shared.mk
+++ b/AllLangHelp_shared.mk
@@ -771,6 +771,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\
helpcontent2/source/text/shared/guide/textmode_change \
helpcontent2/source/text/shared/guide/tipoftheday \
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 dcd645ff55..ad9fb4dc60 100644
--- a/source/text/swriter/main0105.xhp
+++ b/source/text/swriter/main0105.xhp
@@ -46,6 +46,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"/>
<embed
href="text/swriter/01/title_page.xhp#using_title_pages_in_your_document"/>
