Merge remote-tracking branch 'refs/remotes/halogenica/master'

# Conflicts:
#	layouts/index.html

exampleSite/config.toml

@@ -2,6 +2,7 @@ baseurl = "https://username.github.io"
 languageCode = "en-us"
 title = "Beautiful Hugo"
 theme = "beautifulhugo"
+metaDataFormat = "yaml"
 pygmentsUseClasses = true
 pygmentCodeFences = true
 #disqusShortname = "XXX"
@@ -16,6 +17,16 @@ pygmentCodeFences = true
   rss = true
   comments = true
 
+#[[Params.bigimg]]
+#  src = "img/triangle.jpg"
+#  desc = "Triangle"
+#[[Params.bigimg]]
+#  src = "img/sphere.jpg"
+#  desc = "Sphere"
+#[[Params.bigimg]]
+#  src = "img/hexagon.jpg"
+#  desc = "Hexagon"
+
 [Author]
   name = "Some Person"
   email = "youremail@domain.com"
@@ -50,22 +61,22 @@ pygmentCodeFences = true
     name = "Samples"
     weight = 2
 
+[[menu.main]]
+    parent = "samples"
+    name = "Big Image Sample"
+    url = "/post/2017-03-07-bigimg-sample"
+    weight = 1
+
 [[menu.main]]
     parent = "samples"
     name = "Math Sample"
     url = "/post/2017-03-05-math-sample"
-    weight = 1
+    weight = 2
 
 [[menu.main]]
     parent = "samples"
     name = "Code Sample"
     url = "/post/2016-03-08-code-sample"
-    weight = 2
-
-[[menu.main]]
-    parent = "samples"
-    name = "Test Markdown"
-    url = "/post/2015-02-20-test-markdown"
     weight = 3
 
 [[menu.main]]

exampleSite/content/post/2015-02-26-flake-it-till-you-make-it.md

@@ -2,7 +2,7 @@
 title: Flake it till you make it
 subtitle: Excerpt from Soulshaping by Jeff Brown
 date: 2015-02-26
-bigimg: /img/path.jpg
+bigimg: [{src: "/img/path.jpg", desc: "Path"}]
 ---
 
 Under what circumstances should we step off a path? When is it essential that we finish what we start? If I bought a bag of peanuts and had an allergic reaction, no one would fault me if I threw it out. If I ended a relationship with a woman who hit me, no one would say that I had a commitment problem. But if I walk away from a seemingly secure route because my soul has other ideas, I am a flake?  

exampleSite/content/post/2017-03-07-bigimg-sample.md

@@ -0,0 +1,40 @@
+---
+title: Big Image Sample
+subtitle: Using Multiple Images
+date: 2017-03-07
+tags: ["example", "bigimg"]
+bigimg: [{src: "/img/triangle.jpg", desc: "Triangle"}, {src: "/img/sphere.jpg", desc: "Sphere"}, {src: "/img/hexagon.jpg", desc: "Hexagon"}]
+---
+
+The image banners at the top of the page are refered to as "bigimg" in this theme. They are optional, and one more more can be specified. If more than one is specified, the images rotate every 10 seconds. In the front matter, bigimgs are specified using an array of hashes.
+
+<!--more-->
+
+A single bigimg can be specified in the front matter by the following YAML:
+```
+bigimg: [{src: "/img/triangle.jpg", desc: "Triangle"}]
+```
+
+Multiple bigimgs can be specified in the front matter by the following YAML:
+```
+bigimg: [{src: "/img/triangle.jpg", desc: "Triangle"}, 
+         {src: "/img/sphere.jpg", desc: "Sphere"}, 
+         {src: "/img/hexagon.jpg", desc: "Hexagon"}]
+```
+
+Also note that the description field is optional, and images could instead be specified by:
+```
+bigimg: [{src: "/img/triangle.jpg"}, 
+         {src: "/img/sphere.jpg"}, 
+         {src: "/img/hexagon.jpg"}]
+```
+
+The above YAML array of hashes were written in "flow" style. However when generating a new page or post with `hugo new post/mypost.md`, hugo may interpret the archetype for bigimg in the default YAML style. Defining multiple bigimg's complete with descriptions in this style would be specified by:
+```
+bigimg: 
+- {src: "/img/triangle.jpg", desc: "Triangle"}
+- {src: "/img/sphere.jpg", desc: "Sphere"}
+- {src: "/img/hexagon.jpg", desc: "Hexagon"}
+```
+
+Additional information can be found [in this YAML tutorial](https://rhnh.net/2011/01/31/yaml-tutorial/).