summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/resources/Copy.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/functions/resources/Copy.md')
-rw-r--r--docs/content/en/functions/resources/Copy.md32
1 files changed, 32 insertions, 0 deletions
diff --git a/docs/content/en/functions/resources/Copy.md b/docs/content/en/functions/resources/Copy.md
new file mode 100644
index 000000000..f8e962aee
--- /dev/null
+++ b/docs/content/en/functions/resources/Copy.md
@@ -0,0 +1,32 @@
+---
+title: resources.Copy
+description: Copies the given resource to the target path.
+categories: []
+action:
+ aliases: []
+ related: []
+ returnType: resource.Resource
+ signatures: [resources.Copy TARGETPATH RESOURCE]
+---
+
+{{< new-in 0.100.0 >}}
+
+```go-html-template
+{{ with resources.Get "images/a.jpg" }}
+ {{ with resources.Copy "img/new-image-name.jpg" . }}
+ <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
+ {{ end }}
+{{ end }}
+```
+
+The relative URL of the new published resource will be:
+
+```text
+/img/new-image-name.jpg
+```
+
+The target path must be different than the source path, as shown in the example above.
+
+{{% note %}}
+Use the `resources.Copy` function with global, page, and remote resources.
+{{% /note %}}