X-Git-Url: https://git.mdrn.pl/librarian.git/blobdiff_plain/8f76c14aae6e491816a0c07ec7fe66119dd34716..b1376392167c09775bf57b41cb9ea3016f06cfb8:/README.md?ds=sidebyside diff --git a/README.md b/README.md old mode 100755 new mode 100644 index 0867419..a64e37a --- a/README.md +++ b/README.md @@ -2,10 +2,10 @@ License ------- ![AGPL Logo](http://www.gnu.org/graphics/agplv3-155x51.png) - - Copyright © 2008,2009,2010 Fundacja Nowoczesna Polska - - For full list of contributors see AUTHORS section at the end. + + Copyright © 2008-2023 Fundacja Wolne Lektury + + For full list of contributors see AUTHORS file. 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,20 +21,22 @@ License along with this program. If not, see . -About +About ------ -Librarian converts XML-based markup language used by FNP for writing books to +Librarian converts XML-based markup language used by WL for writing books to other formats, which are more suitable for presentation. Currently we support: - * HTML4, XHTML 1.0 + * HTML4, XHTML 1.0 (?) * Plain text * EPUB (XHTML based) + * MOBI * print-ready PDF - -Other features: + * FB2 + +Other features: * extract DublinCore meta-data from documents; * extract marked "themes" from documents. @@ -45,8 +47,11 @@ Dependencies * lxml , version 2.2 or later * additional PDF converter dependencies: - * XeTeX + * XeTeX with support for Polish language * TeXML + * recommended: morefloats LaTeX package, version >=1.0c + for dealing with documents with many motifs in one paragraph. + Installation @@ -55,7 +60,9 @@ Installation 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 ------ @@ -79,13 +86,3 @@ To convert a file to PDF: To extract book fragments marked as "theme": bookfragments file1.xml [file2.xml ...] - - -Authors -------- -Originally written by Marek Stępniowski - -Later contributions: - - * Łukasz Rekucki - * Radek Czajka \ No newline at end of file