X-Git-Url: https://git.mdrn.pl/wl2pdf.git/blobdiff_plain/aa5c31831c1052ad02ca99ca6533bc18c6b8a3cb..f70d93119d236e25ccebf4ca1c27bed77873797f:/README.md
diff --git a/README.md b/README.md
new file mode 100755
index 0000000..93f566b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,62 @@
+WL2PDF is an XSL-FO based converter from WLML (format
+used by [wolnelektury.pl][1] to print-friendly PDFs).
+
+
+License
+-------
+
+ Copyright © 2009,2010 Åukasz Rekucki
+
+ WL2PDF is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ WL2PDF is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU Affero General Public License for more details.
+
+ You should have received a copy of the GNU Affero General Public License
+ along with WL2PDF. If not, see .
+
+
+Requirements
+------------
+
+ * Fairly new Java Runtime (1.5+)
+
+ * [Apache FOP][2]
+ (at least version 0.95, trunk is recommended)
+
+ * [Saxon][3] for XSLT2
+
+ * Hyphenation is done via FOP, so read a section on it in their docs.
+
+ * Some unicode-capable font, like DejaVu.
+
+
+Configuration
+-------------
+
+ 1. Compile FOP if needed.
+ 2. Generate font metrics (refer to FOP Documentation on that)
+ 3. Make a "fop-config.xml" out of the supplied example and place it in this directory.
+
+
+Running
+-------
+
+With Jython:
+
+ jython wl2pdf
+
+With Java:
+
+ java org.lqsoft.wlml.WL2PDF
+
+Rember to place FOP, it's libraries and Saxon under your classpath.
+
+ [1]: http://wolnelektury.pl/
+ [2]: http://xmlgraphics.apache.org/fop/index.html
+ [3]: http://www.saxonica.com/index.html
\ No newline at end of file