Ubuntu环境下Hugo创建内容时报错：无现有内容目录配置求解决

问题场景 #

在Ubuntu系统的Hugo项目中，执行命令hugo new content content/first.md时触发报错：

Error: no existing content directory configured for this project

项目根目录存在hugo.toml（多语言配置，每个语言指定独立contentDir）和额外的config.toml，且根目录已手动创建content文件夹及index.md文件。

问题原因 #

1. 配置冲突：同时存在hugo.toml和config.toml，Hugo配置加载优先级导致多语言配置里的contentDir被优先读取，根目录的content目录不匹配多语言指定的路径。
2. 缺失语言对应目录：hugo.toml中为每种语言指定了content/en、content/it、content/es作为内容目录，但这些子目录未创建。
3. 命令写法错误：hugo new content命令不需要重复写入content前缀，路径写法不符合多语言项目的规范。

解决步骤 #

1. 清理重复配置文件 #

删除根目录下单独的config.toml，避免和hugo.toml的配置冲突，Hugo会默认读取hugo.toml作为主配置文件。

2. 创建多语言内容目录 #

根据hugo.toml中的配置，手动创建各语言对应的内容子目录：

mkdir -p content/en content/it content/es

3. 使用正确命令创建内容 #

针对多语言项目，创建内容时需指定目标语言（或利用默认语言）：

• 给默认语言（英文，weight=1）创建内容：

hugo new en/first.md

• 明确指定语言创建：

hugo new first.md --language en

• 给其他语言创建内容（以意大利语为例）：

hugo new first.md --language it

可选：添加根级别内容目录（如需通用内容） #

如果需要在根content目录存放不绑定特定语言的通用内容，可在hugo.toml的根级别添加配置：

contentDir = "content"

此配置会和各语言的contentDir共存，Hugo会同时识别根目录和各语言子目录的内容。

内容的提问来源于stack exchange，提问作者Roberto Gimenez