[kde-doc-english] Help with docbook format

[Elvis Angelaccio]

2014-04-01 15:40 GMT+02:00 Yuri Chornoivan <yurchor at ukr.net>:

> написане Tue, 01 Apr 2014 16:32:18 +0300, Elvis Angelaccio <
> elvis.angelaccio at kdemail.net>:
>
>
>  Hi all,
>> I'm the creator of the kronometer project, actually part of KDE
>> playground:
>> https://projects.kde.org/projects/playground/utils/kronometer
>>
>> According to the application lifecycle policy, in order to be accepted in
>> the main modules (or in extragear) one of the requirements is the user
>> documentation in the docbook format.
>> Since I am a bit in trouble whit this, I'd like to ask help to you.
>>
>> While I'm able to handle a markup language (like docbook is), there are
>> specific details that I don't know at all.
>> So, I'm worried to write a partially wrong docbook  that might be
>> hard/tedious to fix.
>>
>> How does usually work the writing of a new docbook?
>> I can suppose two possible ways:
>>
>> 1. I write a .txt with only the documentation content. Then someone
>> creates
>> from scratch a docbook based on the content in the .txt file. For example
>> I
>> might provide a text file like this: http://pastebin.com/8wQp7YVJ
>>
>> 2. I write a partial .docbook, filling only the main tags, e.g. <chapter>,
>> <title>, <para>. Then someone completes the docbook with the missing stuff
>> that I'm not able to handle.
>>
>> What's the best method?
>>
>> Thank you in advance for your time,
>> Elvis Angelaccio
>>
>
> Hi,
>
> You can use any format you like. You do not need to know anything about
> DocBook format.
>
> I can help you to convert your text and figures into the valid KDE DocBook.
>
> For example, you can compose your docs in ODT (LO Writer or Calligra
> Words) then save it as DocBook (*.xml, LO Writer). Later send the data to
> me or to this mailing list.
>
> Best regards,
> Yuri
>

Hi,
I created a first ODT draft using LibreOffice Writer.
Unfortunately when I save the document in the DocBook format, the generated
XML is wrong and some content is lost. Something weird happens.
For this reason I attach both the original ODT and the wrong resulting
DocBook.

Thank you and let me know if something is missing.

Best regards,
Elvis



> _______________________________________________
> kde-doc-english mailing list
> kde-doc-english at kde.org
> https://mail.kde.org/mailman/listinfo/kde-doc-english
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-doc-english/attachments/20140401/043abbb6/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: kronometer.odt
Type: application/vnd.oasis.opendocument.text
Size: 21454 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/kde-doc-english/attachments/20140401/043abbb6/attachment.odt>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: kronometer.xml
Type: text/xml
Size: 2323 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/kde-doc-english/attachments/20140401/043abbb6/attachment.xml>