Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove admonition section from translation #2436

Merged
merged 1 commit into from
Mar 13, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
7 changes: 5 additions & 2 deletions docs/about/criteria.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,12 @@
title: General Criteria
---

!!! example "Work in Progress"
<div class="admonition example" markdown>
<p class="admonition-title">Work in Progress</p>

The following page is a work in progress, and does not reflect the full criteria for our recommendations at this time. Past discussion on this topic: [#24](https://github.com/privacyguides/privacyguides.org/discussions/24)
The following page is a work in progress, and does not reflect the full criteria for our recommendations at this time. Past discussion on this topic: [#24](https://github.com/privacyguides/privacyguides.org/discussions/24)

</div>

Below are some things that must apply to all submissions to Privacy Guides. Each category will have additional requirements for inclusion.

Expand Down
6 changes: 4 additions & 2 deletions docs/about/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,9 +86,11 @@ Our team members review all changes made to the website and handle administrativ

## Site License

!!! danger ""
<div class="admonition danger" markdown>

The following is a human-readable summary of (and not a substitute for) the [license](/license).
The following is a human-readable summary of (and not a substitute for) the [license](/license).

</div>

:fontawesome-brands-creative-commons: :fontawesome-brands-creative-commons-by: :fontawesome-brands-creative-commons-nd: Unless otherwise noted, the original content on this website is made available under the [Creative Commons Attribution-NoDerivatives 4.0 International Public License](https://github.com/privacyguides/privacyguides.org/blob/main/LICENSE). This means that you are free to copy and redistribute the material in any medium or format for any purpose, even commercially; as long as you give appropriate credit to `Privacy Guides (www.privacyguides.org)` and provide a link to the license. You may do so in any reasonable manner, but not in any way that suggests Privacy Guides endorses you or your use. If you remix, transform, or build upon the content of this website, you may not distribute the modified material.

Expand Down
6 changes: 4 additions & 2 deletions docs/about/notices.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,11 @@ Privacy Guides additionally does not warrant that this website will be constantl

## Licensing Overview

!!! danger ""
<div class="admonition danger" markdown>

The following is a human-readable summary of (and not a substitute for) the [license](/license).
The following is a human-readable summary of (and not a substitute for) the [license](/license).

</div>

Unless otherwise noted, all **content** on this website is made available under the terms of the [Creative Commons Attribution-NoDerivatives 4.0 International Public License](https://github.com/privacyguides/privacyguides.org/blob/main/LICENSE). The underlying **source code** used to generate this website and display that content is released under the [MIT License](https://github.com/privacyguides/privacyguides.org/tree/main/LICENSE-CODE).

Expand Down
2 changes: 1 addition & 1 deletion docs/basics/threat-modeling.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@ Making a security plan will help you to understand the threats that are unique t

## Further Reading

For people looking to increase their privacy and security online, we've compiled a list of common threats our visitors face or goals our visitors have, to give you some inspiration and demonstrate the basis of our recommendations.
For people looking to increase their privacy and security online, we've compiled a list of common threats our visitors face or goals our visitors have, to give you some inspiration and demonstrate the basis of our recommendations.

- [Common Goals and Threats :material-arrow-right-drop-circle:](common-threats.md)

Expand Down
48 changes: 0 additions & 48 deletions docs/meta/translations.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,54 +8,6 @@ Please join our localization room on Matrix ([#pg-i18n:aragon.sh](https://matrix

Note that the English version of the site is the primary version, meaning changes occur there first. If you notice a language falling behind the English version, please help out. We cannot guarantee the accuracy of all our translations. If you have a suggestion about content specific to your region, please open an issue or pull request to our [main repository](https://github.com/privacyguides/privacyguides.org).

## Admonitions

Throughout the site we use MkDocs's [admonitions](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#usage), to show information to readers. They come in a few different flavors such as `example`, `warning`, `tip`, etc.

When admonitions are used they will have an English string on the site by default. This can be [customized](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#changing-the-title), without too much effort. For example, if you were translating an admonition of type [`warning`](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#type:warning) to Dutch, this is how you would write it:

=== "Dutch translation"

```text
!!! warning "Waarschuwing"
```

=== "English source text"

```text
!!! warning
```

Downloads are a [custom admonition](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#custom-admonitions) which is written as follows:

=== "Dutch translation"

```text
??? downloads "Downloaden"
```

=== "English source text"

```text
??? downloads
```

The same goes for other types, such as `tip`, `example`, `warning`, `danger` etc.

Recommendations are a special type of admonition which do **not** need overriding as they have no visible text, so they are never changed:

=== "Dutch translation"

```text
!!! recommendation
```

=== "English source text"

```text
!!! recommendation
```

## Translation output

Translation software gets the translation quite accurate; however, you need to make sure the translated string is correct.
Expand Down