Go to file

Parker Moore 2cc5dc3704 Update history to reflect merge of #1488		2013-09-01 13:37:06 -04:00
bin	Fixed --layouts option	2013-08-26 17:19:32 +02:00
features	Fix date format in permalink.features.	2013-08-11 12:40:28 +02:00
lib	Merge pull request #1341 from maul-esel/minor-refactors	2013-08-29 20:21:08 -07:00
script	Add a bootstrap script	2013-01-22 23:10:51 +00:00
site	Merge pull request #1488 from troyswanson/iso8601	2013-09-01 10:35:44 -07:00
test	Merge pull request #944 from x3ro/permalink-special-characters	2013-08-28 15:02:20 -07:00
.gitignore	Remove duplicate	2013-08-21 23:08:26 +02:00
.travis.yml	Remove duplicate period in travis message.	2013-07-01 17:41:11 +02:00
CONTRIBUTING.markdown	Standardized all text files on markdown and set all their extensions to the shortform	2013-07-06 13:51:33 -04:00
Gemfile	Explicitly require HTTPS rubygems source	2013-02-27 20:28:09 -05:00
History.markdown	Update history to reflect merge of #1488	2013-09-01 13:37:06 -04:00
LICENSE	convert to use rakegem	2010-04-21 13:55:01 -07:00
README.markdown	Replace defunked mailing list link with info on IRC room.	2013-08-16 11:56:36 -04:00
Rakefile	Merge pull request #1480 from mojombo/ignore-_site-in-deploy	2013-08-30 15:41:10 -07:00
cucumber.yml	Change default format to pretty and create travis profile	2013-03-04 03:12:31 +01:00
jekyll.gemspec	Release 1.1.2	2013-07-25 09:15:34 +02:00

README.markdown

Jekyll

By Tom Preston-Werner, Nick Quaranto, and many awesome contributors!

Jekyll is a simple, blog aware, static site generator. It takes a template directory (representing the raw form of a website), runs it through Textile or Markdown and Liquid converters, and spits out a complete, static website suitable for serving with Apache or your favorite web server. This is also the engine behind GitHub Pages, which you can use to host your project's page or blog right here from GitHub.

Getting Started

Install the gem
Read up about its Usage and Configuration
Take a gander at some existing Sites
Fork and Contribute your own modifications
Have questions? Check out #jekyll on irc.freenode.net.

Diving In

Migrate from your previous system
Learn how the YAML Front Matter works
Put information on your site with Variables
Customize the Permalinks your posts are generated with
Use the built-in Liquid Extensions to make your life easier
Use custom Plugins to generate content specific to your site

Runtime Dependencies

Commander: Command-line interface constructor (Ruby)
Colorator: Colorizes command line output (Ruby)
Classifier: Generating related posts (Ruby)
Directory Watcher: Auto-regeneration of sites (Ruby)
Kramdown: Markdown-superset converter (Ruby)
Liquid: Templating system (Ruby)
Maruku: Default markdown engine (Ruby)
Pygments.rb: Syntax highlighting (Ruby/Python)
RedCarpet: Markdown engine (Ruby)
Safe YAML: YAML Parser built for security (Ruby)

Developer Dependencies

Launchy: Cross-platform file launcher (Ruby)
RDiscount: Discount Markdown Processor (Ruby)
RedCloth: Textile support (Ruby)
RedGreen: Nicer test output (Ruby)
RR: Mocking (Ruby)
Shoulda: Test framework (Ruby)
SimpleCov: Coverage framework (Ruby)

License

See LICENSE.