source/text/shared/01/themescolordialog.xhp | 8 +++++--- source/text/shared/01/themesdialog.xhp | 17 ++++++++++++++--- source/text/shared/guide/usingthemes.xhp | 26 +++++++++++++------------- 3 files changed, 32 insertions(+), 19 deletions(-)
New commits: commit 52fca1cc12693af63d999faededfc4aa92741cd4 Author: Olivier Hallot <[email protected]> AuthorDate: Thu Jan 22 12:51:29 2026 -0300 Commit: Olivier Hallot <[email protected]> CommitDate: Thu Jan 22 19:41:48 2026 +0100 tdf#159500 clarify fixed colors topicc in Themes + some refactor Change-Id: Icf9b81ed50510d36d030b840a3ce2d45caaff6ed Reviewed-on: https://gerrit.libreoffice.org/c/help/+/197856 Tested-by: Jenkins Reviewed-by: Olivier Hallot <[email protected]> diff --git a/source/text/shared/01/themescolordialog.xhp b/source/text/shared/01/themescolordialog.xhp index 569d33cf67..771cd3ccb0 100644 --- a/source/text/shared/01/themescolordialog.xhp +++ b/source/text/shared/01/themescolordialog.xhp @@ -16,7 +16,7 @@ </topic> </meta> <body> -<bookmark xml-lang="en-US" branch="index" id="bm_id121691113786345"> +<bookmark 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> @@ -24,7 +24,7 @@ <section id="themecolordialogHead"> <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> + <description id="par_id701691103384432">Creates a color theme for the document.</description> </section> <section id="howtoget"> <embed href="text/shared/00/00000004.xhp#from_menu_bar"/> @@ -36,7 +36,9 @@ <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> + +<embed href="text/shared/01/themesdialog.xhp#theme_ colors_content"/> + <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> diff --git a/source/text/shared/01/themesdialog.xhp b/source/text/shared/01/themesdialog.xhp index 402e9eb22c..fdb0daea39 100644 --- a/source/text/shared/01/themesdialog.xhp +++ b/source/text/shared/01/themesdialog.xhp @@ -24,7 +24,7 @@ </bookmark> <section id="themesHead"> <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> + <description id="par_id601691097282479">Color, font, and formatting settings can be bundled together under the concept of a <emph>Theme</emph>. When you select a theme, all document elements with a theme attribute automatically inherit those settings.</description> </section> <section id="howtoget"> <embed href="text/shared/00/00000004.xhp#from_menu_bar"/> @@ -35,9 +35,20 @@ <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> + <paragraph role="paragraph" id="par_id261691098998130"><emph>Theme colors</emph> consist of a set of twelve base colors, each with five internally calculated variations. These colors are defined solely by their RGB values, and saved to the document file. An object’s color can be assigned by referencing a color from the <emph>Theme colors</emph> set, either by keyword or index, depending on the context. The base color names are</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id801769095750727" role="listitem">Dark 1, Light 1, Dark 2, Light 2,</paragraph> + </listitem> + <listitem> + <paragraph id="par_id551769095774021" role="listitem">Accent 1, Accent 2, Accent 3, Accent 4, Accent 5, Accent 6,</paragraph> + </listitem> + <listitem> + <paragraph id="par_id111769095786860" role="listitem">Hyperlink, FollowedHyperlink</paragraph> + </listitem> + </list> </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> diff --git a/source/text/shared/guide/usingthemes.xhp b/source/text/shared/guide/usingthemes.xhp index 26ead5291b..bdbb31a71b 100644 --- a/source/text/shared/guide/usingthemes.xhp +++ b/source/text/shared/guide/usingthemes.xhp @@ -23,7 +23,16 @@ <section id="usingthemesHead"> <h1 id="hd_id911691103974397"><variable id="h1"><link href="text/shared/guide/usingthemes.xhp">Using Document Themes</link></variable></h1> </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> + <description id="par_id451691109216603">Theme is the concept of bundling color, font and format settings. The colors, fonts and format settings names are fixed in the document. When switching themes in the document, the elements containing the fixed names switch colors, fonts and format settings accordingly to the new theme.</description> + <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 fixed 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> <h2 id="hd_id761691104702168">To Apply a Theme to the Document</h2> <list type="ordered"> <listitem> @@ -33,7 +42,7 @@ <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> + <paragraph role="paragraph" id="par_id91691105048167">All document elements with the fixed 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> @@ -43,7 +52,8 @@ <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> + <paragraph id="par_id191691110090664" role="listitem">On the color area, choose the base color for each of the 12 fixed color names of the theme.</paragraph> + <embed href="text/shared/01/themesdialog.xhp#theme_ colors_content"/> </listitem> <listitem> <paragraph id="par_id811691110231938" role="listitem">Click <widget>OK</widget> to close the color dialog.</paragraph> @@ -52,16 +62,6 @@ <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>
