リンクしたい（{{% ref %}} / {{% relref %}}）
本文
詳細は[こちらの外部サイト](外部サイトURL)をご覧ください
出力
詳細は<a href="外部サイトURL">こちらの外部サイト</a>をご覧ください
外部サイトのURLにリンクする場合は、通常のMarkdown記法でOKです。
内部ページしたい
ショートコード
{{% ref "ファイルのパス" %}}
{{% relref "ファイルのパス" %}}
本文
詳細は[こちらのリンク]({{% relref "ファイルのパス" %}} "title属性")をご覧ください
サイト内のページにリンクする場合は、コンテンツ用のファイル名からパーマリンクを取得する必要があります。
そのために、ビルトインされている{{< relref >}}もしくは{{< ref >}}ショートコードを使います。
relref: 該当するパーマリンクの相対パスを取得ref: 該当するパーマリンクの絶対パスを取得
他言語ページしたい
ショートコード
{{% relref path="ファイル名" lang="言語コード" %}}
本文
関連する英語ページは[こちらのページ]({{% relref path="ファイル名" lang="言語コード" %}} "英語ページのタイトル")です。
設定したい
1# hugo.toml
2refLinkErrorLevel = "ERROR"
3refLinksNotFoundURL = "リンク先が参照できなかったときに埋め込むURL"
relrefやrefでリンク先が参照できなかった場合の挙動を設定できます。
リンクエラーが多い場合は、一時的にWARNINGに変更してもよいかもしれません。