Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/nodejh/hugo-theme-cactus-plus.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authornodejh <jianghangscu@gmail.com>2021-03-01 19:52:15 +0300
committernodejh <jianghangscu@gmail.com>2021-03-01 19:52:15 +0300
commit82a3842d3145555030676fff09617bb39056f212 (patch)
tree7eebe5d45919a77028edc626dd30c13b9ee99508 /README.md
parent3c0b005454e727735c1103a95d8e8bbd125a89c3 (diff)
feat: update docs
Diffstat (limited to 'README.md')
-rw-r--r--README.md81
1 files changed, 80 insertions, 1 deletions
diff --git a/README.md b/README.md
index b37f6c2..5e27bdc 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,80 @@
-## WIP \ No newline at end of file
+# 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. \ No newline at end of file