Lonetrail

Lonetrail Configuration Reference

Lonetrail Demo — Sun, 01 Mar 2026 00:00:00 GMT

Site Configuration

All configuration lives in src/site.yml:

site:
  title: "Lonetrail"
  subtitle: "Ad Astra Per Aspera"
  url: "https://lonetrail.vercel.app"
  lang: "en"
  author: "Chongxi"
  email: "qwq@chongxi.us"
  favicon: "/images/favicon.webp"
  banner: ""
  og_image: "/images/og.webp"

profile:
  avatar: "/images/chongxi-avatar.webp"
  name: "Chongxi"
  bio: "Ad Astra Per Aspera"
  links:
    - name: "GitHub"
      url: "https://github.com/ChongxiSama/Lonetrail"
    - name: "Docs"
      url: "https://github.com/ChongxiSama/Lonetrail#readme"
    - name: "Theme Gallery"
      url: "https://astro.build/themes/"

nav:
  - Home: "/"
  - Archive: "/archive/"
  - Series: "/seri/"
  - Links: "/links/"
  - About: "/about/"

features:
  breadcrumb: true
  comments: true
  search: false
  donate: false
  rss_feed: true
  sitemap: true
  related_posts: true
  series: true
  license: true

seo:
  enable_json_ld: false
  breadcrumb: true
  keywords: "astro, theme, blog, lonetrail"
  same_as: []

services:
  posthog:
    api_key: ""
    api_host: "https://app.posthog.com"
  webmention:
    url: ""
  blogsclub:
    badge_url: ""
  issue_tracker:
    url: ""

trusted_domains:
  - "lonetrail.vercel.app"

copyright:
  text: "Lonetrail Demo"
  site_name: "Lonetrail"
  license: "MIT"
  license_url: "https://opensource.org/licenses/MIT"

Article Frontmatter

Articles use the following frontmatter format:

---
title: "Article Title"
published: 2026-01-15
description: "Article description"
tags: ["tag1", "tag2"]
category: "Category"
image: ""
---

Series

The "Stellar Exploration" series is defined as:

---
title: "Stellar Exploration Project"
subtitle: "Stellar Exploration Project"
published: 2026-01-15
filter:
  tag: "Stars"
---

Articles tagged with the matching tag are automatically associated with the series.

Whispers of the Stars

Lonetrail Demo — Fri, 20 Feb 2026 00:00:00 GMT

Humanity has looked up at the stars for as long as we have existed. Across millennia, thinkers, scientists, and explorers have captured their wonder in words. Here is a collection spanning centuries and cultures.

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.

The Art of Code

Lonetrail Demo — Tue, 10 Feb 2026 00:00:00 GMT

Elegant Code

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.

We Choose to Go to the Moon

Lonetrail Demo — Sun, 01 Feb 2026 00:00:00 GMT

The Moment

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.

Welcome to Lonetrail

Lonetrail Demo — Thu, 15 Jan 2026 00:00:00 GMT

About Lonetrail

Lonetrail is a modern blog theme built with Astro. It prioritizes reading experience while retaining rich customization capabilities.

Ad Astra Per Aspera.
Through hardships to the stars.

Key Features

Blazing fast — Astro's static generation delivers near-instant page loads
Responsive design — Looks great on desktop, tablet, and mobile
Dark mode — Toggle between light and dark themes
RSS / Atom — Auto-generated syndication feeds
Series — Organize articles into research series
Tags & categories — Flexible content organization system
Comments — Artalk integration for discussion
Links page — Built-in friend links management

Quick Start

# Clone the repository
git clone https://github.com/ChongxiSama/Lonetrail.git my-blog
cd my-blog

# Install dependencies
pnpm install

# Start dev server
pnpm dev

# Build for production
pnpm build

Directory Structure

src/
├── content/        # Article content
│   ├── posts/     # Blog posts
│   ├── seri/      # Series
│   └── spec/      # Special pages
├── components/    # Components
├── layouts/       # Layouts
├── pages/         # Page routes
├── styles/        # Styles
└── site.yml       # Site configuration

Configuring Your Site

Edit src/site.yml to customize your site title, subtitle, author info, and more.

site:
  title: "My Blog"
  subtitle: "A place for thoughts"
  url: "https://example.com"

Articles are written in Markdown and placed in src/content/posts/. Each article requires a frontmatter header:

---
title: "Article Title"
published: 2026-01-15
description: "Article description"
tags: ["tag1", "tag2"]
category: "Category"
---

Lonetrail also supports series collections, custom pages, and more advanced features. Check out the other articles for details.