summaryrefslogtreecommitdiff
path: root/README.help.md
blob: 542cabf61dd88b89e0d7b81812a7d1da7437e81e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
# LibreOffice help build

LibreOffice can build three kinds of help output from helpcontent2:

* XML (local, bundled with LibreOffice < 6.0)
* HTML (local, bundled with LibreOffice >= 6.0)
* HTML (online)

Both local help variants can be included in help-packs, which might be bundled
with the installer or provided as separate packages. They are supposed to be
installed by a user to provide localized help. Both HTML-based help types are
displayed in a browser, while the XML help uses an internal viewer component.

The XML help is the only one supported in extensions.

## configure options

--with-help: selects the help type to build
--with-omindex: prepares the online help for a Xapian Omega based search index
--disable-xmlhelp: removes support for the XML help
--with-helppack-integration: includes the help-packs in the installer

Also see `configure --help`.

## XML help, bundled

This type was bundled per-default until LibreOffice 6.0.

This help output is generated by using two tools: HelpIndexer and HelpLinker.
It uses an internal viewer component. Extensions still use this help type to
ship their help. This output is originally based on JavaDoc.

The main support for this help type is in the following directories:

* helpcompiler: tooling and support library
* xmlhelp: the viewer component
* desktop/source/deployment/registry/help: extensions / help-pack support

Most code is "marked" by HAVE_FEATURE_XMLHELP precompiler blocks or conditioned
by the XMLHELP flag in the $BUILD_TYPE variable.

Interestingly the HelpIndexer and HelpLinker are used by gbuild to build the
help inside bundled extensions, but both are not part of the LibreOffice SDK.

## HTML help, bundled

This type is bundled per-default since LibreOffice 6.0 and displayed in a
browser.

## HTML help, online

This help is the external one, currently provided by help.libreoffice.org. It
differs from the bundled HTML help in three main aspects:

* has a language chooser widget
* provides an additional Xapian Omega, CGI- / server-based search index
* includes some additional multimedia assets

It is opened in a browser.