X-Git-Url: https://pere.pagekite.me/gitweb/text-free-culture-lessig.git/blobdiff_plain/e7f2d570dc228f97f874696aecfc1bf944d47975..30af2bc2e80cdbe8d23877a51a79762c14d8c636:/README.md

diff --git a/README.md b/README.md
index 953fc37..bc370f0 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,110 @@
-free-culture-lessig
-===================
+Norwegian translation of Free Culture
+=====================================
 
-Norwegian translation of the book Free Culture by Lessig.  Based
-on the Docbook version by Hans Schou available from
-<URL: http://www.sslug.dk/~chlor/lessig/ >.
+The books are ready for download and purchase:
 
-Source:
-https://github.com/petterreinholdtsen/free-culture-lessig.git
+English (<a href="https://github.com/petterreinholdtsen/free-culture-lessig/raw/master/images/cover-art.pdf">book cover</a>): [<a href="https://github.com/petterreinholdtsen/free-culture-lessig/raw/master/archive/freeculture.pdf">PDF</a>], [<a href="https://github.com/petterreinholdtsen/free-culture-lessig/raw/master/archive/freeculture.epub">ePub</a>], [<a href="https://github.com/petterreinholdtsen/free-culture-lessig/raw/master/archive/freeculture.mobi">MOBI</a>], [<a href="http://www.lulu.com/shop/lawrence-lessig/free-culture/paperback/product-22402863.html">on paper from lulu.com</a>].
 
+Norwegian Bokmål (<a href="https://github.com/petterreinholdtsen/free-culture-lessig/raw/master/images/nb/cover-art.pdf">book cover</a>): [<a href="https://github.com/petterreinholdtsen/free-culture-lessig/raw/master/archive/freeculture.nb.pdf">PDF</a>], [<a href="https://github.com/petterreinholdtsen/free-culture-lessig/raw/master/archive/freeculture.nb.epub">ePub</a>], [<a href="https://github.com/petterreinholdtsen/free-culture-lessig/raw/master/archive/freeculture.nb.mobi">MOBI</a>], [<a href="http://www.lulu.com/shop/lawrence-lessig/fri-kultur/paperback/product-22406445.html">on paper from lulu.com</a>].
+
+The original book version is available from http://free-culture.cc/ .
+
+See
+<a href="http://people.skolelinux.org/pere/blog/Dugnad_for___sende_norsk_versjon_av_Free_Culture_til_stortingets_representanter_.html">my blog post for 2012</a>
+for a project description.
+
+Norwegian translation of the book Free Culture by Lessig.  Based on
+the <a href="http://www.sslug.dk/~chlor/lessig/">Docbook version by
+Hans Schou</a>.  Other versions of the book can be found from the
+<a href="http://free-culture.cc/remixes/">books remixes list</a>.
+
+The first draft had images found in the HTML version available from
+<a href="http://www.ibiblio.org/ebooks/Lessig/index.html">Elegant
+Ebooks</a>, while later draft had these replaced with the original
+images provided by the author.
+
+The source of this project is available from the
+<a href="https://github.com/petterreinholdtsen/free-culture-lessig">free-culture-lessig
+github repository</a>.
+
+
+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.  The
+translation is maintained using
+<a href="https://www.transifex.com/pere/free-culture-lessig/">Transifex</a>,
+making sure translators only need a browser and Internet connectivity
+to contribute.
+
+Only the file freeculture.xml 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 and EPUB version of this book, the following Debian
+packages are needed:
+
+  make
+  po4a
+  dblatex (>= 0.3.4-2 in debian, for nb support)
+  dbtoepub
+  libxml2-utils
+  gnuplot
+  xmlto
+  docbook-xsl
+  calibre
+
+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.
+
+Changes done to the original
+----------------------------
+
+Changed typo in introduction (page 11 in original):
+
+  Is it not about the «centrality of technology» to ordinary life.
+
+to:
+
+  It is not about the «centrality of technology» to ordinary life.
+
+Changed typo in quote from Elizabeth Daly (page 40 in original),
+removed trailing quite character:
+
+  power with this language."
+
+to:
+
+  power with this language.
+
+Changed 'next page' references to use cross references instead (pages
+141, 148 and 246 in original).
+
+Rewrote colophon page and dropped irrelevant pages between the content
+table and the preface.
+
+
+Translation status
+------------------
+
+<img src="https://github.com/petterreinholdtsen/free-culture-lessig/raw/master/progress.png">
+
+Todo
+----
+
+ * Complete the spell checking of the content (using the txt version
+   is easiest).
+ * Publish first edition.
+ * (Add missing index entries.  Nice to have, not vital.  See
+   scripts/idxcompare for helper script.)