src/config.ts reads site.yml and exports siteConfig / navBarConfig / profileConfig, so components never touch the raw YAML.

site.yml

site:
  title: "Lonetrail"
  title_en: "Lonetrail"
  subtitle: "循此苦旅 直抵群星"
  subtitle_en: "Ad Astra Per Aspera"
  description: "一个关于代码、安全与网络的个人笔记本。"
  description_en: "A personal notebook on code, security and the web."
  url: "https://lonetrail.pages.dev"
  lang: "zh_CN"
  author: "Lonetrail"
  email: "i@chongxi.us"
  favicon: "/images/favicon.webp"
  banner: "/images/banner.webp"
  og_image: "/images/og.webp"
  avatar: "/images/avatar.webp"

Bilingual fields come in pairs. The English site reads *_en and falls back to the default value when it is empty.

url also drives site and the image allow-list in astro.config.mjs, so changing the domain is a one-line edit.

Navigation

Nav entries reference built-in labels by key, so they translate automatically:

nav:
  - key: home
    url: "/"
  - key: archive
    url: "/archive/"
  - key: series
    url: "/seri/"
  - key: essays
    url: "/essays/"
  - key: about
    url: "/about/"

Available keys: home, archive, series, essays, about, subscribe. Custom links use name instead:

nav:
  - name: "Notes"
    url: "/notes/"

Taxonomy labels

Translated labels are display-only — URLs and filters keep the canonical name:

taxonomy:
  tags:
    "技术": "Technology"
  categories:
    "技术": "Technology"

config.ts

export const localeConfig = {
	defaultLocale: "zh",
	locales: ["zh", "en"],
	translatedPaths: ["/", "/archive/", "/about/", "/subscribe/", "/essays/"],
};

export const featureConfig = {
	comments: true,
	search: true,
	analytics: "none",
};

export const integrationConfig = {
	twikoo: { envId: "" },
	umami: { websiteId: "", domains: "" },
};

• translatedPaths — pages that have a real English version; every other /en/ route is a fallback of the Chinese page and is marked noindex
• featureConfig.comments — turn off to drop the comment section
• featureConfig.search — turn off to skip mounting the search panel
• featureConfig.analytics — set to "umami" and fill umami.websiteId to load the script
• integrationConfig.twikoo.envId — leave empty to skip comments entirely

Post frontmatter

---
title: "Post title"
published: 2026-01-15
updated: 2026-02-01
description: "One-line summary"
tags: ["tag-one", "tag-two"]
category: "技术"
draft: false
pinned: false
noindex: false
---

• draft: true — skipped in production builds
• pinned: true — pinned to the top of the first home page
• noindex: true — kept out of listings and sitemaps

Looking Up

Two things fill the mind with ever new and increasing admiration and awe — the starry heavens above me and the moral law within me.
— Immanuel Kant

When Kant wrote these words, humanity did not yet know that galaxies existed beyond the Milky Way, nor that the universe was expanding. Yet his reverence for the night sky remains as vivid today as it was two centuries ago.

Exploration

We choose to go to the moon. We choose to go to the moon in this decade and do the other things, not because they are easy, but because they are hard.
— John F. Kennedy, 1962

Perhaps the most famous words ever spoken about human exploration. It was never about conquest — it was about choosing the difficult path.

Look again at that dot. That’s here. That’s home. That’s us.
On it everyone you love, everyone you know, everyone you ever heard of, every human being who ever was, lived out their lives.
— Carl Sagan, Pale Blue Dot

In 1990, Voyager 1 turned its camera back toward Earth from 6.4 billion kilometers away and captured the iconic “Pale Blue Dot” photograph. Sagan’s reflection on that image has moved millions.

The Cosmos

The universe is not only queerer than we suppose, but queerer than we can suppose.
— J.B.S. Haldane

Space: the final frontier.
These are the voyages of the Starship Enterprise.
Its five-year mission: to explore strange new worlds, to seek out new life and new civilizations, to boldly go where no man has gone before.
— Star Trek Opening Narration

Science

The most incomprehensible thing about the universe is that it is comprehensible.
— Albert Einstein

Somewhere, something incredible is waiting to be known.
— Carl Sagan

Science is not only compatible with spirituality; it is a profound source of spirituality.
— Carl Sagan

Stardust

We are made of starstuff.
— Carl Sagan

This is not merely poetic — it is scientific fact. Every atom of carbon, oxygen, nitrogen, and iron in our bodies was forged in the core of an ancient star.

When you look up at the night sky, you are seeing starlight that left its source millions of years ago.
It is like reading a love letter from the distant past.

Solitude

The vastness of the cosmos — the smallness of humanity.
Yet it is this small life, armed with curiosity, that measures the infinite.
That, in itself, is extraordinary.

Somewhere in the universe, perhaps, intelligent beings are gazing at their own night sky.
They are asking the same question we ask:
“Are we alone?”

Final Thoughts

These words span hundreds, even thousands of years. They come from different eras, cultures, and perspectives — but they all point in the same direction: upward, outward, toward the stars.

A hymn to humanity is a hymn to courage.
The greatness of humanity is the greatness of its courage.
— Hirohiko Araki, JoJo’s Bizarre Adventure

Perhaps that is why we keep exploring.

This article is demo content for the Lonetrail theme, showcasing blockquotes, dividers, lists, and other typographic features.

Good code reads like good writing — clear, concise, and purposeful. Below is a demonstration of Lonetrail’s syntax highlighting across multiple programming languages.

TypeScript

interface Star {
  name: string;
  distance: number; // light years
  spectralType: string;
}

async function findNearestStars(
  maxDistance: number
): Promise<Star[]> {
  const response = await fetch(
    "https://api.stellar-db.example/stars"
  );
  const allStars: Star[] = await response.json();
  return allStars.filter(
    (star) => star.distance <= maxDistance
  );
}

Python

from dataclasses import dataclass
from typing import List
import asyncio


@dataclass
class Voyager:
    name: str
    launch_year: int
    speed: float  # km/s
    destination: str

    async def transmit(self, message: str) -> bool:
        """Transmit signal back to Earth"""
        delay = len(message) * 0.1  # simulate transmission delay
        await asyncio.sleep(delay)
        print(f"[{self.name}] Signal sent: {message}")
        return True


async def exploration_mission():
    voyager = Voyager(
        name="Lonetrail-1",
        launch_year=2147,
        speed=42.0,
        destination="Proxima Centauri b"
    )
    await voyager.transmit("Arrived at target sector, beginning observation")

Rust

use std::collections::HashMap;

#[derive(Debug)]
struct NavigationSystem {
    waypoints: HashMap<String, (f64, f64, f64)>,
    current_position: (f64, f64, f64),
}

impl NavigationSystem {
    fn new() -> Self {
        NavigationSystem {
            waypoints: HashMap::new(),
            current_position: (0.0, 0.0, 0.0),
        }
    }

    fn add_waypoint(&mut self, name: &str, coords: (f64, f64, f64)) {
        self.waypoints.insert(name.to_string(), coords);
    }

    fn distance_to(&self, target: &str) -> Option<f64> {
        self.waypoints.get(target).map(|&(x, y, z)| {
            let dx = x - self.current_position.0;
            let dy = y - self.current_position.1;
            let dz = z - self.current_position.2;
            (dx * dx + dy * dy + dz * dz).sqrt()
        })
    }
}

Go

package stellar

import (
	"context"
	"fmt"
	"time"
)

type Probe struct {
	ID        string
	Launched  time.Time
	Status    string
	Telemetry chan Signal
}

type Signal struct {
	Timestamp time.Time
	Data      map[string]float64
	Strength  float64
}

func (p *Probe) StartMission(ctx context.Context) error {
	p.Status = "en_route"
	ticker := time.NewTicker(30 * time.Second)
	defer ticker.Stop()

	for {
		select {
		case <-ctx.Done():
			p.Status = "offline"
			return ctx.Err()
		case <-ticker.C:
			signal := p.collectData()
			p.Telemetry <- signal
		}
	}
}

func (p *Probe) collectData() Signal {
	return Signal{
		Timestamp: time.Now(),
		Data: map[string]float64{
			"temperature": -270.4,
			"radiation":   0.87,
			"velocity":    42.0,
		},
		Strength: 0.92,
	}
}

Inline Code

Call calculateTrajectory(origin, destination, fuel) which returns a Trajectory object. Use pnpm dev to start the development server.

Terminal Commands

# Clone the theme
git clone https://github.com/ChongxiSama/Lonetrail.git
cd Lonetrail

# Install and run
pnpm install
pnpm dev

# Build
pnpm build

Math Formulas

$$ E = mc^2 $$

$$ v = \sqrt{\frac{2GM}{r}} $$

Lonetrail supports LaTeX math rendering via KaTeX, making it ideal for technical and scientific blogging.

September 12, 1962. Houston, Texas. Rice University Stadium.

A sweltering autumn day. Some forty thousand people gathered to hear the President of the United States speak. Few realized that seventeen minutes would change the course of human history.

We choose to go to the moon. We choose to go to the moon in this decade and do the other things, not because they are easy, but because they are hard.

Full Speech

President Pitzer, Mr. Vice President, Governor, Congressman Thomas, Senator Wiley, Congressman Miller, Mr. Webb, Mr. Bell, scientists, distinguished guests, ladies and gentlemen:

I appreciate your president having made me an honorary visiting professor, and I will assure you that my first lecture will be very brief.

We meet at a college noted for knowledge, in a city noted for progress, in a State noted for strength. And we stand in need of all three, for we meet in an hour of change and challenge, in a decade of hope and fear, in an age of both knowledge and ignorance. The greater our knowledge increases, the greater our ignorance unfolds.

The Measure of Progress

No man can fully grasp how far and how fast we have come. But condense the entire 50,000 years of man’s recorded history into a span of half a century:

• For the first 40 years, we knew little — only at the end did advanced humans learn to cover themselves with animal skins
• About 10 years ago, man emerged from caves to build other kinds of shelter
• Only 5 years ago, man learned to write and use the wheeled cart
• Less than 2 years ago, Christianity was born
• This year, printing was invented
• Less than 2 months ago, the steam engine provided a new power source
• Newton explored the meaning of gravity
• Last month, electric lights, telephones, cars, and airplanes became available
• Last week, we developed penicillin, television, and nuclear power
• And if America’s new spacecraft succeeds in reaching Venus, by midnight tonight — we will have literally touched the stars.

Why the Moon?

But why, some say, the moon? Why choose this as our goal?
And they may well ask: why climb the highest mountain?
Why, 35 years ago, fly the Atlantic?
Why does Rice play Texas?

We choose to go to the moon. We choose to go to the moon in this decade and do the other things, not because they are easy, but because they are hard. Because that goal will serve to organize and measure the best of our energies and skills, because that challenge is one that we are willing to accept, one we are unwilling to postpone, and one which we intend to win.

The Cost

The vast expanse of space promises high costs and hardships, along with great rewards.

But this country — the United States — was not built by those who waited, rested, and looked back. This country was conquered by those who moved forward — and so will space.

William Bradford, speaking in 1630 of the founding of the Plymouth Bay Colony, said:

All great and honorable actions are accompanied by great difficulties, and both must be enterprised and overcome with answerable courage.

Afterword

Sixty-four years later, Kennedy’s words still resonate.

Apollo 11 ultimately fulfilled the promise on July 20, 1969 — Armstrong and Aldrin stepped onto the lunar surface. But what was said that September afternoon in Houston represents something beyond the moon landing itself: the pinnacle of the human spirit of exploration.

Not because they are easy, but because they are hard.

This article is demo content for the Lonetrail theme, showcasing long-form typography, blockquotes, and lists. Speech source: John F. Kennedy Presidential Library and Museum.

Lonetrail is a modern blog theme built with Astro. It puts reading experience first while keeping plenty of room for customization.

Per Aspera, Ad Astra. Through hardships to the stars.

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

git clone https://github.com/ChongxiSama/Lonetrail.git my-blog
cd my-blog
pnpm install
pnpm dev
pnpm build

Directory layout

src/
├── content/        # Content
│   ├── posts/      # Posts
│   ├── essays/     # Essays
│   ├── seri/       # Series
│   └── spec/       # Standalone pages
├── components/     # Components
├── layouts/        # Layouts
├── pages/          # Routes
├── styles/         # Styles
├── config.ts       # Feature flags and integrations
└── site.yml        # Site metadata

Writing a post

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

---
title: "Post title"
published: 2026-01-15
description: "One-line summary"
tags: ["tag-one", "tag-two"]
category: "技术"
---

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.