28a99707fd
We will no longer support GHC 6.4. git-svn-id: https://pandoc.googlecode.com/svn/trunk@603 788f1e2b-df1e-0410-8736-df70ead52e1b
90 lines
4 KiB
Text
90 lines
4 KiB
Text
% Pandoc
|
|
|
|
Pandoc is a [Haskell] library for converting from one markup format
|
|
to another, and a command-line tool that uses this library. It can read
|
|
[markdown] and (subsets of) [reStructuredText], [HTML], and [LaTeX],
|
|
and it can write [markdown], [reStructuredText], [HTML], [LaTeX], [RTF],
|
|
[DocBook XML], and [S5] HTML slide shows. Pandoc's version of markdown
|
|
contains some enhancements, like footnotes and embedded LaTeX.
|
|
|
|
In contrast to existing tools for converting markdown to HTML, which
|
|
use regex substitutions, Pandoc has a modular design: it consists of a
|
|
set of readers, which parse text in a given format and produce a native
|
|
representation of the document, and a set of writers, which convert
|
|
this native representation into a target format. Thus, adding an input
|
|
or output format requires only adding a reader or writer.
|
|
|
|
For more information, see the [README](README.html) file.
|
|
|
|
Pandoc is free software, released under the [GPL].
|
|
|
|
**Source distribution:** [`@TARBALL_NAME@`].
|
|
To install, unpack the archive and follow the instructions in the
|
|
[INSTALL](INSTALL.html) file. You'll need the [GHC] Haskell compiler,
|
|
version 6.6 or higher.
|
|
|
|
**MacOS X binary package:** [`@OSX_DMG_NAME@`].
|
|
To install, just double-click the package icon in the disk
|
|
image. See the [installation notes](osx-notes.html) for important
|
|
information about setting your `PATH`. Note: This package was
|
|
compiled on a G4 Mac; it will also work on an Intel Mac via emulation.
|
|
|
|
**Windows binary package:** [`@WINDOWS_PKG_NAME@`].
|
|
The zip file contains the `pandoc.exe` command-line program (which
|
|
you should extract from the zip archive and put somewhere in your
|
|
PATH). See the included file `README-WINDOWS.txt` for instructions
|
|
on using the program. Note: If you use [Cygwin], we recommend that
|
|
you compile Pandoc from source. This will give you access to the
|
|
wrapper scripts `markdown2pdf`, `html2markdown`, and `hsmarkdown`,
|
|
which are not included in the Windows binary package.
|
|
|
|
[`@TARBALL_NAME@`]: http://code.google.com/p/pandoc/downloads/detail?name=@TARBALL_NAME@
|
|
"Download source tarball from Pandoc's Google Code site"
|
|
[`@OSX_DMG_NAME@`]: http://code.google.com/p/pandoc/downloads/detail?name=@OSX_DMG_NAME@
|
|
"Download Mac OS X disk image from Pandoc's Google Code site"
|
|
[`@WINDOWS_PKG_NAME@`]: http://code.google.com/p/pandoc/downloads/detail?name=@WINDOWS_PKG_NAME@
|
|
"Download Windows zip file from Pandoc's Google Code site"
|
|
[Cygwin]: http://www.cygwin.com/
|
|
"Cygwin - a linux-like environment for Windows"
|
|
|
|
**Debian linux package:** [`pandoc_0.3_i386.deb`] (thanks to Recai Oktaş).
|
|
To install, download the file and type:
|
|
|
|
sudo dpkg -i pandoc_0.3_i386.deb
|
|
|
|
[`pandoc_0.3_i386.deb`]: http://people.debian.org/~roktas/packages/pandoc_0.3_i386.deb
|
|
|
|
**FreeBSD port:** <http://www.freshports.org/textproc/pandoc/>
|
|
|
|
**Repository:** Pandoc has a publicly accesible subversion repository
|
|
at Google Code (<http://code.google.com/p/pandoc>). To check out the
|
|
latest, bleeding-edge source code:
|
|
|
|
svn checkout http://pandoc.googlecode.com/svn/trunk/ pandoc
|
|
|
|
**Bugs:** You may view existing bug reports and submit new ones at
|
|
<http://code.google.com/p/pandoc/issues/list>.
|
|
|
|
**Announcements list:** If you'd like to receive announcements of
|
|
new releases of Pandoc, you may subscribe to the [pandoc-announce
|
|
mailing list].
|
|
|
|
**API:** You can browse the API documentation for the Pandoc Haskell
|
|
libraries [here](doc/index.html).
|
|
|
|
This is an early, "alpha" release. It carries no warranties of any
|
|
kind.
|
|
|
|
[pandoc-announce mailing list]: http://groups.google.com/group/pandoc-announce
|
|
[John MacFarlane]: http://sophos.berkeley.edu/macfarlane/
|
|
[markdown]: http://daringfireball.net/projects/markdown/
|
|
[reStructuredText]: http://docutils.sourceforge.net/docs/ref/rst/introduction.html
|
|
[S5]: http://meyerweb.com/eric/tools/s5/
|
|
[HTML]: http://www.w3.org/TR/html40/
|
|
[LaTeX]: http://www.latex-project.org/
|
|
[RTF]: http://en.wikipedia.org/wiki/Rich_Text_Format
|
|
[DocBook XML]: http://www.docbook.org/
|
|
[Haskell]: http://www.haskell.org/
|
|
[GHC]: http://www.haskell.org/ghc/
|
|
[GPL]: http://www.gnu.org/copyleft/gpl.html
|
|
|