User Tools

Site Tools


mac:pandoc

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

mac:pandoc [2013/07/07 10:47] (current)
Admin Document installation of Pandoc and BasicTeX.
Line 1: Line 1:
 +====== Pandoc ======
 +
 +[[http://​johnmacfarlane.net/​pandoc/​ | Pandoc]] converts files between formats. It supports Markdown, HTML, DocBook, LaTeX, and others. We use it primarily to convert Markdown to other formats. Its version of Markdown seems to be better than the alternatives. It also support syntax highlighting for a wide variety of languages.
 +
 +
 +===== Prerequisites =====
 +
 +To get PDF output, we'll need a version of LaTeX. We'll use the BasicTeX packages that Pandoc'​s site recommends.
 +
 +Go the the [[http://​www.tug.org/​mactex/​morepackages.html | MacTeX page]] and download both the MacTeX-Additions package and the BasicTeX package. Install both packages.
 +
 +
 +===== Installation =====
 +
 +Pandoc is built with Haskell. It's possible to install Haskell from Homebrew, and install all the packages that Pandoc needs through cabal (the Haskell package manager) -- but that's difficult and leaves a big mess. Instead, we just install the binary package from the Pandoc web site.
 +
 +Download the latest Mac OS X package from the [[http://​code.google.com/​p/​pandoc/​downloads/​list | Pandoc downloads page]]. Open the image file and install the package.
 +
 +
 +===== Testing =====
 +
 +Pandoc is a command-line utility -- there'​s no GUI. To test, just run the following from the command line:
 +
 +<code bash>
 +pandoc --version
 +</​code>​
  
mac/pandoc.txt ยท Last modified: 2013/07/07 10:47 by Admin