https://bugs.documentfoundation.org/show_bug.cgi?id=112863
Bug ID: 112863
Summary: [NEWHELP] Convert New Help bash script builder to
python.
Product: LibreOffice
Version: 6.0.0.0.alpha0+ Master
Hardware: All
OS: All
Status: UNCONFIRMED
Severity: normal
Priority: medium
Component: Documentation
Assignee: libreoffice-bugs@lists.freedesktop.org
Reporter: olivier.hal...@documentfoundation.org
CC: olivier.hal...@documentfoundation.org
Blocks: 97629
The current New Help (html help) builder is convert2html.sh, a bash script in
helpcontend/help3xl/
The python script should do the same, be cleaner and more professional.
1) convert all existing translated xhp files in
/workdir/HelpTranslatePartTarget/ into HTML files, applying
online_transform.xsl with xsltproc + parameters
2) convert translated tree files in /workdir/HelpTreeTarget/ into a javascript
file named contents.js, applying get_tree.xsl with xsltproc
3) generate the bookmark file bookmark.js with the python equivalent of
get_bookmark.sh, applying get_bookmark.xsl with xsltproc.
4) place resulting files in /workdir/HelpHTMLTarget/ (this folder does not
exist).
5) place service files like default.css, help.html, help.js, index.html,
normalize.css, etc in the right place
6) place source/media/ files in the right place
7) file organization is /{productversion}/{language}/text/{path/to/html/file}
e.g. /6.0/fr/text/shared/main0108.html
8) add an option to the makefiles (--with-html-help) to integrate in build
process.
Note: En-US does not exist in /workdir/HelpTranslatePartTarget/ , thus it is a
special case.
To test: you browser should open the html file and be able to navigate the
internal links.
Referenced Bugs:
https://bugs.documentfoundation.org/show_bug.cgi?id=97629
[Bug 97629] [META] Help Content Modernization
--
You are receiving this mail because:
You are the assignee for the bug._______________________________________________
Libreoffice-bugs mailing list
Libreoffice-bugs@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-bugs
