Use msgcat to avoid word-wrapping in .po files

This commit is contained in:
Slavi Pantaleev
2024-12-20 14:33:31 +02:00
parent 36429d8bd3
commit 71e5f1103d
269 changed files with 8438 additions and 39279 deletions

View File

@ -25,9 +25,7 @@ msgid "Synapse maintenance"
msgstr ""
#: ../../../docs/maintenance-synapse.md:3
msgid ""
"This document shows you how to perform various maintenance tasks related "
"to the Synapse chat server."
msgid "This document shows you how to perform various maintenance tasks related to the Synapse chat server."
msgstr ""
#: ../../../docs/maintenance-synapse.md:5
@ -35,22 +33,15 @@ msgid "Table of contents:"
msgstr ""
#: ../../../docs/maintenance-synapse.md:7
msgid ""
"[Purging old data with the Purge History API](#purging-old-data-with-the-"
"purge-history-api), for when you wish to delete in-use (but old) data "
"from the Synapse database"
msgid "[Purging old data with the Purge History API](#purging-old-data-with-the-purge-history-api), for when you wish to delete in-use (but old) data from the Synapse database"
msgstr ""
#: ../../../docs/maintenance-synapse.md:9
msgid ""
"[Compressing state with rust-synapse-compress-state](#compressing-state-"
"with-rust-synapse-compress-state)"
msgid "[Compressing state with rust-synapse-compress-state](#compressing-state-with-rust-synapse-compress-state)"
msgstr ""
#: ../../../docs/maintenance-synapse.md:11
msgid ""
"[Browse and manipulate the database](#browse-and-manipulate-the-"
"database), for when you really need to take matters into your own hands"
msgid "[Browse and manipulate the database](#browse-and-manipulate-the-database), for when you really need to take matters into your own hands"
msgstr ""
#: ../../../docs/maintenance-synapse.md:13
@ -62,42 +53,23 @@ msgid "Purging old data with the Purge History API"
msgstr ""
#: ../../../docs/maintenance-synapse.md:17
msgid ""
"You can use the **[Purge History API](https://github.com/element-"
"hq/synapse/blob/master/docs/admin_api/purge_history_api.md)** to delete "
"old messages on a per-room basis. **This is destructive** (especially for"
" non-federated rooms), because it means **people will no longer have "
"access to history past a certain point**."
msgid "You can use the **[Purge History API](https://github.com/element-hq/synapse/blob/master/docs/admin_api/purge_history_api.md)** to delete old messages on a per-room basis. **This is destructive** (especially for non-federated rooms), because it means **people will no longer have access to history past a certain point**."
msgstr ""
#: ../../../docs/maintenance-synapse.md:19
msgid ""
"To make use of this Synapse Admin API, **you'll need an admin access "
"token** first. Refer to the documentation on [how to obtain an access "
"token](obtaining-access-tokens.md)."
msgid "To make use of this Synapse Admin API, **you'll need an admin access token** first. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/maintenance-synapse.md:21
msgid ""
"Synapse's Admin API is not exposed to the internet by default, following "
"[official Synapse reverse-proxying recommendations](https://github.com"
"/element-hq/synapse/blob/master/docs/reverse_proxy.md#synapse-"
"administration-endpoints). To expose it you will need to add "
"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
" true` to your `vars.yml` file."
msgid "Synapse's Admin API is not exposed to the internet by default, following [official Synapse reverse-proxying recommendations](https://github.com/element-hq/synapse/blob/master/docs/reverse_proxy.md#synapse-administration-endpoints). To expose it you will need to add `matrix_synapse_container_labels_public_client_synapse_admin_api_enabled: true` to your `vars.yml` file."
msgstr ""
#: ../../../docs/maintenance-synapse.md:23
msgid ""
"Follow the [Purge History API](https://github.com/element-"
"hq/synapse/blob/master/docs/admin_api/purge_history_api.md) documentation"
" page for the actual purging instructions."
msgid "Follow the [Purge History API](https://github.com/element-hq/synapse/blob/master/docs/admin_api/purge_history_api.md) documentation page for the actual purging instructions."
msgstr ""
#: ../../../docs/maintenance-synapse.md:25
msgid ""
"After deleting data, you may wish to run a [`FULL` Postgres `VACUUM"
"`](./maintenance-postgres.md#vacuuming-postgresql)."
msgid "After deleting data, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)."
msgstr ""
#: ../../../docs/maintenance-synapse.md:27
@ -105,27 +77,15 @@ msgid "Compressing state with rust-synapse-compress-state"
msgstr ""
#: ../../../docs/maintenance-synapse.md:29
msgid ""
"[rust-synapse-compress-state](https://github.com/matrix-org/rust-synapse-"
"compress-state) can be used to optimize some `_state` tables used by "
"Synapse. If your server participates in large rooms this is the most "
"effective way to reduce the size of your database."
msgid "[rust-synapse-compress-state](https://github.com/matrix-org/rust-synapse-compress-state) can be used to optimize some `_state` tables used by Synapse. If your server participates in large rooms this is the most effective way to reduce the size of your database."
msgstr ""
#: ../../../docs/maintenance-synapse.md:31
msgid ""
"**Note**: besides running the `rust-synapse-compress-state` tool "
"manually, you can also enable its `synapse-auto-compressor` tool by "
"[Setting up synapse-auto-compressor](configuring-playbook-synapse-auto-"
"compressor.md). The automatic tool will run on a schedule every day and "
"you won't have to compress state manually ever again."
msgid "**Note**: besides running the `rust-synapse-compress-state` tool manually, you can also enable its `synapse-auto-compressor` tool by [Setting up synapse-auto-compressor](configuring-playbook-synapse-auto-compressor.md). The automatic tool will run on a schedule every day and you won't have to compress state manually ever again."
msgstr ""
#: ../../../docs/maintenance-synapse.md:33
msgid ""
"`rust-synapse-compress-state` should be safe to use (even when Synapse is"
" running), but it's always a good idea to [make Postgres backups"
"](./maintenance-postgres.md#backing-up-postgresql) first."
msgid "`rust-synapse-compress-state` should be safe to use (even when Synapse is running), but it's always a good idea to [make Postgres backups](./maintenance-postgres.md#backing-up-postgresql) first."
msgstr ""
#: ../../../docs/maintenance-synapse.md:35
@ -133,23 +93,15 @@ msgid "To ask the playbook to run rust-synapse-compress-state, execute:"
msgstr ""
#: ../../../docs/maintenance-synapse.md:41
msgid ""
"The shortcut command with `just` program is also available: `just run-"
"tags rust-synapse-compress-state`"
msgid "The shortcut command with `just` program is also available: `just run-tags rust-synapse-compress-state`"
msgstr ""
#: ../../../docs/maintenance-synapse.md:43
msgid ""
"By default, all rooms with more than `100000` state group rows will be "
"compressed. If you need to adjust this, pass: `--extra-"
"vars='matrix_synapse_rust_synapse_compress_state_min_state_groups_required=SOME_NUMBER_HERE'`"
" to the command above."
msgid "By default, all rooms with more than `100000` state group rows will be compressed. If you need to adjust this, pass: `--extra-vars='matrix_synapse_rust_synapse_compress_state_min_state_groups_required=SOME_NUMBER_HERE'` to the command above."
msgstr ""
#: ../../../docs/maintenance-synapse.md:45
msgid ""
"After state compression, you may wish to run a [`FULL` Postgres `VACUUM"
"`](./maintenance-postgres.md#vacuuming-postgresql)."
msgid "After state compression, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)."
msgstr ""
#: ../../../docs/maintenance-synapse.md:47
@ -157,46 +109,27 @@ msgid "Browse and manipulate the database"
msgstr ""
#: ../../../docs/maintenance-synapse.md:49
msgid ""
"When the [Synapse Admin API](https://github.com/element-"
"hq/synapse/tree/master/docs/admin_api) and the other tools do not provide"
" a more convenient way, having a look at synapse's postgresql database "
"can satisfy a lot of admins' needs."
msgid "When the [Synapse Admin API](https://github.com/element-hq/synapse/tree/master/docs/admin_api) and the other tools do not provide a more convenient way, having a look at synapse's postgresql database can satisfy a lot of admins' needs."
msgstr ""
#: ../../../docs/maintenance-synapse.md:51
msgid ""
"Editing the database manually is not recommended or supported by the "
"Synapse developers. If you are going to do so you should [make a database"
" backup](./maintenance-postgres.md#backing-up-postgresql)."
msgid "Editing the database manually is not recommended or supported by the Synapse developers. If you are going to do so you should [make a database backup](./maintenance-postgres.md#backing-up-postgresql)."
msgstr ""
#: ../../../docs/maintenance-synapse.md:53
msgid ""
"First, set up an SSH tunnel to your Matrix server (skip if it is your "
"local machine):"
msgid "First, set up an SSH tunnel to your Matrix server (skip if it is your local machine):"
msgstr ""
#: ../../../docs/maintenance-synapse.md:60
msgid ""
"Then start up an ephemeral [adminer](https://www.adminer.org/) container "
"on the Matrix server, connecting it to the `matrix` network and linking "
"the postgresql container:"
msgid "Then start up an ephemeral [adminer](https://www.adminer.org/) container on the Matrix server, connecting it to the `matrix` network and linking the postgresql container:"
msgstr ""
#: ../../../docs/maintenance-synapse.md:66
msgid ""
"You should then be able to browse the adminer database administration GUI"
" at http://localhost:1799/ after entering your DB credentials (found in "
"the `host_vars` or on the server in "
"`{{matrix_synapse_config_dir_path}}/homeserver.yaml` under "
"`database.args`)"
msgid "You should then be able to browse the adminer database administration GUI at http://localhost:1799/ after entering your DB credentials (found in the `host_vars` or on the server in `{{matrix_synapse_config_dir_path}}/homeserver.yaml` under `database.args`)"
msgstr ""
#: ../../../docs/maintenance-synapse.md:68
msgid ""
"⚠️️ Be **very careful** with this, there is **no undo** for impromptu DB "
"operations."
msgid "⚠️️ Be **very careful** with this, there is **no undo** for impromptu DB operations."
msgstr ""
#: ../../../docs/maintenance-synapse.md:70
@ -204,28 +137,15 @@ msgid "Make Synapse faster"
msgstr ""
#: ../../../docs/maintenance-synapse.md:72
msgid ""
"Synapse's presence feature which tracks which users are online and which "
"are offline can use a lot of processing power. You can disable presence "
"by adding `matrix_synapse_presence_enabled: false` to your `vars.yml` "
"file."
msgid "Synapse's presence feature which tracks which users are online and which are offline can use a lot of processing power. You can disable presence by adding `matrix_synapse_presence_enabled: false` to your `vars.yml` file."
msgstr ""
#: ../../../docs/maintenance-synapse.md:74
msgid ""
"If you have enough compute resources (CPU & RAM), you can make Synapse "
"better use of them by [enabling load-balancing with workers](configuring-"
"playbook-synapse.md#load-balancing-with-workers)."
msgid "If you have enough compute resources (CPU & RAM), you can make Synapse better use of them by [enabling load-balancing with workers](configuring-playbook-synapse.md#load-balancing-with-workers)."
msgstr ""
#: ../../../docs/maintenance-synapse.md:76
msgid ""
"[Tuning your PostgreSQL database](maintenance-postgres.md#tuning-"
"postgresql) could also improve Synapse performance. The playbook tunes "
"the integrated Postgres database automatically, but based on your needs "
"you may wish to adjust tuning variables manually. If you're using an "
"[external Postgres database](configuring-playbook-external-postgres.md), "
"you will also need to tune Postgres manually."
msgid "[Tuning your PostgreSQL database](maintenance-postgres.md#tuning-postgresql) could also improve Synapse performance. The playbook tunes the integrated Postgres database automatically, but based on your needs you may wish to adjust tuning variables manually. If you're using an [external Postgres database](configuring-playbook-external-postgres.md), you will also need to tune Postgres manually."
msgstr ""
#: ../../../docs/maintenance-synapse.md:78
@ -233,44 +153,27 @@ msgid "Tuning caches and cache autotuning"
msgstr ""
#: ../../../docs/maintenance-synapse.md:80
msgid ""
"Tuning Synapse's cache factor is useful for performance increases but "
"also as part of controlling Synapse's memory use. Use the variable "
"`matrix_synapse_caches_global_factor` to set the cache factor as part of "
"this process."
msgid "Tuning Synapse's cache factor is useful for performance increases but also as part of controlling Synapse's memory use. Use the variable `matrix_synapse_caches_global_factor` to set the cache factor as part of this process."
msgstr ""
#: ../../../docs/maintenance-synapse.md:82
msgid ""
"**The playbook defaults the global cache factor to a large value** (e.g. "
"`10`). A smaller value (e.g. `0.5`) will decrease the amount used for "
"caches, but will [not necessarily decrease RAM usage as a "
"whole](https://github.com/matrix-org/synapse/issues/3939)."
msgid "**The playbook defaults the global cache factor to a large value** (e.g. `10`). A smaller value (e.g. `0.5`) will decrease the amount used for caches, but will [not necessarily decrease RAM usage as a whole](https://github.com/matrix-org/synapse/issues/3939)."
msgstr ""
#: ../../../docs/maintenance-synapse.md:84
msgid ""
"Tuning the cache factor is useful only to a limited degree (as its crude "
"to do in isolation) and therefore users who are tuning their cache factor"
" should likely look into tuning autotune variables as well (see below)."
msgid "Tuning the cache factor is useful only to a limited degree (as its crude to do in isolation) and therefore users who are tuning their cache factor should likely look into tuning autotune variables as well (see below)."
msgstr ""
#: ../../../docs/maintenance-synapse.md:86
msgid ""
"Cache autotuning is **enabled by default** and controlled via the "
"following variables:"
msgid "Cache autotuning is **enabled by default** and controlled via the following variables:"
msgstr ""
#: ../../../docs/maintenance-synapse.md:88
msgid ""
"`matrix_synapse_cache_autotuning_max_cache_memory_usage` - defaults to "
"1/8 of total RAM with a cap of 2GB; values are specified in bytes"
msgid "`matrix_synapse_cache_autotuning_max_cache_memory_usage` - defaults to 1/8 of total RAM with a cap of 2GB; values are specified in bytes"
msgstr ""
#: ../../../docs/maintenance-synapse.md:89
msgid ""
"`matrix_synapse_cache_autotuning_target_cache_memory_usage` - defaults to"
" 1/16 of total RAM with a cap of 1GB; values are specified in bytes"
msgid "`matrix_synapse_cache_autotuning_target_cache_memory_usage` - defaults to 1/16 of total RAM with a cap of 1GB; values are specified in bytes"
msgstr ""
#: ../../../docs/maintenance-synapse.md:90
@ -278,12 +181,7 @@ msgid "`matrix_synapse_cache_autotuning_min_cache_ttl` - defaults to `30s`"
msgstr ""
#: ../../../docs/maintenance-synapse.md:92
msgid ""
"You can **learn more about cache-autotuning and the global cache factor "
"settings** in the [Synapse's documentation on caches and associated "
"values](https://matrix-"
"org.github.io/synapse/latest/usage/configuration/config_documentation.html"
"#caches-and-associated-values)."
msgid "You can **learn more about cache-autotuning and the global cache factor settings** in the [Synapse's documentation on caches and associated values](https://matrix-org.github.io/synapse/latest/usage/configuration/config_documentation.html#caches-and-associated-values)."
msgstr ""
#: ../../../docs/maintenance-synapse.md:94
@ -291,19 +189,9 @@ msgid "To **disable cache auto-tuning**, unset all values:"
msgstr ""
#: ../../../docs/maintenance-synapse.md:102
msgid ""
"Users who wish to lower Synapse's RAM footprint should look into lowering"
" the global cache factor and tweaking the autotune variables (or "
"disabling auto-tuning). If your cache factor is too low for a given auto "
"tune setting your caches will not reach autotune thresholds and autotune "
"won't be able to do its job. Therefore, when auto-tuning is enabled "
"(which it is by default), it's recommended to have your cache factor be "
"large."
msgid "Users who wish to lower Synapse's RAM footprint should look into lowering the global cache factor and tweaking the autotune variables (or disabling auto-tuning). If your cache factor is too low for a given auto tune setting your caches will not reach autotune thresholds and autotune won't be able to do its job. Therefore, when auto-tuning is enabled (which it is by default), it's recommended to have your cache factor be large."
msgstr ""
#: ../../../docs/maintenance-synapse.md:104
msgid ""
"See also [How do I optimize this setup for a low-power server?](faq.md"
"#how-do-i-optimize-this-setup-for-a-low-power-server)."
msgid "See also [How do I optimize this setup for a low-power server?](faq.md#how-do-i-optimize-this-setup-for-a-low-power-server)."
msgstr ""