diff --git a/README.md b/README.md index 056cc57a59..f56245ede2 100644 --- a/README.md +++ b/README.md @@ -119,6 +119,40 @@ Embedding videos with in-line HTML `iframe` tag does not work. instead. To embed an video simply type the following in markdown: `` (example). +### Embedding ToS checkbox + +A ToS acceptance checkbox can be added to any release page to gate binary +downloads behind a user acknowledgement. The feature is opt-in per page. + +**1. Add the checkbox macro** above the content you want to protect: + +```md +{{ tos_checkbox("unique-section-id") }} +``` + +**2. Wrap the protected content** in an HTML div with a matching `id`: + +```md +
+``` + +`tos_checkbox` accepts an optional `tos_url` argument to override the default +Terms of Service link: + +```md +{{ tos_checkbox("unique-section-id", tos_url="https://example.com/terms") }} +``` + +For pages with multiple release sections, use a distinct `section-id` per +release (e.g. `vendor-board-v100-binaries`, `vendor-board-v090-binaries`). See +[`docs/variants/gigabyte_mz33-ar1/releases.md`][tos-example] for example. + +[tos-example]: docs/variants/gigabyte_mz33-ar1/releases.md + ### Embedding subscribe forms It is possible to embed subscribe form for the selfhosted Listmonk mailing diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css index b2b0d03cbd..8ee88fe0e5 100644 --- a/docs/stylesheets/extra.css +++ b/docs/stylesheets/extra.css @@ -59,6 +59,30 @@ background-color: var(--md-accent-fg-color); } +.tos-gate { + border: 1px solid var(--md-default-fg-color--lighter); + border-radius: 0.2rem; + padding: 0.75rem 1rem; + margin: 1rem 0; + background-color: var(--md-code-bg-color); +} + +.tos-gate__label { + cursor: pointer; + font-size: 0.8rem; + line-height: 1.6; + color: var(--md-default-fg-color); +} + +.tos-gate__checkbox { + width: 1rem; + height: 1rem; + margin-right: 0.4rem; + vertical-align: middle; + cursor: pointer; + accent-color: var(--md-accent-fg-color); +} + .video-wrapper { position: relative; display: block; diff --git a/docs/variants/gigabyte_mz33-ar1/building-manual.md b/docs/variants/gigabyte_mz33-ar1/building-manual.md index 68c92da530..d6a340e211 100644 --- a/docs/variants/gigabyte_mz33-ar1/building-manual.md +++ b/docs/variants/gigabyte_mz33-ar1/building-manual.md @@ -15,9 +15,58 @@ MZ33-AR1. ## Building -!!! Error "STOP" +To build Dasharo (coreboot+UEFI) firmware image, first clone the coreboot +repository: - Building the firmware from source is currently only available after - purchasing the product from [our - shop](https://shop.3mdeb.com/product/full-build-gigabyte-mz33-ar1-with-dasharo-corebootuefi-pro-package-for-servers/) - and agreeing to the terms of service. +```bash +git clone https://github.com/Dasharo/coreboot.git +``` + +then follow the steps below: + +1. To build a specific version checkout to the version's tag. + Skip this step otherwise. + + ```bash + cd coreboot + git checkout gigabyte_mz33_ar1_