jekyll-theme-low 1.0.1 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +180 -52
- data/_layouts/home.html +1 -1
- data/lib/low/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 3aea22681c895bd8b8107a7095fd740b82463bf39f23fdbca0bfab5a0c9b86b5
|
|
4
|
+
data.tar.gz: 3899265938c1fe60ba0a8b062a125cfd026dac8af30f2fab0868eb8c317c2646
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: a10835290d900633298faf1a7625eca34fa7e5648a248cab7fdfb4ff99dae130589d55d98a58832563f0322c8bc222065f3c063039b9f448f4089ed86b658d38
|
|
7
|
+
data.tar.gz: 3137aacc6539e9da31729bdcec8270739a1186d69efffa36cd324a63e82a97bead935c13f1b8d7cc986b5e3ce5da27b2ef95ff61eb38e7ec7c224f67b5b0dd94
|
data/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# low
|
|
2
2
|
|
|
3
|
-

|
|
4
4
|
|
|
5
5
|
> A minimal, retro-inspired Jekyll theme for engineers who care about the metal.
|
|
6
6
|
|
|
7
|
-
**low** is a lightweight Jekyll theme designed for technical blogging — inspired by [Fabien Sanglard
|
|
8
|
-
It
|
|
7
|
+
**low** is a lightweight Jekyll theme designed for technical blogging — inspired by [Fabien Sanglard's website](https://fabiensanglard.net/).
|
|
8
|
+
It's meant for developers who write about *low-level programming, graphics, operating systems, emulation, and the craft of software*.
|
|
9
9
|
|
|
10
10
|
No JavaScript frameworks. No build pipelines. Just clean HTML, monospace typography, and focus on content.
|
|
11
11
|
|
|
@@ -13,82 +13,210 @@ No JavaScript frameworks. No build pipelines. Just clean HTML, monospace typogra
|
|
|
13
13
|
|
|
14
14
|
## ✳ Features
|
|
15
15
|
|
|
16
|
-
- ⚙️ **Zero-dependency design** — pure HTML + CSS, no JavaScript
|
|
17
|
-
- 💾 **Retro technical aesthetic** — monospaced typography and print-like layout
|
|
18
|
-
- 🧱 **Simple structure** — easily fork, modify, or embed in existing Jekyll setups
|
|
19
|
-
- 📰 **RSS + SEO ready** — via `jekyll-feed`, `jekyll-seo-tag`, and `jekyll-sitemap
|
|
20
|
-
- 🗓️ **Archive view** — grouped by year, auto-generated from posts
|
|
21
|
-
- 🖋️ **Clean code blocks** — styled for low-level and C-style syntax
|
|
22
|
-
- 🪶 **Compact footer** — © year + author, nothing more
|
|
16
|
+
- ⚙️ **Zero-dependency design** — pure HTML + CSS, no JavaScript
|
|
17
|
+
- 💾 **Retro technical aesthetic** — monospaced typography and print-like layout
|
|
18
|
+
- 🧱 **Simple structure** — easily fork, modify, or embed in existing Jekyll setups
|
|
19
|
+
- 📰 **RSS + SEO ready** — via `jekyll-feed`, `jekyll-seo-tag`, and `jekyll-sitemap`
|
|
20
|
+
- 🗓️ **Archive view** — grouped by year, auto-generated from posts
|
|
21
|
+
- 🖋️ **Clean code blocks** — styled for low-level and C-style syntax
|
|
22
|
+
- 🪶 **Compact footer** — © year + author, nothing more
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## ⚡ Installation
|
|
27
|
+
|
|
28
|
+
### Option 1: Add to Existing Site
|
|
29
|
+
|
|
30
|
+
Add this line to your Jekyll site's `Gemfile`:
|
|
31
|
+
|
|
32
|
+
```ruby
|
|
33
|
+
gem "jekyll-theme-low"
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
And add this line to your `_config.yml`:
|
|
37
|
+
|
|
38
|
+
```yaml
|
|
39
|
+
theme: jekyll-theme-low
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Then execute:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
bundle install
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### Option 2: Create New Site
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
jekyll new my-blog
|
|
52
|
+
cd my-blog
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Edit `Gemfile` and add:
|
|
56
|
+
|
|
57
|
+
```ruby
|
|
58
|
+
gem "jekyll-theme-low"
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Edit `_config.yml` and add:
|
|
62
|
+
|
|
63
|
+
```yaml
|
|
64
|
+
theme: jekyll-theme-low
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Then run:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
bundle install
|
|
71
|
+
bundle exec jekyll serve
|
|
72
|
+
```
|
|
23
73
|
|
|
24
74
|
---
|
|
25
75
|
|
|
26
76
|
## 🧩 Directory Structure
|
|
27
77
|
|
|
28
|
-
```
|
|
78
|
+
```
|
|
29
79
|
low/
|
|
30
80
|
├── _layouts/
|
|
31
|
-
│
|
|
32
|
-
│
|
|
33
|
-
│
|
|
34
|
-
│
|
|
81
|
+
│ ├── default.html # Base layout (includes header/footer)
|
|
82
|
+
│ ├── home.html # Main index page
|
|
83
|
+
│ ├── post.html # Individual post layout
|
|
84
|
+
│ └── archive.html # Yearly archive page
|
|
35
85
|
│
|
|
36
86
|
├── _includes/
|
|
37
|
-
│
|
|
38
|
-
│
|
|
39
|
-
│
|
|
40
|
-
│
|
|
41
|
-
│
|
|
87
|
+
│ ├── head.html # Metadata + styles
|
|
88
|
+
│ ├── header.html # Top navigation bar
|
|
89
|
+
│ ├── footer.html # Minimal one-liner footer
|
|
90
|
+
│ ├── post-list.html # Reusable post index
|
|
91
|
+
│ └── post-meta.html # Date + tags for posts
|
|
42
92
|
│
|
|
43
93
|
├── assets/
|
|
44
|
-
│
|
|
45
|
-
│
|
|
94
|
+
│ └── css/
|
|
95
|
+
│ └── main.scss # Global theme styles
|
|
46
96
|
│
|
|
47
97
|
├── _sass/
|
|
48
|
-
│
|
|
49
|
-
│
|
|
98
|
+
│ └── theme/
|
|
99
|
+
│ └── _syntax.scss # Rouge syntax highlighting
|
|
50
100
|
│
|
|
51
|
-
└── low.gemspec
|
|
101
|
+
└── low.gemspec # Jekyll theme definition
|
|
52
102
|
```
|
|
53
103
|
|
|
54
|
-
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 🧭 Example Site
|
|
55
107
|
|
|
56
|
-
|
|
108
|
+
The theme ships with an `example/` directory that demonstrates:
|
|
57
109
|
|
|
58
|
-
|
|
59
|
-
|
|
110
|
+
- Index page listing posts under "Articles"
|
|
111
|
+
- `/archive/` for yearly grouping
|
|
112
|
+
- `/rss.xml` for feed readers
|
|
113
|
+
|
|
114
|
+
Run it locally:
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
cd example
|
|
118
|
+
bundle install
|
|
119
|
+
bundle exec jekyll serve
|
|
60
120
|
```
|
|
61
121
|
|
|
62
|
-
|
|
122
|
+
Then open: http://127.0.0.1:4000
|
|
63
123
|
|
|
64
|
-
|
|
124
|
+
---
|
|
65
125
|
|
|
66
|
-
|
|
67
|
-
- Respect simplicity.
|
|
68
|
-
- Prefer text over tools.
|
|
126
|
+
## 🎨 Customization
|
|
69
127
|
|
|
70
|
-
|
|
71
|
-
- retro-game rendering,
|
|
72
|
-
- CPU emulation,
|
|
73
|
-
- assembly or C,
|
|
74
|
-
- framebuffer graphics,
|
|
75
|
-
- or OS development logs.
|
|
128
|
+
### Basic Configuration
|
|
76
129
|
|
|
77
|
-
|
|
78
|
-
The theme ships with an `example/` site that demonstrates:
|
|
79
|
-
- index listing posts under Articles,
|
|
80
|
-
- /archive/ for yearly grouping,
|
|
81
|
-
- /rss.xml for feed readers.
|
|
130
|
+
Edit your `_config.yml`:
|
|
82
131
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
132
|
+
```yaml
|
|
133
|
+
title: Your Site Title
|
|
134
|
+
author: Your Name
|
|
135
|
+
description: A technical blog about low-level programming
|
|
136
|
+
url: "https://yourdomain.com"
|
|
137
|
+
|
|
138
|
+
# Plugins
|
|
139
|
+
plugins:
|
|
140
|
+
- jekyll-feed
|
|
141
|
+
- jekyll-seo-tag
|
|
142
|
+
- jekyll-sitemap
|
|
87
143
|
```
|
|
88
144
|
|
|
89
|
-
|
|
145
|
+
### Creating Posts
|
|
146
|
+
|
|
147
|
+
Create a file in `_posts/` directory:
|
|
148
|
+
|
|
149
|
+
```markdown
|
|
150
|
+
---
|
|
151
|
+
layout: post
|
|
152
|
+
title: "My First Post"
|
|
153
|
+
date: 2025-11-05
|
|
154
|
+
categories: programming
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
Your content here...
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
### Adding Pages
|
|
161
|
+
|
|
162
|
+
Create pages in the root directory:
|
|
163
|
+
|
|
164
|
+
```markdown
|
|
165
|
+
---
|
|
166
|
+
layout: default
|
|
167
|
+
title: About
|
|
168
|
+
permalink: /about/
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
About me...
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
## 🧠 Philosophy
|
|
177
|
+
|
|
178
|
+
This theme follows the same principles as the projects it's meant to host:
|
|
179
|
+
|
|
180
|
+
- Understand what runs under the hood
|
|
181
|
+
- Respect simplicity
|
|
182
|
+
- Prefer text over tools
|
|
183
|
+
|
|
184
|
+
It's ideal for developers writing deep dives into:
|
|
185
|
+
|
|
186
|
+
- Retro-game rendering
|
|
187
|
+
- CPU emulation
|
|
188
|
+
- Assembly or C programming
|
|
189
|
+
- Framebuffer graphics
|
|
190
|
+
- OS development logs
|
|
191
|
+
|
|
192
|
+
---
|
|
90
193
|
|
|
91
194
|
## 🪞 Credit
|
|
92
195
|
|
|
93
|
-
Heavily inspired by the aesthetic and minimalism of
|
|
94
|
-
|
|
196
|
+
Heavily inspired by the aesthetic and minimalism of [Fabien Sanglard](https://fabiensanglard.net/).
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
## 📄 License
|
|
201
|
+
|
|
202
|
+
The theme is available as open source under the terms of the [MIT License](LICENSE).
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## 🤝 Contributing
|
|
207
|
+
|
|
208
|
+
Bug reports and pull requests are welcome on GitHub at https://github.com/[username]/jekyll-theme-low
|
|
209
|
+
|
|
210
|
+
---
|
|
211
|
+
|
|
212
|
+
## 📮 Support
|
|
213
|
+
|
|
214
|
+
If you encounter any issues or have questions:
|
|
215
|
+
|
|
216
|
+
1. Check the [example site](./example/) for reference
|
|
217
|
+
2. Open an issue on GitHub
|
|
218
|
+
3. Read the [Jekyll documentation](https://jekyllrb.com/docs/)
|
|
219
|
+
|
|
220
|
+
---
|
|
221
|
+
|
|
222
|
+
**Made with ❤️ for the low-level community**
|
data/_layouts/home.html
CHANGED
data/lib/low/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: jekyll-theme-low
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.0.
|
|
4
|
+
version: 1.0.2
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Levent Kaya
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2025-11-
|
|
11
|
+
date: 2025-11-22 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: jekyll
|