[dot] Using Quanta as a Docbook Editor

[Dot Stories]

URL: http://dot.kde.org/1124997856/

From: Carlos Leonhard Woelz <carloswoelz at imap-mail.com-no.spam> onThursday 25/Aug/2005, @14:24
Dept: better-late-than-never


Using Quanta as a Docbook Editor
================================

   Quanta [http://quanta.kdewebdev.org] is widely recognized as the most
advanced free software web development environment. But a lot of people
do not know that Quanta is a friendly editor for all SGML and XML
documents (and therefore for docbook).

     Writing documentation is a great way to start contributing to KDE.
While the KDE documentation team [http://i18n.kde.org/] gladly accepts
contributions plain text, the format used for writing the applications
manuals is called docbook
[http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=docbook].
Docbook is a format based on tags, which describe the format and
specifications of the document.

     If you want to learn about docbook, or don't know how to start, the
KDE Documentation Primer [http://i18n.kde.org/doc/doc-primer/] was
created to guide new writers, and offers information such as what to
write about
[http://i18n.kde.org/doc/doc-primer/guidelines-include.html], English
usage guidelines
[http://i18n.kde.org/doc/doc-primer/guidelines-english-usage.html], how
to get the documentation sources
[http://i18n.kde.org/doc/doc-primer/writing-docs.html#getting-the-sources],
a docbook introduction
[http://i18n.kde.org/doc/doc-primer/docbook-intro.html], a docbook
reference guide
[http://i18n.kde.org/doc/doc-primer/docbook-reference.html] and more.
And if you need any assistence while getting up to speed as a new KDE
contributor, don't hesitate to ask your questions in the kde-quality
mailing list.
 [kde-quality at kde.org]
     If you want get your documentation contribution inside the upcoming
KDE 3.5 release, act now, as the Message Freeze
[http://developer.kde.org/development-versions/kde-3.5-release-plan.html]
starts on September 5th.