fnp / librarian.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
organization name in footer
[librarian.git] / README.md
diff --git a/README.md b/README.md
old mode 100755 (executable)
new mode 100644 (file)
index 0867419..f1c7736
--- a/README.md
+++ b/README.md
@@ -2,10 +2,10 @@ License
 -------
 
   ![AGPL Logo](http://www.gnu.org/graphics/agplv3-155x51.png)
 -------
 
   ![AGPL Logo](http://www.gnu.org/graphics/agplv3-155x51.png)
-    
+
     Copyright © 2008,2009,2010 Fundacja Nowoczesna Polska <fundacja@nowoczesnapolska.org.pl>
     Copyright © 2008,2009,2010 Fundacja Nowoczesna Polska <fundacja@nowoczesnapolska.org.pl>
-    
-    For full list of contributors see AUTHORS section at the end. 
+
+    For full list of contributors see AUTHORS section at the end.
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU Affero General Public License as published by
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU Affero General Public License as published by
@@ -21,10 +21,10 @@ License
     along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 
     along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 
-About 
+About
 ------
 
 ------
 
-Librarian converts XML-based markup language used by FNP for writing books to 
+Librarian converts XML-based markup language used by FNP for writing books to
 other formats, which are more suitable for presentation.
 
 Currently we support:
 other formats, which are more suitable for presentation.
 
 Currently we support:
@@ -33,8 +33,8 @@ Currently we support:
  * Plain text
  * EPUB (XHTML based)
  * print-ready PDF
  * Plain text
  * EPUB (XHTML based)
  * print-ready PDF
- 
-Other features: 
+
+Other features:
 
  * extract DublinCore meta-data from documents;
  * extract marked "themes" from documents.
 
  * extract DublinCore meta-data from documents;
  * extract marked "themes" from documents.
@@ -45,8 +45,11 @@ Dependencies
 
  * lxml <http://codespeak.net/lxml/>, version 2.2 or later
  * additional PDF converter dependencies:
 
  * lxml <http://codespeak.net/lxml/>, version 2.2 or later
  * additional PDF converter dependencies:
-   * XeTeX
+   * XeTeX with support for Polish language
    * TeXML <http://getfo.org/texml/>
    * TeXML <http://getfo.org/texml/>
+   * recommended: morefloats LaTeX package, version >=1.0c
+     for dealing with documents with many motifs in one paragraph.
+     <http://www.ctan.org/tex-archive/help/Catalogue/entries/morefloats.html>
 
 
 Installation
 
 
 Installation
@@ -55,7 +58,9 @@ Installation
 Librarian uses standard Python distutils for packaging. After installing all the dependencies just run:
 
     python setup.py install
 Librarian uses standard Python distutils for packaging. After installing all the dependencies just run:
 
     python setup.py install
-    
+
+PDF converter also needs the Junicode-WL fonts (librarian/pdf/JunicodeWL-*.ttf) installed.
+In Debian/Ubuntu, put those files in ~/.fonts/ and run `fc-cache'.
 
 Usage
 ------
 
 Usage
 ------
@@ -88,4 +93,5 @@ Originally written by Marek Stępniowski <marek@stepniowski.com>
 Later contributions:
 
  * Łukasz Rekucki <lrekucki@gmail.com>
 Later contributions:
 
  * Łukasz Rekucki <lrekucki@gmail.com>
- * Radek Czajka <radek.czajka@gmail.com>
\ No newline at end of file
+ * Radek Czajka <radek.czajka@gmail.com>
+ * Jan Szejko <jan.szejko@nowoczesnapolska.org.pl>