龙星划空

基于 Fuwari 定制，融合 Stellar 标签插件生态的 Astro 静态博客模板。

✨ Features

• Built with Astro and Tailwind CSS
• Smooth animations and page transitions
• Light / dark mode
• Customizable theme colors & banner
• Responsive design
• Search functionality with Pagefind
• Stellar tag-plugin compatibility (box, note, folding, button, frame, poetry, paper, tabs)
• Pinned posts
• Abbrlink support (CRC16/CRC32)
• Multi-level dropdown navbar
• Table of contents
• RSS feed
• Novel / Fiction support — dedicated content type with chapters, series, characters, and reading mode

🚀 Getting Started

1. Install pnpm: npm install -g pnpm
2. Install dependencies: pnpm install
3. Edit config file src/config.ts to customize your blog
4. Run pnpm new-post <filename> to create a new post
5. Start dev server: pnpm dev

📝 Frontmatter of Posts

---
title: My First Blog Post
published: 2023-09-09
description: This is the first post of my new Astro blog.
image: ./cover.jpg
tags: [Foo, Bar]
category: Front-end
draft: false
pinned: true        # Pin to top of list
abbrlink: 12345     # Optional custom short link ID
lang: jp            # Set only if post language differs from site language
---

🧩 Stellar Tag Plugins

Use triple-colon container directives in markdown:

Box — colored block with optional title

:::box{color="blue" title="Info"}
Content here
:::

Note — styled note with color accent

:::note{color="cyan" title="Note"}
Note content
:::

Folding — collapsible section

:::folding{title="Click to expand" color="yellow" open=true}
Hidden content
:::

Button

::button{color="red" text="Click Me" url="https://example.com"}

Frame — bordered image frame

:::frame
![alt](image.jpg)
:::

Poetry — verse block

:::poetry{title="静夜思" author="李白"}
床前明月光，
疑是地上霜。
:::

Paper — article with delimiters

:::paper{style="underline"}
---
Body content
---
## Notes
Footer notes
:::

Tabs — raw HTML (use directly in markdown)

<div class="tag-plugin tabs" data-tabs-name="example" data-tabs-active="0">
  <div class="nav-tabs raw">
    <button class="tab active">Tab 1</button>
    <button class="tab">Tab 2</button>
  </div>
  <div class="tab-panel" data-active>
    Content for tab 1
  </div>
  <div class="tab-panel">
    Content for tab 2
  </div>
</div>

📖 Writing Novels / Fiction

Directory Structure

src/content/
├── novels/
│   └── your-novel-slug/
│       ├── index.md          # Novel overview
│       ├── 01-chapter.md     # Chapter 1
│       └── 02-chapter.md     # Chapter 2
└── characters/
    └── character-name.md     # Character profile

See existing novels in src/content/novels/ for examples.

⚡ Commands

Command	Action
pnpm install	Install dependencies
pnpm dev	Start dev server at localhost:4321
pnpm build	Build to ./dist/
pnpm preview	Preview production build
pnpm new-post <filename>	Create a new post
pnpm astro ...	Run Astro CLI commands

📄 License

MIT