如何让Hugo项目中的跨页面引用正常生效？

基于Hugo主题搭建项目，项目结构如下：

content
    learning
        aws
            index.md
            how-we-use
                index.md

希望在aws > index.md中添加指向how-we-use > index.md的链接，但尝试以下写法均出现404错误：

- [How we use AWS](./how-we-use)
- [How we use AWS](/how-we-use)
- [How we use AWS](/learning/aws/how-we-use)

how-we-use > index.md内容：

+++
title = "How we use AWS"
aliases = "/learning/aws/how-we-use/"
+++

Hi There

也曾修改别名为/how-we-use/和/how-we-use，依旧无效。

config.toml关键配置片段：

baseurl = "https://welcome-page" 
theme = "hugo-universal-theme"
uglyURLs = false

[[menu.main]]
    name       = "AWS"
    identifier = "learning.aws"
    url        = "/aws"
    weight     = 1
    parent     = "section.learnings"

附：若将文件名改为_index.md，仅显示标题，内容无法正常展示。

1. 修正菜单路径配置 #

你的菜单中AWS的URL设为/aws，但实际内容的路径是/learning/aws/，路径不匹配会导致页面跳转异常。先把菜单URL修正为正确的内容路径：

[[menu.main]]
    name       = "AWS"
    identifier = "learning.aws"
    url        = "/learning/aws/"  # 改为对应content目录的实际路径
    weight     = 1
    parent     = "section.learnings"

2. 使用Hugo内置短代码生成可靠链接（推荐） #

放弃手动写路径，改用Hugo的relref或ref短代码，它会自动匹配页面路径、别名等，避免人为错误：

# 基于当前页面的相对路径匹配
[How we use AWS]({{< relref "how-we-use/index.md" >}})

# 更简洁的写法（如果文件名在站点内唯一）
[How we use AWS]({{< relref "how-we-use" >}})

# 基于站点根路径的匹配写法
[How we use AWS]({{< ref "learning/aws/how-we-use" >}})

3. 验证静态生成后的实际路径 #

运行hugo命令生成静态文件后，检查public目录下的结构：
正常情况下，content/learning/aws/how-we-use/index.md会生成public/learning/aws/how-we-use/index.html，对应的访问路径应为/learning/aws/how-we-use/，如果路径不符，检查是否有其他配置（如permalinks）干扰了生成规则。

4. 关于_index.md的显示问题 #

_index.md是Hugo的章节首页（Section Page），它使用主题的list.html模板渲染；而index.md是独立页面（Regular Page），使用single.html模板。改成_index.md后只显示标题，说明主题的列表模板未包含内容渲染逻辑，你可以：

• 继续使用index.md作为独立页面，避免模板适配问题
• 或修改主题的layouts/learning/aws/list.html模板，添加{{ .Content }}代码块来渲染页面内容

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