配置Hugo-blox自定义主题遇多类问题，请求技术指导

一、基础自定义主题不生效的修复 #

• 创建正确的自定义目录：Wowchemy新版采用模块化架构，自定义主题文件不能放在themes子目录的data文件夹下，需在项目根目录手动新建data/theme目录，将custom_theme.toml放入此处。
• 验证配置项：在params.yaml中确认已添加theme: custom_theme（与你的toml文件名一致），注意YAML的缩进格式必须正确（通常为2个空格）。

二、高级自定义中「table短码缺失」报错的解决 #

报错信息： #

process: readAndProcessContent: "/Users/chrislarkin/Documents/website/content/post/data-visualization/index.md:155:1": failed to extract shortcode: template for shortcode "table" not found
hugo v0.128.1-0ff542b4b9cc7b5cb425bbab8bdb5aace81d0c03+extended darwin/arm64 BuildDate=2024-07-02T06:46:41Z VendorInfo=gohugoio

修复步骤： #

1. 补全缺失的短码文件：下载的自定义主题依赖旧版Wowchemy的table短码，而新版已移除该短码。将自定义主题文件夹内的layouts/shortcodes/table.html复制到项目根目录的layouts/shortcodes文件夹（无此目录则手动新建）。
2. 验证模块导入路径：检查modules.yaml的导入路径是否正确，示例格式如下：

   imports:
     - path: ./modules/custom-wowchemy-settings
   

   执行hugo mod tidy命令刷新Hugo模块依赖，确保本地模块被正确识别。
3. 备选方案：若不想保留旧短码，可将文章中的{{< table >}}替换为标准Markdown表格语法，适配新版Wowchemy。

三、通用排查建议 #

• 执行hugo clean清理缓存后再预览，避免缓存导致的配置不生效问题。
• 参考Wowchemy官方最新自定义文档，旧教程的目录结构已过时，官方文档会同步最新的配置方式。

内容的提问来源于stack exchange，提问作者C.Robin