mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
d276e901b3
63386081c update cSpell config update 15c76494b Update cSpell custom dictionary (#1694) 34f3167b7 Update image processing (#1625) 7462cc798 fix: pipes in sample code break table creation (#1686) 48736447e Update anchorize.md 2ff0bd10b netlify: Hugo 0.95.0 0fc1d21b2 Update configuration.md 41855e372 Fix #1682 8c663433e Update related.md 7aa072eab netlify: Hugo 0.94.2 1682c7ee7 Update render-hooks.md ce1283cc4 Move the Render Hooks doc to its own page bbbbfbfc6 Update configuration-markup.md 92d91a316 Update configuration-markup.md 2e8068823 Update configuration-markup.md ff2dbca60 Update configuration-markup.md 89d8e5d65 Add code block documenation e993539f0 Update shortcodes.md c1b28dbfe netlify: Hugo 0.94.1 81b8c9b83 Merge branch 'tempv0.94.1' 4763b3d50 docs: Regenerate CLI docs b18463971 netlify: Bump to Hugo 0.94.0 4152ebc1d Merge branch 'tempv0.94.0' ba3a11ac2 docs: Regenerate docshelper e64016d13 docs: Regenerate docshelper 29180e4d2 add `.html` suffix to partial usage and references 3213e00f2 Docs tidy-up 6cfcae4b7 docs: Regenerate CLI docs 8a6cd0b4d docs: Regenerate docshelper b20ab262f Merge commit 'd706529720b3b2ccb99719ccd578062ca25a0cc2' git-subtree-dir: docs git-subtree-split: 63386081c55de6a7f97adde564a9cfc2ad326119
49 lines
1.8 KiB
Markdown
49 lines
1.8 KiB
Markdown
---
|
|
title: relURL
|
|
description: Creates a baseURL-relative URL.
|
|
date: 2017-02-01
|
|
publishdate: 2017-02-01
|
|
categories: [functions]
|
|
menu:
|
|
docs:
|
|
parent: "functions"
|
|
keywords: [urls]
|
|
signature: ["relURL INPUT"]
|
|
workson: []
|
|
hugoversion:
|
|
relatedfuncs: [absURL]
|
|
deprecated: false
|
|
aliases: []
|
|
---
|
|
|
|
Both `absURL` and `relURL` consider the configured value of `baseURL` in your site's [`config` file][configuration]. Given a `baseURL` set to `https://example.com/hugo/`:
|
|
|
|
```
|
|
{{ "mystyle.css" | absURL }} → "https://example.com/hugo/mystyle.css"
|
|
{{ "mystyle.css" | relURL }} → "/hugo/mystyle.css"
|
|
{{ "http://gohugo.io/" | relURL }} → "http://gohugo.io/"
|
|
{{ "http://gohugo.io/" | absURL }} → "http://gohugo.io/"
|
|
```
|
|
|
|
The last two examples may look strange but can be very useful. For example, the following shows how to use `absURL` in [JSON-LD structured data for SEO][jsonld] where some of your images for a piece of content may or may not be hosted locally:
|
|
|
|
{{< code file="layouts/partials/schemaorg-metadata.html" download="schemaorg-metadata.html" >}}
|
|
<script type="application/ld+json">
|
|
{
|
|
"@context" : "https://schema.org",
|
|
"@type" : "BlogPosting",
|
|
"image" : {{ apply .Params.images "absURL" "." }}
|
|
}
|
|
</script>
|
|
{{< /code >}}
|
|
|
|
The above uses the [apply function][] and also exposes how the Go template parser JSON-encodes objects inside `<script>` tags. See [the safeJS template function][safejs] for examples of how to tell Hugo not to escape strings inside of such tags.
|
|
|
|
{{% note "Ending Slash" %}}
|
|
`absURL` and `relURL` are smart about missing slashes, but they will *not* add a closing slash to a URL if it is not present.
|
|
{{% /note %}}
|
|
|
|
[apply function]: /functions/apply/
|
|
[configuration]: /getting-started/configuration/
|
|
[jsonld]: https://developers.google.com/search/docs/advanced/structured-data/intro-structured-data
|
|
[safejs]: /functions/safejs
|