Welcome to Lonetrail

What’s inside#

• Static by default — Astro ships plain HTML; almost nothing to wait for
• Bilingual — Chinese at /, English at /en/, the language switch keeps your place
• Essays — short notes and images, kept apart from long-form posts
• No-refresh navigation — Swup handles transitions between pages
• Full-text search — Pagefind index generated at build time, no backend
• Series — group articles into multi-part reads
• Tags & categories — archive pages generated from content
• Dark mode — follow the system or toggle manually
• RSS / Atom / Sitemap — emitted at build time, including per-locale variants
• Code highlighting — Expressive Code with line numbers, folding and copy
• Math & diagrams — KaTeX and Mermaid

Quick start#

1
git clone https://github.com/ChongxiSama/Lonetrail.git my-blog
2
cd my-blog
3
pnpm install
4
pnpm dev
5
pnpm build

Directory layout#

1
src/
2
├── content/        # Content
3
│   ├── posts/      # Posts
4
│   ├── essays/     # Essays
5
│   ├── seri/       # Series
6
│   └── spec/       # Standalone pages
7
├── components/     # Components
8
├── layouts/        # Layouts
9
├── pages/          # Routes
10
├── styles/         # Styles
11
├── config.ts       # Feature flags and integrations
12
└── site.yml        # Site metadata

Writing a post#

Drop a Markdown file into src/content/posts/ with frontmatter:

1
---
2
title: "Post title"
3
published: 2026-01-15
4
description: "One-line summary"
5
tags: ["tag-one", "tag-two"]
6
category: "技术"
7
---

For an English translation, add a sibling file with an .en suffix such as welcome.en.md; it is served at /en/posts/welcome/.

See “Configuring Lonetrail” for the full configuration reference.