diff options
| author | John MacFarlane <fiddlosopher@gmail.com> | 2012-12-29 19:27:48 -0800 |
|---|---|---|
| committer | John MacFarlane <fiddlosopher@gmail.com> | 2012-12-29 19:27:48 -0800 |
| commit | 9aba0bdb4a292c46a45747f16721948c59fa01b4 (patch) | |
| tree | 30bebaa89a9ef24d71432c3cf350457872fa60d1 | |
| parent | 78425c90e39fac39df8da6bb8ee81fb4ffdf9588 (diff) | |
| download | pandoc-9aba0bdb4a292c46a45747f16721948c59fa01b4.tar.gz | |
Updated INSTALL with new flags.
| -rw-r--r-- | INSTALL | 49 |
1 files changed, 12 insertions, 37 deletions
@@ -62,15 +62,8 @@ you will need [zip-archive], [blaze-html], and [highlighting-kate]. preceded by a `-` (to force the flag to `false`), and separated by spaces. Pandoc's flags include: - - `executable`: build the pandoc executable (default yes) - - `library`: build the pandoc library (default yes) - - So, for example, - - --flags="-executable" - - tells Cabal to build the library but not the executables, - and to compile with syntax highlighting support. + - `blaze_html_0_5`: Use blaze-html >= 0.5 (default yes) + - `embed_data_files`: embed all data files into the binary (default no) 3. Build: @@ -94,37 +87,19 @@ you will need [zip-archive], [blaze-html], and [highlighting-kate]. generate a script that can be run to register the package at install time. -Creating a relocatable Windows binary -------------------------------------- +Creating a relocatable binary +----------------------------- -On Windows it is possible to compile pandoc such that it -(and its data files) are "relocatable." You can put the relocatable -binary in any directory (even on a USB drive), and it will look for its -data files there. +It is possible to compile pandoc such that the data files +pandoc uses are embedded in the binary. The resulting binary +can be run from any directory and is completely self-contained. cabal install --flags="embed_data_files" citeproc-hs - cabal install --flags="executable -library" --datasubdir= - -You can find `pandoc.exe` in `dist/build/pandoc`. Copy this wherever -you please, and copy the following data files to the same place: - - README - COPYRIGHT - COPYING - reference.odt - reference.docx - epub.css - default.csl - templates/ - data/ - s5/ - slidy/ - slideous/ - dzslides/ - pcre-license.txt - pcre3.dll - -This is essentially what the binary installer does. + cabal configure --flags="embed_data_files" + cabal build + +You can find the pandoc executable in `dist/build/pandoc`. Copy this wherever +you please. [zip-archive]: http://hackage.haskell.org/package/zip-archive [highlighting-kate]: http://hackage.haskell.org/package/highlighting-kate |