Skip to content

Commit

Permalink
tdf#162504 Add help page for Design sidebar deck
Browse files Browse the repository at this point in the history
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 <[email protected]>
Tested-by: Jenkins
  • Loading branch information
twistappel authored and Olivier Hallot committed Nov 12, 2024
1 parent 8273b9c commit e9d4aba
Show file tree
Hide file tree
Showing 4 changed files with 154 additions and 26 deletions.
1 change: 1 addition & 0 deletions AllLangHelp_swriter.mk
Original file line number Diff line number Diff line change
Expand Up @@ -203,6 +203,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,swriter,\
helpcontent2/source/text/swriter/01/select_text \
helpcontent2/source/text/swriter/01/show_whitespace \
helpcontent2/source/text/swriter/01/sidebar_comments \
helpcontent2/source/text/swriter/01/sidebar_design \
helpcontent2/source/text/swriter/01/sidebar_quickfind \
helpcontent2/source/text/swriter/01/SpotlightMenu \
helpcontent2/source/text/swriter/01/SpotlightCharStyles \
Expand Down
63 changes: 44 additions & 19 deletions source/text/shared/01/05210200.xhp
Original file line number Diff line number Diff line change
Expand Up @@ -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">
Expand Down
26 changes: 19 additions & 7 deletions source/text/shared/01/themesdialog.xhp
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down
90 changes: 90 additions & 0 deletions source/text/swriter/01/sidebar_design.xhp
Original file line number Diff line number Diff line change
@@ -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>

0 comments on commit e9d4aba

Please sign in to comment.