前言#

1
[site]
2
title = "Firmamento"                    # 站点标题，显示在浏览器标签和页头
3
description = "欢迎来到这个小站！"      # 站点描述，用于 SEO 和 Banner 副标题
4
url = "https://luoshulv.netlify.app/"   # 站点完整 URL，用于 RSS、Sitemap
5
language = "zh-CN"                      # HTML lang 属性值
6
author = "花束（洛疏律）"               # 作者名称，显示在页脚和个人信息栏
7
bg_image = "/scp.jpg"                   # 全屏背景图路径，支持本地和远程图片
8
announcement = "欢迎来到我的个人小站！" # 站点公告，显示在右侧工具栏
9
launch_date = "2026-07-10"              # 建站日期（用于计算运行天数）
10

11
featured_posts = ["story-1"]            # 首页推荐文章 slug 或 ID

1
[banner]
2
title = "Firmamento"
3
subtitle = "欢迎来到属于我的星空，坐在这里陪我一会吧~"
4
bg_start = "#38bdf8"
5
bg_end = "#0284c7"
6
bg_opacity_start = "15%"
7
bg_opacity_end = "5%"
8
border_opacity = "10%"
9
shadow_opacity = "35%"
10
typing_speed = 120        # 打字速度（ms/字符）
11
typing_delete_speed = 60  # 删除速度（ms/字符）
12
typing_pause = 2000       # 完成后暂停时间（ms）
13
typing_loop = true        # 是否循环

1
[author]
2
avatar = "/avatar.png"                          # 头像图片路径，支持本地和远程
3
id = "花束（洛疏律）"                           # 作者昵称/ID，显示在个人信息栏
4
bio = "血液的作用之一，是为信仰付出代价。"      # 个人简介
5
location = "中华人民共和国"                      # 所在地
6
age = "17"                                      # 年龄

1
[[social_links]]
2
name = "GitHub"
3
href = "https://github.com/silencieuxzero"
4
icon = "github"
5

6
[[social_links]]
7
name = "Fandom"
8
href = "https://backrooms.fandom.com/zh/wiki/User:Appennino"
9
icon = "fandom"

1
[repos]
2
username = "silencieuxzero"   # GitHub 用户名，用于 API 调用
3
page_title = "GitHub 仓库"    # 仓库页面标题
4
page_subtitle = "仓库副标题"  # 仓库页面副标题
5
display_mode = "selected"     # "all" 或 "selected"
6

7
[[displayed_repos]]
8
owner = "silencieuxzero"
9
repo = "backrooms_escape"
10

11
[[displayed_repos]]
12
owner = "E33EPUS"
13
repo = "E33EPUS-s-ChatScreen"

1
[site]
2
featured_posts = ["story-1"]

1
[music]
2
loop_mode = "all"   # "none" 不循环 / "one" 单曲循环 / "all" 列表循环
3
autoplay = false
4
volume = 0.3        # 默认音量（0.0 ~ 1.0）
5

6
[[songs]]
7
url = "/music/song.mp3"
8
title = "歌曲名"
9

10
# 网易云音乐：使用 id 字段
11
# [[songs]]
12
# id = "3379996850"
13
# title = "网易云音乐歌曲"

1
[[gallery.images]]
2
src = "/image.jpg"      # 图片路径，支持本地和远程 URL
3
alt = "图片描述"        # 用于无障碍访问和灯箱预览
4
copyright = "版权方"    # 版权方名称
5
source = "来源链接"     # 图片来源链接

1
[sub_gallery]
2
page_title = "三十天友谊挑战"
3
page_subtitle = "描述文字"
4
password = "30days"   # 留空则不启用密码
5

6
[[sub_gallery.images]]
7
src = "/image.jpg"
8
alt = "第1天"

1
[[friend_links]]
2
name = "站点名"
3
url = "https://example.com/"
4
description = "站点描述"
5
avatar = "https://example.com/avatar.png"

1
const blog = defineCollection({
2
  loader: glob({ base: './src/content/blog', pattern: '**/*.{md,mdx}' }),
3
  schema: z.object({
4
    title: z.string(),
5
    description: z.string(),
6
    pubDate: z.coerce.date(),
7
    updatedDate: z.coerce.date().optional(),
8
    heroImage: z.string().optional(),
9
    password: z.string().optional(),
10
    category: z.string().optional(),
11
    tags: z.array(z.string()).optional(),
12
  }),
13
});

1
schema: z.object({
2
  title: z.string(),
3
  description: z.string(),
4
  pubDate: z.coerce.date(),
5
  updatedDate: z.coerce.date().optional(),
6
  heroImage: z.string().optional(),
7
  password: z.string().optional(),
8
  category: z.string().optional(),
9
  tags: z.array(z.string()).optional(),
10
  // 自定义字段示例
11
  draft: z.boolean().optional(),  // 草稿标记
12
  pinned: z.boolean().optional(), // 置顶标记
13
})

1
---
2
title: 文章标题
3
description: 文章简介
4
pubDate: 2026-07-10
5
updatedDate: 2026-07-11       # 可选
6
heroImage: ./path/to/image.jpg # 可选
7
password: <SHA-256 哈希值>     # 可选，启用加密
8
category: 分类名               # 可选
9
tags: [标签1, 标签2]           # 可选
10
draft: true                    # 可选，草稿标记（需在 schema 中声明）
11
pinned: true                   # 可选，置顶标记（需在 schema 中声明）
12
---

1
---
2
title: ''
3
description: ''
4
pubDate: 2026-07-17
5
updatedDate: 2026-07-17
6
heroImage: ''
7
category: ''
8
tags: []
9
---
10

11
## 文章正文
12

13
在这里开始写作...

1
[page]
2
title = "教程"
3
subtitle = "一些实用教程的集合"
4
description = ""  # SEO 描述，留空则继承站点全局描述

1
[layout]
2
columns_mode = "auto"    # "auto" 自适应 / "fixed" 固定列数
3
fixed_columns = 3        # 固定列数（1~6）
4
card_min_width = 280     # 卡片最小宽度（px）
5
items_per_page = 6       # 每页显示数量（1~24）

1
[display]
2
show_thumbnail = true
3
show_category_badge = true
4
show_date = true
5
show_word_count = true
6
show_description = true
7
thumbnail_height = 120  # 60 ~ 300

1
[search]
2
enabled = true
3
debounce_delay = 200      # 防抖延迟（ms），50 ~ 1000
4
search_title = true
5
search_description = true

1
[filter]
2
enabled = true

1
[pagination]
2
enabled = true
3
show_page_numbers = true
4
show_prev_next = true

1
[animation]
2
card_enter_animation = true
3
animation_duration = 0.4    # 0.1 ~ 1.0
4
animation_stagger = 0.06    # 0 ~ 0.3，建议 0.03 ~ 0.1
5
hover_translate_y = 3       # 0 ~ 20

1
[appearance]
2
card_border_radius = 8      # 0 ~ 20
3
card_border_opacity = 0.15  # 0 ~ 1
4
thumbnail_gradient_opacity_start = 0.2  # 0 ~ 1
5
thumbnail_gradient_opacity_end = 0.07   # 0 ~ 1

1
[categories.colors]
2
"前端开发" = "#38bdf8"
3
"后端开发" = "#34d399"
4
"DevOps"   = "#f472b6"
5
"设计"     = "#a78bfa"
6
"编程语言" = "#fb923c"

1
[[tutorials]]
2
title = "教程标题"
3
description = "教程描述"
4
pubDate = "2026-07-14"
5
category = "分类名"
6
url = "/blog/slug"  # 链接到对应博客文章或外部链接

1
[integration]
2
show_in_navbar = true
3
navbar_link_text = "教程"

1
:root {
2
  --accent: #38bdf8;          /* 主色调 */
3
  --accent-dark: #0284c7;     /* 主色调深色 */
4
  --black: 15, 18, 25;        /* 主要文字色（RGB 值） */
5
  --gray: 96, 115, 159;       /* 次要文字色 */
6
  --gray-light: 229, 233, 240; /* 浅色背景 */
7
  --gray-dark: 34, 41, 57;    /* 深色文字 */
8
  --gray-gradient: rgba(var(--gray-light), 50%), #fff;
9
  --box-shadow:
10
    0 1px 3px rgba(var(--gray), 15%),
11
    0 4px 12px rgba(var(--gray), 18%);
12
}

1
[data-theme="dark"] {
2
  --black: 229, 233, 240;
3
  --gray: 156, 163, 175;
4
  --gray-light: 31, 41, 55;
5
  --gray-dark: 229, 233, 240;
6
  --gray-gradient: rgba(31, 41, 55, 50%), #0f1219;
7
  --box-shadow:
8
    0 1px 3px rgba(0, 0, 0, 25%),
9
    0 4px 12px rgba(0, 0, 0, 30%);
10
}

1
fonts: [
2
  {
3
    provider: fontProviders.local(),
4
    name: 'Atkinson',
5
    cssVariable: '--font-atkinson',
6
    fallbacks: ['sans-serif'],
7
    options: {
8
      variants: [
9
        { src: ['./src/assets/fonts/atkinson-regular.woff'], weight: 400, style: 'normal' },
10
        { src: ['./src/assets/fonts/atkinson-bold.woff'], weight: 700, style: 'normal' },
11
      ],
12
    },
13
  },
14
];

1
fonts: [
2
  {
3
    provider: fontProviders.google(),
4
    name: 'Noto Sans SC',
5
    cssVariable: '--font-noto',
6
    fallbacks: ['sans-serif'],
7
  },
8
];

1
const html = document.documentElement;
2
const btn = document.querySelector('.theme-toggle');
3
const stored = localStorage.getItem('theme');
4
const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
5
if (stored === 'dark' || (!stored && prefersDark)) {
6
  html.setAttribute('data-theme', 'dark');
7
}
8
btn?.addEventListener('click', () => {
9
  const isDark = html.getAttribute('data-theme') === 'dark';
10
  html.setAttribute('data-theme', isDark ? 'light' : 'dark');
11
  localStorage.setItem('theme', isDark ? 'light' : 'dark');
12
});

1
const COLLAPSE_THRESHOLD = 15;  // 超过多少行自动折叠

1
// markdown: {
2
//   processor: unified({
3
//     rehypePlugins: [rehypeCodeBlock],
4
//   }),
5
// },

1
---
2
import Header from '../components/Header.astro';
3
---
4

5
<Header />

1
---
2
// 定义 Props 类型
3
interface Props {
4
  title: string;
5
  count?: number;
6
}
7
const { title, count = 0 } = Astro.props;
8
---
9

10
<div>{title} - {count}</div>

1
adapter: netlify(),

1
:root {
2
  --accent: #a78bfa;
3
  --accent-dark: #7c3aed;
4
}

1
[banner]
2
bg_start = "#a78bfa"
3
bg_end = "#7c3aed"

1
---
2
export interface Props {
3
  title?: string;
4
  description?: string;
5
  image?: string;
6
}
7
const {
8
  title = SITE_TITLE,
9
  description = SITE_DESCRIPTION,
10
  image = `${SITE_URL}/og-image.png`
11
} = Astro.props;
12
---
13

14
<head>
15
  <title>{title}</title>
16
  <meta name="description" content={description} />
17
  <meta property="og:title" content={title} />
18
  <meta property="og:description" content={description} />
19
  <meta property="og:image" content={image} />
20
  <meta property="og:type" content="website" />
21
  <link rel="canonical" href={Astro.url.href} />
22
</head>

1
<script type="application/ld+json">
2
{
3
  "@context": "https://schema.org",
4
  "@type": "Blog",
5
  "name": "{SITE_TITLE}",
6
  "description": "{SITE_DESCRIPTION}"
7
}
8
</script>

1
/_astro/*
2
  Cache-Control: public, max-age=31536000, immutable