<div dir="ltr">Thank you for your help, Yuri!<div><br></div><div>Best regards,</div><div>Elvis</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">2014-04-01 20:13 GMT+02:00 Yuri Chornoivan <span dir="ltr"><<a href="mailto:yurchor@ukr.net" target="_blank">yurchor@ukr.net</a>></span>:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">ΞΑΠΙΣΑΞΕ Tue, 01 Apr 2014 20:06:36 +0300, Elvis Angelaccio <<a href="mailto:elvis.angelaccio@kdemail.net" target="_blank">elvis.angelaccio@kdemail.net</a>><u></u>:<div>
<div class="h5"><br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
2014-04-01 15:40 GMT+02:00 Yuri Chornoivan <<a href="mailto:yurchor@ukr.net" target="_blank">yurchor@ukr.net</a>>:<br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
ΞΑΠΙΣΑΞΕ Tue, 01 Apr 2014 16:32:18 +0300, Elvis Angelaccio <<br>
<a href="mailto:elvis.angelaccio@kdemail.net" target="_blank">elvis.angelaccio@kdemail.net</a>>:<br>
<br>
<br>
Hi all,<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I'm the creator of the kronometer project, actually part of KDE<br>
playground:<br>
<a href="https://projects.kde.org/projects/playground/utils/kronometer" target="_blank">https://projects.kde.org/<u></u>projects/playground/utils/<u></u>kronometer</a><br>
<br>
According to the application lifecycle policy, in order to be accepted in<br>
the main modules (or in extragear) one of the requirements is the user<br>
documentation in the docbook format.<br>
Since I am a bit in trouble whit this, I'd like to ask help to you.<br>
<br>
While I'm able to handle a markup language (like docbook is), there are<br>
specific details that I don't know at all.<br>
So, I'm worried to write a partially wrong docbook that might be<br>
hard/tedious to fix.<br>
<br>
How does usually work the writing of a new docbook?<br>
I can suppose two possible ways:<br>
<br>
1. I write a .txt with only the documentation content. Then someone<br>
creates<br>
from scratch a docbook based on the content in the .txt file. For example<br>
I<br>
might provide a text file like this: <a href="http://pastebin.com/8wQp7YVJ" target="_blank">http://pastebin.com/8wQp7YVJ</a><br>
<br>
2. I write a partial .docbook, filling only the main tags, e.g. <chapter>,<br>
<title>, <para>. Then someone completes the docbook with the missing stuff<br>
that I'm not able to handle.<br>
<br>
What's the best method?<br>
<br>
Thank you in advance for your time,<br>
Elvis Angelaccio<br>
<br>
</blockquote>
<br>
Hi,<br>
<br>
You can use any format you like. You do not need to know anything about<br>
DocBook format.<br>
<br>
I can help you to convert your text and figures into the valid KDE DocBook.<br>
<br>
For example, you can compose your docs in ODT (LO Writer or Calligra<br>
Words) then save it as DocBook (*.xml, LO Writer). Later send the data to<br>
me or to this mailing list.<br>
<br>
Best regards,<br>
Yuri<br>
<br>
</blockquote>
<br>
Hi,<br>
I created a first ODT draft using LibreOffice Writer.<br>
Unfortunately when I save the document in the DocBook format, the generated<br>
XML is wrong and some content is lost. Something weird happens.<br>
For this reason I attach both the original ODT and the wrong resulting<br>
DocBook.<br>
<br>
Thank you and let me know if something is missing.<br>
<br>
Best regards,<br>
Elvis<br>
</blockquote>
<br></div></div>
Hi,<br>
<br>
Attached is the converted index.docbook and CMakeLists.txt for /doc folder.<br>
<br>
The PDF file can be found here:<br>
<br>
<a href="https://dl.dropboxusercontent.com/u/55247264/kronometer.pdf" target="_blank">https://dl.dropboxusercontent.<u></u>com/u/55247264/kronometer.pdf</a><br>
<br>
Thanks for documenting your application.<br>
<br>
Hope this helps.<br>
<br>
Best regards,<br>
Yuri</blockquote></div><br></div>