blog/themes/beautifulhugo/exampleSite/content/post/2017-03-07-bigimg-sample.md
Wilfried OLLIVIER f5391008e6 Bootstrap \o/
2017-09-03 18:13:29 +02:00

1.7 KiB

title subtitle date tags bigimg
Big Image Sample Using Multiple Images 2017-03-07
example
bigimg
src desc
/img/triangle.jpg Triangle
src desc
/img/sphere.jpg Sphere
src desc
/img/hexagon.jpg 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.

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.