mirror/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2025-08-31 22:41:53 +02:00
Code Issues Packages Projects Releases Wiki Activity

Merge commit 'a024bc7d76fcc5e49e8210f9b0896db9ef21861a'

Browse Source
This commit is contained in:
Bjørn Erik Pedersen
2025-02-13 10:40:34 +01:00
parent c054e18827 a024bc7d76
commit 304a7e5e74
817 changed files with 5301 additions and 14766 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
docs/content/en/hugo-pipes/fingerprint.md
View File

@@ -1,7 +1,7 @@
---
title: Fingerprint
linkTitle: Fingerprinting and SRI hashing
description: Process a given resource, adding a hash string of the resource's content.
description: Cryptographically hash the content of the given resource.
categories: [asset management]
keywords: []
menu:
@@ -9,22 +9,6 @@ menu:
parent: hugo-pipes
weight: 100
weight: 100
action:
aliases: [fingerprint]
returnType: resource.Resource
signatures: ['resources.Fingerprint [ALGORITHM] RESOURCE']
---
## Usage
Fingerprinting and [SRI](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) can be applied to any asset file using `resources.Fingerprint` which takes two arguments, the resource object and an optional [hash algorithm](https://en.wikipedia.org/wiki/Secure_Hash_Algorithms).
The default hash algorithm is `sha256`. Other available algorithms are `sha384` and (as of Hugo `0.55`) `sha512` and `md5`.
Any so processed asset will bear a `.Data.Integrity` property containing an integrity string, which is made up of the name of the hash algorithm, one hyphen and the base64-encoded hash sum.
```go-html-template
{{ $js := resources.Get "js/global.js" }}
{{ $secureJS := $js | resources.Fingerprint "sha512" }}
<script src="{{ $secureJS.Permalink }}" integrity="{{ $secureJS.Data.Integrity }}"></script>
```
See the [`resources.Fingerprint`](/functions/resources/fingerprint/) function.