内容配置#

内容配置包含文章、项目、技能、时间线等内容，支持通过后台进行管理。

文件结构#

1
项目根目录/
2
└── src/
3
    └── content/
4
        ├── albums/      # 相册数据
5
        ├── diary/       # 日记数据
6
        ├── friends/     # 友链数据
7
        ├── posts/       # 文章数据
8
        ├── projects/    # 项目数据
9
        ├── skills/      # 技能数据
10
        ├── timeline/    # 时间线数据
11
        ├── about.md     # 关于页面内容
12
        └── friends.md   # 友链页面内容

文章数据#

文章存放在 src/content/posts 目录及其子目录下，支持 Markdown (.md) 格式。

Frontmatter 配置#

每篇文章开头需要包含 Frontmatter：

1
---
2
title: 文章标题
3
published: 2025-01-15    # 发布日期
4
updated: 2025-01-15      # 更新日期（可选）
5
description: 文章描述     # 显示在列表页的摘要
6
image: /path/to/image    # 文章封面图（可选）
7
tags: [Tag1, Tag2]       # 标签
8
category: CategoryName   # 分类
9
draft: false             # 是否为草稿
10
---

扩展语法#

支持以下自定义组件：

GitHub 仓库卡片#

1
::github{repo="Owner/Repo"}

提示框（Admonitions）#

1
:::note
2
提示内容
3
:::

支持类型：note、tip、important、warning、caution

隐藏文本（Spoiler）#

1
:spoiler[被隐藏的文字]

项目数据#

在 src/content/projects 中新建一个 .json 文件，格式如下：

1
{
2
    "title": "Twilight Blog Template",
3
    "description": "A CMS integrated blog theme built with Astro framework.",
4
    "image": "",
5
    "category": "website",
6
    "techStack": [
7
        "Astro",
8
        "Svelte",
9
        "Tailwind CSS"
10
    ],
11
    "status": "in-progress",
12
    "liveDemo": "https://twilight.spr-aachen.com",
13
    "sourceCode": "https://github.com/Spr-Aachen/Twilight",
14
    "startDate": "2025-10-01",
15
    "endDate": "",
16
    "featured": false,
17
    "tags": [
18
        "Personal Project",
19
        "Open Source Project"
20
    ]
21
}

每个 JSON 文件对应一个项目，文件名即项目 ID。

技能数据#

在 src/content/skills 中新建一个 .json 文件：

1
{
2
    "name": "Git",
3
    "description": "A distributed version control system.",
4
    "icon": "logos:git-icon",
5
    "category": "tools",
6
    "level": "advanced",
7
    "experience": {
8
        "years": 3,
9
        "months": 0
10
    },
11
    "color": "#F05032"
12
}

每个 JSON 文件对应一个技能，文件名即技能 ID。

时间线数据#

在 src/content/timeline 中新建一个 .json 文件：

1
{
2
    "title": "Twilight",
3
    "description": "My first open source template project, a blog template built with Astro framework.",
4
    "type": "project",
5
    "startDate": "2025-10-01",
6
    "endDate": "",
7
    "skills": [
8
        "Astro",
9
        "Svelte",
10
        "Tailwind CSS"
11
    ],
12
    "achievements": [],
13
    "links": [
14
        {
15
            "name": "GitHub Repository",
16
            "url": "https://github.com/Spr-Aachen/Twilight",
17
            "type": "project"
18
        },
19
        {
20
            "name": "Online Demo",
21
            "url": "https://twilight.spr-aachen.com",
22
            "type": "other"
23
        }
24
    ],
25
    "icon": "material-symbols:code",
26
    "color": "#7C3AED",
27
    "featured": false
28
}

每个 JSON 文件对应一个时间点，文件名即时间点 ID。

相册数据#

在 src/content/albums 中新建一个 .json 文件：

1
{
2
    "title": "相册标题",
3
    "description": "相册描述",
4
    "cover": "封面图URL",
5
    "date": "2025-01-01T00:00:00.000Z",
6
    "location": "地点",
7
    "tags": ["标签"],
8
    "layout": "masonry",
9
    "columns": 3,
10
    "photos": [
11
        {
12
            "src": "图片URL或本地路径",
13
            "alt": "图片描述",
14
            "title": "图片标题",
15
            "description": "详细描述",
16
            "tags": ["标签"]
17
        }
18
    ],
19
    "visible": true
20
}

日记数据#

在 src/content/diary 中新建一个 .json 文件：

1
{
2
    "content": "日记内容",
3
    "date": "2025-01-01T00:00:00Z",
4
    "images": []
5
}

友链数据#

在 src/content/friends 中新建一个 .json 文件：

1
{
2
    "title": "站点名称",
3
    "imgurl": "头像URL",
4
    "desc": "站点描述",
5
    "siteurl": "站点链接",
6
    "tags": ["分类标签"]
7
}

单页内容#

src/content/about.md：关于页面内容
src/content/friends.md：友链页面头部说明（如申请方式）

后台管理#

访问：

1
你的域名/admin

进入后台管理界面，点击对应选项卡即可管理内容。

如果你愿意，我还能帮你把这篇文档：

生成 官方文档侧边栏结构
生成 更专业的标题摘要
合并到你的 Twilight 文档体系中

你想继续优化哪一部分。

致虚以守静