Bug 112863 - [NEWHELP] Convert New Help bash script builder to python.
Summary: [NEWHELP] Convert New Help bash script builder to python.
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
(earliest affected)
Hardware: All All
: medium normal
Assignee: Not Assigned
Keywords: easyHack, skillPython, topicCleanup
Depends on:
Blocks: New-Help
  Show dependency treegraph
Reported: 2017-10-03 17:57 UTC by Olivier Hallot
Modified: 2017-12-16 13:07 UTC (History)
3 users (show)

See Also:
Crash report or crash signature:


Note You need to log in before you can comment on or make changes to this bug.
Description Olivier Hallot 2017-10-03 17:57:50 UTC
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.
Comment 1 Olivier Hallot 2017-12-16 13:07:46 UTC
Scripts will move to gbuild .