mirror of
https://github.com/jekyll/jekyll.git
synced 2026-02-01 10:15:03 -05:00
1163fa905e
It would really pain me if the default Jekyll site were XHTML. That'd be bad for the internet. Instead, use Twitter Bootstrap as a base (while still keeping @mojombo's origin design), to give users a great initial baseline to build beautiful, simple sites. Defaults are more than just the starting point. It's what 80% of users are going to use. Look at WordPress and the default theme. May as well lead by example and start the user off right. * Add Bootstrap base CSS as a better reset and base layer * Update default layout to HTML5 with boilerplate best practices * Add title and post date to post.html (rather than including in the post itself) * Make site title a variable and add to _config.yml * Add page title to header * Add default .gitignore to ignore `_site` * Remove unused `rss.png` and `.gitkeep` * Add Modernizr for legacy IE support
h1. Jekyll !https://travis-ci.org/mojombo/jekyll.png?branch=master!:https://travis-ci.org/mojombo/jekyll "!https://codeclimate.com/github/mojombo/jekyll.png!":https://codeclimate.com/github/mojombo/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":http://pages.github.com, which you can use to host your project's page or blog right here from GitHub. h2. Getting Started * "Install":http://wiki.github.com/mojombo/jekyll/install the gem * Read up about its "Usage":http://wiki.github.com/mojombo/jekyll/usage and "Configuration":http://wiki.github.com/mojombo/jekyll/configuration * Take a gander at some existing "Sites":http://wiki.github.com/mojombo/jekyll/sites * Fork and "Contribute":http://wiki.github.com/mojombo/jekyll/contribute your own modifications * Have questions? Post them on the "Mailing List":http://groups.google.com/group/jekyll-rb h2. Diving In * "Migrate":http://wiki.github.com/mojombo/jekyll/blog-migrations from your previous system * Learn how the "YAML Front Matter":http://wiki.github.com/mojombo/jekyll/yaml-front-matter works * Put information on your site with "Template Data":http://wiki.github.com/mojombo/jekyll/template-data * Customize the "Permalinks":http://wiki.github.com/mojombo/jekyll/permalinks your posts are generated with * Use the built-in "Liquid Extensions":http://wiki.github.com/mojombo/jekyll/liquid-extensions to make your life easier * Use custom "Plugins":http://wiki.github.com/mojombo/jekyll/Plugins to generate content specific to your site h2. Runtime Dependencies * 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) h2. Developer Dependencies * RDiscount: Discount Markdown Processor (Ruby) * RedCloth: Textile support (Ruby) * RedGreen: Nicer test output (Ruby) * RR: Mocking (Ruby) * Shoulda: Test framework (Ruby) h2. License See "LICENSE":https://github.com/mojombo/jekyll/blob/master/LICENSE.