Documentation Primer/Manual/DocBook Reference/This Document - Revision history

Claus chr: Corrected links

2012-09-09T10:14:47Z

Corrected links

Claus chr at 08:28, 2 September 2012

2012-09-02T08:28:12Z

Claus chr at 09:05, 1 September 2012

2012-09-01T09:05:30Z

Claus chr: 1 revision: Moving Docbook Primer from UserBase to TechBase

2012-09-01T08:47:34Z

1 revision: Moving Docbook Primer from UserBase to TechBase

Annew: Marked this version for translation

2011-11-30T14:33:05Z

Marked this version for translation

New page

<translate>

=== Purpose of this document === 


The purpose of this document is to describe how markup has been standardized within KDE documentation only.


This document is ''not'' to be considered more authoritative than the DocBook documentation, including the O'Reilly Duck book. However, there are places where the KDE DTD is more restrictive than, or just differs from, the OASIS DTD, and these are noted in this document. In these cases, follow the instructions here.


Please read and make use of the other documentation available to you, which is much more comprehensive. This document is not intended to be more than a quick reference for KDE authors, to clarify how the DocBook XML elements are used within the KDE Documentation.

</translate><span id="Other reference material"></span><translate>

==== Other reference material ==== 


Please take a look at the following reference material, rather than relying on this document to answer all your questions.


;[http://www.docbook.org/ The Duck book]
:The complete DocBook SGML (and now XML) reference. Available as a download in several formats, so you can keep a copy on your hard drive for reference. Also available for sale in hard copy - if you see yourself doing a lot of DocBook Authoring, you definitely ought to consider buying it.


;[http://opensource.bureau-cornavin.com/crash-course/ The Crash Course to Docbook]
:A non-KDE specific crash course to marking up documentation. This is the starting point for all KDE documents, including the markup issues discussed here. Note that the current version is written for SGML, but the concepts are still correct for XML.


;The KDE Documentation Template
:Covers many things not mentioned here, including required and optional chapters, the preferred way to mark up the prologue and bookinfo sections, and how to deal with licensing and credits. It can be found in <tt>kdelibs/kdoctools/template.docbook</tt> in CVS.


;[http://www.millin.de/linux_docbook_xmlbuch.html DocBook-XML] (in German)
:A very nice book, in German only unfortunately, but comes highly recommended.


{{Prevnext2
| prevpage=Documentation Primer/Manual/DocBook Reference/Markup
| prevtext=General KDE markup style guide
| nextpage=Documentation Primer/Manual/DocBook Reference/Prologue
| nexttext=The Prologue
| index=Documentation Primer/Manual
| indextext=Back to Menu
}}

</translate>

← Older revision		Revision as of 08:28, 2 September 2012
Line 1:		Line 1:
	<languages />		<languages />
−	~~{{Transferring}}~~
	<translate>		<translate>

← Older revision		Revision as of 09:05, 1 September 2012
Line 1:		Line 1:
		+	<languages />
		+	{{Transferring}}
	<translate>		<translate>

@@ Line 38: / Line 38: @@
 <!--T:11-->
 {{Prevnext2
-| prevpage=Documentation Primer/Manual/DocBook Reference/Markup
+| prevpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/Markup
 | prevtext=General KDE markup style guide
-| nextpage=Documentation Primer/Manual/DocBook Reference/Prologue
+| nextpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/Prologue
 | nexttext=The Prologue
-| index=Documentation Primer/Manual
+| index=Special:myLanguage/Documentation Primer/Manual
 | indextext=Back to Menu
 }}
 </translate>