预览地址：Astro-Theme-Yi
更多配置内容，请参阅文章： Astro-YI Write Skill
一款以内容为主的Astro博客主题————Yi，快速和简洁。
- 支持GithubPages
- 支持多端显示
- 支持暗黑显示
- 集成Memos
- 支持国际化
- 支持搜索功能
- 友好的SEO
- 支持站点地图和rss
- 支持草稿箱
- 支持waline评论系统
- 支持图片懒加载和预览
- 支持文章永久固定链接
- 支持meriand
- 支持mathjax
- 支持expressive-code
......等等
试试吧，点击上面的按钮，就可以一键部署了。
推荐使用：nodejs >= 20，pnpm >= 8。
git clone https://github.com/cirry/astro-yi.git
cd astro-yi
npm install -g pnpm
pnpm i
npm run dev # preview将您最喜欢的文章写在 src/content/blog 文件夹中，在 src/content/feed 文件夹中编写您想发布的动态内容。
- 博客内容位于：
src/content/blog - All
.mdfiles under this directory are treated as blog posts
- 支持子目录分类（Subdirectories are allowed）
- 只有
.md文件会被识别为文章 - 目录本身不会生成页面
本项目的博客内容位于：
src/content/blog/
支持使用子目录对文章进行分类，例如：
src/content/blog/wsl/xxx.md
src/content/blog/stm32/yyy.md
src/content/blog/ros/zzz.md
- 所有
.md文件（包括子目录中的）都会被识别为博客文章 - 子目录仅用于分类，不影响文章是否被收集
- 仅文件会被识别为文章，目录本身不会生成页面
👉 推荐按技术方向或主题划分子目录，便于管理和维护
npm run build # build
pnpm dev 查看打包完成后，在根目录中会生成一个 dist 文件夹。将 'dist' 文件夹上传到 Web 服务器目录中，即可完成部署。
只需在/src/consts.ts中修改site对象中的url和baseUrl属性：
export const site = {
// ...
url: 'https://wdxzf.github.io', // 必填 你的网站主域名
baseUrl: 'wdxzf.github.io', // 必填，仓库名称
// ...
}本博客的唯一的配置文件就是：src/consts.ts，您可以根据自己的需求进行一些修改。
/**
* Site information
* title：网站标题
* description：网站描述
* author：作者
* motto：格言
* url：网站地址
* baseUrl： 当使用github pages时，必须填入仓库名称，用/开头
* recentBlogSize：最近文章数量
* archivePageSize：归档页面每页显示的数量
* postPageSize：文章页面每页显示的数量
* feedPageSize：动态页面每页显示数量
* beian：备案号
*/
export const site = {
title: 'Astro Theme Yi',
favicon: '/favicon.svg',
description: 'Welcome to my independent blog website! ',
author: "Cirry",
avatar: '/avatar.png',
motto: '最重要的事情只有一件',
url: 'https://astro-yi-nu.vercel.app',
baseUrl: '', // 用斜杠开头 '/astro-blog'
recentBlogSize: 5,
archivePageSize: 25,
postPageSize: 10,
feedPageSize: 20,
beian: ''
}
/**
* busuanzi：是否开启不蒜子统计功能
* lang {string} Default website language: English
* codeFoldingStartLines {number} default 16
* ga {string} google analytics code
* memosUrl {string} memos server url
* memosUsername {string} memos login name
* memosPageSize {number} 10
*/
export const config = {
lang: 'en', // English: en | 简体中文: zh-cn | 繁體中文: zh-Hant | cs
codeFoldingStartLines: 16, // Need to re-run the project to take effect
// memos config
memosUrl: '', // https://xxxx.xxx.xx
memosUsername: '', // login name
memosPageSize: 10, // number
}
/**
* 导航栏
*/
export const categories = [
{
name: "首页",
iconClass: "ri-home-4-line",
href: "/",
},
{
name: "博客",
iconClass: "ri-draft-line",
href: "/blog/1",
},
{
name: "动态",
iconClass: "ri-lightbulb-flash-line",
href: "/feed/1",
},
{
name: "归档",
iconClass: "ri-archive-line",
href: "/archive/1",
},
{
name: "留言",
iconClass: "ri-chat-1-line",
href: "/message",
},
{
name: "搜索",
iconClass: "ri-search-line",
href: "/search",
},
{
name: "更多",
iconClass: "ri-more-fill",
href: "javascript:void(0);",
children: [
{
name: '关于本站',
iconClass: 'ri-information-line',
href: '/about',
},
{
name: '友情链接',
iconClass: 'ri-user-5-line',
href: '/friends',
},
]
}
]
/**
* 个人链接地址
*/
export const infoLinks = [
{
icon: "ri-bilibili-fill",
name: "bilibili",
outlink: "https://space.bilibili.com/xxxxxxxx",
},
{
icon: 'ri-mail-fill',
name: 'xxxxxxx@gmail.com',
outlink: 'mailto:xxxxxxx@gmail.com',
},
{
icon: 'ri-github-fill',
name: 'github',
outlink: 'https://github.com/cirry',
},
{
icon: 'ri-rss-fill',
name: 'rss',
outlink: 'https://xxxxx.com/rss.xml',
}
]
/**
* 赞赏功能
* 请在使用之前更换图像和 PayPal 链接。
* enable {boolean}
* tip {string}
*/
export const donate = {
enable: false,
tip: "感谢大佬送来的咖啡☕",
wechatQRCode: "/WeChatQR.png",
alipayQRCode: "/AliPayQR.png",
paypalUrl: "https://paypal.me/cirry0?country.x=C2&locale.x=zh_XC",
}
/**
* 友情链接配置
*/
export const friendshipLinks =
[
{
name: "Cirry's Blog",
url: 'https://cirry.cn',
avatar: "https://cirry.cn/avatar.png",
description: '前端开发的日常'
},
]
/**
* 评论功能
* enable 是否开启评论功能
* type 目前支持waline和giscus评论系统
* walineConfig.serverUrl 评论服务器地址
* walineConfig.pageSize 每页评论数量
* walineConfig.wordLimit 评论内容字数限制，默认为空不限制
* walineConfig.count 最近评论侧边栏评论数量
* walineConfig.pageview 是否开启阅读数统计
* walineConfig.reaction 是否开启表情
* walineConfig.requiredMeta 必填字段
*/
export const comment = {
enable: true,
type: 'giscus', // waline | giscus,
walineConfig:{
serverUrl: "https://xxxxx.xxxxx.app",
lang: 'en',
pageSize: 20,
wordLimit: '',
count: 5,
pageview: true,
reaction: true,
requiredMeta: ["nick", "mail"],
whiteList: ['/message/', '/friends/'],
},
// giscus config
giscusConfig: {
'data-repo': "wdxzf/blog-comments",
'data-repo-id': "R_kgDORf47fw",
'data-category': "Announcements",
'data-category-id': "DIC_kwDORf47f84C3zZC",
'data-mapping': "pathname",
'data-strict': "1",
'data-reactions-enabled': "1",
'data-emit-metadata': "0",
'data-input-position': "top",
'data-theme': "preferred_color_scheme",
'data-lang': "zh-CN",
'data-loading': "lazy",
'crossorigin': "anonymous",
}
}评论配置直接写在 src/consts.ts 里即可，不需要 .env、GitHub Actions Variables 或其他额外配置文件。
/**
- Analytics Feature Configuration
- enable: {boolean} 这个必须启用才能使用其他的配置项
- This file centralizes the analytics configuration for the application.
- It defines and exports the default settings for Umami and Google Analytics.
- busuanzi {boolean} */ export const analytics: AnalyticsConfig = { enable: false, umamiConfig: { enable: false, id: "", url: "" }, gaConfig: { enable: false, id: "" }, busuanzi: false, };
请修改您的网站配置、评论系统配置、赞赏功能图片、个人信息链接，当然，您也可以修改其他配置内容。