Re-work theme description and reflect current state.

5 files changed, 53 insertions, 15 deletions

diff --git a/README.md b/README.md
index 7c08ce3..4e71316 100644
--- a/README.md
+++ b/README.md
@@ -2,12 +2,11 @@
 
 This [Hugo](http://gohugo.io) theme is for documenting One-Day-Only (OneDly) projects. The theme renders a single page and is based on [Github project Page](https://themes.gohugo.io/github-project-landing-page/).
 
-
 # Demo
-A demo can be find here [...](https://github.com/cdeck3r/OneDly-Theme)
+A demo can be found here [...](https://github.com/cdeck3r/OneDly-Theme)
 
 # Screenshot
-![screenshot](...)
+![screenshot](https://github.com/cdeck3r/OneDly-Theme/blob/master/images/screenshot.png)
 
 # Notable Differences
 
@@ -16,11 +15,20 @@ A demo can be find here [...](https://github.com/cdeck3r/OneDly-Theme)
 * All posts on a single page as separated sections
 * Post ordering by sec parameter, instead of date
 
+
+# Quick Start
+
+1. install [Hugo](http://gohugo.io) 
+1. Create a new site: `hugo new site myproject`
+1. Change dir: `cd myproject`
+1. Add the OneDly theme: `git submodule add https://github.com/cdeck3r/OneDly-Theme.git themes/onedly`
+1. Start server: `hugo server -D -t onedly` 
+
 # Customization
 
-Check [config.toml](https://github.com/cdeck3r/OneDly-Theme/blob/master/exampleSite/config.toml) for available configuration. 
+Check [config.toml](https://github.com/cdeck3r/OneDly-Theme/blob/master/exampleSite/config.toml) for available configuration. Below is a description for each of them.
 
-Below is a description for each of them.
+### Project Specification Parameters
 
 The project name is specified as the title of the site.
 ```
@@ -30,15 +38,18 @@ title = "OneDly Project"
 The project description follows in the `params` section.
 ```
 [params]
-    description = "Amazing project."
+    description = "One-Day-Only (OneDly) project documentation."
 ```
 
-Other variables are
-`author_name` the project author's name.
-`author_url` link to the personal website of the project author.
-`project_url` link to project url, e.g. the project's github repo 
+Other variables within the `[params]` section are 
+
+* `author_name` the project author's name.
+* `author_url` link to the personal website of the project author.
+* `project_url` link to project url, e.g. the project's github repo 
 
-**Note:** `description` and `author_name` are put into the site's meta data for author and the site description.
+**Note:** `description` and `author_name` are used as the site's meta data for author and description within the html header.
+
+Examples
 
 ```
     author_name = "cdeck3r"
@@ -46,7 +57,33 @@ Other variables are
     project_url = "//github.com/cdeck3r/OneDly-Theme"
 ```
 
-Theme colors
+### Section Ordering
+
+The project documentation may consists of several files indicating different sections. All files need to be placed in `myproject\content\post` directory. 
+
+One may create a new section using `hugo new post/about.md`. It is recommended to start with an About section. In the file's front matter specify 
+
+```
++++
+title = "About"
+date = "2019-02-28"
+sec = 1
++++
+```
+
+The `sec` variable defines the position on the site. `sec = 1` lets the About section appear at the beginning right below the description and social media links. In the next section, created by the command above, you may specify a larger number, e.g. `sec = 4`. This positions this new section after the About section and before a section with `sec = 5` or larger. If you do not specify a `sec` variable ordering falls back to default ordering by the date sourced from the front matter. Information on ordering are found in [Hugo's documentation](https://gohugo.io/templates/lists/#default-weight-date-linktitle-filepath).
+
+
+### Social media
+
+A user may specify links to well-known social media sites shown at the top of the page. In `config.toml` the section `[social]` lists the supported social media links. If the variable in this section specifies the user's account name, the corresponding button linking to the social media site will appear on the page.
+
+The exampleSite's [config.toml](https://github.com/cdeck3r/OneDly-Theme/blob/master/exampleSite/config.toml) for examples.
+
+### Theme colors
+
+Standard theme colors are 
+
 ```    
     first_color="#f8f8f8"
     first_border_color="#e7e7e7"
diff --git a/exampleSite/config.toml b/exampleSite/config.toml
index ea5f683..d11352d 100644
--- a/exampleSite/config.toml
+++ b/exampleSite/config.toml
@@ -5,9 +5,9 @@ theme = "onedly"
 
 [params]
     description = "One-Day-Only (OneDly) project documentation."
-    author_url = "http://cdeck3r.com"
+    author_url = "//cdeck3r.com"
     author_name = "cdeck3r"
-    project_url = "https://github.com/cdeck3r/OneDly-Theme"
+    project_url = "//github.com/cdeck3r/OneDly-Theme"
     github_project_name = "OneDly"
     github_user_name = "cdeck3r"
 
diff --git a/images/screenshot.png b/images/screenshot.png
index 1e9c7c1..e62731f 100644
--- a/images/screenshot.png
+++ b/images/screenshot.png
diff --git a/images/tn.png b/images/tn.png
index 317b358..8139e24 100644
--- a/images/tn.png
+++ b/images/tn.png
diff --git a/theme.toml b/theme.toml
index 6dbfde4..e5709d0 100644
--- a/theme.toml
+++ b/theme.toml
@@ -1,7 +1,7 @@
 name = "OneDly Project"
 license = "MIT"
 licenselink = "https://github.com/cdeck3r/OneDly-Theme/blob/master/LICENSE.md"
-description = "Theme for documenting OneDly project."
+description = "Theme for documenting One-Day-Only (OneDly) projects."
 homepage = "https://github.com/cdeck3r/OneDly-Theme"
 tags = ["documentation", "landing page", "opensource"]
 features = ["github", "images" ]
@@ -10,6 +10,7 @@ min_version= 0.1
 [author]
      name = "Christian Decker"
 
+# If porting an existing theme
 [original]
     author =  "Omar Abdelhafith"
     homepage = "https://github.com/nsomar/github-project-landing-page"