使用教程

首先推荐大家查看文档:https://quartz.jzhao.xyz/,从安装到二次开发相关的内容,都讲的非常详细了!推荐大家先看一下文档之后再尝试操作。

如果大家在使用过程中遇到问题,还可以到 Github上提问,一般作者都会回复。

我的个性化设置

增加统计代码

如果使用的是 Google Analytics 或者 Umami 来统计网站访客,只需要打开根目录的 quartz.config.ts 文件,在 provider 中加入信息:

const config: QuartzConfig = {
  configuration: {
    pageTitle: "☕ 微尘印记",
    enableSPA: true,
    enablePopovers: true,
    analytics: {
      provider: 'google', tagId: <your-google-tag>
    },
    baseUrl: "weichen.ink",

除了 Google Analytics 之外,还可以使用 Umami 和 Plausible,当然,如果你想使用 百度统计 也没问题,只需要在上面的字段中设置为 umami,然后去 quartz\plugins\emitters\componentResources.ts 这个文件里,把 umami 的统计代码替换为谷歌的代码就可以了。

自定义页脚(footer)信息

修改页脚信息有两种方式,第一种就是直接修改quartz\components\Footer.tsx 文件,可以改模板默认的第一行代码,如果你就是要增加几个链接,可以打开根目录的 quartz.layout.ts 文件,在 links 里面添加即可:

export const sharedPageComponents: SharedLayout = {
  head: Component.Head(),
  header: [],
  footer: Component.Footer({
    links: {
      GitHub: "https://github.com/jackyzha0/quartz",
      "Discord Community": "https://discord.gg/cRFFHYye7t",
    },
  }),
}

自定义 CSS 规则

这一条也比较简单,只需要打开 quartz\styles\custom.scss 文件,添加自己的 CSS 规则即可,例如下面这段规则,就是网站标题字体的大小调整到 1.5rem。

@use "./base.scss";
h1.page-title  {
    font-size: 1.5rem;
}