[Libreoffice-bugs] [Bug 112863] New: [NEWHELP] Convert New Help bash script builder to python.

[bugzilla-daemon at bugs.documentfoundation.org]

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 at lists.freedesktop.org
          Reporter: olivier.hallot at documentfoundation.org
                CC: olivier.hallot at 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.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.freedesktop.org/archives/libreoffice-bugs/attachments/20171003/64fc466d/attachment.html>