diff --git a/i18n/locales/bg/LC_MESSAGES/CHANGELOG.po b/i18n/locales/bg/LC_MESSAGES/CHANGELOG.po index d9f668a66..a6080952c 100644 --- a/i18n/locales/bg/LC_MESSAGES/CHANGELOG.po +++ b/i18n/locales/bg/LC_MESSAGES/CHANGELOG.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-22 17:53+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -4007,7 +4007,7 @@ msgid "We believe the steps below are safe and you won't encounter any data loss msgstr "" #: ../../../CHANGELOG.md:2195 -msgid "Generate a strong password to be used for your superuser Postgres user (called `matrix`). You can use `pwgen -s 64 1` to generate it, or some other tool. The **maximum length** for a Postgres password is 100 bytes (characters). Don't go crazy!" +msgid "Generate a strong password to be used for your superuser Postgres user (called `matrix`). You can create one with a command like `pwgen -s 64 1`. The **maximum length** for a Postgres password is 100 bytes (characters). Don't go crazy!" msgstr "" #: ../../../CHANGELOG.md:2197 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po index 7c6a635af..2c03e93ea 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -54,7 +54,7 @@ msgid "The playbook does not automatically create users for you. You **need to r msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:17 -msgid "Choose a strong password for the bot. You can generate a good password with a command like this: `pwgen -s 64 1`." +msgid "Generate a strong password for the bot. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:19 @@ -62,7 +62,7 @@ msgid "You can use the playbook to [register a new user](registering-users.md):" msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:25 -msgid "Get an access token" +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:27 @@ -70,97 +70,101 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:29 -msgid "Join to rooms as the bot manually" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:31 -msgid "ℹ️ **This bot does not accept room invitations automatically**. To deliver messages to rooms, the bot must be joined to all rooms manually." +msgid "Join to rooms as the bot manually" msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:33 -msgid "For each new room you would like the bot to deliver alerts to, invite the bot to the room." +msgid "ℹ️ **This bot does not accept room invitations automatically**. To deliver messages to rooms, the bot must be joined to all rooms manually." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:35 -msgid "Then, log in as the bot using any Matrix client of your choosing, accept the room invitation from the bot's account, and log out." +msgid "For each new room you would like the bot to deliver alerts to, invite the bot to the room." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:37 -msgid "Adjusting the playbook configuration" +msgid "Then, log in as the bot using any Matrix client of your choosing, accept the room invitation from the bot's account, and log out." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:39 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-token)." +msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:61 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:41 +msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:62 msgid "See `roles/custom/matrix-alertmanager-receiver/defaults/main.yml` for additional configuration variables." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:63 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:64 msgid "Adjusting the matrix-alertmanager-receiver URL" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:65 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:66 msgid "By default, this playbook installs matrix-alertmanager-receiver on the `matrix.` subdomain, at the `/matrix-alertmanager-receiver` path (https://matrix.example.com/matrix-alertmanager-receiver). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:68 msgid "By tweaking the `matrix_alertmanager_receiver_hostname` and `matrix_alertmanager_receiver_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:70 msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:77 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:78 msgid "Adjusting DNS records" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:79 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:80 msgid "If you've changed the default hostname, **you may need to adjust your DNS** records to point the matrix-alertmanager-receiver domain to the Matrix server." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:81 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:82 msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:83 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:84 msgid "If you've decided to use the default hostname, you won't need to do any extra DNS configuration." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:85 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:86 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:88 msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:94 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:95 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:96 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:97 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:98 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:99 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:100 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:101 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:102 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:103 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:104 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:105 msgid "Configure your Prometheus Alertmanager with configuration like this:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:123 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:124 msgid "where `URL_HERE` looks like `https://matrix.example.com/matrix-alertmanager-receiver-RANDOM_VALUE_HERE/alert/some-room-name` or `https://matrix.example.com/matrix-alertmanager-receiver-RANDOM_VALUE_HERE/alert/!qporfwt:example.com`." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-backup-borg.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-backup-borg.po index 8d90bc9eb..9940bcadd 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-backup-borg.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-backup-borg.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-22 17:53+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -98,7 +98,7 @@ msgid "REPO - BorgBackup repository name, it will be initialized on backup start msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:63 -msgid "PASSPHRASE - passphrase used for encrypting backups, you may generate it with `pwgen -s 64 1` or use any password manager" +msgid "PASSPHRASE - passphrase used for encrypting backups. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:64 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po index d135c0566..4c6509717 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -82,7 +82,7 @@ msgid "Base configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:33 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:71 @@ -389,7 +389,7 @@ msgid "Usage" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:386 -msgid "To use the bot, invite the `@baibot:example.com` bot user into a room." +msgid "To use the bot, invite it to any existing Matrix room (`/invite @baibot:example.com` where `example.com` is your base domain, not the `matrix.` domain)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:388 @@ -405,7 +405,7 @@ msgid "If you've [🤖 configured one or more agents via Ansible](#-configuring- msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:394 -msgid "Send `!bai help` to the room at any time to see the bot's help menu for additional commands." +msgid "Send `!bai help` to the bot in the room to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:396 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po index 1965840a5..55af029e1 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -38,7 +38,7 @@ msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:9 -msgid "To enable Buscarron, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:32 @@ -106,29 +106,37 @@ msgid "Usage" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:78 -msgid "To use the bot, invite the `@bot.buscarron:example.com` to the room you specified in a config, after that any point your form to the form url, example for the `contact` form:" +msgid "To use the bot, invite it to the room you specified on your `vars.yml` file (`/invite @bot.buscarron:example.com` where `example.com` is your base domain, not the `matrix.` domain)." msgstr "" -#: ../../../docs/configuring-playbook-bot-buscarron.md:86 -msgid "**Note**: to fight against spam, Buscarron is **very aggressive when it comes to banning** and will ban you if:" +#: ../../../docs/configuring-playbook-bot-buscarron.md:80 +msgid "After the bot joins the room, anyone can call the web form via HTTP POST method." msgstr "" -#: ../../../docs/configuring-playbook-bot-buscarron.md:88 -msgid "if you hit the homepage (HTTP `GET` request to `/`)" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-buscarron.md:89 -msgid "if you submit a form to the wrong URL (`POST` request to `/non-existing-form`)" +#: ../../../docs/configuring-playbook-bot-buscarron.md:82 +msgid "Here is an example for the `contact` form:" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:90 -msgid "if `hasemail` is enabled for the form (like in the example above) and you don't submit an `email` field" +msgid "**Note**: to fight against spam, Buscarron is **very aggressive when it comes to banning** and will ban you if:" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:92 -msgid "If you get banned, you'd need to restart the process by running the playbook with `--tags=start` or running `systemctl restart matrix-bot-buscarron` on the server." +msgid "you hit the homepage (HTTP `GET` request to `/`)" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-buscarron.md:93 +msgid "you submit a form to the wrong URL (`POST` request to `/non-existing-form`)" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:94 +msgid "`hasemail` is enabled for the form (like in the example above) and you don't submit an `email` field" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-buscarron.md:96 +msgid "If you get banned, you'd need to restart the process by running the playbook with `--tags=start` or running `systemctl restart matrix-bot-buscarron` on the server." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-buscarron.md:98 msgid "You can also refer to the upstream [documentation](https://github.com/etkecc/buscarron)." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po index 06ee33bc8..c54da193f 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -38,47 +38,55 @@ msgid "Talk to [ChatGPT](https://openai.com/blog/chatgpt/) via your favourite Ma msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:9 -msgid "Register the bot account" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:11 -msgid "The playbook does not automatically create users for you. The bot requires an access token to be able to connect to your homeserver." +msgid "Obtain an OpenAI API key" msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:13 -msgid "You **need to register the bot user manually** before setting up the bot." +msgid "To use the bot, you'd need to obtain an API key from [https://platform.openai.com/account/api-keys](https://platform.openai.com/account/api-keys)." msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:15 -msgid "Choose a strong password for the bot. You can generate a good password with a command like this: `pwgen -s 64 1`." +msgid "Register the bot account" msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:17 +msgid "The playbook does not automatically create users for you. You **need to register the bot user manually** before setting up the bot." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:19 +msgid "Generate a strong password for the bot. You can create one with a command like `pwgen -s 64 1`." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:21 msgid "You can use the playbook to [register a new user](registering-users.md):" msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:23 -msgid "Get an access token and create encryption keys" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-chatgpt.md:25 -msgid "Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." -msgstr "" - #: ../../../docs/configuring-playbook-bot-chatgpt.md:27 -msgid "To make sure the bot can read encrypted messages, it will need an encryption key, just like any other new user. While obtaining the access token, follow the prompts to setup a backup key. More information can be found in the [Element documentation](https://element.io/help#encryption6)." +msgid "Obtain an access token and create encryption keys" msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:29 -msgid "Adjusting the playbook configuration" +msgid "The bot requires an access token to be able to connect to your homeserver. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:31 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:52 -msgid "You will need to get tokens for ChatGPT." +#: ../../../docs/configuring-playbook-bot-chatgpt.md:33 +msgid "To make sure the bot can read encrypted messages, it will need an encryption key, just like any other new user. While obtaining the access token, follow the prompts to setup a backup key. More information can be found in the [Element documentation](https://element.io/help#encryption6)." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:35 +msgid "Adjusting the playbook configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:37 +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `API_KEY_HERE` with the API key retrieved [here](#obtain-an-openai-api-key) and `ACCESS_TOKEN_HERE` with the access token created [here](#obtain-an-access-token-and-create-encryption-keys), respectively." msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:54 @@ -110,9 +118,13 @@ msgid "Usage" msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:73 -msgid "To use the bot, invite the `@bot.chatgpt:example.com` to the room you specified in a config, after that start speaking to it, use the prefix if you configured one or mention the bot." +msgid "To use the bot, invite it to the room you specified on your `vars.yml` file (`/invite @bot.chatgpt:example.com` where `example.com` is your base domain, not the `matrix.` domain)." msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:75 +msgid "After the bot joins the room, you can send a message to it. When you do so, use the prefix if you configured it or mention the bot." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:77 msgid "You can also refer to the upstream [documentation](https://github.com/matrixgpt/matrix-chatgpt-bot)." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po index c0d39766e..bab221487 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -54,7 +54,7 @@ msgid "The playbook does not automatically create users for you. You **need to r msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:17 -msgid "Choose a strong password for the bot. You can generate a good password with a command like this: `pwgen -s 64 1`." +msgid "Generate a strong password for the bot. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:19 @@ -66,7 +66,7 @@ msgid "If you would like Draupnir to be able to deactivate users, move aliases, msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:27 -msgid "Get an access token" +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:29 @@ -74,309 +74,313 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:31 -msgid "Make sure the account is free from rate limiting" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:33 -msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Draupnir will crash.**" +msgid "Make sure the account is free from rate limiting" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:35 -msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Draupnir will crash.**" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:37 +msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:39 msgid "To expose the APIs publicly, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:43 +#: ../../../docs/configuring-playbook-bot-draupnir.md:45 msgid "The APIs can also be accessed via [Synapse Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can use to administrate users, rooms, media, etc. on your Matrix server. The playbook can install and configure Synapse Admin for you. For details about it, see [this page](configuring-playbook-synapse-admin.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:45 +#: ../../../docs/configuring-playbook-bot-draupnir.md:47 msgid "**Note**: access to the APIs is restricted with a valid access token, so exposing them publicly should not be a real security concern. Still, doing so is not recommended for additional security. See [official Synapse reverse-proxying recommendations](https://element-hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-endpoints)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:47 +#: ../../../docs/configuring-playbook-bot-draupnir.md:49 msgid "To discharge rate limiting, run the following command on systems that ship curl (note that it does not work on outdated Windows 10). Even if the APIs are not exposed to the internet, you should still be able to run the command on the homeserver locally. Before running it, make sure to replace `@bot.draupnir:example.com` with the MXID of your Draupnir:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:53 +#: ../../../docs/configuring-playbook-bot-draupnir.md:55 msgid "You can obtain an access token for a homeserver admin account in the same way as you can do so for Draupnir itself. If you have made Draupnir an admin, you can just use the Draupnir token." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:55 +#: ../../../docs/configuring-playbook-bot-draupnir.md:57 msgid "Create a management room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:57 +#: ../../../docs/configuring-playbook-bot-draupnir.md:59 msgid "Using your own account, create a new invite only room that you will use to manage the bot. This is the room where you will see the status of the bot and where you will send commands to the bot, such as the command to ban a user from another room. Anyone in this room can control the bot so it is important that you only invite trusted users to this room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:59 +#: ../../../docs/configuring-playbook-bot-draupnir.md:61 msgid "If you make the management room encrypted (E2EE), then you MUST enable and use Pantalaimon (see [below](#configuration-with-e2ee-support))." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:61 +#: ../../../docs/configuring-playbook-bot-draupnir.md:63 msgid "Once you have created the room you need to copy the room ID so you can tell the bot to use that room. In Element Web you can do this by going to the room's settings, clicking Advanced, and then copying the internal room ID. The room ID will look something like `!qporfwt:example.com`." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:63 +#: ../../../docs/configuring-playbook-bot-draupnir.md:65 msgid "Finally invite the `@bot.draupnir:example.com` account you created earlier into the room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:65 +#: ../../../docs/configuring-playbook-bot-draupnir.md:67 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:67 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `MANAGEMENT_ROOM_ID_HERE`." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-draupnir.md:76 -msgid "End-to-End Encryption support" +#: ../../../docs/configuring-playbook-bot-draupnir.md:69 +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `MANAGEMENT_ROOM_ID_HERE`." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:78 -msgid "Decide whether you want Draupnir to be capable of operating in end-to-end encrypted (E2EE) rooms. This includes the management room and the moderated rooms." +msgid "End-to-End Encryption support" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:80 -msgid "To support E2EE, Draupnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)." +msgid "Decide whether you want Draupnir to be capable of operating in end-to-end encrypted (E2EE) rooms. This includes the management room and the moderated rooms." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:82 -msgid "Configuration with E2EE support" +msgid "To support E2EE, Draupnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:84 -msgid "When using Pantalaimon, Draupnir will log in to its bot account itself through Pantalaimon, so configure its username and password." +msgid "Configuration with E2EE support" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:86 +msgid "When using Pantalaimon, Draupnir will log in to its bot account itself through Pantalaimon, so configure its username and password." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:88 msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:100 +#: ../../../docs/configuring-playbook-bot-draupnir.md:102 msgid "The playbook's `group_vars` will configure other required settings. If using this role separately without the playbook, you also need to configure the two URLs that Draupnir uses to reach the homeserver, one through Pantalaimon and one \"raw\". This example is taken from the playbook's `group_vars`:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:112 +#: ../../../docs/configuring-playbook-bot-draupnir.md:114 msgid "Configuration without E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:114 +#: ../../../docs/configuring-playbook-bot-draupnir.md:116 msgid "When NOT using Pantalaimon, Draupnir does not log in by itself and you must give it an access token for its bot account." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:116 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-token)." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-draupnir.md:122 -msgid "Abuse Reports" +#: ../../../docs/configuring-playbook-bot-draupnir.md:118 +msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:124 -msgid "Draupnir supports two methods to receive reports in the management room." +msgid "Abuse Reports" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:126 +msgid "Draupnir supports two methods to receive reports in the management room." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:128 msgid "The first method intercepts the report API endpoint of the client-server API, which requires integration with the reverse proxy in front of the homeserver. If you are using traefik, this playbook can set this up for you:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:132 +#: ../../../docs/configuring-playbook-bot-draupnir.md:134 msgid "The other method polls an Synapse Admin API endpoint, hence it is available only if using Synapse and if the Draupnir user is an admin (see [above](#register-the-bot-account)). To enable it, set `pollReports: true` on `vars.yml` file as below." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:134 +#: ../../../docs/configuring-playbook-bot-draupnir.md:136 msgid "Extending the configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:136 +#: ../../../docs/configuring-playbook-bot-draupnir.md:138 msgid "You can configure additional options by adding the `matrix_bot_draupnir_configuration_extension_yaml` variable." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:138 +#: ../../../docs/configuring-playbook-bot-draupnir.md:140 msgid "For example, to change Draupnir's `pollReports` option to `true`, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:152 +#: ../../../docs/configuring-playbook-bot-draupnir.md:154 msgid "Migrating from Mjolnir (Only required if migrating)" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:154 +#: ../../../docs/configuring-playbook-bot-draupnir.md:156 msgid "Replace your `matrix_bot_mjolnir` config with `matrix_bot_draupnir` config. Also disable Mjolnir if you're doing migration." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:156 +#: ../../../docs/configuring-playbook-bot-draupnir.md:158 msgid "That is all you need to do due to that Draupnir can complete migration on its own." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:158 +#: ../../../docs/configuring-playbook-bot-draupnir.md:160 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:160 +#: ../../../docs/configuring-playbook-bot-draupnir.md:162 msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:167 +#: ../../../docs/configuring-playbook-bot-draupnir.md:169 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:169 +#: ../../../docs/configuring-playbook-bot-draupnir.md:171 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:171 +#: ../../../docs/configuring-playbook-bot-draupnir.md:173 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:173 +#: ../../../docs/configuring-playbook-bot-draupnir.md:175 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:175 +#: ../../../docs/configuring-playbook-bot-draupnir.md:177 msgid "If you change the Pantalaimon's password (`matrix_bot_draupnir_pantalaimon_password` in your `vars.yml` file) subsequently, its credentials on the homeserver won't be updated automatically. If you'd like to change the password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_draupnir_pantalaimon_password` to let Pantalaimon know its new password." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:177 +#: ../../../docs/configuring-playbook-bot-draupnir.md:179 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:179 +#: ../../../docs/configuring-playbook-bot-draupnir.md:181 msgid "You can refer to the upstream [documentation](https://the-draupnir-project.github.io/draupnir-documentation/) for additional ways to use and configure Draupnir and for a more detailed usage guide." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:181 +#: ../../../docs/configuring-playbook-bot-draupnir.md:183 msgid "Below is a **non-exhaustive quick-start guide** for the impatient." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:183 +#: ../../../docs/configuring-playbook-bot-draupnir.md:185 msgid "Making Draupnir join and protect a room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:185 +#: ../../../docs/configuring-playbook-bot-draupnir.md:187 msgid "Draupnir can be told to self-join public rooms, but it's better to follow this flow which works well for all kinds of rooms:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:187 +#: ../../../docs/configuring-playbook-bot-draupnir.md:189 msgid "Invite the bot to the room manually ([inviting Draupnir to rooms](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#inviting-draupnir-to-rooms)). Before joining, the bot *may* ask for confirmation in the Management Room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:189 +#: ../../../docs/configuring-playbook-bot-draupnir.md:191 msgid "[Give the bot permissions to do its job](#giving-draupnir-permissions-to-do-its-job)" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:191 +#: ../../../docs/configuring-playbook-bot-draupnir.md:193 msgid "Tell it to protect the room (using the [rooms command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#using-the-draupnir-rooms-command)) by sending the following command to the Management Room: `!draupnir rooms add !qporfwt:example.com`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:193 +#: ../../../docs/configuring-playbook-bot-draupnir.md:195 msgid "To have Draupnir provide useful room protection, you need do to a bit more work (at least the first time around). You may wish to [Subscribe to a public policy list](#subscribing-to-a-public-policy-list), [Create your own own policy and rules](#creating-your-own-policy-lists-and-rules) and [Enabling built-in protections](#enabling-built-in-protections)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:195 +#: ../../../docs/configuring-playbook-bot-draupnir.md:197 msgid "Giving Draupnir permissions to do its job" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:197 +#: ../../../docs/configuring-playbook-bot-draupnir.md:199 msgid "For Draupnir to do its job, you need to [give it permissions](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#giving-draupnir-permissions) in rooms it's protecting. This involves **giving it an Administrator power level**." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:199 +#: ../../../docs/configuring-playbook-bot-draupnir.md:201 msgid "**We recommend setting this power level as soon as the bot joins your room** (and before you create new rules), so that it can apply rules as soon as they are available. If the bot is under-privileged, it may fail to apply protections and may not retry for a while (or until your restart it)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:201 +#: ../../../docs/configuring-playbook-bot-draupnir.md:203 msgid "Subscribing to a public policy list" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:203 +#: ../../../docs/configuring-playbook-bot-draupnir.md:205 msgid "We recommend **subscribing to a public [policy list](https://the-draupnir-project.github.io/draupnir-documentation/concepts/policy-lists)** using the [watch command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-watch-command-to-subscribe-to-policy-rooms)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:205 +#: ../../../docs/configuring-playbook-bot-draupnir.md:207 msgid "Polcy lists are maintained in Matrix rooms. A popular policy list is maintained in the public `#community-moderation-effort-bl:neko.dev` room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:207 +#: ../../../docs/configuring-playbook-bot-draupnir.md:209 msgid "You can tell Draupnir to subscribe to it by sending the following command to the Management Room: `!draupnir watch #community-moderation-effort-bl:neko.dev`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:209 +#: ../../../docs/configuring-playbook-bot-draupnir.md:211 msgid "Creating your own policy lists and rules" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:211 +#: ../../../docs/configuring-playbook-bot-draupnir.md:213 msgid "We also recommend **creating your own policy lists** with the [list create](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-list-create-command-to-create-a-policy-room) command." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:213 +#: ../../../docs/configuring-playbook-bot-draupnir.md:215 msgid "You can do so by sending the following command to the Management Room: `!draupnir list create my-bans my-bans-bl`. This will create a policy list having a name (shortcode) of `my-bans` and stored in a public `#my-bans-bl:example.com` room on your server. As soon as you run this command, the bot will invite you to the policy list room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:215 +#: ../../../docs/configuring-playbook-bot-draupnir.md:217 msgid "A policy list does nothing by itself, so the next step is **adding some rules to your policy list**. Policies target a so-called `entity` (one of: `user`, `room` or `server`). These entities are mentioned on the [policy lists](https://the-draupnir-project.github.io/draupnir-documentation/concepts/policy-lists) documentation page and in the Matrix Spec [here](https://spec.matrix.org/v1.11/client-server-api/#mban-recommendation)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:217 +#: ../../../docs/configuring-playbook-bot-draupnir.md:219 msgid "The simplest and most useful entity to target is `user`. Below are a few examples using the [ban command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-users#the-ban-command) and targeting users." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:219 +#: ../../../docs/configuring-playbook-bot-draupnir.md:221 msgid "To create rules, you run commands in the Management Room (**not** in the policy list room)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:221 +#: ../../../docs/configuring-playbook-bot-draupnir.md:223 msgid "(ban a single user on a given homeserver): `!draupnir ban @charles:example.com my-bans Rude to others`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:222 +#: ../../../docs/configuring-playbook-bot-draupnir.md:224 msgid "(ban all users on a given homeserver by using a [wildcard](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-users#wildcards)): `!draupnir ban @*:example.org my-bans Spam server - all users are fake`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:224 +#: ../../../docs/configuring-playbook-bot-draupnir.md:226 msgid "As a result of running these commands, you may observe:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:226 +#: ../../../docs/configuring-playbook-bot-draupnir.md:228 msgid "Draupnir creating `m.policy.rule.user` state events in the `#my-bans-bl:example.com` room on your server" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:227 +#: ../../../docs/configuring-playbook-bot-draupnir.md:229 msgid "applying these rules against all rooms that Draupnir is an Administrator in" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:229 +#: ../../../docs/configuring-playbook-bot-draupnir.md:231 msgid "You can undo bans with the [unban command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-users#the-unban-command)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:231 +#: ../../../docs/configuring-playbook-bot-draupnir.md:233 msgid "Enabling built-in protections" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:233 +#: ../../../docs/configuring-playbook-bot-draupnir.md:235 msgid "You can also **turn on various built-in [protections](https://the-draupnir-project.github.io/draupnir-documentation/protections)** like `JoinWaveShortCircuit` (\"If X amount of users join in Y time, set the room to invite-only\")." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:235 +#: ../../../docs/configuring-playbook-bot-draupnir.md:237 msgid "To **see which protections are available and which are enabled**, send a `!draupnir protections` command to the Management Room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:237 +#: ../../../docs/configuring-playbook-bot-draupnir.md:239 msgid "To **see the configuration options for a given protection**, send a `!draupnir config get PROTECTION_NAME` (e.g. `!draupnir config get JoinWaveShortCircuit`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:239 +#: ../../../docs/configuring-playbook-bot-draupnir.md:241 msgid "To **set a specific option for a given protection**, send a command like this: `!draupnir config set PROTECTION_NAME.OPTION VALUE` (e.g. `!draupnir config set JoinWaveShortCircuit.timescaleMinutes 30`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:241 +#: ../../../docs/configuring-playbook-bot-draupnir.md:243 msgid "To **enable a given protection**, send a command like this: `!draupnir enable PROTECTION_NAME` (e.g. `!draupnir enable JoinWaveShortCircuit`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:243 +#: ../../../docs/configuring-playbook-bot-draupnir.md:245 msgid "To **disable a given protection**, send a command like this: `!draupnir disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po index f9abc1654..72c8f2272 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -38,19 +38,19 @@ msgid "See the project's [documentation](https://github.com/matrix-org/go-neb/bl msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:11 -msgid "Registering the bot account" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:13 -msgid "The playbook does not automatically create users for you. The bot requires at least 1 access token to be able to connect to your homeserver." +msgid "Register the bot account" msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:15 -msgid "You **need to register the bot user manually** before setting up the bot." +msgid "The playbook does not automatically create users for you. You **need to register the bot user manually** before setting up the bot." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:17 -msgid "Choose a strong password for the bot. You can generate a good password with a command like this: `pwgen -s 64 1`." +msgid "Generate a strong password for the bot. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:19 @@ -58,89 +58,97 @@ msgid "You can use the playbook to [register a new user](registering-users.md):" msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:25 -msgid "Once the user is created you can [obtain an access token](obtaining-access-tokens.md)." +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:27 -msgid "Adjusting the playbook configuration" +msgid "The bot requires an access token to be able to connect to your homeserver. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:29 -msgid "To enable Go-NEB, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:193 -msgid "Adjusting the Go-NEB URL" +#: ../../../docs/configuring-playbook-bot-go-neb.md:31 +msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:195 -msgid "By default, this playbook installs Go-NEB on the `goneb.` subdomain (`goneb.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." +#: ../../../docs/configuring-playbook-bot-go-neb.md:33 +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_FOR_GONEB_HERE` and `ACCESS_TOKEN_FOR_ANOTHER_GONEB_HERE` with the ones created [above](#obtain-an-access-token)." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:197 -msgid "By tweaking the `matrix_bot_go_neb_hostname` and `matrix_bot_go_neb_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." +msgid "Adjusting the Go-NEB URL" msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:199 +msgid "By default, this playbook installs Go-NEB on the `goneb.` subdomain (`goneb.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-go-neb.md:201 +msgid "By tweaking the `matrix_bot_go_neb_hostname` and `matrix_bot_go_neb_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-go-neb.md:203 msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:210 +#: ../../../docs/configuring-playbook-bot-go-neb.md:214 msgid "Adjusting DNS records" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:212 +#: ../../../docs/configuring-playbook-bot-go-neb.md:216 msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Go-NEB domain to the Matrix server." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:214 +#: ../../../docs/configuring-playbook-bot-go-neb.md:218 msgid "By default, you will need to create a CNAME record for `goneb`. See [Configuring DNS](configuring-dns.md) for details about DNS changes." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:216 +#: ../../../docs/configuring-playbook-bot-go-neb.md:220 msgid "If you've decided to reuse the `matrix.` domain, you won't need to do any extra DNS configuration." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:218 +#: ../../../docs/configuring-playbook-bot-go-neb.md:222 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:220 +#: ../../../docs/configuring-playbook-bot-go-neb.md:224 msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:227 +#: ../../../docs/configuring-playbook-bot-go-neb.md:231 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:229 +#: ../../../docs/configuring-playbook-bot-go-neb.md:233 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:231 +#: ../../../docs/configuring-playbook-bot-go-neb.md:235 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:233 +#: ../../../docs/configuring-playbook-bot-go-neb.md:237 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:235 +#: ../../../docs/configuring-playbook-bot-go-neb.md:239 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:237 +#: ../../../docs/configuring-playbook-bot-go-neb.md:241 msgid "To use the bot, invite it to any existing Matrix room (`/invite @bot.go-neb:example.com` where `example.com` is your base domain, not the `matrix.` domain). Make sure you are granted with the sufficient permission if you are not the room owner." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:239 +#: ../../../docs/configuring-playbook-bot-go-neb.md:243 msgid "Basic usage is like this: `!echo hi` or `!imgur puppies` or `!giphy matrix`" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:241 -msgid "If you enabled the github_cmd service you can get the supported commands via `!github help`" +#: ../../../docs/configuring-playbook-bot-go-neb.md:245 +msgid "If you enabled the github_cmd service, send `!github help` to the bot in the room to see the available commands." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:243 +#: ../../../docs/configuring-playbook-bot-go-neb.md:247 msgid "You can also refer to the upstream [Documentation](https://github.com/matrix-org/go-neb)." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po index 827fc18d3..06874ae70 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -42,7 +42,7 @@ msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:11 -msgid "To enable Honoroit, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:26 @@ -110,13 +110,17 @@ msgid "Usage" msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:69 -msgid "To use the bot, invite the `@honoroit:example.com` to the room you specified in config, after that any Matrix user can send a message to the `@honoroit:example.com` to start a new thread in that room." +msgid "To use the bot, invite it to the room you specified on your `vars.yml` file (`/invite @honoroit:example.com` where `example.com` is your base domain, not the `matrix.` domain)." msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:71 -msgid "Send `!ho help` to the room to see the bot's help menu for additional commands." +msgid "After the bot joins the room, any Matrix user can send a message to it to start a new thread in that room." msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:73 +msgid "Send `!ho help` to the bot in the room to see the available commands." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-honoroit.md:75 msgid "You can also refer to the upstream [documentation](https://github.com/etkecc/honoroit#features)." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po index 073beaf8b..3471823b4 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -38,7 +38,7 @@ msgid "See the project's [documentation](https://github.com/moan0s/matrix-regist msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:9 -msgid "Configuration" +msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:11 @@ -86,7 +86,7 @@ msgid "To use the bot, start a chat with `@bot.matrix-registration-bot:example.c msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:55 -msgid "In this room send `help` and the bot will reply with all options." +msgid "Send `help` to the bot to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:57 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po index fa00c1476..84f39a049 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -42,7 +42,7 @@ msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:11 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:26 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po index cf4454110..f4130be13 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -42,7 +42,7 @@ msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:11 -msgid "To enable maubot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:26 @@ -62,6 +62,7 @@ msgid "By tweaking the `matrix_bot_maubot_hostname` and `matrix_bot_maubot_path_ msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:34 +#: ../../../docs/configuring-playbook-bot-maubot.md:56 msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" @@ -82,65 +83,85 @@ msgid "If you've decided to use the default hostname, you won't need to do any e msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:50 -msgid "Installing" +msgid "Customizing the maubot container image" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:52 -msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" +msgid "Certain [maubot plugins](https://plugins.mau.bot/) require additional dependencies to be installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-maubot.md:59 -msgid "**Notes**:" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:61 -msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:63 -msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:65 -msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." +#: ../../../docs/configuring-playbook-bot-maubot.md:54 +msgid "You can customize the default maubot container image and install your own dependencies." msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:67 -msgid "If you change the bot password (`matrix_bot_maubot_initial_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_maubot_initial_password` to let the bot know its new password." +msgid "Consult the [Dockerfile reference](https://docs.docker.com/reference/dockerfile/) for more information about the syntax." msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:69 -msgid "Usage" +msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:71 -msgid "By default, you can visit `matrix.example.com/_matrix/maubot/` to manage your available plugins, clients and instances." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:73 -msgid "You should start in the following order" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:74 -msgid "**Create one or more clients**: A client is a Matrix account which the bot will use to message. By default, the playbook creates a `bot.maubot` account (as per the configuration above). You only need to [obtain an access token](#obtaining-an-access-token) for it" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:75 -msgid "**Upload some Plugins**: Plugins can be obtained from [here](https://github.com/maubot/maubot#plugins) or any other source." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:76 -msgid "**Create an instance**: An instance is the actual bot. You have to specify a client which the bot instance will use and the plugin (how the bot will behave)" +msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:78 -msgid "Obtaining an access token" +msgid "**Notes**:" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:80 -msgid "This can be done via `mbc login` then `mbc auth` (see the [maubot documentation](https://docs.mau.fi/maubot/usage/cli/auth.html)). To run these commands, you'll first need to `exec` into the maubot container with `docker exec -it matrix-bot-maubot sh`." +msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:82 -msgid "Alternatively, you can follow our generic [obtain an access token](obtaining-access-tokens.md) documentation. Be aware that you'd better use the **Obtain an access token via curl** method (not **Obtain an access token via Element Web**) as the latter will give your bot issues in encrypted rooms. Read [more](https://docs.mau.fi/maubot/usage/basic.html#creating-clients)." +msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:84 +msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:86 +msgid "If you change the bot password (`matrix_bot_maubot_initial_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_maubot_initial_password` to let the bot know its new password." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:88 +msgid "Usage" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:90 +msgid "By default, you can visit `matrix.example.com/_matrix/maubot/` to manage your available plugins, clients and instances." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:92 +msgid "You should start in the following order" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:93 +msgid "**Create one or more clients**: A client is a Matrix account which the bot will use to message. By default, the playbook creates a `bot.maubot` account (as per the configuration above). You only need to [obtain an access token](#obtaining-an-access-token) for it" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:94 +msgid "**Upload some Plugins**: Plugins can be obtained from [here](https://github.com/maubot/maubot#plugins) or any other source." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:95 +msgid "**Create an instance**: An instance is the actual bot. You have to specify a client which the bot instance will use and the plugin (how the bot will behave)" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:97 +msgid "Obtain an access token" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:99 +msgid "This can be done via `mbc login` then `mbc auth` (see the [maubot documentation](https://docs.mau.fi/maubot/usage/cli/auth.html)). To run these commands, you'll first need to `exec` into the maubot container with `docker exec -it matrix-bot-maubot sh`." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:101 +msgid "Alternatively, you can refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md). Be aware that you'd better use the **Obtain an access token via curl** method (not **Obtain an access token via Element Web**) as the latter will causes issues to your bot in encrypted rooms. Read [more](https://docs.mau.fi/maubot/usage/basic.html#creating-clients)." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:103 +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po index 770378086..148e91976 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -46,7 +46,7 @@ msgid "The playbook does not automatically create users for you. You **need to r msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:13 -msgid "Choose a strong password for the bot. You can generate a good password with a command like this: `pwgen -s 64 1`." +msgid "Generate a strong password for the bot. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:15 @@ -58,7 +58,7 @@ msgid "If you would like Mjolnir to be able to deactivate users, move aliases, s msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:23 -msgid "Get an access token" +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:25 @@ -66,157 +66,161 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:27 -msgid "Make sure the account is free from rate limiting" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:29 -msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Mjolnir will crash.**" +msgid "Make sure the account is free from rate limiting" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:31 -msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Mjolnir will crash.**" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:33 +msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-mjolnir.md:35 msgid "To expose the APIs publicly, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:39 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:41 msgid "The APIs can also be accessed via [Synapse Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can use to administrate users, rooms, media, etc. on your Matrix server. The playbook can install and configure Synapse Admin for you. For details about it, see [this page](configuring-playbook-synapse-admin.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:41 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:43 msgid "**Note**: access to the APIs is restricted with a valid access token, so exposing them publicly should not be a real security concern. Still, doing so is not recommended for additional security. See [official Synapse reverse-proxying recommendations](https://element-hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-endpoints)." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:43 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:45 msgid "To discharge rate limiting, run the following command on systems that ship curl (note that it does not work on outdated Windows 10). Even if the APIs are not exposed to the internet, you should still be able to run the command on the homeserver locally. Before running it, make sure to replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:49 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:51 msgid "You can obtain an access token for a homeserver admin account in the same way as you can do so for Mjolnir itself. If you have made Mjolnir an admin, you can just use the Mjolnir token." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:51 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:53 msgid "Create a management room" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:53 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:55 msgid "Using your own account, create a new invite only room that you will use to manage the bot. This is the room where you will see the status of the bot and where you will send commands to the bot, such as the command to ban a user from another room. Anyone in this room can control the bot so it is important that you only invite trusted users to this room." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:55 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:57 msgid "If you make the management room encrypted (E2EE), then you MUST enable and use Pantalaimon (see [below](#configuration-with-e2ee-support))." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:57 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:59 msgid "Once you have created the room you need to copy the room ID so you can tell the bot to use that room. In Element Web you can do this by going to the room's settings, clicking Advanced, and then copying the internal room ID. The room ID will look something like `!qporfwt:example.com`." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:59 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:61 msgid "Finally invite the `@bot.mjolnir:example.com` account you created earlier into the room." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:61 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:63 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:63 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `MANAGEMENT_ROOM_ID_HERE`." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-mjolnir.md:72 -msgid "End-to-End Encryption support" +#: ../../../docs/configuring-playbook-bot-mjolnir.md:65 +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `MANAGEMENT_ROOM_ID_HERE`." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:74 -msgid "Decide whether you want Mjolnir to be capable of operating in end-to-end encrypted (E2EE) rooms. This includes the management room and the moderated rooms." +msgid "End-to-End Encryption support" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:76 -msgid "To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)." +msgid "Decide whether you want Mjolnir to be capable of operating in end-to-end encrypted (E2EE) rooms. This includes the management room and the moderated rooms." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:78 -msgid "Configuration with E2EE support" +msgid "To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:80 -msgid "When using Pantalaimon, Mjolnir will log in to its bot account itself through Pantalaimon, so configure its username and password." +msgid "Configuration with E2EE support" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:82 +msgid "When using Pantalaimon, Mjolnir will log in to its bot account itself through Pantalaimon, so configure its username and password." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-mjolnir.md:84 msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:96 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:98 msgid "The playbook's `group_vars` will configure other required settings. If using this role separately without the playbook, you also need to configure the two URLs that Mjolnir uses to reach the homeserver, one through Pantalaimon and one \"raw\". This example is taken from the playbook's `group_vars`:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:108 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:110 msgid "Configuration without E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:110 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:112 msgid "When NOT using Pantalaimon, Mjolnir does not log in by itself and you must give it an access token for its bot account." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:112 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-token)." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-mjolnir.md:118 -msgid "Adding Mjolnir synapse antispam module (optional)" +#: ../../../docs/configuring-playbook-bot-mjolnir.md:114 +msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:120 +msgid "Adding Mjolnir synapse antispam module (optional)" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-mjolnir.md:122 msgid "To enable Mjolnir synapse antispam module, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:130 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:132 msgid "Extending the configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:132 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:134 msgid "You can configure additional options by adding the `matrix_bot_mjolnir_configuration_extension_yaml` variable to your `inventory/host_vars/matrix.example.com/vars.yml` file." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:134 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:136 msgid "For example, to change Mjolnir's `recordIgnoredInvites` option to `true`, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:148 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:150 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:150 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:152 msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:157 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:159 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:159 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:161 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:161 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:163 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:163 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:165 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:165 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:167 msgid "If you change the Pantalaimon's password (`matrix_bot_mjolnir_pantalaimon_password` in your `vars.yml` file) subsequently, its credentials on the homeserver won't be updated automatically. If you'd like to change the password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_mjolnir_pantalaimon_password` to let Pantalaimon know its new password." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:167 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:169 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:169 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:171 msgid "You can refer to the upstream [documentation](https://github.com/matrix-org/mjolnir) for additional ways to use and configure Mjolnir. Check out their [quickstart guide](https://github.com/matrix-org/mjolnir#quickstart-guide) for some basic commands you can give to the bot." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po index 19e765ead..c57241d4d 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -115,7 +115,7 @@ msgid "If the bot is not already in the Discord server, follow the provided invi msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-discord.md:66 -msgid "On the Discord side, you can say `!matrix help` to get a list of available commands to manage the bridge and Matrix users." +msgid "On the Discord side, send `!matrix help` to the bot to see the available commands for managing the bridge and Matrix users." msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-discord.md:68 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po index f45dd6fa7..c9efff085 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -150,7 +150,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:73 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:75 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po index 6565f7474..76a31dbd3 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -74,5 +74,5 @@ msgid "To use the bridge, you need to start a chat with `Skype bridge bot` with msgstr "" #: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:36 -msgid "Send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po index 969a85e2a..4c3b51aae 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -114,7 +114,7 @@ msgid "Make sure the bot is able to send state events (usually the Moderator pow msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:64 -msgid "Send `!hookshot help` to the room to see the bridge's help menu for additional commands." +msgid "Send `!hookshot help` to the bot to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:66 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po index 2c8767d29..bd0311833 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -174,7 +174,7 @@ msgid "After confirming (in the Discord app) that you'd like to allow this login msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:79 -msgid "Now that you're logged in, you can send a `help` command to the bot again, to see additional commands you have access to" +msgid "Now that you're logged in, you can send `help` to the bot to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:80 @@ -234,7 +234,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:104 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:106 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po index 9325f317c..a16acf802 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -150,7 +150,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:99 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:101 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po index f181bca9b..40bc5001c 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -118,7 +118,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:58 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:60 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po index 2f4d93ae1..3fd090658 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -138,7 +138,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:68 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:70 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po index fa5c12175..0d552d93a 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -138,7 +138,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:68 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:70 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po index b8e6a3229..e1c347b88 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -198,7 +198,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:107 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:109 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po index deedc6840..905ac480e 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -234,7 +234,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:124 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:126 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po index 3767bf9d3..990eefa26 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -186,7 +186,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:109 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:111 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po index 95912f8f4..3de53dfe5 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -146,7 +146,7 @@ msgid "The bot should respond with \"Successfully logged into for team < msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:66 -msgid "Now that you're logged in, you can send a `help` command to the bot again, to see additional commands you have access to." +msgid "Now that you're logged in, you can send `help` to the bot to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:67 @@ -186,7 +186,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:85 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:87 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po index fcdaf40dc..5dbfc7b62 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -142,7 +142,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:91 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:93 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po index e16a0a587..403b09145 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -134,7 +134,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:65 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:67 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po index f38bbc6b1..15cd1e448 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -138,7 +138,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:76 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:78 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po index 63c31ff55..38262cd43 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -98,5 +98,5 @@ msgid "Clicking rooms in the list will result in you receiving an invitation to msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:46 -msgid "Also send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po index 61d002626..ad848ffcb 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -90,5 +90,5 @@ msgid "Clicking rooms in the list will result in you receiving an invitation to msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:48 -msgid "Also send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po index 7174fc472..918c8fe79 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -102,5 +102,5 @@ msgid "If you are linking only one Instagram account, your `$puppetId` is probab msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:48 -msgid "The `help` command shows which commands are available, though at the time of writing, not every command is fully implemented." +msgid "Send `help` to the bot to see the available commands. At the time of writing, not every command is fully implemented." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po index 4ca40c767..67ae99b1e 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -94,5 +94,5 @@ msgid "Clicking rooms in the list will result in you receiving an invitation to msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:51 -msgid "Also send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po index fbad3d73e..4ece71ba6 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -86,5 +86,5 @@ msgid "Clicking rooms in the list will result in you receiving an invitation to msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:42 -msgid "Also send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po index e881607c3..904abfeac 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -98,5 +98,5 @@ msgid "Clicking rooms in the list will result in you receiving an invitation to msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:53 -msgid "Also send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po index 17eb742c0..dceac0da9 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -118,7 +118,7 @@ msgid "Then send `!pm mailbox NAME` to expose this Matrix room as an inbox with msgstr "" #: ../../../docs/configuring-playbook-bridge-postmoogle.md:74 -msgid "Send `!pm help` to the room to see the bridge's help menu for additional commands." +msgid "Send `!pm help` to the bot in the room to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bridge-postmoogle.md:76 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po index 79c9dddee..b28acaeed 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -126,7 +126,7 @@ msgid "Upon starting Cactus Comments, a `bot.cactusbot` user account is created msgstr "" #: ../../../docs/configuring-playbook-cactus-comments.md:85 -msgid "To get started, send a `help` message to the `@bot.cactusbot:example.com` bot to confirm it's working." +msgid "To get started, send `help` to the `@bot.cactusbot:example.com` bot to confirm it's working." msgstr "" #: ../../../docs/configuring-playbook-cactus-comments.md:87 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-dimension.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-dimension.po index a2dcc6505..6bc7248aa 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-dimension.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-dimension.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -26,137 +26,158 @@ msgid "Setting up Dimension integration manager (optional, unmaintained)" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:3 -msgid "**[Dimension](https://dimension.t2bot.io) can only be installed after Matrix services are installed and running.** If you're just installing Matrix services for the first time, please continue with the [Configuration](configuring-playbook.md) / [Installation](installing.md) flow and come back here later." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:5 -msgid "**Note**: Dimension is **[officially unmaintained](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/2806#issuecomment-1673559299)**. We recommend not bothering with installing it." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:7 -msgid "**Note**: This playbook now supports running [Dimension](https://dimension.t2bot.io) in both a federated and [unfederated](https://github.com/turt2live/matrix-dimension/blob/master/docs/unfederated.md) environments. This is handled automatically based on the value of `matrix_homeserver_federation_enabled`. Enabling Dimension, means that the `openid` API endpoints will be exposed on the Matrix Federation port (usually `8448`), even if [federation](configuring-playbook-federation.md) is disabled. It's something to be aware of, especially in terms of firewall whitelisting (make sure port `8448` is accessible)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:9 -msgid "Adjusting the playbook configuration" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:11 -msgid "To enable Dimension, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:17 -msgid "Define admin users" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:19 -msgid "These users can modify the integrations this Dimension supports. Add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:27 -msgid "The admin interface is accessible within Element Web by accessing it in any room and clicking the cog wheel/settings icon in the top right. Currently, Dimension can be opened in Element Web by the \"Add widgets, bridges, & bots\" link in the room information." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:29 -msgid "Access token" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:31 -msgid "We recommend that you create a dedicated Matrix user for Dimension (`dimension` is a good username). Follow our [Registering users](registering-users.md) guide to learn how to register **a regular (non-admin) user**." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:33 -msgid "You are required to specify an access token (belonging to this new user) for Dimension to work. To get an access token for the Dimension user, you can follow the documentation on [how to do obtain an access token](obtaining-access-tokens.md)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:35 -msgid "**Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone.**" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:37 -msgid "Add access token to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:43 -msgid "For more information on how to acquire an access token, visit [https://t2bot.io/docs/access_tokens](https://t2bot.io/docs/access_tokens)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:45 -msgid "Adjusting the Dimension URL" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:47 -msgid "By default, this playbook installs Dimension on the `dimension.` subdomain (`dimension.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:49 -msgid "By tweaking the `matrix_dimension_hostname` and `matrix_dimension_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:51 -msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:62 -msgid "**Note**: While there is a `matrix_dimension_path_prefix` variable for changing the path where Dimension is served, overriding it is not possible due to [this Dimension issue](https://github.com/turt2live/matrix-dimension/issues/510). You must serve Dimension at a dedicated subdomain." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:64 -msgid "Adjusting DNS records" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:66 -msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Dimension domain to the Matrix server." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:68 -msgid "By default, you will need to create a CNAME record for `dimension`. See [Configuring DNS](configuring-dns.md) for details about DNS changes." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:70 -msgid "Installing" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:72 -msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:79 +#: ../../../docs/configuring-playbook-dimension.md:91 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:81 -msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" +#: ../../../docs/configuring-playbook-dimension.md:4 +msgid "Dimension is **[officially unmaintained](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/2806#issuecomment-1673559299)**. We recommend not bothering with installing it." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:83 -msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too." +#: ../../../docs/configuring-playbook-dimension.md:5 +msgid "This playbook now supports running Dimension in both a federated and [unfederated](https://github.com/turt2live/matrix-dimension/blob/master/docs/unfederated.md) environments. This is handled automatically based on the value of `matrix_homeserver_federation_enabled`. Enabling Dimension, means that the `openid` API endpoints will be exposed on the Matrix Federation port (usually `8448`), even if [federation](configuring-playbook-federation.md) is disabled. It's something to be aware of, especially in terms of firewall whitelisting (make sure port `8448` is accessible)." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:85 -msgid "After Dimension has been installed you may need to log out and log back in for it to pick up the new integration manager. Then you can access integrations in Element Web by opening a room, clicking the Room info button (`i`) button in the top right corner of the screen, and then clicking Add widgets, bridges & bots." +#: ../../../docs/configuring-playbook-dimension.md:7 +msgid "The playbook can install and configure the [Dimension](https://dimension.t2bot.io) integration manager for you." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:87 -msgid "Jitsi domain" +#: ../../../docs/configuring-playbook-dimension.md:9 +msgid "See the project's [documentation](https://github.com/turt2live/matrix-dimension/blob/master/README.md) to learn what it does and why it might be useful to you." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:89 -msgid "By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video conference widgets. For users running [a self-hosted Jitsi instance](./configuring-playbook-jitsi.md), you will likely want the widget to use your own Jitsi instance. Currently there is no way to configure this via the playbook, see [this issue](https://github.com/turt2live/matrix-dimension/issues/345) for details." +#: ../../../docs/configuring-playbook-dimension.md:11 +msgid "Prerequisites" msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:91 -msgid "In the interim until the above limitation is resolved, an admin user needs to configure the domain via the admin ui once dimension is running. In Element Web, go to *Manage Integrations* → *Settings* → *Widgets* → *Jitsi Conference Settings* and set *Jitsi Domain* and *Jitsi Script URL* appropriately." +#: ../../../docs/configuring-playbook-dimension.md:13 +msgid "Install Matrix services" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:15 +msgid "Dimension can only be installed after Matrix services are installed and running. If you're just installing Matrix services for the first time, please continue with the [Configuration](configuring-playbook.md) / [Installation](installing.md) and come back here later." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:17 +msgid "Register a dedicated Matrix user (optional, recommended)" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:19 +msgid "We recommend that you create a dedicated Matrix user for Dimension (`dimension` is a good username)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:21 +msgid "Generate a strong password for the user. You can create one with a command like `pwgen -s 64 1`." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:23 +msgid "You can use the playbook to [register a new user](registering-users.md):" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:29 +msgid "Obtain an access token" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:31 +msgid "Dimension requires an access token to be able to connect to your homeserver. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:33 +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:35 +msgid "Adjusting the playbook configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:37 +msgid "To enable Dimension, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`). Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:45 +msgid "Define admin users" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:47 +msgid "These users can modify the integrations this Dimension supports. Add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:55 +msgid "The admin interface is accessible within Element Web by accessing it in any room and clicking the cog wheel/settings icon in the top right. Currently, Dimension can be opened in Element Web by the \"Add widgets, bridges, & bots\" link in the room information." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:57 +msgid "Adjusting the Dimension URL" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:59 +msgid "By default, this playbook installs Dimension on the `dimension.` subdomain (`dimension.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:61 +msgid "By tweaking the `matrix_dimension_hostname` and `matrix_dimension_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:63 +msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:74 +msgid "**Note**: While there is a `matrix_dimension_path_prefix` variable for changing the path where Dimension is served, overriding it is not possible due to [this Dimension issue](https://github.com/turt2live/matrix-dimension/issues/510). You must serve Dimension at a dedicated subdomain." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:76 +msgid "Adjusting DNS records" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:78 +msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Dimension domain to the Matrix server." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:80 +msgid "By default, you will need to create a CNAME record for `dimension`. See [Configuring DNS](configuring-dns.md) for details about DNS changes." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:82 +msgid "Installing" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:84 +msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:93 -msgid "Additional features" +msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:95 -msgid "To use a more custom configuration, you can define a `matrix_dimension_configuration_extension_yaml` string variable and put your configuration in it. To learn more about how to do this, refer to the information about `matrix_dimension_configuration_extension_yaml` in the [default variables file](../roles/custom/matrix-dimension/defaults/main.yml) of the Dimension component." +msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:97 +msgid "After Dimension has been installed you may need to log out and log back in for it to pick up the new integration manager. Then you can access integrations in Element Web by opening a room, clicking the Room info button (`i`) button in the top right corner of the screen, and then clicking Add widgets, bridges & bots." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:99 +msgid "Jitsi domain" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:101 +msgid "By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video conference widgets. For users running [a self-hosted Jitsi instance](./configuring-playbook-jitsi.md), you will likely want the widget to use your own Jitsi instance. Currently there is no way to configure this via the playbook, see [this issue](https://github.com/turt2live/matrix-dimension/issues/345) for details." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:103 +msgid "In the interim until the above limitation is resolved, an admin user needs to configure the domain via the admin ui once dimension is running. In Element Web, go to *Manage Integrations* → *Settings* → *Widgets* → *Jitsi Conference Settings* and set *Jitsi Domain* and *Jitsi Script URL* appropriately." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:105 +msgid "Additional features" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:107 +msgid "To use a more custom configuration, you can define a `matrix_dimension_configuration_extension_yaml` string variable and put your configuration in it. To learn more about how to do this, refer to the information about `matrix_dimension_configuration_extension_yaml` in the [default variables file](../roles/custom/matrix-dimension/defaults/main.yml) of the Dimension component." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:109 msgid "You can find all configuration options on [GitHub page of Dimension project](https://github.com/turt2live/matrix-dimension/blob/master/config/default.yaml)." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po index 0bdcf7ed3..aa97b41e9 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -70,113 +70,129 @@ msgid "For details about using Email2Matrix alongside [Postfix](http://www.postf msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:25 -msgid "Creating a user" +msgid "Register a dedicated Matrix user (optional, recommended)" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:27 -msgid "Before enabling Email2Matrix, you'd most likely wish to create a dedicated user (or more) that would be sending messages on the Matrix side. Take note of the user's ID as it needs to be specified as `MatrixUserId` on your `inventory/host_vars/matrix.example.com/vars.yml` file later." +msgid "We recommend that you create a dedicated Matrix user for Email2Matrix." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:29 -msgid "Refer to [Registering users](registering-users.md) for ways to create a user. A regular (non-admin) user works best." +msgid "Generate a strong password for the user. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:31 -msgid "Creating a shared room" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:33 -msgid "After creating the sender user, you should create one or more Matrix rooms that you share with that user. It doesn't matter who creates and owns the rooms and who joins later (you or the sender user)." -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:35 -msgid "What matters is that both you and the sender user are part of the same room and that the sender user has enough privileges in the room to be able to send messages there." +msgid "You can use the playbook to [register a new user](registering-users.md):" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:37 -msgid "Inviting additional people to the room is okay too." +msgid "Take note of the user's ID as it needs to be specified as `MatrixUserId` on your `inventory/host_vars/matrix.example.com/vars.yml` file later." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:39 -msgid "Take note of each room's room ID (different clients show the room ID in a different place). You'll need the room ID when [configuring the playbook](#adjusting-the-playbook-configuration) below." +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:41 -msgid "Obtaining an access token for the sender user" +msgid "Email2Matrix requires an access token for the sender user to be able to send messages to the room. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:43 -msgid "In order for the sender user created above to be able to send messages to the room, we'll need to obtain an access token for it. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:45 -msgid "Adjusting the playbook configuration" +msgid "Join to rooms as the sender user manually" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:47 -msgid "After doing the preparation steps above, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" +msgid "ℹ️ **Email2Matrix does not accept room invitations automatically**. To deliver messages to rooms, the sender user must be joined to all rooms manually." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:72 -msgid "where:" +#: ../../../docs/configuring-playbook-email2matrix.md:49 +msgid "For each new room you would like the user to deliver messages to, invite the user to the room." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:74 -msgid "MailboxName - local-part of the email address, through which emails are bridged to the room whose ID is defined with MatrixRoomId" +#: ../../../docs/configuring-playbook-email2matrix.md:51 +msgid "Then, log in as the sender user using any Matrix client of your choosing, accept the room invitation from the user's account." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:75 -msgid "MatrixRoomId - internal ID of the room, to which received emails are sent as Matrix message" +#: ../../../docs/configuring-playbook-email2matrix.md:53 +msgid "Make sure that you and the sender user are part of the same room and that the sender user has enough privileges in the room to be able to send messages there, then log out." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:76 -msgid "MatrixHomeserverUrl - URL of your Matrix homeserver, through which to send Matrix messages. You can also set `MatrixHomeserverUrl` to the container URL where your homeserver's Client-Server API lives by using the `{{ matrix_addons_homeserver_client_api_url }}` variable" +#: ../../../docs/configuring-playbook-email2matrix.md:55 +msgid "Take note of each room's room ID (different clients show the room ID in a different place). You'll need the room ID when [configuring the playbook](#adjusting-the-playbook-configuration) below." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:77 -msgid "MatrixUserId - the full ID of the sender user which sends bridged messages to the room. On this configuration it is `@email2matrix1:example.com` and `@email2matrix2:example.com` (where `example.com` is your base domain, not the `matrix.` domain)" +#: ../../../docs/configuring-playbook-email2matrix.md:57 +msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:78 -msgid "MatrixAccessToken - sender user's access token" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:79 -msgid "IgnoreSubject - if set to \"true\", the subject is not bridged to Matrix" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:80 -msgid "IgnoreBody - if set to \"true\", the message body is not bridged to Matrix" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:81 -msgid "SkipMarkdown - if set to \"true\", emails are bridged as plain text Matrix message instead of Markdown (actually HTML)" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:83 -msgid "Refer to the official documentation [here](https://github.com/devture/email2matrix/blob/master/docs/configuration.md)." +#: ../../../docs/configuring-playbook-email2matrix.md:59 +msgid "To enable Email2Matrix, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_FOR_EMAIL2MATRIX1_HERE` and `ACCESS_TOKEN_FOR_EMAIL2MATRIX2_HERE` with the ones created [above](#obtain-an-access-token)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:85 -msgid "Installing" +msgid "where:" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:87 -msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" +msgid "MailboxName - local-part of the email address, through which emails are bridged to the room whose ID is defined with MatrixRoomId" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:88 +msgid "MatrixRoomId - internal ID of the room, to which received emails are sent as Matrix message" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:89 +msgid "MatrixHomeserverUrl - URL of your Matrix homeserver, through which to send Matrix messages. You can also set `MatrixHomeserverUrl` to the container URL where your homeserver's Client-Server API lives by using the `{{ matrix_addons_homeserver_client_api_url }}` variable" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:90 +msgid "MatrixUserId - the full ID of the sender user which sends bridged messages to the room. On this configuration it is `@email2matrix1:example.com` and `@email2matrix2:example.com` (where `example.com` is your base domain, not the `matrix.` domain)" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:91 +msgid "MatrixAccessToken - sender user's access token" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:92 +msgid "IgnoreSubject - if set to \"true\", the subject is not bridged to Matrix" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:93 +msgid "IgnoreBody - if set to \"true\", the message body is not bridged to Matrix" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:94 -msgid "**Notes**:" +msgid "SkipMarkdown - if set to \"true\", emails are bridged as plain text Matrix message instead of Markdown (actually HTML)" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:96 -msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-service email2matrix` or `just setup-all`" +msgid "Refer to the official documentation [here](https://github.com/devture/email2matrix/blob/master/docs/configuration.md)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:98 -msgid "`just install-service email2matrix` is useful for maintaining your setup quickly when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note `just setup-all` runs the `ensure-matrix-users-created` tag too." +msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:100 +msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:107 +msgid "**Notes**:" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:109 +msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-service email2matrix` or `just setup-all`" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:111 +msgid "`just install-service email2matrix` is useful for maintaining your setup quickly when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note `just setup-all` runs the `ensure-matrix-users-created` tag too." +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:113 msgid "After installation, you may wish to send a test email to the email address assigned to `mailbox1` (default: `mailbox1@matrix.example.com`) to make sure that Email2Matrix works as expected." msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-jitsi.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-jitsi.po index 323995184..05f28ca05 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-jitsi.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-jitsi.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -90,7 +90,7 @@ msgid "By default, you will need to create a CNAME record for `jitsi`. See [Conf msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:43 -msgid "(Optional) Configure Jitsi authentication and guests mode" +msgid "Configure Jitsi authentication and guests mode (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:45 @@ -166,7 +166,7 @@ msgid "For more information refer to the [docker-jitsi-meet](https://github.com/ msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:115 -msgid "(Optional) Making your Jitsi server work on a LAN" +msgid "Making your Jitsi server work on a LAN (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:117 @@ -186,7 +186,7 @@ msgid "Add these two lines to your `inventory/host_vars/matrix.example.com/vars. msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:130 -msgid "(Optional) Fine tune Jitsi" +msgid "Fine tune Jitsi (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:132 @@ -210,7 +210,7 @@ msgid "You may want to **limit the maximum video resolution**, to save up resour msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:155 -msgid "(Optional) Specify a Max number of participants on a Jitsi conference" +msgid "Specify a Max number of participants on a Jitsi conference (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:157 @@ -222,7 +222,7 @@ msgid "In order to set the max number of participants use the following **additi msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:165 -msgid "(Optional) Additional JVBs" +msgid "Additional JVBs (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:167 @@ -274,7 +274,7 @@ msgid "To make Traefik reverse-proxy to these additional JVBs (living on other h msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:256 -msgid "(Optional) Enable Gravatar" +msgid "Enable Gravatar (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:258 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po index a3d6a1636..3acc935c1 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -78,7 +78,7 @@ msgid "Additional common configuration options:" msgstr "" #: ../../../docs/configuring-playbook-matrix-media-repo.md:91 -msgid "Full list of configuration options with documentation can be found in [`roles/custom/matrix-media-repo/defaults/main.yml`](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/master/roles/custom/matrix-media-repo/defaults/main.yml)" +msgid "Full list of configuration options with documentation can be found in [`roles/custom/matrix-media-repo/defaults/main.yml`](../roles/custom/matrix-media-repo/defaults/main.yml)" msgstr "" #: ../../../docs/configuring-playbook-matrix-media-repo.md:93 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po index 0e4f60922..25c018878 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -98,7 +98,7 @@ msgid "In the default configuration, the UVS Server is only reachable via the do msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:42 -msgid "Access token" +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:44 @@ -110,15 +110,15 @@ msgid "We recommend that you create a dedicated Matrix user for uvs (`uvs` is a msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:48 -msgid "You are required to specify an access token (belonging to this new user) for UVS to work. To get an access token for the UVS user, you can follow the documentation on [how to do obtain an access token](obtaining-access-tokens.md)." +msgid "You are required to specify an access token (belonging to this new user) for UVS to work. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:50 -msgid "**Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone.**" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:56 -msgid "(Optional) Custom Auth Token" +msgid "Custom Auth Token (optional)" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:58 @@ -138,7 +138,7 @@ msgid "In case Jitsi is also managed by this playbook and 'matrix' authenticatio msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:70 -msgid "(Optional) Disable Auth" +msgid "Disable Auth (optional)" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:72 @@ -146,7 +146,7 @@ msgid "Authorization is enabled by default. To disable it, add the following con msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:78 -msgid "(Optional) Federation" +msgid "Federation (optional)" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:80 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-well-known.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-well-known.po index 19ba61dcd..9711ff1b9 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-well-known.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-well-known.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -90,7 +90,7 @@ msgid "However, this playbook installs your Matrix server on another domain (e.g msgstr "" #: ../../../docs/configuring-well-known.md:37 -msgid "(Optional) Support Service Discovery" +msgid "Support Service Discovery (optional)" msgstr "" #: ../../../docs/configuring-well-known.md:39 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/howto-server-delegation.po b/i18n/locales/bg/LC_MESSAGES/docs/howto-server-delegation.po index 122665b7b..3572ebe44 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/howto-server-delegation.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/howto-server-delegation.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -130,7 +130,7 @@ msgid "For more details on how to configure the playbook to work with SRV delega msgstr "" #: ../../../docs/howto-server-delegation.md:54 -msgid "Obtaining certificates" +msgid "Obtain certificates" msgstr "" #: ../../../docs/howto-server-delegation.md:56 diff --git a/i18n/locales/bg/LC_MESSAGES/docs/maintenance-synapse.po b/i18n/locales/bg/LC_MESSAGES/docs/maintenance-synapse.po index 1d92a8229..2463c4eb2 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/maintenance-synapse.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/maintenance-synapse.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -62,137 +62,141 @@ msgid "To make use of this Synapse Admin API, **you'll need an admin access toke 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 "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." 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 "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:25 -msgid "After deleting data, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)." +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:27 -msgid "Compressing state with rust-synapse-compress-state" +msgid "After deleting data, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)." 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 "Compressing state with rust-synapse-compress-state" 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 "[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: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 "**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:35 +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:37 msgid "To ask the playbook to run rust-synapse-compress-state, execute:" msgstr "" -#: ../../../docs/maintenance-synapse.md:41 +#: ../../../docs/maintenance-synapse.md:43 msgid "The shortcut command with `just` program is also available: `just run-tags rust-synapse-compress-state`" msgstr "" -#: ../../../docs/maintenance-synapse.md:43 +#: ../../../docs/maintenance-synapse.md:45 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 +#: ../../../docs/maintenance-synapse.md:47 msgid "After state compression, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)." msgstr "" -#: ../../../docs/maintenance-synapse.md:47 +#: ../../../docs/maintenance-synapse.md:49 msgid "Browse and manipulate the database" msgstr "" -#: ../../../docs/maintenance-synapse.md:49 +#: ../../../docs/maintenance-synapse.md:51 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 +#: ../../../docs/maintenance-synapse.md:53 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 +#: ../../../docs/maintenance-synapse.md:55 msgid "First, set up an SSH tunnel to your Matrix server (skip if it is your local machine):" msgstr "" -#: ../../../docs/maintenance-synapse.md:60 +#: ../../../docs/maintenance-synapse.md:62 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 +#: ../../../docs/maintenance-synapse.md:68 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 +#: ../../../docs/maintenance-synapse.md:70 msgid "⚠️️ Be **very careful** with this, there is **no undo** for impromptu DB operations." msgstr "" -#: ../../../docs/maintenance-synapse.md:70 +#: ../../../docs/maintenance-synapse.md:72 msgid "Make Synapse faster" msgstr "" -#: ../../../docs/maintenance-synapse.md:72 +#: ../../../docs/maintenance-synapse.md:74 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 +#: ../../../docs/maintenance-synapse.md:76 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 +#: ../../../docs/maintenance-synapse.md:78 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 +#: ../../../docs/maintenance-synapse.md:80 msgid "Tuning caches and cache autotuning" msgstr "" -#: ../../../docs/maintenance-synapse.md:80 +#: ../../../docs/maintenance-synapse.md:82 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 +#: ../../../docs/maintenance-synapse.md:84 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 +#: ../../../docs/maintenance-synapse.md:86 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 +#: ../../../docs/maintenance-synapse.md:88 msgid "Cache autotuning is **enabled by default** and controlled via the following variables:" msgstr "" -#: ../../../docs/maintenance-synapse.md:88 +#: ../../../docs/maintenance-synapse.md:90 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 +#: ../../../docs/maintenance-synapse.md:91 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 +#: ../../../docs/maintenance-synapse.md:92 msgid "`matrix_synapse_cache_autotuning_min_cache_ttl` - defaults to `30s`" msgstr "" -#: ../../../docs/maintenance-synapse.md:92 +#: ../../../docs/maintenance-synapse.md:94 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 +#: ../../../docs/maintenance-synapse.md:96 msgid "To **disable cache auto-tuning**, unset all values:" msgstr "" -#: ../../../docs/maintenance-synapse.md:102 +#: ../../../docs/maintenance-synapse.md:104 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 +#: ../../../docs/maintenance-synapse.md:106 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 "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/obtaining-access-tokens.po b/i18n/locales/bg/LC_MESSAGES/docs/obtaining-access-tokens.po index f14ecacfd..3a94222d7 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/obtaining-access-tokens.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/obtaining-access-tokens.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -30,7 +30,7 @@ msgid "When setting up some optional features like bots and bridges you will nee msgstr "" #: ../../../docs/obtaining-access-tokens.md:5 -msgid "**Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone.**" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/obtaining-access-tokens.md:7 diff --git a/i18n/locales/jp/LC_MESSAGES/CHANGELOG.po b/i18n/locales/jp/LC_MESSAGES/CHANGELOG.po index f0f6914ef..b142bce39 100644 --- a/i18n/locales/jp/LC_MESSAGES/CHANGELOG.po +++ b/i18n/locales/jp/LC_MESSAGES/CHANGELOG.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-22 17:53+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -4006,7 +4006,7 @@ msgid "We believe the steps below are safe and you won't encounter any data loss msgstr "" #: ../../../CHANGELOG.md:2195 -msgid "Generate a strong password to be used for your superuser Postgres user (called `matrix`). You can use `pwgen -s 64 1` to generate it, or some other tool. The **maximum length** for a Postgres password is 100 bytes (characters). Don't go crazy!" +msgid "Generate a strong password to be used for your superuser Postgres user (called `matrix`). You can create one with a command like `pwgen -s 64 1`. The **maximum length** for a Postgres password is 100 bytes (characters). Don't go crazy!" msgstr "" #: ../../../CHANGELOG.md:2197 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po index f968d56f4..bd7e7f512 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -53,7 +53,7 @@ msgid "The playbook does not automatically create users for you. You **need to r msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:17 -msgid "Choose a strong password for the bot. You can generate a good password with a command like this: `pwgen -s 64 1`." +msgid "Generate a strong password for the bot. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:19 @@ -61,7 +61,7 @@ msgid "You can use the playbook to [register a new user](registering-users.md):" msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:25 -msgid "Get an access token" +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:27 @@ -69,97 +69,101 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:29 -msgid "Join to rooms as the bot manually" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:31 -msgid "ℹ️ **This bot does not accept room invitations automatically**. To deliver messages to rooms, the bot must be joined to all rooms manually." +msgid "Join to rooms as the bot manually" msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:33 -msgid "For each new room you would like the bot to deliver alerts to, invite the bot to the room." +msgid "ℹ️ **This bot does not accept room invitations automatically**. To deliver messages to rooms, the bot must be joined to all rooms manually." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:35 -msgid "Then, log in as the bot using any Matrix client of your choosing, accept the room invitation from the bot's account, and log out." +msgid "For each new room you would like the bot to deliver alerts to, invite the bot to the room." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:37 -msgid "Adjusting the playbook configuration" +msgid "Then, log in as the bot using any Matrix client of your choosing, accept the room invitation from the bot's account, and log out." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:39 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-token)." +msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:61 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:41 +msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:62 msgid "See `roles/custom/matrix-alertmanager-receiver/defaults/main.yml` for additional configuration variables." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:63 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:64 msgid "Adjusting the matrix-alertmanager-receiver URL" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:65 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:66 msgid "By default, this playbook installs matrix-alertmanager-receiver on the `matrix.` subdomain, at the `/matrix-alertmanager-receiver` path (https://matrix.example.com/matrix-alertmanager-receiver). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:68 msgid "By tweaking the `matrix_alertmanager_receiver_hostname` and `matrix_alertmanager_receiver_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:70 msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:77 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:78 msgid "Adjusting DNS records" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:79 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:80 msgid "If you've changed the default hostname, **you may need to adjust your DNS** records to point the matrix-alertmanager-receiver domain to the Matrix server." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:81 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:82 msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:83 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:84 msgid "If you've decided to use the default hostname, you won't need to do any extra DNS configuration." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:85 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:86 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:88 msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:94 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:95 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:96 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:97 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:98 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:99 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:100 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:101 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:102 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:103 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:104 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:105 msgid "Configure your Prometheus Alertmanager with configuration like this:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:123 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:124 msgid "where `URL_HERE` looks like `https://matrix.example.com/matrix-alertmanager-receiver-RANDOM_VALUE_HERE/alert/some-room-name` or `https://matrix.example.com/matrix-alertmanager-receiver-RANDOM_VALUE_HERE/alert/!qporfwt:example.com`." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-backup-borg.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-backup-borg.po index e787fcd57..ea0595781 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-backup-borg.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-backup-borg.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-22 17:53+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -97,7 +97,7 @@ msgid "REPO - BorgBackup repository name, it will be initialized on backup start msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:63 -msgid "PASSPHRASE - passphrase used for encrypting backups, you may generate it with `pwgen -s 64 1` or use any password manager" +msgid "PASSPHRASE - passphrase used for encrypting backups. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:64 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po index 77417d722..5e7d91371 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -81,7 +81,7 @@ msgid "Base configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:33 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:71 @@ -388,7 +388,7 @@ msgid "Usage" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:386 -msgid "To use the bot, invite the `@baibot:example.com` bot user into a room." +msgid "To use the bot, invite it to any existing Matrix room (`/invite @baibot:example.com` where `example.com` is your base domain, not the `matrix.` domain)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:388 @@ -404,7 +404,7 @@ msgid "If you've [🤖 configured one or more agents via Ansible](#-configuring- msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:394 -msgid "Send `!bai help` to the room at any time to see the bot's help menu for additional commands." +msgid "Send `!bai help` to the bot in the room to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:396 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po index 2dd8ab917..6822a51fb 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -37,7 +37,7 @@ msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:9 -msgid "To enable Buscarron, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:32 @@ -105,29 +105,37 @@ msgid "Usage" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:78 -msgid "To use the bot, invite the `@bot.buscarron:example.com` to the room you specified in a config, after that any point your form to the form url, example for the `contact` form:" +msgid "To use the bot, invite it to the room you specified on your `vars.yml` file (`/invite @bot.buscarron:example.com` where `example.com` is your base domain, not the `matrix.` domain)." msgstr "" -#: ../../../docs/configuring-playbook-bot-buscarron.md:86 -msgid "**Note**: to fight against spam, Buscarron is **very aggressive when it comes to banning** and will ban you if:" +#: ../../../docs/configuring-playbook-bot-buscarron.md:80 +msgid "After the bot joins the room, anyone can call the web form via HTTP POST method." msgstr "" -#: ../../../docs/configuring-playbook-bot-buscarron.md:88 -msgid "if you hit the homepage (HTTP `GET` request to `/`)" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-buscarron.md:89 -msgid "if you submit a form to the wrong URL (`POST` request to `/non-existing-form`)" +#: ../../../docs/configuring-playbook-bot-buscarron.md:82 +msgid "Here is an example for the `contact` form:" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:90 -msgid "if `hasemail` is enabled for the form (like in the example above) and you don't submit an `email` field" +msgid "**Note**: to fight against spam, Buscarron is **very aggressive when it comes to banning** and will ban you if:" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:92 -msgid "If you get banned, you'd need to restart the process by running the playbook with `--tags=start` or running `systemctl restart matrix-bot-buscarron` on the server." +msgid "you hit the homepage (HTTP `GET` request to `/`)" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-buscarron.md:93 +msgid "you submit a form to the wrong URL (`POST` request to `/non-existing-form`)" msgstr "" #: ../../../docs/configuring-playbook-bot-buscarron.md:94 +msgid "`hasemail` is enabled for the form (like in the example above) and you don't submit an `email` field" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-buscarron.md:96 +msgid "If you get banned, you'd need to restart the process by running the playbook with `--tags=start` or running `systemctl restart matrix-bot-buscarron` on the server." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-buscarron.md:98 msgid "You can also refer to the upstream [documentation](https://github.com/etkecc/buscarron)." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po index 3214d2062..6b6d46434 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -37,47 +37,55 @@ msgid "Talk to [ChatGPT](https://openai.com/blog/chatgpt/) via your favourite Ma msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:9 -msgid "Register the bot account" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:11 -msgid "The playbook does not automatically create users for you. The bot requires an access token to be able to connect to your homeserver." +msgid "Obtain an OpenAI API key" msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:13 -msgid "You **need to register the bot user manually** before setting up the bot." +msgid "To use the bot, you'd need to obtain an API key from [https://platform.openai.com/account/api-keys](https://platform.openai.com/account/api-keys)." msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:15 -msgid "Choose a strong password for the bot. You can generate a good password with a command like this: `pwgen -s 64 1`." +msgid "Register the bot account" msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:17 +msgid "The playbook does not automatically create users for you. You **need to register the bot user manually** before setting up the bot." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:19 +msgid "Generate a strong password for the bot. You can create one with a command like `pwgen -s 64 1`." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:21 msgid "You can use the playbook to [register a new user](registering-users.md):" msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:23 -msgid "Get an access token and create encryption keys" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-chatgpt.md:25 -msgid "Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." -msgstr "" - #: ../../../docs/configuring-playbook-bot-chatgpt.md:27 -msgid "To make sure the bot can read encrypted messages, it will need an encryption key, just like any other new user. While obtaining the access token, follow the prompts to setup a backup key. More information can be found in the [Element documentation](https://element.io/help#encryption6)." +msgid "Obtain an access token and create encryption keys" msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:29 -msgid "Adjusting the playbook configuration" +msgid "The bot requires an access token to be able to connect to your homeserver. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:31 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:52 -msgid "You will need to get tokens for ChatGPT." +#: ../../../docs/configuring-playbook-bot-chatgpt.md:33 +msgid "To make sure the bot can read encrypted messages, it will need an encryption key, just like any other new user. While obtaining the access token, follow the prompts to setup a backup key. More information can be found in the [Element documentation](https://element.io/help#encryption6)." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:35 +msgid "Adjusting the playbook configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:37 +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `API_KEY_HERE` with the API key retrieved [here](#obtain-an-openai-api-key) and `ACCESS_TOKEN_HERE` with the access token created [here](#obtain-an-access-token-and-create-encryption-keys), respectively." msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:54 @@ -109,9 +117,13 @@ msgid "Usage" msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:73 -msgid "To use the bot, invite the `@bot.chatgpt:example.com` to the room you specified in a config, after that start speaking to it, use the prefix if you configured one or mention the bot." +msgid "To use the bot, invite it to the room you specified on your `vars.yml` file (`/invite @bot.chatgpt:example.com` where `example.com` is your base domain, not the `matrix.` domain)." msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:75 +msgid "After the bot joins the room, you can send a message to it. When you do so, use the prefix if you configured it or mention the bot." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:77 msgid "You can also refer to the upstream [documentation](https://github.com/matrixgpt/matrix-chatgpt-bot)." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po index 5fad573c4..70ab42f91 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -53,7 +53,7 @@ msgid "The playbook does not automatically create users for you. You **need to r msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:17 -msgid "Choose a strong password for the bot. You can generate a good password with a command like this: `pwgen -s 64 1`." +msgid "Generate a strong password for the bot. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:19 @@ -65,7 +65,7 @@ msgid "If you would like Draupnir to be able to deactivate users, move aliases, msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:27 -msgid "Get an access token" +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:29 @@ -73,309 +73,313 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:31 -msgid "Make sure the account is free from rate limiting" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:33 -msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Draupnir will crash.**" +msgid "Make sure the account is free from rate limiting" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:35 -msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Draupnir will crash.**" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:37 +msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:39 msgid "To expose the APIs publicly, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:43 +#: ../../../docs/configuring-playbook-bot-draupnir.md:45 msgid "The APIs can also be accessed via [Synapse Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can use to administrate users, rooms, media, etc. on your Matrix server. The playbook can install and configure Synapse Admin for you. For details about it, see [this page](configuring-playbook-synapse-admin.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:45 +#: ../../../docs/configuring-playbook-bot-draupnir.md:47 msgid "**Note**: access to the APIs is restricted with a valid access token, so exposing them publicly should not be a real security concern. Still, doing so is not recommended for additional security. See [official Synapse reverse-proxying recommendations](https://element-hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-endpoints)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:47 +#: ../../../docs/configuring-playbook-bot-draupnir.md:49 msgid "To discharge rate limiting, run the following command on systems that ship curl (note that it does not work on outdated Windows 10). Even if the APIs are not exposed to the internet, you should still be able to run the command on the homeserver locally. Before running it, make sure to replace `@bot.draupnir:example.com` with the MXID of your Draupnir:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:53 +#: ../../../docs/configuring-playbook-bot-draupnir.md:55 msgid "You can obtain an access token for a homeserver admin account in the same way as you can do so for Draupnir itself. If you have made Draupnir an admin, you can just use the Draupnir token." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:55 +#: ../../../docs/configuring-playbook-bot-draupnir.md:57 msgid "Create a management room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:57 +#: ../../../docs/configuring-playbook-bot-draupnir.md:59 msgid "Using your own account, create a new invite only room that you will use to manage the bot. This is the room where you will see the status of the bot and where you will send commands to the bot, such as the command to ban a user from another room. Anyone in this room can control the bot so it is important that you only invite trusted users to this room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:59 +#: ../../../docs/configuring-playbook-bot-draupnir.md:61 msgid "If you make the management room encrypted (E2EE), then you MUST enable and use Pantalaimon (see [below](#configuration-with-e2ee-support))." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:61 +#: ../../../docs/configuring-playbook-bot-draupnir.md:63 msgid "Once you have created the room you need to copy the room ID so you can tell the bot to use that room. In Element Web you can do this by going to the room's settings, clicking Advanced, and then copying the internal room ID. The room ID will look something like `!qporfwt:example.com`." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:63 +#: ../../../docs/configuring-playbook-bot-draupnir.md:65 msgid "Finally invite the `@bot.draupnir:example.com` account you created earlier into the room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:65 +#: ../../../docs/configuring-playbook-bot-draupnir.md:67 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:67 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `MANAGEMENT_ROOM_ID_HERE`." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-draupnir.md:76 -msgid "End-to-End Encryption support" +#: ../../../docs/configuring-playbook-bot-draupnir.md:69 +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `MANAGEMENT_ROOM_ID_HERE`." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:78 -msgid "Decide whether you want Draupnir to be capable of operating in end-to-end encrypted (E2EE) rooms. This includes the management room and the moderated rooms." +msgid "End-to-End Encryption support" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:80 -msgid "To support E2EE, Draupnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)." +msgid "Decide whether you want Draupnir to be capable of operating in end-to-end encrypted (E2EE) rooms. This includes the management room and the moderated rooms." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:82 -msgid "Configuration with E2EE support" +msgid "To support E2EE, Draupnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:84 -msgid "When using Pantalaimon, Draupnir will log in to its bot account itself through Pantalaimon, so configure its username and password." +msgid "Configuration with E2EE support" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:86 +msgid "When using Pantalaimon, Draupnir will log in to its bot account itself through Pantalaimon, so configure its username and password." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:88 msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:100 +#: ../../../docs/configuring-playbook-bot-draupnir.md:102 msgid "The playbook's `group_vars` will configure other required settings. If using this role separately without the playbook, you also need to configure the two URLs that Draupnir uses to reach the homeserver, one through Pantalaimon and one \"raw\". This example is taken from the playbook's `group_vars`:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:112 +#: ../../../docs/configuring-playbook-bot-draupnir.md:114 msgid "Configuration without E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:114 +#: ../../../docs/configuring-playbook-bot-draupnir.md:116 msgid "When NOT using Pantalaimon, Draupnir does not log in by itself and you must give it an access token for its bot account." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:116 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-token)." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-draupnir.md:122 -msgid "Abuse Reports" +#: ../../../docs/configuring-playbook-bot-draupnir.md:118 +msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:124 -msgid "Draupnir supports two methods to receive reports in the management room." +msgid "Abuse Reports" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:126 +msgid "Draupnir supports two methods to receive reports in the management room." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:128 msgid "The first method intercepts the report API endpoint of the client-server API, which requires integration with the reverse proxy in front of the homeserver. If you are using traefik, this playbook can set this up for you:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:132 +#: ../../../docs/configuring-playbook-bot-draupnir.md:134 msgid "The other method polls an Synapse Admin API endpoint, hence it is available only if using Synapse and if the Draupnir user is an admin (see [above](#register-the-bot-account)). To enable it, set `pollReports: true` on `vars.yml` file as below." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:134 +#: ../../../docs/configuring-playbook-bot-draupnir.md:136 msgid "Extending the configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:136 +#: ../../../docs/configuring-playbook-bot-draupnir.md:138 msgid "You can configure additional options by adding the `matrix_bot_draupnir_configuration_extension_yaml` variable." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:138 +#: ../../../docs/configuring-playbook-bot-draupnir.md:140 msgid "For example, to change Draupnir's `pollReports` option to `true`, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:152 +#: ../../../docs/configuring-playbook-bot-draupnir.md:154 msgid "Migrating from Mjolnir (Only required if migrating)" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:154 +#: ../../../docs/configuring-playbook-bot-draupnir.md:156 msgid "Replace your `matrix_bot_mjolnir` config with `matrix_bot_draupnir` config. Also disable Mjolnir if you're doing migration." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:156 +#: ../../../docs/configuring-playbook-bot-draupnir.md:158 msgid "That is all you need to do due to that Draupnir can complete migration on its own." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:158 +#: ../../../docs/configuring-playbook-bot-draupnir.md:160 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:160 +#: ../../../docs/configuring-playbook-bot-draupnir.md:162 msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:167 +#: ../../../docs/configuring-playbook-bot-draupnir.md:169 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:169 +#: ../../../docs/configuring-playbook-bot-draupnir.md:171 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:171 +#: ../../../docs/configuring-playbook-bot-draupnir.md:173 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:173 +#: ../../../docs/configuring-playbook-bot-draupnir.md:175 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:175 +#: ../../../docs/configuring-playbook-bot-draupnir.md:177 msgid "If you change the Pantalaimon's password (`matrix_bot_draupnir_pantalaimon_password` in your `vars.yml` file) subsequently, its credentials on the homeserver won't be updated automatically. If you'd like to change the password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_draupnir_pantalaimon_password` to let Pantalaimon know its new password." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:177 +#: ../../../docs/configuring-playbook-bot-draupnir.md:179 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:179 +#: ../../../docs/configuring-playbook-bot-draupnir.md:181 msgid "You can refer to the upstream [documentation](https://the-draupnir-project.github.io/draupnir-documentation/) for additional ways to use and configure Draupnir and for a more detailed usage guide." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:181 +#: ../../../docs/configuring-playbook-bot-draupnir.md:183 msgid "Below is a **non-exhaustive quick-start guide** for the impatient." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:183 +#: ../../../docs/configuring-playbook-bot-draupnir.md:185 msgid "Making Draupnir join and protect a room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:185 +#: ../../../docs/configuring-playbook-bot-draupnir.md:187 msgid "Draupnir can be told to self-join public rooms, but it's better to follow this flow which works well for all kinds of rooms:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:187 +#: ../../../docs/configuring-playbook-bot-draupnir.md:189 msgid "Invite the bot to the room manually ([inviting Draupnir to rooms](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#inviting-draupnir-to-rooms)). Before joining, the bot *may* ask for confirmation in the Management Room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:189 +#: ../../../docs/configuring-playbook-bot-draupnir.md:191 msgid "[Give the bot permissions to do its job](#giving-draupnir-permissions-to-do-its-job)" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:191 +#: ../../../docs/configuring-playbook-bot-draupnir.md:193 msgid "Tell it to protect the room (using the [rooms command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#using-the-draupnir-rooms-command)) by sending the following command to the Management Room: `!draupnir rooms add !qporfwt:example.com`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:193 +#: ../../../docs/configuring-playbook-bot-draupnir.md:195 msgid "To have Draupnir provide useful room protection, you need do to a bit more work (at least the first time around). You may wish to [Subscribe to a public policy list](#subscribing-to-a-public-policy-list), [Create your own own policy and rules](#creating-your-own-policy-lists-and-rules) and [Enabling built-in protections](#enabling-built-in-protections)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:195 +#: ../../../docs/configuring-playbook-bot-draupnir.md:197 msgid "Giving Draupnir permissions to do its job" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:197 +#: ../../../docs/configuring-playbook-bot-draupnir.md:199 msgid "For Draupnir to do its job, you need to [give it permissions](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#giving-draupnir-permissions) in rooms it's protecting. This involves **giving it an Administrator power level**." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:199 +#: ../../../docs/configuring-playbook-bot-draupnir.md:201 msgid "**We recommend setting this power level as soon as the bot joins your room** (and before you create new rules), so that it can apply rules as soon as they are available. If the bot is under-privileged, it may fail to apply protections and may not retry for a while (or until your restart it)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:201 +#: ../../../docs/configuring-playbook-bot-draupnir.md:203 msgid "Subscribing to a public policy list" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:203 +#: ../../../docs/configuring-playbook-bot-draupnir.md:205 msgid "We recommend **subscribing to a public [policy list](https://the-draupnir-project.github.io/draupnir-documentation/concepts/policy-lists)** using the [watch command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-watch-command-to-subscribe-to-policy-rooms)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:205 +#: ../../../docs/configuring-playbook-bot-draupnir.md:207 msgid "Polcy lists are maintained in Matrix rooms. A popular policy list is maintained in the public `#community-moderation-effort-bl:neko.dev` room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:207 +#: ../../../docs/configuring-playbook-bot-draupnir.md:209 msgid "You can tell Draupnir to subscribe to it by sending the following command to the Management Room: `!draupnir watch #community-moderation-effort-bl:neko.dev`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:209 +#: ../../../docs/configuring-playbook-bot-draupnir.md:211 msgid "Creating your own policy lists and rules" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:211 +#: ../../../docs/configuring-playbook-bot-draupnir.md:213 msgid "We also recommend **creating your own policy lists** with the [list create](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-list-create-command-to-create-a-policy-room) command." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:213 +#: ../../../docs/configuring-playbook-bot-draupnir.md:215 msgid "You can do so by sending the following command to the Management Room: `!draupnir list create my-bans my-bans-bl`. This will create a policy list having a name (shortcode) of `my-bans` and stored in a public `#my-bans-bl:example.com` room on your server. As soon as you run this command, the bot will invite you to the policy list room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:215 +#: ../../../docs/configuring-playbook-bot-draupnir.md:217 msgid "A policy list does nothing by itself, so the next step is **adding some rules to your policy list**. Policies target a so-called `entity` (one of: `user`, `room` or `server`). These entities are mentioned on the [policy lists](https://the-draupnir-project.github.io/draupnir-documentation/concepts/policy-lists) documentation page and in the Matrix Spec [here](https://spec.matrix.org/v1.11/client-server-api/#mban-recommendation)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:217 +#: ../../../docs/configuring-playbook-bot-draupnir.md:219 msgid "The simplest and most useful entity to target is `user`. Below are a few examples using the [ban command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-users#the-ban-command) and targeting users." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:219 +#: ../../../docs/configuring-playbook-bot-draupnir.md:221 msgid "To create rules, you run commands in the Management Room (**not** in the policy list room)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:221 +#: ../../../docs/configuring-playbook-bot-draupnir.md:223 msgid "(ban a single user on a given homeserver): `!draupnir ban @charles:example.com my-bans Rude to others`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:222 +#: ../../../docs/configuring-playbook-bot-draupnir.md:224 msgid "(ban all users on a given homeserver by using a [wildcard](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-users#wildcards)): `!draupnir ban @*:example.org my-bans Spam server - all users are fake`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:224 +#: ../../../docs/configuring-playbook-bot-draupnir.md:226 msgid "As a result of running these commands, you may observe:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:226 +#: ../../../docs/configuring-playbook-bot-draupnir.md:228 msgid "Draupnir creating `m.policy.rule.user` state events in the `#my-bans-bl:example.com` room on your server" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:227 +#: ../../../docs/configuring-playbook-bot-draupnir.md:229 msgid "applying these rules against all rooms that Draupnir is an Administrator in" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:229 +#: ../../../docs/configuring-playbook-bot-draupnir.md:231 msgid "You can undo bans with the [unban command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-users#the-unban-command)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:231 +#: ../../../docs/configuring-playbook-bot-draupnir.md:233 msgid "Enabling built-in protections" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:233 +#: ../../../docs/configuring-playbook-bot-draupnir.md:235 msgid "You can also **turn on various built-in [protections](https://the-draupnir-project.github.io/draupnir-documentation/protections)** like `JoinWaveShortCircuit` (\"If X amount of users join in Y time, set the room to invite-only\")." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:235 +#: ../../../docs/configuring-playbook-bot-draupnir.md:237 msgid "To **see which protections are available and which are enabled**, send a `!draupnir protections` command to the Management Room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:237 +#: ../../../docs/configuring-playbook-bot-draupnir.md:239 msgid "To **see the configuration options for a given protection**, send a `!draupnir config get PROTECTION_NAME` (e.g. `!draupnir config get JoinWaveShortCircuit`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:239 +#: ../../../docs/configuring-playbook-bot-draupnir.md:241 msgid "To **set a specific option for a given protection**, send a command like this: `!draupnir config set PROTECTION_NAME.OPTION VALUE` (e.g. `!draupnir config set JoinWaveShortCircuit.timescaleMinutes 30`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:241 +#: ../../../docs/configuring-playbook-bot-draupnir.md:243 msgid "To **enable a given protection**, send a command like this: `!draupnir enable PROTECTION_NAME` (e.g. `!draupnir enable JoinWaveShortCircuit`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:243 +#: ../../../docs/configuring-playbook-bot-draupnir.md:245 msgid "To **disable a given protection**, send a command like this: `!draupnir disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po index fda8f1717..2009436c9 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -41,19 +41,19 @@ msgid "See the project's [documentation](https://github.com/matrix-org/go-neb/bl msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:11 -msgid "Registering the bot account" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:13 -msgid "The playbook does not automatically create users for you. The bot requires at least 1 access token to be able to connect to your homeserver." +msgid "Register the bot account" msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:15 -msgid "You **need to register the bot user manually** before setting up the bot." +msgid "The playbook does not automatically create users for you. You **need to register the bot user manually** before setting up the bot." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:17 -msgid "Choose a strong password for the bot. You can generate a good password with a command like this: `pwgen -s 64 1`." +msgid "Generate a strong password for the bot. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:19 @@ -61,89 +61,97 @@ msgid "You can use the playbook to [register a new user](registering-users.md):" msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:25 -msgid "Once the user is created you can [obtain an access token](obtaining-access-tokens.md)." +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:27 -msgid "Adjusting the playbook configuration" +msgid "The bot requires an access token to be able to connect to your homeserver. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:29 -msgid "To enable Go-NEB, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:193 -msgid "Adjusting the Go-NEB URL" +#: ../../../docs/configuring-playbook-bot-go-neb.md:31 +msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:195 -msgid "By default, this playbook installs Go-NEB on the `goneb.` subdomain (`goneb.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." +#: ../../../docs/configuring-playbook-bot-go-neb.md:33 +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_FOR_GONEB_HERE` and `ACCESS_TOKEN_FOR_ANOTHER_GONEB_HERE` with the ones created [above](#obtain-an-access-token)." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:197 -msgid "By tweaking the `matrix_bot_go_neb_hostname` and `matrix_bot_go_neb_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." +msgid "Adjusting the Go-NEB URL" msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:199 +msgid "By default, this playbook installs Go-NEB on the `goneb.` subdomain (`goneb.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-go-neb.md:201 +msgid "By tweaking the `matrix_bot_go_neb_hostname` and `matrix_bot_go_neb_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-go-neb.md:203 msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:210 +#: ../../../docs/configuring-playbook-bot-go-neb.md:214 msgid "Adjusting DNS records" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:212 +#: ../../../docs/configuring-playbook-bot-go-neb.md:216 msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Go-NEB domain to the Matrix server." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:214 +#: ../../../docs/configuring-playbook-bot-go-neb.md:218 msgid "By default, you will need to create a CNAME record for `goneb`. See [Configuring DNS](configuring-dns.md) for details about DNS changes." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:216 +#: ../../../docs/configuring-playbook-bot-go-neb.md:220 msgid "If you've decided to reuse the `matrix.` domain, you won't need to do any extra DNS configuration." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:218 +#: ../../../docs/configuring-playbook-bot-go-neb.md:222 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:220 +#: ../../../docs/configuring-playbook-bot-go-neb.md:224 msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:227 +#: ../../../docs/configuring-playbook-bot-go-neb.md:231 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:229 +#: ../../../docs/configuring-playbook-bot-go-neb.md:233 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:231 +#: ../../../docs/configuring-playbook-bot-go-neb.md:235 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:233 +#: ../../../docs/configuring-playbook-bot-go-neb.md:237 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:235 +#: ../../../docs/configuring-playbook-bot-go-neb.md:239 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:237 +#: ../../../docs/configuring-playbook-bot-go-neb.md:241 msgid "To use the bot, invite it to any existing Matrix room (`/invite @bot.go-neb:example.com` where `example.com` is your base domain, not the `matrix.` domain). Make sure you are granted with the sufficient permission if you are not the room owner." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:239 +#: ../../../docs/configuring-playbook-bot-go-neb.md:243 msgid "Basic usage is like this: `!echo hi` or `!imgur puppies` or `!giphy matrix`" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:241 -msgid "If you enabled the github_cmd service you can get the supported commands via `!github help`" +#: ../../../docs/configuring-playbook-bot-go-neb.md:245 +msgid "If you enabled the github_cmd service, send `!github help` to the bot in the room to see the available commands." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:243 +#: ../../../docs/configuring-playbook-bot-go-neb.md:247 msgid "You can also refer to the upstream [Documentation](https://github.com/matrix-org/go-neb)." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po index e996cc5a3..2cf15ee0d 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -41,7 +41,7 @@ msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:11 -msgid "To enable Honoroit, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:26 @@ -109,13 +109,17 @@ msgid "Usage" msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:69 -msgid "To use the bot, invite the `@honoroit:example.com` to the room you specified in config, after that any Matrix user can send a message to the `@honoroit:example.com` to start a new thread in that room." +msgid "To use the bot, invite it to the room you specified on your `vars.yml` file (`/invite @honoroit:example.com` where `example.com` is your base domain, not the `matrix.` domain)." msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:71 -msgid "Send `!ho help` to the room to see the bot's help menu for additional commands." +msgid "After the bot joins the room, any Matrix user can send a message to it to start a new thread in that room." msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:73 +msgid "Send `!ho help` to the bot in the room to see the available commands." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-honoroit.md:75 msgid "You can also refer to the upstream [documentation](https://github.com/etkecc/honoroit#features)." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po index d5efd5bbc..b3110a4dc 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -37,7 +37,7 @@ msgid "See the project's [documentation](https://github.com/moan0s/matrix-regist msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:9 -msgid "Configuration" +msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:11 @@ -85,7 +85,7 @@ msgid "To use the bot, start a chat with `@bot.matrix-registration-bot:example.c msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:55 -msgid "In this room send `help` and the bot will reply with all options." +msgid "Send `help` to the bot to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:57 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po index d6abfb68d..20f7e1e24 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -41,7 +41,7 @@ msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:11 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:26 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po index b2e8d722c..2ea984e1e 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -41,7 +41,7 @@ msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:11 -msgid "To enable maubot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:26 @@ -61,6 +61,7 @@ msgid "By tweaking the `matrix_bot_maubot_hostname` and `matrix_bot_maubot_path_ msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:34 +#: ../../../docs/configuring-playbook-bot-maubot.md:56 msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" @@ -81,65 +82,85 @@ msgid "If you've decided to use the default hostname, you won't need to do any e msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:50 -msgid "Installing" +msgid "Customizing the maubot container image" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:52 -msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" +msgid "Certain [maubot plugins](https://plugins.mau.bot/) require additional dependencies to be installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-maubot.md:59 -msgid "**Notes**:" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:61 -msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:63 -msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:65 -msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." +#: ../../../docs/configuring-playbook-bot-maubot.md:54 +msgid "You can customize the default maubot container image and install your own dependencies." msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:67 -msgid "If you change the bot password (`matrix_bot_maubot_initial_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_maubot_initial_password` to let the bot know its new password." +msgid "Consult the [Dockerfile reference](https://docs.docker.com/reference/dockerfile/) for more information about the syntax." msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:69 -msgid "Usage" +msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:71 -msgid "By default, you can visit `matrix.example.com/_matrix/maubot/` to manage your available plugins, clients and instances." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:73 -msgid "You should start in the following order" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:74 -msgid "**Create one or more clients**: A client is a Matrix account which the bot will use to message. By default, the playbook creates a `bot.maubot` account (as per the configuration above). You only need to [obtain an access token](#obtaining-an-access-token) for it" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:75 -msgid "**Upload some Plugins**: Plugins can be obtained from [here](https://github.com/maubot/maubot#plugins) or any other source." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:76 -msgid "**Create an instance**: An instance is the actual bot. You have to specify a client which the bot instance will use and the plugin (how the bot will behave)" +msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:78 -msgid "Obtaining an access token" +msgid "**Notes**:" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:80 -msgid "This can be done via `mbc login` then `mbc auth` (see the [maubot documentation](https://docs.mau.fi/maubot/usage/cli/auth.html)). To run these commands, you'll first need to `exec` into the maubot container with `docker exec -it matrix-bot-maubot sh`." +msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:82 -msgid "Alternatively, you can follow our generic [obtain an access token](obtaining-access-tokens.md) documentation. Be aware that you'd better use the **Obtain an access token via curl** method (not **Obtain an access token via Element Web**) as the latter will give your bot issues in encrypted rooms. Read [more](https://docs.mau.fi/maubot/usage/basic.html#creating-clients)." +msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:84 +msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:86 +msgid "If you change the bot password (`matrix_bot_maubot_initial_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_maubot_initial_password` to let the bot know its new password." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:88 +msgid "Usage" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:90 +msgid "By default, you can visit `matrix.example.com/_matrix/maubot/` to manage your available plugins, clients and instances." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:92 +msgid "You should start in the following order" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:93 +msgid "**Create one or more clients**: A client is a Matrix account which the bot will use to message. By default, the playbook creates a `bot.maubot` account (as per the configuration above). You only need to [obtain an access token](#obtaining-an-access-token) for it" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:94 +msgid "**Upload some Plugins**: Plugins can be obtained from [here](https://github.com/maubot/maubot#plugins) or any other source." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:95 +msgid "**Create an instance**: An instance is the actual bot. You have to specify a client which the bot instance will use and the plugin (how the bot will behave)" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:97 +msgid "Obtain an access token" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:99 +msgid "This can be done via `mbc login` then `mbc auth` (see the [maubot documentation](https://docs.mau.fi/maubot/usage/cli/auth.html)). To run these commands, you'll first need to `exec` into the maubot container with `docker exec -it matrix-bot-maubot sh`." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:101 +msgid "Alternatively, you can refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md). Be aware that you'd better use the **Obtain an access token via curl** method (not **Obtain an access token via Element Web**) as the latter will causes issues to your bot in encrypted rooms. Read [more](https://docs.mau.fi/maubot/usage/basic.html#creating-clients)." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:103 +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po index 4d52e2e66..2cac78d7c 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -45,7 +45,7 @@ msgid "The playbook does not automatically create users for you. You **need to r msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:13 -msgid "Choose a strong password for the bot. You can generate a good password with a command like this: `pwgen -s 64 1`." +msgid "Generate a strong password for the bot. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:15 @@ -57,7 +57,7 @@ msgid "If you would like Mjolnir to be able to deactivate users, move aliases, s msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:23 -msgid "Get an access token" +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:25 @@ -65,157 +65,161 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:27 -msgid "Make sure the account is free from rate limiting" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:29 -msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Mjolnir will crash.**" +msgid "Make sure the account is free from rate limiting" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:31 -msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Mjolnir will crash.**" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:33 +msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-mjolnir.md:35 msgid "To expose the APIs publicly, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:39 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:41 msgid "The APIs can also be accessed via [Synapse Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can use to administrate users, rooms, media, etc. on your Matrix server. The playbook can install and configure Synapse Admin for you. For details about it, see [this page](configuring-playbook-synapse-admin.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:41 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:43 msgid "**Note**: access to the APIs is restricted with a valid access token, so exposing them publicly should not be a real security concern. Still, doing so is not recommended for additional security. See [official Synapse reverse-proxying recommendations](https://element-hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-endpoints)." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:43 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:45 msgid "To discharge rate limiting, run the following command on systems that ship curl (note that it does not work on outdated Windows 10). Even if the APIs are not exposed to the internet, you should still be able to run the command on the homeserver locally. Before running it, make sure to replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:49 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:51 msgid "You can obtain an access token for a homeserver admin account in the same way as you can do so for Mjolnir itself. If you have made Mjolnir an admin, you can just use the Mjolnir token." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:51 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:53 msgid "Create a management room" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:53 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:55 msgid "Using your own account, create a new invite only room that you will use to manage the bot. This is the room where you will see the status of the bot and where you will send commands to the bot, such as the command to ban a user from another room. Anyone in this room can control the bot so it is important that you only invite trusted users to this room." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:55 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:57 msgid "If you make the management room encrypted (E2EE), then you MUST enable and use Pantalaimon (see [below](#configuration-with-e2ee-support))." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:57 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:59 msgid "Once you have created the room you need to copy the room ID so you can tell the bot to use that room. In Element Web you can do this by going to the room's settings, clicking Advanced, and then copying the internal room ID. The room ID will look something like `!qporfwt:example.com`." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:59 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:61 msgid "Finally invite the `@bot.mjolnir:example.com` account you created earlier into the room." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:61 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:63 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:63 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `MANAGEMENT_ROOM_ID_HERE`." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-mjolnir.md:72 -msgid "End-to-End Encryption support" +#: ../../../docs/configuring-playbook-bot-mjolnir.md:65 +msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `MANAGEMENT_ROOM_ID_HERE`." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:74 -msgid "Decide whether you want Mjolnir to be capable of operating in end-to-end encrypted (E2EE) rooms. This includes the management room and the moderated rooms." +msgid "End-to-End Encryption support" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:76 -msgid "To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)." +msgid "Decide whether you want Mjolnir to be capable of operating in end-to-end encrypted (E2EE) rooms. This includes the management room and the moderated rooms." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:78 -msgid "Configuration with E2EE support" +msgid "To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:80 -msgid "When using Pantalaimon, Mjolnir will log in to its bot account itself through Pantalaimon, so configure its username and password." +msgid "Configuration with E2EE support" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:82 +msgid "When using Pantalaimon, Mjolnir will log in to its bot account itself through Pantalaimon, so configure its username and password." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-mjolnir.md:84 msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:96 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:98 msgid "The playbook's `group_vars` will configure other required settings. If using this role separately without the playbook, you also need to configure the two URLs that Mjolnir uses to reach the homeserver, one through Pantalaimon and one \"raw\". This example is taken from the playbook's `group_vars`:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:108 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:110 msgid "Configuration without E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:110 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:112 msgid "When NOT using Pantalaimon, Mjolnir does not log in by itself and you must give it an access token for its bot account." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:112 -msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-token)." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-mjolnir.md:118 -msgid "Adding Mjolnir synapse antispam module (optional)" +#: ../../../docs/configuring-playbook-bot-mjolnir.md:114 +msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:120 +msgid "Adding Mjolnir synapse antispam module (optional)" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-mjolnir.md:122 msgid "To enable Mjolnir synapse antispam module, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:130 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:132 msgid "Extending the configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:132 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:134 msgid "You can configure additional options by adding the `matrix_bot_mjolnir_configuration_extension_yaml` variable to your `inventory/host_vars/matrix.example.com/vars.yml` file." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:134 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:136 msgid "For example, to change Mjolnir's `recordIgnoredInvites` option to `true`, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:148 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:150 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:150 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:152 msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:157 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:159 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:159 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:161 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:161 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:163 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:163 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:165 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:165 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:167 msgid "If you change the Pantalaimon's password (`matrix_bot_mjolnir_pantalaimon_password` in your `vars.yml` file) subsequently, its credentials on the homeserver won't be updated automatically. If you'd like to change the password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_mjolnir_pantalaimon_password` to let Pantalaimon know its new password." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:167 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:169 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:169 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:171 msgid "You can refer to the upstream [documentation](https://github.com/matrix-org/mjolnir) for additional ways to use and configure Mjolnir. Check out their [quickstart guide](https://github.com/matrix-org/mjolnir#quickstart-guide) for some basic commands you can give to the bot." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po index 9597f9293..555b4be9c 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -114,7 +114,7 @@ msgid "If the bot is not already in the Discord server, follow the provided invi msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-discord.md:66 -msgid "On the Discord side, you can say `!matrix help` to get a list of available commands to manage the bridge and Matrix users." +msgid "On the Discord side, send `!matrix help` to the bot to see the available commands for managing the bridge and Matrix users." msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-discord.md:68 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po index be0b9f9c8..879f96227 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -149,7 +149,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:73 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:75 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po index 958c405a0..4cf9ddce5 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -73,5 +73,5 @@ msgid "To use the bridge, you need to start a chat with `Skype bridge bot` with msgstr "" #: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:36 -msgid "Send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po index e7459a3d9..cd25974f7 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -113,7 +113,7 @@ msgid "Make sure the bot is able to send state events (usually the Moderator pow msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:64 -msgid "Send `!hookshot help` to the room to see the bridge's help menu for additional commands." +msgid "Send `!hookshot help` to the bot to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:66 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po index fa8864352..c37fee3cc 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -173,7 +173,7 @@ msgid "After confirming (in the Discord app) that you'd like to allow this login msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:79 -msgid "Now that you're logged in, you can send a `help` command to the bot again, to see additional commands you have access to" +msgid "Now that you're logged in, you can send `help` to the bot to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:80 @@ -233,7 +233,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:104 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:106 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po index 4ff5d1c8a..bb31537fd 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -149,7 +149,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:99 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:101 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po index befacc522..9ddab67b7 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -117,7 +117,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:58 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:60 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po index adf3e0f3b..843db4c5a 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -137,7 +137,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:68 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:70 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po index 0aca553fe..1bfea7e5b 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -137,7 +137,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:68 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:70 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po index 71919b61e..162d6c528 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -197,7 +197,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:107 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:109 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po index ed1a47c96..62e9ae19b 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -233,7 +233,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:124 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:126 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po index 529fb825d..cd3278b10 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -185,7 +185,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:109 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:111 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po index 0ba7b089c..13eb94f02 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -145,7 +145,7 @@ msgid "The bot should respond with \"Successfully logged into for team < msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:66 -msgid "Now that you're logged in, you can send a `help` command to the bot again, to see additional commands you have access to." +msgid "Now that you're logged in, you can send `help` to the bot to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:67 @@ -185,7 +185,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:85 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:87 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po index 0415d7248..1246af68f 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -141,7 +141,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:91 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:93 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po index e05a23047..f2c461f42 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -133,7 +133,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:65 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:67 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po index db8a16cff..2e12be38c 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -137,7 +137,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:76 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:78 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po index be69ce8ad..fc6d17c55 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -97,5 +97,5 @@ msgid "Clicking rooms in the list will result in you receiving an invitation to msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:46 -msgid "Also send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po index 7b9c350c6..c59253dc7 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -89,5 +89,5 @@ msgid "Clicking rooms in the list will result in you receiving an invitation to msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:48 -msgid "Also send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po index d58429322..3b479cfdc 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -101,5 +101,5 @@ msgid "If you are linking only one Instagram account, your `$puppetId` is probab msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:48 -msgid "The `help` command shows which commands are available, though at the time of writing, not every command is fully implemented." +msgid "Send `help` to the bot to see the available commands. At the time of writing, not every command is fully implemented." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po index e0cc1584d..9b7f2c028 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -97,5 +97,5 @@ msgid "Clicking rooms in the list will result in you receiving an invitation to msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:51 -msgid "Also send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po index 39037aabe..9b162ca65 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -85,5 +85,5 @@ msgid "Clicking rooms in the list will result in you receiving an invitation to msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:42 -msgid "Also send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po index 405bfd428..00f617467 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -97,5 +97,5 @@ msgid "Clicking rooms in the list will result in you receiving an invitation to msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:53 -msgid "Also send `help` to the bot to see the commands available." +msgid "Send `help` to the bot to see the available commands." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po index 87c74e8c5..6e8b01d9e 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -121,7 +121,7 @@ msgid "Then send `!pm mailbox NAME` to expose this Matrix room as an inbox with msgstr "" #: ../../../docs/configuring-playbook-bridge-postmoogle.md:74 -msgid "Send `!pm help` to the room to see the bridge's help menu for additional commands." +msgid "Send `!pm help` to the bot in the room to see the available commands." msgstr "" #: ../../../docs/configuring-playbook-bridge-postmoogle.md:76 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po index 15d9c546e..77b63cfc0 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 23:17+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -125,7 +125,7 @@ msgid "Upon starting Cactus Comments, a `bot.cactusbot` user account is created msgstr "" #: ../../../docs/configuring-playbook-cactus-comments.md:85 -msgid "To get started, send a `help` message to the `@bot.cactusbot:example.com` bot to confirm it's working." +msgid "To get started, send `help` to the `@bot.cactusbot:example.com` bot to confirm it's working." msgstr "" #: ../../../docs/configuring-playbook-cactus-comments.md:87 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-dimension.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-dimension.po index ed1278ad1..70fd29702 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-dimension.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-dimension.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -25,137 +25,158 @@ msgid "Setting up Dimension integration manager (optional, unmaintained)" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:3 -msgid "**[Dimension](https://dimension.t2bot.io) can only be installed after Matrix services are installed and running.** If you're just installing Matrix services for the first time, please continue with the [Configuration](configuring-playbook.md) / [Installation](installing.md) flow and come back here later." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:5 -msgid "**Note**: Dimension is **[officially unmaintained](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/2806#issuecomment-1673559299)**. We recommend not bothering with installing it." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:7 -msgid "**Note**: This playbook now supports running [Dimension](https://dimension.t2bot.io) in both a federated and [unfederated](https://github.com/turt2live/matrix-dimension/blob/master/docs/unfederated.md) environments. This is handled automatically based on the value of `matrix_homeserver_federation_enabled`. Enabling Dimension, means that the `openid` API endpoints will be exposed on the Matrix Federation port (usually `8448`), even if [federation](configuring-playbook-federation.md) is disabled. It's something to be aware of, especially in terms of firewall whitelisting (make sure port `8448` is accessible)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:9 -msgid "Adjusting the playbook configuration" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:11 -msgid "To enable Dimension, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:17 -msgid "Define admin users" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:19 -msgid "These users can modify the integrations this Dimension supports. Add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:27 -msgid "The admin interface is accessible within Element Web by accessing it in any room and clicking the cog wheel/settings icon in the top right. Currently, Dimension can be opened in Element Web by the \"Add widgets, bridges, & bots\" link in the room information." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:29 -msgid "Access token" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:31 -msgid "We recommend that you create a dedicated Matrix user for Dimension (`dimension` is a good username). Follow our [Registering users](registering-users.md) guide to learn how to register **a regular (non-admin) user**." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:33 -msgid "You are required to specify an access token (belonging to this new user) for Dimension to work. To get an access token for the Dimension user, you can follow the documentation on [how to do obtain an access token](obtaining-access-tokens.md)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:35 -msgid "**Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone.**" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:37 -msgid "Add access token to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:43 -msgid "For more information on how to acquire an access token, visit [https://t2bot.io/docs/access_tokens](https://t2bot.io/docs/access_tokens)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:45 -msgid "Adjusting the Dimension URL" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:47 -msgid "By default, this playbook installs Dimension on the `dimension.` subdomain (`dimension.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:49 -msgid "By tweaking the `matrix_dimension_hostname` and `matrix_dimension_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:51 -msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:62 -msgid "**Note**: While there is a `matrix_dimension_path_prefix` variable for changing the path where Dimension is served, overriding it is not possible due to [this Dimension issue](https://github.com/turt2live/matrix-dimension/issues/510). You must serve Dimension at a dedicated subdomain." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:64 -msgid "Adjusting DNS records" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:66 -msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Dimension domain to the Matrix server." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:68 -msgid "By default, you will need to create a CNAME record for `dimension`. See [Configuring DNS](configuring-dns.md) for details about DNS changes." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:70 -msgid "Installing" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:72 -msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:79 +#: ../../../docs/configuring-playbook-dimension.md:91 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:81 -msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" +#: ../../../docs/configuring-playbook-dimension.md:4 +msgid "Dimension is **[officially unmaintained](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/2806#issuecomment-1673559299)**. We recommend not bothering with installing it." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:83 -msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too." +#: ../../../docs/configuring-playbook-dimension.md:5 +msgid "This playbook now supports running Dimension in both a federated and [unfederated](https://github.com/turt2live/matrix-dimension/blob/master/docs/unfederated.md) environments. This is handled automatically based on the value of `matrix_homeserver_federation_enabled`. Enabling Dimension, means that the `openid` API endpoints will be exposed on the Matrix Federation port (usually `8448`), even if [federation](configuring-playbook-federation.md) is disabled. It's something to be aware of, especially in terms of firewall whitelisting (make sure port `8448` is accessible)." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:85 -msgid "After Dimension has been installed you may need to log out and log back in for it to pick up the new integration manager. Then you can access integrations in Element Web by opening a room, clicking the Room info button (`i`) button in the top right corner of the screen, and then clicking Add widgets, bridges & bots." +#: ../../../docs/configuring-playbook-dimension.md:7 +msgid "The playbook can install and configure the [Dimension](https://dimension.t2bot.io) integration manager for you." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:87 -msgid "Jitsi domain" +#: ../../../docs/configuring-playbook-dimension.md:9 +msgid "See the project's [documentation](https://github.com/turt2live/matrix-dimension/blob/master/README.md) to learn what it does and why it might be useful to you." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:89 -msgid "By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video conference widgets. For users running [a self-hosted Jitsi instance](./configuring-playbook-jitsi.md), you will likely want the widget to use your own Jitsi instance. Currently there is no way to configure this via the playbook, see [this issue](https://github.com/turt2live/matrix-dimension/issues/345) for details." +#: ../../../docs/configuring-playbook-dimension.md:11 +msgid "Prerequisites" msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:91 -msgid "In the interim until the above limitation is resolved, an admin user needs to configure the domain via the admin ui once dimension is running. In Element Web, go to *Manage Integrations* → *Settings* → *Widgets* → *Jitsi Conference Settings* and set *Jitsi Domain* and *Jitsi Script URL* appropriately." +#: ../../../docs/configuring-playbook-dimension.md:13 +msgid "Install Matrix services" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:15 +msgid "Dimension can only be installed after Matrix services are installed and running. If you're just installing Matrix services for the first time, please continue with the [Configuration](configuring-playbook.md) / [Installation](installing.md) and come back here later." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:17 +msgid "Register a dedicated Matrix user (optional, recommended)" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:19 +msgid "We recommend that you create a dedicated Matrix user for Dimension (`dimension` is a good username)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:21 +msgid "Generate a strong password for the user. You can create one with a command like `pwgen -s 64 1`." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:23 +msgid "You can use the playbook to [register a new user](registering-users.md):" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:29 +msgid "Obtain an access token" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:31 +msgid "Dimension requires an access token to be able to connect to your homeserver. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:33 +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:35 +msgid "Adjusting the playbook configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:37 +msgid "To enable Dimension, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`). Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:45 +msgid "Define admin users" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:47 +msgid "These users can modify the integrations this Dimension supports. Add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:55 +msgid "The admin interface is accessible within Element Web by accessing it in any room and clicking the cog wheel/settings icon in the top right. Currently, Dimension can be opened in Element Web by the \"Add widgets, bridges, & bots\" link in the room information." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:57 +msgid "Adjusting the Dimension URL" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:59 +msgid "By default, this playbook installs Dimension on the `dimension.` subdomain (`dimension.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:61 +msgid "By tweaking the `matrix_dimension_hostname` and `matrix_dimension_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:63 +msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:74 +msgid "**Note**: While there is a `matrix_dimension_path_prefix` variable for changing the path where Dimension is served, overriding it is not possible due to [this Dimension issue](https://github.com/turt2live/matrix-dimension/issues/510). You must serve Dimension at a dedicated subdomain." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:76 +msgid "Adjusting DNS records" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:78 +msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Dimension domain to the Matrix server." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:80 +msgid "By default, you will need to create a CNAME record for `dimension`. See [Configuring DNS](configuring-dns.md) for details about DNS changes." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:82 +msgid "Installing" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:84 +msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:93 -msgid "Additional features" +msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:95 -msgid "To use a more custom configuration, you can define a `matrix_dimension_configuration_extension_yaml` string variable and put your configuration in it. To learn more about how to do this, refer to the information about `matrix_dimension_configuration_extension_yaml` in the [default variables file](../roles/custom/matrix-dimension/defaults/main.yml) of the Dimension component." +msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:97 +msgid "After Dimension has been installed you may need to log out and log back in for it to pick up the new integration manager. Then you can access integrations in Element Web by opening a room, clicking the Room info button (`i`) button in the top right corner of the screen, and then clicking Add widgets, bridges & bots." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:99 +msgid "Jitsi domain" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:101 +msgid "By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video conference widgets. For users running [a self-hosted Jitsi instance](./configuring-playbook-jitsi.md), you will likely want the widget to use your own Jitsi instance. Currently there is no way to configure this via the playbook, see [this issue](https://github.com/turt2live/matrix-dimension/issues/345) for details." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:103 +msgid "In the interim until the above limitation is resolved, an admin user needs to configure the domain via the admin ui once dimension is running. In Element Web, go to *Manage Integrations* → *Settings* → *Widgets* → *Jitsi Conference Settings* and set *Jitsi Domain* and *Jitsi Script URL* appropriately." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:105 +msgid "Additional features" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:107 +msgid "To use a more custom configuration, you can define a `matrix_dimension_configuration_extension_yaml` string variable and put your configuration in it. To learn more about how to do this, refer to the information about `matrix_dimension_configuration_extension_yaml` in the [default variables file](../roles/custom/matrix-dimension/defaults/main.yml) of the Dimension component." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:109 msgid "You can find all configuration options on [GitHub page of Dimension project](https://github.com/turt2live/matrix-dimension/blob/master/config/default.yaml)." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po index 129b07f5c..8fcce52cb 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -69,113 +69,129 @@ msgid "For details about using Email2Matrix alongside [Postfix](http://www.postf msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:25 -msgid "Creating a user" +msgid "Register a dedicated Matrix user (optional, recommended)" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:27 -msgid "Before enabling Email2Matrix, you'd most likely wish to create a dedicated user (or more) that would be sending messages on the Matrix side. Take note of the user's ID as it needs to be specified as `MatrixUserId` on your `inventory/host_vars/matrix.example.com/vars.yml` file later." +msgid "We recommend that you create a dedicated Matrix user for Email2Matrix." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:29 -msgid "Refer to [Registering users](registering-users.md) for ways to create a user. A regular (non-admin) user works best." +msgid "Generate a strong password for the user. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:31 -msgid "Creating a shared room" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:33 -msgid "After creating the sender user, you should create one or more Matrix rooms that you share with that user. It doesn't matter who creates and owns the rooms and who joins later (you or the sender user)." -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:35 -msgid "What matters is that both you and the sender user are part of the same room and that the sender user has enough privileges in the room to be able to send messages there." +msgid "You can use the playbook to [register a new user](registering-users.md):" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:37 -msgid "Inviting additional people to the room is okay too." +msgid "Take note of the user's ID as it needs to be specified as `MatrixUserId` on your `inventory/host_vars/matrix.example.com/vars.yml` file later." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:39 -msgid "Take note of each room's room ID (different clients show the room ID in a different place). You'll need the room ID when [configuring the playbook](#adjusting-the-playbook-configuration) below." +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:41 -msgid "Obtaining an access token for the sender user" +msgid "Email2Matrix requires an access token for the sender user to be able to send messages to the room. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:43 -msgid "In order for the sender user created above to be able to send messages to the room, we'll need to obtain an access token for it. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:45 -msgid "Adjusting the playbook configuration" +msgid "Join to rooms as the sender user manually" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:47 -msgid "After doing the preparation steps above, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" +msgid "ℹ️ **Email2Matrix does not accept room invitations automatically**. To deliver messages to rooms, the sender user must be joined to all rooms manually." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:72 -msgid "where:" +#: ../../../docs/configuring-playbook-email2matrix.md:49 +msgid "For each new room you would like the user to deliver messages to, invite the user to the room." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:74 -msgid "MailboxName - local-part of the email address, through which emails are bridged to the room whose ID is defined with MatrixRoomId" +#: ../../../docs/configuring-playbook-email2matrix.md:51 +msgid "Then, log in as the sender user using any Matrix client of your choosing, accept the room invitation from the user's account." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:75 -msgid "MatrixRoomId - internal ID of the room, to which received emails are sent as Matrix message" +#: ../../../docs/configuring-playbook-email2matrix.md:53 +msgid "Make sure that you and the sender user are part of the same room and that the sender user has enough privileges in the room to be able to send messages there, then log out." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:76 -msgid "MatrixHomeserverUrl - URL of your Matrix homeserver, through which to send Matrix messages. You can also set `MatrixHomeserverUrl` to the container URL where your homeserver's Client-Server API lives by using the `{{ matrix_addons_homeserver_client_api_url }}` variable" +#: ../../../docs/configuring-playbook-email2matrix.md:55 +msgid "Take note of each room's room ID (different clients show the room ID in a different place). You'll need the room ID when [configuring the playbook](#adjusting-the-playbook-configuration) below." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:77 -msgid "MatrixUserId - the full ID of the sender user which sends bridged messages to the room. On this configuration it is `@email2matrix1:example.com` and `@email2matrix2:example.com` (where `example.com` is your base domain, not the `matrix.` domain)" +#: ../../../docs/configuring-playbook-email2matrix.md:57 +msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:78 -msgid "MatrixAccessToken - sender user's access token" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:79 -msgid "IgnoreSubject - if set to \"true\", the subject is not bridged to Matrix" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:80 -msgid "IgnoreBody - if set to \"true\", the message body is not bridged to Matrix" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:81 -msgid "SkipMarkdown - if set to \"true\", emails are bridged as plain text Matrix message instead of Markdown (actually HTML)" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:83 -msgid "Refer to the official documentation [here](https://github.com/devture/email2matrix/blob/master/docs/configuration.md)." +#: ../../../docs/configuring-playbook-email2matrix.md:59 +msgid "To enable Email2Matrix, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_FOR_EMAIL2MATRIX1_HERE` and `ACCESS_TOKEN_FOR_EMAIL2MATRIX2_HERE` with the ones created [above](#obtain-an-access-token)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:85 -msgid "Installing" +msgid "where:" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:87 -msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" +msgid "MailboxName - local-part of the email address, through which emails are bridged to the room whose ID is defined with MatrixRoomId" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:88 +msgid "MatrixRoomId - internal ID of the room, to which received emails are sent as Matrix message" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:89 +msgid "MatrixHomeserverUrl - URL of your Matrix homeserver, through which to send Matrix messages. You can also set `MatrixHomeserverUrl` to the container URL where your homeserver's Client-Server API lives by using the `{{ matrix_addons_homeserver_client_api_url }}` variable" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:90 +msgid "MatrixUserId - the full ID of the sender user which sends bridged messages to the room. On this configuration it is `@email2matrix1:example.com` and `@email2matrix2:example.com` (where `example.com` is your base domain, not the `matrix.` domain)" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:91 +msgid "MatrixAccessToken - sender user's access token" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:92 +msgid "IgnoreSubject - if set to \"true\", the subject is not bridged to Matrix" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:93 +msgid "IgnoreBody - if set to \"true\", the message body is not bridged to Matrix" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:94 -msgid "**Notes**:" +msgid "SkipMarkdown - if set to \"true\", emails are bridged as plain text Matrix message instead of Markdown (actually HTML)" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:96 -msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-service email2matrix` or `just setup-all`" +msgid "Refer to the official documentation [here](https://github.com/devture/email2matrix/blob/master/docs/configuration.md)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:98 -msgid "`just install-service email2matrix` is useful for maintaining your setup quickly when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note `just setup-all` runs the `ensure-matrix-users-created` tag too." +msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:100 +msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:107 +msgid "**Notes**:" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:109 +msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-service email2matrix` or `just setup-all`" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:111 +msgid "`just install-service email2matrix` is useful for maintaining your setup quickly when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note `just setup-all` runs the `ensure-matrix-users-created` tag too." +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:113 msgid "After installation, you may wish to send a test email to the email address assigned to `mailbox1` (default: `mailbox1@matrix.example.com`) to make sure that Email2Matrix works as expected." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-jitsi.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-jitsi.po index 5ce63d953..00813eb43 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-jitsi.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-jitsi.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -89,7 +89,7 @@ msgid "By default, you will need to create a CNAME record for `jitsi`. See [Conf msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:43 -msgid "(Optional) Configure Jitsi authentication and guests mode" +msgid "Configure Jitsi authentication and guests mode (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:45 @@ -165,7 +165,7 @@ msgid "For more information refer to the [docker-jitsi-meet](https://github.com/ msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:115 -msgid "(Optional) Making your Jitsi server work on a LAN" +msgid "Making your Jitsi server work on a LAN (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:117 @@ -185,7 +185,7 @@ msgid "Add these two lines to your `inventory/host_vars/matrix.example.com/vars. msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:130 -msgid "(Optional) Fine tune Jitsi" +msgid "Fine tune Jitsi (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:132 @@ -209,7 +209,7 @@ msgid "You may want to **limit the maximum video resolution**, to save up resour msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:155 -msgid "(Optional) Specify a Max number of participants on a Jitsi conference" +msgid "Specify a Max number of participants on a Jitsi conference (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:157 @@ -221,7 +221,7 @@ msgid "In order to set the max number of participants use the following **additi msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:165 -msgid "(Optional) Additional JVBs" +msgid "Additional JVBs (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:167 @@ -273,7 +273,7 @@ msgid "To make Traefik reverse-proxy to these additional JVBs (living on other h msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:256 -msgid "(Optional) Enable Gravatar" +msgid "Enable Gravatar (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:258 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po index 9a742c046..82cecc0af 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -77,7 +77,7 @@ msgid "Additional common configuration options:" msgstr "" #: ../../../docs/configuring-playbook-matrix-media-repo.md:91 -msgid "Full list of configuration options with documentation can be found in [`roles/custom/matrix-media-repo/defaults/main.yml`](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/master/roles/custom/matrix-media-repo/defaults/main.yml)" +msgid "Full list of configuration options with documentation can be found in [`roles/custom/matrix-media-repo/defaults/main.yml`](../roles/custom/matrix-media-repo/defaults/main.yml)" msgstr "" #: ../../../docs/configuring-playbook-matrix-media-repo.md:93 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po index 35da30ba4..55c520ed5 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -97,7 +97,7 @@ msgid "In the default configuration, the UVS Server is only reachable via the do msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:42 -msgid "Access token" +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:44 @@ -109,15 +109,15 @@ msgid "We recommend that you create a dedicated Matrix user for uvs (`uvs` is a msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:48 -msgid "You are required to specify an access token (belonging to this new user) for UVS to work. To get an access token for the UVS user, you can follow the documentation on [how to do obtain an access token](obtaining-access-tokens.md)." +msgid "You are required to specify an access token (belonging to this new user) for UVS to work. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:50 -msgid "**Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone.**" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:56 -msgid "(Optional) Custom Auth Token" +msgid "Custom Auth Token (optional)" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:58 @@ -137,7 +137,7 @@ msgid "In case Jitsi is also managed by this playbook and 'matrix' authenticatio msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:70 -msgid "(Optional) Disable Auth" +msgid "Disable Auth (optional)" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:72 @@ -145,7 +145,7 @@ msgid "Authorization is enabled by default. To disable it, add the following con msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:78 -msgid "(Optional) Federation" +msgid "Federation (optional)" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:80 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-well-known.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-well-known.po index be002abbb..20a45a880 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-well-known.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-well-known.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -93,7 +93,7 @@ msgid "However, this playbook installs your Matrix server on another domain (e.g msgstr "" #: ../../../docs/configuring-well-known.md:37 -msgid "(Optional) Support Service Discovery" +msgid "Support Service Discovery (optional)" msgstr "" #: ../../../docs/configuring-well-known.md:39 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/howto-server-delegation.po b/i18n/locales/jp/LC_MESSAGES/docs/howto-server-delegation.po index 8304c4748..f31b86f09 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/howto-server-delegation.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/howto-server-delegation.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-23 13:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -129,7 +129,7 @@ msgid "For more details on how to configure the playbook to work with SRV delega msgstr "" #: ../../../docs/howto-server-delegation.md:54 -msgid "Obtaining certificates" +msgid "Obtain certificates" msgstr "" #: ../../../docs/howto-server-delegation.md:56 diff --git a/i18n/locales/jp/LC_MESSAGES/docs/maintenance-synapse.po b/i18n/locales/jp/LC_MESSAGES/docs/maintenance-synapse.po index 00e65f61c..92a7ac762 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/maintenance-synapse.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/maintenance-synapse.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -61,137 +61,141 @@ msgid "To make use of this Synapse Admin API, **you'll need an admin access toke 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 "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." 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 "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:25 -msgid "After deleting data, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)." +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:27 -msgid "Compressing state with rust-synapse-compress-state" +msgid "After deleting data, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)." 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 "Compressing state with rust-synapse-compress-state" 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 "[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: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 "**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:35 +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:37 msgid "To ask the playbook to run rust-synapse-compress-state, execute:" msgstr "" -#: ../../../docs/maintenance-synapse.md:41 +#: ../../../docs/maintenance-synapse.md:43 msgid "The shortcut command with `just` program is also available: `just run-tags rust-synapse-compress-state`" msgstr "" -#: ../../../docs/maintenance-synapse.md:43 +#: ../../../docs/maintenance-synapse.md:45 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 +#: ../../../docs/maintenance-synapse.md:47 msgid "After state compression, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)." msgstr "" -#: ../../../docs/maintenance-synapse.md:47 +#: ../../../docs/maintenance-synapse.md:49 msgid "Browse and manipulate the database" msgstr "" -#: ../../../docs/maintenance-synapse.md:49 +#: ../../../docs/maintenance-synapse.md:51 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 +#: ../../../docs/maintenance-synapse.md:53 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 +#: ../../../docs/maintenance-synapse.md:55 msgid "First, set up an SSH tunnel to your Matrix server (skip if it is your local machine):" msgstr "" -#: ../../../docs/maintenance-synapse.md:60 +#: ../../../docs/maintenance-synapse.md:62 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 +#: ../../../docs/maintenance-synapse.md:68 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 +#: ../../../docs/maintenance-synapse.md:70 msgid "⚠️️ Be **very careful** with this, there is **no undo** for impromptu DB operations." msgstr "" -#: ../../../docs/maintenance-synapse.md:70 +#: ../../../docs/maintenance-synapse.md:72 msgid "Make Synapse faster" msgstr "" -#: ../../../docs/maintenance-synapse.md:72 +#: ../../../docs/maintenance-synapse.md:74 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 +#: ../../../docs/maintenance-synapse.md:76 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 +#: ../../../docs/maintenance-synapse.md:78 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 +#: ../../../docs/maintenance-synapse.md:80 msgid "Tuning caches and cache autotuning" msgstr "" -#: ../../../docs/maintenance-synapse.md:80 +#: ../../../docs/maintenance-synapse.md:82 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 +#: ../../../docs/maintenance-synapse.md:84 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 +#: ../../../docs/maintenance-synapse.md:86 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 +#: ../../../docs/maintenance-synapse.md:88 msgid "Cache autotuning is **enabled by default** and controlled via the following variables:" msgstr "" -#: ../../../docs/maintenance-synapse.md:88 +#: ../../../docs/maintenance-synapse.md:90 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 +#: ../../../docs/maintenance-synapse.md:91 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 +#: ../../../docs/maintenance-synapse.md:92 msgid "`matrix_synapse_cache_autotuning_min_cache_ttl` - defaults to `30s`" msgstr "" -#: ../../../docs/maintenance-synapse.md:92 +#: ../../../docs/maintenance-synapse.md:94 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 +#: ../../../docs/maintenance-synapse.md:96 msgid "To **disable cache auto-tuning**, unset all values:" msgstr "" -#: ../../../docs/maintenance-synapse.md:102 +#: ../../../docs/maintenance-synapse.md:104 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 +#: ../../../docs/maintenance-synapse.md:106 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 "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/obtaining-access-tokens.po b/i18n/locales/jp/LC_MESSAGES/docs/obtaining-access-tokens.po index 7302f99d6..9eda037b9 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/obtaining-access-tokens.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/obtaining-access-tokens.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -29,7 +29,7 @@ msgid "When setting up some optional features like bots and bridges you will nee msgstr "" #: ../../../docs/obtaining-access-tokens.md:5 -msgid "**Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone.**" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/obtaining-access-tokens.md:7 diff --git a/i18n/translation-templates/docs/configuring-playbook-alertmanager-receiver.pot b/i18n/translation-templates/docs/configuring-playbook-alertmanager-receiver.pot index 7782e5c8f..824ef02d4 100644 --- a/i18n/translation-templates/docs/configuring-playbook-alertmanager-receiver.pot +++ b/i18n/translation-templates/docs/configuring-playbook-alertmanager-receiver.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-23 13:09+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -65,97 +65,101 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:29 -msgid "Join to rooms as the bot manually" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:31 -msgid "ℹ️ **This bot does not accept room invitations automatically**. To deliver messages to rooms, the bot must be joined to all rooms manually." +msgid "Join to rooms as the bot manually" msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:33 -msgid "For each new room you would like the bot to deliver alerts to, invite the bot to the room." +msgid "ℹ️ **This bot does not accept room invitations automatically**. To deliver messages to rooms, the bot must be joined to all rooms manually." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:35 -msgid "Then, log in as the bot using any Matrix client of your choosing, accept the room invitation from the bot's account, and log out." +msgid "For each new room you would like the bot to deliver alerts to, invite the bot to the room." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:37 -msgid "Adjusting the playbook configuration" +msgid "Then, log in as the bot using any Matrix client of your choosing, accept the room invitation from the bot's account, and log out." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:39 +msgid "Adjusting the playbook configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:41 msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:60 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:62 msgid "See `roles/custom/matrix-alertmanager-receiver/defaults/main.yml` for additional configuration variables." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:62 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:64 msgid "Adjusting the matrix-alertmanager-receiver URL" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:64 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:66 msgid "By default, this playbook installs matrix-alertmanager-receiver on the `matrix.` subdomain, at the `/matrix-alertmanager-receiver` path (https://matrix.example.com/matrix-alertmanager-receiver). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:66 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:68 msgid "By tweaking the `matrix_alertmanager_receiver_hostname` and `matrix_alertmanager_receiver_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:68 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:70 msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:76 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:78 msgid "Adjusting DNS records" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:78 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:80 msgid "If you've changed the default hostname, **you may need to adjust your DNS** records to point the matrix-alertmanager-receiver domain to the Matrix server." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:80 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:82 msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:82 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:84 msgid "If you've decided to use the default hostname, you won't need to do any extra DNS configuration." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:84 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:86 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:86 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:88 msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:93 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:95 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:95 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:97 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:97 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:99 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:99 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:101 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:101 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:103 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:103 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:105 msgid "Configure your Prometheus Alertmanager with configuration like this:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:122 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:124 msgid "where `URL_HERE` looks like `https://matrix.example.com/matrix-alertmanager-receiver-RANDOM_VALUE_HERE/alert/some-room-name` or `https://matrix.example.com/matrix-alertmanager-receiver-RANDOM_VALUE_HERE/alert/!qporfwt:example.com`." msgstr "" diff --git a/i18n/translation-templates/docs/configuring-playbook-bot-chatgpt.pot b/i18n/translation-templates/docs/configuring-playbook-bot-chatgpt.pot index 19e496fdb..bd944f467 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bot-chatgpt.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bot-chatgpt.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-23 13:09+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -69,53 +69,57 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:31 -msgid "To make sure the bot can read encrypted messages, it will need an encryption key, just like any other new user. While obtaining the access token, follow the prompts to setup a backup key. More information can be found in the [Element documentation](https://element.io/help#encryption6)." +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:33 -msgid "Adjusting the playbook configuration" +msgid "To make sure the bot can read encrypted messages, it will need an encryption key, just like any other new user. While obtaining the access token, follow the prompts to setup a backup key. More information can be found in the [Element documentation](https://element.io/help#encryption6)." msgstr "" #: ../../../docs/configuring-playbook-bot-chatgpt.md:35 +msgid "Adjusting the playbook configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-chatgpt.md:37 msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `API_KEY_HERE` with the API key retrieved [here](#obtain-an-openai-api-key) and `ACCESS_TOKEN_HERE` with the access token created [here](#obtain-an-access-token-and-create-encryption-keys), respectively." msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:52 +#: ../../../docs/configuring-playbook-bot-chatgpt.md:54 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:54 +#: ../../../docs/configuring-playbook-bot-chatgpt.md:56 msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:61 +#: ../../../docs/configuring-playbook-bot-chatgpt.md:63 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:63 +#: ../../../docs/configuring-playbook-bot-chatgpt.md:65 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:65 +#: ../../../docs/configuring-playbook-bot-chatgpt.md:67 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:67 +#: ../../../docs/configuring-playbook-bot-chatgpt.md:69 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:69 +#: ../../../docs/configuring-playbook-bot-chatgpt.md:71 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:71 +#: ../../../docs/configuring-playbook-bot-chatgpt.md:73 msgid "To use the bot, invite it to the room you specified on your `vars.yml` file (`/invite @bot.chatgpt:example.com` where `example.com` is your base domain, not the `matrix.` domain)." msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:73 +#: ../../../docs/configuring-playbook-bot-chatgpt.md:75 msgid "After the bot joins the room, you can send a message to it. When you do so, use the prefix if you configured it or mention the bot." msgstr "" -#: ../../../docs/configuring-playbook-bot-chatgpt.md:75 +#: ../../../docs/configuring-playbook-bot-chatgpt.md:77 msgid "You can also refer to the upstream [documentation](https://github.com/matrixgpt/matrix-chatgpt-bot)." msgstr "" diff --git a/i18n/translation-templates/docs/configuring-playbook-bot-draupnir.pot b/i18n/translation-templates/docs/configuring-playbook-bot-draupnir.pot index 645d34ac6..952063e39 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bot-draupnir.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bot-draupnir.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-23 13:09+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -69,309 +69,313 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:31 -msgid "Make sure the account is free from rate limiting" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:33 -msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Draupnir will crash.**" +msgid "Make sure the account is free from rate limiting" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:35 -msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Draupnir will crash.**" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:37 +msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:39 msgid "To expose the APIs publicly, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:43 +#: ../../../docs/configuring-playbook-bot-draupnir.md:45 msgid "The APIs can also be accessed via [Synapse Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can use to administrate users, rooms, media, etc. on your Matrix server. The playbook can install and configure Synapse Admin for you. For details about it, see [this page](configuring-playbook-synapse-admin.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:45 +#: ../../../docs/configuring-playbook-bot-draupnir.md:47 msgid "**Note**: access to the APIs is restricted with a valid access token, so exposing them publicly should not be a real security concern. Still, doing so is not recommended for additional security. See [official Synapse reverse-proxying recommendations](https://element-hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-endpoints)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:47 +#: ../../../docs/configuring-playbook-bot-draupnir.md:49 msgid "To discharge rate limiting, run the following command on systems that ship curl (note that it does not work on outdated Windows 10). Even if the APIs are not exposed to the internet, you should still be able to run the command on the homeserver locally. Before running it, make sure to replace `@bot.draupnir:example.com` with the MXID of your Draupnir:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:53 +#: ../../../docs/configuring-playbook-bot-draupnir.md:55 msgid "You can obtain an access token for a homeserver admin account in the same way as you can do so for Draupnir itself. If you have made Draupnir an admin, you can just use the Draupnir token." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:55 +#: ../../../docs/configuring-playbook-bot-draupnir.md:57 msgid "Create a management room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:57 +#: ../../../docs/configuring-playbook-bot-draupnir.md:59 msgid "Using your own account, create a new invite only room that you will use to manage the bot. This is the room where you will see the status of the bot and where you will send commands to the bot, such as the command to ban a user from another room. Anyone in this room can control the bot so it is important that you only invite trusted users to this room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:59 +#: ../../../docs/configuring-playbook-bot-draupnir.md:61 msgid "If you make the management room encrypted (E2EE), then you MUST enable and use Pantalaimon (see [below](#configuration-with-e2ee-support))." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:61 +#: ../../../docs/configuring-playbook-bot-draupnir.md:63 msgid "Once you have created the room you need to copy the room ID so you can tell the bot to use that room. In Element Web you can do this by going to the room's settings, clicking Advanced, and then copying the internal room ID. The room ID will look something like `!qporfwt:example.com`." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:63 +#: ../../../docs/configuring-playbook-bot-draupnir.md:65 msgid "Finally invite the `@bot.draupnir:example.com` account you created earlier into the room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:65 +#: ../../../docs/configuring-playbook-bot-draupnir.md:67 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:67 +#: ../../../docs/configuring-playbook-bot-draupnir.md:69 msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `MANAGEMENT_ROOM_ID_HERE`." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:76 +#: ../../../docs/configuring-playbook-bot-draupnir.md:78 msgid "End-to-End Encryption support" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:78 +#: ../../../docs/configuring-playbook-bot-draupnir.md:80 msgid "Decide whether you want Draupnir to be capable of operating in end-to-end encrypted (E2EE) rooms. This includes the management room and the moderated rooms." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:80 +#: ../../../docs/configuring-playbook-bot-draupnir.md:82 msgid "To support E2EE, Draupnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:82 +#: ../../../docs/configuring-playbook-bot-draupnir.md:84 msgid "Configuration with E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:84 +#: ../../../docs/configuring-playbook-bot-draupnir.md:86 msgid "When using Pantalaimon, Draupnir will log in to its bot account itself through Pantalaimon, so configure its username and password." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:86 +#: ../../../docs/configuring-playbook-bot-draupnir.md:88 msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:100 +#: ../../../docs/configuring-playbook-bot-draupnir.md:102 msgid "The playbook's `group_vars` will configure other required settings. If using this role separately without the playbook, you also need to configure the two URLs that Draupnir uses to reach the homeserver, one through Pantalaimon and one \"raw\". This example is taken from the playbook's `group_vars`:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:112 +#: ../../../docs/configuring-playbook-bot-draupnir.md:114 msgid "Configuration without E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:114 +#: ../../../docs/configuring-playbook-bot-draupnir.md:116 msgid "When NOT using Pantalaimon, Draupnir does not log in by itself and you must give it an access token for its bot account." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:116 +#: ../../../docs/configuring-playbook-bot-draupnir.md:118 msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:122 +#: ../../../docs/configuring-playbook-bot-draupnir.md:124 msgid "Abuse Reports" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:124 +#: ../../../docs/configuring-playbook-bot-draupnir.md:126 msgid "Draupnir supports two methods to receive reports in the management room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:126 +#: ../../../docs/configuring-playbook-bot-draupnir.md:128 msgid "The first method intercepts the report API endpoint of the client-server API, which requires integration with the reverse proxy in front of the homeserver. If you are using traefik, this playbook can set this up for you:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:132 +#: ../../../docs/configuring-playbook-bot-draupnir.md:134 msgid "The other method polls an Synapse Admin API endpoint, hence it is available only if using Synapse and if the Draupnir user is an admin (see [above](#register-the-bot-account)). To enable it, set `pollReports: true` on `vars.yml` file as below." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:134 +#: ../../../docs/configuring-playbook-bot-draupnir.md:136 msgid "Extending the configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:136 +#: ../../../docs/configuring-playbook-bot-draupnir.md:138 msgid "You can configure additional options by adding the `matrix_bot_draupnir_configuration_extension_yaml` variable." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:138 +#: ../../../docs/configuring-playbook-bot-draupnir.md:140 msgid "For example, to change Draupnir's `pollReports` option to `true`, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:152 +#: ../../../docs/configuring-playbook-bot-draupnir.md:154 msgid "Migrating from Mjolnir (Only required if migrating)" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:154 +#: ../../../docs/configuring-playbook-bot-draupnir.md:156 msgid "Replace your `matrix_bot_mjolnir` config with `matrix_bot_draupnir` config. Also disable Mjolnir if you're doing migration." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:156 +#: ../../../docs/configuring-playbook-bot-draupnir.md:158 msgid "That is all you need to do due to that Draupnir can complete migration on its own." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:158 +#: ../../../docs/configuring-playbook-bot-draupnir.md:160 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:160 +#: ../../../docs/configuring-playbook-bot-draupnir.md:162 msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:167 +#: ../../../docs/configuring-playbook-bot-draupnir.md:169 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:169 +#: ../../../docs/configuring-playbook-bot-draupnir.md:171 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:171 +#: ../../../docs/configuring-playbook-bot-draupnir.md:173 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:173 +#: ../../../docs/configuring-playbook-bot-draupnir.md:175 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:175 +#: ../../../docs/configuring-playbook-bot-draupnir.md:177 msgid "If you change the Pantalaimon's password (`matrix_bot_draupnir_pantalaimon_password` in your `vars.yml` file) subsequently, its credentials on the homeserver won't be updated automatically. If you'd like to change the password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_draupnir_pantalaimon_password` to let Pantalaimon know its new password." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:177 +#: ../../../docs/configuring-playbook-bot-draupnir.md:179 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:179 +#: ../../../docs/configuring-playbook-bot-draupnir.md:181 msgid "You can refer to the upstream [documentation](https://the-draupnir-project.github.io/draupnir-documentation/) for additional ways to use and configure Draupnir and for a more detailed usage guide." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:181 +#: ../../../docs/configuring-playbook-bot-draupnir.md:183 msgid "Below is a **non-exhaustive quick-start guide** for the impatient." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:183 +#: ../../../docs/configuring-playbook-bot-draupnir.md:185 msgid "Making Draupnir join and protect a room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:185 +#: ../../../docs/configuring-playbook-bot-draupnir.md:187 msgid "Draupnir can be told to self-join public rooms, but it's better to follow this flow which works well for all kinds of rooms:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:187 +#: ../../../docs/configuring-playbook-bot-draupnir.md:189 msgid "Invite the bot to the room manually ([inviting Draupnir to rooms](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#inviting-draupnir-to-rooms)). Before joining, the bot *may* ask for confirmation in the Management Room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:189 +#: ../../../docs/configuring-playbook-bot-draupnir.md:191 msgid "[Give the bot permissions to do its job](#giving-draupnir-permissions-to-do-its-job)" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:191 +#: ../../../docs/configuring-playbook-bot-draupnir.md:193 msgid "Tell it to protect the room (using the [rooms command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#using-the-draupnir-rooms-command)) by sending the following command to the Management Room: `!draupnir rooms add !qporfwt:example.com`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:193 +#: ../../../docs/configuring-playbook-bot-draupnir.md:195 msgid "To have Draupnir provide useful room protection, you need do to a bit more work (at least the first time around). You may wish to [Subscribe to a public policy list](#subscribing-to-a-public-policy-list), [Create your own own policy and rules](#creating-your-own-policy-lists-and-rules) and [Enabling built-in protections](#enabling-built-in-protections)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:195 +#: ../../../docs/configuring-playbook-bot-draupnir.md:197 msgid "Giving Draupnir permissions to do its job" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:197 +#: ../../../docs/configuring-playbook-bot-draupnir.md:199 msgid "For Draupnir to do its job, you need to [give it permissions](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#giving-draupnir-permissions) in rooms it's protecting. This involves **giving it an Administrator power level**." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:199 +#: ../../../docs/configuring-playbook-bot-draupnir.md:201 msgid "**We recommend setting this power level as soon as the bot joins your room** (and before you create new rules), so that it can apply rules as soon as they are available. If the bot is under-privileged, it may fail to apply protections and may not retry for a while (or until your restart it)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:201 +#: ../../../docs/configuring-playbook-bot-draupnir.md:203 msgid "Subscribing to a public policy list" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:203 +#: ../../../docs/configuring-playbook-bot-draupnir.md:205 msgid "We recommend **subscribing to a public [policy list](https://the-draupnir-project.github.io/draupnir-documentation/concepts/policy-lists)** using the [watch command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-watch-command-to-subscribe-to-policy-rooms)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:205 +#: ../../../docs/configuring-playbook-bot-draupnir.md:207 msgid "Polcy lists are maintained in Matrix rooms. A popular policy list is maintained in the public `#community-moderation-effort-bl:neko.dev` room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:207 +#: ../../../docs/configuring-playbook-bot-draupnir.md:209 msgid "You can tell Draupnir to subscribe to it by sending the following command to the Management Room: `!draupnir watch #community-moderation-effort-bl:neko.dev`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:209 +#: ../../../docs/configuring-playbook-bot-draupnir.md:211 msgid "Creating your own policy lists and rules" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:211 +#: ../../../docs/configuring-playbook-bot-draupnir.md:213 msgid "We also recommend **creating your own policy lists** with the [list create](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-list-create-command-to-create-a-policy-room) command." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:213 +#: ../../../docs/configuring-playbook-bot-draupnir.md:215 msgid "You can do so by sending the following command to the Management Room: `!draupnir list create my-bans my-bans-bl`. This will create a policy list having a name (shortcode) of `my-bans` and stored in a public `#my-bans-bl:example.com` room on your server. As soon as you run this command, the bot will invite you to the policy list room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:215 +#: ../../../docs/configuring-playbook-bot-draupnir.md:217 msgid "A policy list does nothing by itself, so the next step is **adding some rules to your policy list**. Policies target a so-called `entity` (one of: `user`, `room` or `server`). These entities are mentioned on the [policy lists](https://the-draupnir-project.github.io/draupnir-documentation/concepts/policy-lists) documentation page and in the Matrix Spec [here](https://spec.matrix.org/v1.11/client-server-api/#mban-recommendation)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:217 +#: ../../../docs/configuring-playbook-bot-draupnir.md:219 msgid "The simplest and most useful entity to target is `user`. Below are a few examples using the [ban command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-users#the-ban-command) and targeting users." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:219 +#: ../../../docs/configuring-playbook-bot-draupnir.md:221 msgid "To create rules, you run commands in the Management Room (**not** in the policy list room)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:221 +#: ../../../docs/configuring-playbook-bot-draupnir.md:223 msgid "(ban a single user on a given homeserver): `!draupnir ban @charles:example.com my-bans Rude to others`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:222 +#: ../../../docs/configuring-playbook-bot-draupnir.md:224 msgid "(ban all users on a given homeserver by using a [wildcard](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-users#wildcards)): `!draupnir ban @*:example.org my-bans Spam server - all users are fake`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:224 +#: ../../../docs/configuring-playbook-bot-draupnir.md:226 msgid "As a result of running these commands, you may observe:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:226 +#: ../../../docs/configuring-playbook-bot-draupnir.md:228 msgid "Draupnir creating `m.policy.rule.user` state events in the `#my-bans-bl:example.com` room on your server" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:227 +#: ../../../docs/configuring-playbook-bot-draupnir.md:229 msgid "applying these rules against all rooms that Draupnir is an Administrator in" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:229 +#: ../../../docs/configuring-playbook-bot-draupnir.md:231 msgid "You can undo bans with the [unban command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-users#the-unban-command)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:231 +#: ../../../docs/configuring-playbook-bot-draupnir.md:233 msgid "Enabling built-in protections" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:233 +#: ../../../docs/configuring-playbook-bot-draupnir.md:235 msgid "You can also **turn on various built-in [protections](https://the-draupnir-project.github.io/draupnir-documentation/protections)** like `JoinWaveShortCircuit` (\"If X amount of users join in Y time, set the room to invite-only\")." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:235 +#: ../../../docs/configuring-playbook-bot-draupnir.md:237 msgid "To **see which protections are available and which are enabled**, send a `!draupnir protections` command to the Management Room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:237 +#: ../../../docs/configuring-playbook-bot-draupnir.md:239 msgid "To **see the configuration options for a given protection**, send a `!draupnir config get PROTECTION_NAME` (e.g. `!draupnir config get JoinWaveShortCircuit`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:239 +#: ../../../docs/configuring-playbook-bot-draupnir.md:241 msgid "To **set a specific option for a given protection**, send a command like this: `!draupnir config set PROTECTION_NAME.OPTION VALUE` (e.g. `!draupnir config set JoinWaveShortCircuit.timescaleMinutes 30`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:241 +#: ../../../docs/configuring-playbook-bot-draupnir.md:243 msgid "To **enable a given protection**, send a command like this: `!draupnir enable PROTECTION_NAME` (e.g. `!draupnir enable JoinWaveShortCircuit`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:243 +#: ../../../docs/configuring-playbook-bot-draupnir.md:245 msgid "To **disable a given protection**, send a command like this: `!draupnir disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)." msgstr "" diff --git a/i18n/translation-templates/docs/configuring-playbook-bot-go-neb.pot b/i18n/translation-templates/docs/configuring-playbook-bot-go-neb.pot index ce2d7387a..6897302ae 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bot-go-neb.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bot-go-neb.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-23 13:09+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -65,85 +65,89 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:29 -msgid "Adjusting the playbook configuration" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:31 +msgid "Adjusting the playbook configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-go-neb.md:33 msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_FOR_GONEB_HERE` and `ACCESS_TOKEN_FOR_ANOTHER_GONEB_HERE` with the ones created [above](#obtain-an-access-token)." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:195 +#: ../../../docs/configuring-playbook-bot-go-neb.md:197 msgid "Adjusting the Go-NEB URL" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:197 +#: ../../../docs/configuring-playbook-bot-go-neb.md:199 msgid "By default, this playbook installs Go-NEB on the `goneb.` subdomain (`goneb.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:199 +#: ../../../docs/configuring-playbook-bot-go-neb.md:201 msgid "By tweaking the `matrix_bot_go_neb_hostname` and `matrix_bot_go_neb_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:201 +#: ../../../docs/configuring-playbook-bot-go-neb.md:203 msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:212 +#: ../../../docs/configuring-playbook-bot-go-neb.md:214 msgid "Adjusting DNS records" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:214 +#: ../../../docs/configuring-playbook-bot-go-neb.md:216 msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Go-NEB domain to the Matrix server." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:216 +#: ../../../docs/configuring-playbook-bot-go-neb.md:218 msgid "By default, you will need to create a CNAME record for `goneb`. See [Configuring DNS](configuring-dns.md) for details about DNS changes." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:218 +#: ../../../docs/configuring-playbook-bot-go-neb.md:220 msgid "If you've decided to reuse the `matrix.` domain, you won't need to do any extra DNS configuration." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:220 +#: ../../../docs/configuring-playbook-bot-go-neb.md:222 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:222 +#: ../../../docs/configuring-playbook-bot-go-neb.md:224 msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:229 +#: ../../../docs/configuring-playbook-bot-go-neb.md:231 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:231 +#: ../../../docs/configuring-playbook-bot-go-neb.md:233 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:233 +#: ../../../docs/configuring-playbook-bot-go-neb.md:235 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:235 +#: ../../../docs/configuring-playbook-bot-go-neb.md:237 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:237 +#: ../../../docs/configuring-playbook-bot-go-neb.md:239 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:239 +#: ../../../docs/configuring-playbook-bot-go-neb.md:241 msgid "To use the bot, invite it to any existing Matrix room (`/invite @bot.go-neb:example.com` where `example.com` is your base domain, not the `matrix.` domain). Make sure you are granted with the sufficient permission if you are not the room owner." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:241 +#: ../../../docs/configuring-playbook-bot-go-neb.md:243 msgid "Basic usage is like this: `!echo hi` or `!imgur puppies` or `!giphy matrix`" msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:243 +#: ../../../docs/configuring-playbook-bot-go-neb.md:245 msgid "If you enabled the github_cmd service, send `!github help` to the bot in the room to see the available commands." msgstr "" -#: ../../../docs/configuring-playbook-bot-go-neb.md:245 +#: ../../../docs/configuring-playbook-bot-go-neb.md:247 msgid "You can also refer to the upstream [Documentation](https://github.com/matrix-org/go-neb)." msgstr "" diff --git a/i18n/translation-templates/docs/configuring-playbook-bot-maubot.pot b/i18n/translation-templates/docs/configuring-playbook-bot-maubot.pot index 3bbb8d3d2..463906876 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bot-maubot.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bot-maubot.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-23 13:09+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -57,6 +57,7 @@ msgid "By tweaking the `matrix_bot_maubot_hostname` and `matrix_bot_maubot_path_ msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:34 +#: ../../../docs/configuring-playbook-bot-maubot.md:56 msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" @@ -77,65 +78,85 @@ msgid "If you've decided to use the default hostname, you won't need to do any e msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:50 -msgid "Installing" +msgid "Customizing the maubot container image" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:52 -msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" +msgid "Certain [maubot plugins](https://plugins.mau.bot/) require additional dependencies to be installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-maubot.md:59 -msgid "**Notes**:" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:61 -msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:63 -msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:65 -msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." +#: ../../../docs/configuring-playbook-bot-maubot.md:54 +msgid "You can customize the default maubot container image and install your own dependencies." msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:67 -msgid "If you change the bot password (`matrix_bot_maubot_initial_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_maubot_initial_password` to let the bot know its new password." +msgid "Consult the [Dockerfile reference](https://docs.docker.com/reference/dockerfile/) for more information about the syntax." msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:69 -msgid "Usage" +msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:71 -msgid "By default, you can visit `matrix.example.com/_matrix/maubot/` to manage your available plugins, clients and instances." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:73 -msgid "You should start in the following order" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:74 -msgid "**Create one or more clients**: A client is a Matrix account which the bot will use to message. By default, the playbook creates a `bot.maubot` account (as per the configuration above). You only need to [obtain an access token](#obtaining-an-access-token) for it" -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:75 -msgid "**Upload some Plugins**: Plugins can be obtained from [here](https://github.com/maubot/maubot#plugins) or any other source." -msgstr "" - -#: ../../../docs/configuring-playbook-bot-maubot.md:76 -msgid "**Create an instance**: An instance is the actual bot. You have to specify a client which the bot instance will use and the plugin (how the bot will behave)" +msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:78 -msgid "Obtain an access token" +msgid "**Notes**:" msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:80 -msgid "This can be done via `mbc login` then `mbc auth` (see the [maubot documentation](https://docs.mau.fi/maubot/usage/cli/auth.html)). To run these commands, you'll first need to `exec` into the maubot container with `docker exec -it matrix-bot-maubot sh`." +msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" #: ../../../docs/configuring-playbook-bot-maubot.md:82 -msgid "Alternatively, you can follow our generic [obtain an access token](obtaining-access-tokens.md) documentation. Be aware that you'd better use the **Obtain an access token via curl** method (not **Obtain an access token via Element Web**) as the latter will give your bot issues in encrypted rooms. Read [more](https://docs.mau.fi/maubot/usage/basic.html#creating-clients)." +msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:84 +msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:86 +msgid "If you change the bot password (`matrix_bot_maubot_initial_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_maubot_initial_password` to let the bot know its new password." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:88 +msgid "Usage" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:90 +msgid "By default, you can visit `matrix.example.com/_matrix/maubot/` to manage your available plugins, clients and instances." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:92 +msgid "You should start in the following order" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:93 +msgid "**Create one or more clients**: A client is a Matrix account which the bot will use to message. By default, the playbook creates a `bot.maubot` account (as per the configuration above). You only need to [obtain an access token](#obtaining-an-access-token) for it" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:94 +msgid "**Upload some Plugins**: Plugins can be obtained from [here](https://github.com/maubot/maubot#plugins) or any other source." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:95 +msgid "**Create an instance**: An instance is the actual bot. You have to specify a client which the bot instance will use and the plugin (how the bot will behave)" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:97 +msgid "Obtain an access token" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:99 +msgid "This can be done via `mbc login` then `mbc auth` (see the [maubot documentation](https://docs.mau.fi/maubot/usage/cli/auth.html)). To run these commands, you'll first need to `exec` into the maubot container with `docker exec -it matrix-bot-maubot sh`." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:101 +msgid "Alternatively, you can refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md). Be aware that you'd better use the **Obtain an access token via curl** method (not **Obtain an access token via Element Web**) as the latter will causes issues to your bot in encrypted rooms. Read [more](https://docs.mau.fi/maubot/usage/basic.html#creating-clients)." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-maubot.md:103 +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" diff --git a/i18n/translation-templates/docs/configuring-playbook-bot-mjolnir.pot b/i18n/translation-templates/docs/configuring-playbook-bot-mjolnir.pot index a033bff46..e5d06bb95 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bot-mjolnir.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bot-mjolnir.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-23 13:09+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -61,157 +61,161 @@ msgid "The bot requires an access token to be able to connect to your homeserver msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:27 -msgid "Make sure the account is free from rate limiting" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:29 -msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Mjolnir will crash.**" +msgid "Make sure the account is free from rate limiting" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:31 -msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgid "If your homeserver's implementation is Synapse, you will need to prevent it from rate limiting the bot's account. **This is a required step. If you do not configure it, Mjolnir will crash.**" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:33 +msgid "This can be done using Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-ratelimiting-for-users). They can be accessed both externally and internally." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-mjolnir.md:35 msgid "To expose the APIs publicly, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:39 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:41 msgid "The APIs can also be accessed via [Synapse Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can use to administrate users, rooms, media, etc. on your Matrix server. The playbook can install and configure Synapse Admin for you. For details about it, see [this page](configuring-playbook-synapse-admin.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:41 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:43 msgid "**Note**: access to the APIs is restricted with a valid access token, so exposing them publicly should not be a real security concern. Still, doing so is not recommended for additional security. See [official Synapse reverse-proxying recommendations](https://element-hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-endpoints)." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:43 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:45 msgid "To discharge rate limiting, run the following command on systems that ship curl (note that it does not work on outdated Windows 10). Even if the APIs are not exposed to the internet, you should still be able to run the command on the homeserver locally. Before running it, make sure to replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:49 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:51 msgid "You can obtain an access token for a homeserver admin account in the same way as you can do so for Mjolnir itself. If you have made Mjolnir an admin, you can just use the Mjolnir token." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:51 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:53 msgid "Create a management room" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:53 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:55 msgid "Using your own account, create a new invite only room that you will use to manage the bot. This is the room where you will see the status of the bot and where you will send commands to the bot, such as the command to ban a user from another room. Anyone in this room can control the bot so it is important that you only invite trusted users to this room." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:55 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:57 msgid "If you make the management room encrypted (E2EE), then you MUST enable and use Pantalaimon (see [below](#configuration-with-e2ee-support))." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:57 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:59 msgid "Once you have created the room you need to copy the room ID so you can tell the bot to use that room. In Element Web you can do this by going to the room's settings, clicking Advanced, and then copying the internal room ID. The room ID will look something like `!qporfwt:example.com`." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:59 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:61 msgid "Finally invite the `@bot.mjolnir:example.com` account you created earlier into the room." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:61 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:63 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:63 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:65 msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `MANAGEMENT_ROOM_ID_HERE`." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:72 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:74 msgid "End-to-End Encryption support" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:74 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:76 msgid "Decide whether you want Mjolnir to be capable of operating in end-to-end encrypted (E2EE) rooms. This includes the management room and the moderated rooms." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:76 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:78 msgid "To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:78 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:80 msgid "Configuration with E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:80 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:82 msgid "When using Pantalaimon, Mjolnir will log in to its bot account itself through Pantalaimon, so configure its username and password." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:82 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:84 msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:96 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:98 msgid "The playbook's `group_vars` will configure other required settings. If using this role separately without the playbook, you also need to configure the two URLs that Mjolnir uses to reach the homeserver, one through Pantalaimon and one \"raw\". This example is taken from the playbook's `group_vars`:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:108 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:110 msgid "Configuration without E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:110 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:112 msgid "When NOT using Pantalaimon, Mjolnir does not log in by itself and you must give it an access token for its bot account." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:112 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:114 msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:118 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:120 msgid "Adding Mjolnir synapse antispam module (optional)" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:120 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:122 msgid "To enable Mjolnir synapse antispam module, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:130 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:132 msgid "Extending the configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:132 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:134 msgid "You can configure additional options by adding the `matrix_bot_mjolnir_configuration_extension_yaml` variable to your `inventory/host_vars/matrix.example.com/vars.yml` file." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:134 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:136 msgid "For example, to change Mjolnir's `recordIgnoredInvites` option to `true`, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:148 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:150 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:150 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:152 msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:157 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:159 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:159 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:161 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:161 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:163 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:163 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:165 msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:165 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:167 msgid "If you change the Pantalaimon's password (`matrix_bot_mjolnir_pantalaimon_password` in your `vars.yml` file) subsequently, its credentials on the homeserver won't be updated automatically. If you'd like to change the password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_mjolnir_pantalaimon_password` to let Pantalaimon know its new password." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:167 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:169 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:169 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:171 msgid "You can refer to the upstream [documentation](https://github.com/matrix-org/mjolnir) for additional ways to use and configure Mjolnir. Check out their [quickstart guide](https://github.com/matrix-org/mjolnir#quickstart-guide) for some basic commands you can give to the bot." msgstr "" diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-appservice-kakaotalk.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-appservice-kakaotalk.pot index 0d38f2077..cb917fa11 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-appservice-kakaotalk.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-appservice-kakaotalk.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -145,7 +145,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:73 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:75 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-discord.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-discord.pot index 42c732f37..9a18465db 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-discord.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-discord.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 23:17+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -229,7 +229,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:104 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:106 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-facebook.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-facebook.pot index 3c03c30fb..ac1d04009 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-facebook.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-facebook.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -145,7 +145,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:99 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:101 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-gmessages.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-gmessages.pot index 6e2f83980..f5fa7acb1 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-gmessages.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-gmessages.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -113,7 +113,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:58 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:60 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-googlechat.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-googlechat.pot index 004ff9bd0..14dd76870 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-googlechat.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-googlechat.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -133,7 +133,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:68 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:70 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-hangouts.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-hangouts.pot index fecd8edf9..e05c6c2eb 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-hangouts.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-hangouts.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -133,7 +133,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:68 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:70 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-meta-instagram.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-meta-instagram.pot index b71e4bb98..6a658af27 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-meta-instagram.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-meta-instagram.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -193,7 +193,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:107 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:109 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-meta-messenger.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-meta-messenger.pot index 3d2e0cebf..16fece3ae 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-meta-messenger.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-meta-messenger.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -229,7 +229,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:124 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:126 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-signal.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-signal.pot index a931c0168..732776d30 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-signal.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-signal.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -181,7 +181,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:109 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:111 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-slack.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-slack.pot index 3cdcf38e4..30988952e 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-slack.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-slack.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 23:17+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -181,7 +181,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:85 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:87 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-telegram.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-telegram.pot index a83d5467f..cf64deff8 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-telegram.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-telegram.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -137,7 +137,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:91 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:93 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-twitter.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-twitter.pot index ece21b5ac..612714ca8 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-twitter.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-twitter.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -129,7 +129,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:65 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:67 diff --git a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-whatsapp.pot b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-whatsapp.pot index 3cbe6494c..b393ba2e3 100644 --- a/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-whatsapp.pot +++ b/i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-whatsapp.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -133,7 +133,7 @@ msgid "When using this method, **each user** that wishes to enable Double Puppet msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:76 -msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to do that](obtaining-access-tokens.md)." +msgid "retrieve a Matrix access token for yourself. Refer to the documentation on [how to obtain one](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:78 diff --git a/i18n/translation-templates/docs/configuring-playbook-dimension.pot b/i18n/translation-templates/docs/configuring-playbook-dimension.pot index ec8a03f96..3dbfc4bf3 100644 --- a/i18n/translation-templates/docs/configuring-playbook-dimension.pot +++ b/i18n/translation-templates/docs/configuring-playbook-dimension.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -21,137 +21,158 @@ msgid "Setting up Dimension integration manager (optional, unmaintained)" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:3 -msgid "**[Dimension](https://dimension.t2bot.io) can only be installed after Matrix services are installed and running.** If you're just installing Matrix services for the first time, please continue with the [Configuration](configuring-playbook.md) / [Installation](installing.md) flow and come back here later." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:5 -msgid "**Note**: Dimension is **[officially unmaintained](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/2806#issuecomment-1673559299)**. We recommend not bothering with installing it." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:7 -msgid "**Note**: This playbook now supports running [Dimension](https://dimension.t2bot.io) in both a federated and [unfederated](https://github.com/turt2live/matrix-dimension/blob/master/docs/unfederated.md) environments. This is handled automatically based on the value of `matrix_homeserver_federation_enabled`. Enabling Dimension, means that the `openid` API endpoints will be exposed on the Matrix Federation port (usually `8448`), even if [federation](configuring-playbook-federation.md) is disabled. It's something to be aware of, especially in terms of firewall whitelisting (make sure port `8448` is accessible)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:9 -msgid "Adjusting the playbook configuration" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:11 -msgid "To enable Dimension, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:17 -msgid "Define admin users" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:19 -msgid "These users can modify the integrations this Dimension supports. Add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:27 -msgid "The admin interface is accessible within Element Web by accessing it in any room and clicking the cog wheel/settings icon in the top right. Currently, Dimension can be opened in Element Web by the \"Add widgets, bridges, & bots\" link in the room information." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:29 -msgid "Access token" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:31 -msgid "We recommend that you create a dedicated Matrix user for Dimension (`dimension` is a good username). Follow our [Registering users](registering-users.md) guide to learn how to register **a regular (non-admin) user**." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:33 -msgid "You are required to specify an access token (belonging to this new user) for Dimension to work. To get an access token for the Dimension user, you can follow the documentation on [how to do obtain an access token](obtaining-access-tokens.md)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:35 -msgid "**Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone.**" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:37 -msgid "Add access token to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:43 -msgid "For more information on how to acquire an access token, visit [https://t2bot.io/docs/access_tokens](https://t2bot.io/docs/access_tokens)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:45 -msgid "Adjusting the Dimension URL" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:47 -msgid "By default, this playbook installs Dimension on the `dimension.` subdomain (`dimension.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:49 -msgid "By tweaking the `matrix_dimension_hostname` and `matrix_dimension_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:51 -msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:62 -msgid "**Note**: While there is a `matrix_dimension_path_prefix` variable for changing the path where Dimension is served, overriding it is not possible due to [this Dimension issue](https://github.com/turt2live/matrix-dimension/issues/510). You must serve Dimension at a dedicated subdomain." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:64 -msgid "Adjusting DNS records" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:66 -msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Dimension domain to the Matrix server." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:68 -msgid "By default, you will need to create a CNAME record for `dimension`. See [Configuring DNS](configuring-dns.md) for details about DNS changes." -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:70 -msgid "Installing" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:72 -msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" -msgstr "" - -#: ../../../docs/configuring-playbook-dimension.md:79 +#: ../../../docs/configuring-playbook-dimension.md:91 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:81 -msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" +#: ../../../docs/configuring-playbook-dimension.md:4 +msgid "Dimension is **[officially unmaintained](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/2806#issuecomment-1673559299)**. We recommend not bothering with installing it." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:83 -msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too." +#: ../../../docs/configuring-playbook-dimension.md:5 +msgid "This playbook now supports running Dimension in both a federated and [unfederated](https://github.com/turt2live/matrix-dimension/blob/master/docs/unfederated.md) environments. This is handled automatically based on the value of `matrix_homeserver_federation_enabled`. Enabling Dimension, means that the `openid` API endpoints will be exposed on the Matrix Federation port (usually `8448`), even if [federation](configuring-playbook-federation.md) is disabled. It's something to be aware of, especially in terms of firewall whitelisting (make sure port `8448` is accessible)." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:85 -msgid "After Dimension has been installed you may need to log out and log back in for it to pick up the new integration manager. Then you can access integrations in Element Web by opening a room, clicking the Room info button (`i`) button in the top right corner of the screen, and then clicking Add widgets, bridges & bots." +#: ../../../docs/configuring-playbook-dimension.md:7 +msgid "The playbook can install and configure the [Dimension](https://dimension.t2bot.io) integration manager for you." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:87 -msgid "Jitsi domain" +#: ../../../docs/configuring-playbook-dimension.md:9 +msgid "See the project's [documentation](https://github.com/turt2live/matrix-dimension/blob/master/README.md) to learn what it does and why it might be useful to you." msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:89 -msgid "By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video conference widgets. For users running [a self-hosted Jitsi instance](./configuring-playbook-jitsi.md), you will likely want the widget to use your own Jitsi instance. Currently there is no way to configure this via the playbook, see [this issue](https://github.com/turt2live/matrix-dimension/issues/345) for details." +#: ../../../docs/configuring-playbook-dimension.md:11 +msgid "Prerequisites" msgstr "" -#: ../../../docs/configuring-playbook-dimension.md:91 -msgid "In the interim until the above limitation is resolved, an admin user needs to configure the domain via the admin ui once dimension is running. In Element Web, go to *Manage Integrations* → *Settings* → *Widgets* → *Jitsi Conference Settings* and set *Jitsi Domain* and *Jitsi Script URL* appropriately." +#: ../../../docs/configuring-playbook-dimension.md:13 +msgid "Install Matrix services" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:15 +msgid "Dimension can only be installed after Matrix services are installed and running. If you're just installing Matrix services for the first time, please continue with the [Configuration](configuring-playbook.md) / [Installation](installing.md) and come back here later." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:17 +msgid "Register a dedicated Matrix user (optional, recommended)" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:19 +msgid "We recommend that you create a dedicated Matrix user for Dimension (`dimension` is a good username)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:21 +msgid "Generate a strong password for the user. You can create one with a command like `pwgen -s 64 1`." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:23 +msgid "You can use the playbook to [register a new user](registering-users.md):" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:29 +msgid "Obtain an access token" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:31 +msgid "Dimension requires an access token to be able to connect to your homeserver. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:33 +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:35 +msgid "Adjusting the playbook configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:37 +msgid "To enable Dimension, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`). Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:45 +msgid "Define admin users" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:47 +msgid "These users can modify the integrations this Dimension supports. Add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:55 +msgid "The admin interface is accessible within Element Web by accessing it in any room and clicking the cog wheel/settings icon in the top right. Currently, Dimension can be opened in Element Web by the \"Add widgets, bridges, & bots\" link in the room information." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:57 +msgid "Adjusting the Dimension URL" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:59 +msgid "By default, this playbook installs Dimension on the `dimension.` subdomain (`dimension.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:61 +msgid "By tweaking the `matrix_dimension_hostname` and `matrix_dimension_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:63 +msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:74 +msgid "**Note**: While there is a `matrix_dimension_path_prefix` variable for changing the path where Dimension is served, overriding it is not possible due to [this Dimension issue](https://github.com/turt2live/matrix-dimension/issues/510). You must serve Dimension at a dedicated subdomain." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:76 +msgid "Adjusting DNS records" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:78 +msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Dimension domain to the Matrix server." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:80 +msgid "By default, you will need to create a CNAME record for `dimension`. See [Configuring DNS](configuring-dns.md) for details about DNS changes." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:82 +msgid "Installing" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:84 +msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:93 -msgid "Additional features" +msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:95 -msgid "To use a more custom configuration, you can define a `matrix_dimension_configuration_extension_yaml` string variable and put your configuration in it. To learn more about how to do this, refer to the information about `matrix_dimension_configuration_extension_yaml` in the [default variables file](../roles/custom/matrix-dimension/defaults/main.yml) of the Dimension component." +msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:97 +msgid "After Dimension has been installed you may need to log out and log back in for it to pick up the new integration manager. Then you can access integrations in Element Web by opening a room, clicking the Room info button (`i`) button in the top right corner of the screen, and then clicking Add widgets, bridges & bots." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:99 +msgid "Jitsi domain" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:101 +msgid "By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video conference widgets. For users running [a self-hosted Jitsi instance](./configuring-playbook-jitsi.md), you will likely want the widget to use your own Jitsi instance. Currently there is no way to configure this via the playbook, see [this issue](https://github.com/turt2live/matrix-dimension/issues/345) for details." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:103 +msgid "In the interim until the above limitation is resolved, an admin user needs to configure the domain via the admin ui once dimension is running. In Element Web, go to *Manage Integrations* → *Settings* → *Widgets* → *Jitsi Conference Settings* and set *Jitsi Domain* and *Jitsi Script URL* appropriately." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:105 +msgid "Additional features" +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:107 +msgid "To use a more custom configuration, you can define a `matrix_dimension_configuration_extension_yaml` string variable and put your configuration in it. To learn more about how to do this, refer to the information about `matrix_dimension_configuration_extension_yaml` in the [default variables file](../roles/custom/matrix-dimension/defaults/main.yml) of the Dimension component." +msgstr "" + +#: ../../../docs/configuring-playbook-dimension.md:109 msgid "You can find all configuration options on [GitHub page of Dimension project](https://github.com/turt2live/matrix-dimension/blob/master/config/default.yaml)." msgstr "" diff --git a/i18n/translation-templates/docs/configuring-playbook-email2matrix.pot b/i18n/translation-templates/docs/configuring-playbook-email2matrix.pot index f508b138b..4b61b12f1 100644 --- a/i18n/translation-templates/docs/configuring-playbook-email2matrix.pot +++ b/i18n/translation-templates/docs/configuring-playbook-email2matrix.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-23 13:09+0900\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -65,113 +65,129 @@ msgid "For details about using Email2Matrix alongside [Postfix](http://www.postf msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:25 -msgid "Creating a user" +msgid "Register a dedicated Matrix user (optional, recommended)" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:27 -msgid "Before enabling Email2Matrix, you'd most likely wish to create a dedicated user (or more) that would be sending messages on the Matrix side. Take note of the user's ID as it needs to be specified as `MatrixUserId` on your `inventory/host_vars/matrix.example.com/vars.yml` file later." +msgid "We recommend that you create a dedicated Matrix user for Email2Matrix." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:29 -msgid "Refer to [Registering users](registering-users.md) for ways to create a user. A regular (non-admin) user works best." +msgid "Generate a strong password for the user. You can create one with a command like `pwgen -s 64 1`." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:31 -msgid "Creating a shared room" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:33 -msgid "After creating the sender user, you should create one or more Matrix rooms that you share with that user. It doesn't matter who creates and owns the rooms and who joins later (you or the sender user)." -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:35 -msgid "What matters is that both you and the sender user are part of the same room and that the sender user has enough privileges in the room to be able to send messages there." +msgid "You can use the playbook to [register a new user](registering-users.md):" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:37 -msgid "Inviting additional people to the room is okay too." +msgid "Take note of the user's ID as it needs to be specified as `MatrixUserId` on your `inventory/host_vars/matrix.example.com/vars.yml` file later." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:39 -msgid "Take note of each room's room ID (different clients show the room ID in a different place). You'll need the room ID when [configuring the playbook](#adjusting-the-playbook-configuration) below." +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:41 -msgid "Obtain an access token for the sender user" +msgid "Email2Matrix requires an access token for the sender user to be able to send messages to the room. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:43 -msgid "In order for the sender user created above to be able to send messages to the room, we'll need to obtain an access token for it. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:45 -msgid "Adjusting the playbook configuration" +msgid "Join to rooms as the sender user manually" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:47 -msgid "After doing the preparation steps above, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):" +msgid "ℹ️ **Email2Matrix does not accept room invitations automatically**. To deliver messages to rooms, the sender user must be joined to all rooms manually." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:72 -msgid "where:" +#: ../../../docs/configuring-playbook-email2matrix.md:49 +msgid "For each new room you would like the user to deliver messages to, invite the user to the room." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:74 -msgid "MailboxName - local-part of the email address, through which emails are bridged to the room whose ID is defined with MatrixRoomId" +#: ../../../docs/configuring-playbook-email2matrix.md:51 +msgid "Then, log in as the sender user using any Matrix client of your choosing, accept the room invitation from the user's account." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:75 -msgid "MatrixRoomId - internal ID of the room, to which received emails are sent as Matrix message" +#: ../../../docs/configuring-playbook-email2matrix.md:53 +msgid "Make sure that you and the sender user are part of the same room and that the sender user has enough privileges in the room to be able to send messages there, then log out." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:76 -msgid "MatrixHomeserverUrl - URL of your Matrix homeserver, through which to send Matrix messages. You can also set `MatrixHomeserverUrl` to the container URL where your homeserver's Client-Server API lives by using the `{{ matrix_addons_homeserver_client_api_url }}` variable" +#: ../../../docs/configuring-playbook-email2matrix.md:55 +msgid "Take note of each room's room ID (different clients show the room ID in a different place). You'll need the room ID when [configuring the playbook](#adjusting-the-playbook-configuration) below." msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:77 -msgid "MatrixUserId - the full ID of the sender user which sends bridged messages to the room. On this configuration it is `@email2matrix1:example.com` and `@email2matrix2:example.com` (where `example.com` is your base domain, not the `matrix.` domain)" +#: ../../../docs/configuring-playbook-email2matrix.md:57 +msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:78 -msgid "MatrixAccessToken - sender user's access token" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:79 -msgid "IgnoreSubject - if set to \"true\", the subject is not bridged to Matrix" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:80 -msgid "IgnoreBody - if set to \"true\", the message body is not bridged to Matrix" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:81 -msgid "SkipMarkdown - if set to \"true\", emails are bridged as plain text Matrix message instead of Markdown (actually HTML)" -msgstr "" - -#: ../../../docs/configuring-playbook-email2matrix.md:83 -msgid "Refer to the official documentation [here](https://github.com/devture/email2matrix/blob/master/docs/configuration.md)." +#: ../../../docs/configuring-playbook-email2matrix.md:59 +msgid "To enable Email2Matrix, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_FOR_EMAIL2MATRIX1_HERE` and `ACCESS_TOKEN_FOR_EMAIL2MATRIX2_HERE` with the ones created [above](#obtain-an-access-token)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:85 -msgid "Installing" +msgid "where:" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:87 -msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" +msgid "MailboxName - local-part of the email address, through which emails are bridged to the room whose ID is defined with MatrixRoomId" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:88 +msgid "MatrixRoomId - internal ID of the room, to which received emails are sent as Matrix message" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:89 +msgid "MatrixHomeserverUrl - URL of your Matrix homeserver, through which to send Matrix messages. You can also set `MatrixHomeserverUrl` to the container URL where your homeserver's Client-Server API lives by using the `{{ matrix_addons_homeserver_client_api_url }}` variable" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:90 +msgid "MatrixUserId - the full ID of the sender user which sends bridged messages to the room. On this configuration it is `@email2matrix1:example.com` and `@email2matrix2:example.com` (where `example.com` is your base domain, not the `matrix.` domain)" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:91 +msgid "MatrixAccessToken - sender user's access token" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:92 +msgid "IgnoreSubject - if set to \"true\", the subject is not bridged to Matrix" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:93 +msgid "IgnoreBody - if set to \"true\", the message body is not bridged to Matrix" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:94 -msgid "**Notes**:" +msgid "SkipMarkdown - if set to \"true\", emails are bridged as plain text Matrix message instead of Markdown (actually HTML)" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:96 -msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-service email2matrix` or `just setup-all`" +msgid "Refer to the official documentation [here](https://github.com/devture/email2matrix/blob/master/docs/configuration.md)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:98 -msgid "`just install-service email2matrix` is useful for maintaining your setup quickly when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note `just setup-all` runs the `ensure-matrix-users-created` tag too." +msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:100 +msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:107 +msgid "**Notes**:" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:109 +msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-service email2matrix` or `just setup-all`" +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:111 +msgid "`just install-service email2matrix` is useful for maintaining your setup quickly when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note `just setup-all` runs the `ensure-matrix-users-created` tag too." +msgstr "" + +#: ../../../docs/configuring-playbook-email2matrix.md:113 msgid "After installation, you may wish to send a test email to the email address assigned to `mailbox1` (default: `mailbox1@matrix.example.com`) to make sure that Email2Matrix works as expected." msgstr "" diff --git a/i18n/translation-templates/docs/configuring-playbook-jitsi.pot b/i18n/translation-templates/docs/configuring-playbook-jitsi.pot index 05c2280b2..a6f074789 100644 --- a/i18n/translation-templates/docs/configuring-playbook-jitsi.pot +++ b/i18n/translation-templates/docs/configuring-playbook-jitsi.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -85,7 +85,7 @@ msgid "By default, you will need to create a CNAME record for `jitsi`. See [Conf msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:43 -msgid "(Optional) Configure Jitsi authentication and guests mode" +msgid "Configure Jitsi authentication and guests mode (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:45 @@ -161,7 +161,7 @@ msgid "For more information refer to the [docker-jitsi-meet](https://github.com/ msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:115 -msgid "(Optional) Making your Jitsi server work on a LAN" +msgid "Making your Jitsi server work on a LAN (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:117 @@ -181,7 +181,7 @@ msgid "Add these two lines to your `inventory/host_vars/matrix.example.com/vars. msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:130 -msgid "(Optional) Fine tune Jitsi" +msgid "Fine tune Jitsi (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:132 @@ -205,7 +205,7 @@ msgid "You may want to **limit the maximum video resolution**, to save up resour msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:155 -msgid "(Optional) Specify a Max number of participants on a Jitsi conference" +msgid "Specify a Max number of participants on a Jitsi conference (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:157 @@ -217,7 +217,7 @@ msgid "In order to set the max number of participants use the following **additi msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:165 -msgid "(Optional) Additional JVBs" +msgid "Additional JVBs (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:167 @@ -269,7 +269,7 @@ msgid "To make Traefik reverse-proxy to these additional JVBs (living on other h msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:256 -msgid "(Optional) Enable Gravatar" +msgid "Enable Gravatar (optional)" msgstr "" #: ../../../docs/configuring-playbook-jitsi.md:258 diff --git a/i18n/translation-templates/docs/configuring-playbook-matrix-media-repo.pot b/i18n/translation-templates/docs/configuring-playbook-matrix-media-repo.pot index c75b2e87c..40aeb8401 100644 --- a/i18n/translation-templates/docs/configuring-playbook-matrix-media-repo.pot +++ b/i18n/translation-templates/docs/configuring-playbook-matrix-media-repo.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -73,7 +73,7 @@ msgid "Additional common configuration options:" msgstr "" #: ../../../docs/configuring-playbook-matrix-media-repo.md:91 -msgid "Full list of configuration options with documentation can be found in [`roles/custom/matrix-media-repo/defaults/main.yml`](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/master/roles/custom/matrix-media-repo/defaults/main.yml)" +msgid "Full list of configuration options with documentation can be found in [`roles/custom/matrix-media-repo/defaults/main.yml`](../roles/custom/matrix-media-repo/defaults/main.yml)" msgstr "" #: ../../../docs/configuring-playbook-matrix-media-repo.md:93 diff --git a/i18n/translation-templates/docs/configuring-playbook-user-verification-service.pot b/i18n/translation-templates/docs/configuring-playbook-user-verification-service.pot index 7a47a11a8..04afcda54 100644 --- a/i18n/translation-templates/docs/configuring-playbook-user-verification-service.pot +++ b/i18n/translation-templates/docs/configuring-playbook-user-verification-service.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -93,7 +93,7 @@ msgid "In the default configuration, the UVS Server is only reachable via the do msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:42 -msgid "Access token" +msgid "Obtain an access token" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:44 @@ -105,15 +105,15 @@ msgid "We recommend that you create a dedicated Matrix user for uvs (`uvs` is a msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:48 -msgid "You are required to specify an access token (belonging to this new user) for UVS to work. To get an access token for the UVS user, you can follow the documentation on [how to do obtain an access token](obtaining-access-tokens.md)." +msgid "You are required to specify an access token (belonging to this new user) for UVS to work. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:50 -msgid "**Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone.**" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:56 -msgid "(Optional) Custom Auth Token" +msgid "Custom Auth Token (optional)" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:58 @@ -133,7 +133,7 @@ msgid "In case Jitsi is also managed by this playbook and 'matrix' authenticatio msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:70 -msgid "(Optional) Disable Auth" +msgid "Disable Auth (optional)" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:72 @@ -141,7 +141,7 @@ msgid "Authorization is enabled by default. To disable it, add the following con msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:78 -msgid "(Optional) Federation" +msgid "Federation (optional)" msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:80 diff --git a/i18n/translation-templates/docs/configuring-well-known.pot b/i18n/translation-templates/docs/configuring-well-known.pot index 157258f8f..7b35a517d 100644 --- a/i18n/translation-templates/docs/configuring-well-known.pot +++ b/i18n/translation-templates/docs/configuring-well-known.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -89,7 +89,7 @@ msgid "However, this playbook installs your Matrix server on another domain (e.g msgstr "" #: ../../../docs/configuring-well-known.md:37 -msgid "(Optional) Support Service Discovery" +msgid "Support Service Discovery (optional)" msgstr "" #: ../../../docs/configuring-well-known.md:39 diff --git a/i18n/translation-templates/docs/maintenance-synapse.pot b/i18n/translation-templates/docs/maintenance-synapse.pot index b33365b79..a205c177a 100644 --- a/i18n/translation-templates/docs/maintenance-synapse.pot +++ b/i18n/translation-templates/docs/maintenance-synapse.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -57,137 +57,141 @@ msgid "To make use of this Synapse Admin API, **you'll need an admin access toke 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 "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." 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 "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:25 -msgid "After deleting data, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)." +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:27 -msgid "Compressing state with rust-synapse-compress-state" +msgid "After deleting data, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)." 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 "Compressing state with rust-synapse-compress-state" 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 "[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: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 "**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:35 +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:37 msgid "To ask the playbook to run rust-synapse-compress-state, execute:" msgstr "" -#: ../../../docs/maintenance-synapse.md:41 +#: ../../../docs/maintenance-synapse.md:43 msgid "The shortcut command with `just` program is also available: `just run-tags rust-synapse-compress-state`" msgstr "" -#: ../../../docs/maintenance-synapse.md:43 +#: ../../../docs/maintenance-synapse.md:45 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 +#: ../../../docs/maintenance-synapse.md:47 msgid "After state compression, you may wish to run a [`FULL` Postgres `VACUUM`](./maintenance-postgres.md#vacuuming-postgresql)." msgstr "" -#: ../../../docs/maintenance-synapse.md:47 +#: ../../../docs/maintenance-synapse.md:49 msgid "Browse and manipulate the database" msgstr "" -#: ../../../docs/maintenance-synapse.md:49 +#: ../../../docs/maintenance-synapse.md:51 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 +#: ../../../docs/maintenance-synapse.md:53 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 +#: ../../../docs/maintenance-synapse.md:55 msgid "First, set up an SSH tunnel to your Matrix server (skip if it is your local machine):" msgstr "" -#: ../../../docs/maintenance-synapse.md:60 +#: ../../../docs/maintenance-synapse.md:62 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 +#: ../../../docs/maintenance-synapse.md:68 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 +#: ../../../docs/maintenance-synapse.md:70 msgid "⚠️️ Be **very careful** with this, there is **no undo** for impromptu DB operations." msgstr "" -#: ../../../docs/maintenance-synapse.md:70 +#: ../../../docs/maintenance-synapse.md:72 msgid "Make Synapse faster" msgstr "" -#: ../../../docs/maintenance-synapse.md:72 +#: ../../../docs/maintenance-synapse.md:74 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 +#: ../../../docs/maintenance-synapse.md:76 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 +#: ../../../docs/maintenance-synapse.md:78 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 +#: ../../../docs/maintenance-synapse.md:80 msgid "Tuning caches and cache autotuning" msgstr "" -#: ../../../docs/maintenance-synapse.md:80 +#: ../../../docs/maintenance-synapse.md:82 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 +#: ../../../docs/maintenance-synapse.md:84 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 +#: ../../../docs/maintenance-synapse.md:86 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 +#: ../../../docs/maintenance-synapse.md:88 msgid "Cache autotuning is **enabled by default** and controlled via the following variables:" msgstr "" -#: ../../../docs/maintenance-synapse.md:88 +#: ../../../docs/maintenance-synapse.md:90 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 +#: ../../../docs/maintenance-synapse.md:91 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 +#: ../../../docs/maintenance-synapse.md:92 msgid "`matrix_synapse_cache_autotuning_min_cache_ttl` - defaults to `30s`" msgstr "" -#: ../../../docs/maintenance-synapse.md:92 +#: ../../../docs/maintenance-synapse.md:94 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 +#: ../../../docs/maintenance-synapse.md:96 msgid "To **disable cache auto-tuning**, unset all values:" msgstr "" -#: ../../../docs/maintenance-synapse.md:102 +#: ../../../docs/maintenance-synapse.md:104 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 +#: ../../../docs/maintenance-synapse.md:106 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 "" diff --git a/i18n/translation-templates/docs/obtaining-access-tokens.pot b/i18n/translation-templates/docs/obtaining-access-tokens.pot index 60f498f36..d0acfad7a 100644 --- a/i18n/translation-templates/docs/obtaining-access-tokens.pot +++ b/i18n/translation-templates/docs/obtaining-access-tokens.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 07:23+0200\n" +"POT-Creation-Date: 2024-12-28 10:25+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -25,7 +25,7 @@ msgid "When setting up some optional features like bots and bridges you will nee msgstr "" #: ../../../docs/obtaining-access-tokens.md:5 -msgid "**Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone.**" +msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone." msgstr "" #: ../../../docs/obtaining-access-tokens.md:7