]> pere.pagekite.me Git - homepage.git/blob - blog/Best_way_to_create_a_docbook_book_.html
Generated.
[homepage.git] / blog / Best_way_to_create_a_docbook_book_.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" dir="ltr">
4 <head>
5 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
6 <title>Petter Reinholdtsen: Best way to create a docbook book?</title>
7 <link rel="stylesheet" type="text/css" media="screen" href="http://people.skolelinux.org/pere/blog/style.css" />
8 <link rel="stylesheet" type="text/css" media="screen" href="http://people.skolelinux.org/pere/blog/vim.css" />
9 </head>
10 <body>
11 <div class="title">
12 <h1>
13 <a href="http://people.skolelinux.org/pere/blog/">Petter Reinholdtsen</a>
14
15 </h1>
16
17 </div>
18
19
20 <div class="entry">
21 <div class="title">Best way to create a docbook book?</div>
22 <div class="date">31st July 2012</div>
23 <div class="body"><p>I tried to send this text to the
24 <a href="https://lists.oasis-open.org/archives/docbook-apps/">docbook-apps
25 mailing list at lists.oasis-open.org</a>, but it only accept messages
26 from subscribers and rejected my post, and I completely lack the
27 bandwidth required to subscribe to another mailing list, so instead I
28 try to post my message here and hope my blog readers can help me
29 out.</p>
30
31 <p>I am quite new to docbook processing, and am climbing a steep
32 learning curve at the moment.</p>
33
34 <p>To give you some background, I am working on a Norwegian
35 translation of the book Free Culture by Lawrence Lessig, and I use
36 docbook to handle the process. The files to build the book are
37 available from
38 <a href="https://github.com/petterreinholdtsen/free-culture-lessig">github</a>.
39 The book got around 400 pages with parts, images, footnotes, tables,
40 index entries etc, which has proven to be a challenge for the free
41 software docbook processors. My build platform is Debian GNU/Linux
42 Squeeze.</p>
43
44 <p>I want to build PDF, EPUB and HTML version of the book, and have
45 tried different tool chains to do the conversion from docbook to these
46 formats. I am currently focusing on the PDF version, and have a few
47 problems.</p>
48
49 <ul>
50
51 <li>Using dblatex, the &lt;part&gt; handling is not the way I want to,
52 as &lt;/part&gt; do not really end the &lt;part&gt;. (See
53 <a href="http://bugs.debian.org/683166">BTS report #683166</a>), the
54 xetex backend (needed to process UTF-8) give incorrect hyphens in
55 index references spanning several pages (See
56 <a href="http://bugs.debian.org/682901">BTS report #682901</a>), and
57 I am unable to get the norwegian template texts (See
58 <a href="http://bugs.debian.org/682936">BTS report #682936</a>).</li>
59
60 <li>Using straight xmlto fail with some latex error (See
61 <a href="http://bugs.debian.org/683163">BTS report
62 #683163</a>).</li>
63
64 <li>Using xmlto with the fop backend fail to handle images (do not
65 show up in the PDF), fail to handle a long footnote (overlap
66 footnote and text body, see
67 <a href="http://bugs.debian.org/683197">BTS report #683197</a>), and
68 fail to create a correct index (some lack page ref, and the page
69 refs listed are not right).</li>
70
71 <li>Using xmlto with the dblatex backend behave like dblatex.</li>
72
73 <li>Using docbook-xls with xsltproc + fop have the same footnote and
74 index problems the xmlto + fop processing.</li>
75
76 </ul>
77
78 <p>So I wonder, what would be the best way to create the PDF version
79 of this book? Are some of the bugs found above solved in new or
80 experimental versions of some docbook tool chain?</p>
81
82 <p>What about HTML and EPUB versions?</p>
83 </div>
84
85 <div class="tags">Tags: <a href="http://people.skolelinux.org/pere/blog/tags/docbook">docbook</a>, <a href="http://people.skolelinux.org/pere/blog/tags/english">english</a>, <a href="http://people.skolelinux.org/pere/blog/tags/freeculture">freeculture</a>.</div>
86
87
88 </div>
89
90
91
92
93 <div id="sidebar">
94
95
96
97 <h2>Archive</h2>
98 <ul>
99
100 <li>2013
101 <ul>
102
103 <li><a href="http://people.skolelinux.org/pere/blog/archive/2013/01/">January (1)</a></li>
104
105 </ul></li>
106
107 <li>2012
108 <ul>
109
110 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/01/">January (7)</a></li>
111
112 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/02/">February (10)</a></li>
113
114 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/03/">March (17)</a></li>
115
116 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/04/">April (12)</a></li>
117
118 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/05/">May (12)</a></li>
119
120 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/06/">June (20)</a></li>
121
122 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/07/">July (17)</a></li>
123
124 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/08/">August (6)</a></li>
125
126 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/09/">September (9)</a></li>
127
128 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/10/">October (17)</a></li>
129
130 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/11/">November (10)</a></li>
131
132 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/12/">December (7)</a></li>
133
134 </ul></li>
135
136 <li>2011
137 <ul>
138
139 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/01/">January (16)</a></li>
140
141 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/02/">February (6)</a></li>
142
143 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/03/">March (6)</a></li>
144
145 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/04/">April (7)</a></li>
146
147 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/05/">May (3)</a></li>
148
149 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/06/">June (2)</a></li>
150
151 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/07/">July (7)</a></li>
152
153 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/08/">August (6)</a></li>
154
155 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/09/">September (4)</a></li>
156
157 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/10/">October (2)</a></li>
158
159 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/11/">November (3)</a></li>
160
161 <li><a href="http://people.skolelinux.org/pere/blog/archive/2011/12/">December (1)</a></li>
162
163 </ul></li>
164
165 <li>2010
166 <ul>
167
168 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/01/">January (2)</a></li>
169
170 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/02/">February (1)</a></li>
171
172 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/03/">March (3)</a></li>
173
174 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/04/">April (3)</a></li>
175
176 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/05/">May (9)</a></li>
177
178 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/06/">June (14)</a></li>
179
180 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/07/">July (12)</a></li>
181
182 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/08/">August (13)</a></li>
183
184 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/09/">September (7)</a></li>
185
186 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/10/">October (9)</a></li>
187
188 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/11/">November (13)</a></li>
189
190 <li><a href="http://people.skolelinux.org/pere/blog/archive/2010/12/">December (12)</a></li>
191
192 </ul></li>
193
194 <li>2009
195 <ul>
196
197 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/01/">January (8)</a></li>
198
199 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/02/">February (8)</a></li>
200
201 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/03/">March (12)</a></li>
202
203 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/04/">April (10)</a></li>
204
205 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/05/">May (9)</a></li>
206
207 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/06/">June (3)</a></li>
208
209 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/07/">July (4)</a></li>
210
211 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/08/">August (3)</a></li>
212
213 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/09/">September (1)</a></li>
214
215 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/10/">October (2)</a></li>
216
217 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/11/">November (3)</a></li>
218
219 <li><a href="http://people.skolelinux.org/pere/blog/archive/2009/12/">December (3)</a></li>
220
221 </ul></li>
222
223 <li>2008
224 <ul>
225
226 <li><a href="http://people.skolelinux.org/pere/blog/archive/2008/11/">November (5)</a></li>
227
228 <li><a href="http://people.skolelinux.org/pere/blog/archive/2008/12/">December (7)</a></li>
229
230 </ul></li>
231
232 </ul>
233
234
235
236 <h2>Tags</h2>
237 <ul>
238
239 <li><a href="http://people.skolelinux.org/pere/blog/tags/3d-printer">3d-printer (13)</a></li>
240
241 <li><a href="http://people.skolelinux.org/pere/blog/tags/amiga">amiga (1)</a></li>
242
243 <li><a href="http://people.skolelinux.org/pere/blog/tags/aros">aros (1)</a></li>
244
245 <li><a href="http://people.skolelinux.org/pere/blog/tags/bankid">bankid (4)</a></li>
246
247 <li><a href="http://people.skolelinux.org/pere/blog/tags/bitcoin">bitcoin (5)</a></li>
248
249 <li><a href="http://people.skolelinux.org/pere/blog/tags/bootsystem">bootsystem (12)</a></li>
250
251 <li><a href="http://people.skolelinux.org/pere/blog/tags/bsa">bsa (2)</a></li>
252
253 <li><a href="http://people.skolelinux.org/pere/blog/tags/debian">debian (59)</a></li>
254
255 <li><a href="http://people.skolelinux.org/pere/blog/tags/debian edu">debian edu (118)</a></li>
256
257 <li><a href="http://people.skolelinux.org/pere/blog/tags/digistan">digistan (9)</a></li>
258
259 <li><a href="http://people.skolelinux.org/pere/blog/tags/docbook">docbook (7)</a></li>
260
261 <li><a href="http://people.skolelinux.org/pere/blog/tags/drivstoffpriser">drivstoffpriser (4)</a></li>
262
263 <li><a href="http://people.skolelinux.org/pere/blog/tags/english">english (165)</a></li>
264
265 <li><a href="http://people.skolelinux.org/pere/blog/tags/fiksgatami">fiksgatami (21)</a></li>
266
267 <li><a href="http://people.skolelinux.org/pere/blog/tags/fildeling">fildeling (12)</a></li>
268
269 <li><a href="http://people.skolelinux.org/pere/blog/tags/freeculture">freeculture (10)</a></li>
270
271 <li><a href="http://people.skolelinux.org/pere/blog/tags/frikanalen">frikanalen (9)</a></li>
272
273 <li><a href="http://people.skolelinux.org/pere/blog/tags/intervju">intervju (32)</a></li>
274
275 <li><a href="http://people.skolelinux.org/pere/blog/tags/kart">kart (17)</a></li>
276
277 <li><a href="http://people.skolelinux.org/pere/blog/tags/ldap">ldap (8)</a></li>
278
279 <li><a href="http://people.skolelinux.org/pere/blog/tags/lenker">lenker (6)</a></li>
280
281 <li><a href="http://people.skolelinux.org/pere/blog/tags/ltsp">ltsp (1)</a></li>
282
283 <li><a href="http://people.skolelinux.org/pere/blog/tags/multimedia">multimedia (25)</a></li>
284
285 <li><a href="http://people.skolelinux.org/pere/blog/tags/norsk">norsk (219)</a></li>
286
287 <li><a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug (148)</a></li>
288
289 <li><a href="http://people.skolelinux.org/pere/blog/tags/offentlig innsyn">offentlig innsyn (6)</a></li>
290
291 <li><a href="http://people.skolelinux.org/pere/blog/tags/open311">open311 (2)</a></li>
292
293 <li><a href="http://people.skolelinux.org/pere/blog/tags/opphavsrett">opphavsrett (41)</a></li>
294
295 <li><a href="http://people.skolelinux.org/pere/blog/tags/personvern">personvern (61)</a></li>
296
297 <li><a href="http://people.skolelinux.org/pere/blog/tags/raid">raid (1)</a></li>
298
299 <li><a href="http://people.skolelinux.org/pere/blog/tags/reprap">reprap (11)</a></li>
300
301 <li><a href="http://people.skolelinux.org/pere/blog/tags/rfid">rfid (2)</a></li>
302
303 <li><a href="http://people.skolelinux.org/pere/blog/tags/robot">robot (4)</a></li>
304
305 <li><a href="http://people.skolelinux.org/pere/blog/tags/rss">rss (1)</a></li>
306
307 <li><a href="http://people.skolelinux.org/pere/blog/tags/ruter">ruter (4)</a></li>
308
309 <li><a href="http://people.skolelinux.org/pere/blog/tags/scraperwiki">scraperwiki (2)</a></li>
310
311 <li><a href="http://people.skolelinux.org/pere/blog/tags/sikkerhet">sikkerhet (28)</a></li>
312
313 <li><a href="http://people.skolelinux.org/pere/blog/tags/sitesummary">sitesummary (4)</a></li>
314
315 <li><a href="http://people.skolelinux.org/pere/blog/tags/skepsis">skepsis (4)</a></li>
316
317 <li><a href="http://people.skolelinux.org/pere/blog/tags/standard">standard (39)</a></li>
318
319 <li><a href="http://people.skolelinux.org/pere/blog/tags/stavekontroll">stavekontroll (3)</a></li>
320
321 <li><a href="http://people.skolelinux.org/pere/blog/tags/stortinget">stortinget (5)</a></li>
322
323 <li><a href="http://people.skolelinux.org/pere/blog/tags/surveillance">surveillance (12)</a></li>
324
325 <li><a href="http://people.skolelinux.org/pere/blog/tags/sysadmin">sysadmin (1)</a></li>
326
327 <li><a href="http://people.skolelinux.org/pere/blog/tags/valg">valg (7)</a></li>
328
329 <li><a href="http://people.skolelinux.org/pere/blog/tags/video">video (35)</a></li>
330
331 <li><a href="http://people.skolelinux.org/pere/blog/tags/vitenskap">vitenskap (4)</a></li>
332
333 <li><a href="http://people.skolelinux.org/pere/blog/tags/web">web (26)</a></li>
334
335 </ul>
336
337
338 </div>
339 <p style="text-align: right">
340 Created by <a href="http://steve.org.uk/Software/chronicle">Chronicle v4.4</a>
341 </p>
342
343 </body>
344 </html>