Prepare links for link validation

[thomasrebele]

Use {{% ref "..." %}} instead of {{< ref "..." >}}, so that a future link validator will get the link before it is passed to Goldmark. The Goldmark renderer will replace the URL with a shortcode that cannot be validated anymore. (See https://discourse.gohugo.io/t/using-shortcode-inside-render-hook/42038/5).

The modifications have been done with the following command:

perl -pi -e 's/\{\{< (ref|relref) "([^"]*)" >\}\}/{{% \1 "\2" %}}/gm' **/*.md

(Previously it was perl -pi -e 's/\{\{< ref "([^"]*)" >\}\}/{{% ref "\1" %}}/gm' **/*.md. The updated command also handles relref links)

[rubenada]

Just to double-check: there are 3 instances of {{< relref "…" >}}, which were not considered by this patch:

• content/docs/latest/admin/iceberg-rest-catalog.md:28 ==> [Apache Hive : Setting Up OAuth 2]({{< relref "oauth2/_index.md" >}})
• content/docs/latest/admin/iceberg-rest-catalog.md:44 ==> [Apache Hive : LanguageManual Authorization]({{< relref "../language/languagemanual-authorization.md" >}})
• content/docs/latest/admin/oauth2/_index.md:16 ==> [Keycloak]({{< relref "keycloak.md" >}})

Are these intentionally excluded? Or should the also be change into {{% relref "…" %}} for consistency?

[thomasrebele]

Thanks for checking. I guess it makes sense to include relref links as well. I've updated the PR, and the perl command in the description.