Date: prev next · Thread: first prev next last
2020 Archives by date, by thread · List index

Hi Mario

We are now using the system browser to display the Help pages. We don't
use the native Help module (writer-web) anymore, it is deprecated.

The system browser displays html pages transformed at build time from
XHP. The transformation is online_transform.xsl.

We also have extended XHP to handle more simple tags. The extended xhp
is not backward compatible with LO release before 6.0

We developed an editor for xhp at the following address

please be indulgent, it is work in progress, but it can speed-up a lot
of the editing, the text editor is Codemirror. Instructions are in the page

I was not aware of Mallard. It seems to address the same objetive. I
have not seen in Mallard: how to address translations and if there is a
WYSIWYG editor.


Em 11/06/2020 15:42, mario escreveu:
So, I went on this ditzy sidequest of writing some help pages for an UNO
plugin. Like most extension authors, I didn't feel enticed by XHP
initially; and went with Mallard here.
Now I'm wondering if the LO helpviewer can be made to recognize an
embedded stylesheet reference:

  <?xml-stylesheet href="./mallard2xhp.xsl" type="text/xsl"?>
Haven't really looked this up, but I'd assume it strips out any such PIs
in favour of main_transform.xsl. Or libxslt discards it by itself when
fed an override?
Or is it just due to the relative path? (Is %origin%/… supposed to work
in this context?)

Else, couldn't the helpviewer support more than one file type? As in
preconvert *.page files itself? The formats are close enough for some
crude mapping:
Fully converting <link> to <bookmark> absolute path references would
be a bit more involving, of course. But doesn't seem totally infeasible.
(Crossposting to @projectmallard, to lure some feedback.)

Presumably there's zero demand to migrate the Open/LibreOffice help
system at large. But you know, the documentation prevalence among
extensions is a bit lower. Not sure if it's just me, or if any such
effort would be warranted there.

Olivier Hallot
LibreOffice Documentation Coordinator
Comunidade LibreOffice
Rio de Janeiro - Brasil - Local Time: UTC-03:00

To unsubscribe e-mail to:
Posting guidelines + more:
List archive:
Privacy Policy:


Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.