54 lines
1.3 KiB
Markdown
54 lines
1.3 KiB
Markdown
# Quiet's Blog
|
|
|
|
A personal blog built with Markdown content and a Python build script that generates static HTML.
|
|
|
|
## Writing Posts
|
|
|
|
Create a `.md` file with YAML frontmatter in the appropriate `content/` subdirectory:
|
|
|
|
```markdown
|
|
---
|
|
title: "My Post Title"
|
|
date: 2026-02-15
|
|
description: "A short summary of the post"
|
|
---
|
|
|
|
Post content in Markdown here...
|
|
```
|
|
|
|
### Post Categories
|
|
|
|
| Category | Directory | Filename Convention | Example |
|
|
|----------|-----------|-------------------|---------|
|
|
| Regular | `content/posts/` | Any slug | `content/posts/my-topic.md` |
|
|
| Daily | `content/daily/` | `YYYY-MM-DD.md` | `content/daily/2026-02-15.md` |
|
|
| Weekly | `content/weekly/` | `YYYY-WNN.md` | `content/weekly/2026-W07.md` |
|
|
|
|
## Building
|
|
|
|
Requires [uv](https://docs.astral.sh/uv/):
|
|
|
|
```sh
|
|
uv run build.py
|
|
```
|
|
|
|
Output goes to `dist/`. Serve it with any static file server:
|
|
|
|
```sh
|
|
python3 -m http.server -d dist
|
|
```
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
content/ # Markdown source files
|
|
posts/ # Regular posts
|
|
daily/ # Daily posts
|
|
weekly/ # Weekly posts
|
|
about.md # About page
|
|
templates/ # HTML templates with {{placeholder}} variables
|
|
static/ # Static assets (CSS)
|
|
build.py # Build script (dependencies declared inline via PEP 723)
|
|
dist/ # Generated output (gitignored)
|
|
```
|