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

github.com/vividvilla/ezhil.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorVivek R <vividvilla@gmail.com>2019-04-20 11:42:20 +0300
committerVivek R <vividvilla@gmail.com>2019-04-20 11:42:20 +0300
commit6c755e82dfe09c24198a49a88f692b2a29146ab3 (patch)
tree9e534d17bed4d45670dd68d9443aa02ccb5e4230
parent6b00ac4d91413ed0d50a988e9fdd976646a56f8f (diff)
chore: update READMEv1.0.0-beta.1
-rw-r--r--README.md118
1 files changed, 118 insertions, 0 deletions
diff --git a/README.md b/README.md
index ae4cd9f..8a9289d 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,120 @@
# Ezhil
Clean and minimal personal blog and portfolio theme for Hugo.
+
+# Features
+* Clean and minimal
+* Supports tags
+* Social media links
+* Google Analytics integration
+* Syntax highlighting
+* Twitter cards and opengraph tags support
+* Disqus comments
+* Hugo RSS feeds
+
+# Installation
+From your Hugo site run the following.
+
+```sh
+cd themes
+git clone https://github.com/vividvilla/ezhil.git
+```
+
+For more information read the [official setup guide](https://gohugo.io/overview/installing/) of Hugo.
+
+# Configuration
+```toml
+baseURL = "http://example.org/"
+languageCode = "en-us"
+title = "My personal blog"
+theme = "ezhil"
+
+# Enable syntax highlighting.
+pygmentsstyle = "vs"
+pygmentscodefences = true
+pygmentscodefencesguesssyntax = true
+
+# Your Google analytics code.
+googleAnalytics = "UA-123-45"
+# Your Disqus sortname.
+disqusShortname = "localhost"
+
+[params]
+ # Blog subtitle which appears below blog title. Supports markdown.
+ subtitle = "Clean and minimal personal [blog theme for Hugo](https://github.com/vividvilla/ezhil)"
+ # Number of posts to show in recent posts list (Optional). Defaults to 10.
+ recentPostsCount = 10
+ # Content types which are excluded from recent posts and archive page (Optional). Defaults to ["page"]
+ excludedTypes = ["page"]
+ # Content types which are excludes Disqus comments (Optional). Defaults to ["page"]
+ disableDisqusTypes = ["page"]
+ # If social media links are enabled then enable this to fetch icons from CDN instead of hosted on your site.
+ featherIconsCDN = true
+
+# Main menu which appears below site header.
+[[menu.main]]
+name = "Home"
+url = "/"
+weight = 1
+
+[[menu.main]]
+name = "All posts"
+url = "/posts"
+weight = 2
+
+[[menu.main]]
+name = "About"
+url = "/about"
+weight = 3
+
+[[menu.main]]
+name = "Tags"
+url = "/tags"
+weight = 4
+
+# Social media links which shows up on site header.
+# Uses feather icons for icons. You can [search icon names from here](https://feathericons.com/).
+[[params.social]]
+name = "Github"
+icon = "github"
+url = "https://github.com/vividvilla/ezhil"
+
+[[params.social]]
+name = "Twitter"
+icon = "twitter"
+url = "https://twitter.com/gohugoio"
+
+# Enable tags.
+[taxonomies]
+ tag = "tags"
+```
+
+# Content type
+You can specify content type with field `type` in your content. For example static pages can be set as type `page` which are excluded from recent posts and all posts page. You can use site params `excludedTypes` and `disableDisqusTypes` to control which page types are excluded from recent posts and Disqus comments respectively.
+
+```
+---
+title: "About"
+date: 2019-04-19T21:37:58+05:30
+type: "page"
+---
+
+This is some static page where you can write about yourself.
+```
+
+# Disable Disqus
+You can disable Disqus from contents selectively or for all contents with certain content type. Use content field `disqus` to disable Disqus from certain contents.
+
+```
+---
+title: "Content without comments"
+date: 2019-04-19T21:37:58+05:30
+disqus: false
+---
+
+This is a content without Disqus comments.
+```
+
+You can also disable Disqus for certain content types by using site param `disableDisqusTypes`. You can check config section above for example.
+
+# Credits
+* [Feather Icons](https://feathericons.com/)