diff options
Diffstat (limited to 'web/index.txt')
-rw-r--r-- | web/index.txt | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/web/index.txt b/web/index.txt new file mode 100644 index 000000000..72a3594ea --- /dev/null +++ b/web/index.txt @@ -0,0 +1,52 @@ +% 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], +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. + +**Source distribution:** [@TARBALL_NAME@](@TARBALL_NAME@). +To install, unpack the archive and follow the instructions in the +[README](README.html) file. You'll need the [GHC] Haskell compiler. + +**Debian binary package:** [@DEB_NAME@](@DEB_NAME@). +To install (on x86 Debian-based linux systems only), run `dpkg -i +@DEB_NAME@` as root. + +**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>. + +**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. + +[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 +[Haskell]: http://www.haskell.org/ +[GHC]: http://www.haskell.org/ghc/ + + |