update docs and example config.toml

This commit is contained in:
invinciblycool 2021-05-02 14:21:10 +05:30
parent dbd85bc12c
commit 53f541796d
3 changed files with 55 additions and 31 deletions

View File

@ -15,19 +15,41 @@ Simple, text-focussed and minimal personal portfolio theme based on https://gith
## Installation ## Installation
cd into your hugo site's root directory and: ### Installing Hugo
```sh ```sh
cd themes # For Linux
git clone https://github.com/invinciblycool/lekh.git sudo apt-get install hugo
# For Mac
brew install hugo
# Detailed instructions at https://gohugo.io/getting-started/installing#readout
``` ```
For more information read the [official setup guide](https://gohugo.io/overview/installing/) of Hugo. ### Creating a new site
```sh
hugo new site <site_name>
```
### Adding lekh as a theme
```sh
cd <site_name>
git init
git submodule add https://github.com/ba11b0y/lekh.git themes/lekh
echo theme = \"lekh\" >> config.toml
```
Here's Hugo's [official guide](https://gohugo.io/getting-started/quick-start/) for more details.
## Personalization ## Personalization
To personalize the theme Hugo looks for a `config.toml` in the root of your site.
To personalize the theme, copy the default config shipped with the theme
`cp themes/lekh/exampleSite/config.toml config.toml` `cp themes/lekh/exampleSite/config.toml config.toml`
@ -37,29 +59,29 @@ Or simply copy the below config and customize accordingly.
```toml ```toml
baseURL = "http://rtiwari.me/" baseURL = "https://example.com/"
languageCode = "en-us" languageCode = "en-us"
title = "Rahul Tiwari" title = "Example Lekh Site"
theme = "lekh" theme = "lekh"
[params] [params]
Name = "" Name = "Agent Smith"
Email = "" Email = "agentsmith@thematrix.com"
Resume = "" # Add the filename with file extension. Resume = "" # Add the filename with file extension.
PostLimit = 4 # Sets the number of posts to display on the front page PostLimit = 4 # Sets the number of posts to display on the front page
GoatCounterCode = "" GoatCounterCode = ""
[[params.profiles]] [[params.profiles]]
name = "GitHub" name = "GitHub"
url = "" url = "https://github.com/ba11b0y"
[[params.profiles]] [[params.profiles]]
name = "Twitter" name = "Twitter"
url = "" url = "https://twitter.com/ba11b0y"
[[params.profiles]] [[params.profiles]]
name = "Goodreads" name = "Goodreads"
url = "" url = "https://www.goodreads.com/user/show/91520565-rahul-tiwari"
[[params.profiles]] [[params.profiles]]
name = "LinkedIn" name = "LinkedIn"
@ -67,20 +89,22 @@ url = ""
``` ```
## Posts ## Creating posts
Below is a typical post, which defaults to what Hugo expects. ```sh
# This creates a new draft post in content/posts
hugo new posts/title-of-post.md
```
Specify `draft: true` to avoid publishing the post. ## Serving it up
```md ```sh
--- # This will show up your draft posts as well.
title: "Rant post" hugo server -D
date: "2020-04-02" #OR
draft: true
---
Too much to rant :( #This will show up only your published posts.
hugo server
``` ```
## Credits ## Credits

View File

@ -1,26 +1,26 @@
baseURL = "http://rtiwari.me/" baseURL = "https://example.com/"
languageCode = "en-us" languageCode = "en-us"
title = "Rahul Tiwari" title = "Example Lekh Site"
theme = "lekh" theme = "lekh"
[params] [params]
Name = "" Name = "Agent Smith"
Email = "" Email = "agentsmith@thematrix.com"
Resume = "" # Add the filename with file extension. Resume = "" # Add the filename with file extension.
PostLimit = 4 # Sets the number of posts to display on the front page PostLimit = 4 # Sets the number of posts to display on the front page
GoatCounterCode = "" GoatCounterCode = ""
[[params.profiles]] [[params.profiles]]
name = "GitHub" name = "GitHub"
url = "" url = "https://github.com/ba11b0y"
[[params.profiles]] [[params.profiles]]
name = "Twitter" name = "Twitter"
url = "" url = "https://twitter.com/ba11b0y"
[[params.profiles]] [[params.profiles]]
name = "Goodreads" name = "Goodreads"
url = "" url = "https://www.goodreads.com/user/show/91520565-rahul-tiwari"
[[params.profiles]] [[params.profiles]]
name = "LinkedIn" name = "LinkedIn"

View File

@ -1,8 +1,8 @@
name = "Lekh" name = "Lekh"
license = "MIT" license = "MIT"
licenselink = "https://github.com/invinciblycool/lekh/blob/master/LICENSE.md" licenselink = "https://github.com/ba11b0y/lekh/blob/master/LICENSE.md"
description = "A text focussed and minimal personal portfolio theme with dark mode." description = "A text focussed and minimal personal portfolio theme with dark mode."
homepage = "https://github.com/invinciblycool/lekh" homepage = "https://github.com/ba11b0y/lekh"
tags = ["minimal", "clean", "blog", "responsive", "personal", "simple", "minimalist", "portfolio", "text-focussed", "dark", "dark-mode", "rss"] tags = ["minimal", "clean", "blog", "responsive", "personal", "simple", "minimalist", "portfolio", "text-focussed", "dark", "dark-mode", "rss"]
features = ["blog", "Clean and minimal", "Responsive", "Social media links", "Markdown", "Text focussed", "Dark mode", "RSS feeds"] features = ["blog", "Clean and minimal", "Responsive", "Social media links", "Markdown", "Text focussed", "Dark mode", "RSS feeds"]
min_version = "0.38" min_version = "0.38"