Documentation/New Help Content

This page will describe the steps to create new articles or modify existing ones in the offline and online help of LibreOffice, in its new presentation mode, with a modern browser.

Help files are in .xhp file format, they are xml files which, inside LibreOffice, are transformed in HTML file format. Therefore they will contain all the information necessary to this transformation. LibreOffice is not a xml editor, styles and other elements are used to match the xml tags.

Retrieve the help files
Help files are on LibreOffice GIT repository. Therefore you need to have a git environment installed on your computer. Command to retrieve the files

The files you will need in a first time are located in the source/text directory

Editing the files
Use your preferred text editor with support for UTF-8.


 * For Linux systems: vim, Kate, Gedit, etc...
 * For Windows systems: Notepad++

=TODO: Review / fix below=

Opening/Saving

 * Opening
 * To open a help file, in the Help Authoring menu, choose or select the 'help' file type in the file picker under  and navigate to the .xhp file you want to work on.
 * The document opens in Writer. Some information are not displayed like the par_id but are noted with a small yellow mark. It is mandatory to use the styles provided by the template, any other style will be ignore when the file will be parsed.


 * Saving
 * When, saving the document, a check of the file is run. It doesn't check the syntax extensively, but make sure that there is no empty paragraph or that id are added.

Help Authoring menu
Menu Help Authoring localize="false" - which appears as par_id0202201317491162_NOL10N in the document my comment here  Insert;Name &lt;VAR ID="newvariable">
 * creates a new .xhp file based on the template. If the template is not found, the file can't be created and an error message is displayed.
 * : displays the version number of the extension
 * : selects the document as root file
 * : gives a title to the help file or leaves a comment. The Indexing button includes or ignores the file when running a search
 * : runs some checks on the xml structure of the file
 * : sets the localize attribute on false:
 * : adds an ID identifier to the paragraph
 * : adds a comment in the file
 * : inserts a table in the document
 * : inserts a link to another file
 * : inserts a bookmark branch tag of the type
 * : inserts tags marking an index entry
 * : insert tags marking extended tips. The dialog box asks whether they are hidden. If you answer by YES, it will appear in the UI but not in the help.
 * : inserts a section named How To Get
 * : inserts a link to a picture
 * : inserts a section which name is the name of the section
 * : inserts a variable, the dialog box names it
 * : incorporates another existing paragraph
 * : inserts a 'Related Topics' section that links to other help articles. Usually placed at the end of the page.

Unused/Ignored Tags and Attributes
If you are editing the .xhp help files in a text editor, the following tags and attributes are ignored.


 * The tag found in the tag
 * The l10n and oldref attributes of the tag.
 * The tag within the tag
 * The width and height attributes of the tag.
 * The status attribute of the tag.

Make Images Appear
Images shown in Help are found within LibreOffice's icon theme files and in order to get them to appear within the authoring tool, you would need to create a symbolic link between the helpauthoring tool's assumed location of images (i.e. [help repo base path]/../default_images) and a folder that contains the galaxy icon theme. The galaxy icon theme folder can either be through having a copy of the LibreOffice core git repo (found in icon-themes/galaxy/) or alternatively by grabbing the galaxy icon theme zip file that comes with an installation of LibreOffice (e.g. /opt/libreoffice/share/config/images_galaxy.zip, C:\Program Files\LibreOffice\share\config\images_galaxy.zip) and extracting it into a folder.

Here is the Linux command to create the symbolic link with the core git repo if the help repo was located at ~/help

If the help repo is located in the helpcontent2 folder of the LibreOffice core repo, then use this command to create the symbolic link if the core repo is located at ~/core

Test Changes in LibreOffice Help Viewer
It is possible to view the changes you make to the xhp help files within LibreOffice help viewer's, which is accessible by pressing or.

Without the LibreOffice Core Repo
On Linux, open the script found at  and modify the last line to point to the folder in your LibreOffice installation that contains the help files (it normally ends in  ). Once modified, execute the script in the terminal and it will create the necessary packaged .jar help files and move them into the defined folder. If the script isnt modified, the .jar files will be left in the  folder and you can manually copy them to the LibreOffice help folder.

With the LibreOffice Core Repo
If you have the LibreOffice core repo, it has a blank helpcontent2 folder which you should put the LibreOffice help repo in, and with the help repo in that folder, you can run the  command and it will build the help files in , so that you can test them within your built version of LibreOffice.