tdf#137141 update Position and Size help for Textbox and Shape

- add switches because Writer Position and Size tab is
different from other modules
- add Sections for "Anchor" and "Position" in "Type" help page,
so that they can be embedded into "Position and Size" for
the Writer-specific controls
- add "To Frame" control for Writer
- add "Follow text flow" control for Writer
- introduce switch for "Related Topics" in "Position and Size"
because only current topic is "Writer"-specific, and changed
link to a more useful "guide"
- update paragraphs to <h1>, <h2>, <h2>, <note>

Change-Id: I74cb6e9260f7ea1c5aadececaf0ee00c6eef3fbc
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/103653
Reviewed-by: Seth Chaiklin <sdc.blanco@youmail.dk>
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
Tested-by: Jenkins

1 files changed, 30 insertions, 26 deletions

diff --git a/source/text/swriter/01/05060100.xhp b/source/text/swriter/01/05060100.xhp
index fd61edc160..c67c3f03e4 100644
--- a/source/text/swriter/01/05060100.xhp
+++ b/source/text/swriter/01/05060100.xhp
@@ -35,100 +35,104 @@
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/FrameTypePage" id="bm_id3147406" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/SwPosSizePage" id="bm_id3147407" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/@@nowidget@@" id="bm_id3147407" localize="false"/>
-<paragraph role="heading" id="hd_id3151389" xml-lang="en-US" level="1"><link href="text/swriter/01/05060100.xhp" name="Type">Type</link></paragraph>
+<h1 id="hd_id3151389" xml-lang="en-US"><link href="text/swriter/01/05060100.xhp" name="Type">Type</link></h1>
 <paragraph role="paragraph" id="par_id3150568" xml-lang="en-US"><ahelp hid=".">Specifies the size and the position of the selected object or frame on a page.</ahelp></paragraph>
 </section>
 <section id="howtoget">
   <embed href="text/swriter/00/00000405.xhp#grafiktyp"/>
 </section>
-<paragraph role="heading" id="hd_id3147168" xml-lang="en-US" level="2">Size</paragraph>
+<h2 id="hd_id3147168" xml-lang="en-US">Size</h2>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/width" id="bm_id3150761" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/width" id="bm_id9134495" localize="false"/>
-<paragraph role="heading" id="hd_id3147567" xml-lang="en-US" level="3">Width</paragraph>
+<h3 id="hd_id3147567" xml-lang="en-US">Width</h3>
 <paragraph role="paragraph" id="par_id3151180" xml-lang="en-US"><ahelp hid=".">Enter the width that you want for the selected object.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/relwidth" id="bm_id3151177" localize="false"/>
-<paragraph role="heading" id="hd_id3154646" xml-lang="en-US" level="3">Relative</paragraph>
+<h3 id="hd_id3154646" xml-lang="en-US">Relative</h3>
 <paragraph role="paragraph" id="par_id3145413" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmtypepage/relwidth">Calculates the width of the selected object as a percentage of the width of the page text area.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/relwidthrelation" id="bm_id3151178" localize="false"/>
-<paragraph role="heading" id="hd_id3154647" xml-lang="en-US" level="3">Relative width relation</paragraph>
+<h3 id="hd_id3154647" xml-lang="en-US">Relative width relation</h3>
 <paragraph role="paragraph" id="par_id3145414" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmtypepage/relwidthrelation">Decides what 100% width means: either text area (excluding margins) or the entire page (including margins).</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/height" id="bm_id3152948" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/height" id="bm_id9007232" localize="false"/>
-<paragraph role="heading" id="hd_id3147516" xml-lang="en-US" level="3">Height</paragraph>
+<h3 id="hd_id3147516" xml-lang="en-US">Height</h3>
 <paragraph role="paragraph" id="par_id3154099" xml-lang="en-US"><ahelp hid=".">Enter the height that you want for the selected object.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/relheight" id="bm_id3153535" localize="false"/>
-<paragraph role="heading" id="hd_id3149809" xml-lang="en-US" level="3">Relative</paragraph>
+<h3 id="hd_id3149809" xml-lang="en-US">Relative</h3>
 <paragraph role="paragraph" id="par_id3154563" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmtypepage/relheight">Calculates the height of the selected object as a percentage of the height of the page text area.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/relheightrelation" id="bm_id3151179" localize="false"/>
-<paragraph role="heading" id="hd_id3154648" xml-lang="en-US" level="3">Relative height relation</paragraph>
+<h3 id="hd_id3154648" xml-lang="en-US">Relative height relation</h3>
 <paragraph role="paragraph" id="par_id3145415" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmtypepage/relheightrelation">Decides what 100% height means: either text area (excluding margins) or the entire page (including margins).</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/ratio" id="bm_id3153668" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/ratio" id="bm_id7496566" localize="false"/>
-<paragraph role="heading" id="hd_id3151313" xml-lang="en-US" level="3">Keep ratio</paragraph>
+<h3 id="hd_id3151313" xml-lang="en-US">Keep ratio</h3>
 <paragraph role="paragraph" id="par_id3153675" xml-lang="en-US"><ahelp hid=".">Maintains the height and width ratio when you change the width or the height setting.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/origsize" id="bm_id3154482" localize="false"/>
-<paragraph role="heading" id="hd_id3154470" xml-lang="en-US" level="3">Original Size</paragraph>
+<h3 id="hd_id3154470" xml-lang="en-US">Original Size</h3>
 <paragraph role="paragraph" id="par_id3155898" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmtypepage/origsize">Resets the size settings of the selected object to the original values.</ahelp></paragraph>
-<paragraph role="note" id="par_id3149102" xml-lang="en-US">This option is not available for frames.</paragraph>
+<note id="par_id3149102" xml-lang="en-US">This option is not available for frames.</note>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/autoheight" id="bm_id3151255" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/autowidth" id="bm_id358592" localize="false"/>
-<paragraph role="heading" id="hd_id3149824" xml-lang="en-US" level="3">Automatic</paragraph>
+<h3 id="hd_id3149824" xml-lang="en-US">Automatic</h3>
 <paragraph role="paragraph" id="par_id3151262" xml-lang="en-US"><ahelp hid="modules/swriter/ui/frmtypepage/autoheight">Automatically adjusts the width or height of a frame to match the contents of the frame. If you want, you can specify a minimum width or minimum height for the frame.</ahelp></paragraph>
 <paragraph role="note" id="par_id3152773" xml-lang="en-US">The <emph>Automatic</emph> option is only available when you select a frame.</paragraph>
-<paragraph role="heading" id="hd_id3155144" xml-lang="en-US" level="2">Anchor</paragraph>
+<section id="AnchorHelp">
+<h2 id="hd_id3155144" xml-lang="en-US">Anchor</h2>
 <paragraph role="paragraph" id="par_id3153352" xml-lang="en-US">Specify the anchoring options for the selected object or frame. The anchor options are not available when you open the dialog from the Styles window.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/topage" id="bm_id3156280" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/topage" id="bm_id8638874" localize="false"/>
-<paragraph role="heading" id="hd_id3156269" xml-lang="en-US" level="3">To page</paragraph>
+<h3 id="hd_id3156269" xml-lang="en-US">To page</h3>
 <paragraph role="paragraph" id="par_id3149169" xml-lang="en-US"><ahelp hid=".">Anchors the selection to the current page.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/topara" id="bm_id3145771" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/topara" id="bm_id5567796" localize="false"/>
-<paragraph role="heading" id="hd_id3151028" xml-lang="en-US" level="3">To paragraph</paragraph>
+<h3 id="hd_id3151028" xml-lang="en-US">To paragraph</h3>
 <paragraph role="paragraph" id="par_id3145777" xml-lang="en-US"><ahelp hid=".">Anchors the selection to the current paragraph.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/tochar" id="bm_id3151370" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/tochar" id="bm_id89419" localize="false"/>
-<paragraph role="heading" id="hd_id3155913" xml-lang="en-US" level="3">To character</paragraph>
+<h3 id="hd_id3155913" xml-lang="en-US">To character</h3>
 <paragraph role="paragraph" id="par_id3151377" xml-lang="en-US"><ahelp hid=".">Anchors the selection to a character.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/aschar" id="bm_id3155856" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/aschar" id="bm_id2176274" localize="false"/>
-<paragraph role="heading" id="hd_id3150115" xml-lang="en-US" level="3">As character</paragraph>
+<h3 id="hd_id3150115" xml-lang="en-US">As character</h3>
 <paragraph role="paragraph" id="par_id3155863" xml-lang="en-US"><ahelp hid=".">Anchors the selection as character. The height of the current line is resized to match the height of the selection.</ahelp></paragraph>
-<paragraph role="heading" id="hd_id3150693" xml-lang="en-US" level="2">Position</paragraph>
+</section>
+<section id="PositionHelp">
+<h2 id="hd_id3150693" xml-lang="en-US">Position</h2>
 <paragraph role="paragraph" id="par_id3147413" xml-lang="en-US">Specify the location of the selected object on the current page.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/horipos" id="bm_id3147500" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/horipos" id="bm_id2376781" localize="false"/>
-<paragraph role="heading" id="hd_id3147488" xml-lang="en-US" level="3">Horizontal</paragraph>
+<h3 id="hd_id3147488" xml-lang="en-US">Horizontal</h3>
 <paragraph role="paragraph" id="par_id3145121" xml-lang="en-US"><ahelp hid=".">Select the horizontal alignment option for the object.</ahelp> This option is not available if you chose "anchor as character".</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/byhori" id="bm_id3149565" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/byhori" id="bm_id8156682" localize="false"/>
-<paragraph role="heading" id="hd_id3149554" xml-lang="en-US" level="3">by</paragraph>
+<h3 id="hd_id3149554" xml-lang="en-US">by</h3>
 <paragraph role="paragraph" id="par_id3145258" xml-lang="en-US"><ahelp hid=".">Enter the amount of space to leave between the left edge of the selected object and the reference point that you select in the <emph>To</emph> box.</ahelp> This option is only available if you select "From Left" in the <emph>Horizontal</emph> box.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/horianchor" id="bm_id3150556" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/horianchor" id="bm_id3423566" localize="false"/>
-<paragraph role="heading" id="hd_id3150545" xml-lang="en-US" level="3">to</paragraph>
+<h3 id="hd_id3150545" xml-lang="en-US">to</h3>
 <paragraph role="paragraph" id="par_id3149213" xml-lang="en-US"><ahelp hid=".">Select the reference point for the selected horizontal alignment option.</ahelp></paragraph>
 <paragraph role="paragraph" id="par_id3149230" xml-lang="en-US">You can see the result of the alignments options that you select in the Preview box.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/mirror" id="bm_id3146331" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/mirror" id="bm_id1756950" localize="false"/>
-<paragraph role="heading" id="hd_id3147746" xml-lang="en-US" level="3">Mirror on even pages</paragraph>
+<h3 id="hd_id3147746" xml-lang="en-US">Mirror on even pages</h3>
 <paragraph role="paragraph" id="par_id3146337" xml-lang="en-US"><ahelp hid=".">Reverses the current horizontal alignment settings on even pages.</ahelp></paragraph>
 <paragraph role="tip" id="par_id3148446" xml-lang="en-US">You can also use the <link href="text/swriter/01/05060300.xhp" name="Image"><emph>Image</emph></link> flip options to adjust the layout of objects on even and odd pages.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/vertpos" id="bm_id3145321" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/vertpos" id="bm_id7322305" localize="false"/>
-<paragraph role="heading" id="hd_id3145310" xml-lang="en-US" level="3">Vertical</paragraph>
+<h3 id="hd_id3145310" xml-lang="en-US">Vertical</h3>
 <paragraph role="paragraph" id="par_id3150161" xml-lang="en-US"><ahelp hid=".">Select the vertical alignment option for the object.</ahelp></paragraph>
 <paragraph role="note" id="par_id3150463" xml-lang="en-US">If you anchor an object to a frame with a fixed height, only the "Bottom" and "Center" alignment options are available.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/byvert" id="bm_id3156123" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/byvert" id="bm_id8157292" localize="false"/>
-<paragraph role="heading" id="hd_id3154724" xml-lang="en-US" level="3">by</paragraph>
+<h3 id="hd_id3154724" xml-lang="en-US">by</h3>
 <paragraph role="paragraph" id="par_id3156130" xml-lang="en-US"><ahelp hid=".">Enter the amount of space to leave between the top edge of the selected object and the reference point that you select in the <emph>To</emph> box.</ahelp> This option is only available if you select "From Top" or "From Bottom" (as character) in the <emph>Vertical</emph> box. </paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/vertanchor" id="bm_id3150923" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/vertanchor" id="bm_id1466719" localize="false"/>
-<paragraph role="heading" id="hd_id3150912" xml-lang="en-US" level="3">to</paragraph>
+<h3 id="hd_id3150912" xml-lang="en-US">to</h3>
 <paragraph role="paragraph" id="par_id3155075" xml-lang="en-US"><ahelp hid=".">Select the reference point for the selected vertical alignment option.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/modules/swriter/ui/frmtypepage/followtextflow" id="bm_id611285" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/swpossizepage/followtextflow" id="bm_id4516434" localize="false"/>
-<paragraph role="heading" id="par_idN10A8E" xml-lang="en-US" level="3">Keep inside text boundaries</paragraph>
+</section>
+<h3 id="par_idN10A8E" xml-lang="en-US">Keep inside text boundaries</h3>
 <paragraph role="paragraph" id="par_idN10A92" xml-lang="en-US"><ahelp hid=".">Keeps the selected object within the layout boundaries of the text that the object is anchored to. To place the selected object anywhere in your document, do not select this option.</ahelp></paragraph>
 <paragraph role="paragraph" id="par_idN10AA6" xml-lang="en-US">By default, the <emph>Keep inside text boundaries</emph> option is selected when you open a document that was created in a version of Writer older than OpenOffice.org 2.0. However, this option is not selected when you create a document or when you open a document in Microsoft Word format (*.doc).</paragraph>
 <embed href="text/shared/00/00000001.xhp#vorschau"/>