User Tools

Site Tools


it:jekyll

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
it:jekyll [2014/03/30 19:09]
Alexander Rind Files to Exclude
it:jekyll [2014/10/16 11:26] (current)
Alexander Rind Navigation
Line 1: Line 1:
 ====== Jekyll: website generator ====== ====== Jekyll: website generator ======
  
 +  * https://​github.com/​jekyll/​jekyll
   * http://​blog.jetstrap.com/​2013/​03/​building-a-docs-site-with-jekyll-github-pages/ ​     * http://​blog.jetstrap.com/​2013/​03/​building-a-docs-site-with-jekyll-github-pages/ ​  
   * https://​help.github.com/​articles/​using-jekyll-with-pages ​   * https://​help.github.com/​articles/​using-jekyll-with-pages ​
Line 6: Line 7:
   * http://​pages.github.com/ ​   * http://​pages.github.com/ ​
   * https://​help.github.com/​articles/​creating-project-pages-manually ​   * https://​help.github.com/​articles/​creating-project-pages-manually ​
 +
 +===== Installation =====
 +
 +https://​help.github.com/​articles/​using-jekyll-with-pages#​installing-jekyll
 +
 +  - install Ruby via ''​apt''​
 +  - ''​gem install bundler''​
 +  - create or checkout a ''​Gemfile''​ and run ''​[sudo] bundle install''​
 +  - test using ''​jekyll serve --watch''​
  
 ===== Files to Exclude ===== ===== Files to Exclude =====
Line 18: Line 28:
  
   * Maruku ​   * Maruku ​
-    * old default -- now deprecated +    * [[https://​help.github.com/​articles/​migrating-your-pages-site-from-maruku | old default -- now deprecated]] 
-  * Kramdown+  * [[https://​github.com/​gettalong/​kramdown | Kramdown]]
     * similar to Maruku     * similar to Maruku
-    * http://​kramdown.gettalong.org/​quickref.html +    * default in Jekyll 
-    * http://​kramdown.gettalong.org/​syntax.html +    * Syntax: [[http://​kramdown.gettalong.org/​quickref.html ​| Quick]] or [[http://​kramdown.gettalong.org/​syntax.html | Long]] 
-  * RedCarpet +    * Options: [[http://​kramdown.gettalong.org/​rdoc/​Kramdown/​Options.html | documented]] and [[http://​jekyllrb.com/​docs/​configuration/#​default-configuration | defaults in Jekyll]] 
-    * [[https://​github.com/​blog/​832-rolling-out-the-redcarpet | developed by and for GitHub]] ​--> same syntax like GitHub+  * [[https://​github.com/​vmg/​redcarpet | RedCarpet]] 
 +    * [[https://​github.com/​blog/​832-rolling-out-the-redcarpet | developed by and for GitHub]] 
 +    * similar ​syntax like GitHub, but not exactly the same 
 +      * needs ''​ extensions: [smart, autolink, strikethrough,​ no_intra_emphasis,​ tables]'' ​
     * http://​yangsu.github.io/​blog/​2012/​10/​11/​using-octopress-with-github-flavored-markdown-redcarpet/​     * http://​yangsu.github.io/​blog/​2012/​10/​11/​using-octopress-with-github-flavored-markdown-redcarpet/​
-    * https://​github.com/​vmg/​redcarpet/​blob/​v2.2.2/​README.markdown#​and-its-like-really-simple-to-use +    * [[https://​github.com/​vmg/​redcarpet/​blob/​v2.3.0/​README.markdown#​and-its-like-really-simple-to-use ​| Extensions]] 
-  * RDiscount +  * [[https://​github.com/​davidfstr/​rdiscount ​| RDiscount]]
-    * https://​github.com/​davidfstr/​rdiscount ​+
   * Textile   * Textile
     * http://​txstyle.org ​     * http://​txstyle.org ​
 +    * http://​en.wikipedia.org/​wiki/​Textile_%28markup_language%29
 +
 +===== Navigation =====
 +
 +  * [[http://​stackoverflow.com/​questions/​9053066/​sorted-navigation-menu-with-jekyll-and-liquid | use page metadata]]
 +  * use central data object
 +
  
it/jekyll.1396199380.txt · Last modified: 2014/03/30 19:09 by Alexander Rind

alex @ ieg: home about me publications research