Skip to content

Commit f691fe0

Browse files
authored
Add notes to user/admin areas about translation basics (#1830)
1 parent 31e5fdd commit f691fe0

File tree

2 files changed

+14
-1
lines changed

2 files changed

+14
-1
lines changed

content/en/admin/config.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -772,11 +772,20 @@ Prefix for the OTEL service names. The services names will be `$prefix/web` and
772772

773773
What character to use in service names when differentiating between different services. Defaults to `/` (i.e. `mastodon/web`).
774774

775-
776775
#### `OTEL_EXPORTER_OTLP_ENDPOINT`
777776

778777
URL of the OLTP server to send the traces to. OpenTelemetry instrumentation is disabled if this variable is not set. No default (empty value).
779778

779+
### Translation services {#translation}
780+
781+
Mastodon supports integration with [DeepL] and [LibreTranslate] as backend language translation engines. Both services require separate setup and for configuration of Mastodon (via environment variables) to understand how to use them.
782+
783+
- DeepL needs `DEEPL_API_KEY` and `DEEPL_PLAN` (defaults to "free")
784+
- LibreTranslate needs `LIBRE_TRANSLATE_API_KEY` and `LIBRE_TRANSLATE_ENDPOINT`
785+
786+
[DeepL]: https://www.deepl.com
787+
[LibreTranslate]: https://libretranslate.com
788+
780789
## File storage {#files}
781790

782791
### CDN {#cdn}

content/en/user/network.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -125,3 +125,7 @@ Opening a list will load that list's timeline. List timelines contain only posts
125125
## Syndication Feeds {#syndication}
126126

127127
Every account and tag page provide an RSS feed for syndication onto other platforms. Those feeds are auto-discoverable from the account and tag pages.
128+
129+
## Translation
130+
131+
When a post is in a language other than what your account is set to understand, a "Translate" button will appear next to the post content. Clicking this button issues a request to translate the content to the server, and will replace that content with translated results. This feature requires the server to have configured support for a translation service, and so may not be available on all servers.

0 commit comments

Comments
 (0)