# Privacy Guides Is Now Multilingual

**URL:** https://discuss.privacyguides.net/t/privacy-guides-is-now-multilingual/11939
**Category:** Articles
**Created:** 2023-03-01T01:24:53Z
**Posts:** 8

## Post 1 by @privacyguides — 2023-03-01T01:24:53Z

![Privacy Guides Is Now Multilingual](//forum-uploads.privacyguidesusercontent.com/original/2X/7/784d28f62a76ddd58b8dc380b2e09c7787c17b49.jpeg)

It's finally here. After countless requests, Privacy Guides now has translations.

People have always asked us for translations to other languages because our team and community produces high quality, reliable, honest, and researched content. Our [previous site](https://blog.privacyguides.org/2021/09/14/welcome-to-privacy-guides) never had a system for this. All translations were done manually, and translators would quickly lose interest. Translated sites would be outdated and lay unmaintained on domains that we didn't own. Privacy Guides now has a proper system.

Our site runs [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/), which supports [internationalization](https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/). This allows us to provide language specific content without the mammoth effort previously required.

## What we're planning

You can expect translations of this blog – and lots more content. We will add languages to the site when they near completion. That way they can be checked to make sure they maintain the high quality that people have come to expect from the rest of Privacy Guides.

### Translators

We'd also like to remind everyone you can stay up to date with the main site by looking at [our release page](https://github.com/privacyguides/privacyguides.org/releases), this will show major changes to the main content. You can subscribe with a [News Aggregator](https://www.privacyguides.org/news-aggregators):

- [privacyguides.org (Releases)](https://github.com/privacyguides/privacyguides.org/releases.atom).
- [privacyguides.org (Commit log)](https://github.com/privacyguides/privacyguides.org/commits/main.atom)
- [blog.privacyguides.org](https://blog.privacyguides.org/feed_rss_created.xml)
- [blog.privacyguides.org (Commit log)](https://github.com/privacyguides/blog.privacyguides.org/commits/main.atom)

The blog doesn't have releases, but articles are generally published in a complete state and only updated with minor changes.

Feel free to check out our localization room on Matrix [#pg-i18n:aragon.sh](https://matrix.to/#/%23pg-i18n:aragon.sh) if you have any questions on getting started. You can [find us on Crowdin](https://crowdin.com/project/privacyguides).

Please note that the English version of the site is the primary version, meaning changes occur there first. This means it is still possible that specific languages may be behind. If you notice such an instance 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).

#### Some tips for translators

Crowdin has good documentation and we suggest looking at their [Getting Started](https://support.crowdin.com/crowdin-intro/) guide. Our site is in [Markdown](https://en.wikipedia.org/wiki/Markdown), so it should be easy to chip in.

#### Admonitions

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

By default when admonitions are used they will have an English string on the site. 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 and admonition of type [warning](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#type:warning) to Dutch, this is how you would write it:

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

Downloads are a [custom admonition](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#custom-admonitions) that we use and you would write that like:

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

The same goes for other types, such as `tip`, `example` etc. Recommendations are also admonitions, but they do not need overriding, because the default has no text, so they are always:

```
!!! recommendation
```

#### Translation software

Translation software gets the translation quite reliable. We've found [DeepL](https://www.deepl.com/en/translator) works well however, attention does need to be given that the translated string is correct.

For example:

```
![Software logo](assets/img/path/to/image.svg){ align=right }
```

We have sometimes found that the syntax for inserting an image like above was missing the `![` or an extra space was placed between the text and the path, eg `](`. If a translation string is clearly not correct, we encourage you to **delete** it by pressing the trash icon [or vote](https://support.crowdin.com/enterprise/getting-started-for-volunteers/#voting-view) which one you think sounds best. When invalid strings are deleted they are removed from the organization's [translation memory](https://support.crowdin.com/enterprise/translation-memory), meaning that when the source string is seen again, it won't suggest the incorrect translation.

We'd like to thank the [translation team](https://crowdin.com/project/privacyguides/reports/top-members) who spent many hours on translating the content, that we now have. We're going to launch in Dutch, French and Hebrew.

* * *
This is a companion discussion topic for the original entry at [https://blog.privacyguides.org/2023/02/26/i18n-announcement/](https://blog.privacyguides.org/2023/02/26/i18n-announcement/)

---

## Post 2 by @Niek-de-Wilde — 2023-02-27T17:19:38Z

Congrats to all the translators!

---

## Post 3 by @bloatline — 2023-03-10T06:19:43Z

I would like to contribute and translate to my language, which is kurdish. But it isn’t added to the Crowdin, and the matrix room registration has been closed. Does this mean new languages won’t be added?

---

## Post 4 by @anonymous38 — 2023-03-10T14:22:37Z

Will privacy guides also support Arabic latter

---

## Post 6 by @bloatline — 2023-03-10T14:53:14Z

The Crowdin project already includes Arabic, and some translation work has begun..

---

## Post 7 by @dngray — 2023-03-10T15:33:29Z

> [@Nawdare](#):
>
> But it isn’t added to the Crowdin, and the matrix room registration has been closed

You should be able to join the matrix room `/join #pg-i18n:aragon.sh` will join you. It’s also in the Privacy Guides space.

> [@Nawdare](#):
>
> I would like to contribute and translate to my language, which is kurdish

We’re adding new languages as translators come around to translate them. Once they are close to completion they will be added to the site.

As for Kurdish, there’s actually three of those in Crowdin. Those are:

- Kurdish
  - Kurmanji (Kurdish)
  - Sorani (Kurdish)

Also languages must be added to our framework first. See:

> **[Changing the language - Material for MkDocs](https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/)**
>
> Write your documentation in Markdown and create a professional static site in minutes – searchable, customizable, in 60+ languages, for all devices

Scroll down to the bit where it says “_Translations missing? Help us out, it takes only 5 minutes_”

---

## Post 8 by @bloatline — 2023-03-10T20:55:49Z

**Update**  
i’ve joined the matrix room, and wanted to translate to Kurdish (Sorani) which it has been added to the Crowdin project after following some instruction.

---

## Post 9 by @system — 2025-09-18T05:24:15Z



---

## Post 10 by @system — 2025-11-02T05:37:41Z


