Permalink
Browse files

import more wiki pages

  • Loading branch information...
cobyism committed Jul 26, 2012
1 parent f3ffd13 commit ea1f4657ac5879276cc8a7434fb9c61dd866aaf6
Showing with 152 additions and 1 deletion.
  1. +121 −0 _posts/2012-07-19-installation.md
  2. +31 −1 _posts/2012-07-19-resources.md
@@ -12,3 +12,124 @@ Installing Jekyll is easy and straight-forward, but there’s a few requirements
- Ruby
- RubyGems
- 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`
@@ -5,4 +5,34 @@ prev_section: sites
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.