Skip to content

Commit

Permalink
feat: update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
nodejh committed Mar 1, 2021
1 parent 3c0b005 commit 82a3842
Show file tree
Hide file tree
Showing 7 changed files with 83 additions and 58 deletions.
81 changes: 80 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -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.
55 changes: 0 additions & 55 deletions config-example.yaml

This file was deleted.

5 changes: 3 additions & 2 deletions exampleSite/config.yaml
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
baseURL: https://example.com
languageCode: en-us
title: Hugo Themes
theme: mini
title: Hugo
theme: hugo-theme-mini
themesDir: ../../
googleAnalytics: your-google-analytics-id
hasCJKLanguage: true
permalinks:
Expand Down
Binary file removed images/archive.png
Binary file not shown.
Binary file modified images/screenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed images/tags.png
Binary file not shown.
Binary file modified images/tn.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 82a3842

Please sign in to comment.