1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
# Version 2 Major Changes
**Version 2 configuration is a major change from version 1.** Sections on the main page are now configured via multiple markdown files in the content directory **instead of** via frontmatter with raw HTML in one file.
# Grayscale Theme for Hugo
This is a multi-section single page theme intended as a landing page. This is derived from the startbootstrap-grayscale theme.
Preview at https://runningstream.github.io/hugograyscale/
## Usage
Drop it in your site's themes folder, then modify your site config file to specify the theme `grayscale`, or use the `-t grayscale` command line switch.
## Configuration and Content
The Hugo Grayscale theme is a one page theme designed to be the front page to your site. Its content is in sections with visual breaks between each. The content is contained in markdown files in the content folder, ordered by their `weight` parameter. The `exampleSite` directory is a good place to start. The page is designed to consist of, in order:
* a navbar at top linking to the other sections, and other arbitrary links
* an intro section presenting a header title and into text with background image
* an about section presenting a header and text with black background
* a download section presenting header and text with background image
* a contact section presenting header and text with black background
These section names correspond to the `title` front matter parameter, and the files are ordered by their `weight` front matter parameter. The section names show up as the links in the navbar.
The page's overall title, date, copyright and additional navbar links are specified in `content/_index.md`.
Because this theme generates only one page, it does not generate an RSS feed. The sitemap will only contain the home page.
The background images are selected by filename and placed in the "static/img/" directory for your site.
* The intro section, section 0, must have its image at `static/img/section0-bg.jpg`
* The download section, section 2, must have its image at `static/img/section2-bg.jpg`
These filenames are configured in `grayscale.css`.
Image aspect ratios used by the theme's default images are:
* 1.33333 for `section0-bg.jpg` - 1500x1125, for example
* 4.625 for `section2-bg.jpg` - 1500x324, for example
### Shortcodes
Shortcodes exist to support the "big buttons", including the demo site's download page button and social network buttons.
Big button shortcode example:
```
{{< big-button text="Visit Download Page" href="https://github.com/runningstream/hugograyscale/" >}}
```
Social network shortcode example:
```
{{% socialhandles %}}
{{< twitter user="stream_running" >}}
{{< github user="runningstream" >}}
{{% /socialhandles %}}
```
Check out the directory `exampleSite/content/` for a full-featured example.
|
