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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
# Slick
A Hugo theme focused on content, cleanliness, speed, responsiveness and privacy.
> Slick is a fork of [Temple](https://github.com/aos/temple) with many
improvements.
…
> Temple is a fork of [Nofancy](https://github.com/gizak/nofancy) with many
improvements.
## Table of Contents
* [Features](#features)
* [Installation](#installation)
* [Customizing](#customizing)
* [Components](#components)
* [Development](#development)
* [Contributing](#contributing)
* [License](#license)
* [Images](#images)
## Features
The main features of this theme include:
* Supports taxonomies of tags, categories and series with their own pages
* Pagination of content lists
* RSS Feed with complete entries
* [Open Graph](http://ogp.me),
[Schema.org](https://schema.org) and
[Twitter Cards](https://developer.twitter.com/en/docs/tweets/optimize-with-cards/overview/abouts-cards.html)
support
* Fully customizable menu entries in the header
* Footer with fully customizable links and RSS
* Customizable favicon (with correct mime type for png files)
and ability to inject own css file
* Relies on chroma for syntax highlighting
* Not even one external request (privacy!) - Everything needed is part of this
theme (Fonts, CSS, JS, ...)
* 404 page with customizable text
## Installation
Just download the theme or clone it into
your ``themes/`` directory:
```sh
cd themes && git clone https://github.com/spookey/slick.git
```
Then reference it in your ``config``:
```toml
theme = "slick"
```
Or when building the site, pass it in to the CLI:
```sh
hugo -t slick
```
To setup the 404 page please read the
[instructions](https://gohugo.io/templates/404/#automatic-loading).
## Customizing
Your ``config`` file will hold all your options.
Please have a look into the subfolders of ``_sites`` for working examples.
It is highly recommended to make some adjustments to the ``main``
and the ``footer`` menu (e.g. to link to your **About** page).
## Components
* [PureCSS](https://purecss.io/)
* [Source Code Pro](https://fonts.adobe.com/fonts/source-code-pro)
* [Source Sans Pro](https://fonts.adobe.com/fonts/source-sans-pro)
* [Source Serif Pro](https://fonts.adobe.com/fonts/source-serif-pro)
* [Tomorrow Theme](https://github.com/chriskempson/tomorrow-theme)
as color scheme (Tomorrow Night for syntax highlighting)
**Please Note**:
Files inside the [static] folder are only updated on tagged commits (releases).
## Development
This theme uses
[rollup.js](https://rollupjs.org) and [postCSS](https://postcss.org)
to bundle all files together.
JavaScript is compiled from [TypeScript](http://www.typescriptlang.org).
[Components](#components) are drawn in by [npm](https://www.npmjs.com).
Please have a look inside [package.json] for commands and tools required
for building.
Use ``npm version`` to tag a commit.
## Contributing
Contributions are welcome.
### Features
If you are adding a feature, fork the repository, create a new branch
for your feature and submit a PR.
Please make sure to put documentation for your new feature:
* Place a comment about what your feature is doing above the code.
* If making additions that will affect the ``config`` file, make sure
you update the [config.toml] and [config.yaml] below the ``_sites`` folder
as well as the [CHANGELOG.md].
### Issues/Bugs
Submit a new issue with information about your issue and/or bug. If you
have a solution, then submit a new PR with the guidelines posted above in the
**features** section and link your issue to it using the keyword
"[*closes*](https://help.github.com/articles/closing-issues-using-keywords/)".
## License
Licensed under the MIT License. See the [LICENSE].
## Images
### Screenshot
![Screenshot](https://raw.githubusercontent.com/spookey/slick/master/images/screenshot.png)
### Thumbnail
![Thumbnail](https://raw.githubusercontent.com/spookey/slick/master/images/tn.png)
[CHANGELOG.md]: https://github.com/spookey/slick/blob/master/CHANGELOG.md
[config.toml]: https://github.com/spookey/slick/blob/master/_sites/example/config.toml
[config.yaml]: https://github.com/spookey/slick/blob/master/_sites/changelog/config.yaml
[LICENSE]: https://github.com/spookey/slick/blob/master/LICENSE
[package.json]: https://github.com/spookey/slick/blob/master/package.json
[static]: https://github.com/spookey/slick/blob/master/static
|