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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
# Tale
This is a port of the [Tale theme for Jekyll](https://github.com/chesterhow/tale) to Hugo. Tale is a minimal Jekyll theme curated for storytellers. Checkout the demo [here](https://chesterhow.github.io/tale/). I did not design this theme; I only ported it from Jekyll to Hugo.
## Installation
### 1. Install the theme
If your site is also under version control using git, the easiest way to install this theme is to add it as a submodule. If you have not created a git repo for your project yet, you need to run `git init` beforehand. Inside the folder of your Hugo site, run the following command.
```
git submodule add https://github.com/EmielH/tale-hugo.git themes/tale
```
Alternatively, you can clone the theme into your project.
```
git clone https://github.com/EmielH/tale-hugo.git themes/tale
```
### 2. Configure Hugo
Add the following line to `config.toml` to tell Hugo to use the theme.
```
theme = "tale"
```
Alternatively, you can tell Hugo to use the theme with the `server` command.
```
hugo server -t tale
```
### Additional information
For more information, read the official [setup guide](https//gohugo.io/overview/installing/) of Hugo.
### Update the theme
If you have installed the theme as a git submodule, you can update the theme by issuing the following command inside your project folder.
```
git submodule update --remote --rebase
```
If you have cloned the theme, you can run `git pull` inside the theme folder.
## Configuration
### Internationalisation (i18n)
Tale supports using other languages than English. Language files for the texts Tale uses are provided in the `i18n` directory. The default language is English. To switch languages, add the key `defaultContentLanguage` to your `config.toml` file. For example:
```
defaultContentLanguage = "nl"
```
To translate texts your site uses, add an `i18n` folder to your site.
Feel free to submit pull requests for other translations of Tale's texts.
[Hugo documentation for multilingual sites](//gohugo.io/content-management/multilingual/)
### Custom summaries
Tale allows for writing the summary of your posts manually by setting the `summary` variable in the page frontmatter. If this variable is not set, the summary that Hugo automatically generates will be used.
## Acknowledgments
Thanks
- to [Chester How](//github.com/chesterhow) for creating the original [Tale theme for Jekyll](https://chesterhow.github.io/tale/),
- to [onedrawingperday](//github.com/onedrawingperday), [bep](//github.com/bep) and [digitalcraftsman](//github.com/digitalcraftsman) for their help in getting the theme working correctly with Hugo,
- to [lucperkins](https://github.com/lucperkins) for the [Fresh theme](https://github.com/lucperkins/hugo-fresh) from which I used some useful snippets of code.
## License
See [LICENSE](https://github.com/EmielH/tale-hugo/blob/master/LICENSE).
|
