summaryrefslogtreecommitdiff
path: root/source/text/shared/guide
diff options
context:
space:
mode:
authorOlivier Hallot <olivier.hallot@libreoffice.org>2023-08-03 23:00:04 -0300
committerOlivier Hallot <olivier.hallot@libreoffice.org>2023-08-04 13:09:29 +0200
commit3cb6dbe25ae87882ca810a56794a05a65412bf17 (patch)
tree8d3b728b9da69cd596023017154d75acdd9563a8 /source/text/shared/guide
parent2b9431287ea5b01b4f854c9363d6250bcfc1f767 (diff)
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>
Diffstat (limited to 'source/text/shared/guide')
-rw-r--r--source/text/shared/guide/usingthemes.xhp71
1 files changed, 71 insertions, 0 deletions
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>