{{text | replace:"|.", "{" | replace:".|", "}" | replace:">", ">" | replace:"<", "<" }}
31 | {% endif %}
32 | {% assign text = nil %}
--------------------------------------------------------------------------------
/_includes/JB/pages_list:
--------------------------------------------------------------------------------
1 | {% comment %}{% endcomment %}
22 |
23 | {% if site.JB.pages_list.provider == "custom" %}
24 | {% include custom/pages_list %}
25 | {% else %}
26 | {% for node in pages_list %}
27 | {% if node.title != null %}
28 | {% if group == null or group == node.group %}
29 | {% if page.url == node.url %}
30 | #{obj.class}\n#{obj.pretty_inspect}" 33 | end 34 | 35 | end # DebugFilter 36 | end # Jekyll 37 | 38 | Liquid::Template.register_filter(Jekyll::DebugFilter) -------------------------------------------------------------------------------- /_posts/2011-12-29-jekyll-introduction.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: post 3 | category : lessons 4 | tagline: "Supporting tagline" 5 | tags : [blog] 6 | --- 7 | {% include JB/setup %} 8 | 9 | This Jekyll introduction will outline specifically what Jekyll is and why you would want to use it. 10 | Directly following the intro we'll learn exactly _how_ Jekyll does what it does. 11 | 12 | ## Overview 13 | 14 | ### What is Jekyll? 15 | 16 | Jekyll is a parsing engine bundled as a ruby gem used to build static websites from 17 | dynamic components such as templates, partials, liquid code, markdown, etc. Jekyll is known as "a simple, blog aware, static site generator". 18 | 19 | ### Examples 20 | 21 | This website is created with Jekyll. [Other Jekyll websites](https://github.com/mojombo/jekyll/wiki/Sites). 22 | 23 | 24 | 25 | ### What does Jekyll Do? 26 | 27 | Jekyll is a ruby gem you install on your local system. 28 | Once there you can call `jekyll --server` on a directory and provided that directory 29 | is setup in a way jekyll expects, it will do magic stuff like parse markdown/textile files, 30 | compute categories, tags, permalinks, and construct your pages from layout templates and partials. 31 | 32 | Once parsed, Jekyll stores the result in a self-contained static `_site` folder. 33 | The intention here is that you can serve all contents in this folder statically from a plain static web-server. 34 | 35 | You can think of Jekyll as a normalish dynamic blog but rather than parsing content, templates, and tags 36 | on each request, Jekyll does this once _beforehand_ and caches the _entire website_ in a folder for serving statically. 37 | 38 | ### Jekyll is Not Blogging Software 39 | 40 | **Jekyll is a parsing engine.** 41 | 42 | Jekyll does not come with any content nor does it have any templates or design elements. 43 | This is a common source of confusion when getting started. 44 | Jekyll does not come with anything you actually use or see on your website - you have to make it. 45 | 46 | ### Why Should I Care? 47 | 48 | Jekyll is very minimalistic and very efficient. 49 | The most important thing to realize about Jekyll is that it creates a static representation of your website requiring only a static web-server. 50 | Traditional dynamic blogs like Wordpress require a database and server-side code. 51 | Heavily trafficked dynamic blogs must employ a caching layer that ultimately performs the same job Jekyll sets out to do; serve static content. 52 | 53 | Therefore if you like to keep things simple and you prefer the command-line over an admin panel UI then give Jekyll a try. 54 | 55 | **Developers like Jekyll because we can write content like we write code:** 56 | 57 | - Ability to write content in markdown or textile in your favorite text-editor. 58 | - Ability to write and preview your content via localhost. 59 | - No internet connection required. 60 | - Ability to publish via git. 61 | - Ability to host your blog on a static web-server. 62 | - Ability to host freely on GitHub Pages. 63 | - No database required. 64 | 65 | # How Jekyll Works 66 | 67 | The following is a complete but concise outline of exactly how Jekyll works. 68 | 69 | Be aware that core concepts are introduced in rapid succession without code examples. 70 | This information is not intended to specifically teach you how to do anything, rather it 71 | is intended to give you the _full picture_ relative to what is going on in Jekyll-world. 72 | 73 | Learning these core concepts should help you avoid common frustrations and ultimately 74 | help you better understand the code examples contained throughout Jekyll-Bootstrap. 75 | 76 | 77 | ## Initial Setup 78 | 79 | After [installing jekyll](/index.html#start-now) you'll need to format your website directory in a way jekyll expects. 80 | Jekyll-bootstrap conveniently provides the base directory format. 81 | 82 | ### The Jekyll Application Base Format 83 | 84 | Jekyll expects your website directory to be laid out like so: 85 | 86 | . 87 | |-- _config.yml 88 | |-- _includes 89 | |-- _layouts 90 | | |-- default.html 91 | | |-- post.html 92 | |-- _posts 93 | | |-- 2011-10-25-open-source-is-good.markdown 94 | | |-- 2011-04-26-hello-world.markdown 95 | |-- _site 96 | |-- index.html 97 | |-- assets 98 | |-- css 99 | |-- style.css 100 | |-- javascripts 101 | 102 | 103 | - **\_config.yml** 104 | Stores configuration data. 105 | 106 | - **\_includes** 107 | This folder is for partial views. 108 | 109 | - **\_layouts** 110 | This folder is for the main templates your content will be inserted into. 111 | You can have different layouts for different pages or page sections. 112 | 113 | - **\_posts** 114 | This folder contains your dynamic content/posts. 115 | the naming format is required to be `@YEAR-MONTH-DATE-title.MARKUP@`. 116 | 117 | - **\_site** 118 | This is where the generated site will be placed once Jekyll is done transforming it. 119 | 120 | - **assets** 121 | This folder is not part of the standard jekyll structure. 122 | The assets folder represents _any generic_ folder you happen to create in your root directory. 123 | Directories and files not properly formatted for jekyll will be left untouched for you to serve normally. 124 | 125 | (read more: