This commit is contained in:
Joe Hutchinson
2018-12-18 16:30:26 -05:00
2 changed files with 17 additions and 6 deletions

View File

@@ -8,7 +8,7 @@ Aether is a Hugo theme for blogs that emphasizes motion, depth, and material as
- Looks good on any screen using responsive web design
- Highlight.js integration provides beautiful syntax highlighting for most programming languages and file formats
![Aether Hugo theme screenshot](images/screenshot.png)
![Aether Hugo theme screenshot](https://raw.githubusercontent.com/josephhutch/aether/master/images/screenshot.png?_sm_au_=iVVVRRW7D405F0fN)
## Installation
In your Hugo project's theme directory, clone the Aether repo.
@@ -37,7 +37,8 @@ bgimg = "URL to the image used for the page background - optional"
### Creating content
Make a new post by executing `hugo new post/postnamehere.md` in your shell. Open the new file, update the front matter, and start writing! Below you can find what the front matter should contain for a new post and what each of the parameters mean.
```
```yaml
---
title: "The title of your post"
date: date the post was generated
description: "Description of the post (displayed in the post's card)"
@@ -46,12 +47,23 @@ featuredImage: "URL to the page's featured image, used as the card image and the
displayInMenu: whether you would like the post to show up in the navigation menu (true, false)
displayInList: whether you would like the post to be listed on the home page and category pages (true, false)
draft: if the page is a draft (true, false)
---
```
Posts typically would have displayInMenu set to false so that the post is not a menu option, and displayInList set to true so it shows up on the homepage's list of posts and in category page lists. An About Me page or a Contact page, on the other hand, would want displayInMenu set to true and displayInList set to false. That will allow the About Me page or Contact page to be accessable from the menu but not displayed in the homepage's list of posts.
Adding an interesting description and a good image to each post is a great way to get the most value out of this theme.
### Further Customization
To change the heading and subtext at the top of list pages just add a \_index.md file in the folder that the list page is generated from. For example to change the heading at the top of the homepage, add an \_index.md file to the content folder with the following parameters.
```yaml
---
title: "This is the main heading text in big letters"
date: the date
description: "This is the subtext above the main heading in small letters"
---
```
## Helpful Links
[Hugo Documentation](https://gohugo.io/documentation/) - Learn how to use Hugo and format content files

View File

@@ -1,7 +1,6 @@
baseurl = "https://gohugo.io/"
baseurl = "http://example.org"
title = "Hugo Themes - aether"
author = "Steve Francia"
copyright = "Copyright © 20082018, Steve Francia and the Hugo Authors; all rights reserved."
author = "Joe Hutchinson"
canonifyurls = true
paginate = 3
theme = "aether"
@@ -9,4 +8,4 @@ theme = "aether"
[params]
brand = "aether"
description = "aether Hugo theme for blogs"
bgimg = "/img/ignasi_pattern_s.png"
bgimg = "/img/ignasi_pattern_s.png"