[kde-doc-english] Is asciidoc for us?

Jaroslaw Staniek staniek at kde.org
Thu Nov 5 21:43:53 UTC 2015


Back to the topic.
Can anyone share opinion about the gitbook toolkit built on top of
nodejs/asciidoc?

https://github.com/GitbookIO/gitbook

Things become more interesting it seems.


On 28 July 2015 at 21:33, Jaroslaw Staniek <staniek at kde.org> wrote:

> Hi!
> My use of docbook failed due to complexity. Also userbase-based docs
> (at least for Kexi, for which a finished book could be easily over 300
> pages) are far from perfect and not too actively maintained. No
> surprise as it's too much of work if it's used "just" by KDE.
>
> Still I am grateful for tools that we have now!
>
> In the meantime I just installed asciidoc.[1] Some projects like git
> use it for all documentation needs. There's support for localization
> via po4a.
> There's even more than one implementation.
>
> Anyone considered asciidoc as a docbook replacement? It would be good
> to discuss this and see how it fits for our needs.
>
> [1] http://www.methods.co.nz/asciidoc/
>
> --
> regards, Jaroslaw Staniek
>
> KDE:
> : A world-wide network of software engineers, artists, writers, translators
> : and facilitators committed to Free Software development - http://kde.org
> Calligra Suite:
> : A graphic art and office suite - http://calligra.org
> Kexi:
> : A visual database apps builder - http://calligra.org/kexi
> Qt Certified Specialist:
> : http://www.linkedin.com/in/jstaniek
>



-- 
regards, Jaroslaw Staniek

KDE:
: A world-wide network of software engineers, artists, writers, translators
: and facilitators committed to Free Software development - http://kde.org
Calligra Suite:
: A graphic art and office suite - http://calligra.org
Kexi:
: A visual database apps builder - http://calligra.org/kexi
Qt Certified Specialist:
: http://www.linkedin.com/in/jstaniek
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-doc-english/attachments/20151105/9c63a749/attachment.html>


More information about the kde-doc-english mailing list