Site Basic Information

Main File Structure

1
stalux/
2
├── public/  # Public resources folder
3
├── src/
4
│   ├── assets/  # Static assets, generally don't modify
5
│   ├── components/ # Components
6
│   │   └── stalux/ # Theme components
7
│   │       ├── archives/ # Archives
8
│   │       ├── categories/ # Categories
9
│   │       ├── common/ # Common components
10
│   │       ├── footer/ # Footer
11
│   │       ├── layout/ # Layout
12
│   │       ├── links/  # Friend links
13
│   │       ├── posts/  # Posts
14
│   │       ├── tags/   # Tags
15
│   │       └── words/  # Words cards
16
│   ├── layouts/ # Layout files
17
│   ├── pages/ # Page files
18
│   │   ├── api/ # API folder
19
│   │   ├── categories/ # Categories page
20
│   │   ├── posts/ # Posts page
21
│   │   ├── tags/ # Tags page
22
│   │   └── words.astro # Words page
23
│   ├── scripts/ # Script files
24
│   ├── styles/
25
│   │   ├── base/ # Base styles
26
│   │   ├── components/ # Component styles
27
│   │   │   ├── archives/ # Archives
28
│   │   │   ├── categories/ # Categories
29
│   │   │   ├── common/ # Common components
30
│   │   │   ├── footer/ # Footer
31
│   │   │   ├── layout/ # Layout
32
│   │   │   ├── links/  # Friend links
33
│   │   │   ├── markdown.css # Markdown styles
34
│   │   │   ├── posts/  # Posts
35
│   │   │   ├── search.css # Search styles
36
│   │   │   ├── tags/   # Tags
37
│   │   │   └── words/  # Words
38
│   │   └── pages/ # Page styles
39
│   ├── utils/ # Utility files
40
│   └── content.config.ts # Content configuration file
41
├── stalux
42
│   ├── about/ # About .md
43
│   ├── posts/ # Posts .md
44
│   └── words/ # Words .md
45
├── astro.config.mjs
46
├── tsconfig.json
47
├── package.json
48
├── README.md
49
└── (other files)

Content Collection Locations

Content collections use astro:content and are stored by default under the root stalux/ directory:

• stalux/posts/: Post Markdown/MDX files, constrained by the posts collection schema.
• stalux/about/: About page Markdown/MDX files, constrained by the about collection schema.
• stalux/words/: Words/quotes Markdown files, constrained by the words collection schema.

posts/*.md frontmatter

Required:

• title: Post title.
• abbrlink: Permanent link identifier, string or number (numbers are automatically converted to strings); used to generate the /posts/{abbrlink} route.
• date: Publish time, supports ISO 8601 format (e.g., 2025-05-10T09:30:00+08:00) or YYYY-MM-DD HH:mm:ss format.
• desc: Post description, used for SEO meta description and Open Graph. Must be manually written, cannot be empty, recommended 50–160 characters.

Optional:

• updated: Update date, supports ISO 8601 format or YYYY-MM-DD HH:mm:ss format.
• draft: Draft status, default false; when true the post will not appear in the published list.
• tags: Tag array; a single string will also be converted to an array.
• categories: Category array; a single string will also be converted to an array.
• cc: Copyright license, default CC-BY-NC-SA-4.0.

Example:

1
---
2
title: Sample Post
3
abbrlink: sample-post
4
date: 2025-05-10T12:00:00+08:00
5
desc: This is a sample post demonstrating Stalux theme frontmatter writing.
6
updated: 2025-05-12T09:00:00+08:00
7
tags:
8
    - Tech
9
    - Essay
10
categories:
11
    - Frontend
12
cc: CC-BY-NC-SA-4.0
13
draft: false
14
---
15

16
Body content...

about/*.md frontmatter

Required:

• title: Page title.
• description: Page description (used for page intro/SEO).

Example:

1
---
2
title: About This Site
3
description: Personal introduction and site information
4
---
5

6
Content...

words/*.md frontmatter

Used for the /words quotes page, suitable for collecting short phrases, code snippets, or sayings.

Required: None.

Optional:

• source: Source or author name.
• link: Source link; when present, source will render as a clickable external link.
• sourceDate: The date associated with the source, displayed in italics at the bottom-right of the card.
• date: The date this quote was written, displayed at the bottom-left of the card; also used for sorting.
• updated: Update date, string, same format as date.
• draft: Boolean, default false; when true, not displayed.

Example:

1
---
2
source: "Quake III Arena"
3
link: "https://en.wikipedia.org/wiki/Fast_inverse_square_root"
4
sourceDate: "1999"
5
date: "2026-06-18 20:45:00"
6
updated: "2026-06-18 21:00:00"
7
draft: false
8
---
9

10
Talk is cheap. Show me the `code`.

Writing Notes

• Wrap frontmatter with --- at the top; leave a space after colons, maintain indentation for arrays/objects.
• It is recommended to use ISO 8601 format (with timezone offset) for dates, for easier sorting and display.
• It is recommended to use custom strings for abbrlink to ensure stable links independent of the title.