along with this program. If not, see <http://www.gnu.org/licenses/>.
along with this program. If not, see <http://www.gnu.org/licenses/>.
-Librarian
-=========
+About
+------
-Librarian (*ang. bibliotekarz*) to biblioteka służąca do konwersji języka składu książek opartego na XML opracowanego przez Fundację Nowoczesna Polska na inne formaty.
+Librarian converts XML-based markup language used by FNP for writing books to
+other formats, which are more suitable for presentation.
-Obecnie obsługiwane są formaty:
+Currently we support:
- * XML
- * TXT
+ * HTML4, XHTML 1.0
+ * Plain text
+ * EPUB (XHTML based)
+ * print-ready PDF
-Biblioteka librarian potrafi również parsować metadane opisane przez DublinCore oraz wyciągać fragmenty motywów z lektur.
+Other features:
+ * extract DublinCore meta-data from documents;
+ * extract marked "themes" from documents.
-Wymagania
----------
- * [lxml 2.2](http://codespeak.net/lxml/)
+Dependencies
+------------
-
-Instalacja
-----------
-Zainstaluj biblioteki z sekcji *Wymagania* powyżej. Następnie rozpakuj archiwum z biblioteką librarian, przejdź w terminalu do rozpakowanego katalogu i wpisz:
+ * lxml <http://codespeak.net/lxml/>, version 2.2 or later
+ * additional PDF converter dependencies:
+ * XeTeX
+ * TeXML <http://getfo.org/texml/>
+
+
+Installation
+------------
-<pre>python setup.py install</pre>
+Librarian uses standard Python distutils for packaging. After installing all the dependencies just run:
-Na Linuxie i OSX mogą być wymagane uprawnienia administratora. W takim wypadku wpisz:
+ python setup.py install
+
+
+Usage
+------
-<pre>sudo python setup.py install</pre>
+To convert a series of files to XHTML:
-Alternatywnie możesz zainstalować bibliotekę librarian w wybranym przez siebie katalogu. W takim wypadku należy użyć argumentu *prefix* do *setup.py*:
fnp / librarian.git / blobdiff