]> pere.pagekite.me Git - homepage.git/blobdiff - blog/archive/2012/07/index.html
Generated.
[homepage.git] / blog / archive / 2012 / 07 / index.html
index 863cb8555bcdca6af03fdb0f59f07d739f396d81..9d0b6a8f9152fcb0613d60f67a8a3299abb0f90c 100644 (file)
 
     <h3>Entries from July 2012.</h3>
     
+    <div class="entry">
+      <div class="title">
+        <a href="http://people.skolelinux.org/pere/blog/Best_way_to_create_a_docbook_book_.html">Best way to create a docbook book?</a>
+      </div>
+      <div class="date">
+        31st July 2012
+      </div>
+      <div class="body">
+        <p>I tried to send this text to the
+<a href="https://lists.oasis-open.org/archives/docbook-apps/">docbook-apps
+mailing list at lists.oasis-open.org</a>, but it only accept messages
+from subscribers and rejected my post, and I completely lack the
+bandwidth required to subscribe to another mailing list, so instead I
+try to post my message here and hope my blog readers can help me
+out.</p>
+
+<p>I am quite new to docbook processing, and am climbing a steep
+learning curve at the moment.</p>
+
+<p>To give you some background, I am working on a Norwegian
+translation of the book Free Culture by Lawrence Lessig, and I use
+docbook to handle the process.  The files to build the book are
+available from
+<a href="https://github.com/petterreinholdtsen/free-culture-lessig">github</a>.
+The book got around 400 pages with parts, images, footnotes, tables,
+index entries etc, which has proven to be a challenge for the free
+software docbook processors.  My build platform is Debian GNU/Linux
+Squeeze.</p>
+
+<p>I want to build PDF, EPUB and HTML version of the book, and have
+tried different tool chains to do the conversion from docbook to these
+formats.  I am currently focusing on the PDF version, and have a few
+problems.</p>
+
+<ul>
+
+<li>Using dblatex, the &lt;part&gt; handling is not the way I want to,
+   as &lt;/part&gt; do not really end the &lt;part&gt;. (See
+   <a href="http://bugs.debian.org/683166">BTS report #683166</a>), the
+   xetex backend (needed to process UTF-8) give incorrect hyphens in
+   index references spanning several pages (See
+   <a href="http://bugs.debian.org/682901">BTS report #682901</a>), and
+   I am unable to get the norwegian template texts (See
+   <a href="http://bugs.debian.org/682936">BTS report #682936</a>).</li>
+
+<li>Using straight xmlto fail with some latex error (See
+   <a href="http://bugs.debian.org/683163">BTS report
+   #683163</a>).</li>
+
+<li>Using xmlto with the fop backend fail to handle images (do not
+   show up in the PDF), fail to handle a long footnote (overlap
+   footnote and text body, see
+   <a href="http://bugs.debian.org/683197">BTS report #683197</a>), and
+   fail to create a correct index (some lack page ref, and the page
+   refs listed are not right).</li>
+
+<li>Using xmlto with the dblatex backend behave like dblatex.</li>
+
+<li>Using docbook-xls with xsltproc + fop have the same footnote and
+   index problems the xmlto + fop processing.</li>
+
+</ul>
+
+<p>So I wonder, what would be the best way to create the PDF version
+of this book?  Are some of the bugs found above solved in new or
+experimental versions of some docbook tool chain?</p>
+
+<p>What about HTML and EPUB versions?</p>
+
+      </div>
+      <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>
+    </div>
+    <div class="padding"></div>
+    
+    <div class="entry">
+      <div class="title">
+        <a href="http://people.skolelinux.org/pere/blog/OOXML_og_standardisering.html">OOXML og standardisering</a>
+      </div>
+      <div class="date">
+        25th July 2012
+      </div>
+      <div class="body">
+        <p>DIFI har
+<a href="http://people.skolelinux.org/pere/blog/DIFI_foresl_r___kaste_ut_ODF_og_ta_inn_OOXML_fra_statens_standardkatalog.html">en
+høring gående</a> om ny versjon av statens standardkatalog, med frist
+2012-09-30, der det foreslås å fjerne ODF fra katalogen og ta inn ISO
+OOXML.  I den anledning minnes jeg
+<a href="http://www.regjeringen.no/upload/FAD/Vedlegg/IKT-politikk/Refkat_v2.pdf">notatet
+FAD skrev</a> da versjon 2 av standardkatalogen var under
+utarbeidelse, da FAD og DIFI fortsatt forsto poenget med og verdien av
+frie og åpne standarder.</p>
+
+<p>Det er mange som tror at OOXML er ett spesifikt format, men det
+brukes ofte som fellesbetegnelse for både formatet spesifisert av
+ECMA, ISO, og formatet produsert av Microsoft Office (aka docx), som
+dessverre ikke er det samme formatet.  Fra en av de som implementerte
+støtte for docx-formatet i KDE fikk jeg høre at ISO-spesifikasjonen
+var en nyttig referanse, men at det var mange avvik som gjorde at en
+ikke kunne gå ut ifra at Microsoft Office produserte dokumenter i
+henhold til ISO-spesifikasjonen.</p>
+
+<p>ISOs OOXML-spesifikasjon har (eller hadde, usikker på om
+kommentaren er oppdatert) i følge
+<a href="http://surguy.net/articles/ooxml-validation-and-technical-review.xml">Inigo
+Surguy</a> feil i mer enn 10% av eksemplene, noe som i tillegg gjør
+det vanskelig å bruke spesifikasjonen til å implementere støtte for
+ISO OOXML.  Jeg har ingen erfaring med å validere OOXML-dokumenter
+selv, men ser at
+<a href="http://www.microsoft.com/en-us/download/details.aspx?id=5124">Microsoft
+har laget en validator</a> som jeg ikke kan teste da den kun er
+tilgjengelig på MS Windows.  Finner også en annen kalt
+<a href="http://code.google.com/p/officeotron/">Office-O-Tron</A> som
+er oppdatert i fjor.  Lurer på om de validerer at dokumenter er i
+formatet til Microsoft office, eller om de validerer at de er i
+henhold til formatene spesifisert av ECMA og ISO. Det hadde også vært
+interessant å se om docx-dokumentene publisert av det offentlige er
+gyldige ISO OOXML-dokumenter.</p>
+
+      </div>
+      <div class="tags">
+        
+        
+        Tags: <a href="http://people.skolelinux.org/pere/blog/tags/norsk">norsk</a>, <a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug</a>, <a href="http://people.skolelinux.org/pere/blog/tags/standard">standard</a>.
+        
+        
+      </div>
+    </div>
+    <div class="padding"></div>
+    
+    <div class="entry">
+      <div class="title">
+        <a href="http://people.skolelinux.org/pere/blog/Free_Culture_in_Norwegian___5_chapters_done__74_percent_left_to_do.html">Free Culture in Norwegian - 5 chapters done, 74 percent left to do</a>
+      </div>
+      <div class="date">
+        21st July 2012
+      </div>
+      <div class="body">
+        <p>I reported earlier that I am working on
+<a href="http://people.skolelinux.org/pere/blog/Dugnad_for___sende_norsk_versjon_av_Free_Culture_til_stortingets_representanter_.html">a
+norwegian version</a> of the book
+<a href="http://free-culture.cc/">Free Culture</a> by Lawrence Lessig.
+Progress is good, and yesterday I got a major contribution from Anders
+Hagen Jarmund completing chapter six.  The source files as well as a
+PDF and EPUB version of this book are available from
+<a href="https://github.com/petterreinholdtsen/free-culture-lessig">github</a>.</p>
+
+<p>I am happy to report that the draft for the first two chapters
+(preface, introduction) is complete, and three other chapters are also
+completely translated.  This completes 26 percent of the number of
+strings (equivalent to paragraphs) in the book, and there is thus 74
+percent left to translate.  A graph of the progress is present at the
+bottom of the github project page.  There is still room for more
+contributors.  Get in touch or send github pull requests with fixes if
+you got time and are willing to help make this book make it to
+print. :)</p>
+
+<p>The book translation framework could also be a good basis for other
+translations, if you want the book to be available in your
+language.</p>
+
+      </div>
+      <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>, <a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug</a>, <a href="http://people.skolelinux.org/pere/blog/tags/opphavsrett">opphavsrett</a>.
+        
+        
+      </div>
+    </div>
+    <div class="padding"></div>
+    
     <div class="entry">
       <div class="title">
         <a href="http://people.skolelinux.org/pere/blog/Tips_for___bli_med_i_Skolelinux_prosjektet__som_faktisk_er_aktivt_.html">Tips for å bli med i Skolelinux-prosjektet (som faktisk er aktivt)</a>
@@ -111,7 +288,7 @@ send pull requests with fixes. :)</p>
       <div class="tags">
         
         
-        Tags: <a href="http://people.skolelinux.org/pere/blog/tags/english">english</a>, <a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug</a>, <a href="http://people.skolelinux.org/pere/blog/tags/opphavsrett">opphavsrett</a>.
+        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>, <a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug</a>, <a href="http://people.skolelinux.org/pere/blog/tags/opphavsrett">opphavsrett</a>.
         
         
       </div>
@@ -154,7 +331,7 @@ lille folder om temaet</a>.</p>
       <div class="tags">
         
         
-        Tags: <a href="http://people.skolelinux.org/pere/blog/tags/norsk">norsk</a>, <a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug</a>.
+        Tags: <a href="http://people.skolelinux.org/pere/blog/tags/freeculture">freeculture</a>, <a href="http://people.skolelinux.org/pere/blog/tags/norsk">norsk</a>, <a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug</a>.
         
         
       </div>
@@ -237,7 +414,7 @@ slik at du kan oppdatere direkte.</p>
       <div class="tags">
         
         
-        Tags: <a href="http://people.skolelinux.org/pere/blog/tags/norsk">norsk</a>, <a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug</a>, <a href="http://people.skolelinux.org/pere/blog/tags/opphavsrett">opphavsrett</a>.
+        Tags: <a href="http://people.skolelinux.org/pere/blog/tags/docbook">docbook</a>, <a href="http://people.skolelinux.org/pere/blog/tags/freeculture">freeculture</a>, <a href="http://people.skolelinux.org/pere/blog/tags/norsk">norsk</a>, <a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug</a>, <a href="http://people.skolelinux.org/pere/blog/tags/opphavsrett">opphavsrett</a>.
         
         
       </div>
@@ -1462,7 +1639,13 @@ opp.</p>
 
 <li><a href="http://people.skolelinux.org/pere/blog/archive/2012/06/">June (20)</a></li>
 
-<li><a href="http://people.skolelinux.org/pere/blog/archive/2012/07/">July (14)</a></li>
+<li><a href="http://people.skolelinux.org/pere/blog/archive/2012/07/">July (17)</a></li>
+
+<li><a href="http://people.skolelinux.org/pere/blog/archive/2012/08/">August (6)</a></li>
+
+<li><a href="http://people.skolelinux.org/pere/blog/archive/2012/09/">September (9)</a></li>
+
+<li><a href="http://people.skolelinux.org/pere/blog/archive/2012/10/">October (5)</a></li>
 
 </ul></li>
 
@@ -1581,25 +1764,29 @@ opp.</p>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/bsa">bsa (2)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/debian">debian (55)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/debian">debian (57)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/debian edu">debian edu (110)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/debian edu">debian edu (113)</a></li>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/digistan">digistan (9)</a></li>
 
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/docbook">docbook (7)</a></li>
+
  <li><a href="http://people.skolelinux.org/pere/blog/tags/drivstoffpriser">drivstoffpriser (4)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/english">english (142)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/english">english (153)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/fiksgatami">fiksgatami (17)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/fiksgatami">fiksgatami (18)</a></li>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/fildeling">fildeling (12)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/frikanalen">frikanalen (6)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/freeculture">freeculture (8)</a></li>
+
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/frikanalen">frikanalen (8)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/intervju">intervju (30)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/intervju">intervju (31)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/kart">kart (16)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/kart">kart (17)</a></li>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/ldap">ldap (8)</a></li>
 
@@ -1607,19 +1794,19 @@ opp.</p>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/ltsp">ltsp (1)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/multimedia">multimedia (22)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/multimedia">multimedia (25)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/norsk">norsk (189)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/norsk">norsk (201)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug (140)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/nuug">nuug (145)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/offentlig innsyn">offentlig innsyn (4)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/offentlig innsyn">offentlig innsyn (5)</a></li>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/open311">open311 (2)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/opphavsrett">opphavsrett (33)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/opphavsrett">opphavsrett (35)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/personvern">personvern (48)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/personvern">personvern (49)</a></li>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/raid">raid (1)</a></li>
 
@@ -1639,21 +1826,21 @@ opp.</p>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/sitesummary">sitesummary (4)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/skepsis">skepsis (1)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/skepsis">skepsis (2)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/standard">standard (35)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/standard">standard (38)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/stavekontroll">stavekontroll (1)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/stavekontroll">stavekontroll (2)</a></li>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/stortinget">stortinget (4)</a></li>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/surveillance">surveillance (10)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/valg">valg (6)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/valg">valg (7)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/video">video (32)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/video">video (34)</a></li>
 
- <li><a href="http://people.skolelinux.org/pere/blog/tags/vitenskap">vitenskap (1)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/vitenskap">vitenskap (3)</a></li>
 
  <li><a href="http://people.skolelinux.org/pere/blog/tags/web">web (25)</a></li>