# Stalux Blog Theme

URL: https://stalux.needhelp.icu/

> Blog theme Stalux - A professional display platform for content creators, supporting various customization features including comment system integration, friend link management, social media sharing, and rich SEO optimization options to make your content more attractive and discoverable.

Lang: en

## Markdown Sources
- [Home](https://stalux.needhelp.icu/index.md)
- [About](https://stalux.needhelp.icu/about.md)
- [Words](https://stalux.needhelp.icu/words.md)
- [Links](https://stalux.needhelp.icu/links.md)
- [Archives](https://stalux.needhelp.icu/archives.md)
- [Categories](https://stalux.needhelp.icu/categories.md)
- [Tags](https://stalux.needhelp.icu/tags.md)
- [LLMs.txt](https://stalux.needhelp.icu/llms.txt)
- [LLMs-full.txt](https://stalux.needhelp.icu/llms-full.txt)

## About
## 👋 Welcome to the Stalux Theme

**Stalux** is an Astro static blog theme for content creators, developed by **xingwangzhe**. The name blends "Static" and "Luxury," with the goal of providing a high-performance, beautiful, and easily customizable writing experience.

## ⚙️ What You Can Configure

- Site Info: Title, description, author, favicon, social head information
- Navigation Menu: Name, icon (Lucide Icons), internal and external links
- Comment System: Waline server address, language, emoji, pagination, etc.
- Social Links: Multi-platform entries, rendering SVGs based on simple-icons
- Friend Links: Site name, description, icon, link
- Footer: Copyright, filing, badges, custom scripts and slots

All configuration is centralized in the root `config.yml`, taking effect without modifying component code.

## 🌟 Documentation Acknowledgements

- [Astro](https://astro.build/) — Content-driven modern static framework
- [MDN Web Docs](https://developer.mozilla.org/) — Authoritative reference for Web technologies
- [Simple Icons](https://simpleicons.org/) — Brand SVG icon library
- [Lucide Icons](https://lucide.dev/) — Beautiful and consistent open-source icon library

## 💡 Usage Suggestions

1. First complete the basic items in `config.yml`, then supplement navigation, social, and footer.
2. When writing, use Markdown and ensure required fields like `title`, `abbrlink`, and `date` are complete.
3. If enabling analytics or verification, place the code into `anyhead`, and confirm in the browser console that there are no errors before publishing.
4. After deployment, visit the entire site and check that interactions like lightbox, search, and comments work properly.

## 🙏 Feedback and Support

- Submit Issues or PRs on [GitHub](https://github.com/xingwangzhe/stalux).
- Leave your usage experience and needs in the comment section.

Stalux is released under the MIT license, and you are welcome to freely use and improve it. May it become your efficient writing companion!

## Latest Posts
- [LLM & AI Discovery File Configuration](https://stalux.needhelp.icu/posts/a1b2c3d4.md): Configure LLM prompt injection (promote.yml) and AI discovery file generation (ai-discovery.yml) for AI crawler visibility.
- [Lorem Ipsum Test](https://stalux.needhelp.icu/posts/asddsa.md): This post is just to check if the timezone is correct???
- [Image Lightbox Test](https://stalux.needhelp.icu/posts/asdasdasd.md): 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](https://stalux.needhelp.icu/posts/2cb4f19c.md): Inline code var example = "hello";
- [Markdown File Configuration Reference](https://stalux.needhelp.icu/posts/f31dae4f.md): 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.
- [Waline Comment System Configuration](https://stalux.needhelp.icu/posts/f4442947.md): Comment system configuration from comment.yml — enable/disable toggle and Waline integration settings.
- [Footer Configuration Details](https://stalux.needhelp.icu/posts/dd30cf92.md): Footer configuration from footer.yml — buildtime, copyright, badges, beian, and custom HTML.
- [Typing Animation, Social Media & Friend Links](https://stalux.needhelp.icu/posts/8e8c59c4.md): Configuration for the homepage typing animation (typetexts.yml), social media links (media-links.yml), and friend links (links.yml).
- [Custom Head, Analytics & Navigation](https://stalux.needhelp.icu/posts/0035a0ee.md): Configure analytics tools (Google Analytics, Bing Clarity, Umami), custom head content, and navigation bar items.
- [Code Display Configuration](https://stalux.needhelp.icu/posts/55a885fa.md): The Stalux theme uses Expressive Code to provide powerful code display features, including syntax highlighting, editor/terminal frames, and automatic line wrapping. This article explains how to configure and use these features.