diff options
Diffstat (limited to 'docs/content/en/functions/absurl.md')
-rw-r--r-- | docs/content/en/functions/absurl.md | 51 |
1 files changed, 0 insertions, 51 deletions
diff --git a/docs/content/en/functions/absurl.md b/docs/content/en/functions/absurl.md deleted file mode 100644 index a31dbb0b4..000000000 --- a/docs/content/en/functions/absurl.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: absURL -description: Creates an absolute URL based on the configured baseURL. -godocref: -date: 2017-02-01 -publishdate: 2017-02-01 -lastmod: 2017-02-01 -categories: [functions] -menu: - docs: - parent: "functions" -keywords: [urls] -signature: ["absURL INPUT"] -workson: [] -hugoversion: -relatedfuncs: [relURL] -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 (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" : "http://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/guides/intro-structured-data -[safejs]: /functions/safejs |