Improved organziation of _config.yml

_config.yml

@@ -1,38 +1,43 @@
-# Required configuration
+# ----------------------- #
-source: source
+#      Main Configs       #
-destination: public
+# ----------------------- #
-plugins: plugins
-code_dir: downloads/code
-port: 4000
 
 url: http://yoursite.com
 title: My Octopress Blog
-permalink: /blog/:year/:month/:day/:title
 subtitle: A blogging framework for hackers.
 author: Your Name
+simple_search: http://google.com/search
 
 # RSS / Email (optional) subscription links (change if using something like Feedburner)
 subscribe_rss: /atom.xml
 subscribe_email:
-
+# RSS feeds can list your email address if you like
-markdown: rdiscount
+email:
-pygments: true
-paginate: 10
-recent_posts: 5
-category_dir: blog/categories
-simple_search: http://google.com/search
 
 # ----------------------- #
-# Optional configurations #
+#    Jekyll & Plugins     #
 # ----------------------- #
 
-# If publishing to a subdirectory as in http://site.com/project set this:
+# If publishing to a subdirectory as in http://site.com/project set 'root: /project'
-# root: /project
+# If blank, urls will be mapped to '/'
-# If left blank, urls will be mapped to '/'
 root:
 
-# RSS feeds can list your email address if you like
+port: 4000
-email:
+permalink: /blog/:year/:month/:day/:title
+source: source
+destination: public
+plugins: plugins
+code_dir: downloads/code
+category_dir: blog/categories
+markdown: rdiscount
+pygments: true
+
+paginate: 10 # Posts per page on the blog index
+recent_posts: 5 # Posts in the sidebar Recent Posts section
+
+# ----------------------- #
+#   3rd Party Settings    #
+# ----------------------- #
 
 # Twitter
 twitter_user: imathis