File: Howtos-with-LinuxDoc-NL-3.html

package info (click to toggle)
doc-linux-nl 20051127-2
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 16,408 kB
  • ctags: 94
  • sloc: xml: 47,403; makefile: 312; perl: 193; sh: 116; ansic: 12; csh: 9
file content (61 lines) | stat: -rw-r--r-- 2,776 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
 <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
 <TITLE>Howto's-met-LinuxDoc-mini-HOWTO: LinuxDoc vergeleken met DocBook</TITLE>
 <LINK HREF="Howtos-with-LinuxDoc-NL-4.html" REL=next>
 <LINK HREF="Howtos-with-LinuxDoc-NL-2.html" REL=previous>
 <LINK HREF="Howtos-with-LinuxDoc-NL.html#toc3" REL=contents>
</HEAD>
<BODY>
<A HREF="Howtos-with-LinuxDoc-NL-4.html">Next</A>
<A HREF="Howtos-with-LinuxDoc-NL-2.html">Previous</A>
<A HREF="Howtos-with-LinuxDoc-NL.html#toc3">Contents</A>
<HR>
<H2><A NAME="s3">3. LinuxDoc vergeleken met DocBook</A></H2>

<P> Een manier om dit te doen is op de LDP-site te gaan kijken
<A HREF="http://www.linuxdoc.org">http://www.linuxdoc.org</A> klik op HOWTOs en vergelijk de
bronnen van dezelfde HOWTO dan in de twee formaten: LinuxDoc en DocBook.
De DocBook tags zijn vaak langer dan de equivalente LinuxDoc tags en voor
dezelfde taak zijn er soms meer van nodig . DocBook gebruikt
&lt;para> en &lt;/para> tags om paragrafen te omsluiten, terwijl LinuxDoc
slechts een lege regel gebruikt om paragrafen van elkaar te scheiden (geen tags).
Voor het benadrukken van het woord "release" is de vergelijking:
<P>
<BLOCKQUOTE><CODE>
<PRE>
&lt;emphasis>release&lt;/emphasis> release
&lt;em>release&lt;/em>
</PRE>
</CODE></BLOCKQUOTE>
<P>Ja, in DocBook moet je het woord "release" tweemaal intikken. Voor het
beginnen van een sectie:
<BLOCKQUOTE><CODE>
<PRE>

&lt;sect>
&lt;title>Introductie&lt;title>
</PRE>
</CODE></BLOCKQUOTE>
<P>Dus in DocBook moet je heel wat meer typen als je tags met de hand intikt.
Maar voor DocBook zijn heel veel soorten tags die in LinuxDoc niet voorkomen,
dus het biedt meer mogelijkheden. Slecht een subset van DocBook gebruiken
helpt je zoals je kunt zien niet, zoals je uit de hierboven getoonde voorbeelden
kunt afleiden. Het is met nog heel wat meer tags vervuild.
Met meer en langere tags wordt het document moeilijker leesbaar, tenzij je 
een editor gebruikt, die ze verbergt. Maar ze verbergen heeft zijn nadelen
aangezien het toch wel handig is als je ziet welke tags je hebt gebruikt.
<P>Het aantal mensen die gebruik maken van DocBook neemt nog steeds erg toe
boven het aantal dat LinuxDoc gebruikt. Maar als je besluit naar DocBook
over te stappen dan is daar een programma voor van
Reuben Thomas (ld2db) die van hulp kan zijn bij het uitvoeren van de conversie.
Het is niet 100% perfect en het kan zijn dat je handmatig nog het een
en ander aan moet passen. De LDP converteert een LinuxDoc HOWTO ook
automatisch naar DocBook nadat je het hebt aangeleverd.
<HR>
<A HREF="Howtos-with-LinuxDoc-NL-4.html">Next</A>
<A HREF="Howtos-with-LinuxDoc-NL-2.html">Previous</A>
<A HREF="Howtos-with-LinuxDoc-NL.html#toc3">Contents</A>
</BODY>
</HTML>