X-Git-Url: https://pere.pagekite.me/gitweb/text-free-culture-lessig.git/blobdiff_plain/afc5fb72d09485d5c48e21b418951585f822dde4..e05056c20e6db7058278121af557042f6a61d37c:/README.md
diff --git a/README.md b/README.md
index d14b114..1d3da7e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,12 @@
Norwegian translation of Free Culture
=====================================
+The original book version is available from http://free-culture.cc/ .
+
+See
+http://people.skolelinux.org/pere/blog/Dugnad_for___sende_norsk_versjon_av_Free_Culture_til_stortingets_representanter_.html
+for a project description.
+
Norwegian translation of the book Free Culture by Lessig. Based on
the Docbook version by
Hans Schou. Other versions of the book can be found from the
@@ -14,18 +20,43 @@ The source of this project is available from the
free-culture-lessig
github repository.
+
+Text flow
+---------
+
+The original source for the book is freeculture.xml, a Docbook
+formattet file. This file is transformed to the freeculture.pot,
+which is the base file for translators. It was copied to
+freeculture.nb.po as the starting point of the Norwegian Bokmål
+translation, and the text blocks are translated in this file.
+
+Only the files freeculture.xml and freeculture.nb.po should be
+manually edited!
+
+The freeculture.xml file is automatically combined with the
+freeculture.nb.po file to create a new generated file
+freeculture.nb.xml representing the Norwegian Bokmål Docbook version.
+This file is in turn used to generate the HTML, PDF and EPUB version
+of the book.
+
Requirements
------------
-To build the PDF version of this book, the following Debian packages
-are needed:
+To build the PDF and EPUB version of this book, the following Debian
+packages are needed:
+ make
po4a
dblatex
dbtoepub
+ libxml2-utils
+ gnuplot
+ xmlto
+
+When the build requirements are in place, the PDF and EPUB version of
+the book can be build by running 'make' on the command line.
-Docbook howtos
---------------
+Translation status
+------------------
-http://developer.gnome.org/gdp-handbook/stable/docbook.html.en
-http://www.docbook.org/tdg/en/html/docbook.html
+