mirror/matrix-docker-ansible-deploy
1
0
Fork 0
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy.git synced 2025-01-16 05:03:10 +01:00
Code Issues Packages Projects Releases Wiki Activity

Rebuild i18n files

Browse Source
This commit is contained in:
Slavi Pantaleev 2024-12-28 10:25:48 +02:00
parent 59b8fbb13d
commit 75337384c0
119 changed files with 1842 additions and 1548 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
i18n/locales/bg/LC_MESSAGES/CHANGELOG.po
View File

@ -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 <EMAIL@ADDRESS>\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

58
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-backup-borg.po
View File

@ -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 <EMAIL@ADDRESS>\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

8
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po
View File

@ -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 <EMAIL@ADDRESS>\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

34
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

50
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

174
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

66
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 ""

12
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

6
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po
View File

@ -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 <EMAIL@ADDRESS>\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

101
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

98
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po
View File

@ -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 <EMAIL@ADDRESS>\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

6
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po
View File

@ -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 <EMAIL@ADDRESS>\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

6
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language: bg\n"
@ -146,7 +146,7 @@ msgid "The bot should respond with \"Successfully logged into <email> 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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 ""

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po
View File

@ -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 <EMAIL@ADDRESS>\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

243
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-dimension.po
View File

@ -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 <EMAIL@ADDRESS>\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* &rightarrow; *Settings* &rightarrow; *Widgets* &rightarrow; *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* &rightarrow; *Settings* &rightarrow; *Widgets* &rightarrow; *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 ""

120
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

14
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-jitsi.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po
View File

@ -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 <EMAIL@ADDRESS>\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

14
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/bg/LC_MESSAGES/docs/configuring-well-known.po
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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

4
i18n/locales/bg/LC_MESSAGES/docs/howto-server-delegation.po
View File

@ -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 <EMAIL@ADDRESS>\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

72
i18n/locales/bg/LC_MESSAGES/docs/maintenance-synapse.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/bg/LC_MESSAGES/docs/obtaining-access-tokens.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/CHANGELOG.po
View File

@ -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 <EMAIL@ADDRESS>\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

58
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-backup-borg.po
View File

@ -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 <EMAIL@ADDRESS>\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

8
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po
View File

@ -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 <EMAIL@ADDRESS>\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

34
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

50
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

174
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

66
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

12
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

6
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po
View File

@ -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 <EMAIL@ADDRESS>\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

101
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

98
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po
View File

@ -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 <EMAIL@ADDRESS>\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

6
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po
View File

@ -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 <EMAIL@ADDRESS>\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

6
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language: jp\n"
@ -145,7 +145,7 @@ msgid "The bot should respond with \"Successfully logged into <email> 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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po
View File

@ -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 <EMAIL@ADDRESS>\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

243
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-dimension.po
View File

@ -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 <EMAIL@ADDRESS>\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* &rightarrow; *Settings* &rightarrow; *Widgets* &rightarrow; *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* &rightarrow; *Settings* &rightarrow; *Widgets* &rightarrow; *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 ""

120
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

14
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-jitsi.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po
View File

@ -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 <EMAIL@ADDRESS>\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

14
i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/configuring-well-known.po
View File

@ -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 <EMAIL@ADDRESS>\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

4
i18n/locales/jp/LC_MESSAGES/docs/howto-server-delegation.po
View File

@ -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 <EMAIL@ADDRESS>\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

72
i18n/locales/jp/LC_MESSAGES/docs/maintenance-synapse.po
View File

@ -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 <EMAIL@ADDRESS>\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 ""

4
i18n/locales/jp/LC_MESSAGES/docs/obtaining-access-tokens.po
View File

@ -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 <EMAIL@ADDRESS>\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

52
i18n/translation-templates/docs/configuring-playbook-alertmanager-receiver.pot
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 ""

30
i18n/translation-templates/docs/configuring-playbook-bot-chatgpt.pot
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 ""

158
i18n/translation-templates/docs/configuring-playbook-bot-draupnir.pot
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 ""

46
i18n/translation-templates/docs/configuring-playbook-bot-go-neb.pot
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 ""

99
i18n/translation-templates/docs/configuring-playbook-bot-maubot.pot
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 ""

82
i18n/translation-templates/docs/configuring-playbook-bot-mjolnir.pot
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 ""

4
i18n/translation-templates/docs/configuring-playbook-bridge-appservice-kakaotalk.pot
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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

4
i18n/translation-templates/docs/configuring-playbook-bridge-mautrix-discord.pot
View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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

Some files were not shown because too many files have changed in this diff Show More