Skip to content

Commit 5f5429c

Browse files
committed
update docs and example config.toml
1 parent 1b445a0 commit 5f5429c

File tree

3 files changed

+55
-31
lines changed

3 files changed

+55
-31
lines changed

README.md

+46-22
Original file line numberDiff line numberDiff line change
@@ -15,19 +15,41 @@ Simple, text-focussed and minimal personal portfolio theme based on https://gith
1515

1616
## Installation
1717

18-
cd into your hugo site's root directory and:
18+
### Installing Hugo
1919

2020
```sh
21-
cd themes
22-
git clone https://github.com/invinciblycool/lekh.git
21+
# For Linux
22+
sudo apt-get install hugo
23+
24+
# For Mac
25+
brew install hugo
26+
27+
# Detailed instructions at https://gohugo.io/getting-started/installing#readout
2328
```
2429

25-
For more information read the [official setup guide](https://gohugo.io/overview/installing/) of Hugo.
30+
### Creating a new site
31+
32+
```sh
33+
hugo new site <site_name>
34+
```
35+
36+
### Adding lekh as a theme
37+
38+
```sh
39+
cd <site_name>
40+
git init
41+
git submodule add https://github.com/ba11b0y/lekh.git themes/lekh
42+
echo theme = \"lekh\" >> config.toml
43+
44+
```
45+
46+
Here's Hugo's [official guide](https://gohugo.io/getting-started/quick-start/) for more details.
2647

2748

2849
## Personalization
2950

30-
To personalize the theme
51+
Hugo looks for a `config.toml` in the root of your site.
52+
To personalize the theme, copy the default config shipped with the theme
3153

3254
`cp themes/lekh/exampleSite/config.toml config.toml`
3355

@@ -37,50 +59,52 @@ Or simply copy the below config and customize accordingly.
3759

3860
```toml
3961

40-
baseURL = "http://rtiwari.me/"
62+
baseURL = "https://example.com/"
4163
languageCode = "en-us"
42-
title = "Rahul Tiwari"
64+
title = "Example Lekh Site"
4365
theme = "lekh"
4466

4567
[params]
46-
Name = ""
47-
Email = ""
68+
Name = "Agent Smith"
69+
4870
Resume = "" # Add the filename with file extension.
4971
PostLimit = 4 # Sets the number of posts to display on the front page
5072
GoatCounterCode = ""
5173

5274
[[params.profiles]]
5375
name = "GitHub"
54-
url = ""
76+
url = "https://github.com/ba11b0y"
5577

5678
[[params.profiles]]
5779
name = "Twitter"
58-
url = ""
80+
url = "https://twitter.com/ba11b0y"
5981

6082
[[params.profiles]]
6183
name = "Goodreads"
62-
url = ""
84+
url = "https://www.goodreads.com/user/show/91520565-rahul-tiwari"
6385

6486
[[params.profiles]]
6587
name = "LinkedIn"
6688
url = ""
6789

6890
```
6991

70-
## Posts
92+
## Creating posts
7193

72-
Below is a typical post, which defaults to what Hugo expects.
94+
```sh
95+
# This creates a new draft post in content/posts
96+
hugo new posts/title-of-post.md
97+
```
7398

74-
Specify `draft: true` to avoid publishing the post.
99+
## Serving it up
75100

76-
```md
77-
---
78-
title: "Rant post"
79-
date: "2020-04-02"
80-
draft: true
81-
---
101+
```sh
102+
# This will show up your draft posts as well.
103+
hugo server -D
104+
#OR
82105

83-
Too much to rant :(
106+
#This will show up only your published posts.
107+
hugo server
84108
```
85109

86110
## Credits

exampleSite/config.toml

+7-7
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
1-
baseURL = "http://rtiwari.me/"
1+
baseURL = "https://example.com/"
22
languageCode = "en-us"
3-
title = "Rahul Tiwari"
3+
title = "Example Lekh Site"
44
theme = "lekh"
55

66
[params]
7-
Name = ""
8-
Email = ""
7+
Name = "Agent Smith"
8+
99
Resume = "" # Add the filename with file extension.
1010
PostLimit = 4 # Sets the number of posts to display on the front page
1111
GoatCounterCode = ""
1212

1313
[[params.profiles]]
1414
name = "GitHub"
15-
url = ""
15+
url = "https://github.com/ba11b0y"
1616

1717
[[params.profiles]]
1818
name = "Twitter"
19-
url = ""
19+
url = "https://twitter.com/ba11b0y"
2020

2121
[[params.profiles]]
2222
name = "Goodreads"
23-
url = ""
23+
url = "https://www.goodreads.com/user/show/91520565-rahul-tiwari"
2424

2525
[[params.profiles]]
2626
name = "LinkedIn"

theme.toml

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

0 commit comments

Comments
 (0)