Hugo/markdown 中的链接页面

Posted 2023-03-07

【中文标题】Hugo/markdown 中的链接页面

【英文标题】：Linking pages in Hugo/markdown

【发布时间】：2016-01-18 10:17:30

【问题描述】：

我是 HUGO (http://gohugo.io/) 静态站点生成器的新手。我在本地运行 Hugo 服务器，可作为 localhost:1313 访问。我正在尝试链接两个不同部分的页面。我的“feature.md”文件需要指向“grid_modules.md”的链接，反之亦然。以下是 hugo 生成站点中两个文件的目录结构。

~/mysite/content/about/feature.md

~/mysite/content/modules/grid_modules.md

将两个页面链接在一起的最佳方式是什么？我正在尝试的是以下

在feature.md:

“[grid_modules] (../modules/grid_modules)”

如果我尝试访问此链接，我会在“localhost:1313/about/modules/grid_modules”处收到错误，我知道这是错误的位置。

我在链接中缺少什么？为什么我没有收到“localhost:1313/modules/grid_modules”。

【问题讨论】：

你也可以查看文档(gohugo.io/content-management/cross-references)，他们给出了很多关于如何让它在不同语言中工作的例子，而不仅仅是markdown。

【参考方案1】：

页面的 URL 取决于您的 URL 配置（通过 https://gohugo.io/extras/permalinks/ 或直接设置为单个页面上的 URL）。

而且这通常与文件系统上的路径不同。

Hugo 有一些辅助函数可以帮助您，请参阅本文档中的 ref 和 relref：

https://gohugo.io/extras/cros-s-references/

【参考方案2】：

此答案基于提供的answer 通过bep。这个答案是正确的，但不是很清楚（因为在我找到解决方案之前，我花了很多次阅读它并尝试了不同的东西）。

如前所述：

页面的 URL 取决于您的 URL 配置（通过 https://gohugo.io/extras/permalinks/ 或直接设置为单个页面上的 URL）。

您可以在标记中使用ref 和relref 标签，以便链接解析为正确的URL。

对于您的示例，这可能类似于以下内容之一（取决于您需要绝对 URL 还是相对 URL）：

[grid_modules] ( < relref "modules/grid_modules" >)
[grid_modules] ( < ref "modules/grid_modules" >)

【讨论】：

看起来这不适用于参考格式？ IE。 [my_link][id] 和 [id]: < relref "otherpage.md" > "my title text"

【参考方案3】：

我遇到了同样的问题，并找到了以下更简单的解决方案。当从 content/ 下的页面以 [text](/url/path) 的形式指定 url 时，/url/path 根实际上是 content/（或呈现站点中的 public/）。因此，要从“~/mysite/content/about/feature.md”中链接到“~/mysite/content/modules/grid_modules.md”，您可以简单地写在“feature.md”中

[grid_modules](/modules/grid_modules)