AllLangHelp_swriter.mk | 1
source/text/swriter/01/style_inspector.xhp | 92 +++++++++++++++++++++++++++++
2 files changed, 93 insertions(+)
New commits:
commit 9bcc5f53bd012afc91b7c86cd0779d179f93ab71
Author: Olivier Hallot <olivier.hal...@libreoffice.org>
AuthorDate: Tue Jan 4 20:56:48 2022 -0300
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Thu Jan 6 11:31:08 2022 +0100
tdf#135175 Styles Inspector Help page
+ Borrowed contents from Jean Weber and Shivam Kumar
+ Added more descriptive examples
Change-Id: Ie045498e5c0239686f20f4fe55b40067c4bb893c
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/127978
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
diff --git a/AllLangHelp_swriter.mk b/AllLangHelp_swriter.mk
index 40dd86a91..2ac115c02 100644
--- a/AllLangHelp_swriter.mk
+++ b/AllLangHelp_swriter.mk
@@ -203,6 +203,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,swriter,\
helpcontent2/source/text/swriter/01/protectdocument \
helpcontent2/source/text/swriter/01/selection_mode \
helpcontent2/source/text/swriter/01/show_whitespace \
+ helpcontent2/source/text/swriter/01/style_inspector \
helpcontent2/source/text/swriter/01/title_page \
helpcontent2/source/text/swriter/01/watermark \
helpcontent2/source/text/swriter/02/02110000 \
diff --git a/source/text/swriter/01/style_inspector.xhp
b/source/text/swriter/01/style_inspector.xhp
new file mode 100644
index 000000000..713b72c4b
--- /dev/null
+++ b/source/text/swriter/01/style_inspector.xhp
@@ -0,0 +1,92 @@
+<?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="stylesinspector" indexer="include" status="PUBLISH">
+ <title id="tit" xml-lang="en-US">Style Inspector</title>
+ <filename>/text/swriter/01/style_inspector.xhp</filename>
+ </topic>
+ </meta>
+ <body>
+ <bookmark xml-lang="en-US"
branch="hid/svx/ui/inspectortextpanel/@@nowidget@@" id="bm_id361641339217672"
localize="false"/>
+ <bookmark xml-lang="en-US" branch="index" id="bm_id441641339111122">
+<bookmark_value>styles;inspector</bookmark_value>
+<bookmark_value>style inspector</bookmark_value>
+ </bookmark>
+ <section id="styleinspectorhead">
+ <h1 id="hd_id741641334466741"><link
href="text/swriter/01/style_inspector.xhp" name="Style Inspector">Style
Inspector</link></h1>
+ <paragraph id="par_id971641334466743" role="paragraph"
xml-lang="en-US"><variable id="StyleInspector">The Style Inspector is located
on the Sidebar. It displays all the attributes of the styles (paragraph and
character) and any direct formatting present in the paragraph and character
where the cursor is located. These details can be useful when you are trying to
figure out why some formatting in a document appears to be incorrect or
inconsistent.</variable></paragraph>
+ </section>
+ <embed href="text/shared/00/00000005.xhp#Section7"/>
+ <section id="howtoget">
+ <paragraph role="paragraph" id="par_id521641338705733">Open the
sidebar, click on the Style Inspector icon</paragraph>
+ <table id="tab_id961641335152917">
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id431641335152917" role="paragraph">
+ <image src="cmd/lc_inspectordeck.svg"
id="img_id661641335152918" width="1cm" height="1cm"><alt xml-lang="en-US"
id="alt_id61641335152918">Icon Style Inspector</alt></image>
+ </paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id721641335152918" role="paragraph"
xml-lang="en-US">Icon Style Inspector on the Sidebar</paragraph>
+ </tablecell>
+ </tablerow>
+ </table>
+ <paragraph role="paragraph" id="par_id781641335609033">Press
<switchinline select="sys"><caseinline
select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline><keycode>+Alt+5</keycode><keycode></keycode></paragraph>
+ </section>
+ <h2 id="hd_id941641336331359">The Style Inspector Panel</h2>
+ <h3 id="hd_id771641336335666">Properties</h3>
+ <paragraph role="paragraph" id="par_id1001641336347665"><emph>Paragraph
Styles</emph>: shows the list of the paragraph styles applied to the text at
the cursor position, following the style hierarchy, where the parent style
comes above any child style.</paragraph>
+
+ <paragraph role="paragraph" id="par_id981641336364074"><emph>Paragraph
direct formatting</emph>: shows the list of paragraph properties which are set
directly to the text at the cursor location.</paragraph>
+
+ <paragraph role="paragraph" id="par_id961641336357072"><emph>Character
Styles</emph>: shows the list of the character styles applied to the text at
the cursor, following hierarchy, where the parent style comes above any child
style.</paragraph>
+
+ <paragraph role="paragraph" id="par_id981641336364073"><emph>Character
direct formatting</emph>: shows the list of character properties which are set
directly to the text at the cursor location.</paragraph>
+
+ <h3 id="hd_id301641336416253">Values</h3>
+ <paragraph role="paragraph" id="par_id251641336411569">Display the values
of the properties.</paragraph>
+ <h2 id="hd_id491641337715424">Usage</h2>
+ <paragraph role="paragraph" id="par_id821641421059397">Use the Style
Inspector to uncover formatting issues in your text document.</paragraph>
+ <list type="unordered">
+ <listitem>
+ <paragraph id="par_id991641421123640" role="listitem">Style
properties overwritten by direct formatting are greyed out in the Paragraph and
Character style tree, indicating that the style property is not effective
anymore.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id841641421139731" role="listitem">Paragraph
style properties that are re-defined by a child paragraph style are greyed
out.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id31641421150849" role="listitem">Character
style properties that are re-defined by a child character style are greyed
out.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id911641421185601" role="listitem">Paragraph
style and direct properties that are re-defined by character styles or
character direct properties are greyed.</paragraph>
+ </listitem>
+ </list>
+ <paragraph role="paragraph" id="par_id621641337772747">For example, if the
margins of the paragraph are changed by direct formatting using the rulers, the
margins property of the paragraph style are greyed out and the margins
properties are displayed in the Paragraph Direct Formatting entry of the Style
Inspector.</paragraph>
+
+ <paragraph role="paragraph" id="par_id771641378992460">Another example, if
the <emph>Emphasis</emph> character style highlights a word with a yellow
background, and the user mistakenly overwrote it by using a white background,
the <literal>yellow</literal> attribute would be greyed-out and
<literal>white</literal> is listed under Direct Formatting in the Style
Inspector. The Style Inspector shows only those attributes that diverge from
the parent (which is usually the Default Paragraph Style).</paragraph>
+
+ <paragraph role="paragraph" id="par_id101641338214488">Some features of
the Style Inspector are of interest mainly to advanced users:</paragraph>
+ <list type="unordered">
+ <listitem>
+ <paragraph id="par_id281641338268000" role="listitem">The Style
Inspector can show any hidden RDF (Resource Description Framework, a W3C
standard) metadata at the cursor position associated with text spans,
paragraphs, and bookmarks. For annotated text spans, “Nested Text Content” item
can show the boundary of the nested annotated text ranges and metadata
fields.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id531641338286704" role="listitem">Custom
color metadata field shadings can be set for an annotated text range or a
metadata field, for visualization of metadata categories in the document
editor. Use <menuitem>View - Field Shadings</menuitem> or press <switchinline
select="sys"><caseinline
select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline><keycode>+F8</keycode>
to disable or enable these field shadings.</paragraph>
+ </listitem>
+ </list>
+ <section id="relatedtopics">
+ <paragraph role="paragraph" id="par_id261641340112608"><link
href="https://wiki.documentfoundation.org/ReleaseNotes/7.1#Style_inspector";
name="rel71">Release notes for Style Inspector</link></paragraph>
+ <paragraph role="paragraph" id="par_id601641340196019"><link
href="https://wiki.documentfoundation.org/ReleaseNotes/7.2#RDF_metadata_in_Style_Inspector";
name="rdfmetadata">RDF Metadata in Style Inspector</link></paragraph>
+ <paragraph role="paragraph" id="par_id731641340265093"><link
href="https://wiki.documentfoundation.org/ReleaseNotes/7.2#Custom_color_metadata_field_shadings";
name="customcolormetadata">Custom color metadata</link> </paragraph>
+ </section>
+</body>
+</helpdocument>
