mirror of
https://github.com/McShelby/hugo-theme-relearn.git
synced 2024-11-30 19:23:12 +00:00
33 lines
1.7 KiB
Markdown
33 lines
1.7 KiB
Markdown
+++
|
|
categories = ["howto"]
|
|
description = "What options are available for links and images"
|
|
frontmatter = ["externalLinkTarget", "image.errorlevel", "link.errorlevel"]
|
|
options = ["externalLinkTarget", "image.errorlevel", "link.errorlevel"]
|
|
title = "Linking"
|
|
weight = 3
|
|
+++
|
|
|
|
## Opening Links
|
|
|
|
{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}} By default, external links open in a new tab. To change this, use the `externalLinkTarget` setting with a proper [link target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#target).
|
|
|
|
For example, this will open links in the same tab
|
|
|
|
{{< multiconfig >}}
|
|
externalLinkTarget = '_self'
|
|
{{< /multiconfig >}}
|
|
|
|
## Enabling Link and Image Link Warnings
|
|
|
|
{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}} You can use `link.errorlevel` and `image.errorlevel` to control what should happen if a local link can not be resolved to a resource.
|
|
|
|
If not set or empty, any unresolved link is written as given into the resulting output. If set to `warning` the same happens and an additional warning is printed in the built console. If set to `error` an error message is printed and the build is aborted.
|
|
|
|
Please note that this can not resolve files inside of your `static` directory. The file must be a resource of the page or the site.
|
|
|
|
Link warnings are also available for the [include](shortcodes/include#enabling-link-warnings) and [openapi](shortcodes/openapi#enabling-link-warnings) shortcodes.
|
|
|
|
{{< multiconfig >}}
|
|
link.errorlevel = 'warning'
|
|
image.errorlevel = 'warning'
|
|
{{< /multiconfig >}}
|