TheCloud/hugoDocs
1
0
Fork 0
mirror of https://github.com/gohugoio/hugoDocs.git synced 2025-09-11 08:54:41 -04:00
Code Issues Packages Projects Releases Wiki Activity

Add cache note to resources.Concat

Browse Source
This commit is contained in:
Joe Mooring 2024-01-04 11:19:04 -08:00 committed by GitHub
parent a8d1a60206
commit dc1c0aeeb1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 26 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
content/en/functions/resources/Concat.md
View File

@ -1,6 +1,6 @@
---
title: resources.Concat
description: Concatenates a slice of resources.
description: Returns a concatenated slice of resources.
categories: []
keywords: []
action:
@ -10,12 +10,17 @@ action:
signatures: ['resources.Concat TARGETPATH [RESOURCE...]']
---
The `resources.Concat` function returns a concatenated slice of resources, caching the result using the target path as its cache key. Each resource must have the same [media type].
Hugo publishes the resource to the target path when you call its [`Publish`], [`Permalink`], or [`RelPermalink`] methods.
[media type]: https://en.wikipedia.org/wiki/Media_type
[`publish`]: /methods/resource/publish
[`permalink`]: /methods/resource/permalink
[`relpermalink`]: /methods/resource/relpermalink
```go-html-template
{{ $plugins := resources.Get "js/plugins.js" }}
{{ $global := resources.Get "js/global.js" }}
{{ $js := slice $plugins $global | resources.Concat "js/bundle.js" }}
```
Asset files of the same [media type] can be bundled into one resource using the `resources.Concat` function which takes two arguments, the target path for the created resource bundle and a slice of resource objects to be concatenated.
[media type]: https://en.wikipedia.org/wiki/Media_type

10
content/en/functions/resources/ExecuteAsTemplate.md
View File

@ -1,6 +1,6 @@
---
title: resources.ExecuteAsTemplate
description: Creates a resource from a Go template, parsed and executed with the given context.
description: Returns a resource created from a Go template, parsed and executed with the given context.
categories: []
keywords: []
action:
@ -11,7 +11,13 @@ action:
signatures: [resources.ExecuteAsTemplate TARGETPATH CONTEXT RESOURCE]
---
Hugo publishes the resource to the target path when you call its`.Publish`, `.Permalink`, or `.RelPermalink` method. The resource is cached, using the target path as the cache key.
The `resources.ExecuteAsTemplate` function returns a resource created from a Go template, parsed and executed with the given context, caching the result using the target path as its cache key.
Hugo publishes the resource to the target path when you call its [`Publish`], [`Permalink`], or [`RelPermalink`] methods.
[`publish`]: /methods/resource/publish
[`permalink`]: /methods/resource/permalink
[`relpermalink`]: /methods/resource/relpermalink
Let's say you have a CSS file that you wish to populate with values from your site configuration:

10
content/en/functions/resources/FromString.md
View File

@ -1,6 +1,6 @@
---
title: resources.FromString
description: Creates a resource from a string.
description: Returns a resource created from a string.
categories: []
keywords: []
action:
@ -11,7 +11,13 @@ action:
signatures: [resources.FromString TARGETPATH STRING]
---
Hugo publishes the resource to the target path when you call its`.Publish`, `.Permalink`, or `.RelPermalink` method. The resource is cached, using the target path as the cache key.
The `resources.FromString` function returns a resource created from a string, caching the result using the target path as its cache key.
Hugo publishes the resource to the target path when you call its [`Publish`], [`Permalink`], or [`RelPermalink`] methods.
[`publish`]: /methods/resource/publish
[`permalink`]: /methods/resource/permalink
[`relpermalink`]: /methods/resource/relpermalink
Let's say you need to publish a file named "site.json" in the root of your public directory, containing the build date, the Hugo version used to build the site, and the date that the content was last modified. For example: