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

github.com/spech66/bootstrap-bp-hugo-theme.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSebastian Pech <windows@spech.de>2019-09-14 16:47:21 +0300
committerSebastian Pech <windows@spech.de>2019-09-14 16:47:21 +0300
commit04bb0561711f4b4c9bb663d647206a12dea55561 (patch)
treec4cf6324ac35502cdb4c59b0d21d5b4cecc83dff
parent347f50e26701d8958068487a227821241f392c68 (diff)
update readme
-rw-r--r--README.md38
1 files changed, 35 insertions, 3 deletions
diff --git a/README.md b/README.md
index 7292e08..33c1c50 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,15 @@
+
# Bootstrap-BP hugo theme
[Bootstrap v4](https://getbootstrap.com/) based Hugo theme which provides out of the box best practices like performance and SEO readiness. Featured images will be resized automatically. This is based on the [Hugo docs](https://gohugo.io/templates/homepage/), [hugo-best-practices](https://github.com/spech66/hugo-best-practices), [Front-End Checklist](https://github.com/thedaviddias/Front-End-Checklist) and the [Front-End Performance Checklist](https://github.com/thedaviddias/Front-End-Performance-Checklist). Contains four different color themes.
+<!-- START doctoc -->
+<!-- END doctoc -->
+
+## Features
+
+* x
+
## Install the theme
With Git installed, run the following commands inside the Hugo site folder. If Hugo has not yet been installed, read the setup guide [here](https://gohugo.io/overview/installing/).
@@ -14,9 +22,27 @@ git clone https://github.com/spech66/bootstrap-bp-hugo-theme.git
You can get a zip of the latest version of the theme from the [home page](https://github.com/spech66/bootstrap-bp-hugo-theme) and extract it to the themes folder.
-## Theme settings
+
+## Update the theme
+
+Go to the themes folder as in the installation and run the following command.
+
+```sh
+git pull
+```
+
+## Run example site
+
+Go to the `exampleSite` folder from the theme `themes/cupper-hugo-theme/exampleSite` and run the following command.
+
+```sh
+hugo server --themesDir ../..
+```
+
+## Configuration and theme specific settings
Most settings should be done with hugo specific variables. There are only a few (optional) additional `[params]`.
+Use the `config.toml` from the `exampleSite` subdirectory as base.
* `startPageColumns = true` will show the start page in a Masonry-like mode.
* `customDateFormat = "02.01.2006"` to override the date format.
@@ -26,13 +52,19 @@ Most settings should be done with hugo specific variables. There are only a few
* `themeColor` set to dark, light, blue (do not set for bootstrap default).
* `hideReadingTime` to hide reading time.
+## Screenshots of cofigurations
+
+`startPageColumns = false`
+
![startPageColumns = false](https://raw.githubusercontent.com/spech66/bootstrap-bp-hugo-theme/master/images/tn.png)
+`startPageColumns = true`
+
![startPageColumns = true](https://raw.githubusercontent.com/spech66/bootstrap-bp-hugo-theme/master/images/tn2.png)
## Google Analytics
-This theme uses the internal asynchronous template for Google Analytics tracking. You only have to provide your tracking id in your configuration file:
+This theme uses the internal asynchronous template for Google Analytics tracking. You only have to provide your tracking id in your configuration file.
```yaml
googleAnalytics = "UA-123-45"
@@ -40,7 +72,7 @@ googleAnalytics = "UA-123-45"
## Page templates / archetypes
-This theme has support for the following archetypes:
+This theme has support for the following archetypes. Based on the specified types the layout and functionality of a page is slightly changed.
* Page (not on the startpage)
* Post (regular post/blog pages)