---
layout: docs
title: Extras
prev_section: plugins
next_section: github-pages
permalink: /docs/extras/
---

There are a number of (optional) extra features that Jekyll supports that you
may want to install, depending on how you plan to use Jekyll.

## Pygments

If you want syntax highlighting via the `{% raw %}{% highlight %}{% endraw %}`
tag in your posts, you’ll need to install [Pygments](http://pygments.org/).

### Installing Pygments on OSX

Mac OS X (Leopard onwards) comes preinstalled with Python, so on just about any
OS X machine you can install Pygments simply by running:

{% highlight bash %}
$ sudo easy_install Pygments
{% endhighlight %}

#### Installing Pygments using Homebrew

Alternatively, you can install Pygments with
[Homebrew](http://mxcl.github.com/homebrew/), an excellent package manager for
OS X:

{% highlight bash %}
$ brew install python
# export PATH="/usr/local/share/python:${PATH}"
$ pip install pygments
{% endhighlight %}

<div class="note">
  <h5>Homebrew's executable paths</h5>
  <p>
    Homebrew doesn’t symlink the executables for you. For the Homebrew default
    Cellar location and Python 2.7, be sure to add `/usr/local/share/python` to
    your `PATH`. For more information, check out
    <a href="https://github.com/mxcl/homebrew/wiki/Homebrew-and-Python">the
    Homebrew wiki</a>.
  </p>
</div>

#### Installing Pygments using MacPorts

If you use MacPorts, you can install Pygments by running:

{% highlight bash %}
$ sudo port install python25 py25-pygments
{% endhighlight %}

Seriously though, you should check out
[Homebrew](http://mxcl.github.com/homebrew/)—it’s awesome.

### Installing Pygments on Arch Linux

You can install Pygments using the pacman package manager as follows:

{% highlight bash %}
$ sudo pacman -S python-pygments
{% endhighlight %}

Or to use python2 for Pygments:

{% highlight bash %}
$ sudo pacman -S python2-pygments
{% endhighlight %}

### Installing Pygments on Ubuntu and Debian

{% highlight bash %}
$ sudo apt-get install python-pygments
{% endhighlight %}

### Installing Pygments on RedHat, Fedora, and CentOS

{% highlight bash %}
$ sudo yum install python-pygments
{% endhighlight %}

### Installing Pygments on Gentoo

{% highlight bash %}
$ sudo emerge -av dev-python/pygments
{% endhighlight %}

## LaTeX Support

Maruku comes with optional support for LaTeX to PNG rendering via blahtex
(Version 0.6) which must be in your `$PATH` along with `dvips`. If you need
Maruku to not assume a fixed location for `dvips`, check out [Remi’s Maruku
fork](http://github.com/remi/maruku).

## RDiscount

If you prefer to use [RDiscount](http://github.com/rtomayko/rdiscount) instead
of [Maruku](http://maruku.rubyforge.org/) for markdown, just make sure you have
it installed:

{% highlight bash %}
$ sudo gem install rdiscount
{% endhighlight %}

And then specify RDiscount as the Markdown engine in your `_config.yml` file to
have Jekyll run with that option.

{% highlight bash %}
# In _config.yml
markdown: rdiscount
{% endhighlight %}