+ <div class="entry">
+ <div class="title"><a href="http://people.skolelinux.org/pere/blog/Writing_and_translating_documentation_in_Debian_Edu.html">Writing and translating documentation in Debian Edu</a></div>
+ <div class="date">16th March 2012</div>
+ <div class="body"><p>Documentation in Debian Edu is provided in several languages, and
+it is important to make it both easy to contribute and to keep the
+translated versions in sync. To do this we have come up with what we
+believe is a very efficient work flow.</p>
+
+<ol>
+
+<li>The documentation is written in a moinmoin wiki (see for example
+<a href="http://wiki.debian.org/DebianEdu/Documentation/Squeeze">the
+Squeeze release manual</a>) with support for exporting the content as
+docbook XML.</li>
+
+<li>This docbook document is given to po4a to extract a gettext style
+.pot file with the content, which in turn is used to create .po files
+with the translated text.</li>
+
+<li>The .po files are given to translators, and they can always tell
+which part of the original wiki document is new or changed. They can
+use their normal translation tools like lokalize or poedit to write
+the translation. There is even a system in place to handle translated
+images.</li>
+
+<li>The translated .po files are combined with the original docbook
+XML document using po4a to create a translated docbook document.</li>
+
+<li>The final step is to use all the generated docbook files and
+create PDF and HTML version of the original and translated documents.</li>
+
+</ol>
+
+<p>This setup work very well, but have a few issues. The biggest
+issue is that the docbook support in moinmoin is not actively
+maintained. This make it hard to upgrade moinmoin. The docbook
+support is also buggy, and our build system contain lots of
+workarounds to make sure the generated docbook is usable despite these
+bugs.</p>
+
+<p>If you want to have a look at our setup, it is all there in the
+<a href="http://packages.qa.debian.org/debian-edu-doc">debian-edu-doc
+package</a>.</p>
+</div>
+ <div class="tags">
+
+
+ Tags: <a href="http://people.skolelinux.org/pere/blog/tags/debian edu">debian edu</a>, <a href="http://people.skolelinux.org/pere/blog/tags/english">english</a>.
+
+
+ </div>
+ </div>
+ <div class="padding"></div>
+
<div class="entry">
<div class="title"><a href="http://people.skolelinux.org/pere/blog/NUUG_presentasjon__Skolelinux___ferdig_oppsatt_skolenettl_sning.html">NUUG-presentasjon: Skolelinux - ferdig oppsatt skolenettløsning</a></div>
<div class="date">13th March 2012</div>
</div>
<div class="padding"></div>
- <div class="entry">
- <div class="title"><a href="http://people.skolelinux.org/pere/blog/Skolelinux_intervju__Frode_Danielsen.html">Skolelinux-intervju: Frode Danielsen</a></div>
- <div class="date">27th February 2012</div>
- <div class="body"><p>I serien med intervjuer av folk i
-<a href="http://www.skolelinux.org/">Skolelinux</a>-miljøet møter vi
-denne gangen Frode Danielsen, som er leder for en IT-virksomhet som
-passer på IT-løsningen til flere kommuner i Hedmark-området, der noen
-av dem bruker Skolelinux i dag.</p>
-
-<p><strong>Hvem er du, og hva driver du med til daglig?</strong></p>
-
-<p>Daglig leder i <a href="http://www.hedmarken-ikt.no/">Hedmark
-IKT</a>. En interkommunal IKT-virksomhet for Stange, Nord-Odal,
-Kongsvinger, Grue, Løten og Hamar kommuner. Vi er 32 ansatte</p>
-
-<p><strong>Hvordan kom du i kontakt med Skolelinux-prosjektet?</strong></p>
-
-<p>Vi har vært i kontakt med Skolelinux-prosjektet i flere
-sammenhenger, blant annet gjennom et par piloter som ikke har ført til
-noe konkret resultat. Nå sist gjennom satsingen på skolelinux i Grue,
-Kongsvinger og Nord-Odal.</p>
-
-<p><strong>Hva er fordelene med Skolelinux slik du ser det?</strong>
-<br><strong>Hva er ulempene med Skolelinux slik du ser det?</strong></p>
-
-<p>Jeg tror alle løsninger har fordeler og ulemper, litt avhengig av
-hvilket ståsted du selv har, så jeg unnlater å svare på dette.</p>
-
-<p><strong>Hvilken fri programvare bruker du til daglig?</strong></p>
-
-<p>Ingen for min egen del, men vi har noe fri programvare i våre
-løsninger.</p>
-
-<p><strong>Hvilken strategi tror du er den rette å bruke for å få
-skoler til å ta i bruk fri programvare?</strong></p>
-
-<p>Jeg tror ikke man skal ha en slik strategi. Man bør ha en strategi
-basert på å løse fremtidige behov, og velge løsninger som støtter opp
-under dette.</p>
-</div>
- <div class="tags">
-
-
- Tags: <a href="http://people.skolelinux.org/pere/blog/tags/debian edu">debian edu</a>, <a href="http://people.skolelinux.org/pere/blog/tags/intervju">intervju</a>, <a href="http://people.skolelinux.org/pere/blog/tags/norsk">norsk</a>.
-
-
- </div>
- </div>
- <div class="padding"></div>
-
<p style="text-align: right;"><a href="index.rss"><img src="http://people.skolelinux.org/pere/blog/xml.gif" alt="RSS feed" width="36" height="14" /></a></p>
<div id="sidebar">
<li><a href="http://people.skolelinux.org/pere/blog/archive/2012/02/">February (10)</a></li>
-<li><a href="http://people.skolelinux.org/pere/blog/archive/2012/03/">March (9)</a></li>
+<li><a href="http://people.skolelinux.org/pere/blog/archive/2012/03/">March (10)</a></li>
</ul></li>
<li><a href="http://people.skolelinux.org/pere/blog/tags/debian">debian (54)</a></li>
- <li><a href="http://people.skolelinux.org/pere/blog/tags/debian edu">debian edu (87)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/debian edu">debian edu (88)</a></li>
<li><a href="http://people.skolelinux.org/pere/blog/tags/digistan">digistan (7)</a></li>
- <li><a href="http://people.skolelinux.org/pere/blog/tags/english">english (114)</a></li>
+ <li><a href="http://people.skolelinux.org/pere/blog/tags/english">english (115)</a></li>
<li><a href="http://people.skolelinux.org/pere/blog/tags/fiksgatami">fiksgatami (14)</a></li>
projects / homepage.git / blobdiff