diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2024-02-04 15:33:40 -0700 |
|---|---|---|
| committer | Dan Allen <dan.j.allen@gmail.com> | 2024-02-04 15:33:40 -0700 |
| commit | 5cfd8adfdae60ca1168315a78999c80610c91568 (patch) | |
| tree | 0787af414d7b53711888165b6663fb6dc8fc7c50 | |
| parent | 323d288ea2915df702cbad23b311435e7c30f9b7 (diff) | |
add disclaimer about the use of Google Fonts in the output of the HTML converter
| -rw-r--r-- | docs/modules/html-backend/pages/index.adoc | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/modules/html-backend/pages/index.adoc b/docs/modules/html-backend/pages/index.adoc index bd416e1d..0bef296c 100644 --- a/docs/modules/html-backend/pages/index.adoc +++ b/docs/modules/html-backend/pages/index.adoc @@ -7,6 +7,13 @@ Asciidoctor's default output format is HTML. `html`:: The HTML 5 converter (`html` or `html5`) generates HTML 5 styled with CSS3. +WARNING: A standalone HTML document generated by the built-in HTML converter loads web fonts from Google Fonts, which are then referenced by the default stylesheet. +The xref:default-stylesheet.adoc[default stylesheet] makes use of web fonts to ensure the document renders consistently across platforms. +Concerns have been raised that Google Fonts do not comply with GDPR. +If this presents a problem, you can xref:default-stylesheet.adoc#disable-or-modify-the-web-fonts[opt out of the use of Google Fonts]. +When this is done, the default stylesheet reverts to using generic font families (e.g., sans-serif), which are mapped to system fonts by your browser. +The consequence is that the appearance of the document will be different and system dependent due to a reliance on system fonts. + == Generate HTML using the html5 converter In this section, we'll create a sample document, then process and convert it with Asciidoctor's built-in HTML converter. |