天下典藏版

文件数量变化的分析

4 min read

文件数量变化的分析

文件类型变化数量作用说明
HTML 文件+1您的新笔记 (new-note.md) 被编译成一个可供浏览器访问的 HTML 文件 (new-note.html)。
OG 图像文件+1由于您的 Quartz 配置中启用了 CustomOgImages 插件，每篇笔记都会自动生成一个用于社交媒体分享预览的 Open Graph 图像文件（通常是 .webp 或 .png 格式）。

禁用 OG 图像来减少文件数量 好的，要禁用 Obsidian Quartz v4 自动生成的 Open Graph (OG) 图像来减少文件数量，您需要在项目的配置文件中修改设置。

禁用 OG 图像后，每篇笔记将只会生成 1 个 HTML 文件，而不是 2 个文件（HTML + OG 图像），从而减少您部署文件总数的一半。

⚙️ 禁用 OG 图像的步骤

您需要编辑项目根目录下的 quartz.config.ts 文件。

1. 找到并打开 quartz.config.ts

这个文件位于您的项目根目录 E:\quartz\ 下。

2. 修改 plugins 配置

在 quartz.config.ts 文件中，找到 quartz.config.cfg.plugins 数组。您需要找到并注释掉或删除包含 CustomOgImages 的一行配置。

原始配置 (启用 OG 图像):

TypeScript

// quartz.config.ts (部分内容)

export const cfg: QuartzConfig = {
  // ... 其他配置
  plugins: {
    // ... 其他插件
    emitters: [
      // ... 其他 emitter
      // 找到这一行
      Plugin.CustomOgImages(), // <--- 启用 OG 图像的配置
      // ... 其他 emitter
      Plugin.ContentPage(),
      Plugin.FolderPage(),
      Plugin.TagPage(),
      Plugin.Rss(),
      Plugin.Sitemap(),
    ],
  },
  // ...
}

修改后的配置 (禁用 OG 图像):

您只需要在 Plugin.CustomOgImages() 前面加上 // 将其注释掉即可。

TypeScript

// quartz.config.ts (部分内容)

export const cfg: QuartzConfig = {
  // ... 其他配置
  plugins: {
    // ... 其他插件
    emitters: [
      // ... 其他 emitter
      // Plugin.CustomOgImages(), // <--- 这一行被注释掉了！
      // ... 其他 emitter
      Plugin.ContentPage(),
      Plugin.FolderPage(),
      Plugin.TagPage(),
      Plugin.Rss(),
      Plugin.Sitemap(),
    ],
  },
  // ...
}

3. 重新编译网站

保存 quartz.config.ts 文件后，回到 PowerShell，执行重新编译命令：

  1. 确保您在 E:\quartz 目录。

  2. 运行编译命令：

    Bash

    npx quartz build

✅ 预计的文件数量变化

  • 旧配置 (206 篇笔记): 445 个文件 (HTML + OG Image)

  • 新配置 (206 篇笔记): 约 240 个文件

现在，您的每篇笔记只会生成 1 个 HTML 文件，文件总数将是：

这样，您就成功减少了部署的文件数量，提高了编译效率，并且减少了存储空间占用（虽然 Cloudflare Pages 免费额度充足）。

Graph View