104 lines
3.0 KiB
Markdown
104 lines
3.0 KiB
Markdown
---
|
||
layout: docs
|
||
title: Extras
|
||
prev_section: plugins
|
||
next_section: github-pages
|
||
---
|
||
|
||
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 `{{ "{% highlight " }}%}` tag in your
|
||
posts, you’ll need to install [Pygments](http://pygments.org/).
|
||
|
||
### Installing Pygments on OSX
|
||
|
||
Mac OS X (Leopard onwards) come 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}"
|
||
easy_install pip
|
||
pip install --upgrade distribute
|
||
pip install pygments
|
||
{% endhighlight %}
|
||
|
||
**ProTip™**: 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 [the Homebrew wiki](https://github.com/mxcl/homebrew/wiki/Homebrew-and-Python).
|
||
|
||
#### 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 run Jekyll with the following option:
|
||
|
||
{% highlight bash %}
|
||
jekyll build --markdown rdiscount
|
||
{% endhighlight %}
|
||
|
||
Or, specify RDiscount as the markdown engine in your `_config.yml` file to have Jekyll run with that option by default (so you don’t have to specify the flag every time).
|
||
|
||
{% highlight bash %}
|
||
# In _config.yml
|
||
markdown: rdiscount
|
||
{% endhighlight %}
|
||
|