about summary refs log tree commit diff
path: root/README.md
blob: 5d188920f548ab737cb2afa714c2ef2ca741c251 (plain) (blame)
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
# Victor theme

> To my surprise, no one has created a Hugo theme called Victor
> 
> -- me, at some point

Hugo theme, using [readable.css][readable] for ease of reading.

[readable]: https://readable-css.freedomtowrite.org/

## Usage

### Adding theme

If you use git for managing your content, adding it as a submodule is
straightforward:

```sh
git submodule add https://git.sr.ht/~huyngo/victor themes/victor
```

Then add it in the config:

```toml
theme = 'victor'
```

### Use for blog

You should add `blog` to the list of categories of the section to get
reverse-chronological feed.  RSS feed is currently not tested.

### Use for book

You should add `book` to the list of categories for every section of the book
to get recursive table of content and breadcrumb navigation. Bread crumb is
generated from the current page up to the furthest ancestor section that is a
book, so you have to add that for *every* section of the book.  If your site
consists of only book, you can set a theme-specific parameter to note that:

```toml
[params]
OnlyBooks = true
```

RSS feed is currently not tested.

## Licenses

This theme is released under MIT license.  Full license text can be found in
`LICENSES/MIT.txt`.

The theme uses CSS style from [readable.css][readable], written by Freedom to
Write project and licensed under 0BSD license.