blob: 517b905fc39f81740f6d2a7e68aa380704a792bd (
plain)
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
|
# Yuki [![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/iCyris/hugo-theme-yuki/blob/master/LICENSE)
❄️ Hugo theme yuki. She is as pure as the snow.
![Screenshot](https://raw.githubusercontent.com/iCyris/hugo-theme-yuki/master/images/screenshot.png)
## Features
* Responsive
* Syntax highlighting with highlightjs
* Social links(Customize)
* Custom Pages
* Support for Related Content
* Support for tags
* Google Analytics
* SCSS
## Table of Contents
* [Quick Start](#quick-start)
* [Usage](#usage)
* [Development](#development)
* [License](#license)
## Quick Start
In your hugo site directory, run:
```shell
$ mkdir themes
$ cd themes
$ git clone https://github.com/iCyris/hugo-theme-yuki
```
## Usage
Use hugo's -t hugo-theme-yuki or --theme=hugo-theme-yuki option with hugo commands.
e.g.
```shell
$ hugo server -t hugo-theme-yuki
```
### Configuration
Please see the sample [`config.toml`](https://github.com/iCyris/hugo-theme-yuki/tree/master/exampleSite/config.toml).
### Creating Posts
Posts should generally go under a `content/post` directory. Typically you would run:
````sh
hugo new post/your-new-post.md
````
For posts to appear on your site, you may need `draft = false` in the post's front matter or use the `--buildDrafts` option when building.
### Creating Custom Pages
Custom pages such as an About page should preferably go under `content/pages` or be present at the root of the `content` directory.
````sh
hugo new pages/about.md
````
## Development
If you're contributing CSS changes, there are two ways:
1. Simply make changes on `/static/scss/custom.css`, the style will be overwrited.
2. Use [SASS](https://sass-lang.com/). Directly make changes on the `*.scss` files and recompile `style.scss` or `highlight.scss`.
## License
Licensed under the MIT License. See the [LICENSE](https://github.com/iCyris/hugo-theme-yuki/blob/master/LICENSE) file for more details.
|