feat: update docs
parent
3c0b005454
commit
82a3842d31
@ -1 +1,80 @@
|
||||
## WIP
|
||||
# Hugo Theme Mini
|
||||
|
||||
A fast, minimalist and responsive hugo theme.
|
||||
|
||||
![./images/screenshot.png](./images/screenshot.png)
|
||||
|
||||
|
||||
- [Online demo](nodejh.github.io/hugo-theme-mini)
|
||||
- [Example Site](exampleSite)
|
||||
|
||||
Features:
|
||||
|
||||
- Fast
|
||||
- Minimalist
|
||||
- Responsive
|
||||
- Archive
|
||||
- Tags
|
||||
|
||||
|
||||
## Installation
|
||||
|
||||
|
||||
### As a Hugo Module (recommended)
|
||||
|
||||
> ⚠️ If you installed a [Hugo binary](https://gohugo.io/getting-started/installing/#binary-cross-platform), you may not have Go installed on your machine. To check if Go is installed:
|
||||
> ```
|
||||
> $ go version
|
||||
> ```
|
||||
> Go modules were considered production ready in v1.14. [Download Go](https://golang.org/dl/).
|
||||
|
||||
1. From your project's root directory, initiate the hugo module system if you haven't already:
|
||||
|
||||
```
|
||||
$ hugo mod init github.com/<your_user>/<your_project>
|
||||
```
|
||||
|
||||
2. Add the theme's repo to your `config.yaml`:
|
||||
|
||||
```yaml
|
||||
theme:
|
||||
- github.com/nodejh/gohugo-theme-mini
|
||||
```
|
||||
|
||||
### As Git Submodule
|
||||
|
||||
Inside the folder of your Hugo site run:
|
||||
|
||||
```
|
||||
$ git submodule add https://github.com/nodejh/gohugo-theme-mini.git themes/mini
|
||||
```
|
||||
For more information read the official [setup guide](//gohugo.io/overview/installing/) of Hugo.
|
||||
|
||||
|
||||
|
||||
## Getting started
|
||||
|
||||
After installing the theme successfully it requires a just a few more steps to get your site running.
|
||||
|
||||
|
||||
### The config file
|
||||
|
||||
Take a look inside the [`exampleSite`](https://github.com/nodejh/gohugo-theme-mini/tree/master/exampleSite) folder of this theme. You'll find a file called [`config.yaml`](https://github.com/nodejh/gohugo-theme-mini/blob/master/exampleSite/config.yaml). To use it, copy the [`config.yaml`](https://github.com/nodejh/gohugo-theme-mini/blob/master/exampleSite/config.yaml) in the root folder of your Hugo site. Feel free to change the strings in this theme.
|
||||
|
||||
You may need to delete the line: `themesDir: ../../`
|
||||
|
||||
|
||||
### Logo and favicon
|
||||
|
||||
You can replace the log in the top of each page and favicon with your own images. To do that replace `static/images/avatar.png` and `static/images/favicon.ico` .
|
||||
|
||||
|
||||
### Nearly finished
|
||||
|
||||
In order to see your site in action, run Hugo's built-in local server.
|
||||
|
||||
```sh
|
||||
$ hugo server
|
||||
```
|
||||
|
||||
Now enter localhost:1313 in the address bar of your browser.
|
@ -1,55 +0,0 @@
|
||||
baseURL: https://gohugo.io
|
||||
languageCode: en-us
|
||||
title: Hugo Themes
|
||||
theme: mini
|
||||
googleAnalytics: your-google-analytics-id
|
||||
hasCJKLanguage: true
|
||||
permalinks:
|
||||
posts: /posts/:title/
|
||||
|
||||
disqusShortname: your-disqus-shorname
|
||||
|
||||
# Hugo Configure Markup
|
||||
# see: https://gohugo.io/getting-started/configuration-markup#highlight
|
||||
markup:
|
||||
highlight:
|
||||
guessSyntax: true
|
||||
style: emacs
|
||||
|
||||
|
||||
# Social links in footer, support github,twitter,stackoverflow,facebook
|
||||
social:
|
||||
# e.g.
|
||||
github: 'your-github-link'
|
||||
twitter: 'your-github-link'
|
||||
stackoverflow: 'your-github-link'
|
||||
# facebook: 'your-facebook-link'
|
||||
|
||||
|
||||
# Site parameters
|
||||
params:
|
||||
# Site Author
|
||||
author: Author
|
||||
# Author biography
|
||||
bio: Software Engineer
|
||||
# Site Description, used in HTML meat
|
||||
description: My Blog
|
||||
enableRSS: true
|
||||
|
||||
# Optional
|
||||
home: '' # Default: Home
|
||||
about: '' # Default: About
|
||||
archive: '' # Default: Archive
|
||||
subscribe: '' # Default: Subscribe
|
||||
olderPosts: '' # Default: Older Posts
|
||||
newerPosts: '' # Default: Newer Posts
|
||||
copyright: ''
|
||||
title404: '' # Default: 404 - Page Not Found
|
||||
subtitle404: '' # Default: The content you're looking for doesn't seem to exist.
|
||||
readMore: '' # Default: Read More
|
||||
|
||||
# Extra links in navigation
|
||||
links:
|
||||
# e.g.
|
||||
# - name: Project
|
||||
# path: /project
|
Binary file not shown.
Before Width: | Height: | Size: 5.7 MiB |
Binary file not shown.
Before Width: | Height: | Size: 5.7 MiB After Width: | Height: | Size: 166 KiB |
Binary file not shown.
Before Width: | Height: | Size: 5.7 MiB |
Binary file not shown.
Before Width: | Height: | Size: 2.1 MiB After Width: | Height: | Size: 82 KiB |
Loading…
Reference in New Issue