add welcome page

Author: geraldb

README.md

@@ -1,7 +1,11 @@
-# jekyll-minimal-theme
+# What's `jekyll-minimal-theme`?
 
+It's another minimal(istic) Jekyll static site generator theme,
+that is, a ready-to-fork template pack.
 
-Another minimial Jekyll theme  - [Live Demo @ `feedreader.github.io/jekyll-minimal-theme` »](http://feedreader.github.io/jekyll-minimal-theme/)
+See a live demo @ [`feedreader.github.io/jekyll-minimal-theme` »](http://feedreader.github.io/jekyll-minimal-theme/)
+
+For example:
 
 ```
 ├── _config.yml                               # site configuration

_posts/2015-01-31-welcome.md

@@ -0,0 +1,56 @@
+---
+layout: post
+title: "Welcome to jekyll-minimal-theme - Another Minimal Jekyll Theme"
+---
+
+What's `jekyll-minimal-theme`?
+
+It's another minimal(istic) Jekyll static site generator theme,
+that is, a ready-to-fork template pack. For example:
+
+~~~
+├── _config.yml                               # site configuration
+├── _posts                                    # sample blog posts
+|   ├── 2014-05-05-sportdb-update-v192.md     #   filename format:
+|   ├── 2014-10-10-new-repo-baviria-bayern.md #    => YEAR-MONTH-DAY-TITLE.MARKUP
+|   ├── 2014-10-21-sql-views.md
+|   ├── 2014-11-11-new-reop-maps.md
+|   └── 2014-12-15-quick-starter-datafiles.md
+├── _layouts                           
+|   ├── default.html                   # master layout template
+|   └── post.html                      # single blog post template
+├── css                               
+|   ├── _settings.scss                 # style settings (e.g. variables)
+|   └── style.scss                     # master style page
+├── feed.xml                           # web feed template (e.g. in atom format)
+├── archive.html                       # archive template
+└── index.html                         # index template
+~~~
+
+will result in (with `permalink: /:title.html`):
+
+~~~
+└── _site                                # output build folder; site gets generated here
+    ├── css
+    |   └── style.css                    # styles for pages (copied 1:1 as is)
+    ├── sportdb-update-v192.html         # blog post page
+    ├── new-repo-baviria-bayern.html     # another blog post page
+    ├── sql-views.html                   #  ""
+    ├── new-repo-maps.html               #  ""
+    ├── quick-starter-datafiles.html     #  ""
+    ├── feed.xml                         # web feed (e.g. in atom format)
+    ├── archive.html                     # archive page
+    └── index.html                       # index page
+~~~
+
+To use - delete all sample posts in the `_posts` folder and
+change the settings in `_config.yml` to use your own `site.title`
+and `site.url`:
+
+~~~
+title:   'Jekyll Minimal Theme'
+url:     'http://feedreader.github.io/jekyll-minimal-theme'
+author:
+  name:  'Jekyll Minimal Theme Team'
+~~~
+