Documentation/Help page description

We comment the contents of the LibreOffice Help file located in https://opengrok.libreoffice.org/xref/help/source/text/swriter/01/04020100.xhp

Header of the file
 

The header of the file is constant and should not be changed.

The meta tags
 Section /text/swriter/01/04020100.xhp
 * topic
 * id: any string. Usually we combine some form of mnemonic string
 * indexer: keep "include"
 * status: Keep "PUBLISH"
 * title
 * xml-lang: always en-US
 * id: any string unique in the file
 * filename: full file name qualifier similar to the example

The body, sections and bookmarks
 sections;inserting sections by DDE DDE; command for inserting sections      Section <ahelp hid=".">Sets the properties of the section.
 * body: identical to body in HTML
 * section: used here to wrap the contents into a container with name given by its id= attribute.
 * bookmark, branch="index": indicates that the following bookmark_values are keywords for the LibreOffice Help index.
 * bookmark_values: keywords or pairs or keywords (level1;level2) for the LibreOffice Help index.
 * bookmark, branch="hid/....": Sets the entry point to display the Help page. The string "hid/..." is defined in the software and is mapped to this help file when you press F1 or the help button in a dialog.
 * paragraph
 * id: must be UNIQUE in the file.
 * role: role of the paragraph. heading, paragraph, note, warning, tip, bascode, and more...
 * level: combined with role="heading", sets the H1... H6 heading levels.
 * xml-lang: keep always en-US.

The contents
The contents may include paragraphs, tables, section, objects, images, embedded contents, embedded variables, switches and more. <paragraph role="paragraph" id="par_id171534888116942" xml-lang="en-US">%PRODUCTNAME Help pages are displayed in your system default web browser. <embed href="text/shared/05/00000100.xhp#neuehilfe"/> <paragraph xml-lang="en-US" id="par_id3156183" role="warning">The Help system for all versions of the software is based on the same source files. Some of the functions described in Help may not be included in this particular distribution. Some features specific to a distribution may not be mentioned in this Help. (...) (...)
 * paragraph role="paragraph": a normal paragraph
 * id: An UNIQUE id for the paragraph within the file. This uniqueness ensure a perfect one-to-one link with the translated content of the translation process used in LibreOffice.
 * embed: this tag insert a piece of contents located in another file. When used correctly, it prevents repeated contents and spares translation work.

Predefined Sections
Some sections are predefined (special id), and will be transformed with special settings.

How to get
This section describes the actions to get the resource to work. Can be a menu path, a icon to press or a mouse click. This section is usually placed in the beginning of the description text. <embed href="text/swriter/00/00000404.xhp#bereicheinbereich"/>

Related topic
Usually placed in the bottom of the page, indicates further reading on the topic, as links for external or internal web pages. <paragraph role="paragraph" id="par_id3150032" xml-lang="en-US"><link href="text/swriter/01/04090000.xhp" name="Field commands">Field commands <paragraph role="paragraph" id="par_id3158420" xml-lang="en-US"><link href="text/swriter/01/04090200.xhp" name="Syntax for conditions">Syntax for conditions