feat(config): update comment for better readability

sparanoid · Jun 6, 2016 · 16911d8 · 16911d8
1 parent 6617343
commit 16911d8
Show file tree

Hide file tree

Showing 2 changed files with 47 additions and 15 deletions.
diff --git a/_config.init.yml b/_config.init.yml
@@ -75,7 +75,10 @@ name:           Almace Scaffolding
 # Site description, will appear in the document meta and Atom feed subtitle
 description:    Almace Scaffolding - Super-fast Jekyll framework
 
-# Base URL, this is useful when I need to build site in a subdirectory (like GitHub Pages for Projects), it provides a specific URL prefix, for example, if the production site URL is http://sparanoid.com/lab/version/, set `base` to `/lab/version/24`, without trailing slash.
+# Base URL, this is useful when I need to build site in a subdirectory (like
+# GitHub Pages for Projects), it provides a specific URL prefix, for example, if
+# the production site URL is http://sparanoid.com/lab/version/, set `base` to
+# `/lab/version/24`, without trailing slash.
 # Default:      ""
 base:           ""
 
@@ -91,13 +94,20 @@ feed:           /feed.xml
 # Default:      https://pubsubhubbub.appspot.com/
 pshh:           https://pubsubhubbub.appspot.com/
 
-# Used in atom feed, sitemap, Twitter Cards, and etc. I should use absolute full URLs for these fields
+# Used in atom feed, sitemap, Twitter Cards, and etc. I should use absolute full
+# URLs for these fields
 url:            http://sparanoid.com
 
-# Media assets URL used in posts, without trailing slash. ie. `<img src="{{ site.file }}/image.png">`. In the most cases this URL should be powered by a CDN provider
+# Media assets URL used in posts, without trailing slash. ie.
+# `<img src="{{ site.file }}/image.png">`. In the most cases this URL should be
+# powered by a CDN provider
 file:           //d349cztnlupsuf.cloudfront.net
 
-# Download files URL used in posts, ie. href="{{ site.download }}/package.zip", this should also be a CDN link just like `site.file`. There're no notable differences in `site.file` and `site.download`, I just use the one for post images and the other for large download files. That's it. Remove or ignore this if you don't need it.
+# Download files URL used in posts, ie. href="{{ site.download }}/package.zip",
+# this should also be a CDN link just like `site.file`. There're no notable
+# differences in `site.file` and `site.download`, I just use the one for post
+# images and the other for large download files. That's it. Remove or ignore
+# this if you don't need it.
 download:       http://dl.sparanoid.com
 
 # Google Analytics tracking code
@@ -109,12 +119,13 @@ google_analytics:
 # Site Twitter account handle
 twitter:        sparanoid
 
-# Force UTF-8 encoding, enable this will simply add <meta charset="utf-8"> to the head of your pages
+# Force UTF-8 encoding, enable this will simply add <meta charset="utf-8"> to
+# the head of your pages
 # Default:      false
 force_utf_8:    false
 
-# Enable this settings to make your feed Daring Fireball-like link blog
-# (This basically change your <link> value to external link you defined in your posts)
+# Enable this settings to make your feed Daring Fireball-like link blog (This
+# basically change your <link> value to external link you defined in your posts)
 # Default:      false
 link_blog:      false
 

diff --git a/_config.yml b/_config.yml
@@ -45,6 +45,16 @@ kramdown:
   transliterated_header_ids: true
   footnote_backlink:         "&#8617;&#xfe0e;"
 
+redcarpet:
+  extensions:
+    - footnotes
+    - no_intra_emphasis
+    - smart
+    - space_after_headers
+    - strikethrough
+    - superscript
+    - tables
+
 #
 # Jekyll plugins
 #
@@ -65,7 +75,10 @@ name:           Almace Scaffolding
 # Site description, will appear in the document meta and Atom feed subtitle
 description:    Almace Scaffolding - Super-fast Jekyll framework
 
-# Base URL, this is useful when I need to build site in a subdirectory (like GitHub Pages for Projects), it provides a specific URL prefix, for example, if the production site URL is http://sparanoid.com/lab/version/, set `base` to `/lab/version/24`, without trailing slash.
+# Base URL, this is useful when I need to build site in a subdirectory (like
+# GitHub Pages for Projects), it provides a specific URL prefix, for example, if
+# the production site URL is http://sparanoid.com/lab/version/, set `base` to
+# `/lab/version/24`, without trailing slash.
 # Default:      ""
 base:           /lab/amsf
 
@@ -81,13 +94,20 @@ feed:           /feed.xml
 # Default:      https://pubsubhubbub.appspot.com/
 pshh:           https://pubsubhubbub.appspot.com/
 
-# Used in atom feed, sitemap, Twitter Cards, and etc. I should use absolute full URLs for these fields
+# Used in atom feed, sitemap, Twitter Cards, and etc. I should use absolute full
+# URLs for these fields
 url:            http://sparanoid.com
 
-# Media assets URL used in posts, without trailing slash. ie. `<img src="{{ site.file }}/image.png">`. In the most cases this URL should be powered by a CDN provider
+# Media assets URL used in posts, without trailing slash. ie.
+# `<img src="{{ site.file }}/image.png">`. In the most cases this URL should be
+# powered by a CDN provider
 file:           //d349cztnlupsuf.cloudfront.net
 
-# Download files URL used in posts, ie. href="{{ site.download }}/package.zip", this should also be a CDN link just like `site.file`. There're no notable differences in `site.file` and `site.download`, I just use the one for post images and the other for large download files. That's it. Remove or ignore this if you don't need it.
+# Download files URL used in posts, ie. href="{{ site.download }}/package.zip",
+# this should also be a CDN link just like `site.file`. There're no notable
+# differences in `site.file` and `site.download`, I just use the one for post
+# images and the other for large download files. That's it. Remove or ignore
+# this if you don't need it.
 download:       http://dl.sparanoid.com
 
 # Google Analytics tracking code
@@ -99,12 +119,13 @@ google_analytics:
 # Site Twitter account handle
 twitter:        sparanoid
 
-# Force UTF-8 encoding, enable this will simply add <meta charset="utf-8"> to the head of your pages
+# Force UTF-8 encoding, enable this will simply add <meta charset="utf-8"> to
+# the head of your pages
 # Default:      false
 force_utf_8:    false
 
-# Enable this settings to make your feed Daring Fireball-like link blog
-# (This basically change your <link> value to external link you defined in your posts)
+# Enable this settings to make your feed Daring Fireball-like link blog (This
+# basically change your <link> value to external link you defined in your posts)
 # Default:      false
 link_blog:      false
 
@@ -116,7 +137,7 @@ rss_excerpt:    false
 # Default:      true
 credits:        true
 
-# Items in robots.txt
+# Custom records in robots.txt
 # For example:
 # robots:
 #   - "User-agent: *"