[homepage.git] / blog / tags / docbook / docbook.rss

<?xml version="1.0" encoding="utf-8"?>
<rss version='2.0' xmlns:lj='http://www.livejournal.org/rss/lj/1.0/'>
        <channel>
                <title>Petter Reinholdtsen - Entries tagged docbook</title>
                <description>Entries tagged docbook</description>
                <link>http://people.skolelinux.org/pere/blog/</link>

        
        <item>
                <title>Half way there with translated docbook version of Free Culture</title>
                <link>http://people.skolelinux.org/pere/blog/Half_way_there_with_translated_docbook_version_of_Free_Culture.html</link>        
                <guid isPermaLink="true">http://people.skolelinux.org/pere/blog/Half_way_there_with_translated_docbook_version_of_Free_Culture.html</guid>
                <pubDate>Fri, 17 Aug 2012 21:50:00 +0200</pubDate>
                <description>&lt;p&gt;In my spare time, I currently work on a Norwegian
&lt;a href=&quot;http://www.docbook.org/&quot;&gt;docbook&lt;/a&gt; version of the 2004 book
&lt;a href=&quot;http://free-culture.cc/&quot;&gt;Free Culture&lt;/a&gt; by Lawrence Lessig,
to get a Norwegian text explaining the problems with the copyright law
I can give to my parents and others that are reluctant to read an
English book.  It is a marvellous set of examples on how the ever
expanding copyright regulations hurt culture and society.  When the
translation is done, I hope to find funding to print and ship a copy
to all the members of the Norwegian parliament, before they sit down
to debate the latest revisions to the Norwegian copyright law.  This
summer I
&lt;a href=&quot;http://people.skolelinux.org/pere/blog/Dugnad_for___sende_norsk_versjon_av_Free_Culture_til_stortingets_representanter_.html&quot;&gt;called
for volunteers&lt;/a&gt; to help me, and I have been able to secure the
valuable contribution from at least one other Norwegian.&lt;/p&gt;

&lt;p&gt;Two days ago, we finally broke the 50% mark.  Then more than 50% of
the number of strings to translate (normally paragraphs, but also
titles and index entries are also counted).  All parts from the
beginning up to and including chapter four is translated.  So is
chapters six, seven and the conclusion.  I created a graph to show the
progress:&lt;/p&gt;

&lt;img width=&quot;80%&quot; align=&quot;center&quot; src=&quot;https://github.com/petterreinholdtsen/free-culture-lessig/raw/master/progress.png&quot;&gt;

&lt;p&gt;The number of strings to translate increase as I insert the index
entries into the docbook.  They were missing with the docbook version
I initially started with.  There are still quite a few index entries
missing, but everyone starting with A, B, O, Z and Y are done.  I
currently focus on completing the index entries, to get a complete
english version of the docbook source.&lt;/p&gt;

&lt;p&gt;There is still need for translators and people with docbook
knowledge, to be able to get a good looking book (I still struggle
with dblatex, xmlto and docbook-xsl) as well as to do the draft
translation and proof reading.  And I would like the figures to be
redrawn as SVGs to make it easy to translate them.  Any SVG master
around?  I am sure there are some legal terms that are unfamiliar to
me.  If you want to help, please get in touch, and check out the
project files currently available from &lt;a
href=&quot;https://github.com/petterreinholdtsen/free-culture-lessig&quot;&gt;github&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;If you are curious what the translated book currently look like,
the updated
&lt;a href=&quot;https://github.com/petterreinholdtsen/free-culture-lessig/blob/master/archive/freeculture.nb.pdf?raw=true&quot;&gt;PDF&lt;/a&gt;
and
&lt;a href=&quot;https://github.com/petterreinholdtsen/free-culture-lessig/blob/master/archive/freeculture.nb.epub?raw=true&quot;&gt;EPUB&lt;/a&gt;
are published on github.  The HTML version is published as well, but
github hand it out with MIME type text/plain, confusing browsers, so I
saw no point in linking to that version.&lt;/p&gt;
</description>
        </item>
        
        <item>
                <title>Notes on language codes for Norwegian docbook processing...</title>
                <link>http://people.skolelinux.org/pere/blog/Notes_on_language_codes_for_Norwegian_docbook_processing___.html</link>        
                <guid isPermaLink="true">http://people.skolelinux.org/pere/blog/Notes_on_language_codes_for_Norwegian_docbook_processing___.html</guid>
                <pubDate>Fri, 10 Aug 2012 21:00:00 +0200</pubDate>
                <description>&lt;p&gt;In &lt;a href=&quot;http://www.docbook.org/&quot;&gt;docbook&lt;/a&gt; one can specify
the language used at the top, and the processing pipeline will use
this information to pick the correct translations for &#39;chapter&#39;, &#39;see
also&#39;, &#39;index&#39; etc.  And for most languages used with docbook, I guess
this work just fine.  For example a German user can start the document
with &amp;lt;book lang=&quot;de&quot;&amp;gt;, and the document will show up with the
correct content with any of the docbook processors.  This is not the
case for the language
&lt;a href=&quot;http://people.skolelinux.org/pere/blog/Free_Culture_in_Norwegian___5_chapters_done__74_percent_left_to_do.html&quot;&gt;I
am working with at the moment&lt;/a&gt;, Norwegian Bokmål.&lt;/p&gt;

&lt;p&gt;For a while, I was confused about which language code to use,
because I was unable to find any language code that would work across
all tools.  I am currently testing dblatex, xmlto, docbook-xsl, and
dbtoepub, and they do not handle Norwegian Bokmål the same way.  Some
of them do not handle it at all.&lt;/p&gt;

&lt;p&gt;A bit of background information is probably needed to understand
this mess.  Norwegian is not one, but two written variants.  The
variants are Norwegian Nynorsk and Norwegian Bokmål.  There are three
two letter language codes associated with these languages, Norwegian
is &#39;no&#39;, Norwegian Nynorsk is &#39;nn&#39; and Norwegian Bokmål is &#39;nb&#39;.
Historically the &#39;no&#39; language code was used for Norwegian Bokmål, but
many years ago this was found to be å bad idea, and the recommendation
is to use the most specific language code instead, to avoid confusion.
In the transition period it is a good idea to make sure &#39;no&#39; was an
alias for &#39;nb&#39;.&lt;/p&gt;

&lt;p&gt;Back to docbook processing tools in Debian.  The dblatex tool only
understand &#39;nn&#39;.  There are translations for &#39;no&#39;, but not &#39;nb&#39; (BTS
&lt;a href=&quot;http://bugs.debian.org/684391&quot;&gt;#684391&lt;/a&gt;), but due to a bug
(BTS &lt;a href=&quot;http://bugs.debian.org/682936&quot;&gt;#682936&lt;/a&gt;) the &#39;no&#39;
language code is not recognised.  The docbook-xsl tool chain only
recognise &#39;nn&#39; and &#39;nb&#39;, but not &#39;no&#39;.  The xmlto tool only recognise
&#39;nn&#39; and &#39;nb&#39;, but not &#39;no&#39;.  The end result that there is no language
code I can use to get the docbook file working with all of these tools
at the same time. :(&lt;/p&gt;

&lt;p&gt;The correct solution is to use &amp;lt;book lang=&quot;nb&quot;&amp;gt;, but it will
take time before that will work with all the free software docbook
processors. :(&lt;/p&gt;

&lt;p&gt;Oh, the joy of well integrated tools. :/&lt;/p&gt;
</description>
        </item>
        
        <item>
                <title>Best way to create a docbook book?</title>
                <link>http://people.skolelinux.org/pere/blog/Best_way_to_create_a_docbook_book_.html</link>        
                <guid isPermaLink="true">http://people.skolelinux.org/pere/blog/Best_way_to_create_a_docbook_book_.html</guid>
                <pubDate>Tue, 31 Jul 2012 22:00:00 +0200</pubDate>
                <description>&lt;p&gt;I tried to send this text to the
&lt;a href=&quot;https://lists.oasis-open.org/archives/docbook-apps/&quot;&gt;docbook-apps
mailing list at lists.oasis-open.org&lt;/a&gt;, 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.&lt;/p&gt;

&lt;p&gt;I am quite new to docbook processing, and am climbing a steep
learning curve at the moment.&lt;/p&gt;

&lt;p&gt;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
&lt;a href=&quot;https://github.com/petterreinholdtsen/free-culture-lessig&quot;&gt;github&lt;/a&gt;.
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.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;ul&gt;

&lt;li&gt;Using dblatex, the &amp;lt;part&amp;gt; handling is not the way I want to,
   as &amp;lt;/part&amp;gt; do not really end the &amp;lt;part&amp;gt;. (See
   &lt;a href=&quot;http://bugs.debian.org/683166&quot;&gt;BTS report #683166&lt;/a&gt;), the
   xetex backend (needed to process UTF-8) give incorrect hyphens in
   index references spanning several pages (See
   &lt;a href=&quot;http://bugs.debian.org/682901&quot;&gt;BTS report #682901&lt;/a&gt;), and
   I am unable to get the norwegian template texts (See
   &lt;a href=&quot;http://bugs.debian.org/682936&quot;&gt;BTS report #682936&lt;/a&gt;).&lt;/li&gt;

&lt;li&gt;Using straight xmlto fail with some latex error (See
   &lt;a href=&quot;http://bugs.debian.org/683163&quot;&gt;BTS report
   #683163&lt;/a&gt;).&lt;/li&gt;

&lt;li&gt;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
   &lt;a href=&quot;http://bugs.debian.org/683197&quot;&gt;BTS report #683197&lt;/a&gt;), and
   fail to create a correct index (some lack page ref, and the page
   refs listed are not right).&lt;/li&gt;

&lt;li&gt;Using xmlto with the dblatex backend behave like dblatex.&lt;/li&gt;

&lt;li&gt;Using docbook-xls with xsltproc + fop have the same footnote and
   index problems the xmlto + fop processing.&lt;/li&gt;

&lt;/ul&gt;

&lt;p&gt;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?&lt;/p&gt;

&lt;p&gt;What about HTML and EPUB versions?&lt;/p&gt;
</description>
        </item>
        
        <item>
                <title>Free Culture in Norwegian - 5 chapters done, 74 percent left to do</title>
                <link>http://people.skolelinux.org/pere/blog/Free_Culture_in_Norwegian___5_chapters_done__74_percent_left_to_do.html</link>        
                <guid isPermaLink="true">http://people.skolelinux.org/pere/blog/Free_Culture_in_Norwegian___5_chapters_done__74_percent_left_to_do.html</guid>
                <pubDate>Sat, 21 Jul 2012 20:00:00 +0200</pubDate>
                <description>&lt;p&gt;I reported earlier that I am working on
&lt;a href=&quot;http://people.skolelinux.org/pere/blog/Dugnad_for___sende_norsk_versjon_av_Free_Culture_til_stortingets_representanter_.html&quot;&gt;a
norwegian version&lt;/a&gt; of the book
&lt;a href=&quot;http://free-culture.cc/&quot;&gt;Free Culture&lt;/a&gt; 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
&lt;a href=&quot;https://github.com/petterreinholdtsen/free-culture-lessig&quot;&gt;github&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;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. :)&lt;/p&gt;

&lt;p&gt;The book translation framework could also be a good basis for other
translations, if you want the book to be available in your
language.&lt;/p&gt;
</description>
        </item>
        
        <item>
                <title>Call for help from docbook expert to tag Free Culture by Lawrence Lessig</title>
                <link>http://people.skolelinux.org/pere/blog/Call_for_help_from_docbook_expert_to_tag_Free_Culture_by_Lawrence_Lessig.html</link>        
                <guid isPermaLink="true">http://people.skolelinux.org/pere/blog/Call_for_help_from_docbook_expert_to_tag_Free_Culture_by_Lawrence_Lessig.html</guid>
                <pubDate>Mon, 16 Jul 2012 22:50:00 +0200</pubDate>
                <description>&lt;p&gt;I am currently working on a
&lt;a href=&quot;http://people.skolelinux.org/pere/blog/Dugnad_for___sende_norsk_versjon_av_Free_Culture_til_stortingets_representanter_.html&quot;&gt;project
to translate&lt;/a&gt; the book
&lt;a href=&quot;http://free-culture.cc/&quot;&gt;Free Culture&lt;/a&gt; by Lawrence Lessig
to Norwegian.  And the source we base our translation on is the
&lt;a href=&quot;http://en.wikipedia.org/wiki/DocBook&quot;&gt;docbook&lt;/a&gt; version, to
allow us to use po4a and .po files to handle the translation, and for
this to work well the docbook source document need to be properly
tagged.  The source files of this project is available from
&lt;a href=&quot;https://github.com/petterreinholdtsen/free-culture-lessig&quot;&gt;github&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;The problem is that the docbook source have flaws, and we have
no-one involved in the project that is a docbook expert.  Is there a
docbook expert somewhere that is interested in helping us create a
well tagged docbook version of the book, and adjust our build process
for the PDF, EPUB and HTML version of the book?  This will provide a
well tagged English version (our source document), and make it a lot
easier for us to create a good Norwegian version.  If you can and want
to help, please get in touch with me or fork the github project and
send pull requests with fixes. :)&lt;/p&gt;
</description>
        </item>
        
        <item>
                <title>Dugnad for å sende norsk versjon av Free Culture til stortingets representanter!</title>
                <link>http://people.skolelinux.org/pere/blog/Dugnad_for___sende_norsk_versjon_av_Free_Culture_til_stortingets_representanter_.html</link>        
                <guid isPermaLink="true">http://people.skolelinux.org/pere/blog/Dugnad_for___sende_norsk_versjon_av_Free_Culture_til_stortingets_representanter_.html</guid>
                <pubDate>Wed, 11 Jul 2012 09:00:00 +0200</pubDate>
                <description>&lt;p&gt;Da opphavsrettsloven ble revidert i forrige runde rundt 2005, var
det skummelt å se hvor lite stortingsrepresentantene forsto hvordan
Internet påvirket folks forhold til kulturuttrykk, og min venn Vidar
og jeg spekulert på at det hadde kanskje vært fornuftig om samtlige
representanter fikk en norsk utgave av boken
&lt;a href=&quot;http://free-culture.cc/&quot;&gt;Free Culture&lt;/a&gt; av Lawrence Lessig
som forklarte litt om problemstillingene.  Vi endte opp med å
prioritere utvikling i
&lt;a href=&quot;http://www.skolelinux.org/&quot;&gt;Skolelinux&lt;/a&gt;-prosjektet i
stedet, så den oversatte boken så aldri dagens lys.  Men i forrige uke
ble jeg inspirert til å ta opp tråden og se om det er mulig å få til
bokprosjektet denne gang, da det er tydelig at kulturdepartementet i
sitt nye forsøk på å gjøre opphavsrettsloven enda mer ubalansert til
fordel for forlag og store mediehus fortsatt trenger en annen vinkling
i debatten.&lt;/p&gt;

&lt;p&gt;Planen min er å oversette boka på dugnad, sette den opp for
trykking med en av de mange
&lt;a href=&quot;http://no.wikipedia.org/wiki/Trykk_på_forespørsel&quot;&gt;trykk på
forespørsel&lt;/a&gt;-tjenestene, skaffe sponsor til å finansiere trykking
til stortingsrepresentantene og alle som har bidratt med
oversettelser.  Kanskje vi også kan få en avtale med et forlag om
publisering når boka er ferdig?  Kommentarene til
&lt;a href=&quot;http://newth.net/eirik/2011/04/01/e-selvpublisering/&quot;&gt;Eirik
Newth&lt;/a&gt; og
&lt;a href=&quot;http://www.espen.com/norskblogg/archives/2008/09/erfaringer_med_publishing_on_demand.html&quot;&gt;Espen
Andersen&lt;/a&gt; om erfaringene med selvpublisering og trykk på
forespørsel er interessante og ikke avskrekkende, og jeg mistenker at
&lt;a href=&quot;http://www.lulu.com/&quot;&gt;Lulu&lt;/a&gt; er en grei leverandør av
trykketjenester til prosjektet.&lt;/p&gt;

&lt;p&gt;Jeg har satt opp
&lt;a href=&quot;https://github.com/petterreinholdtsen/free-culture-lessig&quot;&gt;et
Github-prosjekt&lt;/a&gt; for a lage boken, basert på Docbook-utgaven jeg
fant fra Hans Schou.  Skolelinux har hatt byggesystem for å lage
oversatt HTML og PDF-utgave av Docbook-bøker i en årrekke, så jeg har
kopiert og utvidet dette oppsettet.  Originalteksten er i Docbook, og
oversettelsen gjøres i .po-filer med hjelp av vanlige
oversetterverktøy brukt i fri programvareverden.  Dernest tar
byggesystemet over og lager PDF og EPUB-utgave av den oversatte
teksten.  Resultatet kan ses i Github-prosjektet.  For å komme raskt
igang har jeg brukt maskinoversettelse av alle tekstbitene fra engelsk
til norsk, noe som grovoversatte ca. 1300 av de ca. 1700 tekstbitene
boken består av.  Jeg håper nå at flere kan bidra med å få
oversettelsen på plass, slik at teksten kan være klar i løpet av
høsten.  Når alt er oversatt må teksten gjennomgås for feil og
konsistent språk.  Totalt er det nok mange timer som trengs for å
gjennomføre oversettelsen.&lt;/p&gt;

&lt;p&gt;Økonomien i dette er ikke avskrekkende.  169
stortingsrepresentanter og nesten like mange varamedlemmer bør få
bøker, og estimert produduksjonskostnad for hver bok er rundt 6 EURO i
følge et raskt estimat fra Lulu.  Jeg vet ennå ikke hvor mange sider
det blir i størrelsen 5,5&quot; x 8.5&quot; (det er ca. 140 sider i A4-format),
så jeg gjettet på 400 sider.  Jeg tror originalutgaven har nesten 400
sider.  For 169*2 eksemplarer snakker vi om en trykkekostnad på
ca. 2000 EURO, dvs. ca 15 000 NOK.  Det burde være mulig å finne en
sponsor for å dekke en slik sum.  I tillegg kommer distribusjon og
porto, som antagelig kommer på like mye.&lt;/p&gt;

&lt;p&gt;Kan du bidra med oversettelse og docbook-typesetting?  Ta kontakt
og send patcher i github.  Jeg legger gjerne inn folk i prosjektet
slik at du kan oppdatere direkte.&lt;/p&gt;
</description>
        </item>
        
        </channel>
</rss>