<html>
<head>
<base href="https://bugs.documentfoundation.org/">
</head>
<body><table border="1" cellspacing="0" cellpadding="8">
<tr>
<th>Bug ID</th>
<td><a class="bz_bug_link
bz_status_UNCONFIRMED "
title="UNCONFIRMED - [NEWHELP] Convert New Help bash script builder to python."
href="https://bugs.documentfoundation.org/show_bug.cgi?id=112863">112863</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>[NEWHELP] Convert New Help bash script builder to python.
</td>
</tr>
<tr>
<th>Product</th>
<td>LibreOffice
</td>
</tr>
<tr>
<th>Version</th>
<td>6.0.0.0.alpha0+ Master
</td>
</tr>
<tr>
<th>Hardware</th>
<td>All
</td>
</tr>
<tr>
<th>OS</th>
<td>All
</td>
</tr>
<tr>
<th>Status</th>
<td>UNCONFIRMED
</td>
</tr>
<tr>
<th>Severity</th>
<td>normal
</td>
</tr>
<tr>
<th>Priority</th>
<td>medium
</td>
</tr>
<tr>
<th>Component</th>
<td>Documentation
</td>
</tr>
<tr>
<th>Assignee</th>
<td>libreoffice-bugs@lists.freedesktop.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>olivier.hallot@documentfoundation.org
</td>
</tr>
<tr>
<th>CC</th>
<td>olivier.hallot@documentfoundation.org
</td>
</tr>
<tr>
<th>Blocks</th>
<td>97629
</td>
</tr></table>
<p>
<div>
<pre>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.</pre>
</div>
</p>
<div id="referenced">
<hr style="border: 1px dashed #969696">
<b>Referenced Bugs:</b>
<ul>
<li>
[<a class="bz_bug_link
bz_status_NEW "
title="NEW - [META] Help Content Modernization"
href="https://bugs.documentfoundation.org/show_bug.cgi?id=97629">Bug 97629</a>] [META] Help Content Modernization
</li>
</ul>
</div>
<br>
<hr>
<span>You are receiving this mail because:</span>
<ul>
<li>You are the assignee for the bug.</li>
</ul>
</body>
</html>