...
` โ **zero JS, pure SSG** |
| Coverage | Every page (home, posts, archives, etc.) gets the same hidden prompt |
| Disable | Leave `llm_promote` empty |
### export_md
Markdown export is opt-in and defaults to `false`. Only a strict `export_md: true` enables the Markdown endpoints for the home page, posts, about, words, links, archives, categories, and tags. Published posts are served from `/posts/{abbrlink}.md`; list and taxonomy pages use their corresponding `.md` routes. Useful for:
| Use Case | Benefit |
| ----------- | ------------------------------ |
| AI crawlers | Read original content directly |
| Users | Download Markdown source |
| RSS readers | Subscribe to Markdown content |
---
## ai-discovery.yml โ AI Discovery Files
File: `stalux/config/ai-discovery.yml` โ controls generation of AI-visibility.org standard files.
```yaml
id: ai-discovery
conformance: "complete" # See conformance levels below
```
### Conformance Levels
| Level | Generated Files |
| ------------- | ------------------------------------------------------------------------- |
| `disabled` | None |
| `essential` | `llms.txt`, `ai.txt` |
| `recommended` | essential + `ai.json`, `identity.json`, `brand.txt`, `faq-ai.txt` |
| `complete` | recommended + `llm.txt`, `llms.html`, `developer-ai.txt`, `robots-ai.txt` |
### Content Overrides (Optional)
```yaml
# Custom permissions/restrictions for ai.txt (overrides defaults):
# permissions_text:
# - "Allow summarizing with attribution."
# restrictions_text:
# - "Do not reproduce full articles without permission."
# attribution_text: ""
# contact_text: ""
```
Each route file checks `ai-discovery.yml` โ `conformance` before generating content. Disabled files return a notice instead of actual content.
### Verification
```bash
# Check generated AI files
ls dist/ai.txt dist/llms.txt dist/identity.json 2>/dev/null
# Count hidden prompts
grep -rl 'display:none' dist/ | grep '\.html$' | wc -l
```
---
## Lorem Ipsum Test
URL: https://stalux.needhelp.icu/posts/asddsa/
License: CC-BY-NC-SA-4.0
This post is just to check if the timezone is correct???
Lorem ipsum test
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam euismod, nisl eget ultricies ultrices, nunc nisl aliquam nunc, vitae aliquam nisl nisl vitae nisl. Donec euismod, nisl eget ultricies ultrices, nunc nisl aliquam nunc, vitae aliquam nisl nisl vitae nisl.
Sample content text, this is just some random Chinese text. These words have no specific meaning and are only used to test page layout and font rendering. If more text is needed, you can continue adding similar content to fill the page space.
1. Test item one
2. Test item two
3. Test item three
```
Code block example
function hello() {
console.log("Hello, world!");
}
```
Lorem ipsum test
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam euismod, nisl eget ultricies ultrices, nunc nisl aliquam nunc, vitae aliquam nisl nisl vitae nisl. Donec euismod, nisl eget ultricies ultrices, nunc nisl aliquam nunc, vitae aliquam nisl nisl vitae nisl.
Sample content text, this is just some random Chinese text. These words have no specific meaning and are only used to test page layout and font rendering. If more text is needed, you can continue adding similar content to fill the page space.
1. Test item one
2. Test item two
3. Test item three
```
Code block example
function hello() {
console.log("Hello, world!");
}
```
---
## Image Lightbox Test
URL: https://stalux.needhelp.icu/posts/asdasdasd/
License: CC-BY-NC-SA-4.0
The following are a large number of test image links (using the https://picsum.photos placeholder image service), which can be used to verify lightbox (PhotoSwipe) loading and lazy loading performance:
---
## Markdown Rendering Examples
URL: https://stalux.needhelp.icu/posts/2cb4f19c/
License: CC-BY-NC-SA-4.0
# Comprehensive Markdown Syntax Guide
## Basic Syntax
### Headings
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
### Emphasis
_Italic_ or _Italic_
**Bold** or **Bold**
**_Bold Italic_** or **_Bold Italic_**
~~Strikethrough~~
HTML Block
This is an HTML paragraph mixed with Markdown
- Markdown list within HTML
- Second item
> Markdown blockquote within HTML
### Footnotes
Here is a footnote[^1], and another one[^2].
[^1]: This is the content of the first footnote.
[^2]:
This is the second footnote, which can span multiple lines.
Indented content belongs to the footnote.
### LaTeX Math Formulas
Inline formula: $E=mc^2$
Block formula:
$$
\frac{d}{dx}(e^x) = e^x
$$
### Mermaid
**Flowchart**
```mermaid
graph LR
A[Start] --> B{Is it?}
B -->|Yes| C[OK]
B -->|No| D[Fail]
C --> E[End]
D --> E
```
**Sequence Diagram**
```mermaid
sequenceDiagram
Alice->>John: Hello John
John-->>Alice: Hi Alice
Alice->>John: How are you?
John-->>Alice: Great!
```
**Class Diagram**
```mermaid
classDiagram
Animal <|-- Duck
Animal <|-- Fish
Animal : +int age
Animal : +String gender
Animal: +isMammal()
Duck: +String beakColor
Duck: +swim()
Fish: -int sizeInFeet
Fish: -canEat()
```
**State Diagram**
```mermaid
stateDiagram-v2
[*] --> Idle
Idle --> Processing : start
Processing --> Success : done
Processing --> Failed : error
Success --> [*]
Failed --> Idle : retry
```
**Flowchart**
```mermaid
flowchart LR
A[Login] --> B{Dashboard}
B --> C[Settings]
B --> D[Profile]
C --> E[Security]
C --> F[Notifications]
D --> G[Edit]
D --> H[Avatar]
```
## Special Character Escaping
\* Escaped asterisk
\\ Escaped backslash
\` Escaped backtick
\_ Escaped underscore
\{ \} Escaped curly braces
\[ \] Escaped square brackets
\( \) Escaped parentheses
\# Escaped hash
\+ Escaped plus
\- Escaped minus
\. Escaped period
\! Escaped exclamation mark
---
## Markdown File Configuration Reference
URL: https://stalux.needhelp.icu/posts/f31dae4f/
License: CC-BY-NC-SA-4.0
## Overview
This article is rewritten according to the current schema (see src/content.config.ts), listing the frontmatter requirements and examples for posts, about, and words. Avoid using project-internal relative links to ensure no broken links when published to the site.
## posts/\*.md frontmatter
Loader: base is `stalux/posts/`, pattern `*.md`/`*.mdx`.
Required fields:
- `title`: Post title.
- `abbrlink`: Permanent link, supports strings or numbers (numbers are automatically converted to strings). It is recommended to manually set this to keep URLs stable.
- `date`: Publish time, **string type**, recommended format `YYYY-MM-DD HH:mm:ss`, must be wrapped in double quotes to prevent YAML from automatically converting it to a Date object.
Optional fields:
- `updated`: Update date, **string type**, same format as `date`, also needs double quotes. If not provided, the update time will not be displayed.
- `draft`: Boolean, default false; when true, can be used for local draft control.
- `tags`: Tag array; a string or single string will be preprocessed into an array.
- `categories`: Category array; a string or single string will be preprocessed into an array.
- `cc`: Copyright license, default `CC-BY-NC-SA-4.0`.
Example:
```markdown
---
title: Astro Getting Started Guide
abbrlink: astro-guide
date: "2025-05-10 09:30:00"
updated: "2025-05-12 18:00:00"
tags:
- Astro
- Frontend
categories:
- Tech Tutorial
cc: CC-BY-NC-SA-4.0
draft: false
---
Body content...
```
Writing tips:
- **Recommended date format**: `YYYY-MM-DD HH:mm:ss` (e.g., `"2025-05-10 09:30:00"`).
- Must be wrapped in **double quotes**, otherwise YAML will automatically convert it to a Date object, causing schema validation to fail.
- `abbrlink` can be a string (e.g., `"astro-guide"`) or a number (e.g., `123456`); numbers are automatically converted to strings.
- `tags`/`categories` support a single string or an array; they are automatically converted to arrays internally.
- If `cc` is not provided, the default value `CC-BY-NC-SA-4.0` is used; if no copyright notice is needed, it can be set to an empty string.
## about/\*.md frontmatter
Loader: base is `stalux/about/`, pattern `**/*.{md,mdx}`.
Fields:
- `title` is required.
- `description` is required (used for page description/SEO).
Example:
```markdown
---
title: About the Author
description: Personal introduction, skills, and contact information
---
Here is the about page body...
```
## words/\*.md frontmatter
Loader: base is `stalux/words/`, pattern `*.md`/`*.mdx`.
All fields are 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 and used for sorting; same format as posts' `date`.
- `updated`: Update date, string, same format as `date`.
- `draft`: Boolean, default `false`; when `true`, not displayed.
Example:
```markdown
---
source: "Quake III Arena"
link: "https://en.wikipedia.org/wiki/Fast_inverse_square_root"
sourceDate: "1999"
date: "2026-06-18 20:45:00"
updated: "2026-06-18 21:00:00"
draft: false
---
Talk is cheap. Show me the `code`.
```
## promote.yml: Markdown Export (`export_md`)
Field in `stalux/config/promote.yml`:
- `export_md`: Boolean, default `false`. Markdown export is opt-in: only a strict `true` generates `.md` routes for the home page, posts, about, words, links, archives, categories, and tags.
Published article endpoints serve the raw Markdown source with `Content-Type: text/markdown`. The source is read directly from the original `.md` file when available, falling back to a reconstruction from frontmatter + body data. List and taxonomy endpoints render Markdown summaries.
Example:
```yaml title="stalux/config/promote.yml"
id: promote
export_md: true
```
Note:
- `export_md` is a site-level opt-in config, not a per-article frontmatter field.
- When disabled or omitted, no `.md` export files are generated.
- Only non-draft articles get post `.md` endpoints.
- The sitemap filters out `.md` pages to avoid duplicate content issues.
- Useful for readers who want to view or reuse the raw source.
## Writing and Validation
- Place frontmatter at the top of the file, wrapped in three dashes.
- Leave a space after colons, maintain correct indentation for arrays/objects.
- After saving, run `bun run dev`; if any required fields are missing or types don't match, the build log will indicate the specific fields.
---
## Waline Comment System Configuration
URL: https://stalux.needhelp.icu/posts/f4442947/
License: CC-BY-NC-SA-4.0
## comment.yml โ Comment System
File: `stalux/config/comment.yml`
```yaml
id: comment
enabled: false # Master switch: enable comments site-wide
waline:
serverURL: https://walines.xingwangzhe.fun # Waline server address
lang: zh-CN # Waline UI language
login: "force" # "enable" | "disable" | "force"
dark: true # Dark mode support
reaction: false # Reaction feature
meta: [nick, mail, link] # Required user fields
requiredMeta: [] # Mandatory fields
commentSorting: "latest" # "latest" | "oldest" | "hottest"
wordLimit: 200 # Max comment length
pageSize: 10 # Comments per page
recaptchaV3Key: "" # reCAPTCHA v3 site key
turnstileKey: "" # Cloudflare Turnstile key
```
### Key Fields
| Field | Description |
| --------------------- | ----------------------------------------------------------------------------------- |
| `enabled` | Global toggle. Set to `true` to enable comments on all pages |
| `waline.serverURL` | **Required** for Waline to work. Points to your Waline server |
| `waline.login` | `"enable"` โ allow anyone; `"force"` โ require login; `"disable"` โ no login needed |
| `waline.meta` | User info fields collected from commenters |
| `waline.requiredMeta` | Fields that must be filled in (subset of `meta`) |
### Getting Started
1. Deploy a Waline server (see [Waline docs](https://waline.js.org/))
2. Set `enabled: true` and fill in `waline.serverURL`
3. Adjust other settings as needed
4. Test by leaving a comment on any post
### Common Modifications
| Operation | How |
| ---------------------- | -------------------------------------------------------------- |
| Toggle comments on/off | Change `enabled` |
| Switch Waline server | Update `serverURL` |
| Enable anti-spam | Set `recaptchaV3Key` or `turnstileKey` |
| Change sort order | Set `commentSorting` to `"latest"`, `"oldest"`, or `"hottest"` |
---
## Footer Configuration Details
URL: https://stalux.needhelp.icu/posts/dd30cf92/
License: CC-BY-NC-SA-4.0
## Overview
Footer configuration is in `stalux/config/footer.yml`:
```yaml
id: footer
buildtime: "2025-05-01T10:00:00" # Build time for uptime display
copyright:
enabled: true
startYear: 2024
customText: ""
theme:
showPoweredBy: true
showThemeInfo: true
beian:
icp:
enabled: false
number: "ICPๅคXXXXXXXXๅท"
security:
enabled: false
text: "Public Security Filing"
number: "XXXXXXXXXXXX"
badges:
- label: "Powered by"
message: "Astro"
color: "orange"
style: "flat-square"
href: "https://astro.build/"
# ... more badges ...
# Collapsible badge group (v1.1+):
- title: "ๅๅฎข็คพๅบ"
collapsed: true
items:
- label: "็คบไพ็คพๅบA"
message: "็คพๅบ"
color: "green"
href: "https://example.com"
- label: "็คบไพ็คพๅบB"
message: "ๅฏผ่ช"
color: "yellow"
href: "https://example.org"
custom: |
```
## Badge Types
| Type | Fields | Behavior |
| ----------- | --------------------------------------------------- | ----------------------------------------------------- |
| Flat badge | `label`, `message`, `color`, `style`, `alt`, `href` | Renders a single badge |
| Badge group | `title`, `collapsed`, `items[]` | Collapsible `