diff --git a/site/.gitignore b/site/.gitignore new file mode 100644 index 00000000..79bd74f7 --- /dev/null +++ b/site/.gitignore @@ -0,0 +1,4 @@ +_site/ +*.swp +pkg/ +test/ diff --git a/site/_config.yml b/site/_config.yml index 2fc224a9..79be19f5 100644 --- a/site/_config.yml +++ b/site/_config.yml @@ -1,2 +1,5 @@ -auto: true +auto: false server: true +permalink: /docs/:categories/:title +pygments: true +gauges_id: 503c5af6613f5d0f19000027 diff --git a/site/_includes/analytics.html b/site/_includes/analytics.html new file mode 100644 index 00000000..bbdc351e --- /dev/null +++ b/site/_includes/analytics.html @@ -0,0 +1,32 @@ +{% if site.gauges_id %} + + +{% endif %} + +{% if site.google_analytics_id %} + + +{% endif %} diff --git a/site/_includes/docs_contents.html b/site/_includes/docs_contents.html new file mode 100644 index 00000000..7e7637f3 --- /dev/null +++ b/site/_includes/docs_contents.html @@ -0,0 +1,82 @@ +
+ +
diff --git a/site/_includes/footer.html b/site/_includes/footer.html new file mode 100644 index 00000000..b0c084dc --- /dev/null +++ b/site/_includes/footer.html @@ -0,0 +1,15 @@ + +
diff --git a/site/_includes/header.html b/site/_includes/header.html new file mode 100644 index 00000000..70ba591d --- /dev/null +++ b/site/_includes/header.html @@ -0,0 +1,26 @@ +
+
+ + +
+
+
diff --git a/site/_includes/section_nav.html b/site/_includes/section_nav.html new file mode 100644 index 00000000..14ae1d2c --- /dev/null +++ b/site/_includes/section_nav.html @@ -0,0 +1,22 @@ +
+
+ {% if page.prev_section != null %} + + {% else %} + Back + {% endif %} +
+
+ {% if page.next_section != null %} + + {% else %} + Next + {% endif %} +
+
+
+ diff --git a/site/_includes/top.html b/site/_includes/top.html new file mode 100644 index 00000000..6ee24730 --- /dev/null +++ b/site/_includes/top.html @@ -0,0 +1,14 @@ + + + + + {{ page.title }} + + + + + + + + + diff --git a/site/_layouts/default.html b/site/_layouts/default.html new file mode 100644 index 00000000..80c9e4c1 --- /dev/null +++ b/site/_layouts/default.html @@ -0,0 +1,12 @@ +{% include top.html %} + + + {% include header.html %} + + {{ content }} + + {% include footer.html %} + {% include analytics.html %} + + + diff --git a/site/_layouts/docs.html b/site/_layouts/docs.html new file mode 100644 index 00000000..b88f7a58 --- /dev/null +++ b/site/_layouts/docs.html @@ -0,0 +1,21 @@ +--- +layout: default +--- + +
+
+ +
+
+

{{ page.title }}

+ {{ content }} + {% include section_nav.html %} +
+
+ + {% include docs_contents.html %} + +
+ +
+
diff --git a/site/_posts/2012-07-01-configuration.md b/site/_posts/2012-07-01-configuration.md new file mode 100644 index 00000000..a942914b --- /dev/null +++ b/site/_posts/2012-07-01-configuration.md @@ -0,0 +1,250 @@ +--- +layout: docs +title: Configuration +prev_section: structure +next_section: frontmatter +--- + +Jekyll allows you to concoct your sites in any way you can dream up, and it’s thanks to the powerful and flexible configuration options that this is possible. These options can either be specified in a `_config.yml` file placed in your site’s root directory, or can be specified as flags for the `jekyll` executable in the terminal. + +## Configuration Settings + +The table below lists the available settings for Jekyll, and the various options (specifed in the configuration file) and flags (specified on the command-line) that control them. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SettingOptions and Flags
+

Safe

+

Disables custom plugins.

+
+

safe: [boolean]

+

--safe

+
+

Regeneration

+

Enables or disables Jekyll from recreating the site when files are modified.

+
+

auto: [boolean]

+

--auto

+

--no-auto

+
+

Local Server

+

Fires up a server that will host your _site directory

+
+

server: [boolean]

+

--server

+
+

Local Server Port

+

Changes the port that the Jekyll server will run on

+
+

server_port: [integer]

+

--server [port]

+
+

Base URL

+

Serve website from a given base URL

+
+

baseurl: [BASE_URL]

+

--base-url [url]

+
+

URL

+

Sets site.url, useful for environment switching

+
+

url: [URL]

+

--url [URL]

+
+

Site Destination

+

Changes the directory where Jekyll will write files to

+
+

destination: [dir]

+

jekyll [dest]

+
+

Site Source

+

Changes the directory where Jekyll will look to transform files

+
+

source: [dir]

+

jekyll [source] [dest]

+
+

Markdown

+

Uses RDiscount or [engine] instead of Maruku.

+
+

markdown: [engine]

+

--rdiscount

+

--kramdown

+

--redcarpet

+
+

Pygments

+

Enables highlight tag with Pygments.

+
+

pygments: [boolean]

+

--pygments

+
+

Future

+

Publishes posts with a future date

+
+

future: [boolean]

+

--no-future

+

--future

+
+

LSI

+

Produces an index for related posts.

+
+

lsi: [boolean]

+

--lsi

+
+

Permalink

+

Controls the URLs that posts are generated with. Please refer to the Permalinks page for more info.

+
+

permalink: [style]

+

--permalink=[style]

+
+

Pagination

+

Splits your posts up over multiple subdirectories called "page2", "page3", ... "pageN"

+
+

paginate: [per_page]

+

--paginate [per_page]

+
+

Exclude

+

A list of directories and files to exclude from the conversion

+
+

exclude: [dir1, file1, dir2]

+
+

Include

+

A list of directories and files to specifically include in the conversion. .htaccess is a good example since dotfiles are excluded by default.

+
+

include: [dir1, file1, dir2]

+
+

Limit Posts

+

Limits the number of posts to parse and publish

+
+

limit_posts: [max_posts]

+

--limit_posts=[max_posts]

+
+ +
+
Do not use tabs in configuration files
+

This will either lead to parsing errors, or Jekyll will revert to the default settings. Use spaces instead.

+
+ +## Default Configuration + +Jekyll runs with the following configuration options by default. Unless alternative settings for these options are explicitly specified in the configuration file or on the command-line, Jekyll will run using these options. + +{% highlight yaml %} +safe: false +auto: false +server: false +server_port: 4000 +baseurl: / +url: http://localhost:4000 + +source: . +destination: ./_site +plugins: ./_plugins + +future: true +lsi: false +pygments: false +markdown: maruku +permalink: date + +maruku: + use_tex: false + use_divs: false + png_engine: blahtex + png_dir: images/latex + png_url: /images/latex + +rdiscount: + extensions: [] + +kramdown: + auto_ids: true, + footnote_nr: 1 + entity_output: as_char + toc_levels: 1..6 + use_coderay: false + + coderay: + coderay_wrap: div + coderay_line_numbers: inline + coderay_line_numbers_start: 1 + coderay_tab_width: 4 + coderay_bold_every: 10 + coderay_css: style + +{% endhighlight %} diff --git a/site/_posts/2012-07-01-contributing.md b/site/_posts/2012-07-01-contributing.md new file mode 100644 index 00000000..80e625b1 --- /dev/null +++ b/site/_posts/2012-07-01-contributing.md @@ -0,0 +1,66 @@ +--- +layout: docs +title: Contributing +prev_section: deployment-methods +next_section: troubleshooting +--- + +Contributions to Jekyll are always welcome, however there’s a few things that you should keep in mind to improve your chances of having your changes merged in. + +## Workflow + +Here’s the most typical way to get your change merged into the project: + +1. Fork the project [on GitHub](https://github.com/mojombo/jekyll) and clone it down to your local machine. +2. Create a topic branch to contain your change. +3. Hack away, add tests. Not necessarily in that order. +4. Make sure all the existing tests still pass. +5. If necessary, rebase your commits into logical chunks, without errors. +6. Push the branch up to your fork on GitHub. +7. Create an issue on GitHub with a link to your branch. + +
+
Contributions will not be accepted without tests
+

If you’re creating a small fix or patch to an existing feature, just + a simple test will do.

+
+ +## Tests + +We’re big on tests, so please be sure to include them. Please stay in the confines of the current test suite and use [Shoulda](https://github.com/thoughtbot/shoulda) and [RR](https://github.com/btakita/rr). + +### Tests for brand-new features + +If it’s a brand new feature, make sure to create a new [Cucumber](https://github.com/cucumber/cucumber/) feature and reuse steps where appropriate. Also, whipping up some documentation in your fork’s `gh-pages` branch would be appreciated, so the main website can be updated as soon as your new feature is merged. + +### Test dependencies + +To run the test suite and build the gem you’ll need to install Jekyll’s dependencies. Jekyll uses Bundler, so a quick run of the bundle command and you’re all set! + +{% highlight bash %} +$ bundle +{% endhighlight %} + +Before you start, run the tests and make sure that they pass (to confirm +your environment is configured properly): + +{% highlight bash %} +$ rake test +$ rake features +{% endhighlight %} + +## Common Gotchas + +- If you want to bump the gem version, please put that in a separate + commit. This way, the maintainers can control when the gem gets released. +- Try to keep your patch(es) based from [the latest commit on + mojombo/jekyll](https://github.com/mojombo/jekyll/commits/master). The easier it is to apply your work, the less work + the maintainers have to do, which is always a good thing. +- Please don’t tag your GitHub issue with labels like “fix” or “feature”. + The maintainers actively read the issues and will label it once they come + across it. + +
+
Let us know what could be better!
+

Both using and hacking on Jekyll should be fun, simple, and easy, so if for some reason you find it’s a pain, please create an issue on GitHub describing your experience so we can make it better.

+
diff --git a/site/_posts/2012-07-01-deployment-methods.md b/site/_posts/2012-07-01-deployment-methods.md new file mode 100644 index 00000000..7716e5f8 --- /dev/null +++ b/site/_posts/2012-07-01-deployment-methods.md @@ -0,0 +1,108 @@ +--- +layout: docs +title: Deployment methods +prev_section: github-pages +next_section: contributing +--- + +Sites built using Jekyll can be deployed in a large number of ways due to the static nature of the generated output. A few of the most common deployment techniques are described below. + +## Web hosting providers (FTP) + +Just about any traditional web hosting provider will let you upload files to their servers over FTP. To upload a Jekyll site to a web host using FTP, simply run the `jekyll` command and copy the generated `_site` folder to the root folder of your hosting account. This is most likely to be the `httpdocs` or `public_html` folder on most hosting providers. + +### FTP using Glynn + +There is a project called [Glynn](https://github.com/dmathieu/glynn), which lets you easily generate your Jekyll powered website’s static files and +send them to your host through FTP. + +## Self-managed web server + +If you have direct access yourself to the deployment web server yourself, the process is essentially the same, except you might have other methods available to you (such as `scp`, or even direct filesystem access) for transferring the files. Just remember to make sure the contents of the generated `_site` folder get placed in the appropriate web root directory for your web server. + +## Automated methods + +There are also a number of ways to easily automate the deployment of a Jekyll site. If you’ve got another method that isn’t listed below, we’d love it if you [contributed](../contributing) so that everyone else can benefit too. + +### Git post-update hook + +If you store your jekyll site in [Git](http://git-scm.com/) (you are using version control, right?), it’s pretty easy to automate the +deployment process by setting up a post-update hook in your Git +repository, [like +this](http://web.archive.org/web/20091223025644/http://www.taknado.com/en/2009/03/26/deploying-a-jekyll-generated-site/). + +### Git post-receive hook + +To have a remote server handle the deploy for you every time you push changes using Git, you can create a user account which has all the public keys that are authorized to deploy in its `authorized_keys` file. With that in place, setting up the post-receive hook is done as follows: + +{% highlight bash %} +laptop$ ssh deployer@myserver.com +server$ mkdir myrepo.git +server$ cd myrepo.git +server$ git --bare init +server$ cp hooks/post-receive.sample hooks/post-receive +server$ mkdir /var/www/myrepo +{% endhighlight %} + +Next, add the following lines to hooks/post-receive and be sure Jekyll is +installed on the server: + +{% highlight bash %} +GIT_REPO=$HOME/myrepo.git +TMP_GIT_CLONE=$HOME/tmp/myrepo +PUBLIC_WWW=/var/www/myrepo + +git clone $GIT_REPO $TMP_GIT_CLONE +jekyll --no-auto $TMP_GIT_CLONE $PUBLIC_WWW +rm -Rf $TMP_GIT_CLONE +exit +{% endhighlight %} + +Finally, run the following command on any users laptop that needs to be able to +deploy using this hook: + +{% highlight bash %} +laptops$ git remote add deploy deployer@myserver.com:~/myrepo.git +{% endhighlight %} + +Deploying is now as easy as telling nginx or Apache to look at +`/var/www/myrepo` and running the following: + +{% highlight bash %} +laptops$ git push deploy master +{% endhighlight %} + +### Rake + +Another way to deploy your Jekyll site is to use [Rake](https://github.com/jimweirich/rake), [HighLine](https://github.com/JEG2/highline), and +[Net::SSH](http://net-ssh.rubyforge.org/). A more complex example of deploying Jekyll with Rake that deals with multiple branches can be found in [Git Ready](https://github.com/gitready/gitready/blob/en/Rakefile). + +### rsync + +Once you’ve generated the `_site` directory, you can easily rsync it using a `tasks/deploy` shell script similar to [this deploy script here](http://github.com/henrik/henrik.nyh.se/blob/master/tasks/deploy). You’d obviously need to change the values to reflect your site’s details. There is even [a matching TextMate command](http://gist.github.com/214959) that will help you run +this script from within Textmate. + + +## Rack-Jekyll + +[Rack-Jekyll](http://github.com/bry4n/rack-jekyll/) is an easy way to deploy your site on any Rack server such as Amazon EC2, Slicehost, Heroku, and so forth. It also can run with [shotgun](http://github.com/rtomakyo/shotgun/), [rackup](http://github.com/rack/rack), [mongrel](http://github.com/mongrel/mongrel), [unicorn](http://github.com/defunkt/unicorn/), and [others](https://github.com/adaoraul/rack-jekyll#readme). + +Read [this post](http://blog.crowdint.com/2010/08/02/instant-blog-using-jekyll-and-heroku.html) on how to deploy to Heroku using Rack-Jekyll. + +## Jekyll-Admin for Rails + +If you want to maintain Jekyll inside your existing Rails app, [Jekyll-Admin](http://github.com/zkarpinski/Jekyll-Admin) contains drop in code to make this possible. See Jekyll-Admin’s [README](http://github.com/zkarpinski/Jekyll-Admin/blob/master/README) for more details. + +## Amazon S3 + +If you want to host your site in Amazon S3, you can do so with +[jekyll-s3](https://github.com/laurilehmijoki/jekyll-s3) application. It will +push your site to Amazon S3 where it can be served like any web server, +dynamically scaling to almost unlimited traffic. This approach has the +benefit of being about the cheapest hosting option available for +low-volume blogs as you only pay for what you use. + +
+
ProTip™: Use GitHub Pages for zero-hassle Jekyll hosting
+

GitHub Pages are powered by Jekyll behind the scenes, so if you’re looking for a zero-hassle, zero-cost solution, GitHub Pages are a great way to host your Jekyll-powered website for free.

+
diff --git a/site/_posts/2012-07-01-extras.md b/site/_posts/2012-07-01-extras.md new file mode 100644 index 00000000..1af24d10 --- /dev/null +++ b/site/_posts/2012-07-01-extras.md @@ -0,0 +1,103 @@ +--- +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 --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 %} + diff --git a/site/_posts/2012-07-01-frontmatter.md b/site/_posts/2012-07-01-frontmatter.md new file mode 100644 index 00000000..982e5ec1 --- /dev/null +++ b/site/_posts/2012-07-01-frontmatter.md @@ -0,0 +1,120 @@ +--- +layout: docs +title: Front-matter +prev_section: configuration +next_section: posts +--- + +The front-matter is where Jekyll starts to get really cool. Any files that contain a [YAML](http://yaml.org/) front matter block will be processed by Jekyll as special files. The front matter must be the first thing in the file and must take the form of sets of variables and values set between triple-dashed lines. Here is a basic example: + +{% highlight yaml %} +--- +layout: post +title: Blogging Like a Hacker +--- +{% endhighlight %} + +Between these triple-dashed lines, you can set predefined variables (see below for a reference) or even create custom ones of your own. These variables will then be available to you to access using Liquid tags both further down in the file and also in any layouts or includes that the page or post in question relies on. + +
+
UTF-8 Character Encoding Warning
+

If you use UTF-8 encoding, make sure that no BOM header characters exist in your files or very, very bad things will happen to Jekyll. This is especially relevant if you’re running Jekyll on Windows.

+
+ +## Predefined Global Variables + +There are a number of predefined global variables that you can set in the front-matter of a page or post. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VariableDescription
+

layout

+
+

If set, this specifies the layout file to use. Use the layout file name without file extension. Layout files must be placed in the _layouts directory.

+
+

permalink

+
+

If you need your processed URLs to be something other than the default /year/month/day/title.html then you can set this variable and it will be used as the final URL.

+
+

published

+
+

Set to false if you don’t want a post to show up when the site is generated.

+
+

category

+

categories

+
+

Instead of placing posts inside of folders, you can specify one or more categories that the post belongs to. When the site is generated the post will act as though it had been set with these categories normally. Categories (plural key) can be specified as a YAML list or a space-separated string.

+
+

tags

+
+

Similar to categories, one or multiple tags can be added to a post. Also like categories, tags can be specified as a YAML list or a space-separated string.

+
+ + +## Custom Variables + +Any variables in the front matter that are not predefined are mixed into +the data that is sent to the Liquid templating engine during the +conversion. For instance, if you set a title, you can use that in your +layout to set the page title: + +{% highlight html %} + + + + {{ "{{ page.title " }}}} + + + ... +{% endhighlight %} + +## Predefined Variables for Posts + +These are available out-of-the-box to be used in the front-matter for a +post. + + + + + + + + + + + + + + +
VariableDescription
+

date

+
+

A date here overrides the date from the name of the post. This can be used to ensure correct sorting of posts.

+
diff --git a/site/_posts/2012-07-01-github-pages.md b/site/_posts/2012-07-01-github-pages.md new file mode 100644 index 00000000..dbe8434a --- /dev/null +++ b/site/_posts/2012-07-01-github-pages.md @@ -0,0 +1,34 @@ +--- +layout: docs +title: GitHub Pages +prev_section: extras +next_section: deployment-methods +--- + +[GitHub Pages](https://pages.github.com) are public web pages for users, organizations, and repositories, that are freely hosted on [GitHub](https://github.com/). GitHub Pages are powered by Jekyll behind the scenes, so in addition to supporting regular HTML content, they’re also a great way to host your Jekyll-powered website for free. + +## Deploying Jekyll to GitHub Pages + +GitHub Pages work by looking at certain branches of repositories on GitHub. There are two basic types of Pages available, user/organization Pages and project Pages. The way to deploy these two types of pages are nearly identical, except for a few minor details. + +### User and Organization Pages + +User and organization Pages live in a special GitHub repository dedicated to only the Pages files. This repository must be named after the account name. For example, [@mojombo’s user page repository](https://github.com/mojombo/mojombo.github.com) has the name `mojombo.github.com`. + +Content from the `master` branch of your repository will be used to build and publish the GitHub Pages site, so make sure your Jekyll site is stored there. + +
+
Custom domains do not affect repository names
+

GitHub Pages are initially configured to live under the `username.github.com` subdomain, which is why repositories must be named this way even if a custom domain is being used.

+
+ +### Project Pages + +Unlike user and organization Pages, Project Pages are kept in the same repository as the project they are for, except that the website content is stored in a specially named `gh-pages` branch. The content of this branch will be used to rendered using Jekyll, and the output will become available under a subpath of your user pages subdomain, such as `username.github.com/project` (unless a custom domain is specified—see below). + +The Jekyll project repository itself is a perfect example of this branch structure—the [master branch](https://github.com/mojombo/jekyll) contains the actual software project for Jekyll, however the Jekyll website (that you’re looking at right now) is contained in the [gh-pages branch](https://github.com/mojombo/jekyll/tree/gh-pages) of the same repository. + +
+
GitHub Pages Documentation, Help, and Support
+

For more information about what you can do with GitHub Pages, as well as for troubleshooting guides, you should check out GitHub’s Pages Help section. If all else fails, you should contact GitHub Support.

+
diff --git a/site/_posts/2012-07-01-heroku.md b/site/_posts/2012-07-01-heroku.md new file mode 100644 index 00000000..091239c5 --- /dev/null +++ b/site/_posts/2012-07-01-heroku.md @@ -0,0 +1,8 @@ +--- +layout: docs +title: Heroku +prev_section: github-pages +next_section: manual-deployment +--- + +Move along, people. Nothing to see here. diff --git a/site/_posts/2012-07-01-home.md b/site/_posts/2012-07-01-home.md new file mode 100644 index 00000000..9c27eeef --- /dev/null +++ b/site/_posts/2012-07-01-home.md @@ -0,0 +1,47 @@ +--- +layout: docs +title: Welcome +next_section: installation +--- + +This site aims to be a comprehensive guide to Jekyll. We’ll cover everything from getting your site up and running, creating and managing your content, customizing the way your site works and looks, deploying to various environments, as well as some advice on participating in the future development of Jekyll itself. + +## So what is Jekyll, exactly? + +Jekyll is a simple, blog-aware, static site generator. It takes a template directory containing raw text files in various formats, runs it through [Markdown](http://daringfireball.net/projects/markdown/) (or [Textile](http://textile.sitemonks.com/)) and [Liquid](http://liquidmarkup.org/) converters, and spits out a complete, ready-to-publish static website suitable for serving with your favorite web server. Jekyll also happens to be the engine behind [GitHub Pages](http://pages.github.com), which means you can use Jekyll to host your project’s page, blog, or website from GitHub’s servers **for free**. + +## Quick-start guide + +For the impatient, here's how to get Jekyll up and running. + +{% highlight bash %} +~ $ gem install jekyll +~ $ mkdir -p my/new/site +~ $ cd my/new/site +~ $ vim index.html +~/my/new/site $ jekyll --server +# => Now browse to http://localhost:4000 +{% endhighlight %} + +That's nothing though. The real magic happens when you start creating posts, using the front-matter to conrol templates and layouts, and taking advantage of all the awesome configuration options Jekyll makes available. + +## ProTips™, Notes, and Warnings + +Throughout this guide there are a number of small-but-handy pieces of information that can make using Jekyll easier, more interesting, and less hazardous. Here’s what to look out for. + +
+
ProTips™ help you get more from Jekyll
+

These are tips and tricks that will help you be a Jekyll wizard!

+
+ +
+
Notes are handy pieces of information
+

These are for the extra tidbits sometimes necessary to understand Jekyll.

+
+ +
+
Warnings help you not blow things up
+

Be aware of these messages if you wish to avoid certain death.

+
+ +If you come across anything along the way that we haven’t covered, or if you know of a tip yourself you think others would find handy, please [file an issue](https://github.com/mojombo/jekyll/issues/new) and we’ll see about including it in this guide. diff --git a/site/_posts/2012-07-01-installation.md b/site/_posts/2012-07-01-installation.md new file mode 100644 index 00000000..190645fb --- /dev/null +++ b/site/_posts/2012-07-01-installation.md @@ -0,0 +1,43 @@ +--- +layout: docs +title: Installation +prev_section: home +next_section: usage +--- + +Getting Jekyll installed and ready-to-go should only take a few minutes. If it ever becomes a pain in the ass, you should [file an issue](https://github.com/mojombo/jekyll/issues/new) (or submit a pull request) about what might be a better way to do things. + +### Requirements + +Installing Jekyll is easy and straight-forward, but there’s a few requirements you’ll need to make sure your system has before you start. + +- [Ruby](http://www.ruby-lang.org/en/downloads/) +- [RubyGems](http://rubygems.org/pages/download) +- Linux, Unix, or Mac OS X + +
+
Running Jekyll on Windows
+

It is possible to get Jekyll running on Windows however the official documentation does not support installation on Windows platforms.

+
+ +## Install with RubyGems + +The best way to install Jekyll is via +[RubyGems](http://docs.rubygems.org/read/chapter/3). At the terminal prompt, simply run the following command to install Jekyll: + +{% highlight bash %} +gem install jekyll +{% endhighlight %} + +All Jekyll’s gem dependancies are automatically installed by the above command, so you won’t have to worry about them at all. If you have problems installing Jekyll, check out the [troubleshooting](../troubleshooting) page or [report an issue](https://github.com/mojombo/jekyll/issues/new) so the Jekyll community can improve the experience for everyone. + +## Optional 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. These extras include syntax highlighting of code snippets using [Pygments](http://pygments.org/), LaTeX support, and the use of alternative content rendering engines. Check out [the extras page](../extras) for more information. + +
+
ProTip™: Enable Syntax Highlighting
+

If you’re the kind of person who is using Jekyll, then chances are you’ll definitely want to enable syntax highlighting using Pygments. You should really check out how to do that before you go any further.

+
+ +Now that you’ve got everything installed, let’s get to work! diff --git a/site/_posts/2012-07-01-migrations.md b/site/_posts/2012-07-01-migrations.md new file mode 100644 index 00000000..3360fe4b --- /dev/null +++ b/site/_posts/2012-07-01-migrations.md @@ -0,0 +1,180 @@ +--- +layout: docs +title: Blog migrations +prev_section: variables +next_section: templates +--- + +If you’re switching to Jekyll from another blogging system, Jekyll’s migrators can help you with the move. Most methods listed on this page require read access to the database to generate posts from your old system. Each method generates `.markdown` posts in the `_posts` directory based on the entries in the database. + +## Preparing for migrations + +The migrators are [built-in to the Jekyll gem](https://github.com/mojombo/jekyll/tree/master/lib/jekyll/migrators), and require a few things to be set up in your project directory before they are run. This should all be done from the root folder of your Jekyll project. + +{% highlight bash %} +$ mkdir _import +$ gem install sequel mysqlplus +{% endhighlight %} + +You should now be all set to run the migrators below. + +
+
Note: Always double-check migrated content
+

Import scripts may not distinguish between published or private posts, so you should always check that the content Jekyll generates for you appears as you intended.

+
+ +## WordPress + +### Wordpress export files + +If hpricot is not already installed, you will need to run `gem install hpricot`. Next, export your blog using the Wordpress export utility. Assuming that exported file is saved as `wordpress.xml`, here is the command you need to run: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/wordpressdotcom"; + Jekyll::WordpressDotCom.process("wordpress.xml")' +{% endhighlight %} + +
+
ProTip™: Wordpress.com Export Tool
+

If you are migrating from a Wordpress.com account, you can access the export tool at the following URL: `https://YOUR-USER-NAME.wordpress.com/wp-admin/export.php`.

+
+ +### Using Wordpress MySQL server connection + +If you want to import using a direct connection to the Wordpress MySQL server, here's how: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/wordpress"; + Jekyll::WordPress.process("database", "user", "pass")' +{% endhighlight %} + +If you are using Webfaction and have to set an [SSH tunnel](http://docs.webfaction.com/user-guide/databases.html?highlight=mysql#starting-an-ssh-tunnel-with-ssh), make sure to make the hostname (`127.0.0.1`) explicit, otherwise MySQL may block your access based on localhost and `127.0.0.1` not being equivalent in its authentication system: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/wordpress"; + Jekyll::WordPress.process("database", "user", "pass", "127.0.0.1")' +{% endhighlight %} + +### Further Wordpress migration alternatives + +While the above methods work, they do not import much of the metadata that is usually stored in Wordpress posts and pages. If you need to export things like pages, tags, custom fields, image attachments and so on, the following resources might be useful to you: + +- [Exitwp](https://github.com/thomasf/exitwp) is a configurable tool written in Python for migrating one or more Wordpress blogs into Jekyll (Markdown) format while keeping as much metadata as possible. Exitwp also downloads attachments and pages. +- [A great article](http://vitobotta.com/how-to-migrate-from-wordpress-to-jekyll/) with a step-by-step guide for migrating a Wordpress blog to Jekyll while keeping most of the structure and metadata. +- [wpXml2Jekyll](https://github.com/theaob/wpXml2Jekyll) is an executable windows application for creating Markdown posts from your Wordpress XML file. + +## Drupal + +If you’re migrating from [Drupal](), there is [a migrator](https://github.com/mojombo/jekyll/blob/master/lib/jekyll/migrators/drupal.rb) for you too: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/drupal"; + Jekyll::Drupal.process("database", "user", "pass")' +{% endhighlight %} + +
+
Warning: Drupal Version Compatibility
+

This migrator was written for Drupal 6.1 and may not work as expected on future versions of Drupal. Please update it and send us a pull request if necessary.

+
+ +## Movable Type + +To import posts from Movable Type: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/mt"; + Jekyll::MT.process("database", "user", "pass")' +{% endhighlight %} + +## Typo + +To import posts from Typo: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/typo"; + Jekyll::Typo.process("database", "user", "pass")' +{% endhighlight %} + +This code also has only been tested with Typo version 4+. + +## TextPattern + +To import posts from TextPattern: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/textpattern"; + Jekyll::TextPattern.process("database_name", "username", "password", "hostname")' +{% endhighlight %} + +You will need to run the above from the parent directory of your `_import` folder. For example, if `_import` is located in `/path/source/_import`, you will need to run this code from `/path/source`. The hostname defaults to `localhost`, all other variables are required. You may need to adjust the code used to filter entries. Left alone, it will attempt to pull all entries that are live or sticky. + +## Mephisto + +To import posts from Mephisto: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/mephisto"; + Jekyll::Mephisto.process("database", "user", "password")' +{% endhighlight %} + +If your data is in Postgres, you should do this instead: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/mephisto"; + Jekyll::Mephisto.postgres({:database => "database", :username=>"username", :password =>"password"})' +{% endhighlight %} + +## Blogger (Blogspot) + +To import posts from Blogger, see [this post about migrating from Blogger to Jekyll](http://coolaj86.info/articles/migrate-from-blogger-to-jekyll.html). If that doesn’t work for you, you might want to try some of the following alternatives: + +- [@kennym](https://github.com/kennym) created a [little migration script](https://gist.github.com/1115810), because the solutions in the previous article didn't work out for him. +- [@ngauthier](https://github.com/ngauthier) created [another importer](https://gist.github.com/1506614) that imports comments, and does so via blogger’s archive instead of the RSS feed. +- [@juniorz](https://github.com/juniorz) created [yet another importer](https://gist.github.com/1564581) that works for [Octopress](http://octopress.org). It is like [@ngauthier’s version](https://gist.github.com/1506614) but separates drafts from posts, as well as importing tags and permalinks. + +## Posterous + +To import posts from your primary Posterous blog: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/posterous"; + Jekyll::Posterous.process("my_email", "my_pass")' +{% endhighlight %} + +For any other Posterous blog on your account, you will need to specify the `blog_id` for the blog: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/posterous"; + Jekyll::Posterous.process("my_email", "my_pass", "blog_id")' +{% endhighlight %} + +There is also an [alternative Posterous migrator](https://github.com/pepijndevos/jekyll/blob/patch-1/lib/jekyll/migrators/posterous.rb) that maintains permalinks and attempts to import images too. + +## Tumblr + +To import posts from Tumblr: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/tumblr"; + Jekyll::Tumblr.process("http://www.your_blog_url.com", true)' +{% endhighlight %} + +There is also [a modified Tumblr migrator](https://github.com/stephenmcd/jekyll/blob/master/lib/jekyll/migrators/tumblr.rb) that exports posts as Markdown and preserves post tags. + +The migrator above requires the `json` gem and Python's `html2text` to be installed as follows: + +{% highlight bash %} +$ gem install json +$ pip install html2text +{% endhighlight %} + +Once installed, simply use the format argument: + +{% highlight bash %} +$ ruby -rubygems -e 'require "jekyll/migrators/tumblr"; + Jekyll::Tumblr.process("http://www.your_blog_url.com", format="md")' +{% endhighlight %} + +## Other Systems + +If you have a system that there isn’t currently a migrator for, you should consider writing one and sending us a pull request. \ No newline at end of file diff --git a/site/_posts/2012-07-01-pages.md b/site/_posts/2012-07-01-pages.md new file mode 100644 index 00000000..c53e06c2 --- /dev/null +++ b/site/_posts/2012-07-01-pages.md @@ -0,0 +1,62 @@ +--- +layout: docs +title: Creating pages +prev_section: posts +next_section: variables +--- + +As well as [writing posts](../posts), the other thing you may want to do with your Jekyll site is create static pages. This is pretty simple to do, simply by taking advantage of the way Jekyll copies files and directories. + +## Homepage + +Just about every web server configuration you’ll come across will look for a HTML file called `index.html` (by convention) in the site root folder and display that as the homepage. Unless the web server you’re using is configured to look for some different filename as the default, this file will turn into the homepage of your Jekyll-generated site. + +
+
ProTip™: Use layouts on your homepage
+

Any HTML file on your site can make use of layouts and includes, even the homepage. It’s usually a good idea to extract everything that is the same across all your pages into an included file in a layout.

+
+ +## Where additional pages live + +Where you put HTML files for pages depends on how you want the pages to work, since there are two main ways of creating pages: + +- By placing named HTML files for each page in the site root folder. +- Create a folder in the site root for each page, and placing an index.html file in each page folder. + +Both methods work fine (and can be used in conduction with each other), with the only real difference being the resulting URLs each page has. + +### Named HTML files + +The simplest way of adding a page is just to add a HTML file in the root directory with a suitable name for the page you want to create. For a site with a homepage, an about page, and a contact page, here’s what the root directory and associated URLs might look like. + +{% highlight bash %} +. +|-- _config.yml +|-- _includes +|-- _layouts +|-- _posts +|-- _site +|-- about.html #=> http://yoursite.com/about.html +|-- index.html #=> http://yoursite.com/ +└── contact.html #=> http://yoursite.com/contact.html +{% endhighlight %} + +### Named folders containing index HTML files + +There is nothing wrong with the above method, however some people like to keep their URLs free from things like filename extensions. To achieve clean URLs for pages using Jekyll, you simply need to create a folder for each top-level page you want, and then place an `index.html` file in each page’s folder. This way the page URL ends up being the folder name, and the web server will serve up the respective `index.html` file. An example of what this structure would look like is as follows: + +{% highlight bash %} +. +├── _config.yml +├── _includes +├── _layouts +├── _posts +├── _site +├── about +| └── index.html #=> http://yoursite.com/about/ +├── contact +| └── index.html #=> http://yoursite.com/contact/ +└── index.html #=> http://yoursite.com/ +{% endhighlight %} + +This approach may not suit everyone, but for people who like clear URLs it’s simple and it works. In the end the decision is yours! diff --git a/site/_posts/2012-07-01-pagination.md b/site/_posts/2012-07-01-pagination.md new file mode 100644 index 00000000..a82d0fdb --- /dev/null +++ b/site/_posts/2012-07-01-pagination.md @@ -0,0 +1,116 @@ +--- +layout: docs +title: Pagination +prev_section: permalinks +next_section: plugins +--- + +With many websites—especially blogs—it’s very common to break the main listing of posts up into smaller lists and display them over multiple pages. Jekyll has pagination built-in, so you can automatically generate the appropriate files and folders you need for paginated post listings. + +
+
Pagination only works within HTML files
+

Pagination does not work with Markdown or Textile files in your Jekyll site. It will only work when used within HTML files. Since you’ll likely be using this for the list of posts, this probably won’t be an issue.

+
+ +## Enable pagination + +The first thing you need to do to enable pagination for your blog is add a line to the `_config.yml` Jekyll configuration file that specifies how many items should be displayed per page. Here is what the line should look like: + +{% highlight yaml %} +paginate: 5 +{% endhighlight %} + +The number should be the maximum number of posts you’d like to be displayed per-page in the generated site. + +## Render the paginated posts + +The next thing you need to do is to actually display your posts in a list using the `paginator` variable that will now be available to you. You’ll probably want to do this in one of the main pages of your site. Here’s one example of a simple way of rendering paginated posts in a HTML file: + +{% highlight html %} +--- +layout: default +title: My Blog +--- + + +{{ "{% for post in paginator.posts " }}%} +

{{ "{{ post.title " }}}}

+

+ {{ "{{post.date" }}}} +

+
+ {{ "{{ post.content " }}}} +
+{{ "{% endfor " }}%} + + + +{% endhighlight %} + +
+
Beware the page one edge-case
+

Jekyll does not generate a ‘page1’ folder, so the above code will not work when a /page1 link is produced. See below for a way to handle this if it’s a problem for you.

+
+ +The following HTML snippet should handle page one, and render a list of each page with links to all but the current page. + +{% highlight html %} + +{% endhighlight %} diff --git a/site/_posts/2012-07-01-permalinks.md b/site/_posts/2012-07-01-permalinks.md new file mode 100644 index 00000000..9bee0d72 --- /dev/null +++ b/site/_posts/2012-07-01-permalinks.md @@ -0,0 +1,163 @@ +--- +layout: docs +title: Permalinks +prev_section: templates +next_section: pagination +--- + +Jekyll supports a flexible way to build your site’s URLs. You can +specify the permalinks for your site through the [Configuration](../configuration) or on the [YAML Front Matter](../frontmatter) for each post. You’re free to choose one of the built-in styles to create your links or craft your own. The default style is always `date`. + +## Template variables + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VariableDescription
+

year

+
+

Year from the post’s filename

+
+

month

+
+

Month from the post’s filename

+
+

day

+
+

Day from the post’s filename

+
+

title

+
+

Title from the post’s filename

+
+

categories

+
+

The specified categories for this post. Jekyll automatically parses out double slashes in the URLs, so if no categories are present, it basically ignores this.

+
+

i_month

+
+

 Month from the post’s filename without leading zeros.

+
+

i_day

+
+

Day from the post’s filename without leading zeros.

+
+ +## Built-in permalink styles + + + + + + + + + + + + + + + + + + + + + + +
Permalink StyleURL Template
+

date

+
+

/:categories/:year/:month/:day/:title.html

+
+

pretty

+
+

/:categories/:year/:month/:day/:title/

+
+

none

+
+

/:categories/:title.html

+
+ +## Permalink style examples + +Given a post named: `/2009-04-29-slap-chop.textile` + + + + + + + + + + + + + + + + + + + + + + + + + + +
Permalink SettingResulting Permalink URL
+

None specified, or permalink: date

+
+

/2009/04/29/slap-chop.html

+
+

permalink: pretty

+
+

/2009/04/29/slap-chop/index.html

+
+

permalink: /:month-:day-:year/:title.html

+
+

/04-29-2009/slap-chop.html

+
+

permalink: /blog/:year/:month/:day/:title

+
+

/blog/2009/04/29/slap-chop/index.html

+
+ diff --git a/site/_posts/2012-07-01-plugins.md b/site/_posts/2012-07-01-plugins.md new file mode 100644 index 00000000..6543e621 --- /dev/null +++ b/site/_posts/2012-07-01-plugins.md @@ -0,0 +1,384 @@ +--- +layout: docs +title: Plugins +prev_section: assets +next_section: extras +--- + +Jekyll has a plugin system with hooks that allow you to create custom generated +content specific to your site. You can run custom code for your site +without having to modify the Jekyll source itself. + +
+
Plugins on GitHub Pages
+

GitHub Pages are powered by Jekyll, however all Pages sites are generated using the --safe option to disable custom plugins for security reasons. Unfortunately, this means your plugins won’t work if you’re deploying to GitHub Pages.

+
+ +## Installing a plugin + +In your site source root, make a `_plugins` directory. Place your plugins +here. Any file ending in `*.rb` inside this directory will be required +when Jekyll generates your site. + +In general, plugins you make will fall into one of three categories: + +1. Generators +2. Converters +3. Tags + +## Generators + +You can create a generator when you need Jekyll to create additional +content based on your own rules. For example, a generator might look +like this: + +{% highlight ruby %} +module Jekyll + + class CategoryPage < Page + def initialize(site, base, dir, category) + @site = site + @base = base + @dir = dir + @name = 'index.html' + + self.process(@name) + self.read_yaml(File.join(base, '_layouts'), 'category_index.html') + self.data['category'] = category + + category_title_prefix = site.config['category_title_prefix'] || 'Category: ' + self.data['title'] = "#{category_title_prefix}#{category}" + end + end + + class CategoryPageGenerator < Generator + safe true + + def generate(site) + if site.layouts.key? 'category_index' + dir = site.config['category_dir'] || 'categories' + site.categories.keys.each do |category| + site.pages << CategoryPage.new(site, site.source, File.join(dir, category), category) + end + end + end + end + +end +{% endhighlight %} + +In this example, our generator will create a series of files under the +`categories` directory for each category, listing the posts in each +category using the `category_index.html` layout. + +Generators are only required to implement one method: + + + + + + + + + + + + + + +
MethodDescription
+

generate

+
+

String output of the content being generated.

+
+ +## Converters + +If you have a new markup language you’d like to include in your site, +you can include it by implementing your own converter. Both the markdown +and textile markup languages are implemented using this method. + +
+
Remember your YAML front-matter
+

Jekyll will only convert files that have a YAML header at +the top, even for converters you add using a plugin. If there is no YAML header, Jekyll will ignore the file and not send it through the converter.

+
+ +Below is a converter that will take all posts ending in .upcase and +process them using the UpcaseConverter: + +{% highlight ruby %} +module Jekyll + class UpcaseConverter < Converter + safe true + priority :low + + def matches(ext) + ext =~ /upcase/i + end + + def output_ext(ext) + ".html" + end + + def convert(content) + content.upcase + end + end +end +{% endhighlight %} + +Converters should implement at a minimum 3 methods: + + + + + + + + + + + + + + + + + + + + + + +
MethodDescription
+

matches

+
+

Called to determine whether the specific converter will +run on the page.

+
+

output_ext

+
+

The extension of the outputted file, usually this will be .html

+
+

convert

+
+

Logic to do the content conversion

+
+ +In our example, UpcaseConverter-matches checks if our filename extension is `.upcase`, and will render using the converter if it is. It will call UpcaseConverter-convert to process the content - in our simple converter we’re simply capitalizing the entire content string. Finally, when it saves the page, it will do so with the `.html` extension. + +## Tags + +If you’d like to include custom liquid tags in your site, you can do so +by hooking into the tagging system. Built-in examples added by Jekyll +include the `{{"{% highlight "}}%}` and `{{"{% include "}}%}` tags. Below is an example custom liquid tag that will output the time the page was rendered: + +{% highlight ruby %} +module Jekyll + class RenderTimeTag < Liquid::Tag + + def initialize(tag_name, text, tokens) + super + @text = text + end + + def render(context) + "#{@text} #{Time.now}" + end + end +end + +Liquid::Template.register_tag('render_time', Jekyll::RenderTimeTag) +{% endhighlight %} + +At a minimum, liquid tags must implement: + + + + + + + + + + + + + + +
MethodDescription
+

render

+
+

Outputs the content of the tag.

+
+ +You must also register the custom tag with the Liquid template engine as follows: + +{% highlight ruby %} +Liquid::Template.register_tag('render_time', Jekyll::RenderTimeTag) +{% endhighlight %} + +In the example above, we can place the following tag anywhere in one of our pages: + +{% highlight ruby %} +

{{"{% render_time page rendered at: "}}%}

+{% endhighlight %} + +And we would get something like this on the page: + +{% highlight html %} +

page rendered at: Tue June 22 23:38:47 –0500 2010

+{% endhighlight %} + +### Liquid filters + +You can add your own filters to the Liquid template system much like you can add tags above. Filters are simply modules that export their methods to liquid. All methods will have to take at least one parameter which represents the input of the filter. The return value will be the output of the filter. + +{% highlight ruby %} +module Jekyll + module AssetFilter + def asset_url(input) + "http://www.example.com/#{input}?#{Time.now.to_i}" + end + end +end + +Liquid::Template.register_filter(Jekyll::AssetFilter) +{% endhighlight %} + +
+
ProTip™: Access the site object using Liquid
+

Jekyll lets you access the site object through the context.registers feature of liquid. For example, you can access the global configuration file _config.yml using context.registers.config.

+
+ +### Flags + +There are two flags to be aware of when writing a plugin: + + + + + + + + + + + + + + + + + + +
FlagDescription
+

safe

+
+

A boolean flag that allows a plugin to be safely included in +Jekyll core for exclusion from use with GitHub Pages. In general, set +this to true.

+
+

priortiy

+
+

This flag determines what order the plugin is loaded in. Valid +values are: :lowest, :low, :normal, :high, and :highest.

+
+ +To use one of the example plugins above as an illustration, here is how you’d specify these two flags: + +{% highlight ruby %} +module Jekyll + class UpcaseConverter < Converter + safe true + priority :low + ... + end +end +{% endhighlight %} + + +## Available Plugins + +There are a few useful, prebuilt plugins at the following locations: + +- [Truncate HTML while preserving markup structure](https://github.com/MattHall/truncatehtml) by [Matt Hall](http://codebeef.com) +- [Generic Blog Plugins by Jose Diaz-Gonzalez](https://github.com/josegonzalez/josediazgonzalez.com/tree/master/_plugins): Contains plugins for tags, categories, archives, as well as a few liquid extensions +- [Domain Name Filter by Lawrence Woodman](https://github.com/LawrenceWoodman/domain_name-liquid_filter): Filters the input text so that just the domain name is left +- [Jekyll Plugins by Recursive Design](http://recursive-design.com/projects/jekyll-plugins/): Plugin to generate Project pages from github readmes, a Category page plugin, and a Sitemap generator +- [Tag Cloud Plugin from a Jekyll walk-through](http://vitobotta.com/how-to-migrate-from-wordpress-to-jekyll/): Plugin to generate a Tag Cloud +- [Pygments Cache Path by Raimonds Simanovskis](https://github.com/rsim/blog.rayapps.com/blob/master/_plugins/pygments_cache_patch.rb): Plugin to cache syntax-highlighted code from Pygments +- [Delicious Plugin by Christian Hellsten](https://github.com/christianhellsten/jekyll-plugins): Fetches and renders bookmarks from delicious.com. +- [Ultraviolet plugin by Steve Alex](https://gist.github.com/480380): Jekyll Plugin for Ultraviolet +- [HAML plugin by Sam Z](https://gist.github.com/517556): HAML plugin for jekyll +- [ArchiveGenerator by Ilkka Laukkanen](https://gist.github.com/707909): Uses [this archive page](https://gist.github.com/707020) to generate archives +- [Tag Cloud Plugin by Ilkka Laukkanen](https://gist.github.com/710577): Jekyll tag cloud / tag pages plugin +- [HAML/SASS Converter by Adam Pearson](https://gist.github.com/481456): Simple haml-sass conversion for jekyll. [Fork](https://gist.github.com/528642) by Sam X +- [SASS scss Converter by Mark Wolfe](https://gist.github.com/960150): Jekyll Converter which uses the new css compatible syntax, based on the one written by Sam X. +- [GIT Tag by Alexandre Girard](https://gist.github.com/730347): Jekyll plugin to add Git activity inside a list +- [Draft/Publish Plugin by Michael Ivey](https://gist.github.com/49630) +- [Less.js generator by Andy Fowler](https://gist.github.com/642739): Jekyll plugin to render less.js files during generation. +- [Less Converter by Jason Graham](https://gist.github.com/639920): A Jekyll plugin to convert a .less file to .css +- [Less Converter by Josh Brown](https://gist.github.com/760265) + +- [MathJax Liquid Tags by Jessy Cowan-Sharp](https://gist.github.com/834610): A simple liquid tag for Jekyll that converts and into inline math, and and into block equations, by replacing with the appropriate MathJax script tags. +- [Non-JS Gist Tag by Brandon Tilley](https://gist.github.com/1027674) A Liquid tag for Jekyll sites that allows embedding Gists and showing code for non-JavaScript enabled browsers and readers. +- [Growl Notification Generator by Tate Johnson](https://gist.github.com/490101) +- [Growl Notification Hook by Tate Johnson](https://gist.github.com/525267): Better alternative to the above, but requires his “hook” fork. +- [Version Reporter by Blake Smith](https://gist.github.com/449491) +- [Upcase Converter by Blake Smith](https://gist.github.com/449463) +- [Render Time Tag by Blake Smith](https://gist.github.com/449509) +- [Summarize Filter by Mathieu Arnold](https://gist.github.com/731597) +- [Status.net/OStatus Tag by phaer](https://gist.github.com/912466) +- [CoffeeScript converter by phaer](https://gist.github.com/959938): Put this file in `plugins` and write a YAML header to your .coffee files. See [http://coffeescript.org](http://coffeescript.org) for more info +- [Raw Tag by phaer.](https://gist.github.com/1020852): Keeps liquid from parsing text betweeen `{{ "{% raw " }}%}` and `{{ "{% endraw " }}%}` +- [URL encoding by James An](https://gist.github.com/919275) +- [Sitemap.xml Generator by Michael Levin](http://www.kinnetica.com/projects/jekyll-sitemap-generator/) +- [Markdown references by Olov Lassus](https://gist.github.com/961336): Keep all your markdown reference-style link definitions in one file (_references.md) +- [Full-text search by Pascal Widdershoven](https://github.com/PascalW/jekyll_indextank): Add full-text search to your Jekyll site with this plugin and a bit of JavaScript. +- [Stylus Converter](https://gist.github.com/988201) Convert .styl to .css. +- [Embed.ly client by Robert Böhnke](https://github.com/robb/jekyll-embedly-client) Autogenerate embeds from URLs using oEmbed. +- [Logarithmic Tag Cloud](https://gist.github.com/2290195): Flexible. Logarithmic distribution. Usage eg: `{{ "{% tag_cloud font-size: 50 - 150%, threshold: 2 " }}%}`. Documentation inline. +- [Related Posts by Lawrence Woodman](https://github.com/LawrenceWoodman/related_posts-jekyll_plugin): Overrides `site.related_posts` to use categories to assess relationship +- [AliasGenerator by Thomas Mango](https://github.com/tsmango/jekyll_alias_generator): Generates redirect pages for posts when an alias configuration is specified in the YAML Front Matter. +- [FlickrSetTag by Thomas Mango](https://github.com/tsmango/jekyll_flickr_set_tag): Generates image galleries from Flickr sets. +- [Projectlist by Frederic Hemberger](https://github.com/fhemberger/jekyll-projectlist): Loads all files from a directory and renders the entries into a single page, instead of creating separate posts. +- [Tiered Archives by Eli Naeher](https://gist.github.com/88cda643aa7e3b0ca1e5): creates a tiered template variable that allows you to create archives grouped by year and month. +- [Jammit generator by Vladimir Andrijevik](https://gist.github.com/1224971): enables use of [Jammit](http://documentcloud.github.com/jammit/) for JavaScript and CSS packaging. +- [oEmbed Tag by Tammo van Lessen](https://gist.github.com/1455726): enables easy content embedding (e.g. from YouTube, Flickr, Slideshare) via oEmbed. +- [Company website and blog plugins](https://github.com/flatterline/jekyll-plugins) by Flatterline, a [Ruby on Rails development company](http://flatterline.com/): portfolio/project page generator, team/individual page generator, author bio liquid template tag for use on posts and a few other smaller plugins. +- [Transform Layouts](https://gist.github.com/1472645) Monkey patching allowing HAML layouts (you need a HAML Converter plugin for this to work) +- [ReStructuredText converter](https://github.com/xdissent/jekyll-rst): Converts ReST documents to HTML with Pygments syntax highlighting. +- [Tweet Tag by Scott W. Bradley](https://github.com/scottwb/jekyll-tweet-tag): Liquid tag for [Embedded Tweets](https://dev.twitter.com/docs/embedded-tweets) using Twitter’s shortcodes +- [jekyll-localization](https://github.com/blackwinter/jekyll-localization): Jekyll plugin that adds localization features to the rendering engine. +- [jekyll-rendering](https://github.com/blackwinter/jekyll-rendering): Jekyll plugin to provide alternative rendering engines. +- [jekyll-pagination](https://github.com/blackwinter/jekyll-pagination): Jekyll plugin to extend the pagination generator. +- [jekyll-tagging](https://github.com/pattex/jekyll-tagging): Jekyll plugin to automatically generate a tag cloud and tag pages. +- [Generate YouTube Embed (tag)](https://gist.github.com/1805814) by [joelverhagen](https://github.com/joelverhagen): Jekyll plugin which allows you to embed a YouTube video in your page with the YouTube ID. Optionally specify width and height dimensions. Like “oEmbed Tag” but just for YouTube. +- [JSON Filter](https://gist.github.com/1850654) by [joelverhagen](https://github.com/joelverhagen): filter that takes input text and outputs it as JSON. Great for rendering JavaScript. +- [jekyll-beastiepress](https://github.com/okeeblow/jekyll-beastiepress): FreeBSD utility tags for Jekyll sites. +- [jsonball](https://gist.github.com/1895282): reads json files and produces maps for use in jekylled files +- [redcarpet2](https://github.com/nono/Jekyll-plugins): use Redcarpet2 for rendering markdown +- [bibjekyll](https://github.com/pablooliveira/bibjekyll): render BibTeX-formatted bibliographies/citations included in posts/pages using bibtex2html +- [jekyll-citation](https://github.com/archome/jekyll-citation): render BibTeX-formatted bibliographies/citations included in posts/pages (pure Ruby) +- [jekyll-scholar](https://github.com/inukshuk/jekyll-scholar): Jekyll extensions for the blogging scholar +- [jekyll-asset_bundler](https://github.com/moshen/jekyll-asset_bundler): bundles and minifies JavaScript and CSS +- [Jekyll Dribbble Set Tag](https://github.com/ericdfields/Jekyll-Dribbble-Set-Tag): builds Dribbble image galleries from any user +- [debbugs](https://gist.github.com/2218470): allows posting links to Debian BTS easily +- [refheap_tag](https://github.com/aburdette/refheap_tag): Liquid tag that allows embedding pastes from [refheap](https://refheap.com) +- [i18n_filter](https://github.com/gacha/gacha.id.lv/blob/master/_plugins/i18n_filter.rb): Liquid filter to use I18n localization. +- [singlepage-jekyll](https://github.com/JCB-K/singlepage-jekyll) by [JCB-K](https://github.com/JCB-K): turns Jekyll into a dynamic one-page website. +- [flickr](http://jonasforsberg.se/2012/04/15/flickr-plugin-for-jekyll/): Embed photos from flickr right into your posts. +- [jekyll-devonly_tag](https://gist.github.com/2403522): A block tag for including markup only during development. +- [Jekyll plugins by Aucor](https://github.com/aucor/jekyll-plugins): Plugins for eg. trimming unwanted newlines/whitespace and sorting pages by weight attribute. +- [Only first paragraph](https://github.com/sebcioz/jekyll-only_first_p): Show only first paragrpaph of page/post. +- [jekyll-pandoc-plugin](https://github.com/dsanson/jekyll-pandoc-plugin): use pandoc for rendering markdown. +- [File compressor](https://gist.github.com/2758691) by [mytharcher](https://github.com/mytharcher): Compress HTML (\*.html) and JavaScript(\*.js) files when output. +- [smilify](https://github.com/SaswatPadhi/jekyll_smilify) by [SaswatPadhi](https://github.com/SaswatPadhi): Convert text emoticons in your content to themeable smiley pics. [Demo](http://saswatpadhi.github.com/) +- [excerpts](http://blog.darkrefraction.com/2012/jekyll-excerpt-plugin.html) by [drawoc](https://github.com/drawoc): provides a nice way to implement page excerpts. + +
+
Jekyll Plugins Wanted
+

If you have a Jekyll plugin that you would like to see added to this list, you should read the contributing page to find out how to make that happen.

+
diff --git a/site/_posts/2012-07-01-posts.md b/site/_posts/2012-07-01-posts.md new file mode 100644 index 00000000..2871213b --- /dev/null +++ b/site/_posts/2012-07-01-posts.md @@ -0,0 +1,106 @@ +--- +layout: docs +title: Writing posts +prev_section: frontmatter +next_section: pages +--- + +One of Jekyll’s best aspects is that it is “blog aware”. What does that mean, exactly? Well, simply put it means that blogging is baked into Jekyll’s functionality by default. For people who write articles and publish them online, this means that you can publish and maintain a blog simply by managing a folder full of text-files on your computer. Compared to the hassle of configuring and maintaining databases and web-based CMS systems, this will be a welcome change for many. + +## The Posts Folder + +As detailed on the [directory structure](../structure) page, the `_posts` folder in any Jekyll site is where the files for all your articles will live. These files can be either [Markdown](http://daringfireball.net/projects/markdown/) or [Textile](http://textile.sitemonks.com/) formatted text files, and as long as they have [YAML front-matter](../frontmatter) defined, they will be converted from their source format into a HTML page that is part of your static site. + +### Creating Post Files + +To create a new post, all you need to do is create a new file in the `_posts` folder. The filename structure used for files in this folder is important—Jekyll requires the file to be named in the following format: + +{% highlight bash %} +YEAR-MONTH-DAY-title.MARKUP +{% endhighlight %} + +Where `YEAR` is a four-digit number, `MONTH` and `DAY` are both two-digit numbers, and `MARKUP` is an appropriate file extension for the format your post is written in. For example, the following are examples of excellent post filenames: + +{% highlight bash %} +2011-12-31-new-years-eve-is-awesome.markdown +2012-09-12-how-to-write-a-blog.textile +{% endhighlight %} + +### Content Formats + +The first thing you need to put in any post is a section for [YAML front-matter](../frontmatter), but after that, it's simply a case of deciding which format you prefer to write in. Jekyll supports two popular content markup formats: [Markdown](http://daringfireball.net/projects/markdown/) or [Textile](http://textile.sitemonks.com/). These formats each have their own way of signifying different types of content within a post, so you should read up on how these formats work and decide which one suits your needs best. + +## Including images and resources + +For people who publish articles on a regular basis, it’s quite common to need to include things like images, links, downloads, and other resources along with their text-based content. While the ways to link to these resources differ between Markdown and Textile, the problem of working out where to store these files in your site is something everyone will face. + +Because of Jekyll’s flexibility, there are many solutions to how to do this. One common solution is to create a folder in the root of the project directory called something like `assets` or `downloads`, into which any images, downloads or other resources are placed. Then, from within any post, they can be linked to using the site’s root as the path for the asset to include. Again, this will depend on the way your site’s (sub)domain and path are configured, but here some examples (in Markdown) of how you could do this using the `{{ "{{ site.url " }}}}` variable in a post. + +Including an image asset in a post: + +{% highlight bash %} +… which is shown in the screenshot below: +![My helpful screenshot]({{ "{{ site.url " }}}}/assets/screenshot.jpg) +{% endhighlight %} + +Linking to a PDF for readers to download: + +{% highlight bash %} +… you can [get the PDF]({{ "{{ site.url " }}}}/assets/mydoc.pdf) directly. +{% endhighlight %} + +
+
ProTip™: Link using just the site root URL
+

You can skip the {{ "{{ site.url " }}}} variable if you know your site will only ever be displayed at the root URL of your domain. In this case you can reference assets directly with just /path/file.jpg.

+
+ +## Displaying an index of posts + +It’s all well and good to have posts in a folder, but a blog is no use unless you have a list of posts somewhere for people. Creating an index of posts on another page (or in a [template](../templates)) is easy, thanks to the [Liquid template language](http://liquidmarkup.org/) and it’s tags. Here’s a basic example of how to create an unordered list of links to posts for a Jekyll site: + +{% highlight html %} + +{% endhighlight %} + +Of course, you have full control over how (and where) you display your posts, and how you structure your site. You should read more about [how templates work](../templates) with Jekyll if you’re interested in these kinds of things. + +## Highlighting code snippets + +Jekyll also has built-in support for syntax highlighting of code snippets using [Pygments](../extras), and including a code snippet in any post is easy. Just use the dedicated Liquid tag as follows: + +{% highlight ruby %} +{{ "{% highlight ruby"}} %} +def show + @widget = Widget(params[:id]) + respond_to do |format| + format.html # show.html.erb + format.json { render json: @widget } + end +end +{{ "{% endhighlight"}} %} +{% endhighlight %} + +And the output will look like this: + +{% highlight ruby %} +def show + @widget = Widget(params[:id]) + respond_to do |format| + format.html # show.html.erb + format.json { render json: @widget } + end +end +{% endhighlight %} + +
+
ProTip™: Show line numbers
+

You can make code snippets include line-numbers easily, simply add the word linenos to the end of the opening highlight tag like this: {{ "{% highlight ruby linenos " }}%}.

+
+ +Those basics should be more than enough to get you started writing your first posts. When you’re ready to dig into what else is possible, you might be interested in doing things like [customizing post permalinks](../permalinks) or using [custom variables](../variables) in your posts and elsewhere on your site. \ No newline at end of file diff --git a/site/_posts/2012-07-01-resources.md b/site/_posts/2012-07-01-resources.md new file mode 100644 index 00000000..c14c584c --- /dev/null +++ b/site/_posts/2012-07-01-resources.md @@ -0,0 +1,49 @@ +--- +layout: docs +title: Resources +prev_section: sites +--- + +Jekyll’s growing use is producing a wide variety of tutorials, frameworks, extensions, examples, and other resources that can be very helpful. Below is a collection of links to some of the most popular Jekyll resources. + +### Jekyll tips & tricks, and examples + +- [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/) +- [JekyllBootstrap.com](http://jekyllbootstrap.com) + + Provides detailed explanations, examples, and helper-code to make + getting started with Jekyll easier. + +### Tutorials + +#### Integrating Jekyll 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’, by 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’, by 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/) + + A guide to implementing a tag cloud and per-tag content pages using Jekyll. + +- [Jekyll Extensions -= Pain](http://rfelix.com/2010/01/19/jekyll-extensions-minus-equal-pain/) + + A way to [extend Jekyll](http://github.com/rfelix/jekyll_ext) without forking and modifying the Jekyll gem codebase and some [portable Jekyll extensions](http://wiki.github.com/rfelix/jekyll_ext/extensions) that can be reutilized and shared. + +- [Using your Rails layouts in Jekyll](http://numbers.brighterplanet.com/2010/08/09/sharing-rails-views-with-jekyll) diff --git a/site/_posts/2012-07-01-sites.md b/site/_posts/2012-07-01-sites.md new file mode 100644 index 00000000..d4ec3cb4 --- /dev/null +++ b/site/_posts/2012-07-01-sites.md @@ -0,0 +1,991 @@ +--- +layout: docs +title: Sites using Jekyll +prev_section: troubleshooting +next_section: resources +--- + +It’s interesting to see what designs and features others have come up +with. Link to Jekyll-powered blogs and other sites here. + +- [Tom Preston-Werner](http://tom.preston-werner.com/) + ([source](http://github.com/mojombo/mojombo.github.com)) +- [Koliseo Help Site](http://help.koliseo.com) - Help site of a + ticketing platform +- [Magpie Lab](http://www.magpielab.com) + ([source](https://github.com/magpielab/magpielab.com)) +- [Litany Against Fear](http://litanyagainstfear.com/) + ([source](https://github.com/qrush/qrush.github.com)) +- [Git Ready](http://gitready.com/) + ([source](http://github.com/gitready/gitready)) +- [Bilal Hussain](http://bilalh.github.com/) + ([source](https://github.com/Bilalh/bilalh.github.com/tree/source)) + - Personal site and blog and projects details. +- [m8ck](http://m8ck.us.to) - Personal blog about technology and web + development. +- [Ping My Geek](http://pingmygeek.com) + ([source](http://github.com/pranavk/pranavk.github.com/)) - Personal + blog on computers, hacking, technology and experimentation. +- [Richard Huang](http://www.huangzhimin.com/) + ([source](https://github.com/flyerhzm/flyerhzm.github.com)) - Blog + about ruby/rails and other web develop technology. +- [Michael Ebens](http://nova-fusion.com/) + ([source](http://github.com/BlackBulletIV/blackbulletiv.github.com)) + - Personal site with a tech blog on various topics, usually related + to programming and web development, pages for Michael’s projects, + and other pages. Check out the source, it’s got a lot in it. +- [devsundar](http://devsundar.github.com/) + ([source](http://github.com/devsundar/devsundar.github.com)) +- [metajack.im](http://metajack.im/) + ([source](http://github.com/metajack/metajack.im) / [Jekyll + fork](http://github.com/metajack/jekyll)) - Custom fork with support + for times, archives, custom script output etc. Tags implemented with + Google search. +- [Julian Yap](http://julianyap.com/?pk_campaign=github) + ([source](https://github.com/jyap808/jyap808.github.com)) - Personal + blog and web site. Theme is based off of and customized from Tom + Preston-Werner’s. +- [Corey Smith](http://www.coreynsmith.com/) - Personal blog, made + with Octopress. +- [GitHub Rebase](http://rebase.github.com/) + ([source](http://github.com/rebase/rebase.github.com)) +- [User Obsessed](http://userobsessed.net/) + ([source](http://github.com/joefiorini/userobsessed)) - Link (and + non-link) blog with some nice automation and rsync deployment + script. +- [überduper](http://danhixon.github.com/) + ([source](http://github.com/danhixon/danhixon.github.com)) +- [The Pug Automatic](http://henrik.nyh.se/) + ([source](http://github.com/henrik/henrik.nyh.se) / [Jekyll + fork](http://github.com/henrik/jekyll)) - Custom fork with Haml, + Sass etc. Single page for tags with per-tag anchors. Single page + archive by year/month. +- [Paperplanes](http://www.paperplanes.de/) + ([source](http://github.com/mattmatt/paperplanes) / [Jekyll + fork](http://github.com/mattmatt/jekyll/)) +- [Development Seed](http://developmentseed.org/) + ([source](http://developmentseed.org/blog/2011/09/09/jekyll-github-pages/)) +- [My Thoughts Are Yours](http://mythoughtsareyours.yolk.cc/) + ([source](http://github.com/yyolk/mythoughtsareyours)) - My Thoughts + Are Yours - a project by [YOLK](http://yolk.cc/). +- [Rails Developer + London](http://www.jackkinsella.ie/rails-developer-london.html) + ([source](git://github.com/jackkinsella/Personal-Site-of-Jack-Kinsella.git)) + - Heroku ready and search engine optimised portfolio site and blog + of Jack Kinsella. +- [Tagaholic](http://tagaholic.me/) + ([source](http://github.com/cldwalker/cldwalker.github.com)) - + Machine tags and js are used to organize posts and calculate related + posts. +- [Kismetik Interactive](http://www.kismetik.com/) + ([source](http://github.com/spo11/kismetik-jekyll)) - Jekyll-managed + site deployed on Amazon S3 with tag pages, pagination, custom + layouts. +- [Thomas Glasgow](http://www.thomasglasgow.com/) - Personnal website + of a french engineer and entrepreneur. +- [favrik.com](http://favrik.com/) + ([source](http://github.com/favrik/favrik.com/)) +- [Mark Reid](http://mark.reid.name/) + ([source](http://github.com/mreid/mark.reid.name/tree)) - Jekyll + used as CMS for personal site and running two blogs: [Inductio Ex + Machina](http://mark.reid.name/iem/) (machine learning research) and + [Structure & Process](http://mark.reid.name/sap/) (programming). +- [tychoish](http://www.tychoish.com/) - Large scale Jekyll site, + based on metajack.im’s fork, and using themes from Mark Reid’s site + (with a few modifications). 1300+ entries. +- [Cyborg Institute](http://www.cyborginstitute.com/) + ([source](http://cyborginstitute.net/git/?p=cyborginstitute.com.git;a=summary)) + - Uses Jekyll to power the whole site (save the wiki). Uses the same + version of the code as tychoish, above. +- [Buildr](http://buildr.apache.org/) + ([source](http://github.com/assaf/buildr/tree/master)) - Generate + the site with Jekyll, and use PrinceXML to [generate PDF out of + it](http://blog.labnotes.org/2009/03/14/buildr-how-we-generate-the-documentation-web-site-and-pdf/). +- [Anil Wadghule](http://www.anilwadghule.com/) + ([source](http://github.com/anildigital/anildigital.github.com/)) +- [Basil Shkara](http://oiledmachine.com/posts) - Running Jekyll with + a tag structure. +- [Elijah Miller / jqr](http://jqr.github.com/) + ([source](http://github.com/jqr/jqr.github.com)) +- [PseudoWeb.Net](http://pseudoweb.net/) + ([source](http://github.com/icco/pseudoweb)) +- [Tate Johnson](http://tatey.com/) + ([source](http://github.com/tatey/tatey.com/)) +- [Jens Neuhalfen](http://neuhalfen.name/) +- [zegoggl.es](http://zegoggl.es) + ([source](http://github.com/jberkel/zegoggl.es) / [Jekyll + fork](http://github.com/jberkel/jekyll/)) - Based on Henrik’s + [fork](http://github.com/henrik/jekyll) and + [blog](http://henrik.nyh.se/). +- [Noah Watkins](http://noahdesu.com/) + ([source](https://github.com/noahdesu/noahdesu.github.com)) - + Personal/academic blog. +- [Crantastic Blog](http://blog.crantastic.org/) + ([source](http://github.com/hadley/crantastic/tree/gh-pages)) +- [Tom Ward](http://tomafro.net/) + ([source](http://github.com/tomafro/tomafro.net)) - Fully featured + blog using a Rakefile to generate index pages (of tags, years and + months), custom tags to help display posts, and capistrano to + publish. +- [koraktor](http://koraktor.github.com/) + ([source](http://github.com/koraktor/koraktor.github.com)) +- [Cory Ondrejka](http://cory.github.com/) + ([source](http://github.com/cory/cory.github.com/tree/master)) - My + regularly updated personal blog, talks, open source projects, etc… +- [Alex Payne](http://al3x.net/) + ([source](http://github.com/al3x/al3x.github.com/tree/master)) +- [Thomas Kollbach](http://thomas.kollba.ch/) +- [iPhone Plazer Application Page](http://plazer.bits.io/) +- [Tomasz ‘Tomash’ Stachewicz](http://tomash.wrug.eu/) +- [Dan’s Blog](http://caffeine.cc/) - Regular blog, updated through + Capistrano. +- [IS Development Blog](http://isdevelopment.weblog.glam.ac.uk/) - Uni + of Glamorgan Development blog (in development!). +- [Bernard ‘Imanel’ Potocki](http://imanel.org/) (Using [Henrik’s + Jekyll fork](http://github.com/henrik/jekyll)) +- [Matías + Flores](http://matflores.com/([fork](http://github.com/matflores/jekyll)))- [Stefan Saasen](http://www.juretta.com/) +- [Jason Rudolph](http://jasonrudolph.com/) + ([source](http://github.com/jasonrudolph/jasonrudolph.com)) - Tags + implemented with JavaScript to build URL for Google Custom Search + Engine. +- [Eric Johnson](http://el-studio.com/) + ([fork](http://github.com/elstudio/jekyll)) - Fork sorts tags + alphabetically by key. +- [Michael Nhat](http://michaelnhat.com/) - Great music, simple + design. +- [Superfeedr’s Blog](http://superfeedr.com/) - Real-time cloudy + thoughts from a super-hero. +- [Jason Toy](http://jtoy.net/) + ([source](http://github.com/jtoy.net/jtoyblog)) +- [Paolo Dona: not (yet) entrepreneur](http://paolodona.com/) + ([source](http://github.com/paolodona/paolodona.com)) +- [Joel Bradbury](http://joelbradbury.net/) + ([source](http://github.com/joelbradbury/joelbradbury.github.com)) - + My personal blog, things on software and web development. +- [morten lieba.ch](http://m.lieba.ch/) + ([source](http://github.com/Liebach/liebach.github.com)) - Personal + blog & website on [github pages](http://pages.github.com/). +- [Andrew Benton](http://hellosorld.com/) + ([source](http://github.com/stanleydrew/hellosorld.git)) - Personal + blog on software, development, web technologies, general startup + stuff. +- [Mike Champion](http://graysky.org/) +- [Brandon Mathis](http://brandonmathis.com/) + ([source](http://github.com/imathis/design-enthusiast/) using + [Octopress blogging framework](http://github.com/imathis/octopress)) + - Personal blog on interactive design and my work portfolio. +- [80KV](http://80kv.com/) + ([source](http://github.com/crossblaim/80kv-jekyll/tree/master)) - + Personal blog of Claudio Perez Gamayo, english and spanish. +- [George Ornbo](http://shapeshed.github.com/) + ([source](http://github.com/shapeshed/shapeshed.github.com/)) - An + experimental site for George Ornbo’s open source code using HTML5, + CSS3 and JSON. Integrates with Lighthouse for ticketing. +- [BinaryAge](http://binaryage.com/) - Various open-source tools for + web developers (uses submodules for shared content). +- [jekyll.atog.be](http://jekyll.atog.be/) - Personal blog of Koen Van + der Auwera (prev version). +- [Relatively Early Development](http://relativelyearly.com/) + ([source](http://github.com/relativelyearly/relativelyearly.github.com/tree)) +- [Ali Polatel](http://alip.github.com/) + ([source](http://github.com/alip/alip.github.com/tree/master)) +- [Under the hat, a weblog written by 10to1](http://blog.10to1.be) + ([source](http://github.com/10to1/10to1.github.com)) +- [Dmitry Belitsky](http://belitsky.info/) + ([source](http://github.com/dab/belitsky.info/tree/master)) - Worked + on Jekyll with Compass. +- [Michael Dwan](http://michaeldwan.com/) + ([source](http://github.com/michaeldwan/michaeldwan.github.com)) - + Personal site and blog of Michael Dwan. +- [Marc Chung](http://blog.marcchung.com/) + ([source](https://github.com/mchung/blog/tree)) +- [AppDen](http://appden.com/) + ([source](http://github.com/appden/appden.github.com)) +- [Brandon Philips](http://ifup.org/) + ([source](http://ifup.org/git/?p=ifup.git;a=summary)) +- [Kaspar Schiess](http://blog.absurd.li/) + ([source](http://github.com/kschiess/blog.absurd.li)) - Very minimal + theme, using a haml/sass enabled fork. +- [Joshua Poehls](http://www.zduck.com/) + ([source](http://github.com/jpoehls/zduck-web)) +- [Ben Ubois](http://benubois.com/) + ([source](https://github.com/benubois/benubois.github.com)) +- [Lukas Rieder](http://overbryd.github.com/) + ([source](http://github.com/Overbryd/overbryd.github.com)) +- [Claudio Baccigalupo](http://claudiob.github.com/) + ([source](http://github.com/claudiob/claudiob.github.com/tree/master)) + - My portfolio of Github source code projects. +- [Mislav Marohnić](http://mislav.uniqpath.com/) + ([source](http://github.com/mislav/mislav.github.com)) - Programming + blog. +- [John Duff](http://jduff.github.com/) + ([source](http://github.com/jduff/jduff.github.com)) +- [iruel.net](http://iruel.net/) personal site and blog, fork of John + Duff’s config ([source](http://github.com/sardaukar/iruel.net)) +- [johng Blog](http://www.johng.co.uk) + ([source](http://github.com/john-griffin/johng.co.uk/tree/gh-pages)) + - Based on Tom’s original Jekyll with added compass+sass. +- [Benjamin Thomas](http://benjaminthomas.org/) + ([source](http://github.com/bentomas/benjaminthomas-dot-org)) +- [Mark Wunsch](http://markwunsch.com/) +- [Mark Olesen](http://olesenm.github.com/) + ([source](http://github.com/olesenm/olesenm.github.com)) - Simple + blog with links to other github project pages. +- [Shape Shed](http://shapeshed.com/) - Portfolio and blog for + freelance web developer George Ornbo. +- [Sam Rosen](http://www.sammyrosen.com/) - Portfolio Website. +- [Kneatoh](http://eturk.github.com/) + ([source](http://github.com/eturk/eturk.github.com)) - Ethan + Turkeltaub’s Journal. +- [The Hypsometry Blog](http://blog.hypsometry.com/) - Christopher + Boone’s design and typography blog. +- [Domain51](http://domain51.com/) + ([source](http://github.com/tswicegood/domain51.com/)) - Site for + tswicegood’s business. +- [David Parker](http://davidwparker.com/) - Portfolio and Blog. +- [Mottr.am](http://mottr.am/) + ([source](http://github.com/mottram/mottram)) - A weblog with + comments via Twitter hashtags. +- [kle•pas](http://klepas.org/) + ([source](http://github.com/klepas/klepas.org/)) - Personal site of + Simon Pascal Klein. +- [Avand](http://avandamiri.com/) - Personal site and blog of Avand + Amiri. +- [m4n](http://m4n.github.com/) + ([source](http://github.com/m4n/m4n.github.com/)) +- [Aaron Kalin](http://www.martinisoftware.com/) + ([source](http://github.com/martinisoft/martinisoft.github.com)) +- [Bryan Goines](http://bry4n.ffiirree.com/) + ([source](http://github.com/bry4n/bry4n.github.com)) +- [Mutelight](http://mutelight.org/) + ([source](http://github.com/fyrerise/mutelight)) - Blog for + engineer/developer Brandur Leach. +- [Vanity](http://vanity.labnotes.org/) - Experiment Driven + Development framework for Rails. +- [Alex Coles](http://alexbcoles.com/) + ([source](http://github.com/myabc/myabc.github.com/)) +- [Damien Mathieu](http://42.dmathieu.com/) + ([source](http://github.com/dmathieu/dmathieu.github.com/)) +- [Ruby on ZiGzAg](http://zigzag.github.com/) + ([source](http://github.com/zigzag/zigzag.github.com/)) +- [wulfovitch.net](http://wulfovitch.net/) + ([source](http://github.com/wulfovitch/wulfovitch.net) / + [fork](http://github.com/tatey/jekylless)) - Personal blog covering + programming topics +- [SaForge](http://www.saforge.com/) - Personal blog of Emanuel-S (in + German). +- [Rack-Jekyll](http://github.com/bry4n/rack-jekyll) - Transform your + Jekyll application into Rack application ([Heroku + Demo](http://bry4n.heroku.com/)). +- [Drivemeup carpooling](http://drivemeup.github.com/) + ([source](http://github.com/drivemeup/drivemeup.github.com)) - + Drivemeup Blog (English and French). +- [mojobojo](http://boj.github.com/) + ([source](http://github.com/boj/boj.github.com)) - Simple personal + blog. +- [jouire.com](http://jouire.com/) - Personal blog. +- [algorithmique.net](http://algorithmique.net/) - Personal blog + (French). +- [senoj.net](http://www.senoj.net/) + ([source](http://github.com/stephenjones/stephenjones.github.com)) - + Stephen Jones’s personal blog. +- [Levent Ali](http://purebreeze.com/) - Business and blog for + freelance technologist Levent Ali. +- [Codigo Ergo Sum](http://codigoergosum.com/) + ([source](http://github.com/balinterdi/balinterdi.github.com)) - + Balint Erdi’s personal tech blog. +- [alpinegizmo.com](http://alpinegizmo.com/) + ([source](http://github.com/alpinegizmo/alpinegizmo.com)) - David + Anderson’s personal blog. +- [Neil Grogan](http://neil.grogan.ie/) + ([source](http://github.com/dueyfinster/dueyfinster.github.com)) - + Neil Grogan’s personal blog. +- [Golf Application Server Documentation](http://golf.github.com/) + ([source](http://github.com/golf/golf.github.com)) - Documentation + for Golf app developers. +- [Jim Hansson](http://jimhansson.github.com/) + ([source](http://github.com/jimhansson/jimhansson.github.com)) - + Personal blog. +- [Passing Curiosity](http://passingcuriosity.com/) + ([source](http://github.com/thsutton/passingcuriosity.com/)) - + Personal blog with content about development and a smattering of + scepticism, reading, and education. +- [Michael Bensoussan](http://mickeyben.com/) + ([source](http://github.com/mickey/mickeyben)) - Personal blog. +- [Jesse Storimer’s Bloggings](http://jstorimer.com/) + ([source](http://github.com/jstorimer/jstorimer.com)) - Tech Blog. +- [DigitalSanctum.com](http://www.digitalsanctum.com/) + ([source](http://github.com/digitalsanctum/ds)) - Software + development and other square topics. +- [Jekyll + 960.gs](http://code.btbytes.com/jekyll_960/index.html) + ([source](http://github.com/btbytes/jekyll_960)) - 960.gs based + template for Jekyll. Uses good default fonts (Inconsolata for + monospace and Droid for headings). +- [Datakrup.com](http://www.datakrup.com/) - Ferhat Ziba’s personal + blog ([source](http://github.com/fero46/datakrup.com)) - Theme + inspired by textmate theme ‘midnight’. +- [Marko Anastasov](http://www.marko.anastasov.name/) - Personal site + and blog. +- [Juan Reyero](http://juanreyero.com/) - Site and blog written in + [Org-mode](http://orgmode.org/). The blog is exported to Jekyll + using [Org-jekyll](http://juanreyero.com/open/org-jekyll) . +- [Greater Skies](http://greaterskies.com/) - Multi-language + educational site written in [Org-mode](http://orgmode.org/). + [Source](http://github.com/juanre/Greater-Skies) . +- [Junto al camino](http://juntoalcamino.com/) - Personal blog in + Spanish. +- [dumb-bunny.com](http://www.dumb-bunny.com/) + ([source](http://github.com/pui/pui.github.com)) - Erica Kwan’s + personal blog. +- [The Ruby Reflector - Jekyll](http://rubyreflector.com/Jekyll) - + Jekyll News. +- [Christopher Sexton](http://fuzzymonk.com/) + ([source](http://github.com/csexton/bai_si_bu_jie)) +- [Codeography.com](http://codeography.com/) + ([source](http://github.com/csexton/csexton.github.com)) +- [Jim Myhrberg](http://jimeh.me/) + ([source](http://github.com/jimeh/jimeh.me)) - Personal site and + blog, using two jekyll projects together. One for the site, and one + for the blog. Building and deployment done via a few simple rake + tasks. +- [Sven Dahlstrand](http://svendahlstrand.se/) - Sven Dahlstrand’s + personal blog in Swedish. +- [skim](http://skim.la/) ([source](http://sl4m.github.com/)) - Ruby, + rails on windows environment. +- [Zach Holman](http://zachholman.com/) + ([source](http://github.com/holman/holman.github.com)) - + holman blogs on Apple, Ruby, and startups. And bank robberies. +- [MHFS](http://mhfs.com.br/) - Marcelo Silveira’s personal website/blog. +- [Anti’s World](http://anti.cute-ninjas.com/) ([source](http://github.com/AndreasOM/anti.cute-ninjas.com)) - andreasOM is slowly importing 10 years worth of random blabbering to jekyll. +- [GnuVision Blog](http://pramode.net/) - Pramode C.E’s personal + website/blog. +- [AudioBox.fm](http://www.audiobox.fm/) - Your media library in the + cloud. +- [Sideburns.eu](http://www.sideburns.eu/) + ([source](http://github.com/julienXX/Sideburns.eu)) - + julienXX blog on Ruby, NoSQL and random whatnot. +- [Study Deutsch](http://studydeutsch.com/) - Resources to teach yourself German. +- [Travis Jeffery](http://travisjeffery.com/) - Personal weblog. +- [27smiles](http://27smiles.com/) ([source](http://github.com/RichGuk/27smiles) and [fork](http://github.com/RichGuk/jekyll)) - Personal blog of RichGuk. +- [Ryan Clough](http://becomingaweso.me/) + ([source](http://github.com/RyanCacophony/becomingaweso.me)) - + Personal Website and blog of Ryan Clough (on code, linux, music, and + dance). +- [Andrew Heiss](http://www.andrewheiss.com/) + ([source](http://github.com/andrewheiss/ah-jekyll) / [Jekyll + fork](http://github.com/andrewheiss/jekyll)) - Custom fork that + allows for custom Ruby filters in /\_lib/, making tag pages simple. + Also has support for caching Pygments.Uses a rakefile for deploying + and building. +- [Which Ruby CMS Should I Use?](http://whichrubycmsshouldiuse.com/) + ([source](http://github.com/ychaker/whichrubycmsshouldiuse.com)) - A + project to help understand the Ruby CMS ecosystem. +- [Ronin](http://ronin-ruby.github.com/) + ([source](http://github.com/ronin-ruby/ronin-ruby.github.com/)) - + Project website for Ronin, a Ruby platform for exploit development + and security research. +- [Youssef Chaker](http://www.youhhoo.com/) + ([source](http://github.com/ychaker/youhhoo.com)) - Personal Site + and Blog. +- [Kodfabrik Blog](http://io.kodfabrik.com/) + ([source](http://github.com/azer/io.kodfabrik.com), + [posts](http://github.com/azer/posts)) +- [Anthony Short](http://anthonyshort.com.au) + ([source](http://github.com/anthonyshort/anthonyshort.com.au)) - + Personal blog. Uses Compass. +- [Wael Nasreddine](http://wael.nasreddine.com/) (forked from George + Ombo) +- [ESWAT](http://eswat.ca/) + ([source](http://github.com/eswat/eswat.github.com)) - Simple blog + and stuff about me. +- [testomatic.co.uk](http://testomatic.co.uk/) + ([source](http://github.com/testomatic/site)) - Blog on web + development and programming. +- [Bike to work](http://biketowork.org.uk/) - Site about cycle + commuting. +- [Aktagon Ltd.](http://aktagon.com/) - Aktagon Ltd. (Uses this + [Jekyll delicious + plugin](http://github.com/christianhellsten/jekyll-plugins)). +- [sem4r](http://www.sem4r.com/) - Site about sem4r ruby library. +- [iZ-smart.net IRC Network](http://www.iZ-smart.net/) - Websites of + the 2nd largest German IRC Network. +- [Provence Linux User Group](http://plugfr.org/) + ([source](http://github.com/plug/plugfr.org/)) - Website of a french + LUG with posts, categories, RSS feed, sitemap, Googe CSE… +- [Squeryl](http://squeryl.org/) + ([source](http://github.com/max-l/Squeryl/tree/gh-pages)) - A Scala + DSL for interacting with databases (Scala Query Language) +- [Jeff Kreeftmeijer](http://jeffkreeftmeijer.com/) + ([source](http://github.com/jeffkreeftmeijer/jeffkreeftmeijer.com)) +- [Snort a Sprocket](http://smerpology.org/sprocket/) + ([source](http://bitbucket.org/smerp/snort_a_sprocket/)) - personal + blog of smerp. +- [The iNK blot](http://novemberkilo.com/)([source](http://github.com/novemberkilo/novemberkilo.github.com))- personal blog of novemberkilo. +- [Coding in the Rain](http://ascarter.net/) + ([source](http://github.com/ascarter/ascarter.github.com/)) - + personal blog of ascarter. +- [Al3xandr3](http://al3xandr3.github.com/)([source](http://github.com/al3xandr3/al3xandr3.github.com)) +- [ruddzw.com](http://www.ruddzw.com/)([source](http://github.com/ruddzw/ruddzw.com))- personal blog of ruddzw. +- [Seattle Xcoders](http://seattlexcoders.org/) + ([source](http://github.com/xcoders/xcoders.github.com)) - Seattle + Xcoders Mac developer group web site. +- [Ginzametrics SEO Dashboard](http://ginzametrics.com/) - SEO + Dashboard for marketing reporting and analytics. +- [listbot.org](http://listbot..org/) - personal blog of polera. +- [Developing Ego](http://developingego.com/)- personal and dev blog of ltw. +- [jain basil aliyas.](http://jainbasil.net/) + ([source](http://github.com/jainbasil/jain.basil.aliyas.blog)) - + Jain Basil Aliyas’s personal blog/website. +- [Piotr Sarnacki](http://piotrsarnacki.com/) - Blog of Piotr + Sarnacki, [hosted on + github](http://github.com/drogus/drogus.github.com) . +- [Infochimps Data API](http://api.infochimps.com/) - Front-end and + documentation for the API of infochimps. +- [Realized: A blog about stock portfolio management](http://blog.realized-app.com/)- Based on Henrik’s fork; blog for [realized-app.com](http://realized-app.com/.) +- [Utilise.ca](http://utilise.ca/)([source](http://github.com/remiprev/utilise.ca))- A french-canadian version of [_The Setup_](http://usesthis.com/.) +- [Dan Loewenherz](http://dlo.github.com/)([source](http://github.com/dlo/dlo.github.com))- Personal blog of dwlz, + influenced by [mojombo.github.com](http://mojombo.github.com/). +- [Tony Landis](http://tonylandis.com/) + ([source](http://github.com/tony-landis/tony-landis.github.com)) - + Personal blog of + tony_landis based on [mojombo.github.com](http://mojombo.github.com/)for now. +- [Michael Monteleone](http://michaelmonteleone.net/) ([source](http://github.com/mmonteleone/michaelmonteleone.net))- Personal site of Michael Monteleone, standing on all kinds of shoulders of jekyll giants. +- [dhatNyeng blog](http://alinux.web.id)([source](http://github.com/alinuxwebid/alinuxwebid.github.com))- Personal blog of alinuxwebid + - based on Ascarter’s + [fork](http://github.com/ascarter/ascarter.github.com/). +- [grepthepipe](http://grepthepipe.com/) - Personal blog of leifg. +- [NiftySchool language school administration software blog](http://blog.niftyschool.com/)- Blog of the NiftySchool platform, includes disqus comments. +- [Skroutz.gr Developer blog](http://team.skroutz.gr/)- Developer Blog of Skroutz.gr, the greek price comparison site. +- [Fabrizio Fantini](http://www.fantini.name)- Personal website and blog of Fabrizio Fantini. +- [Ben Vinegar](http://benv.ca/) +- [Mihail Szabolcs](http://szabster.net/)([source](http://github.com/icebreaker/icebreaker.github.com)) +- [Harlan T Wood](http://www.harlantwood.net/)- Enlightened technology, spiritual transhumanism, open source screenplays... +- [Lake Denman](http://lakedenman.com/)([source](http://github.com/ldenman/lakedenman.com)) +- [Ben Hoskings](http://benhoskin.gs/)([source](http://github.com/benhoskings/benhoskin.gs)) +- [Johnson Page](http://johnsonpage.org/)([source](http://github.com/jwpage/johnsonpage-blog)) +- [Atompad](http://atompad.com/)([source](http://github.com/johnantoni/johnantoni.github.com))- Based on mojombo's site, slowly adding to it other stuff, ported from red91.com. +- [Flood Magazine](http://floodmagazine.com/) +- [Brighter Planet](http://brighterplanet.com/)- Runs its blog [Safety in Numbers](http://numbers.brighterplanet.com/)([source](http://github.com/brighterplanet/numbers))and its static [developer site](http://brighterplanet.github.com/)([source](http://github.com/brighterplanet/brighterplanet.github.com))with Jekyll. +- [Emanuel Sprosec](http://www.emanuel-s.com/)- Personal portfolio. +- [unwiredcouch.com](http://unwiredcouch.com/)([source](http://github.com/mrtazz/blog)) +- [Scott Tesoriere](http://tesoriere.com/)([source](http://github.com/scottkf/tesoriere.com))- Tags with spaces. +- [Journal-S](http://muli.cc/)- Personal blog by Emanuel-S / german. +- [Danish Khan](http://danishkhan.org/)([source](http://github.com/danishkhan/danishkhan.github.com))- I blog about ruby, rails, sinatra and startup culture. I am using the octopress blogging framework. +- [Amin Astaneh](http://aminastaneh.net/)- Personal site and weblog. Formerly Wordpress. +- [Develop With Passion® - Jean-Paul S. Boodhoo](http://blog.developwithpassion.com/)- I blog about coding, family, faith, and how to encourage others to develop with passion!!. +- [Crowd Interactive's Tech Blog](http://blog.crowdint.com/)- ([source](http://github.com/crowdint/blog.crowdint.com))- A Blog about Ruby, Rails, gems and git. +- [Brilliant Corners](http://brilliantcorners.org/)- ([source](http://github.com/billturner/brilliantcorners.org)) +- [Hundefutter](http://www.zoo-keller.de/)- Hundefutter - weblog with jekyll & fastercsv) +- [Auto Ersatzteile](http://autoersatzteile.vehicle-data-processor.de/)- Car parts -> jekyll, fastercsv & ar. +- [GeekUp](http://geekup.org/)([source](http://github.com/AndrewDisley/GeekUp))- Events. +- [Peter Hajdu](http://peterhajdu.github.com/)([source](http://github.com/peterhajdu/peterhajdu.github.com))- Personal blog. +- [yeban's weblog](http://yeban.in/)([source](http://github.com/yeban/weblog))- Personal blog. +- [David Sanson](http://www.davidsanson.com/)([source](http://github.com/dsanson/dsanson.github.com))- Personal website and course webpages. +- [Bauria](http://www.bauria.com/en/)- Small startup website. +- [Tigraine's weblog](http://www.tigraine.at/)([source](http://github.com/tigraine/www.tigraine.at))- My weblog about programming. +- [BetterVPS.net](http://www.bettervps.net/)([source](http://repo.no/better/site.git).)Xen VPS hosting for geeks. +- [Bullshit mode on](http://zahardzhan.github.com/)- Russian blog about Emacs and dynamic languages. +- [Jon Buys](http://ibuys.github.com/)- ([source](http://github.com/ibuys/ibuys.github.com)) +- [zerothabhishek](http://zerothabhishek.github.com/)- ([source](http://github.com/zerothabhishek/zerothabhishek.github.com)) +- [Monkey Snatch Banana](http://www.monkeysnatchbanana.com/)- ([source](http://github.com/SeanTAllen/MonkeySnatchBanana.com))- Personal blog that integrates compass via rake. +- [Justin Woodbridge](http://siberianfaucet.com/)- ([source](http://github.com/glitterfang/glitterfang.github.com)) +- [Greg Heartsfield](http://gregheartsfield.com/)- Personal blog. +- [Matthias Endler](http://www.matthias-endler.de/)([source](http://github.com/mre/mre.github.com))- Blog created by purple unicorns with lots of open source love. +- [Jason West](http://jlwestsr.com/)([source](http://github.com/jlwestsr/jlwestsr.github.com))- A technical blog by Jason L. West, Sr. that uses Jekyll-Bootstrap for it's layout. +- [dotlesscss Project Site](http://www.dotlesscss.org/) +- [Romain Dorgueil](http://romain.dorgueil.net/)- Technical blog migrated to jekyll to keep control on my content. +- [Mark Szymanski](http://mrminimalist.nfshost.com/) +- [Pradeep Gowda's Code Blog](http://code.btbytes.com/) +- [Hacker News Resources](http://hnresources.com/)([source](http://github.com/yatsyk/HNResources/tree/gh-pages))- Directory of resources related to Hacker News. +- [Ryan McGeary](http://ryan.mcgeary..org/)([source](https://github.com/rmm5t/ryan.mcgeary.org))- Personal site and programming blog. +- [宋文强](http://mochidino.github.com/)([source](https://github.com/mochidino/mochidino.github.com))- CODING MACHINE. +- [The prometheus Image Archive](http://prometheus-bildarchiv.de)([source](https://github.com/prometheus-ev/promhp)) +- [Bjorn Arneson](http://bjornarneson.com/)([source](https://github.com/bjornarneson/bjornarneson.github.com))- Personal website +- [Nutshell.com](http://www.nutshell.com/)- Nutshell CRM's company website. Uses Nutshell's [Less.js Jekyll Plugin](https://gist.github.com/642739). +- [Jason Graham](http://jason.the-graham.com/)([source](https://github.com/jasongraham/blog))- Personal blog. Uses the [kramdown](http://kramdown.rubyforge.org/)Markdown interpreter. Color scheme based on [Zenburn](http://slinky.imukuppi.org/zenburnpage/.) +- [Christopher H. Laco](http://chrislaco.com/)([source](https://github.com/claco/claco.github.com))- Converted from MT txt file w/converted comments to Disqus + Jekyll/Jekyll.vim/Liquid patches. +- [A Developer's Diary](http://foobarnbaz.com/)([source](https://github.com/semk/semk.github.com))- A jekyll powered blog by Sreejith Kesavan +- [Brian Clapper's blog](http://brizzled.clapper.org/)([source](https://github.com/bmc/brizzled))- [personal web site](http://www.clapper.org/)and [company web site](http://www.ardentex.com/.) +- [MxS' area](http://mxs.buffout..org/)([source](https://github.com/aimxhaisse/mxs-area))- Personal blog. +- [saberma](http://saberma.me/)([source](https://github.com/saberma/saberma.github.com))- (马海波) Personal blog in China. +- [Clint Shryock's super awesome 'site/blog'](http://ctshryock.com/)([source](https://github.com/ctshryock/ctshryock.com)) +- [G33k](http://gauthamponnu.com/g33k)- Gautham Ponnu's geek blog. +- [Some Ruby Stuff](http://somerubystuff.com/)([source](https://github.com/guilleiguaran/somerubystuff.com))- Personal and Programming Blog. +- [derrickj's website](http://www.hillcrestlab.com/)([source](https://github.com/derrickj/hillcrestlab.com))- My site/blog. Has an Atom feed and has a few posts with published time specified. +- [MetaSkills.net](http://metaskills.net/)([source](https://github.com/metaskills/metaskills.net)) +- [Corin Cole](http://www.corincole.com/)([source](https://github.com/corincole/corincole.com))- Personal blog/profile. +- [Budi Dharmawan](http://log.budi.ca)- Life Log. +- [Alan Hecht](http://alanhecht.me/)([source](https://github.com/aghecht/alanhecht.me))- Personal site and technical blog. +- [Veraisvoboda.info](http://veraisvoboda.info/)- The project in witness for Freedom of Conscience in Russia. Powered by Jekyll/Sinatra/Rack/Heroky combination. +- [\_layout - themes for jekyll](http://www.layouts-the.me/)([source](https://github.com/studiomohawk/_layouts))- A theme gallery for jekyll powered websites. You can download themes for jekyll via github for free. +- [Luca Pette](http://lucapette.com/)([source](http://github.com/lucapette/lucapette.github.com)) +- [Seyi Ogunyemi](http://micrypt.com/)([source](http://github.com/micrypt/micrypt.github.com)) +- [PaulStamatiou.com](http://paulstamatiou.com/)- Blog about technology, startups and gadgets. +- [TJ Stein](http://tjstein.com/)([source](https://github.com/bummercloud/tjstein.com)) +- [Dave Lim](http://dlimiter.net/)([source](https://github.com/dlimiter/dlimiter.net)) +- [Oto Brglez FERI](http://feri-faks.opalab.com/)([source](https://github.com/otobrglez/feri-faks.opalab.com))- Personal collage projects and assignments. +- [Neil Ang](http://neilang.com/)- Personal blog. +- [Open Source Life](http://www.juev.ru/)([source](https://github.com/Juev/juev.ru))- Personal site and technical blog in Russian. +- [Denis Evsyukov](http://denis.evsyukov.org/)([source](https://github.com/Juev/denis.evsyukov.org))- Personal Page. +- [Satori Tea](http://satori-tea.ru/)- Tea Satori project. +- [Victor Diaz](http://victordiaz.github.com/)- Portfolio. +- [David Collantes](http://collantes.us/)- Personal weblog. +- [Adam Coffman](http://thecoffman.com/)([source](https://github.com/thecoffman/thecoffman.github.com))- Personal and technical blog. +- [Sparanoid](http://sparanoid.com/)([source](https://github.com/sparanoid/sparanoid.com))- Tunghsiao Liu (劉通曉) personal blog about web designs, freehand drawings and other interesting gadgets. +- [Kw’s Blog](http://kwpolska.co.cc/)([source](https://github.com/Kwpolska/kwsblog))- The weblog of a Pole. +- [Gueorgui Tcherednitchenko](http://gueorgui.net/)- Photographer, Web designer & developer. +- [Russell Harmon](http://eatnumber1.com/)([source](https://github.com/eatnumber1/eatnumber1.com))- Personal site and technical blog. +- [Tom Bell](http://tomb.io)([source](http://github.com/tombell/tombell.github.com))- Personal site and blog. +- [Mariusz Nosiński](http://marioosh.5dots.pl)- Developer's blog (in polish). +- [AtlasHost techblog](http://blog.atlashost.eu/)- On JIRA, Java, FreeBSD and open source. +- [Gonzalo Rodríguez](http://nerian.es)([source](https://github.com/Nerian/nerian.github.com))- Freelance Ruby Developer. +- [Danny Bartlett](http://dannybartlett.co.uk/)- Personal site and Mobile / Web Technology blog. +- [Coffee Comrade](http://coffeecomrade.com/)([source](https://github.com/haircut/coffeecomrade.com))- Coffee reviews, tasting notes and commentary. +- [Exolucere](http://exolucere.ca/)([source](https://github.com/robru/robru.github.com))- Robert Park's photography portfolio. +- [redbluemagenta](http://redbluemagenta.com/)([source](https://github.com/cparedes/redbluemagenta-new))- Christian Paredes's system administration blog. +- [yelyah](http://yelyah.com/)([source](https://github.com/hayley/yelyah.com))- singer/songwriter posting new music everyday. +- [Vern's Blog](http://du1abadd.org/)([source](https://github.com/s5unty/du1abadd.org))- Based on Alip's [fork](https://github.com/alip/alip.github.com.) +- [c00kiemon5ter's masterplan](http://c00kiemon5ter.github.com/)([source](https://github.com/c00kiemon5ter/c00kiemon5ter.github.com))- The life of a cookie. +- [PHPTracker - seed server](http://php-tracker.org/)([source](https://github.com/tcz/PHPTracker/tree/gh-pages)) +- [Aaron Beckerman](http://www.aaronbeckerman.com/)([source](https://github.com/ab9/www.aaronbeckerman.com))- Personal site and blog. +- [Miloš Hadžić](http://miloshadzic.com/)([source](http://github.com/miloshadzic/miloshadzic.github.com))- Blog and personal site. +- [Swedish Pixels](http://swedishpixels.com/)- Writings. +- [Georges Auberger](http://auberger.com/)([source](https://github.com/georges/auberger.com))- Blog and personal site. +- [scheibo.com](http://scheibo.com/)([source](https://github.com/scheibo/scheibo.github.com))and [kirkscheibelhut.com](http://kirkscheibelhut.com)- Both blogs built upon the basic structure provided by [static](https://github.com/scheibo/static)and inspired heavily by [jeffkreeftmeijer.com](http://jeffkreeftmeijer.com/.) +- [sparkjs.co.uk](http://sparkjs.co.uk)([source](https://github.com/Wolfy87/sparkjs.co.uk))- Documentation and downloads for the Spark JavaScript library. +- [Rioki's Corner](http://www.rioki.org/)([source](https://github.com/rioki/www.rioki.org))- Sean “Rioki” Farrell's personal website and blog. +- [Jtalk Smalltalk](http://jtalk-project..org/)([source](https://github.com/NicolasPetton/jtalk))- Website of the Jtalk Smalltalk project. +- [music-as-data](http://mad.emotionull.com/)([source](https://github.com/jonromero/music-as-data))- Website of the M.A.D. project, music generation in Clojure. +- [A Day Without Chocolate](http://blog.hardikr.com/)([source](https://github.com/hardikr/hardikr.github.com))- Personal Blog. +- [Georges Duplessy](http://gduplessy.com/)([source](https://github.com/gduplessy/gduplessy.github.com))- Personal blog and portfolio. +- [Jisedai 次世代](http://jisedai.heroku.com/)([source](https://github.com/Vayn/vayn.github.com))- Personal Blog, based on Ben Ubois's [fork](https://github.com/benubois/benubois.com). +- [atomicules.co.uk](http://atomicules.co.uk/)([source](https://github.com/atomicules/atomicules.github.com))- Personal Blog, with Tumblr-inspired post types and archive page. Uses default Jekyll on Github Pages. +- [Stefano Verna](http://stefanoverna.com/)([source](https://github.com/stefanoverna/stefanoverna.com))- Personal blog. +- [Sanjit Saluja](http://sanjitsaluja.com/)([source](https://github.com/loopwhile1/SanjitSaluja.com))- Personal Website and Blog. +- [Philippe Mongeau](http://phmongeau.github.com/)([source](https://github.com/phmongeau/phmongeau.github.com))- Personal Blog and portfolio. +- [Robert Seaton](http://www.rs.io)([source](https://github.com/robertseaton/rs.io))- Archive of written works. +- [Kinnetica](http://www.kinnetica.com/)([source](https://github.com/kinnetica/kinnetica.com))- Michael Levin's personal website and blog about web development. +- [spoonfullofpoo.com](http://www.spoonfullofpoo.com/)([source](https://github.com/kenmickles/spoonfullofpoo.com))- spoonfullofpoo.com produces lo-fi Internet TV for the discerning viewer. Jekyll produces our blog. +- [The Linux Alternative Project](http://www.linuxalt.com/) +- [The Setup](http://usesthis.com/)([source](http://github.com/waferbaby/usesthis/))- A bunch of nerdy interviews. +- [mattaust.in](http://mattaust.in/)([source](http://github.com/maafy6/mattaust.in)) +- [Shallow Thoughts](http://carlosedp.com/)([source](https://github.com/carlosedp/carlosedp.github.com))- Carlos Eduardo's personal blog about tech, development and music. +- [CrowdConf2011](http://crowdconf2011.com/)- Home of the first and leading conference on crowdsourcing and the future of distributed work. +- [Leto Labs](http://letolabs.github.com/)([source](http://github.com/letolabs/letolabs.github.com/))- New PDX-based startup founded by Jonathan "Duke" Leto +- [Morgan Sutherland's Portfolio](http://msutherl.net/)- Responsive environment designer. +- [John Tornow](http://johntornow.com/)- Personal photography blog. +- [Ted Kulp](http://tedkulp.com/)([source](https://github.com/tedkulp/jekyll-template/))- Personal blog about code, tech and photography using custom Jekyll [fork](https://github.com/tedkulp/jekyll) +- [XCSoar](http://www.xcsoar..org/)([source](http://git.xcsoar.org/cgit/master/website.git/))- Open Source Aviation Application (includes generation of [trac](http://trac.edgewall.org/)and [phpBB3](http://www.phpbb.com/)templates). +- [Does Ideas](http://doesideas.com/)([source](https://github.com/mlanza/doesideas/))- Curated blog by a Rubyist. +- [wikimatze](http://wikimatze.de)- Personal Blog. +- [r00tshell](http://www.r00tshell.com/)- Justin Mazzi's Blog. +- [Madhur](http://madhur.github.com)/ + ([Source](https://github.com/madhur/madhur.github.com)) + - Personal / technology / coding blog by Madhur. +- [Bitfluxx](http://bitfluxx.com) ([source](https://github.com/fluxx/bitfluxx.com)) - Software engineer blog. +- [Topguest + Blog](http://blog.topguest.com)/ + ([source](https://github.com/Topguest/topguest.github.com)) - Topguest company blog. +- [Nathan McGinness](http://njmcgee.com) ([source](https://github.com/njmcgee/njmcgee.github.com)) - Personal site and portfolio. +- [/dev/alip]([http://alip.github.com](http://alip.github.com)/) ([source](https://github.com/alip/alip.github.com)) - Personal weblog of Ali Polatel. +- [Lee Jarvis](http://lee.jarvis.co) ([source](https://github.com/injekt/injekt.github.com)) - Personal Blog +- [Happy + Hacking](http://dyang.github.com)/ + ([source](https://github.com/dyang/dyang.github.com)) - Derek Yang’s personal Blog about agile software development, + continuous integration and software configuration management. +- [Peteris + Erins](http://peteriserins.com)/ + ([source](https://github.com/Pet3ris/peteriserins.com)) - Blog & Personal Landing Page. +- [Dropshado.ws]([http://dropshado.ws](http://dropshado.ws)/) ([source](https://github.com/desandro/dropshado.ws/)) +- [Lorenz + Kitzmann](http://lorenzkitzmann.de) + ([source](https://github.com/lorenzk/lorenzkitzmann.de)) - Professional home page and blog. +- [Jentrata](http://jentrata.org) ([source](https://github.com/jentrata/jentrata.github.com)) - Open Source B2B Gateway for AS2 and ebXML. +- "\v/ julian + gruber":[http://juliangruber.com](http://juliangruber.com)/ - + Personal site and blog. +- [fmeyer.org]([http://fmeyer.org](http://fmeyer.org)/) ([source](https://github.com/fmeyer/fmeyer.org)) - Personal blog, or kind off. +- [tristanoneil.com]([http://tristanoneil.com](http://tristanoneil.com)/) ([source](https://github.com/tristanoneil/tristanoneil.github.com/)) - Personal blog, web presence. +- [Tuan Anh Tran](http://tuananh.us) - Personal + blog, web presence (a fork of[Julian + Yap](http://julianyap.com)/ with a theme, + ported from Tumblr). +- [onycloud.com]([http://onycloud.com](http://onycloud.com)/) - + onycloud company website, blog. +- [chadround.co.uk]([http://chadround.co.uk](http://chadround.co.uk)) - Personal site and blog. +- [Scriptish.org]([http://scriptish.org](http://scriptish.org)/) ([source](https://github.com/scriptish/scriptish.github.com)) - Home for Scriptish a Firefox add-on to run user scripts. Custom + fork with support for haml layouts, sass support from plugins, and + pandoc markdown. + ([source](https://github.com/serenium/jekyll) ([source](https://github.com/shenfeng/shenfeng.me)) - Personal site and blog +- [BauCloud.com](http://www.baucloud.com/?pk_campaign=Github&pk_kwd=jekyll) - Cloud computing for the construction management. Website hosted at + github. +- [Alex Ganov](http://aganov.github.com) ([source](https://github.com/aganov/aganov.github.com)) - Personal site and blog. +- [CocoaHeads + Siegen](http://cocoaheads.informatik.uni-siegen.de) + ([source](https://github.com/bmeurer/cocoaheads.informatik.uni-siegen.de)) - Website of the CocoaHeads Siegen chapter. +- [Benedikt + Meurer](http://benediktmeurer.de) + ([source](https://github.com/bmeurer/benediktmeurer.de)) - Personal website and blog. +- [Rodrigo Alves + Vieira](http://www.rodrigoalvesvieira.com)/ + - Personal Blog. +- "Dan + Foreman-Mackey":[http://dfm.github.com](http://dfm.github.com)/ + ([source](https://github.com/dfm/dfm.github.com)) - Personal blog with comments via GitHub forks. +- [Nick + Knowlson](http://nickknowlson.com)/ + ([source](https://github.com/nickknw/nickknowlson.com)) - Personal website with blog and project pages. +- [TechTinkering](http://techtinkering.com) ([source](https://github.com/lawrencewoodman/techtinkering.com)) - A Blog About Retro Computers, Programming, Open Source and General + Technical Tinkering. +- [Greg Osuri](http://gregosuri.com) ([source](https://github.com/gosuri/gosuri.github.com)) +- [Alistair MacLeod](http://mm0hai.net) ([source](https://github.com/anm/anm.github.com)) - Programming, amateur radio, life. A minimal layout with disqus and + sharing buttons. +- [Jen Hanni](http://wickerbox.net) ([source](https://github.com/wicker/wicker.github.com)) - Over a hundred posts in the project portfolio and world travel + photo gallery of an airplane and hardware geek. +- [Prasanna N](http://www.nprasanna.com) - Personal Blog (forked + from[holman](https://github.com/holman/holman.github.com).) - [jnrbsn.com](http://jnrbsn.com/)([source](https://github.com/jnrbsn/jnrbsn.com))- Personal website and blog of Jonathan Robson. +- [Princeton Roaring 20](http://www.princetonroaring20.com/)([source](https://github.com/dskang/princetonroaring20.com))- Website of Roaring 20, a co-ed a cappella group at Princeton University. Built using compass and sass. +- [YOLK](http://yolk.cc)([source](https://github.com/yyolk/yolkportfolio))- Portfolio of Joseph Chiocchi. +- [Jonathan Cremin](http://crem.in)([source](https://github.com/kudos/crem.in))- Personal site of Jonathan Cremin. +- [Sergey Karayev](http://sergeykarayev.com/)([source](https://github.com/sergeyk/website))- Personal site of a graduate student in AI. +- [Thomas Mango](http://thomasmango.com/)([source](https://github.com/tsmango/thomasmango.com))- Personal site of Thomas Mango. +- [robbie/trencheny](http://robbie.io)([source](https://github.com/robbiet480/robbie.io))- Braindumping grounds for Robbie Trencheny. Features Disqus, Facebook Like/Send, works with iPhone. +- [Thomas Kerpe](http://toke.de)([source](https://github.com/toke/toke.github.com))- Personal site and blog. +- [Marcin Pietraszek](http://marcin.pietraszek.pl)([source](https://github.com/kbl/kbl.github.com))- Personal site of Marcin Pietraszek hosted on github. +- [Eli Naeher](http://flyoverblues.com/)([source](https://github.com/enaeher/fb))- Personal blog. +- [Philip Thrasher](http://philipthrasher.com/)- Personal blog. +- [jeremy.tagada.hu](http://jeremy.tagada.hu)([source](https://github.com/jeherve/jeherve.github.com))- Personal blog (forked from [Jekyll Skeleton](https://github.com/jeherve/jekyll-skeleton).) +- [Ellis Berner](http://ellisberner.com/)([source](https://github.com/maletor/maletor.github.com))- Blog and portfolio. +- [Apertu.re](http://Apertu.re)- My Experience Through The Lens - Blog. +- [DirectStupid.net](http://directstupid.net([source](https://github.com/hongguang/hongguang.github.com))-) A chemist thinks in open. +- [danielsmiller.com](http://www.danielsmiller.com([source](https://github.com/jazzdan/danielsmiller.com))-) Dan Miller's personal blog (modified from [Jekyll Skeleton](https://github.com/jeherve/jekyll-skeleton).) +- [The Setup](http://www.usesthis.com/)([source](http://www.github.com/waferbaby/usesthis/))- Nerdy interviews with nerds to like to nerd it up nerdily. +- [Fuse4X](http://fuse4x..org/)([source](https://github.com/fuse4x/fuse4x.github.com))- Fuse API implementation for MacOSX. +- [ArunRocks](http://arunrocks.com/)([source](https://github.com/arocks/arunrocks))- Arun Ravindran's personal blog using tags for related pages. +- [Chris Christensen](http://imetchrischris.com/) +- [Jigar Patel](http://jigarpatel.in)([source](http://github.com/jagira/jagira.github.com))- Personal blog. +- [David Lynch](http://davidlynch.org/)([source](http://github.com/kemayo/davidlynch.org))- Blog and website for David Lynch. Meddles with pagination, tags, and related posts. Includes a complete port of the WordPress toolbox theme, if anyone wants to reuse their styles with it. +- [Carl Groner](http://carlgroner.me/)([source](https://github.com/cgroner/cgroner.github.com))- Personal Site. +- [Robert Boloc](http://robertboloc.github.com/)([source](https://github.com/robertboloc/robertboloc.github.com))- Blog & Playground. +- [Dented Triangle](http://dentedtriangle.com/)([source](https://github.com/dentedtriangle/blog))- Personal, Projects & all things rock climbing. +- [Alex Lande](http://alexlande.com/)([source](https://github.com/lawnday/alexlande.com))- Blog & Portfolio. +- [James Moss](http://jamesmoss.co.uk)([source](https://github.com/jamesmoss/jamesmoss.github.com))- Personal blog. +- [Stéphane R. Richard](http://www.zanshine.com/)([source](https://zanshine.github.com/zanshine/zanshine-jekyll-website)) - French CG Artist, Musician and Programmer. +- [Restfuse](http://www.restfuse.com/) + ([source](https://github.com/eclipsesource/restfuse/tree/gh-pages)) + - An open-source JUnit extension for automated HTTP/REST Tests. +- [OpenideaL](http://www.openidealapp.com/) + ([sorce](https://github.com/linnovate/openidealapp/tree/gh-pages)) - + Landing page of OpenideaL - an open source idea management system, + powered on Drupal 7. +- [krig](http://tusk.se) + ([plugins](https://github.com/krig/jekyll-plugins)) - Personal Site. +- [CodeRetrear Warsaw](http://coderetreat-warsaw.heroku.com/) - Warsaw + page of Global day of Code Retreat (pl). +- [wrug.eu](http://wrug.eu/) - Warsaw Ruby Users Group blog (pl). +- [abhidsm](http://abhidsm.github.com/) + ([source](https://github.com/abhidsm/abhidsm.github.com)) - Personal + Blog. +- [alt.pathawks.com](http://alt.pathawks.com/) + ([source](https://github.com/pathawks/pathawks.github.com)) - + Personal blog. Hosted on GitHub. Pure Jekyll with custom template. +- [MoveToArctic.com](http://movetoarctic.com/) + ([source](https://github.com/kevinrenskers/movetoarctic.com/tree/gh-pages)) + - Personal blog about life in Iceland. Hosted on GitHub. Built with + Bootstrap and Less. +- [The Arcanaeum](http://www.arcanaeum.com/) + ([source](https://github.com/spilth/arcanaeum)) - The Arcanaeum + contains all the books of Skyrim in a simple, clean format for easy + reading on your iPad, iPhone, Android devices and laptop. +- [Sebastian Günther](http://sebastianguenther.org/) - Personal + webpage and blog of a computer scientist researching DSLs in Ruby, + Python, and Scala. +- [Varibru Configuration Languages](http://soft.vub.ac.be/varibru/) - + Landing page of a research project about software variability, + explaining why software configuration languages help to provide mor + variants for more customers. +- [Hacker Monthly](http://hackermonthly.com/) - Print magazine of + Hacker News. +- [Lim Cheng Soon](http://chengsoon.com/) - Personal Blog. +- [Akash Garg](http://akashkgarg.com/) - Personal site of a student of + computer science, entrepreneurship and life. +- [Minimalist theme](http://stephan83.github.com/) + ([source](https://github.com/stephan83/stephan83.github.com) / + [instructions](http://stephan83.github.com/12-07-2011/use-this-theme-on-github.html)) +- [Alexcp.com](http://alexcp.com/) + ([source](https://github.com/alexcp/alexcp-blog)) - Personal Blog. +- Flatterline + ([source](https://github.com/flatterline/flatterline.com)) - A [Ruby + on Rails development company](http://flatterline.com/) website and + blog. Includes a few custom [Jekyll + plugins](https://github.com/flatterline/jekyll-plugins) written + specifically for company websites (e.g., project portfolio, team + page, etc.). +- [Neban’s notebook](http://neban.github.com/) + ([source](http://github.com/neban/neban.github.com)) - Personal + site, hosted at Github. +- [ImPua’s blog](http://impua.info) + ([source](https://github.com/pua/pua.github.com)) - (Geeks get laid, + Chiness blog, 中文博客). +- [Ganz-Sicher.Net](http://ganz-sicher.net/blog/) + ([source](https://github.com/pylight/gsn)) - Personal Blog (German) + about Linux and OpenSource. +- [夜深blog](http://blog.lenage.com/) + ([source](https://github.com/lenage/lenage.github.com)) - Personal + Blog(chinese) about archLinux and Ruby. +- [setImpl](http://lhzhang.com/) + ([source](https://github.com/waynezhang/blog/tree/gh-pages)) - + Personal Blog. +- [Giovanni Cappellotto’s Focus the Web](http://www.focustheweb.com/) + ([source](http://github.com/focustheweb/www.focustheweb.com)) +- [Lost Decade Games](http://www.lostdecadegames.com/) + ([source](https://github.com/lostdecade/lostdecade.github.com)) - + HTML5 game development blog. +- [Dave Peck](http://davepeck.org/) - Personal blog of a [github + user](https://github.com/davepeck/) +- [Stephen McDonald](http://blog.jupo..org/) + ([source](https://github.com/stephenmcd/stephenmcd.github.com)) - + Personal blog on Django and Python. +- [Josh Suereth](http://jsuereth.com/) + ([source](http://github.com/jsuereth/jsuereth.github.com)) - + Personal programming blog, mostly Scala related. +- [Dmytro + Yashkir](http://dyashkir.com([source](https://github.com/dyashkir/dyashkir.github.com))) - Personal blog on programming and other topics. +- [Court Ewing](http://epixa.com/) + ([source](https://github.com/epixa/epixa.com-source)) - Personal + blog. +- [Useful Paradigm](http://usefulparadigm.com/) + ([source](https://github.com/usefulparadigm/usefulparadigm.github.com)) + - Web 2.0 based SW service & solutions (Korea). +- [sitescraper.net](http://sitescraper.net/) - Website and blog for my + business. +- [Adolfo Villafiorita](http://www.ict4g.net/adolfo) + ([source](https://bitbucket.org/adolfov/newhome/)) - Personal + homepage, based on Twitter Bootstrap, (a bit of) jQuery, and some + Liquid programming to find posts with a given tag and generate a + bibliography. +- [Jekyll Bootstrap](https://github.com/nhoss2/jekyll-bootstrap) + ([source](https://github.com/nhoss2/jekyll-bootstrap)) - A super + simple theme to get started with jekyll. Made with twitter + bootstrap. +- [Ali Raza’s personal Blog](http://www.aliirz.com/) + ([source](https://github.com/aliirz/aliirz.com)) +- [Lauri Mäkinen](http://laurimakinen.net/) - Personal website/blog. +- [Dead epsilon](http://juanlu001.github.com/) + ([source](https://github.com/Juanlu001/juanlu001.github.com)) - Blog + about Python in scientific environments (Spanish). +- [Ivan Torres](http://ivantorres.me/) +- [Marko Kaartinen](https://kaartinen.me/) - Humble blog about tech + and stuff. +- [Itai Ferber](http://itaiferber.net/) - Personal site and blog. +- [Recology](http://schamberlain.github.com/) + ([source](https://github.com/SChamberlain/schamberlain.github.com)) + A blog about using the R language in science. +- [Andy Freeland](http://andyfreeland.net/) + ([source](https://github.com/rouge8/andyfreeland.net)) - Personal + site and blog. +- [Joshua Platt](http://joshuaplatt.com/) - Personal site. +- [pala](http://ztpala.com/) - Personal blog (Chinese, 中文). +- [Shaun Bentzen](http://bentzen.ws/) + ([source](http://github.com/sbentzen/sbentzen.github.com)) +- [Simply Measured Blog](http://simplymeasured.com/blog/) + ([source](http://simplymeasured.com/blog/)) +- [ArvinderKang.com](http://arvinderkang.com/) - Portfolio website and + blog of Arvinder Singh Kang - Designer. Programmer. Researcher. +- [Eric Hamiter](http://erichamiter.com/) + ([source](https://github.com/ehamiter/ehamiter.github.com)) - + Personal site/landing page, using HTML5. +- [Jiang Le](http://jiangle.name/) + ([source](https://github.com/naokij/naokij.github.com)) - Personal + blog(Chinese,中文). +- [Alessandro Vermeulen](http://alessandrovermeulen.me/) - Personal + Blog (English). +- [The Utrecht Haskell Compiler JavaScript + Backend](http://uu-computerscience.github.com/uhc-js/) - Launchpad + for using the UHC JS backend. +- [Vladislav Bykov (vladislavbyk)](http://vladislavbyk.github.com/) + ([source](http://github.com/vladislavbyk/vladislavbyk.github.com)) - + Personal Blog (Russian). +- [Sahat.me (Sahat Yalkabov)](http://sahat.me/) + ([source](http://sahat.me)) - Personal Site and Blog. +- [Garron.me (Guillermo Garron)](http://garron.me/) - Personal site + and Blog (English). +- [Pradeepnayak.in (Pradeep Nayak)](http://pradeepnayak.in) - Personal + site and Blog. +- [Fredrik Appelberg](http://mulli.nu) - Personal Blog. +- [Mike Stegeman](http://thestegemans.com/) + ([source](http://github.com/mrstegeman/thestegemans.com)) - Personal + Site and Blog. +- [elf+js](http://elfjs.com/) + ([source](http://github.com/elfjs/elfjs.github.com)) - + [elf+js](http://github.com/elfjs/) + JavaScript库项目主页,博客(Chinese, 中文) +- [/abyme](http://abyme.github.com/) + ([source](http://github.com/abyme/abyme.github.com)) ([theme + source](http://github.com/abyme/abyme-theme)) - Personal blog, + hosted at Github. The theme is available separately. +- [Finch Blog](http://finchformac.com/blog/) - The official blog for + the Mac app Finch. +- [TJ VanToll](http://tjvantoll.com/) + ([source](http://github.com/tjvantoll/tjvantoll.github.com)) - + Personal Site and Blog. +- [Paydirt Blog](https://paydirtapp.com/blog/) - The official blog for + Paydirt time-tracking app. +- [NoFeed \~ No Music for the Masses](http://nofeed..org/) + ([source](https://github.com/ngw/ngw.github.com)) - Personal Blog + hosted on Github. +- [instant-thinking.de](http://instant-thinking.de) - Personal blog in + german. Contains my personal tidbits and the occasional tech post. + Running with Octopress. +- [Computer-Heimwerker Blog](http://home-server-mind.com/) - Personal + computer blog in german. +- [Matthew Scharley](http://matt.scharley.me/) + ([source](http://github.com/mscharley/mscharley.github.com)) - + Personal blog of a web developer hosted as GitHub. +- [Edward Hotchkiss, Blog](http://edwardhotchkiss.com/) + ([source](http://github.com/edwardhotchkiss/edwardhotchkiss.github.com/)) + - Site & Blog. +- [闭门造轮子](http://mytharcher.github.com/) + ([source](https://github.com/mytharcher/mytharcher.github.com)) + 造轮子工程师的代码笔记 +- [Rod Ebrahimi](http://innovatebig.com/) - Personal blog on business + and tech, co-founder/ceo of ReadyForZero. +- [Hong Xu](http://dev.hong.me/) + ([source](https://github.com/xuhdev/homepage)) - Personal Site and + Blog. +- [Jilles Oldenbeuving](http://www.jilles.net/) + ([source](https://github.com/ojilles/jilles.net)) - Personal Blog. +- [ACBuS](http://www.acbus.org/) - Automotive Communication Bus + Sniffer. +- [Lauri Lehmijoki](http://lauri.lehmijoki.net/) + ([source](https://github.com/laurilehmijoki/lauri.lehmijoki.net)) - + Personal web site. +- [Xiaoli](http://xiaoli.github.com/) +- [Andrew C. Reed](http://andrewcreed.com/) + ([source](https://github.com/Networc/networc.github.com)) - Personal + website & blog. Theme from Tom Preston-Werner. Added Google+ & Tweet + buttons for repo list. +- [Jonathan Tsai](http://www.jonathantsai.com/) + ([source](https://github.com/jontsai/jontsai.github.com)) - Personal + website and blog. +- [雁起平沙的文艺博客](http://art.yanping.me/) + ([source](https://github.com/yanping/art)) - Personal blog (Chinese, + 中文). +- [Daniel Nyström](http://www.danielnystrom.se/) + ([source](https://github.com/xazax/xazax.github.com)) - Personal + Blog. +- [Marcin Świerczyński](http://blog.swierczynski.net/) + ([source](https://github.com/MarcinOS/marcinos.github.com)) - + Personal Blog. +- [ddatsh](http://ddatsh.com/) + ([source](https://github.com/zhangthe9/blog)) - Personal blog + (Chinese, 中文). +- [Amir Chaudhry](http://amirchaudhry.com/) + ([source](https://github.com/amirmc/amirmc.github.com)) - Personal + Blog exported from Posterous and using Jekyll Bootstrap and + (customised) Twitter Bootstrap theme. Included AddThis sharing + buttons for posts. +- [Xiaodong Xu](http://toy.linuxtoy..org/) + ([source](https://github.com/xuxiaodong/xuxiaodong.github.com)) - + About Linux, Perl, Ruby and more. +- [Mijndert Stuij](http://mijndertstuij.nl) + ([source](https://github.com/mijndert/mijndertstuij.nl)) - Personal + blog featuring various articles for sysadmins and people alike. +- [PiZn](http://www.pizn.me/) + ([source](https://github.com/pizn/pizn.github.com)) - This blog use + for fast recording my work, learning and life. + 用来快速记录工作,学习,生活的一点一滴 +- [Ivaylo Kuzev](http://ivo.tehif.eu) + ([source](https://github.com/ivoarch/ivoarch.github.com)) - + Sourcecode of my weblog (Bulgarian). +- [Mort | Looking Glass](http://www.soimort.org/) + ([source](https://github.com/soimort/soimort.github.com)) - Personal + website and blog. +- [Monupco](http://monupco.com/blog/) + ([source](https://github.com/monupco/blog)) - Company blog with + custom theme. +- [Giant Robot Battle](http://giantrobotbattle.com/) + ([source](https://github.com/jwwest/jwwest.github.com)) - Articles + about bootstrapping startup companies. +- [Paul W. Rankin’s Website](http://www.paulrankinwebsite.com/) + ([source](http://github.com/rnkn/rnkn.github.com)) - Filmmaking + portfolio. +- [jekylog](http://fingaholic.github.com/) + ([source](https://github.com/FiNGAHOLiC/fingaholic.github.com)) - My + personal blog powered by jekyll. +- [Denis Roussel](http://denisroussel.fr/) - Tech blog (in french). +- [Alan W. Smith](http://alanwsmith.com/) - Personal site, gallery and + code snippets. +- [Business Guide.co.uk](http://www.businessguide.co.uk/) - Converted + Wordpress blog . +- [Roland Warmerdam](http://rolandwarmerdam.co.nz) + ([source](https://github.com/Rowno/rolandwarmerdam.co.nz)) – + Personal website and blog. +- [Thatch Arce aka 希夷先生](http://blankego.github.com/) + ([source](https://github.com/blankego/blankego.github.com)) - An + all-inclusive personal site, programming and hobbies, blog and + aggregation of useful resources.(汝安知魚之樂,我知之濠上也) Just + take peek! +- [colaborativa corporate site](http://colaborativa.eu/) + ([source](https://github.com/colaborativa/colaborativa.github.com)) + - A complete port of our previous Drupal corporate website using + Jekyll, highly modular design and complex scss layout, let us know + what do you think! +- [incumbent](http://incumbent.org/) - a personal homepage (i + **heart** Yuya Saito) +- [Garrett Winder](http://garrettwinder.com/) + ([source](https://github.com/garrettwinder/garrettwinder.com)) +- [Patrick Mylund Nielsen](http://patrickmylund.com/) ~~- A blog about + astronomy, life, and miscellaneous geekery +- [Miha Hribar](http://hribar.info)~~ CTO of Toshl, professional + hobbyist, [source code](https://github.com/mihahribar/hribar.info) +- [pH 7](http://ph-7.github.com) - A personal website using jQuery, + Twitter Bootstrap and of course **Jekyll**! It also uses Ajax to + load pages. ([source code](https://github.com/pH-7/ph-7.github.com)) +- [Creating Code](http://creatingcode.com) - A programming blog by + Robert Greiner. +- [neocotic](http://neocotic.com) + ([source](http://github.com/neocotic/neocotic.github.com)) +- [Hamsterboy](http://hamsterboy.dk) +- [Jake Harding](http://thejakeharding.com) + ([source](https://github.com/jharding/jharding.github.com)) +- [sbin.dk](http://sbin.dk) - A personal website + ([source](https://github.com/toin0u/sbin.dk)) +- [Romain Sertelon (BluePyth)](http://blog.bluepyth.fr) - A tech blog + by a French Geek ([source](https://github.com/BluePyth/my-blog)) +- [island205(Zhi Cun)](http://island205.github.com) - a + introduction about me. +- [Reverland](http://reverland.github.com) - A personal website + ([source](https://github.com/reverland/reverland.github.com)) +- [SeedProd](http://www.seedprod.com) - Built my entire Marketing Site + with Jekyll +- [Imaginal Torch](http://imaginaltor.ch) - Blog visually inspired by + William Morris and the Arts & Crafts movement +- [Luvah: Journal of the Creative Imagination](http://mimes.is) - + Academic journal focused on exploring the intersections of religion + and politics in a world that has lost touch with traditional ways of + **knowing**. +- [Maplebeats(枫叶饭团)](http://maplebeats.com) - A personal website + using jquery ajax and + jekyll([source](https://github.com/maplebeats/maplebeats.github.com)) +- [Indonesian Virtualizer](http://idvps.org) - Personal website using + Octopress jekyll framework. +- [Fabio Souto](http://fabiosouto.me/) - Personal website and blog + ([source](https://github.com/fsouto/fsouto.github.com)) +- [Gopal Venkatesan](http://g13n.github.com/blog/) - Technology blog + using HTML5/CSS3 ([source](https://github.com/g13n/blog)) +- [Juan de Bravo](http://www.juandebravo.com) + ([source](https://www.github.com/juandebravo/juandebravo.github.com)) + - Personal tech blog. +- [Overworld Map](http://www.overworldmap.com/) - a weblog about video + game cartography +- [DemoJS](http://demojs.org) - DemoJS demoparty infosite +- [hzmook](http://hzmook.github.com/) + ([source](https://github.com/hzmook/hzmook.github.com)) - Personal + blog(Chinese,中文). +- [Simply David Nelson](http://www.simplydavidnelson.com) - Software + Engineering And Architecture +- [Tim Marinin](http://tim.tom.ru) + ([source](https://github.com/booley/booley.github.com)) — personal + blog (Russian) diff --git a/site/_posts/2012-07-01-structure.md b/site/_posts/2012-07-01-structure.md new file mode 100644 index 00000000..87362b44 --- /dev/null +++ b/site/_posts/2012-07-01-structure.md @@ -0,0 +1,95 @@ +--- +layout: docs +title: Directory structure +prev_section: usage +next_section: configuration +--- + +Jekyll at its core is a text transformation engine. The concept behind the system is this: you give it text written in your favorite markup language, be that Markdown, Textile, or just plain HTML, and it churns that through a layout or series of layout files. Throughout that process you can tweak how you want the site URLs to look, what data gets displayed on the layout and more. This is all done through strictly editing files, and the web interface is the final product. + +A basic Jekyll site usually looks something like this: + +{% highlight bash %} +. +├── _config.yml +├── _includes +| ├── footer.html +| └── header.html +├── _layouts +| ├── default.html +| └── post.html +├── _posts +| ├── 2007-10-29-why-every-programmer-should-play-nethack.textile +| └── 2009-04-26-barcamp-boston-4-roundup.textile +├── _site +└── index.html +{% endhighlight %} + +An overview of what each of these does: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
File / DirectoryDescription
+

_config.yml

+
+

Stores configuration data. A majority of these options can be specified from the command line executable but it’s easier to throw them in here so you don’t have to remember them.

+
+

_includes

+
+

These are the partials that can be mixed and matched by your _layouts and _posts to facilitate reuse. The liquid tag {{ "{% include file.ext " }}%} can be used to include the partial in _includes/file.ext.

+
+

_layouts

+
+

These are the templates which posts are inserted into. Layouts are chosen on a post-by-post basis in the YAML front matter, which is described in the next section. The liquid tag {{ "{{ content " }}}} is used to inject data onto the page.

+
+

_posts

+
+

Your dynamic content, so to speak. The format of these files is important, as named as YEAR-MONTH-DAY-title.MARKUP. The permalinks can be adjusted very flexibly for each post, but the date and markup language are determined solely by the file name.

+
+

_site

+
+

This is where the generated site will be placed once Jekyll is done transforming it. It's probably a good idea to add this to your .gitignore file.

+
+

index.html and other HTML, Markdown, Textile files

+
+

Provided that the file has a YAML Front Matter section, it will be transformed by Jekyll. The same will happen for any .html, .markdown, .md, or .textile file in your site's root directory or directories not listed above.

+
+

Other Files/Folders

+
+

Every other directory and file except for those listed above—such as css and images folders, favicon.ico files, and so forth—will be transferred over verbatim to the generated site. There's plenty of sites already using Jekyll if you're curious as to how they're laid out.

+
diff --git a/site/_posts/2012-07-01-templates.md b/site/_posts/2012-07-01-templates.md new file mode 100644 index 00000000..edd76a71 --- /dev/null +++ b/site/_posts/2012-07-01-templates.md @@ -0,0 +1,217 @@ +--- +layout: docs +title: Templates +prev_section: migrations +next_section: permalinks +--- + +Jekyll uses the [Liquid](http://www.liquidmarkup.org/) templating language to process templates. All of the [standard Liquid tags and filters](http://wiki.github.com/shopify/liquid/liquid-for-designers) are supported, Jekyll even adds a few handy filters and tags of its own to make common tasks easier. + +## Filters + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
DescriptionFilter and Output
+

Date to XML Schema

+

Convert a Date into XML Schema format.

+
+

+ {{ "{{ site.time | date_to_xmlschema " }}}} +

+

+ 2008-11-17T13:07:54-08:00 +

+
+

Date to String

+

Convert a date to short format.

+
+

+ {{ "{{ site.time | date_to_string " }}}} +

+

+ 17 Nov 2008 +

+
+

Date to Long String

+

Format a date to long format.

+
+

+ {{ "{{ site.time | date_to_long_string " }}}} +

+

+ 17 November 2008 +

+
+

XML Escape

+

Escape some text for use in XML.

+
+

+ {{ "{{ page.content | xml_escape " }}}} +

+
+

CGI Escape

+

CGI escape a string for use in a URL. Replaces any special characters with appropriate %XX replacements.

+
+

+ {{ "{{ “foo,bar;baz?” | cgi_escape " }}}} +

+

+ foo%2Cbar%3Bbaz%3F +

+
+

Number of Words

+

Count the number of words in some text.

+
+

+ {{ "{{ page.content | number_of_words " }}}} +

+

+ 1337 +

+
+

Array to Sentence

+

Convert an array into a sentence. Useful for listing tags.

+
+

+ {{ "{{ page.tags | array_to_sentence_string " }}}} +

+

+ foo, bar, and baz +

+
+

Textilize

+

Convert a Textile-formatted string into HTML, formatted via RedCloth

+
+

+ {{ "{{ page.excerpt | textilize " }}}} +

+
+

Markdownify

+

Convert a Markdown-formatted string into HTML.

+
+

+ {{ "{{ page.excerpt | markdownify " }}}} +

+
+ +## Tags + +### Includes (Partials) + +If you have small page fragments that you wish to include in multiple +places on your site, you can use the `include` tag. + +{% highlight ruby %} +{{ "{% include sig.textile " }}%} +{% endhighlight %} + +Jekyll expects all include files to be placed in an `_includes` +directory at the root of your source dir. So this will embed the +contents of `/path/to/your/site/_includes/sig.textile` into the calling +file. + +### Code snippet highlighting + +Jekyll has built in support for syntax highlighting of [over 100 +languages](http://pygments.org/languages/) thanks to +[Pygments](http://pygments.org/). In order to take advantage of this +you’ll need to have Pygments installed, and the `pygmentize` binary must +be in your `$PATH`. When you run Jekyll, make sure you run it with +[Pygments enabled](../extras). + +To render a code block with syntax highlighting, surround your code as follows: + +{% highlight ruby %} +{{ "{% highlight ruby " }}%} +def foo + puts 'foo' +end +{{ "{% endhighlight " }}%} +{% endhighlight %} + +The argument to the `highlight` tag (`ruby` in the example above) is the language identifier. To find the appropriate identifier to use for the language you want to highlight, look for the “short name” on the [Lexers page](http://pygments.org/docs/lexers/). + +#### Line numbers + +There is a second argument to `highlight` called `linenos` that is +optional. Including the `linenos` argument will force the highlighted +code to include line numbers. For instance, the following code block +would include line numbers next to each line: + +{% highlight ruby %} +{{ "{% highlight ruby linenos " }}%} +def foo + puts 'foo' +end +{{ "{% endhighlight " }}%} +{% endhighlight %} + +#### Stylesheets for syntax highlighting + +In order for the highlighting to show up, you’ll need to include a +highlighting stylesheet. For an example stylesheet you can look at +[syntax.css](http://github.com/mojombo/tpw/tree/master/css/syntax.css). +These are the same styles as used by GitHub and you are free to use them +for your own site. If you use linenos, you might want to include an +additional CSS class definition for the `.lineno` class in `syntax.css` to +distinguish the line numbers from the highlighted code. + +### Post URL + +If you would like to include a link to a post on your site, the `post_url` tag will generate the correct permalink URL for the post you specify. + +{% highlight bash %} +{{ "{% post_url 2010-07-21-name-of-post " }}%} +{% endhighlight %} + +There is no need to include the file extension when using the `post_url` tag. + +You can also use this tag to create a link to a post in Markdown as follows: + +{% highlight html %} +[Name of Link]({{ "{% post_url 2010-07-21-name-of-post " }}%}) +{% endhighlight %} + diff --git a/site/_posts/2012-07-01-troubleshooting.md b/site/_posts/2012-07-01-troubleshooting.md new file mode 100644 index 00000000..e6a592f2 --- /dev/null +++ b/site/_posts/2012-07-01-troubleshooting.md @@ -0,0 +1,108 @@ +--- +layout: docs +title: Troubleshooting +prev_section: contributing +next_section: sites +--- + +If you ever run into problems installing or using Jekyll, here’s a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please [report an issue](https://github.com/mojombo/jekyll/issues/new) so the Jekyll community can make everyone’s experience better. + +## Installation Problems + +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 Ubunutu or Debian by running: + +{% highlight bash %} +sudo apt-get install ruby1.9.1-dev +{% endhighlight %} + +On Red Hat, CentOS, and Fedora systems you can do this by running: + +{% highlight bash %} +sudo yum install ruby-devel +{% endhighlight %} + +On [NearlyFreeSpeech](http://nearlyfreespeech.net/) you need to run the command with the following environment variable: + +{% highlight bash %} +RB_USER_INSTALL=true gem install jekyll +{% endhighlight %} + +On OSX, you may need to update RubyGems: + +{% highlight bash %} +sudo gem update --system +{% endhighlight %} + +To install RubyGems on Gentoo: + +{% highlight bash %} +sudo emerge -av dev-ruby/rubygems +{% endhighlight %} + +On Windows, you may need to install [RubyInstaller +DevKit](http://wiki.github.com/oneclick/rubyinstaller/development-kit). + +## Problems running Jekyll + +On Debian or Ubuntu, you may need to add /var/lib/gems/1.8/bin/ to your path in order to have the `jekyll` executable be available in your Terminal. + +## Base-URL Problems + +If you are using base-url option like `jekyll --server --base-url '/blog'` then make sure that you access the site at `http://localhost:4000/blog/index.html`. Just accessing `http://localhost:4000/blog` will not work. + +## Configuration problems + + +The order of precedence for conflicting [configuration settings](../configuration) is as follows: + +1. Command-line flags +2. Configuration file settings +3. Defaults + +That is: defaults are overridden by options specified in `_config.yml`, and flags specified at the command-line will override all other settings specified elsewhere. + +## Markup Problems + +The various markup engines that Jekyll uses may have some issues. This +page will document them to help others who may run into the same +problems. + +### Maruku + +If your link has characters that need to be escaped, you need to use +this syntax: + +`![Alt text](http://yuml.me/diagram/class/[Project]->[Task])` + +If you have an empty tag, i.e. ``, Maruku +transforms this into `