Skip to content

Commit

Permalink
import more wiki pages
Browse files Browse the repository at this point in the history
  • Loading branch information
cobyism committed Jul 26, 2012
1 parent f3ffd13 commit ea1f465
Show file tree
Hide file tree
Showing 2 changed files with 152 additions and 1 deletion.
121 changes: 121 additions & 0 deletions _posts/2012-07-19-installation.md
Expand Up @@ -12,3 +12,124 @@ Installing Jekyll is easy and straight-forward, but there’s a few requirements
- Ruby - Ruby
- RubyGems - RubyGems
- Linux, Unix, or Mac OS X - Linux, Unix, or Mac OS X


The best way to install Jekyll is via
[RubyGems](http://docs.rubygems.org/read/chapter/3):

`sudo gem install jekyll`

Jekyll requires the gems `directory_watcher`, `liquid`, `open4`,
`maruku` and `classifier`. These are automatically installed by the gem
install command.



If you encounter errors during gem installation, you may need to install
the header files for compiling extension modules for ruby 1.9.1. This
can be done on Debian systems by:

`sudo apt-get install ruby1.9.1-dev`

or on Red Hat / CentOS / Fedora systems by:

`sudo yum install ruby-devel`

On [NearlyFreeSpeech](http://nearlyfreespeech.net/) you need:

`RB_USER_INSTALL=true gem install jekyll`

If you encounter errors like `Failed to build gem native extension` on
Windows you may need to install [RubyInstaller
DevKit](http://wiki.github.com/oneclick/rubyinstaller/development-kit).

On OSX, you may need to update RubyGems:

`sudo gem update --system`

To install gem on Gentoo:

`sudo emerge -av dev-ruby/rubygems`

LaTeX to PNG
------------

Maruku comes with optional support for LaTeX to PNG rendering via
blahtex (Version 0.6) which must be in your \$PATH along with `dvips`.

(NOTE: [remi’s fork of
Maruku](http://github.com/remi/maruku/tree/master) does not assume a
fixed location for `dvips` if you need that fixed)

RDiscount
---------

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

`sudo gem install rdiscount`

And run Jekyll with the following option:

`jekyll --rdiscount`

Or, in your `_config.yml` file put the following so you don’t have to
specify the flag:

`markdown: rdiscount`

Pygments
--------

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

**On OS X Leopard, Snow Leopard:**\
It already comes preinstalled with Python 2.6\
`sudo easy_install Pygments`

**On OS X Lion:**\
OS X Lion comes preinstalled with Python 2.7\
`sudo easy_install Pygments`

**Alternatively on OS X with MacPorts:**\
`sudo port install python25 py25-pygments`

**Alternatively on OS X with Homebrew:**

brew install python
# export PATH="/usr/local/share/python:${PATH}"
easy_install pip
pip install --upgrade distribute
pip install pygments

*Note: 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 [this](https://github.com/mxcl/homebrew/wiki/Homebrew-and-Python).

**On Archlinux:**

`sudo pacman -S python-pygments`\
Or to use python2 for pygments:\
`sudo pacman -S python2-pygments`\
**Note**: python2 pygments version creates a `pygmentize2` executable,
while jekyll tries to find `pygmentize`. \
Either create a symlink
`# ln -s /usr/bin/pygmentize2 /usr/bin/pygmentize` or use the python3
version. (This advice seems to be outdated — python2-pygments does
install pygmentize).

**On Ubuntu and Debian:**

`sudo apt-get install python-pygments`

**On Fedora:**

`sudo yum install python-pygments`

**On Gentoo:**

`sudo emerge -av dev-python/pygments`
32 changes: 31 additions & 1 deletion _posts/2012-07-19-resources.md
Expand Up @@ -5,4 +5,34 @@ prev_section: sites
next_section: credits next_section: credits
--- ---


Move along, people. Nothing to see here.
Examples and links to various extensions/hackings on Jekyll.

### Tips & Tricks

- [A simple way to add draft posts.](https://gist.github.com/2870636)
No plugins required.
- [Tips for working with GitHub Pages
Integration.](https://gist.github.com/2890453) Code example reuse,
and keeping documentation up to date.
- [Use Simple Form to integrate a simple contact
form.](http://getsimpleform.com/) .

### Tutorials

\* [http://jekyllbootstrap.com](http://jekyllbootstrap.com) \
Provides detailed explanations, examples, and helper-code to make
getting started with Jekyll easier.


Integrating with Git\
* [Blogging with Git, Emacs and Jekyll](http://metajack.im/2009/01/23/blogging-with-git-emacs-and-jekyll/)\
* [Using Git to maintain your blog](http://matedriven.com.ar/2009/04/28/using-git-to-maintain-your-blog.html) (step by step guide)

Other hacks\
* [Integrating Twitter with Jekyll](http://www.justkez.com/integrating-twitter-with-jekyll/): “Having migrated Justkez.com to be based on Jekyll, I was pondering how I might include my recent twitterings on the front page of the site. In the Wordpress world, this would have been done via a plugin which may or may not have hung the loading of the page, might have employed caching, but would certainly have had some overheads. … Not in Jekyll.”\
* [‘My Jekyll Fork’ - Mike West](http://mikewest.org/2009/11/my-jekyll-fork): “Jekyll is a well-architected throwback to a time before Wordpress, when men were men, and HTML was static. I like the ideas it espouses, and have made a few improvements to it’s core. Here, I’ll point out some highlights of my fork in the hopes that they see usage beyond this site.” \
* [‘About this Website’ - Carter Allen](http://cartera.me/2010/08/12/about-this-website/): “Jekyll is everything that I ever wanted in a blogging engine. Really. It isn’t perfect, but what’s excellent about it is that if there’s something wrong, I know exactly how it works and how to fix it. It runs on the your machine only, and is essentially an added”build" step between you and the browser. I coded this entire site in TextMate using standard HTML5 and CSS3, and then at the end I added just a few little variables to the markup. Presto-chango, my site is built and I am at peace with the world." \
* [Generating a Tag Cloud in Jekyll](http://www.justkez.com/generating-a-tag-cloud-in-jekyll/): “Guide on how you can implement a tag cloud and per-tag content pages in Jekyll.”\
* [Jekyll Extensions -= Pain](http://rfelix.com/2010/01/19/jekyll-extensions-minus-equal-pain/): A way to extend Jekyll without forking and modifying the Jekyll gem codebase ([jekyll\_ext](http://github.com/rfelix/jekyll_ext)) + Portable Jekyll extensions that can be reutilized and shared ([list of extensions](http://wiki.github.com/rfelix/jekyll_ext/extensions)).\
* [Using your Rails layouts in Jekyll](http://numbers.brighterplanet.com/2010/08/09/sharing-rails-views-with-jekyll)

0 comments on commit ea1f465

Please sign in to comment.