mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
07b8d9466d
fb551cc75 Update index.md 7af894857 Update index.md d235753ea Hugo 0.82.1 e03e72deb Merge branch 'temp0821' e62648961 Merge branch 'release-0.82.1' e1ab0f6eb releaser: Add release notes to /docs for release of 0.82.1 5d354c38d Replaced ``` code blocks with Code Toggler c9d065c20 Remove duplicate YAML keys (#1420) 8ae31e701 Add webp image encoding support 848f2af26 Update internal.md (#1407) c103a86a4 Fix `ref` shortcode example output (#1409) 9f8ba56dc Remove leading dot from where function KEY (#1419) 363251a51 Improve presentation of template lookup order (#1382) b73da986d Improve description of Page Resources (#1381) 4e0bb96d5 Rework robots.txt page (#1405) edf893e6f Update migrations.md (#1412) 450f1580b Add link to `site` function doc (#1417) cfffa6e6f Added one extension to the list (#1414) 05f1665a0 Update theme 5de0b1c6a Update theme 250e20552 Add hugo.IsExtended dea5e1fd7 Fix typo on merge function page (#1408) 1bbed2cf3 Update configuration.md be0b64a46 Omit ISO cbb5b8367 Fix `dateFormat` documentation 698f15466 Regenerate the docshelper f9a8a7cb6 Update multilingual.md a22dc6267 Fix grammar (#1398) eb98b0997 Fix pretty URL example (#1397) f4c4153dc Mention date var complementation in post scheduling (#1396) 17fae284c Fix resources.ExecuteAsTemplate argument order (#1394) 97e2c2abb Use code-toggle shortcode in `multilingual.md` (#1388) 3a84929bb Harmonize capitalization (#1393) 17f15daa6 fix file naming used in example (#1392) 5d97b6a18 Add slice syntax to sections permalinks config 00665b97b Improve description of `site.md` edcf5e3fc Fix example in `merge.md` f275ab778 Update postprocess.md 9593e3991 Fix file name 59bd9656f Update postprocess.md 1172fb6d0 Update to theNewDynamic repository (#1263) f5b5c1d2c Update Hugo container image 4f2e92f2a Adapt anchorize.md to Goldmark 98aa19073 Directly link to `highlight` shortcode (#1384) 4c75c2422 Fix header level f15c06f23 markdownify: add note about render-hooks and .RenderString (#1281) 69c82eb68 Remove Blackfriday reference from shortcode desc (#1380) 36de478df Update description of ignoreFiles config setting (#1377) 6337699d8 Remove "Authors" page from documentation (#1371) 35e73ca90 fix indent in example (#1372) d3f01f19a Remove opening body tag from header example (#1376) 341a5a7d8 Update index.md c9bfdbee6 Release 0.82.0 119644949 releaser: Add release notes to /docs for release of 0.82.0 32efaed78 docs: Regenerate docs helper dea5449a2 docs: Regen CLI docs eeab18fce Merge commit '81689af79901f0cdaff765cda6322dd4a9a7ccb3' d508a1259 Attributes for code fences should be placed after the lang indicator only c80905cef deps: Update to esbuild v0.9.0 95350eb79 Add support for Google Analytics v4 02d36f9bc Allow markdown attribute lists to be used in title render hooks 7df220a64 Merge commit '9d31f650da964a52f05fc27b7fb99cf3e09778cf' d80bf61b7 Fixes #7698. git-subtree-dir: docs git-subtree-split: fb551cc750faa83a1493b0e0d0898cd98ab74465
140 lines
4.5 KiB
Markdown
140 lines
4.5 KiB
Markdown
---
|
||
title: Hugo and the General Data Protection Regulation (GDPR)
|
||
linktitle: Hugo and GDPR
|
||
description: About how to configure your Hugo site to meet the new regulations.
|
||
date: 2018-05-25
|
||
layout: single
|
||
keywords: ["GDPR", "Privacy", "Data Protection"]
|
||
menu:
|
||
docs:
|
||
parent: "about"
|
||
weight: 5
|
||
weight: 5
|
||
sections_weight: 5
|
||
draft: false
|
||
aliases: [/privacy/,/gdpr/]
|
||
toc: true
|
||
---
|
||
|
||
|
||
General Data Protection Regulation ([GDPR](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation)) is a regulation in EU law on data protection and privacy for all individuals within the European Union and the European Economic Area. It became enforceable on 25 May 2018.
|
||
|
||
**Hugo is a static site generator. By using Hugo you are already standing on very solid ground. Static HTML files on disk are much easier to reason about compared to server and database driven web sites.**
|
||
|
||
But even static websites can integrate with external services, so from version `0.41`, Hugo provides a **Privacy Config** that covers the relevant built-in templates.
|
||
|
||
Note that:
|
||
|
||
* These settings have their defaults setting set to _off_, i.e. how it worked before Hugo `0.41`. You must do your own evaluation of your site and apply the appropriate settings.
|
||
* These settings work with the [internal templates](/templates/internal/). Some theme may contain custom templates for embedding services like Google Analytics. In that case these options have no effect.
|
||
* We will continue this work and improve this further in future Hugo versions.
|
||
|
||
## All Privacy Settings
|
||
|
||
Below are all privacy settings and their default value. These settings need to be put in your site config (e.g. `config.toml`).
|
||
|
||
{{< code-toggle file="config">}}
|
||
[privacy]
|
||
[privacy.disqus]
|
||
disable = false
|
||
[privacy.googleAnalytics]
|
||
disable = false
|
||
respectDoNotTrack = false
|
||
anonymizeIP = false
|
||
useSessionStorage = false
|
||
[privacy.instagram]
|
||
disable = false
|
||
simple = false
|
||
[privacy.twitter]
|
||
disable = false
|
||
enableDNT = false
|
||
simple = false
|
||
[privacy.vimeo]
|
||
disable = false
|
||
enableDNT = false
|
||
simple = false
|
||
[privacy.youtube]
|
||
disable = false
|
||
privacyEnhanced = false
|
||
{{< /code-toggle >}}
|
||
|
||
|
||
## Disable All Services
|
||
|
||
An example Privacy Config that disables all the relevant services in Hugo. With this configuration, the other settings will not matter.
|
||
|
||
{{< code-toggle file="config">}}
|
||
[privacy]
|
||
[privacy.disqus]
|
||
disable = true
|
||
[privacy.googleAnalytics]
|
||
disable = true
|
||
[privacy.instagram]
|
||
disable = true
|
||
[privacy.twitter]
|
||
disable = true
|
||
[privacy.vimeo]
|
||
disable = true
|
||
[privacy.youtube]
|
||
disable = true
|
||
{{< /code-toggle >}}
|
||
|
||
## The Privacy Settings Explained
|
||
|
||
### GoogleAnalytics
|
||
|
||
anonymizeIP
|
||
: Enabling this will make it so the users' IP addresses are anonymized within Google Analytics.
|
||
|
||
respectDoNotTrack
|
||
: Enabling this will make the GA templates respect the "Do Not Track" HTTP header.
|
||
|
||
useSessionStorage
|
||
: Enabling this will disable the use of Cookies and use Session Storage to Store the GA Client ID.
|
||
|
||
{{% warning %}}
|
||
`useSessionStorage` is not supported when using Google Analytics v4 (gtag.js).
|
||
{{% /warning %}}
|
||
### Instagram
|
||
|
||
simple
|
||
: If simple mode is enabled, a static and no-JS version of the Instagram image card will be built. Note that this only supports image cards and the image itself will be fetched from Instagram's servers.
|
||
|
||
**Note:** If you use the _simple mode_ for Instagram and a site styled with Bootstrap 4, you may want to disable the inline styles provided by Hugo:
|
||
|
||
{{< code-toggle file="config">}}
|
||
[services]
|
||
[services.instagram]
|
||
disableInlineCSS = true
|
||
{{< /code-toggle >}}
|
||
|
||
### Twitter
|
||
|
||
enableDNT
|
||
: Enabling this for the twitter/tweet shortcode, the tweet and its embedded page on your site are not used for purposes that include personalized suggestions and personalized ads.
|
||
|
||
simple
|
||
: If simple mode is enabled, a static and no-JS version of a tweet will be built.
|
||
|
||
|
||
**Note:** If you use the _simple mode_ for Twitter, you may want to disable the inlines styles provided by Hugo:
|
||
|
||
{{< code-toggle file="config">}}
|
||
[services]
|
||
[services.twitter]
|
||
disableInlineCSS = true
|
||
{{< /code-toggle >}}
|
||
|
||
### YouTube
|
||
|
||
privacyEnhanced
|
||
: When you turn on privacy-enhanced mode, YouTube won’t store information about visitors on your website unless the user plays the embedded video.
|
||
|
||
### Vimeo
|
||
|
||
enableDNT
|
||
: Enabling this for the vimeo shortcode, the Vimeo player will be blocked from tracking any session data, including all cookies and stats.
|
||
|
||
simple
|
||
: If simple mode is enabled, the video thumbnail is fetched from Vimeo's servers and it is overlayed with a play button. If the user clicks to play the video, it will open in a new tab directly on Vimeo's website.
|
||
|