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

github.com/zerostaticthemes/hugo-serif-theme.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobert Austin <rob@jugglerdigital.com>2019-07-23 08:57:58 +0300
committerRobert Austin <rob@jugglerdigital.com>2019-07-23 08:57:58 +0300
commitb05fd11ae96b5ad6a329a903d5cab39ff081aa30 (patch)
tree11f2f21a16ca30f7190266a7a3db4e35af45b187 /README.md
parent07775f205fff500c959b3388a64387f02332d9b4 (diff)
revise blue theme, better image config, logo config, mobile menu
Diffstat (limited to 'README.md')
-rw-r--r--README.md109
1 files changed, 86 insertions, 23 deletions
diff --git a/README.md b/README.md
index 29b7155..9a0ee0d 100644
--- a/README.md
+++ b/README.md
@@ -1,65 +1,128 @@
# Hugo Serif Theme
-Serif is a beautiful small business theme for Hugo (Static Site Generator). It contains content types for the archetypical small business website. The theme is fully responsive, blazing fast and artfully illustrated.
+Serif is a modern business theme for Hugo. It contains content types for the archetypical business website. The theme is fully responsive, blazing fast and artfully illustrated.
-[Live Demo](https://hugo-serif.netlify.com/)
+[Live Demo](https://hugo-serif.netlify.com/) |
+[Zerostatic Themes](https://www.zerostatic.io/theme/hugo-serif/)
![Hugo Serif Theme screenshot](https://github.com/JugglerX/hugo-serif-theme/blob/master/images/screenshot-with-border.png)
## Theme features
-- Services (Content Type)
-- Team (Content Type)
+### Content Types
+
+- Services (Markdown)
+- Team (Markdown)
- Features (Data)
+
+### CSS
+
- SCSS (Hugo Pipelines)
- Responsive design
-- Bootstrap 4 grid and media queries only
-- Responsive menu managed in `config.toml`
+- Bootstrap 4.3 grid and media queries only
+
+### Speed
+
- 100/100 Google Lighthouse speed score
- Under 30KB without images or 80KB with images and illustrations ⚡
+- No jQuery, only a tiny bit of vanilla Javascript for the mobile menu.
+
+### SEO
+
+- Google analytics configured in `config.toml`
+- Configure GID using env variable HUGO_GOOGLE_ANALYTICS_ID, compatible with Netlify.
+- Configure meta tags and OG meta tags for the homepage in `config.toml`
+- Override any meta tags on a per page basis
+- Semantic document structure
+- Accessible colors, headings and link text
+
+### Menu
+
+- Responsive menu managed in `config.toml`
+
+### Content
+
- Robust example content included
- Royalty free illustrations included
- Set `body` classes on a per template basis
-- Inject javascript files on a per page basis (see services/single.html)
+
+### Templating
+
- Plenty of examples of using `range` and `where` to loop over various content types
-- Google analytics configured in `config.toml`
+- Examples of injecting javascript files on a per page basis (see services/single.html)
+
+# Installation
+
+To use this theme you will need to have Hugo installed. If you don't already have Hugo installed please follow the official [installation guide](https://gohugo.io/getting-started/installing/)
-## Installation
+### Check Hugo version (Hugo 0.51+ Extended is required)
-Inside the folder of your Hugo site run:
+This theme uses [Hugo Pipes](https://gohugo.io/hugo-pipes/scss-sass/) to compile SCSS and minify assets. Please make sure you have the **Hugo Extended** version installed. If you are not using the extended version this theme will not not compile.
+
+To check your version of Hugo, run:
+
+```
+hugo version
+```
+
+This will output the currently installed version of Hugo. Make sure you see `/extended` after the version number, for example `Hugo Static Site Generator v0.51/extended darwin/amd64 BuildDate: unknown` You do not need to use version v0.51 specifically, you can use any version of Hugo above 0.51. It just needs to have the `/extended` part
+
+### Create a new Hugo site
+
+```
+hugo new site mynewsite
+```
+
+This will create a fresh Hugo site in the folder `mynewsite`.
+
+### Install theme
+
+Copy or git clone this theme into the sites themes folder `mynewsite/themes`
+
+#### Install with Git
```
-cd themes
-git clone https://github.com/jugglerx/hugo-serif-theme.git
+cd mynewsite
+git clone https://github.com/jugglerx/hugo-serif-theme.git themes/hugo-serif-theme
```
-For more information read the official [setup guide](//gohugo.io/overview/installing/) of Hugo.
+#### Install from .zip file
-## Getting started
+You can download the .zip file located here https://github.com/JugglerX/hugo-serif-theme/archive/master.zip.
-After installing the Serif theme successfully it requires a just a few more steps to get your site finally running.
+Extract the downloaded .zip inside the `themes` folder. Rename the extracted folder from `hugo-serif-theme-master` -> `hugo-serif-theme`. You should end up with the following folder structure `mynewsite/themes/hugo-serif-theme`
-### Adding example content
+### Add example content
-The fastest way to get started is to copy the example content. Copy the contents of the `exampleSite` folder to the root folder of your Hugo site. This theme comes with content for the following content types: `services`, `team`, `testimonials` and includes JSON data for `features` and `contact`. It also includes the `config.toml` file which has an example menu.
+Copy the entire contents of the `mynewsite/themes/hugo-serif-theme/exampleSite/` folder to root folder of your Hugo site, ie `mynewsite/`
-### Edit config
+To copy the files using terminal, make sure you are still in the projects root, ie the `mynewsite` folder.
-After you copy the `config.toml` into the root folder of your Hugo site you will need to update the `baseURL`
+```
+cp -a themes/hugo-whisper-theme/exampleSite/. .
+```
+
+### Update config.toml
+
+After you copy the `config.toml` into the root folder of your Hugo site you will need to update the `baseURL`, `themesDir` and `theme` values in `mynewsite/config.toml`
```
baseURL = "/"
+themesDir = "themes"
+theme = "hugo-serif-theme"
```
-## Running Hugo
+### Run Hugo
+
+After installing the theme for the first time, generate the Hugo site.
-After installing the theme, generate the Hugo site.
+You run this command from the root folder of your Hugo site ie `mynewsite/`
```
hugo
```
-Hugo's built-in local server.
+For local development run Hugo's built-in local server.
```
hugo server
@@ -108,4 +171,4 @@ You can set meta tags on a per template basis using a block. For example, you mi
## Credits
-- Illustrations by https://absurd.design/
+- Beautiful royalty free Illustrations by https://undraw.co/