Koi 模板的基础配置

基础配置

您可以通过修改 src/consts.ts 中的配置项来实现主要的配置项修改,以定制您的 Astro 博客站点。每个配置项的详细说明如下所示:

配置项说明
SITE_LANGUAGE定义网站的 <html> 语言标签,例如 en 表示英语,zh-hans-CN 表示简体中文。
SITE_TITLE网站名称,如 Astro Koi
SITE_DESCRIPTION网站的副标题,用于简要介绍网站内容。
SITE_AUTHOR_NAME博主的昵称。
SITE_AUTHOR_AVATAR博主的头像,值为 Astro 图片对象
SITE_COPYRIGHT_YEAR_START网站版权起始年份,表明网站从哪一年开始拥有版权。
SITE_MENU网站头部导航菜单,包括各菜单项的标题、链接地址和打开方式(当前页面或新标签页)。
SITE_HEAD_IMAGE_DAY网站横幅背景图片(明亮主题),值为 Astro 图片对象
SITE_HEAD_IMAGE_NIGHT网站横幅背景图片(暗黑主题),值为 Astro 图片对象
BLOG_PAGINATION_SIZE一页展示的博文数量,用于控制博客列表的分页。

通过对这些配置项进行修改,您可以轻松地自定义您的 Astro 博客站点,包括网站的语言、主题、外观以及功能等方面。

Astro 配置

对 Astro 本身的配置,需要修改 astro.config.js 文件。

// (以上略)

// https://astro.build/config
export default defineConfig({
    // 网站的入口地址
    site: 'https://wwww.example.com',
    // 网站的基本 URL。如果网站就在域名根目录下,则保持为 `/` 即可
    // 但是如果是将网站放置在子路径下(例如 `https://example.github.io/my-site/`),则需要指定为 `/my-site/`
    base: process.env.NODE_ENV === "production" ? "/" : "",
    integrations: [mdx(), sitemap(), tailwind(), svelte()],
    markdown: {
        // Markdown 脚注段落的标题
        remarkRehype: {
            footnoteLabel: "脚注", 
            footnoteBackLabel: '文档内容的脚注',
        }
    }
});

Tailwind CSS 配置

如果需要修改网站主色和强调色,以及对 Tailwind CSS 进行其它一些定制,则需要修改 tailwind.config.js 文件。

主色和强调色的调色盘可以通过 UI Colors 等工具快捷生成。生成完毕后,覆盖 primaryaccent 的值即可。