From 6e05d099714e9825cc1328e934627cfa63f5f571 Mon Sep 17 00:00:00 2001
From: Luiz de Prá <rawarkanis@gmail.com>
Date: Mon, 09 Jul 2018 00:25:03 +0000
Subject: [PATCH] Improve README.md

---
 README.md |   65 +++++++++++++++++---------------
 1 files changed, 35 insertions(+), 30 deletions(-)

diff --git a/README.md b/README.md
index c52f839..545f1dd 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,8 @@
 baseurl = "http://www.example.com" # Hostname (and path) to the root.
 title = "johndoe" # Site title.
 theme = "coder" # Set the theme.
-languagecode = "en" # The site’s language code.
+languagecode = "en" # The site’s language code used to generate RSS.
+defaultcontentlanguage = "en" # The default content language.
 
 paginate = 20 # Default number of pages per page in pagination.
 canonifyurls = true # Enable to turn relative URLs into absolute.
@@ -33,7 +34,7 @@
 pygmentscodefences = true # Enable code fence background highlighting.
 pygmentscodefencesguesssyntax = true # Enable syntax guessing for code fences without specified language.
 
-disqusShortname = "yourdiscussshortname" # Enable or disable Disqus
+disqusShortname = "yourdiscussshortname" # Enable or disable Disqus.
 
 [params] # theme parameters
     author = "John Doe" # Author's name.
@@ -54,7 +55,7 @@
     # RTL support
     rtl = false
 
-    # Multilingualism
+    # Multilanguage mode
     langseparator = "|" # Separates menus from language selectors when site is multilingual.
 
 # Social links
@@ -82,28 +83,30 @@
     url = "/about/"
 ```
 
-To support multilingualism the configuration above needs to be extended by parameters for the specific languages.
+You can look at full working [`config.toml`](https://github.com/luizdepra/hugo-coder/blob/master/exampleSite/config.toml) inside the [exampleSite](https://github.com/luizdepra/hugo-coder/tree/master/exampleSite) folder.
+
+#### Multilingual mode
+
+To use multilingual mode, the configuration above needs to be extended by parameters for the specific languages.
 Each `language` section overrides default site's parameters when that language is chosen.
 
 ```toml
-DefaultContentLanguage = "en" # needs to match one of the language sections, add this at the main section of the configuration
-
-[params] # add this to theme params, do not duplicate tables
-    LangSeparator = "|" # separates menus from language selectors
-
+[params]
+    langseparator = "|" # separates menus from language selectors.
 
 [languages]
-
     [languages.en]
-    languagename = "English"
+        languagename = "English" # The language name to be displayed in the selector.
+        title = "John Doe"
 
+        # You can configure the theme parameter for each language. 
         [languages.en.params]
-        author = "John Doe" # Author's name.
-        info = "Full Stack DevOps and Magician" # Author's job title or info.
-        description = "John Doe's personal website" # Site description.
-        keywords = "blog,developer,personal" # Site keywords.
+        author = "John Doe"
+        info = "Full Stack DevOps and Magician"
+        description = "John Doe's personal website"
+        keywords = "blog,developer,personal"
 
-        [languages.en.menu]
+        [languages.en.menu] # It is possible to change the menu too.
 
         [[languages.en.menu.main]]
         name = "About"
@@ -121,12 +124,10 @@
         title = "John Doe po polsku"
 
         [languages.pl.params]
-        author = "John Doe"
-        languagecode = "pl"
-        description = "Strona domowa John'a Doe"
-        keywords = "blog,developer,strona domowa"
-        info = "Full Stack DevOps i Magik"
-        weight = 2.0
+            author = "John Doe"
+            description = "Strona domowa John'a Doe"
+            keywords = "blog,developer,strona domowa"
+            info = "Full Stack DevOps i Magik"
 
         [languages.pl.menu]
 
@@ -140,12 +141,17 @@
             weight = 2.0
             url = "/pl/posts/"
 
+
 ```
 
-You can look at full working [`config.toml`](https://github.com/luizdepra/hugo-coder/blob/master/exampleSite/config.toml) inside the [exampleSite](https://github.com/luizdepra/hugo-coder/tree/master/exampleSite) folder.
+It is possible to force Hugo to render all default language content under the language code with `defaultContentLanguageInSubdir = true`.
+In this case, remember to update your menus URLs (i.e. `/en/about/`).
 
 ### Build & Test
 
+It is necessary to have `less` and `uglifycss` installed to build and run the demo.
+Assuming that already have NodeJS/NPM installed, run `npm install -g less uglifycss`.
+
 To update or generate the minified CSS file:
 
 ```
@@ -157,21 +163,20 @@
 ```
 hugo server
 ```
+
 To preview the exampleSite, run
+
 ```
 make demo
 ```
- The above command copies current state of the theme to exampleSite/themes and starts hugo with hugo serve -D (Go does not support Symlink directories)
+
+The above command copies current state of the theme to exampleSite/themes and starts hugo with hugo serve -D (Go does not support Symlink directories)
 
 ### Disqus
-Add the following line to your config,
-```disqusShortname = "yourdiscussshortname"``` When this is set, all posts are disqus enabled   
-You can disable comments for a post by adding the following to your page meta data.
-```disable_comments: true```
 
+Add the following line to your config, ```disqusShortname = "yourdiscussshortname"``` When this is set, all posts are disqus enabled   
+You can disable comments for a post by adding the following to your page meta data: ```disable_comments: true```.
 
-## To Do
-- Tags, Categories and Series
 
 ## License
 

--
Gitblit v1.10.0