blob: 9d3d397bbf76a31b45d61a3ab972502607a148dd (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
# Kite
A fast, minimal static site generator written in Go. Transform Markdown files into beautiful, themed websites with zero dependencies at runtime.
<p>
<img src="https://img.shields.io/badge/version-1.0.0-blue.svg" alt="Version">
<img src="https://img.shields.io/badge/Go-1.25+-00ADD8.svg" alt="Go Version">
</p>
## Installation
```bash
go install github.com/HimanshuSardana/kite@latest
```
## Usage
### Initialize a New Blog
```bash
kite init
```
This interactive command walks you through:
- Blog name and site title
- Author information
- Theme selection
- Creates `content/`, `output/`, `themes/` directories
- Generates config and a sample post
### Build Your Site
```bash
kite build
```
Or specify a theme:
```bash
kite build gruvbox
```
### Preview Locally
```bash
kite serve
```
Visit `http://localhost:8000` to see your site.
## Commands
| Command | Description |
|---------|-------------|
| `kite init` | Initialize a new blog project |
| `kite build` | Build the static site |
| `kite build <theme>` | Build with a specific theme |
| `kite serve` | Start local development server |
| `kite serve --port 8080` | Serve on custom port |
| `kite list-themes` | Show available themes |
## Configuration
Edit `config.yaml` to customize your site:
```yaml
siteTitle: "Your Blog Name"
authorName: "Your Name"
authorRole: "Writer & Developer"
authorBio: "A short bio about yourself"
defaultTheme: "modern-light"
siteUrl: "https://your-domain.com"
```
## Themes
Kite comes with 9 built-in themes:
- modern-light
- modern-dark
- modern-dark-2
- modern-dark-catppuccin
- everforest
- gruvbox
- rose-pine
- terminal-gruvbox
- tufte
|
