<html>
<body>
<div style="font-family: Verdana, Arial, Helvetica, Sans-Serif;">
<table bgcolor="#f9f3c9" width="100%" cellpadding="12" style="border: 1px #c9c399 solid; border-radius: 6px; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tr>
<td>
This is an automatically generated e-mail. To reply, visit:
<a href="https://git.reviewboard.kde.org/r/128213/">https://git.reviewboard.kde.org/r/128213/</a>
</td>
</tr>
</table>
<br />
<blockquote style="margin-left: 1em; border-left: 2px solid #d0d0d0; padding-left: 10px;">
<p style="margin-top: 0;">On June 17th, 2016, 1:14 a.m. UTC, <b>Michael Pyne</b> wrote:</p>
<blockquote style="margin-left: 1em; border-left: 2px solid #d0d0d0; padding-left: 10px;">
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;"><p style="padding: 0;text-rendering: inherit;margin: 0;line-height: inherit;white-space: inherit;">Regarding the alternative stylesheets, I don't think that's possible. However I've been able to approximate the effect. The KDE Docbook stylesheets use a '<code style="text-rendering: inherit;color: #4444cc;padding: 0;white-space: normal;margin: 0;line-height: inherit;">kde.common</code>' parameter as the base URL for the HTML resources. While it defaults to using kio_help, you can point it to a separate directory (which should contains the contents of "$(kf5-config --install data)/doc/HTML/$LANG/kdoctools5-common").</p>
<p style="padding: 0;text-rendering: inherit;margin: 0;line-height: inherit;white-space: inherit;">You would then use the <code style="text-rendering: inherit;color: #4444cc;padding: 0;white-space: normal;margin: 0;line-height: inherit;">--param</code> option to <code style="text-rendering: inherit;color: #4444cc;padding: 0;white-space: normal;margin: 0;line-height: inherit;">meinproc5</code> to set <code style="text-rendering: inherit;color: #4444cc;padding: 0;white-space: normal;margin: 0;line-height: inherit;">kde.common</code>. Here's the script I used to use to build kdesrc-build docs (before simply sending users to the docs.kde.org docs). You might experiment with stylesheets other than kde-chunk-online.xsl:</p>
<p style="padding: 0;text-rendering: inherit;margin: 0;line-height: inherit;white-space: inherit;"><table class="codehilitetable"><tr><td><div class="linenodiv" style="background-color: #f0f0f0; padding-right: 10px"><pre style="line-height: 125%"> 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24</pre></div></td><td class="code"><div class="codehilite" style="background: #f8f8f8"><pre style="line-height: 125%"><span style="color: #408080; font-style: italic">#!/bin/sh</span>
<span style="color: #408080; font-style: italic"># build-docs</span>
<span style="color: #408080; font-style: italic"># We need to run this from right directory, i.e. the director we want generated</span>
<span style="color: #408080; font-style: italic"># output to go to.</span>
<span style="color: #19177C">PATH_TO_DOCS</span><span style="color: #666666">=</span><span style="color: #BA2121">"../doc/index.docbook"</span>
<span style="color: #19177C">COMMON_DIR</span><span style="color: #666666">=</span><span style="color: #BA2121">"kdoctools5-common"</span>
<span style="color: #19177C">COMMON_FILES</span><span style="color: #666666">=</span><span style="color: #008000; font-weight: bold">$(</span><span style="color: #008000">printf</span> <span style="color: #BA2121">"'%s/'"</span> <span style="color: #BA2121">"</span><span style="color: #19177C">$COMMON_DIR</span><span style="color: #BA2121">"</span><span style="color: #008000; font-weight: bold">)</span> <span style="color: #408080; font-style: italic"># The single quotes are exceedingly important</span>
<span style="color: #19177C">DATA_DIR</span><span style="color: #666666">=</span><span style="color: #008000; font-weight: bold">$(</span>kf5-config --install data<span style="color: #008000; font-weight: bold">)</span>
<span style="color: #19177C">DATA_DIR</span><span style="color: #666666">=</span><span style="color: #BB6688; font-weight: bold">${</span><span style="color: #19177C">DATA_DIR</span>%/<span style="color: #BB6688; font-weight: bold">}</span> <span style="color: #408080; font-style: italic"># Remove trailing /</span>
<span style="color: #19177C">DOC_SRCDIR</span><span style="color: #666666">=</span><span style="color: #BA2121">"</span><span style="color: #19177C">$DATA_DIR</span><span style="color: #BA2121">/kf5/kdoctools"</span>
<span style="color: #19177C">XSLT</span><span style="color: #666666">=</span><span style="color: #BA2121">"</span><span style="color: #19177C">$DOC_SRCDIR</span><span style="color: #BA2121">/customization/kde-chunk-online.xsl"</span>
<span style="color: #008000; font-weight: bold">if</span> <span style="color: #666666">[</span> ! -e <span style="color: #BA2121">"</span><span style="color: #19177C">$COMMON_DIR</span><span style="color: #BA2121">"</span> <span style="color: #666666">]</span>; <span style="color: #008000; font-weight: bold">then</span>
ln -s <span style="color: #BA2121">"</span><span style="color: #19177C">$DATA_DIR</span><span style="color: #BA2121">/doc/HTML/en/</span><span style="color: #19177C">$COMMON_DIR</span><span style="color: #BA2121">"</span> .
<span style="color: #008000; font-weight: bold">fi</span>
meinproc5 --srcdir <span style="color: #BA2121">"</span><span style="color: #19177C">$DOC_SRCDIR</span><span style="color: #BA2121">"</span> <span style="color: #BB6622; font-weight: bold">\</span>
--param kde.common<span style="color: #666666">=</span><span style="color: #BA2121">"</span><span style="color: #19177C">$COMMON_FILES</span><span style="color: #BA2121">"</span> <span style="color: #BB6622; font-weight: bold">\</span>
--stylesheet <span style="color: #BA2121">"</span><span style="color: #19177C">$XSLT</span><span style="color: #BA2121">"</span> <span style="color: #BB6622; font-weight: bold">\</span>
<span style="color: #BA2121">"</span><span style="color: #19177C">$PATH_TO_DOCS</span><span style="color: #BA2121">"</span>
</pre></div>
</td></tr></table></p></pre>
</blockquote>
<p>On June 18th, 2016, 10:49 a.m. UTC, <b>Christoph Cullmann</b> wrote:</p>
<blockquote style="margin-left: 1em; border-left: 2px solid #d0d0d0; padding-left: 10px;">
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;"><p style="padding: 0;text-rendering: inherit;margin: 0;line-height: inherit;white-space: inherit;">Thanks for the information, need to take a look at this then.</p></pre>
</blockquote>
<p>On June 18th, 2016, 10:12 p.m. UTC, <b>Luigi Toscano</b> wrote:</p>
<blockquote style="margin-left: 1em; border-left: 2px solid #d0d0d0; padding-left: 10px;">
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;"><p style="padding: 0;text-rendering: inherit;margin: 0;line-height: inherit;white-space: inherit;">Sorry, I couldn't properly check the patch yet. About your question, kde-web.xsl and kde-chunk-online.xsl are examples of stylesheets that can be used for standalone documents. The one used on docs.kde.org is a variation of kde-chunk-online.xsl (see its repository).</p></pre>
</blockquote>
</blockquote>
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;"><p style="padding: 0;text-rendering: inherit;margin: 0;line-height: inherit;white-space: inherit;">No problem.
My goal would be to have some "standalone" html docs generated for windows & mac with that switch which then can be distributed and just opened with the system browser as replacement of khelpcenter on that platforms.</p></pre>
<br />
<p>- Christoph</p>
<br />
<p>On June 16th, 2016, 4:43 p.m. UTC, Christoph Cullmann wrote:</p>
<table bgcolor="#fefadf" width="100%" cellspacing="0" cellpadding="12" style="border: 1px #888a85 solid; border-radius: 6px; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tr>
<td>
<div>Review request for KDE Frameworks and Luigi Toscano.</div>
<div>By Christoph Cullmann.</div>
<p style="color: grey;"><i>Updated June 16, 2016, 4:43 p.m.</i></p>
<div style="margin-top: 1.5em;">
<b style="color: #575012; font-size: 10pt;">Repository: </b>
kdoctools
</div>
<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Description </h1>
<table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" style="border: 1px solid #b8b5a0">
<tr>
<td>
<pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;"><p style="padding: 0;text-rendering: inherit;margin: 0;line-height: inherit;white-space: inherit;">Fix the optional HTML documentation generation (which I would like to use for Windows/Mac)</p>
<p style="padding: 0;text-rendering: inherit;margin: 0;line-height: inherit;white-space: inherit;">Sidenote: The goal would be to have some html which can be used without khelpcenter and the help:/ ioslave.
Is there some other stylesheet one could use for that?</p></pre>
</td>
</tr>
</table>
<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Testing </h1>
<table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" style="border: 1px solid #b8b5a0">
<tr>
<td>
<pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;"><p style="padding: 0;text-rendering: inherit;margin: 0;line-height: inherit;white-space: inherit;">Before this patch: if you turn HTML docs on, not even cmake will complete, as the target names are broken.
Now: make && make install for e.g. kate.git will create & install a index.html if HTML docs are turned on.</p></pre>
</td>
</tr>
</table>
<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Diffs</b> </h1>
<ul style="margin-left: 3em; padding-left: 0;">
<li>KF5DocToolsMacros.cmake <span style="color: grey">(e0a85b3)</span></li>
</ul>
<p><a href="https://git.reviewboard.kde.org/r/128213/diff/" style="margin-left: 3em;">View Diff</a></p>
</td>
</tr>
</table>
</div>
</body>
</html>