diff --git a/i18n/locales/bg/LC_MESSAGES/README.po b/i18n/locales/bg/LC_MESSAGES/README.po index 9ac7e37f0..10bc599a8 100644 --- a/i18n/locales/bg/LC_MESSAGES/README.po +++ b/i18n/locales/bg/LC_MESSAGES/README.po @@ -8,11 +8,11 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: matrix-docker-ansible-deploy \n" +"Project-Id-Version: matrix-docker-ansible-deploy\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" +"PO-Revision-Date: 2024-12-20 09:52+0200\n" +"Last-Translator: \n" "Language: bg\n" "Language-Team: bg \n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" @@ -30,10 +30,16 @@ msgid "" "docker-ansible-deploy:devture.com) " "[![donate](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/s.pantaleev/donate)" msgstr "" +"[![Matrix стая за поддържка](https://img.shields.io/matrix/matrix-docker-" +"ansible-deploy:devture.com.svg?label=%23matrix-docker-ansible-" +"deploy%3Adevture.com&logo=matrix&style=for-the-" +"badge&server_fqdn=matrix.devture.com)](https://matrix.to/#/#matrix-" +"docker-ansible-deploy:devture.com) " +"[![donate](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/s.pantaleev/donate)" #: ../../../README.md:1 msgid "Support room on Matrix" -msgstr "" +msgstr "Matrix стая за поддръжка" #: ../../../README.md:1 msgid "donate" @@ -47,14 +53,18 @@ msgstr "" #: ../../../README.md:5 msgid "🎯 Purpose" -msgstr "" +msgstr "🎯 Цел" #: ../../../README.md:7 msgid "" "This [Ansible](https://www.ansible.com/) playbook is meant to help you " "run your own [Matrix](http://matrix.org/) homeserver, along with the " "[various services](#supported-services) related to that." -msgstr "Този наръчник [Ansible](https://www.ansible.com/) има за цел да ви помогне да стартирате свой собствен [Matrix](http://matrix.org/) домашен сървър, заедно с [различните услуги](#supported-services), свързани с това." +msgstr "" +"Този наръчник [Ansible](https://www.ansible.com/) има за цел да ви " +"помогне да стартирате свой собствен [Matrix](http://matrix.org/) домашен " +"сървър, заедно с [различните услуги](#supported-services), свързани с " +"това." #: ../../../README.md:9 msgid "" @@ -110,7 +120,7 @@ msgstr "" #: ../../../README.md:21 msgid "🚀 Getting started" -msgstr "" +msgstr "🚀 Стартиране" #: ../../../README.md:23 msgid "" @@ -1350,11 +1360,25 @@ msgid "" "deploy/issues)" msgstr "" -#: ../../../README.md:215 +#: ../../../README.md:201 +msgid "🌐 Translation" +msgstr "" + +#: ../../../README.md:203 +msgid "" +"See the [i18n/README.md](i18n/README.md) file for more information about " +"translation." +msgstr "" + +#: ../../../README.md:205 +msgid "Translations are still work in progress." +msgstr "" + +#: ../../../README.md:207 msgid "🤝 Related" msgstr "" -#: ../../../README.md:217 +#: ../../../README.md:209 msgid "" "You may also be interested in [mash-playbook](https://github.com/mother-" "of-all-self-hosting/mash-playbook) - another Ansible playbook for self-" @@ -1363,7 +1387,7 @@ msgid "" "playbook/blob/main/docs/supported-services.md))." msgstr "" -#: ../../../README.md:219 +#: ../../../README.md:211 msgid "" "mash-playbook also makes use of [Traefik](./docs/configuring-playbook-" "traefik.md) as its reverse-proxy, so with minor [interoperability " @@ -1372,3 +1396,4 @@ msgid "" "ansible-deploy and mash-playbook co-exist and host Matrix and non-Matrix " "services on the same server." msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po index 6aa45c304..b66d0461a 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -41,19 +41,12 @@ msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:5 msgid "" "See the project's [documentation](https://github.com/metio/matrix-" -"alertmanager-receiver) to learn more about what this component does and " -"why it might be useful to you." +"alertmanager-receiver/blob/main/README.md) to learn what it does and why " +"it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:7 msgid "" -"At the moment, **setting up this service's bot requires some manual " -"actions** as described below in [Account and room preparation](#account-" -"and-room-preparation)." -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:9 -msgid "" "This service is meant to be used with an external " "[Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/) " "instance. It's **not** meant to be integrated with the [Prometheus & " @@ -62,27 +55,93 @@ msgid "" "it." msgstr "" +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:9 +msgid "Prerequisites" +msgstr "" + #: ../../../docs/configuring-playbook-alertmanager-receiver.md:11 -msgid "Adjusting the playbook configuration" +msgid "Register the bot account" msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:13 msgid "" -"To enable matrix-alertmanager-receiver, add the following configuration " -"to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +"This service uses a bot (with a username specified in " +"`matrix_alertmanager_receiver_config_matrix_user_id_localpart`) for " +"delivering messages." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:36 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:15 +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-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`." +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:19 +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" +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:27 +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-alertmanager-receiver.md:29 +msgid "Join to rooms as the bot manually" +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." +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." +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." +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:37 +msgid "Adjusting the playbook configuration" +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)." +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:61 msgid "" "See `roles/custom/matrix-alertmanager-receiver/defaults/main.yml` for " "additional configuration variables." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:38 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:63 msgid "Adjusting the matrix-alertmanager-receiver URL" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:40 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:65 msgid "" "By default, this playbook installs matrix-alertmanager-receiver on the " "`matrix.` subdomain, at the `/matrix-alertmanager-receiver` path " @@ -91,7 +150,7 @@ msgid "" "to be set up**. If that's okay, you can skip this section." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:42 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67 msgid "" "By tweaking the `matrix_alertmanager_receiver_hostname` and " "`matrix_alertmanager_receiver_path_prefix` variables, you can easily make" @@ -99,125 +158,61 @@ msgid "" "default one." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:44 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69 msgid "" "Example additional configuration for your " "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:52 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:77 msgid "Adjusting DNS records" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:54 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:79 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:56 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:81 msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:58 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:83 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:60 -msgid "Account and room preparation" -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:62 -msgid "" -"The playbook can automatically create users, but it cannot automatically " -"obtain access tokens, nor perform any of the other manual actions below." -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:64 -msgid "" -"`matrix-alertmanager-receiver` uses a bot (with a username specified in " -"`matrix_alertmanager_receiver_config_matrix_user_id_localpart` - see " -"above) for delivering messages. You need to **manually register this bot " -"acccount and obtain an access token for it**." -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:66 -msgid "" -"[Register a new user](registering-users.md): `ansible-playbook -i " -"inventory/hosts setup.yml --extra-" -"vars='username=bot.alertmanager.receiver password=PASSWORD_FOR_THE_BOT " -"admin=no' --tags=register-user`" -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67 -msgid "" -"[Obtain an access token](obtaining-access-tokens.md) for the bot's user " -"account" -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:68 -msgid "Invite the bot to a room where you'd like to alerts to be delivered" -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69 -msgid "" -"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:70 -msgid "" -"(Optionally) Adjust " -"`matrix_alertmanager_receiver_config_matrix_room_mapping` to create a " -"mapping between the new room and its ID" -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:72 -msgid "" -"Steps 1 and 2 above only need to be done once, while preparing your " -"[configuration](#adjusting-the-playbook-configuration)." -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:74 -msgid "" -"Steps 3 and 4 need to be done for each new room you'd like the bot to " -"deliver alerts to. Step 5 is optional and provides cleaner `/alert/` " -"URLs." -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:76 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:85 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:78 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87 msgid "" -"Now that you've [prepared the bot account and room](#account-and-room-" -"preparation), [configured the playbook](#adjusting-the-playbook-" -"configuration), and potentially [adjusted your DNS records](#adjusting-" -"dns-records), you can run the playbook with [playbook tags](playbook-" -"tags.md) as below:" +"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:85 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:94 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:96 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:89 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:98 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:91 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:100 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" @@ -226,27 +221,136 @@ msgid "" "`just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:93 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:102 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:95 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:104 msgid "Configure your Prometheus Alertmanager with configuration like this:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:114 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:123 msgid "" -".. where `URL_HERE` looks like `https://matrix.example.com/matrix-" +"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 "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:116 -msgid "" -"This bot does **not** accept room invitations automatically (like many " -"other bots do). To deliver messages to rooms, **the bot must be joined to" -" all rooms manually** - see Step 4 of the [Account and room preparation" -"](#account-and-room-preparation) section." -msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/metio/matrix-alertmanager-" +#~ "receiver) to learn more about what " +#~ "this component does and why it " +#~ "might be useful to you." +#~ msgstr "" + +#~ msgid "" +#~ "At the moment, **setting up this " +#~ "service's bot requires some manual " +#~ "actions** as described below in [Account" +#~ " and room preparation](#account-and-" +#~ "room-preparation)." +#~ msgstr "" + +#~ msgid "" +#~ "To enable matrix-alertmanager-receiver, " +#~ "add the following configuration to your" +#~ " `inventory/host_vars/matrix.example.com/vars.yml` file:" +#~ msgstr "" + +#~ msgid "Account and room preparation" +#~ msgstr "" + +#~ msgid "" +#~ "The playbook can automatically create " +#~ "users, but it cannot automatically " +#~ "obtain access tokens, nor perform any" +#~ " of the other manual actions below." +#~ msgstr "" + +#~ msgid "" +#~ "`matrix-alertmanager-receiver` uses a " +#~ "bot (with a username specified in " +#~ "`matrix_alertmanager_receiver_config_matrix_user_id_localpart` -" +#~ " see above) for delivering messages. " +#~ "You need to **manually register this " +#~ "bot acccount and obtain an access " +#~ "token for it**." +#~ msgstr "" + +#~ msgid "" +#~ "[Register a new user](registering-users.md):" +#~ " `ansible-playbook -i inventory/hosts " +#~ "setup.yml --extra-vars='username=bot.alertmanager.receiver" +#~ " password=PASSWORD_FOR_THE_BOT admin=no' --tags" +#~ "=register-user`" +#~ msgstr "" + +#~ msgid "" +#~ "[Obtain an access token](obtaining-access-" +#~ "tokens.md) for the bot's user account" +#~ msgstr "" + +#~ msgid "Invite the bot to a room where you'd like to alerts to be delivered" +#~ msgstr "" + +#~ msgid "" +#~ "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 "" + +#~ msgid "" +#~ "(Optionally) Adjust " +#~ "`matrix_alertmanager_receiver_config_matrix_room_mapping` to " +#~ "create a mapping between the new " +#~ "room and its ID" +#~ msgstr "" + +#~ msgid "" +#~ "Steps 1 and 2 above only need " +#~ "to be done once, while preparing " +#~ "your [configuration](#adjusting-the-playbook-" +#~ "configuration)." +#~ msgstr "" + +#~ msgid "" +#~ "Steps 3 and 4 need to be " +#~ "done for each new room you'd like" +#~ " the bot to deliver alerts to. " +#~ "Step 5 is optional and provides " +#~ "cleaner `/alert/` URLs." +#~ msgstr "" + +#~ msgid "" +#~ "Now that you've [prepared the bot " +#~ "account and room](#account-and-room-" +#~ "preparation), [configured the playbook" +#~ "](#adjusting-the-playbook-configuration), and " +#~ "potentially [adjusted your DNS records" +#~ "](#adjusting-dns-records), you can run " +#~ "the playbook with [playbook tags](playbook-" +#~ "tags.md) as below:" +#~ msgstr "" + +#~ 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 "" + +#~ msgid "" +#~ "This bot does **not** accept room " +#~ "invitations automatically (like many other " +#~ "bots do). To deliver messages to " +#~ "rooms, **the bot must be joined to" +#~ " all rooms manually** - see Step " +#~ "4 of the [Account and room " +#~ "preparation](#account-and-room-preparation) " +#~ "section." +#~ msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po index 6e1b9782e..e993b61b9 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -84,27 +84,31 @@ msgid "" msgstr "" #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:19 -msgid "Installation" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:21 -msgid "Create a main management room." +msgid "Create a main management room" msgstr "" #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:23 msgid "" "The playbook does not create a management room for your Main Draupnir. " -"This task you have to do on your own." +"You **need to create the room manually** before setting up the bot." msgstr "" #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:25 +msgid "Note that the room must be unencrypted." +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29 msgid "" "The management room has to be given an alias and be public when you are " "setting up the bot for the first time as the bot does not differentiate " "between invites and invites to the management room." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:27 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:31 msgid "" "This management room is used to control who has access to your D4A " "deployment. The room stores this data inside of the control room state so" @@ -112,77 +116,107 @@ msgid "" "This is default 50 or moderator as Element clients call this powerlevel." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:33 msgid "" "As noted in the Draupnir install instructions the control room is " -"sensitive. The following is said about the control room in the Draupnir " -"install instructions." +"sensitive. **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-appservice-draupnir-for-all.md:30 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:35 +msgid "Set an alias to the management room" +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:37 +msgid "Next, set an alias to the management room." +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:39 msgid "" -"Anyone in this room can control the bot so it is important that you only " -"invite trusted users to this room. The room must be unencrypted since the" -" playbook does not support installing Pantalaimon yet." +"This alias can be anything you want. However, for increased security " +"during the setup phase, it is recommended to make this alias be a random " +"string. When it has been locked down after setup phase, you can give your" +" room a secondary human readable alias." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:32 -msgid "Give your main management room an alias." +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:41 +msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:34 -msgid "" -"Give the room from step 1 an alias. This alias can be anything you want " -"and its recommended for increased security during the setup phase of the " -"bot that you make this alias be a random string. You can give your room a" -" secondary human readable alias when it has been locked down after setup " -"phase." -msgstr "" - -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:36 -msgid "Adjusting the playbook configuration." -msgstr "" - -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:38 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:43 msgid "" "Add the following configuration to your " -"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your " -"needs):" +"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to " +"replace `MANAGEMENT_ROOM_ALIAS_HERE`." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:40 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:51 +msgid "Extending the configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:53 msgid "" -"You must replace `ALIAS_FROM_STEP_2_GOES_HERE` with the alias you created" -" in step 2." +"You can configure additional options by adding the " +"`matrix_appservice_draupnir_for_all_extension_yaml` variable." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:48 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:55 +msgid "" +"For example, to change Draupnir's `protectAllJoinedRooms` option to " +"`true`, add the following configuration to your " +"`inventory/host_vars/matrix.example.com/vars.yml` file:" +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69 +msgid "" +"You can refer to the upstream [documentation](https://github.com/the-" +"draupnir-project/Draupnir) for more configuration documentation." +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:86 +msgid "**Notes**:" +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73 +msgid "" +"The playbook ships a full copy of the example config that does transfer " +"to provisioned Draupnirs in the production-bots.yaml.j2 file in the " +"template directory of the role." +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75 +msgid "" +"Config extension does not affect the appservices config as this config is" +" not extensible in current Draupnir anyway. It instead touches the config" +" passed to the Draupnirs that your Appservice creates. So the example " +"above (`protectAllJoinedRooms: true`) makes all provisioned Draupnirs " +"protect all joined rooms." +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:50 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:57 -msgid "**Notes**:" -msgstr "" - -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:59 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:88 msgid "" "The `ensure-matrix-users-created` playbook tag makes the playbook " "automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:61 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:90 msgid "" "The shortcut commands with the [`just` program](just.md) are also " "available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:63 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:92 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" @@ -191,29 +225,29 @@ msgid "" "`just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:65 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:94 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:67 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:96 msgid "" "If you made it through all the steps above and your main control room was" " joined by a user called `@draupnir-main:example.com` you have " "succesfully installed Draupnir for All and can now start using it." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:98 msgid "" "The installation of Draupnir for all in this playbook is very much Alpha " -"quality. Usage-wise, Draupnir for allis almost identical to Draupnir bot " -"mode." +"quality. Usage-wise, Draupnir for all is almost identical to Draupnir bot" +" mode." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:100 msgid "Granting Users the ability to use D4A" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:102 msgid "" "Draupnir for all includes several security measures like that it only " "allows users that are on its allow list to ask for a bot. To add a user " @@ -224,7 +258,7 @@ msgid "" " the chat is recomended." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:104 msgid "" "The bot requires a powerlevel of 50 in the management room to control who" " is allowed to use the bot. The bot does currently not say anything if " @@ -233,7 +267,7 @@ msgid "" "project/Draupnir/issues/297))" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:106 msgid "" "To allow users or whole homeservers you type /plain @draupnir-" "main:example.com allow `target` and target can be either a MXID or a " @@ -242,57 +276,146 @@ msgid "" "this command as it can break Wildcard commands especially." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79 -msgid "How to provision a D4A once you are allowed to." +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:108 +msgid "How to provision a D4A once you are allowed to" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:81 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:110 msgid "" -"Open a DM with @draupnir-main:example.com and if using an Element client " -"send a message into this DM to finalise creating it. The bot will reject " -"this invite and you will shortly get invited to the Draupnir control room" -" for your newly provisioned Draupnir. From here its just a normal " -"Draupnir experience." +"To provision a D4A, you need to start a chat with `@draupnir-" +"main:example.com`. The bot will reject this invite and you will shortly " +"get invited to the Draupnir control room for your newly provisioned " +"Draupnir. From here its just a normal Draupnir experience." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:83 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:112 msgid "" "Congratulations if you made it all the way here because you now have a " "fully working Draupnir for all deployment." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:85 -msgid "Configuration of D4A" -msgstr "" +#~ msgid "Installation" +#~ msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:87 -msgid "" -"You can refer to the upstream [documentation](https://github.com/the-" -"draupnir-project/Draupnir) for more configuration documentation. Please " -"note that the playbook ships a full copy of the example config that does " -"transfer to provisioned Draupnirs in the production-bots.yaml.j2 file in " -"the template directory of the role." -msgstr "" +#~ msgid "Create a main management room." +#~ msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:89 -msgid "" -"Please note that Config extension does not affect the appservices config " -"as this config is not extensible in current Draupnir anyways. Config " -"extension instead touches the config passed to the Draupnirs that your " -"Appservice creates. So for example below makes all provisioned Draupnirs " -"protect all joined rooms." -msgstr "" +#~ msgid "" +#~ "The playbook does not create a " +#~ "management room for your Main Draupnir." +#~ " This task you have to do on" +#~ " your own." +#~ msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:91 -msgid "" -"You can configure additional options by adding the " -"`matrix_appservice_draupnir_for_all_extension_yaml` variable to your " -"`inventory/host_vars/matrix.example.com/vars.yml` file." -msgstr "" +#~ msgid "" +#~ "As noted in the Draupnir install " +#~ "instructions the control room is " +#~ "sensitive. The following is said about" +#~ " the control room in the Draupnir " +#~ "install instructions." +#~ msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:93 -msgid "" -"For example to change Draupnir's `protectAllJoinedRooms` option to `true`" -" you would add the following to your `vars.yml` file." -msgstr "" +#~ msgid "" +#~ "Anyone in this room can control " +#~ "the bot so it is important that" +#~ " you only invite trusted users to " +#~ "this room. The room must be " +#~ "unencrypted since the playbook does not" +#~ " support installing Pantalaimon yet." +#~ msgstr "" + +#~ msgid "Give your main management room an alias." +#~ msgstr "" + +#~ msgid "" +#~ "Give the room from step 1 an " +#~ "alias. This alias can be anything " +#~ "you want and its recommended for " +#~ "increased security during the setup " +#~ "phase of the bot that you make " +#~ "this alias be a random string. You" +#~ " can give your room a secondary " +#~ "human readable alias when it has " +#~ "been locked down after setup phase." +#~ msgstr "" + +#~ msgid "Adjusting the playbook configuration." +#~ msgstr "" + +#~ msgid "" +#~ "Add the following configuration to your" +#~ " `inventory/host_vars/matrix.example.com/vars.yml` file " +#~ "(adapt to your needs):" +#~ msgstr "" + +#~ msgid "" +#~ "You must replace `ALIAS_FROM_STEP_2_GOES_HERE` " +#~ "with the alias you created in step" +#~ " 2." +#~ msgstr "" + +#~ msgid "" +#~ "The installation of Draupnir for all " +#~ "in this playbook is very much " +#~ "Alpha quality. Usage-wise, Draupnir for" +#~ " allis almost identical to Draupnir " +#~ "bot mode." +#~ msgstr "" + +#~ msgid "How to provision a D4A once you are allowed to." +#~ msgstr "" + +#~ msgid "" +#~ "Open a DM with @draupnir-" +#~ "main:example.com and if using an Element" +#~ " client send a message into this " +#~ "DM to finalise creating it. The " +#~ "bot will reject this invite and " +#~ "you will shortly get invited to " +#~ "the Draupnir control room for your " +#~ "newly provisioned Draupnir. From here " +#~ "its just a normal Draupnir experience." +#~ msgstr "" + +#~ msgid "Configuration of D4A" +#~ msgstr "" + +#~ msgid "" +#~ "You can refer to the upstream " +#~ "[documentation](https://github.com/the-draupnir-" +#~ "project/Draupnir) for more configuration " +#~ "documentation. Please note that the " +#~ "playbook ships a full copy of the" +#~ " example config that does transfer to" +#~ " provisioned Draupnirs in the " +#~ "production-bots.yaml.j2 file in the " +#~ "template directory of the role." +#~ msgstr "" + +#~ msgid "" +#~ "Please note that Config extension does" +#~ " not affect the appservices config as" +#~ " this config is not extensible in " +#~ "current Draupnir anyways. Config extension " +#~ "instead touches the config passed to " +#~ "the Draupnirs that your Appservice " +#~ "creates. So for example below makes " +#~ "all provisioned Draupnirs protect all " +#~ "joined rooms." +#~ msgstr "" + +#~ msgid "" +#~ "You can configure additional options by" +#~ " adding the " +#~ "`matrix_appservice_draupnir_for_all_extension_yaml` variable " +#~ "to your `inventory/host_vars/matrix.example.com/vars.yml`" +#~ " file." +#~ msgstr "" + +#~ msgid "" +#~ "For example to change Draupnir's " +#~ "`protectAllJoinedRooms` option to `true` you" +#~ " would add the following to your " +#~ "`vars.yml` file." +#~ msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po index 0cd924e1d..2b5dc52fe 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -34,8 +34,8 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:5 msgid "" "See the project's [documentation](https://github.com/the-draupnir-" -"project/Draupnir) to learn what it does and why it might be useful to " -"you." +"project/Draupnir/blob/main/README.md) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:7 @@ -47,21 +47,23 @@ msgid "" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:9 -msgid "If your migrating from Mjolnir skip to step 5b." +msgid "" +"If your migrating from Mjolnir skip to [this section](#migrating-from-" +"mjolnir-only-required-if-migrating)." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:11 -msgid "Register the bot account" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:13 -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 "Register the bot account" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.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-draupnir.md:17 @@ -77,7 +79,7 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:25 msgid "" "If you would like Draupnir to be able to deactivate users, move aliases, " -"shutdown rooms, show abuse reports ([see below](#abuse-reports)), etc " +"shutdown rooms, show abuse reports (see [below](#abuse-reports)), etc " "then it must be a server admin so you need to change `admin=no` to " "`admin=yes` in the command above." msgstr "" @@ -88,8 +90,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:29 msgid "" -"Refer to the documentation on [how to obtain an access token](obtaining-" -"access-tokens.md)." +"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-draupnir.md:31 @@ -98,43 +101,65 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:33 msgid "" -"You will need to prevent Synapse from rate limiting the bot's account. " -"This is not an optional step. If you do not do this step Draupnir will " -"crash. This can be done using Synapse's [admin API](https://matrix-" -"org.github.io/synapse/latest/admin_api/user_admin_api.html#override-" -"ratelimiting-for-users). Please ask for help if you are uncomfortable " -"with these steps or run into issues." +"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:35 msgid "" -"If your Synapse Admin API is exposed to the internet for some reason like" -" running the Synapse Admin Role [Link](configuring-playbook-synapse-" -"admin.md) or running " -"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:" -" true` in your playbook config. If your API is not externally exposed you" -" should still be able to on the local host for your synapse run these " -"commands." +"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:37 msgid "" -"The following command works on semi up to date Windows 10 installs and " -"All Windows 11 installations and other systems that ship curl. `curl " -"--header \"Authorization: Bearer \" -X POST " -"https://matrix.example.com/_synapse/admin/v1/users/@bot.draupnir:example.com/override_ratelimit`" -" Replace `@bot.draupnir:example.com` with the MXID of your Draupnir and " -"example.com with your homeserver domain. You can easily obtain an access " -"token for a homeserver admin account the same way you can obtain an " -"access token for Draupnir itself. If you made Draupnir Admin you can just" -" use the Draupnir token." +"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:39 +#: ../../../docs/configuring-playbook-bot-draupnir.md:43 +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 +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 +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 +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 msgid "Create a management room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:41 +#: ../../../docs/configuring-playbook-bot-draupnir.md:57 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 " @@ -143,13 +168,13 @@ msgid "" "it is important that you only invite trusted users to this room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:43 +#: ../../../docs/configuring-playbook-bot-draupnir.md:59 msgid "" "If you make the management room encrypted (E2EE), then you MUST enable " -"and use Pantalaimon (see below)." +"and use Pantalaimon (see [below](#configuration-with-e2ee-support))." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:45 +#: ../../../docs/configuring-playbook-bot-draupnir.md:61 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" @@ -157,43 +182,58 @@ msgid "" "room ID. The room ID will look something like `!qporfwt:example.com`." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:47 +#: ../../../docs/configuring-playbook-bot-draupnir.md:63 msgid "" "Finally invite the `@bot.draupnir:example.com` account you created " "earlier into the room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:49 +#: ../../../docs/configuring-playbook-bot-draupnir.md:65 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:51 +#: ../../../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" +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. To support E2EE, Draupnir needs to [use Pantalaimon" -"](configuring-playbook-pantalaimon.md)." +"moderated rooms." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:53 -msgid "a. Configuration with E2EE support" +#: ../../../docs/configuring-playbook-bot-draupnir.md:80 +msgid "" +"To support E2EE, Draupnir needs to [use Pantalaimon](configuring-" +"playbook-pantalaimon.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:55 +#: ../../../docs/configuring-playbook-bot-draupnir.md:82 +msgid "Configuration with E2EE support" +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." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:57 -#: ../../../docs/configuring-playbook-bot-draupnir.md:92 +#: ../../../docs/configuring-playbook-bot-draupnir.md:86 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:76 +#: ../../../docs/configuring-playbook-bot-draupnir.md:100 msgid "" "The playbook's `group_vars` will configure other required settings. If " "using this role separately without the playbook, you also need to " @@ -202,65 +242,108 @@ msgid "" "playbook's `group_vars`:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:88 -msgid "b. Configuration without E2EE support" +#: ../../../docs/configuring-playbook-bot-draupnir.md:112 +msgid "Configuration without E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:90 +#: ../../../docs/configuring-playbook-bot-draupnir.md:114 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:94 +#: ../../../docs/configuring-playbook-bot-draupnir.md:116 msgid "" -"You must replace `ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and " -"`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own values." +"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:104 -msgid "c. Migrating from Mjolnir (Only required if migrating.)" +#: ../../../docs/configuring-playbook-bot-draupnir.md:122 +msgid "Abuse Reports" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:106 +#: ../../../docs/configuring-playbook-bot-draupnir.md:124 +msgid "Draupnir supports two methods to receive reports in the management room." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:126 +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 +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 +msgid "Extending the configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:136 +msgid "" +"You can configure additional options by adding the " +"`matrix_bot_draupnir_configuration_extension_yaml` variable." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:138 +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 +msgid "Migrating from Mjolnir (Only required if migrating)" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:154 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:108 +#: ../../../docs/configuring-playbook-bot-draupnir.md:156 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:110 +#: ../../../docs/configuring-playbook-bot-draupnir.md:158 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:112 +#: ../../../docs/configuring-playbook-bot-draupnir.md:160 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:119 +#: ../../../docs/configuring-playbook-bot-draupnir.md:167 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:121 +#: ../../../docs/configuring-playbook-bot-draupnir.md:169 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:123 +#: ../../../docs/configuring-playbook-bot-draupnir.md:171 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:125 +#: ../../../docs/configuring-playbook-bot-draupnir.md:173 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" @@ -269,7 +352,7 @@ msgid "" "`just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:127 +#: ../../../docs/configuring-playbook-bot-draupnir.md:175 msgid "" "If you change the Pantalaimon's password " "(`matrix_bot_draupnir_pantalaimon_password` in your `vars.yml` file) " @@ -280,32 +363,32 @@ msgid "" " know its new password." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:129 +#: ../../../docs/configuring-playbook-bot-draupnir.md:177 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:131 +#: ../../../docs/configuring-playbook-bot-draupnir.md:179 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:133 +#: ../../../docs/configuring-playbook-bot-draupnir.md:181 msgid "Below is a **non-exhaustive quick-start guide** for the impatient." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:135 +#: ../../../docs/configuring-playbook-bot-draupnir.md:183 msgid "Making Draupnir join and protect a room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:137 +#: ../../../docs/configuring-playbook-bot-draupnir.md:185 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:139 +#: ../../../docs/configuring-playbook-bot-draupnir.md:187 msgid "" "Invite the bot to the room manually ([inviting Draupnir to rooms](https" "://the-draupnir-project.github.io/draupnir-documentation/moderator" @@ -313,13 +396,13 @@ msgid "" "the bot *may* ask for confirmation in the Management Room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:141 +#: ../../../docs/configuring-playbook-bot-draupnir.md:189 msgid "" "[Give the bot permissions to do its job](#giving-draupnir-permissions-to-" "do-its-job)" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:143 +#: ../../../docs/configuring-playbook-bot-draupnir.md:191 msgid "" "Tell it to protect the room (using the [rooms command](https://the-" "draupnir-project.github.io/draupnir-documentation/moderator/managing-" @@ -328,7 +411,7 @@ msgid "" "!qporfwt:example.com`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:145 +#: ../../../docs/configuring-playbook-bot-draupnir.md:193 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" @@ -337,11 +420,11 @@ msgid "" " and [Enabling built-in protections](#enabling-built-in-protections)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:147 +#: ../../../docs/configuring-playbook-bot-draupnir.md:195 msgid "Giving Draupnir permissions to do its job" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:149 +#: ../../../docs/configuring-playbook-bot-draupnir.md:197 msgid "" "For Draupnir to do its job, you need to [give it permissions](https" "://the-draupnir-project.github.io/draupnir-documentation/moderator" @@ -349,7 +432,7 @@ msgid "" "protecting. This involves **giving it an Administrator power level**." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:151 +#: ../../../docs/configuring-playbook-bot-draupnir.md:199 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 " @@ -358,11 +441,11 @@ msgid "" " it)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:153 +#: ../../../docs/configuring-playbook-bot-draupnir.md:201 msgid "Subscribing to a public policy list" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:155 +#: ../../../docs/configuring-playbook-bot-draupnir.md:203 msgid "" "We recommend **subscribing to a public [policy list](https://the-" "draupnir-project.github.io/draupnir-documentation/concepts/policy-" @@ -371,24 +454,24 @@ msgid "" "watch-command-to-subscribe-to-policy-rooms)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:157 +#: ../../../docs/configuring-playbook-bot-draupnir.md:205 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:159 +#: ../../../docs/configuring-playbook-bot-draupnir.md:207 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:161 +#: ../../../docs/configuring-playbook-bot-draupnir.md:209 msgid "Creating your own policy lists and rules" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:163 +#: ../../../docs/configuring-playbook-bot-draupnir.md:211 msgid "" "We also recommend **creating your own policy lists** with the [list " "create](https://the-draupnir-project.github.io/draupnir-" @@ -396,7 +479,7 @@ msgid "" "create-command-to-create-a-policy-room) command." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:165 +#: ../../../docs/configuring-playbook-bot-draupnir.md:213 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 " @@ -405,7 +488,7 @@ msgid "" "command, the bot will invite you to the policy list room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:167 +#: ../../../docs/configuring-playbook-bot-draupnir.md:215 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 " @@ -416,7 +499,7 @@ msgid "" "recommendation)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:169 +#: ../../../docs/configuring-playbook-bot-draupnir.md:217 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" @@ -424,19 +507,19 @@ msgid "" "targeting users." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:171 +#: ../../../docs/configuring-playbook-bot-draupnir.md:219 msgid "" "To create rules, you run commands in the Management Room (**not** in the " "policy list room)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:173 +#: ../../../docs/configuring-playbook-bot-draupnir.md:221 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:174 +#: ../../../docs/configuring-playbook-bot-draupnir.md:222 msgid "" "(ban all users on a given homeserver by using a [wildcard](https://the-" "draupnir-project.github.io/draupnir-documentation/moderator/managing-" @@ -444,34 +527,34 @@ msgid "" "all users are fake`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:176 +#: ../../../docs/configuring-playbook-bot-draupnir.md:224 msgid "As a result of running these commands, you may observe:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:178 +#: ../../../docs/configuring-playbook-bot-draupnir.md:226 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:179 +#: ../../../docs/configuring-playbook-bot-draupnir.md:227 msgid "" "applying these rules against all rooms that Draupnir is an Administrator " "in" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:181 +#: ../../../docs/configuring-playbook-bot-draupnir.md:229 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:183 +#: ../../../docs/configuring-playbook-bot-draupnir.md:231 msgid "Enabling built-in protections" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:185 +#: ../../../docs/configuring-playbook-bot-draupnir.md:233 msgid "" "You can also **turn on various built-in [protections](https://the-" "draupnir-project.github.io/draupnir-documentation/protections)** like " @@ -479,75 +562,179 @@ msgid "" "room to invite-only\")." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:187 +#: ../../../docs/configuring-playbook-bot-draupnir.md:235 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:189 +#: ../../../docs/configuring-playbook-bot-draupnir.md:237 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:191 +#: ../../../docs/configuring-playbook-bot-draupnir.md:239 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:193 +#: ../../../docs/configuring-playbook-bot-draupnir.md:241 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:195 +#: ../../../docs/configuring-playbook-bot-draupnir.md:243 msgid "" "To **disable a given protection**, send a command like this: `!draupnir " "disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:197 -msgid "Extending the configuration" -msgstr "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/the-draupnir-project/Draupnir) to learn " +#~ "what it does and why it might " +#~ "be useful to you." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:199 -msgid "" -"You can configure additional options by adding the " -"`matrix_bot_draupnir_configuration_extension_yaml` variable to your " -"`inventory/host_vars/matrix.example.com/vars.yml` file." -msgstr "" +#~ msgid "If your migrating from Mjolnir skip to step 5b." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:201 -msgid "" -"For example to change Draupnir's `recordIgnoredInvites` option to `true` " -"you would add the following to your `vars.yml` file." -msgstr "" +#~ msgid "" +#~ "The playbook does not automatically " +#~ "create users for you. The bot " +#~ "requires an access token to be " +#~ "able to connect to your homeserver." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:215 -msgid "Abuse Reports" -msgstr "" +#~ msgid "" +#~ "You **need to register the bot " +#~ "user manually** before setting up the" +#~ " bot." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:217 -msgid "Draupnir supports two methods to receive reports in the management room." -msgstr "" +#~ msgid "" +#~ "If you would like Draupnir to be" +#~ " able to deactivate users, move " +#~ "aliases, shutdown rooms, show abuse " +#~ "reports ([see below](#abuse-reports)), etc " +#~ "then it must be a server admin " +#~ "so you need to change `admin=no` " +#~ "to `admin=yes` in the command above." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:219 -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 "" +#~ msgid "" +#~ "Refer to the documentation on [how " +#~ "to obtain an access token](obtaining-" +#~ "access-tokens.md)." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:225 -msgid "" -"The other method polls an synapse admin API endpoint and is hence only " -"available when using synapse and when the Draupnir user is an admin user " -"(see step 1). To enable it, set `pollReports: true` in Draupnir's config:" -msgstr "" +#~ msgid "" +#~ "You will need to prevent Synapse " +#~ "from rate limiting the bot's account." +#~ " This is not an optional step. " +#~ "If you do not do this step " +#~ "Draupnir will crash. This can be " +#~ "done using Synapse's [admin API](https" +#~ "://matrix-" +#~ "org.github.io/synapse/latest/admin_api/user_admin_api.html" +#~ "#override-ratelimiting-for-users). Please " +#~ "ask for help if you are " +#~ "uncomfortable with these steps or run" +#~ " into issues." +#~ msgstr "" + +#~ msgid "" +#~ "If your Synapse Admin API is " +#~ "exposed to the internet for some " +#~ "reason like running the Synapse Admin" +#~ " Role [Link](configuring-playbook-synapse-" +#~ "admin.md) or running " +#~ "`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:" +#~ " true` in your playbook config. If" +#~ " your API is not externally exposed" +#~ " you should still be able to on" +#~ " the local host for your synapse " +#~ "run these commands." +#~ msgstr "" + +#~ msgid "" +#~ "The following command works on semi " +#~ "up to date Windows 10 installs and" +#~ " All Windows 11 installations and " +#~ "other systems that ship curl. `curl " +#~ "--header \"Authorization: Bearer \"" +#~ " -X POST " +#~ "https://matrix.example.com/_synapse/admin/v1/users/@bot.draupnir:example.com/override_ratelimit`" +#~ " Replace `@bot.draupnir:example.com` with the " +#~ "MXID of your Draupnir and example.com" +#~ " with your homeserver domain. You can" +#~ " easily obtain an access token for" +#~ " a homeserver admin account the same" +#~ " way you can obtain an access " +#~ "token for Draupnir itself. If you " +#~ "made Draupnir Admin you can just " +#~ "use the Draupnir token." +#~ msgstr "" + +#~ msgid "" +#~ "If you make the management room " +#~ "encrypted (E2EE), then you MUST enable" +#~ " and use Pantalaimon (see below)." +#~ msgstr "" + +#~ 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. To support E2EE, " +#~ "Draupnir needs to [use Pantalaimon" +#~ "](configuring-playbook-pantalaimon.md)." +#~ msgstr "" + +#~ msgid "a. Configuration with E2EE support" +#~ msgstr "" + +#~ msgid "b. Configuration without E2EE support" +#~ msgstr "" + +#~ msgid "" +#~ "You must replace " +#~ "`ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and " +#~ "`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own " +#~ "values." +#~ msgstr "" + +#~ msgid "c. Migrating from Mjolnir (Only required if migrating.)" +#~ msgstr "" + +#~ msgid "" +#~ "You can configure additional options by" +#~ " adding the " +#~ "`matrix_bot_draupnir_configuration_extension_yaml` variable " +#~ "to your `inventory/host_vars/matrix.example.com/vars.yml`" +#~ " file." +#~ msgstr "" + +#~ msgid "" +#~ "For example to change Draupnir's " +#~ "`recordIgnoredInvites` option to `true` you" +#~ " would add the following to your " +#~ "`vars.yml` file." +#~ msgstr "" + +#~ msgid "" +#~ "The other method polls an synapse " +#~ "admin API endpoint and is hence " +#~ "only available when using synapse and" +#~ " when the Draupnir user is an " +#~ "admin user (see step 1). To enable" +#~ " it, set `pollReports: true` in " +#~ "Draupnir's config:" +#~ msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po index ac819c836..ed983bb62 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -46,8 +46,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:9 msgid "" -"See the project's [documentation](https://github.com/matrix-org/go-neb) " -"to learn what it does and why it might be useful to you." +"See the project's [documentation](https://github.com/matrix-org/go-" +"neb/blob/master/README.md) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:11 @@ -204,3 +205,10 @@ msgid "" "/matrix-org/go-neb)." msgstr "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/matrix-org/go-neb) to learn what it" +#~ " does and why it might be " +#~ "useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po index f0140fabc..02ef49eae 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -37,9 +37,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:7 msgid "" -"See the project's [documentation](https://github.com/etkecc/honoroit#how-" -"it-looks-like) to learn what it does with screenshots and why it might be" -" useful to you." +"See the project's " +"[documentation](https://github.com/etkecc/honoroit/blob/main/README.md) " +"to learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:9 @@ -167,3 +167,11 @@ msgid "" "[documentation](https://github.com/etkecc/honoroit#features)." msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/etkecc/honoroit#how-it-" +#~ "looks-like) to learn what it does " +#~ "with screenshots and why it might " +#~ "be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po index ecb6fe7c7..9d7ccf99e 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -44,7 +44,7 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:7 msgid "" "See the project's [documentation](https://github.com/moan0s/matrix-" -"registration-bot#supported-commands) to learn what it does and why it " +"registration-bot/blob/master/README.md) to learn what it does and why it " "might be useful to you." msgstr "" @@ -146,3 +146,11 @@ msgid "" "etc… you can use:" msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/moan0s/matrix-" +#~ "registration-bot#supported-commands) to learn " +#~ "what it does and why it might " +#~ "be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po index 6bb4c05e2..4875ce7c1 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -40,8 +40,8 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:7 msgid "" "See the project's [documentation](https://github.com/anoadragon453" -"/matrix-reminder-bot#usage) to learn what it does and why it might be " -"useful to you." +"/matrix-reminder-bot/blob/master/README.md) to learn what it does and why" +" it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:9 @@ -134,3 +134,11 @@ msgid "" "bot#usage)." msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/anoadragon453/matrix-" +#~ "reminder-bot#usage) to learn what it " +#~ "does and why it might be useful" +#~ " to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po index abfc1d669..2075ec200 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -33,22 +33,23 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:5 msgid "" -"See the project's [documentation](https://github.com/matrix-org/mjolnir) " -"to learn what it does and why it might be useful to you." +"See the project's [documentation](https://github.com/matrix-" +"org/mjolnir/blob/main/README.md) to learn what it does and why it might " +"be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:7 -msgid "Register the bot account" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:9 -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 "Register the bot account" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:11 -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-mjolnir.md:13 @@ -74,8 +75,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:25 msgid "" -"Refer to the documentation on [how to obtain an access token](obtaining-" -"access-tokens.md)." +"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-mjolnir.md:27 @@ -84,43 +86,65 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:29 msgid "" -"You will need to prevent Synapse from rate limiting the bot's account. " -"This is not an optional step. If you do not do this step Mjolnir will " -"crash. This can be done using Synapse's [admin API](https://matrix-" -"org.github.io/synapse/latest/admin_api/user_admin_api.html#override-" -"ratelimiting-for-users). Please ask for help if you are uncomfortable " -"with these steps or run into issues." +"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:31 msgid "" -"If your Synapse Admin API is exposed to the internet for some reason like" -" running the Synapse Admin Role [Link](configuring-playbook-synapse-" -"admin.md) or running " -"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:" -" true` in your playbook config. If your API is not externally exposed you" -" should still be able to on the local host for your synapse run these " -"commands." +"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:33 msgid "" -"The following command works on semi up to date Windows 10 installs and " -"All Windows 11 installations and other systems that ship curl. `curl " -"--header \"Authorization: Bearer \" -X POST " -"https://matrix.example.com/_synapse/admin/v1/users/@bot.mjolnir:example.com/override_ratelimit`" -" Replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir and " -"example.com with your homeserver domain. You can easily obtain an access " -"token for a homeserver admin account the same way you can obtain an " -"access token for Mjolnir itself. If you made Mjolnir Admin you can just " -"use the Mjolnir token." +"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:35 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:39 +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 +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 +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 +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 msgid "Create a management room" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:37 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:53 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 " @@ -129,13 +153,13 @@ msgid "" "it is important that you only invite trusted users to this room." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:39 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:55 msgid "" "If you make the management room encrypted (E2EE), then you MUST enable " -"and use Pantalaimon (see below)." +"and use Pantalaimon (see [below](#configuration-with-e2ee-support))." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:41 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:57 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" @@ -143,44 +167,58 @@ msgid "" "room ID. The room ID will look something like `!qporfwt:example.com`." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:43 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:59 msgid "" "Finally invite the `@bot.mjolnir:example.com` account you created earlier" " into the room." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:45 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:61 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:47 +#: ../../../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" +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. To support E2EE, Mjolnir needs to [use Pantalaimon" -"](configuring-playbook-pantalaimon.md)." +"moderated rooms." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:49 -msgid "a. Configuration with E2EE support" +#: ../../../docs/configuring-playbook-bot-mjolnir.md:76 +msgid "" +"To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-" +"pantalaimon.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:51 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:78 +msgid "Configuration with E2EE support" +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." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:53 -#: ../../../docs/configuring-playbook-bot-mjolnir.md:88 -#: ../../../docs/configuring-playbook-bot-mjolnir.md:102 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:82 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:72 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:96 msgid "" "The playbook's `group_vars` will configure other required settings. If " "using this role separately without the playbook, you also need to " @@ -189,53 +227,80 @@ msgid "" "playbook's `group_vars`:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:84 -msgid "b. Configuration without E2EE support" +#: ../../../docs/configuring-playbook-bot-mjolnir.md:108 +msgid "Configuration without E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:86 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:110 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:90 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:112 msgid "" -"You must replace `ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and " -"`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own values." +"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:100 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:118 msgid "Adding Mjolnir synapse antispam module (optional)" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:112 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:120 +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 +msgid "Extending the configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-mjolnir.md:132 +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 +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 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:114 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:150 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:121 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:157 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:123 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:159 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:125 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:161 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:127 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:163 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" @@ -244,7 +309,7 @@ msgid "" "`just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:129 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:165 msgid "" "If you change the Pantalaimon's password " "(`matrix_bot_mjolnir_pantalaimon_password` in your `vars.yml` file) " @@ -255,11 +320,11 @@ msgid "" "know its new password." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:131 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:167 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:133 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:169 msgid "" "You can refer to the upstream [documentation](https://github.com/matrix-" "org/mjolnir) for additional ways to use and configure Mjolnir. Check out " @@ -267,16 +332,113 @@ msgid "" "#quickstart-guide) for some basic commands you can give to the bot." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:135 -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 "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/matrix-org/mjolnir) to learn what it " +#~ "does and why it might be useful" +#~ " to you." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:137 -msgid "" -"For example to change Mjolnir's `recordIgnoredInvites` option to `true` " -"you would add the following to your `vars.yml` file." -msgstr "" +#~ msgid "" +#~ "The playbook does not automatically " +#~ "create users for you. The bot " +#~ "requires an access token to be " +#~ "able to connect to your homeserver." +#~ msgstr "" + +#~ msgid "" +#~ "You **need to register the bot " +#~ "user manually** before setting up the" +#~ " bot." +#~ msgstr "" + +#~ msgid "" +#~ "Refer to the documentation on [how " +#~ "to obtain an access token](obtaining-" +#~ "access-tokens.md)." +#~ msgstr "" + +#~ msgid "" +#~ "You will need to prevent Synapse " +#~ "from rate limiting the bot's account." +#~ " This is not an optional step. " +#~ "If you do not do this step " +#~ "Mjolnir will crash. This can be " +#~ "done using Synapse's [admin API](https" +#~ "://matrix-" +#~ "org.github.io/synapse/latest/admin_api/user_admin_api.html" +#~ "#override-ratelimiting-for-users). Please " +#~ "ask for help if you are " +#~ "uncomfortable with these steps or run" +#~ " into issues." +#~ msgstr "" + +#~ msgid "" +#~ "If your Synapse Admin API is " +#~ "exposed to the internet for some " +#~ "reason like running the Synapse Admin" +#~ " Role [Link](configuring-playbook-synapse-" +#~ "admin.md) or running " +#~ "`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:" +#~ " true` in your playbook config. If" +#~ " your API is not externally exposed" +#~ " you should still be able to on" +#~ " the local host for your synapse " +#~ "run these commands." +#~ msgstr "" + +#~ msgid "" +#~ "The following command works on semi " +#~ "up to date Windows 10 installs and" +#~ " All Windows 11 installations and " +#~ "other systems that ship curl. `curl " +#~ "--header \"Authorization: Bearer \"" +#~ " -X POST " +#~ "https://matrix.example.com/_synapse/admin/v1/users/@bot.mjolnir:example.com/override_ratelimit`" +#~ " Replace `@bot.mjolnir:example.com` with the " +#~ "MXID of your Mjolnir and example.com " +#~ "with your homeserver domain. You can " +#~ "easily obtain an access token for " +#~ "a homeserver admin account the same " +#~ "way you can obtain an access token" +#~ " for Mjolnir itself. If you made " +#~ "Mjolnir Admin you can just use the" +#~ " Mjolnir token." +#~ msgstr "" + +#~ msgid "" +#~ "If you make the management room " +#~ "encrypted (E2EE), then you MUST enable" +#~ " and use Pantalaimon (see below)." +#~ msgstr "" + +#~ 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. To support E2EE, " +#~ "Mjolnir needs to [use Pantalaimon" +#~ "](configuring-playbook-pantalaimon.md)." +#~ msgstr "" + +#~ msgid "a. Configuration with E2EE support" +#~ msgstr "" + +#~ msgid "b. Configuration without E2EE support" +#~ msgstr "" + +#~ msgid "" +#~ "You must replace " +#~ "`ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and " +#~ "`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own " +#~ "values." +#~ msgstr "" + +#~ msgid "" +#~ "For example to change Mjolnir's " +#~ "`recordIgnoredInvites` option to `true` you" +#~ " would add the following to your " +#~ "`vars.yml` file." +#~ msgstr "" diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po index 6f6d15853..eb6315d87 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -45,8 +45,8 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:7 msgid "" "See the project's [documentation](https://src.miscworks.net/fair/matrix-" -"appservice-kakaotalk) to learn what it does and why it might be useful to" -" you." +"appservice-kakaotalk/src/branch/master/README.md) to learn what it does " +"and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:9 @@ -228,3 +228,11 @@ msgid "" "in the future, as that would break the Double Puppeting feature" msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://src.miscworks.net/fair/matrix-" +#~ "appservice-kakaotalk) to learn what it " +#~ "does and why it might be useful" +#~ " to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po index 47df023ab..b322b503e 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -33,8 +33,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:5 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://github.com/kelaresg/go-skype-" +"bridge/blob/master/README.md) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:7 @@ -98,3 +99,9 @@ msgstr "" msgid "Send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po index 0edf49773..919f68a76 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -43,9 +43,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-heisenbridge.md:7 msgid "" "See the project's " -"[README](https://github.com/hifi/heisenbridge/blob/master/README.md) to " -"learn what it does and why it might be useful to you. You can also take a" -" look at [this demonstration " +"[documentation](https://github.com/hifi/heisenbridge/blob/master/README.md)" +" to learn what it does and why it might be useful to you. You can also " +"take a look at [this demonstration " "video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)." msgstr "" @@ -183,3 +183,13 @@ msgid "" "[#heisenbridge:vi.fi](https://matrix.to/#/#heisenbridge:vi.fi) for help." msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[README](https://github.com/hifi/heisenbridge/blob/master/README.md)" +#~ " to learn what it does and why" +#~ " it might be useful to you. You" +#~ " can also take a look at [this" +#~ " demonstration " +#~ "video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po index dfb2b601d..394ad2aa8 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -34,15 +34,15 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:5 msgid "" "Hookshot can bridge [Webhooks](https://en.wikipedia.org/wiki/Webhook) " -"from software project management services such as GitHub, GitLab, JIRA, " +"from software project management services such as GitHub, GitLab, Jira, " "and Figma, as well as generic webhooks." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:7 msgid "" "See the project's [documentation](https://matrix-org.github.io/matrix-" -"hookshot/latest/hookshot.html) to learn what it does in detail and why it" -" might be useful to you." +"hookshot/latest/hookshot.html) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:9 @@ -53,152 +53,172 @@ msgid "" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:11 -msgid "Setup Instructions" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:13 -msgid "" -"Refer to the [official instructions](https://matrix-org.github.io/matrix-" -"hookshot/latest/setup.html) to learn what the individual options do." +msgid "Download GitHub app private key (optional)" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:15 msgid "" -"Enable the bridge by adding `matrix_hookshot_enabled: true` to your " -"`vars.yml` file" -msgstr "" - -#: ../../../docs/configuring-playbook-bridge-hookshot.md:16 -msgid "" -"For each of the services (GitHub, GitLab, Jira, Figma, generic webhooks) " -"fill in the respective variables `matrix_hookshot_service_*` listed in " -"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml) as " -"required." +"If you're setting up the GitHub bridge, you need to create your GitHub " +"app, and generate a private key file of it." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:17 msgid "" -"Take special note of the `matrix_hookshot_*_enabled` variables. Services " -"that need no further configuration are enabled by default (GitLab, " -"Generic), while you must first add the required configuration and enable " -"the others (GitHub, Jira, Figma)." -msgstr "" - -#: ../../../docs/configuring-playbook-bridge-hookshot.md:18 -msgid "" -"If you're setting up the GitHub bridge, you'll need to generate and " -"download a private key file after you created your GitHub app. Copy the " -"contents of that file to the variable " -"`matrix_hookshot_github_private_key` so the playbook can install it for " -"you, or use one of the [other methods](#manage-github-private-key-with-" -"aux-role) explained below." +"You need to download the private key file, if you will install the file " +"manually or with the `aux` role. For details, see [the section below" +"](#manage-github-private-key-with-aux-role)." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:19 -msgid "" -"If you've already installed Matrix services using the playbook before, " -"you'll need to re-run it (`--tags=setup-all,start`). If not, proceed with" -" [configuring other playbook services](configuring-playbook.md) and then " -"with [Installing](installing.md). Get back to this guide once ready. " -"Hookshot can be set up individually using the tag `setup-hookshot`." +msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:21 msgid "" -"Other configuration options are available via the " +"Add the following configuration to your " +"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to " +"replace `GITHUB_PRIVATE_KEY_HERE` with the one created [above](#download-" +"github-app-private-key)." +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:35 +msgid "" +"For each of the services (GitHub, GitLab, Jira, Figma, and generic " +"webhooks) fill in the respective variables `matrix_hookshot_service_*` " +"listed in [main.yml](../roles/custom/matrix-bridge-" +"hookshot/defaults/main.yml) as required." +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:37 +msgid "" +"Take special note of the `matrix_hookshot_*_enabled` variables. Services " +"that need no further configuration are enabled by default (GitLab and " +"generic webhooks), while you must first add the required configuration " +"and enable the others (GitHub, Jira, and Figma)." +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:39 +msgid "Extending the configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:41 +msgid "" +"You can configure additional options by adding the " "`matrix_hookshot_configuration_extension_yaml` and " -"`matrix_hookshot_registration_extension_yaml` variables, see the comments" -" in [main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml) " -"for how to use them." +"`matrix_hookshot_registration_extension_yaml` variables." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:23 -msgid "Finally, run the playbook (see [installing](installing.md))." -msgstr "" - -#: ../../../docs/configuring-playbook-bridge-hookshot.md:25 -msgid "End-to-bridge encryption" -msgstr "" - -#: ../../../docs/configuring-playbook-bridge-hookshot.md:27 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:43 msgid "" -"You can enable [encryption](https://matrix-org.github.io/matrix-" -"hookshot/latest/advanced/encryption.html) for Hookshot by adding " -"`matrix_hookshot_encryption_enabled: true` to your configuration " -"(`vars.yml`) and [executing the playbook](installing.md) again." +"Refer the [official instructions](https://matrix-org.github.io/matrix-" +"hookshot/latest/setup.html) and the comments in " +"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml) to " +"learn what the individual options do." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:29 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:45 +msgid "Installing" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:47 msgid "" -"Should the crypto store be corrupted, you can reset it by executing this " -"Ansible playbook with the tag `reset-hookshot-encryption` added, for " -"example `ansible-playbook -i inventory/hosts setup.yml --tags=reset-" -"hookshot-encryption`." +"After configuring the playbook, run it with [playbook tags](playbook-" +"tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:31 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:54 +msgid "" +"The shortcut commands with the [`just` program](just.md) are also " +"available: `just install-service hookshot` or `just setup-all`" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:56 +msgid "" +"`just install-service hookshot` 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-bridge-hookshot.md:58 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:33 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:60 msgid "" "To use the bridge, you need to create a room and invite the Hookshot bot " "(`@hookshot:example.com`) to it." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:35 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:62 msgid "" "Make sure the bot is able to send state events (usually the Moderator " "power level in clients)." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:37 -msgid "Send a `!hookshot help` message to see a list of help commands." +#: ../../../docs/configuring-playbook-bridge-hookshot.md:64 +msgid "" +"Send `!hookshot help` to the room to see the bridge's help menu for " +"additional commands." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:39 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:66 msgid "" "Refer to [Hookshot's documentation](https://matrix-org.github.io/matrix-" "hookshot/latest/usage.html) for more details about using the bridge's " "various features." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:41 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:68 msgid "" -"**Important**: Note that the different listeners are bound to certain " -"paths which might differ from those assumed by the hookshot " -"documentation, see [URLs for bridges setup](#urls-for-bridges-setup) " -"below." +"💡 **Note**: the different listeners are bound to certain paths which " +"might differ from those assumed by the hookshot documentation. See [URLs " +"for bridges setup](#urls-for-bridges-setup) below." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:43 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:70 +msgid "Reset crypto store" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:72 +msgid "" +"Should the crypto store be corrupted, you can reset it by executing this " +"Ansible playbook with the tag `reset-hookshot-encryption` added:" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:78 msgid "More setup documentation" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:45 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:80 msgid "URLs for bridges setup" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:47 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:82 msgid "" "Unless indicated otherwise, the following endpoints are reachable on your" " `matrix.` subdomain (if the feature is enabled)." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md -msgid "listener" +msgid "Listener" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md -msgid "default path" +msgid "Default path" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md -msgid "variable" +msgid "Variable" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md -msgid "used as" +msgid "Used as" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md @@ -262,7 +282,7 @@ msgid "`matrix_hookshot_jira_oauth_endpoint`" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md -msgid "JIRA OAuth" +msgid "Jira OAuth" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md @@ -349,71 +369,72 @@ msgstr "" msgid "Prometheus" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:61 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:96 msgid "" "Also see the various `matrix_hookshot_container_labels_*` variables in " -"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml), which" -" expose URLs publicly." +"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml), " +"which expose URLs publicly" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:63 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:98 msgid "" "The different listeners are also reachable *internally* in the docker-" "network via the container's name (configured by " "`matrix_hookshot_container_url`) and on different ports (e.g. " -"`matrix_hookshot_appservice_port`). Read [main.yml](/roles/custom/matrix-" -"bridge-hookshot/defaults/main.yml) in detail for more info." +"`matrix_hookshot_appservice_port`). Read [main.yml](../roles/custom" +"/matrix-bridge-hookshot/defaults/main.yml) in detail for more info." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:65 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:100 msgid "Manage GitHub Private Key with aux role" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:67 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:102 msgid "" "The GitHub bridge requires you to install a private key file. This can be" " done in multiple ways:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:68 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:104 msgid "" "copy the *contents* of the downloaded file and set the variable " "`matrix_hookshot_github_private_key` to the contents (see example in " -"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml))." +"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml))." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:69 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:105 msgid "" "somehow copy the file to the path `{{ matrix_hookshot_base_path }}/{{ " "matrix_hookshot_github_private_key_file }}` (default: `/matrix/hookshot" "/private-key.pem`) on the server manually." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:70 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:106 msgid "" "use the [`aux` role](https://github.com/mother-of-all-self-hosting" "/ansible-role-aux) to copy the file from an arbitrary path on your " "ansible client to the correct path on the server." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:72 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:108 msgid "" "To use the `aux` role, make sure the `matrix_hookshot_github_private_key`" -" variable is empty. Then add the following additional configuration:" +" variable is empty. Then add the following configuration to your " +"`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:83 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:119 msgid "" "For more information, see the documentation in the [default configuration" " of the aux role](https://github.com/mother-of-all-self-hosting/ansible-" "role-aux/blob/main/defaults/main.yml)." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:85 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:121 msgid "Provisioning API" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:87 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:123 msgid "" "The provisioning API will be enabled automatically if you set " "`matrix_dimension_enabled: true` and provided a " @@ -423,11 +444,11 @@ msgid "" "`matrix_hookshot_container_url` and `matrix_hookshot_provisioning_port`." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:89 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:125 msgid "Metrics" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:91 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:127 msgid "" "Metrics are **only enabled by default** if the builtin [Prometheus" "](configuring-playbook-prometheus-grafana.md) is enabled (by default, " @@ -436,32 +457,32 @@ msgid "" "set up your own Dashboard for displaying them." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:93 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:129 msgid "" "To explicitly enable metrics, use `matrix_hookshot_metrics_enabled: " "true`. This only exposes metrics over the container network, however." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:95 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:131 msgid "" "**To collect metrics from an external Prometheus server**, besides " "enabling metrics as described above, you will also need to enable metrics" " exposure on `https://matrix.example.com/metrics/hookshot` by:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:97 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:133 msgid "" "either enabling metrics exposure for Hookshot via " "`matrix_hookshot_metrics_proxying_enabled: true`" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:98 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:134 msgid "" "or enabling metrics exposure for all services via " "`matrix_metrics_exposure_enabled: true`" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:100 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:136 msgid "" "Whichever one you go with, by default metrics are exposed publicly " "**without** password-protection. See [the Prometheus and Grafana docs" @@ -469,11 +490,11 @@ msgid "" "protection for metrics." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:102 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:138 msgid "Collision with matrix-appservice-webhooks" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:104 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:140 msgid "" "If you are also running [matrix-appservice-webhooks](configuring-" "playbook-bridge-appservice-webhooks.md), it reserves its namespace by the" @@ -483,3 +504,175 @@ msgid "" "`matrix_hookshot_generic_userIdPrefix: '_webhooks_'`)." msgstr "" +#~ msgid "" +#~ "Hookshot can bridge " +#~ "[Webhooks](https://en.wikipedia.org/wiki/Webhook) from " +#~ "software project management services such " +#~ "as GitHub, GitLab, JIRA, and Figma, " +#~ "as well as generic webhooks." +#~ msgstr "" + +#~ msgid "" +#~ "See the project's [documentation](https://matrix-" +#~ "org.github.io/matrix-hookshot/latest/hookshot.html) to " +#~ "learn what it does in detail and" +#~ " why it might be useful to you." +#~ msgstr "" + +#~ msgid "Setup Instructions" +#~ msgstr "" + +#~ msgid "" +#~ "Refer to the [official instructions](https" +#~ "://matrix-org.github.io/matrix-hookshot/latest/setup.html)" +#~ " to learn what the individual options" +#~ " do." +#~ msgstr "" + +#~ msgid "" +#~ "Enable the bridge by adding " +#~ "`matrix_hookshot_enabled: true` to your " +#~ "`vars.yml` file" +#~ msgstr "" + +#~ msgid "" +#~ "For each of the services (GitHub, " +#~ "GitLab, Jira, Figma, generic webhooks) " +#~ "fill in the respective variables " +#~ "`matrix_hookshot_service_*` listed in " +#~ "[main.yml](/roles/custom/matrix-bridge-" +#~ "hookshot/defaults/main.yml) as required." +#~ msgstr "" + +#~ msgid "" +#~ "Take special note of the " +#~ "`matrix_hookshot_*_enabled` variables. Services that" +#~ " need no further configuration are " +#~ "enabled by default (GitLab, Generic), " +#~ "while you must first add the " +#~ "required configuration and enable the " +#~ "others (GitHub, Jira, Figma)." +#~ msgstr "" + +#~ msgid "" +#~ "If you're setting up the GitHub " +#~ "bridge, you'll need to generate and " +#~ "download a private key file after " +#~ "you created your GitHub app. Copy " +#~ "the contents of that file to the" +#~ " variable `matrix_hookshot_github_private_key` so " +#~ "the playbook can install it for " +#~ "you, or use one of the [other " +#~ "methods](#manage-github-private-key-with-" +#~ "aux-role) explained below." +#~ msgstr "" + +#~ msgid "" +#~ "If you've already installed Matrix " +#~ "services using the playbook before, " +#~ "you'll need to re-run it (`--tags" +#~ "=setup-all,start`). If not, proceed with" +#~ " [configuring other playbook services" +#~ "](configuring-playbook.md) and then with " +#~ "[Installing](installing.md). Get back to this" +#~ " guide once ready. Hookshot can be" +#~ " set up individually using the tag" +#~ " `setup-hookshot`." +#~ msgstr "" + +#~ msgid "" +#~ "Other configuration options are available " +#~ "via the `matrix_hookshot_configuration_extension_yaml` " +#~ "and `matrix_hookshot_registration_extension_yaml` " +#~ "variables, see the comments in " +#~ "[main.yml](/roles/custom/matrix-bridge-" +#~ "hookshot/defaults/main.yml) for how to use " +#~ "them." +#~ msgstr "" + +#~ msgid "Finally, run the playbook (see [installing](installing.md))." +#~ msgstr "" + +#~ msgid "End-to-bridge encryption" +#~ msgstr "" + +#~ msgid "" +#~ "You can enable [encryption](https://matrix-" +#~ "org.github.io/matrix-hookshot/latest/advanced/encryption.html)" +#~ " for Hookshot by adding " +#~ "`matrix_hookshot_encryption_enabled: true` to your" +#~ " configuration (`vars.yml`) and [executing " +#~ "the playbook](installing.md) again." +#~ msgstr "" + +#~ msgid "" +#~ "Should the crypto store be corrupted," +#~ " you can reset it by executing " +#~ "this Ansible playbook with the tag " +#~ "`reset-hookshot-encryption` added, for " +#~ "example `ansible-playbook -i inventory/hosts" +#~ " setup.yml --tags=reset-hookshot-encryption`." +#~ msgstr "" + +#~ msgid "Send a `!hookshot help` message to see a list of help commands." +#~ msgstr "" + +#~ msgid "" +#~ "**Important**: Note that the different " +#~ "listeners are bound to certain paths " +#~ "which might differ from those assumed" +#~ " by the hookshot documentation, see " +#~ "[URLs for bridges setup](#urls-for-" +#~ "bridges-setup) below." +#~ msgstr "" + +#~ msgid "listener" +#~ msgstr "" + +#~ msgid "default path" +#~ msgstr "" + +#~ msgid "variable" +#~ msgstr "" + +#~ msgid "used as" +#~ msgstr "" + +#~ msgid "JIRA OAuth" +#~ msgstr "" + +#~ msgid "" +#~ "Also see the various " +#~ "`matrix_hookshot_container_labels_*` variables in " +#~ "[main.yml](/roles/custom/matrix-bridge-" +#~ "hookshot/defaults/main.yml), which expose URLs " +#~ "publicly." +#~ msgstr "" + +#~ msgid "" +#~ "The different listeners are also " +#~ "reachable *internally* in the docker-" +#~ "network via the container's name " +#~ "(configured by `matrix_hookshot_container_url`) and" +#~ " on different ports (e.g. " +#~ "`matrix_hookshot_appservice_port`). Read " +#~ "[main.yml](/roles/custom/matrix-bridge-" +#~ "hookshot/defaults/main.yml) in detail for more" +#~ " info." +#~ msgstr "" + +#~ msgid "" +#~ "copy the *contents* of the downloaded" +#~ " file and set the variable " +#~ "`matrix_hookshot_github_private_key` to the contents" +#~ " (see example in [main.yml](/roles/custom" +#~ "/matrix-bridge-hookshot/defaults/main.yml))." +#~ msgstr "" + +#~ msgid "" +#~ "To use the `aux` role, make sure" +#~ " the `matrix_hookshot_github_private_key` variable " +#~ "is empty. Then add the following " +#~ "additional configuration:" +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po index ef36a1e26..d3f504115 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -33,8 +33,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:5 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://github.com/benkuly/matrix-sms-" +"bridge/blob/master/README.md) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:7 @@ -99,3 +100,9 @@ msgid "" "bridge/blob/master/README.md#user-guide) to see how this bridge works." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po index 081ced85a..76826e601 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -40,8 +40,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:7 msgid "" -"See the project's [documentation](https://github.com/mautrix/twitter) to " -"learn what it does and why it might be useful to you." +"See the project's " +"[documentation](https://github.com/mautrix/twitter/blob/master/README.md)" +" to learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:9 @@ -49,58 +50,61 @@ msgid "Prerequisite (optional)" msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:11 +msgid "Enable Appservice Double Puppet (optional)" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:13 msgid "" "If you want to set up [Double " "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) " "(hint: you most likely do) for this bridge automatically, you need to " "have enabled [Appservice Double Puppet](configuring-playbook-appservice-" -"double-puppet.md) or [Shared Secret Auth](configuring-playbook-shared-" -"secret-auth.md) service for this playbook." +"double-puppet.md) service for this playbook." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:13 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:15 msgid "" "For details about configuring Double Puppeting for this bridge, see the " "section below: [Set up Double Puppeting](#-set-up-double-puppeting)" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:15 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:17 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:17 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:19 msgid "" "To enable the bridge, add the following configuration to your " "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:23 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:25 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:25 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:27 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:32 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:34 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:34 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:36 msgid "" "The `ensure-matrix-users-created` playbook tag makes the playbook " "automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:36 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:38 msgid "" "The shortcut commands with the [`just` program](just.md) are also " "available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:38 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:40 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" @@ -109,71 +113,60 @@ msgid "" "`just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:40 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:42 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:42 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:44 msgid "" "You then need to start a chat with `@twitterbot:example.com` (where " "`example.com` is your base domain, not the `matrix.` domain)." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:43 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:45 msgid "" "Send login-cookie to start the login. The bot should respond with " "instructions on how to proceed." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:45 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:47 msgid "" "You can learn more here about authentication from the bridge's [official " "documentation on " "Authentication](https://docs.mau.fi/bridges/python/twitter/authentication.html)." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:47 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:49 msgid "💡 Set up Double Puppeting" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:49 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:51 msgid "" "After successfully enabling bridging, you may wish to set up [Double " "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) " "(hint: you most likely do)." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:51 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:53 msgid "To set it up, you have 2 ways of going about it." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:53 -msgid "" -"Method 1: automatically, by enabling Appservice Double Puppet or Shared " -"Secret Auth" -msgstr "" - #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:55 -msgid "" -"The bridge automatically performs Double Puppeting if [Appservice Double " -"Puppet](configuring-playbook-appservice-double-puppet.md) or [Shared " -"Secret Auth](configuring-playbook-shared-secret-auth.md) service is " -"configured and enabled on the server for this playbook." +msgid "Method 1: automatically, by enabling Appservice Double Puppet" msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:57 msgid "" -"Enabling [Appservice Double Puppet](configuring-playbook-appservice-" -"double-puppet.md) is the recommended way of setting up Double Puppeting, " -"as it's easier to accomplish, works for all your users automatically, and" -" has less of a chance of breaking in the future." +"The bridge automatically performs Double Puppeting if [Appservice Double " +"Puppet](configuring-playbook-appservice-double-puppet.md) service is " +"configured and enabled on the server for this playbook." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:59 msgid "" -"Enabling double puppeting by enabling the [Shared Secret Auth" -"](configuring-playbook-shared-secret-auth.md) service works at the time " -"of writing, but is deprecated and will stop working in the future." +"This is the recommended way of setting up Double Puppeting, as it's " +"easier to accomplish, works for all your users automatically, and has " +"less of a chance of breaking in the future." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:61 @@ -182,9 +175,88 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:63 msgid "" -"This method is currently not available for the Mautrix-Twitter bridge, " -"but is on the " -"[roadmap](https://github.com/mautrix/twitter/blob/master/ROADMAP.md) " -"under Misc/Manual login with `login-matrix`" +"When using this method, **each user** that wishes to enable Double " +"Puppeting needs to follow the following steps:" 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)." +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:67 +msgid "" +"send the access token to the bot. Example: `login-matrix " +"MATRIX_ACCESS_TOKEN_HERE`" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:69 +msgid "" +"make sure you don't log out the `Mautrix-Slack` device some time in the " +"future, as that would break the Double Puppeting feature" +msgstr "" + +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/mautrix/twitter) to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + +#~ msgid "" +#~ "If you want to set up [Double " +#~ "Puppeting](https://docs.mau.fi/bridges/general/double-" +#~ "puppeting.html) (hint: you most likely " +#~ "do) for this bridge automatically, you" +#~ " need to have enabled [Appservice " +#~ "Double Puppet](configuring-playbook-appservice-" +#~ "double-puppet.md) or [Shared Secret Auth" +#~ "](configuring-playbook-shared-secret-auth.md) " +#~ "service for this playbook." +#~ msgstr "" + +#~ msgid "" +#~ "Method 1: automatically, by enabling " +#~ "Appservice Double Puppet or Shared " +#~ "Secret Auth" +#~ msgstr "" + +#~ msgid "" +#~ "The bridge automatically performs Double " +#~ "Puppeting if [Appservice Double Puppet" +#~ "](configuring-playbook-appservice-double-" +#~ "puppet.md) or [Shared Secret Auth" +#~ "](configuring-playbook-shared-secret-auth.md) " +#~ "service is configured and enabled on " +#~ "the server for this playbook." +#~ msgstr "" + +#~ msgid "" +#~ "Enabling [Appservice Double Puppet](configuring-" +#~ "playbook-appservice-double-puppet.md) is " +#~ "the recommended way of setting up " +#~ "Double Puppeting, as it's easier to " +#~ "accomplish, works for all your users " +#~ "automatically, and has less of a " +#~ "chance of breaking in the future." +#~ msgstr "" + +#~ msgid "" +#~ "Enabling double puppeting by enabling " +#~ "the [Shared Secret Auth](configuring-" +#~ "playbook-shared-secret-auth.md) service " +#~ "works at the time of writing, but" +#~ " is deprecated and will stop working" +#~ " in the future." +#~ msgstr "" + +#~ msgid "" +#~ "This method is currently not available" +#~ " for the Mautrix-Twitter bridge, but" +#~ " is on the " +#~ "[roadmap](https://github.com/mautrix/twitter/blob/master/ROADMAP.md)" +#~ " under Misc/Manual login with `login-" +#~ "matrix`" +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po index 6a2c5924a..91e79ff01 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -36,8 +36,8 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:5 msgid "" "See the project's " -"[documentation](https://github.com/mautrix/wsproxy#readme) to learn what " -"it does and why it might be useful to you." +"[documentation](https://github.com/mautrix/wsproxy/blob/master/README.md)" +" to learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:7 @@ -144,3 +144,10 @@ msgid "" "running `android-sms` and/or `matrix-imessage` on your device(s)." msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/mautrix/wsproxy#readme) to" +#~ " learn what it does and why it" +#~ " might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po index 26c2b1f5b..f71b36d15 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -55,8 +55,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:9 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://gitlab.com/mx-puppet/discord" +"/mx-puppet-discord/blob/master/README.md) to learn what it does and why " +"it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:11 @@ -138,3 +139,9 @@ msgstr "" msgid "Also send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po index 9aa89f8cd..eb1a89f86 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -34,8 +34,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:5 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://gitlab.com/xangelix-pub/matrix" +"/mx-puppet-groupme/blob/master/README.md) to learn what it does and why " +"it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:7 @@ -122,3 +123,9 @@ msgstr "" msgid "Also send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po index 93cc2b2bc..344a58cfc 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -41,8 +41,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:7 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://gitlab.com/mx-puppet/slack/mx-" +"puppet-slack/blob/master/README.md) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:9 @@ -135,3 +136,9 @@ msgstr "" msgid "Also send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po index 41cb05e14..f39f3bcfd 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -33,8 +33,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:5 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://github.com/icewind1991/mx-" +"puppet-steam/blob/master/README.md) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:7 @@ -115,3 +116,9 @@ msgstr "" msgid "Also send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po index de0581490..8b1dec811 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -40,8 +40,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:7 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://github.com/Sorunome/mx-puppet-" +"twitter/blob/master/README.md) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:9 @@ -129,3 +130,9 @@ msgstr "" msgid "Also send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po index e16cef9a6..d35e570a5 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -42,8 +42,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-postmoogle.md:9 msgid "" -"See the project's [documentation](https://github.com/etkecc/postmoogle) " -"to learn what it does and why it might be useful to you." +"See the project's " +"[documentation](https://github.com/etkecc/postmoogle/blob/master/README.md)" +" to learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-postmoogle.md:11 @@ -192,3 +193,10 @@ msgid "" " it to `DEBUG` with the following additional configuration:" msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/etkecc/postmoogle) to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po index 95a401bfa..24e25c999 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -34,8 +34,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-wechat.md:5 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://github.com/duo/matrix-" +"wechat/blob/master/README.md) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-wechat.md:7 @@ -97,3 +98,9 @@ msgstr "" msgid "Send `help` to the bot to see the available commands." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po index 199006251..18d078a8e 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -227,33 +227,59 @@ msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:87 msgid "" -"To enable Email2Matrix, run the playbook with [playbook tags](playbook-" +"After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:93 +#: ../../../docs/configuring-playbook-email2matrix.md:94 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:95 +#: ../../../docs/configuring-playbook-email2matrix.md:96 msgid "" "The shortcut commands with the [`just` program](just.md) are also " -"available: `just run-tags setup-email2matrix,start` or `just setup-all`" +"available: `just install-service email2matrix` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:97 +#: ../../../docs/configuring-playbook-email2matrix.md:98 msgid "" -"`just run-tags setup-email2matrix,start` is useful for maintaining your " -"setup quickly when its components remain unchanged. If you adjust your " +"`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:99 +#: ../../../docs/configuring-playbook-email2matrix.md:100 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 "" +#~ msgid "" +#~ "To enable Email2Matrix, run the playbook" +#~ " with [playbook tags](playbook-tags.md) as" +#~ " below:" +#~ msgstr "" + +#~ msgid "" +#~ "The shortcut commands with the [`just`" +#~ " program](just.md) are also available: " +#~ "`just run-tags setup-email2matrix,start` " +#~ "or `just setup-all`" +#~ msgstr "" + +#~ msgid "" +#~ "`just run-tags setup-email2matrix,start` " +#~ "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 "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po index ebb1713a3..201c1802b 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -36,8 +36,9 @@ msgstr "" #: ../../../docs/configuring-playbook-ldap-auth.md:5 msgid "" -"See that project's documentation to learn what it does and why it might " -"be useful to you." +"See the project's [documentation](https://github.com/matrix-org/matrix-" +"synapse-ldap3/blob/main/README.rst) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-ldap-auth.md:7 @@ -82,3 +83,9 @@ msgid "" "](configuring-playbook-matrix-ldap-registration-proxy.md)." msgstr "" +#~ msgid "" +#~ "See that project's documentation to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ma1sd.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ma1sd.po index 96aae51be..50a616c77 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ma1sd.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ma1sd.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -53,8 +53,9 @@ msgstr "" #: ../../../docs/configuring-playbook-ma1sd.md:9 msgid "" -"See the project's [documentation](https://github.com/ma1uta/ma1sd) to " -"learn what it does and why it might be useful to you." +"See the project's " +"[documentation](https://github.com/ma1uta/ma1sd/blob/master/README.md) to" +" learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-ma1sd.md:11 @@ -333,3 +334,10 @@ msgid "" "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/ma1uta/ma1sd) to learn" +#~ " what it does and why it might" +#~ " be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po index 81721ce7b..76289ff29 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -43,101 +43,107 @@ msgstr "" msgid "" "In short, it's a sort of automation and firewalling service, which is " "helpful if you're instaling Matrix services in a controlled corporate " -"environment. See that project's documentation to learn what it does and " -"why it might be useful to you." +"environment." msgstr "" #: ../../../docs/configuring-playbook-matrix-corporal.md:13 msgid "" +"See the project's [documentation](https://github.com/devture/matrix-" +"corporal/blob/main/README.md) to learn what it does and why it might be " +"useful to you." +msgstr "" + +#: ../../../docs/configuring-playbook-matrix-corporal.md:15 +msgid "" "If you decide that you'd like to let this playbook install it for you, " "you'd need to also:" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:14 +#: ../../../docs/configuring-playbook-matrix-corporal.md:16 msgid "" "(required) [set up the Shared Secret Auth password provider module" "](configuring-playbook-shared-secret-auth.md)" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:15 +#: ../../../docs/configuring-playbook-matrix-corporal.md:17 msgid "" "(optional, but encouraged) [set up the REST authentication password " "provider module](configuring-playbook-rest-auth.md)" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:17 +#: ../../../docs/configuring-playbook-matrix-corporal.md:19 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:19 +#: ../../../docs/configuring-playbook-matrix-corporal.md:21 msgid "" "Add the following configuration to your " "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your " "needs):" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:72 +#: ../../../docs/configuring-playbook-matrix-corporal.md:74 msgid "" "Matrix Corporal operates with a specific Matrix user on your server. By " "default, it's `matrix-corporal` (controllable by the " "`matrix_corporal_reconciliation_user_id_local_part` setting, see above)." msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:74 +#: ../../../docs/configuring-playbook-matrix-corporal.md:76 msgid "" "No matter what Matrix user ID you configure to run it with, make sure " "that:" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:76 +#: ../../../docs/configuring-playbook-matrix-corporal.md:78 msgid "" "the Matrix Corporal user is created by [registering it](registering-" "users.md) **with administrator privileges**. Use a password you remember," " as you'll need to log in from time to time to create or join rooms" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:78 +#: ../../../docs/configuring-playbook-matrix-corporal.md:80 msgid "" "the Matrix Corporal user is joined and has Admin/Moderator-level access " "to any rooms you want it to manage" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:80 +#: ../../../docs/configuring-playbook-matrix-corporal.md:82 msgid "Using a locally-stored static policy" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:82 +#: ../../../docs/configuring-playbook-matrix-corporal.md:84 msgid "" "If you'd like to use a [static policy file](https://github.com/devture" "/matrix-corporal/blob/master/docs/policy-providers.md#static-file-pull-" "style-policy-provider), you can use a configuration like this:" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:114 +#: ../../../docs/configuring-playbook-matrix-corporal.md:116 msgid "" "To learn more about what the policy configuration, see the matrix-" "corporal documentation on [policy](https://github.com/devture/matrix-" "corporal/blob/master/docs/policy.md)." msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:116 +#: ../../../docs/configuring-playbook-matrix-corporal.md:118 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:118 +#: ../../../docs/configuring-playbook-matrix-corporal.md:120 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:125 +#: ../../../docs/configuring-playbook-matrix-corporal.md:127 msgid "" "The shortcut commands with the [`just` program](just.md) are also " "available: `just run-tags setup-aux-files,setup-corporal,start` or `just " "setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:127 +#: ../../../docs/configuring-playbook-matrix-corporal.md:129 msgid "" "`just run-tags setup-aux-files,setup-corporal,start` is useful for " "maintaining your setup quickly when its components remain unchanged. If " @@ -146,33 +152,33 @@ msgid "" "`just setup-all` runs the `ensure-matrix-users-created` tag too." msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:129 +#: ../../../docs/configuring-playbook-matrix-corporal.md:131 msgid "Matrix Corporal files" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:131 +#: ../../../docs/configuring-playbook-matrix-corporal.md:133 msgid "" "The following local filesystem paths are mounted in the `matrix-corporal`" " container and can be used in your configuration (or policy):" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:133 +#: ../../../docs/configuring-playbook-matrix-corporal.md:135 msgid "`/matrix/corporal/config` is mounted at `/etc/matrix-corporal` (read-only)" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:135 +#: ../../../docs/configuring-playbook-matrix-corporal.md:137 msgid "" "`/matrix/corporal/var` is mounted at `/var/matrix-corporal` (read and " "write)" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:137 +#: ../../../docs/configuring-playbook-matrix-corporal.md:139 msgid "" "`/matrix/corporal/cache` is mounted at `/var/cache/matrix-corporal` (read" " and write)" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:139 +#: ../../../docs/configuring-playbook-matrix-corporal.md:141 msgid "" "As an example: you can create your own configuration files in " "`/matrix/corporal/config` and they will appear in `/etc/matrix-corporal` " @@ -183,3 +189,13 @@ msgid "" "and write)." msgstr "" +#~ msgid "" +#~ "In short, it's a sort of " +#~ "automation and firewalling service, which " +#~ "is helpful if you're instaling Matrix" +#~ " services in a controlled corporate " +#~ "environment. See that project's documentation" +#~ " to learn what it does and why" +#~ " it might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po index 770043c21..d5a6e3ef0 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -35,7 +35,8 @@ msgstr "" #: ../../../docs/configuring-playbook-pantalaimon.md:5 msgid "" "See the project's [documentation](https://github.com/matrix-" -"org/pantalaimon) to learn what it does and why it might be useful to you." +"org/pantalaimon/blob/master/README.md) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-pantalaimon.md:7 @@ -91,3 +92,10 @@ msgid "" "these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/matrix-org/pantalaimon) to learn what it" +#~ " does and why it might be " +#~ "useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-rest-auth.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-rest-auth.po index 64f262b10..50a5e7e41 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-rest-auth.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-rest-auth.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -32,8 +32,9 @@ msgstr "" #: ../../../docs/configuring-playbook-rest-auth.md:5 msgid "" -"See that project's documentation to learn what it does and why it might " -"be useful to you." +"See the project's [documentation](https://github.com/ma1uta/matrix-" +"synapse-rest-password-provider/blob/master/README.md) to learn what it " +"does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-rest-auth.md:7 @@ -84,3 +85,9 @@ msgid "" "these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" +#~ msgid "" +#~ "See that project's documentation to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po index 06e5c3081..3cdbd4254 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -36,8 +36,9 @@ msgstr "" #: ../../../docs/configuring-playbook-shared-secret-auth.md:5 msgid "" -"See that project's documentation to learn what it does and why it might " -"be useful to you." +"See the project's [documentation](https://github.com/devture/matrix-" +"synapse-shared-secret-auth/blob/master/README.md) to learn what it does " +"and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-shared-secret-auth.md:7 @@ -87,3 +88,9 @@ msgid "" "these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" +#~ msgid "" +#~ "See that project's documentation to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-sygnal.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-sygnal.po index 6ab90bf55..2954af972 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-sygnal.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-sygnal.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -33,8 +33,9 @@ msgstr "" #: ../../../docs/configuring-playbook-sygnal.md:5 msgid "" -"See the project's [documentation](https://github.com/matrix-org/sygnal) " -"to learn what it does and why it might be useful to you." +"See the project's [documentation](https://github.com/matrix-" +"org/sygnal/blob/master/README.md) to learn what it does and why it might " +"be useful to you." msgstr "" #: ../../../docs/configuring-playbook-sygnal.md:7 @@ -200,3 +201,10 @@ msgid "" "/matrix-org/sygnal/blob/master/docs/applications.md) document." msgstr "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/matrix-org/sygnal) to learn what it " +#~ "does and why it might be useful" +#~ " to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po index b7dce7685..257927ce2 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -34,15 +34,20 @@ msgstr "" #: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:5 msgid "" -"See that project's [documentation](https://github.com/matrix-org/synapse-" -"auto-accept-invite) to learn what it does and why it might be useful to " -"you. In short, it automatically accepts room invites. You can specify " -"that only 1:1 room invites are auto-accepted. Defaults to false if not " +"In short, it automatically accepts room invites. You can specify that " +"only 1:1 room invites are auto-accepted. Defaults to false if not " "specified." msgstr "" #: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:7 msgid "" +"See the project's [documentation](https://github.com/matrix-org/synapse-" +"auto-accept-invite/blob/main/README.md) to learn what it does and why it " +"might be useful to you." +msgstr "" + +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:9 +msgid "" "**Note**: Synapse [v1.109.0](https://github.com/element-" "hq/synapse/releases/tag/v1.109.0), the same feature [has been " "merged](https://github.com/element-hq/synapse/pull/17147) into Synapse " @@ -52,11 +57,11 @@ msgid "" "party module." msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:9 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:11 msgid "Configuration" msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:11 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:13 msgid "" "If you decide that you'd like to let this playbook install the [synapse-" "auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-" @@ -64,11 +69,11 @@ msgid "" "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:19 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:21 msgid "Synapse worker deployments" msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:21 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:23 msgid "" "In a [workerized Synapse deployment](https://github.com/spantaleev" "/matrix-docker-ansible-" @@ -78,17 +83,17 @@ msgid "" "is `null`). For example, add this to your configuration:" msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:27 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:29 msgid "" "There might be an [issue with federation](https://github.com/matrix-org" "/synapse-auto-accept-invite/issues/18)." msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:29 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:31 msgid "Native alternative" msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:31 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:33 msgid "" "Since Synapse [v1.109.0](https://github.com/element-" "hq/synapse/releases/tag/v1.109.0), the functionality provided by the " @@ -97,7 +102,19 @@ msgid "" "/element-hq/synapse/pull/17147) part of Synapse." msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:33 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:35 msgid "Here's example configuration for using the **native** Synapse feature:" msgstr "" +#~ msgid "" +#~ "See that project's " +#~ "[documentation](https://github.com/matrix-org/synapse-" +#~ "auto-accept-invite) to learn what it" +#~ " does and why it might be " +#~ "useful to you. In short, it " +#~ "automatically accepts room invites. You " +#~ "can specify that only 1:1 room " +#~ "invites are auto-accepted. Defaults to" +#~ " false if not specified." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po index 9d7430ffd..46ecd6c5a 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -41,8 +41,9 @@ msgstr "" #: ../../../docs/configuring-playbook-synapse-auto-compressor.md:7 msgid "" "See the project's [documentation](https://github.com/matrix-org/rust-" -"synapse-compress-state/#automated-tool-synapse_auto_compressor) to learn " -"what it does and why it might be useful to you." +"synapse-compress-state/blob/master/README.md#automated-tool-" +"synapse_auto_compressor) to learn what it does and why it might be useful" +" to you." msgstr "" #: ../../../docs/configuring-playbook-synapse-auto-compressor.md:9 @@ -107,3 +108,11 @@ msgid "" "unstable." msgstr "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/matrix-org/rust-synapse-compress-state" +#~ "/#automated-tool-synapse_auto_compressor) to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po index 823f71180..b28d1a365 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -33,20 +33,35 @@ msgstr "" #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:5 msgid "" -"See that project's documentation to learn what it does and why it might " -"be useful to you. In short, it lets you fight invite-spam by " -"automatically blocking invitiations from a list of servers specified by " -"you (blacklisting)." +"It lets you fight invite-spam by automatically blocking invitiations from" +" a list of servers specified by you (blacklisting)." msgstr "" #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:7 -msgid "Adjusting the playbook configuration" +msgid "" +"See the project's [documentation](https://github.com/t2bot/synapse-" +"simple-antispam/blob/master/README.md) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:9 +msgid "Adjusting the playbook configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-synapse-simple-antispam.md:11 msgid "" "Add the following configuration to your " "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your " "needs):" msgstr "" +#~ msgid "" +#~ "See that project's documentation to " +#~ "learn what it does and why it " +#~ "might be useful to you. In short," +#~ " it lets you fight invite-spam " +#~ "by automatically blocking invitiations from" +#~ " a list of servers specified by " +#~ "you (blacklisting)." +#~ msgstr "" + diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po index 20c5ed834..7b5148329 100644 --- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po +++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: bg\n" @@ -238,71 +238,71 @@ msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:90 msgid "" -"After these variables have been set, run the playbook with [playbook tags" -"](playbook-tags.md) as below to restart UVS:" +"After configuring the playbook, run it with [playbook tags](playbook-" +"tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:96 +#: ../../../docs/configuring-playbook-user-verification-service.md:97 msgid "" "The shortcut commands with the [`just` program](just.md) are also " -"available: `just run-tags setup-matrix-user-verification-service,start` " -"or `just setup-all`" +"available: `just install-service matrix-user-verification-service` or " +"`just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:98 +#: ../../../docs/configuring-playbook-user-verification-service.md:99 msgid "" -"`just run-tags setup-matrix-user-verification-service,start` 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." +"`just install-service matrix-user-verification-service` 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-user-verification-service.md:100 +#: ../../../docs/configuring-playbook-user-verification-service.md:101 msgid "Logging" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:102 +#: ../../../docs/configuring-playbook-user-verification-service.md:103 msgid "The configuration variable `UVS_LOG_LEVEL` can be set to:" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:103 +#: ../../../docs/configuring-playbook-user-verification-service.md:104 msgid "warning" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:104 +#: ../../../docs/configuring-playbook-user-verification-service.md:105 msgid "info" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:105 +#: ../../../docs/configuring-playbook-user-verification-service.md:106 msgid "debug" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:107 +#: ../../../docs/configuring-playbook-user-verification-service.md:108 msgid "TLS Certificate Checking" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:109 +#: ../../../docs/configuring-playbook-user-verification-service.md:110 msgid "" "If the Matrix Homeserver does not provide a valid TLS certificate, UVS " "will fail with the following error message:" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:111 +#: ../../../docs/configuring-playbook-user-verification-service.md:112 msgid "message: 'No response received: [object Object]'," msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:113 +#: ../../../docs/configuring-playbook-user-verification-service.md:114 msgid "This also applies to self-signed and let's encrypt staging certificates." msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:115 +#: ../../../docs/configuring-playbook-user-verification-service.md:116 msgid "" "To disable certificate validation altogether (INSECURE! Not suitable for " "production use!) set: `NODE_TLS_REJECT_UNAUTHORIZED=0`" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:117 +#: ../../../docs/configuring-playbook-user-verification-service.md:118 msgid "" "Alternatively, it is possible to inject your own CA certificates into the" " container by mounting a PEM file with additional trusted CAs into the " @@ -310,3 +310,31 @@ msgid "" "it." msgstr "" +#~ msgid "" +#~ "After these variables have been set, " +#~ "run the playbook with [playbook tags" +#~ "](playbook-tags.md) as below to restart " +#~ "UVS:" +#~ msgstr "" + +#~ msgid "" +#~ "The shortcut commands with the [`just`" +#~ " program](just.md) are also available: " +#~ "`just run-tags setup-matrix-user-" +#~ "verification-service,start` or `just setup-" +#~ "all`" +#~ msgstr "" + +#~ msgid "" +#~ "`just run-tags setup-matrix-user-" +#~ "verification-service,start` 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 "" + diff --git a/i18n/locales/jp/LC_MESSAGES/README.po b/i18n/locales/jp/LC_MESSAGES/README.po index b40cd4e22..41e9558db 100644 --- a/i18n/locales/jp/LC_MESSAGES/README.po +++ b/i18n/locales/jp/LC_MESSAGES/README.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -53,7 +53,10 @@ msgid "" "This [Ansible](https://www.ansible.com/) playbook is meant to help you " "run your own [Matrix](http://matrix.org/) homeserver, along with the " "[various services](#supported-services) related to that." -msgstr "この [Ansible](https://www.ansible.com/) Playbook は、独自の [Matrix](http://matrix.org/) ホームサーバーと、それに関連する [さまざまなサービス](#supported-services) を実行するのに役立つことを目的としています。" +msgstr "" +"この [Ansible](https://www.ansible.com/) Playbook は、独自の " +"[Matrix](http://matrix.org/) ホームサーバーと、それに関連する [さまざまなサービス](#supported-" +"services) を実行するのに役立つことを目的としています。" #: ../../../README.md:9 msgid "" @@ -1349,11 +1352,25 @@ msgid "" "deploy/issues)" msgstr "" -#: ../../../README.md:215 +#: ../../../README.md:201 +msgid "🌐 Translation" +msgstr "" + +#: ../../../README.md:203 +msgid "" +"See the [i18n/README.md](i18n/README.md) file for more information about " +"translation." +msgstr "" + +#: ../../../README.md:205 +msgid "Translations are still work in progress." +msgstr "" + +#: ../../../README.md:207 msgid "🤝 Related" msgstr "" -#: ../../../README.md:217 +#: ../../../README.md:209 msgid "" "You may also be interested in [mash-playbook](https://github.com/mother-" "of-all-self-hosting/mash-playbook) - another Ansible playbook for self-" @@ -1362,7 +1379,7 @@ msgid "" "playbook/blob/main/docs/supported-services.md))." msgstr "" -#: ../../../README.md:219 +#: ../../../README.md:211 msgid "" "mash-playbook also makes use of [Traefik](./docs/configuring-playbook-" "traefik.md) as its reverse-proxy, so with minor [interoperability " @@ -1371,3 +1388,4 @@ msgid "" "ansible-deploy and mash-playbook co-exist and host Matrix and non-Matrix " "services on the same server." msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po index eb7387679..ef770ef02 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -40,19 +40,12 @@ msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:5 msgid "" "See the project's [documentation](https://github.com/metio/matrix-" -"alertmanager-receiver) to learn more about what this component does and " -"why it might be useful to you." +"alertmanager-receiver/blob/main/README.md) to learn what it does and why " +"it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:7 msgid "" -"At the moment, **setting up this service's bot requires some manual " -"actions** as described below in [Account and room preparation](#account-" -"and-room-preparation)." -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:9 -msgid "" "This service is meant to be used with an external " "[Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/) " "instance. It's **not** meant to be integrated with the [Prometheus & " @@ -61,27 +54,93 @@ msgid "" "it." msgstr "" +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:9 +msgid "Prerequisites" +msgstr "" + #: ../../../docs/configuring-playbook-alertmanager-receiver.md:11 -msgid "Adjusting the playbook configuration" +msgid "Register the bot account" msgstr "" #: ../../../docs/configuring-playbook-alertmanager-receiver.md:13 msgid "" -"To enable matrix-alertmanager-receiver, add the following configuration " -"to your `inventory/host_vars/matrix.example.com/vars.yml` file:" +"This service uses a bot (with a username specified in " +"`matrix_alertmanager_receiver_config_matrix_user_id_localpart`) for " +"delivering messages." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:36 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:15 +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-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`." +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:19 +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" +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:27 +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-alertmanager-receiver.md:29 +msgid "Join to rooms as the bot manually" +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." +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." +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." +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:37 +msgid "Adjusting the playbook configuration" +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)." +msgstr "" + +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:61 msgid "" "See `roles/custom/matrix-alertmanager-receiver/defaults/main.yml` for " "additional configuration variables." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:38 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:63 msgid "Adjusting the matrix-alertmanager-receiver URL" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:40 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:65 msgid "" "By default, this playbook installs matrix-alertmanager-receiver on the " "`matrix.` subdomain, at the `/matrix-alertmanager-receiver` path " @@ -90,7 +149,7 @@ msgid "" "to be set up**. If that's okay, you can skip this section." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:42 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67 msgid "" "By tweaking the `matrix_alertmanager_receiver_hostname` and " "`matrix_alertmanager_receiver_path_prefix` variables, you can easily make" @@ -98,125 +157,61 @@ msgid "" "default one." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:44 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69 msgid "" "Example additional configuration for your " "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:52 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:77 msgid "Adjusting DNS records" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:54 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:79 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:56 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:81 msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:58 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:83 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:60 -msgid "Account and room preparation" -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:62 -msgid "" -"The playbook can automatically create users, but it cannot automatically " -"obtain access tokens, nor perform any of the other manual actions below." -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:64 -msgid "" -"`matrix-alertmanager-receiver` uses a bot (with a username specified in " -"`matrix_alertmanager_receiver_config_matrix_user_id_localpart` - see " -"above) for delivering messages. You need to **manually register this bot " -"acccount and obtain an access token for it**." -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:66 -msgid "" -"[Register a new user](registering-users.md): `ansible-playbook -i " -"inventory/hosts setup.yml --extra-" -"vars='username=bot.alertmanager.receiver password=PASSWORD_FOR_THE_BOT " -"admin=no' --tags=register-user`" -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67 -msgid "" -"[Obtain an access token](obtaining-access-tokens.md) for the bot's user " -"account" -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:68 -msgid "Invite the bot to a room where you'd like to alerts to be delivered" -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69 -msgid "" -"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:70 -msgid "" -"(Optionally) Adjust " -"`matrix_alertmanager_receiver_config_matrix_room_mapping` to create a " -"mapping between the new room and its ID" -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:72 -msgid "" -"Steps 1 and 2 above only need to be done once, while preparing your " -"[configuration](#adjusting-the-playbook-configuration)." -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:74 -msgid "" -"Steps 3 and 4 need to be done for each new room you'd like the bot to " -"deliver alerts to. Step 5 is optional and provides cleaner `/alert/` " -"URLs." -msgstr "" - -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:76 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:85 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:78 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87 msgid "" -"Now that you've [prepared the bot account and room](#account-and-room-" -"preparation), [configured the playbook](#adjusting-the-playbook-" -"configuration), and potentially [adjusted your DNS records](#adjusting-" -"dns-records), you can run the playbook with [playbook tags](playbook-" -"tags.md) as below:" +"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:85 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:94 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:96 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:89 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:98 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:91 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:100 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" @@ -225,27 +220,136 @@ msgid "" "`just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:93 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:102 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:95 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:104 msgid "Configure your Prometheus Alertmanager with configuration like this:" msgstr "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:114 +#: ../../../docs/configuring-playbook-alertmanager-receiver.md:123 msgid "" -".. where `URL_HERE` looks like `https://matrix.example.com/matrix-" +"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 "" -#: ../../../docs/configuring-playbook-alertmanager-receiver.md:116 -msgid "" -"This bot does **not** accept room invitations automatically (like many " -"other bots do). To deliver messages to rooms, **the bot must be joined to" -" all rooms manually** - see Step 4 of the [Account and room preparation" -"](#account-and-room-preparation) section." -msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/metio/matrix-alertmanager-" +#~ "receiver) to learn more about what " +#~ "this component does and why it " +#~ "might be useful to you." +#~ msgstr "" + +#~ msgid "" +#~ "At the moment, **setting up this " +#~ "service's bot requires some manual " +#~ "actions** as described below in [Account" +#~ " and room preparation](#account-and-" +#~ "room-preparation)." +#~ msgstr "" + +#~ msgid "" +#~ "To enable matrix-alertmanager-receiver, " +#~ "add the following configuration to your" +#~ " `inventory/host_vars/matrix.example.com/vars.yml` file:" +#~ msgstr "" + +#~ msgid "Account and room preparation" +#~ msgstr "" + +#~ msgid "" +#~ "The playbook can automatically create " +#~ "users, but it cannot automatically " +#~ "obtain access tokens, nor perform any" +#~ " of the other manual actions below." +#~ msgstr "" + +#~ msgid "" +#~ "`matrix-alertmanager-receiver` uses a " +#~ "bot (with a username specified in " +#~ "`matrix_alertmanager_receiver_config_matrix_user_id_localpart` -" +#~ " see above) for delivering messages. " +#~ "You need to **manually register this " +#~ "bot acccount and obtain an access " +#~ "token for it**." +#~ msgstr "" + +#~ msgid "" +#~ "[Register a new user](registering-users.md):" +#~ " `ansible-playbook -i inventory/hosts " +#~ "setup.yml --extra-vars='username=bot.alertmanager.receiver" +#~ " password=PASSWORD_FOR_THE_BOT admin=no' --tags" +#~ "=register-user`" +#~ msgstr "" + +#~ msgid "" +#~ "[Obtain an access token](obtaining-access-" +#~ "tokens.md) for the bot's user account" +#~ msgstr "" + +#~ msgid "Invite the bot to a room where you'd like to alerts to be delivered" +#~ msgstr "" + +#~ msgid "" +#~ "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 "" + +#~ msgid "" +#~ "(Optionally) Adjust " +#~ "`matrix_alertmanager_receiver_config_matrix_room_mapping` to " +#~ "create a mapping between the new " +#~ "room and its ID" +#~ msgstr "" + +#~ msgid "" +#~ "Steps 1 and 2 above only need " +#~ "to be done once, while preparing " +#~ "your [configuration](#adjusting-the-playbook-" +#~ "configuration)." +#~ msgstr "" + +#~ msgid "" +#~ "Steps 3 and 4 need to be " +#~ "done for each new room you'd like" +#~ " the bot to deliver alerts to. " +#~ "Step 5 is optional and provides " +#~ "cleaner `/alert/` URLs." +#~ msgstr "" + +#~ msgid "" +#~ "Now that you've [prepared the bot " +#~ "account and room](#account-and-room-" +#~ "preparation), [configured the playbook" +#~ "](#adjusting-the-playbook-configuration), and " +#~ "potentially [adjusted your DNS records" +#~ "](#adjusting-dns-records), you can run " +#~ "the playbook with [playbook tags](playbook-" +#~ "tags.md) as below:" +#~ msgstr "" + +#~ 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 "" + +#~ msgid "" +#~ "This bot does **not** accept room " +#~ "invitations automatically (like many other " +#~ "bots do). To deliver messages to " +#~ "rooms, **the bot must be joined to" +#~ " all rooms manually** - see Step " +#~ "4 of the [Account and room " +#~ "preparation](#account-and-room-preparation) " +#~ "section." +#~ msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po index 88f283561..fc4f586b9 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -83,27 +83,31 @@ msgid "" msgstr "" #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:19 -msgid "Installation" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:21 -msgid "Create a main management room." +msgid "Create a main management room" msgstr "" #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:23 msgid "" "The playbook does not create a management room for your Main Draupnir. " -"This task you have to do on your own." +"You **need to create the room manually** before setting up the bot." msgstr "" #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:25 +msgid "Note that the room must be unencrypted." +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29 msgid "" "The management room has to be given an alias and be public when you are " "setting up the bot for the first time as the bot does not differentiate " "between invites and invites to the management room." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:27 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:31 msgid "" "This management room is used to control who has access to your D4A " "deployment. The room stores this data inside of the control room state so" @@ -111,77 +115,107 @@ msgid "" "This is default 50 or moderator as Element clients call this powerlevel." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:33 msgid "" "As noted in the Draupnir install instructions the control room is " -"sensitive. The following is said about the control room in the Draupnir " -"install instructions." +"sensitive. **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-appservice-draupnir-for-all.md:30 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:35 +msgid "Set an alias to the management room" +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:37 +msgid "Next, set an alias to the management room." +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:39 msgid "" -"Anyone in this room can control the bot so it is important that you only " -"invite trusted users to this room. The room must be unencrypted since the" -" playbook does not support installing Pantalaimon yet." +"This alias can be anything you want. However, for increased security " +"during the setup phase, it is recommended to make this alias be a random " +"string. When it has been locked down after setup phase, you can give your" +" room a secondary human readable alias." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:32 -msgid "Give your main management room an alias." +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:41 +msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:34 -msgid "" -"Give the room from step 1 an alias. This alias can be anything you want " -"and its recommended for increased security during the setup phase of the " -"bot that you make this alias be a random string. You can give your room a" -" secondary human readable alias when it has been locked down after setup " -"phase." -msgstr "" - -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:36 -msgid "Adjusting the playbook configuration." -msgstr "" - -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:38 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:43 msgid "" "Add the following configuration to your " -"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your " -"needs):" +"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to " +"replace `MANAGEMENT_ROOM_ALIAS_HERE`." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:40 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:51 +msgid "Extending the configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:53 msgid "" -"You must replace `ALIAS_FROM_STEP_2_GOES_HERE` with the alias you created" -" in step 2." +"You can configure additional options by adding the " +"`matrix_appservice_draupnir_for_all_extension_yaml` variable." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:48 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:55 +msgid "" +"For example, to change Draupnir's `protectAllJoinedRooms` option to " +"`true`, add the following configuration to your " +"`inventory/host_vars/matrix.example.com/vars.yml` file:" +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69 +msgid "" +"You can refer to the upstream [documentation](https://github.com/the-" +"draupnir-project/Draupnir) for more configuration documentation." +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:86 +msgid "**Notes**:" +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73 +msgid "" +"The playbook ships a full copy of the example config that does transfer " +"to provisioned Draupnirs in the production-bots.yaml.j2 file in the " +"template directory of the role." +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75 +msgid "" +"Config extension does not affect the appservices config as this config is" +" not extensible in current Draupnir anyway. It instead touches the config" +" passed to the Draupnirs that your Appservice creates. So the example " +"above (`protectAllJoinedRooms: true`) makes all provisioned Draupnirs " +"protect all joined rooms." +msgstr "" + +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:50 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:57 -msgid "**Notes**:" -msgstr "" - -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:59 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:88 msgid "" "The `ensure-matrix-users-created` playbook tag makes the playbook " "automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:61 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:90 msgid "" "The shortcut commands with the [`just` program](just.md) are also " "available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:63 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:92 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" @@ -190,29 +224,29 @@ msgid "" "`just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:65 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:94 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:67 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:96 msgid "" "If you made it through all the steps above and your main control room was" " joined by a user called `@draupnir-main:example.com` you have " "succesfully installed Draupnir for All and can now start using it." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:98 msgid "" "The installation of Draupnir for all in this playbook is very much Alpha " -"quality. Usage-wise, Draupnir for allis almost identical to Draupnir bot " -"mode." +"quality. Usage-wise, Draupnir for all is almost identical to Draupnir bot" +" mode." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:100 msgid "Granting Users the ability to use D4A" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:102 msgid "" "Draupnir for all includes several security measures like that it only " "allows users that are on its allow list to ask for a bot. To add a user " @@ -223,7 +257,7 @@ msgid "" " the chat is recomended." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:104 msgid "" "The bot requires a powerlevel of 50 in the management room to control who" " is allowed to use the bot. The bot does currently not say anything if " @@ -232,7 +266,7 @@ msgid "" "project/Draupnir/issues/297))" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:106 msgid "" "To allow users or whole homeservers you type /plain @draupnir-" "main:example.com allow `target` and target can be either a MXID or a " @@ -241,57 +275,146 @@ msgid "" "this command as it can break Wildcard commands especially." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79 -msgid "How to provision a D4A once you are allowed to." +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:108 +msgid "How to provision a D4A once you are allowed to" msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:81 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:110 msgid "" -"Open a DM with @draupnir-main:example.com and if using an Element client " -"send a message into this DM to finalise creating it. The bot will reject " -"this invite and you will shortly get invited to the Draupnir control room" -" for your newly provisioned Draupnir. From here its just a normal " -"Draupnir experience." +"To provision a D4A, you need to start a chat with `@draupnir-" +"main:example.com`. The bot will reject this invite and you will shortly " +"get invited to the Draupnir control room for your newly provisioned " +"Draupnir. From here its just a normal Draupnir experience." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:83 +#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:112 msgid "" "Congratulations if you made it all the way here because you now have a " "fully working Draupnir for all deployment." msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:85 -msgid "Configuration of D4A" -msgstr "" +#~ msgid "Installation" +#~ msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:87 -msgid "" -"You can refer to the upstream [documentation](https://github.com/the-" -"draupnir-project/Draupnir) for more configuration documentation. Please " -"note that the playbook ships a full copy of the example config that does " -"transfer to provisioned Draupnirs in the production-bots.yaml.j2 file in " -"the template directory of the role." -msgstr "" +#~ msgid "Create a main management room." +#~ msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:89 -msgid "" -"Please note that Config extension does not affect the appservices config " -"as this config is not extensible in current Draupnir anyways. Config " -"extension instead touches the config passed to the Draupnirs that your " -"Appservice creates. So for example below makes all provisioned Draupnirs " -"protect all joined rooms." -msgstr "" +#~ msgid "" +#~ "The playbook does not create a " +#~ "management room for your Main Draupnir." +#~ " This task you have to do on" +#~ " your own." +#~ msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:91 -msgid "" -"You can configure additional options by adding the " -"`matrix_appservice_draupnir_for_all_extension_yaml` variable to your " -"`inventory/host_vars/matrix.example.com/vars.yml` file." -msgstr "" +#~ msgid "" +#~ "As noted in the Draupnir install " +#~ "instructions the control room is " +#~ "sensitive. The following is said about" +#~ " the control room in the Draupnir " +#~ "install instructions." +#~ msgstr "" -#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:93 -msgid "" -"For example to change Draupnir's `protectAllJoinedRooms` option to `true`" -" you would add the following to your `vars.yml` file." -msgstr "" +#~ msgid "" +#~ "Anyone in this room can control " +#~ "the bot so it is important that" +#~ " you only invite trusted users to " +#~ "this room. The room must be " +#~ "unencrypted since the playbook does not" +#~ " support installing Pantalaimon yet." +#~ msgstr "" + +#~ msgid "Give your main management room an alias." +#~ msgstr "" + +#~ msgid "" +#~ "Give the room from step 1 an " +#~ "alias. This alias can be anything " +#~ "you want and its recommended for " +#~ "increased security during the setup " +#~ "phase of the bot that you make " +#~ "this alias be a random string. You" +#~ " can give your room a secondary " +#~ "human readable alias when it has " +#~ "been locked down after setup phase." +#~ msgstr "" + +#~ msgid "Adjusting the playbook configuration." +#~ msgstr "" + +#~ msgid "" +#~ "Add the following configuration to your" +#~ " `inventory/host_vars/matrix.example.com/vars.yml` file " +#~ "(adapt to your needs):" +#~ msgstr "" + +#~ msgid "" +#~ "You must replace `ALIAS_FROM_STEP_2_GOES_HERE` " +#~ "with the alias you created in step" +#~ " 2." +#~ msgstr "" + +#~ msgid "" +#~ "The installation of Draupnir for all " +#~ "in this playbook is very much " +#~ "Alpha quality. Usage-wise, Draupnir for" +#~ " allis almost identical to Draupnir " +#~ "bot mode." +#~ msgstr "" + +#~ msgid "How to provision a D4A once you are allowed to." +#~ msgstr "" + +#~ msgid "" +#~ "Open a DM with @draupnir-" +#~ "main:example.com and if using an Element" +#~ " client send a message into this " +#~ "DM to finalise creating it. The " +#~ "bot will reject this invite and " +#~ "you will shortly get invited to " +#~ "the Draupnir control room for your " +#~ "newly provisioned Draupnir. From here " +#~ "its just a normal Draupnir experience." +#~ msgstr "" + +#~ msgid "Configuration of D4A" +#~ msgstr "" + +#~ msgid "" +#~ "You can refer to the upstream " +#~ "[documentation](https://github.com/the-draupnir-" +#~ "project/Draupnir) for more configuration " +#~ "documentation. Please note that the " +#~ "playbook ships a full copy of the" +#~ " example config that does transfer to" +#~ " provisioned Draupnirs in the " +#~ "production-bots.yaml.j2 file in the " +#~ "template directory of the role." +#~ msgstr "" + +#~ msgid "" +#~ "Please note that Config extension does" +#~ " not affect the appservices config as" +#~ " this config is not extensible in " +#~ "current Draupnir anyways. Config extension " +#~ "instead touches the config passed to " +#~ "the Draupnirs that your Appservice " +#~ "creates. So for example below makes " +#~ "all provisioned Draupnirs protect all " +#~ "joined rooms." +#~ msgstr "" + +#~ msgid "" +#~ "You can configure additional options by" +#~ " adding the " +#~ "`matrix_appservice_draupnir_for_all_extension_yaml` variable " +#~ "to your `inventory/host_vars/matrix.example.com/vars.yml`" +#~ " file." +#~ msgstr "" + +#~ msgid "" +#~ "For example to change Draupnir's " +#~ "`protectAllJoinedRooms` option to `true` you" +#~ " would add the following to your " +#~ "`vars.yml` file." +#~ msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po index b1c589d9f..0e3677f70 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -33,8 +33,8 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:5 msgid "" "See the project's [documentation](https://github.com/the-draupnir-" -"project/Draupnir) to learn what it does and why it might be useful to " -"you." +"project/Draupnir/blob/main/README.md) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:7 @@ -46,21 +46,23 @@ msgid "" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:9 -msgid "If your migrating from Mjolnir skip to step 5b." +msgid "" +"If your migrating from Mjolnir skip to [this section](#migrating-from-" +"mjolnir-only-required-if-migrating)." msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:11 -msgid "Register the bot account" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:13 -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 "Register the bot account" msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.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-draupnir.md:17 @@ -76,7 +78,7 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:25 msgid "" "If you would like Draupnir to be able to deactivate users, move aliases, " -"shutdown rooms, show abuse reports ([see below](#abuse-reports)), etc " +"shutdown rooms, show abuse reports (see [below](#abuse-reports)), etc " "then it must be a server admin so you need to change `admin=no` to " "`admin=yes` in the command above." msgstr "" @@ -87,8 +89,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:29 msgid "" -"Refer to the documentation on [how to obtain an access token](obtaining-" -"access-tokens.md)." +"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-draupnir.md:31 @@ -97,43 +100,65 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-draupnir.md:33 msgid "" -"You will need to prevent Synapse from rate limiting the bot's account. " -"This is not an optional step. If you do not do this step Draupnir will " -"crash. This can be done using Synapse's [admin API](https://matrix-" -"org.github.io/synapse/latest/admin_api/user_admin_api.html#override-" -"ratelimiting-for-users). Please ask for help if you are uncomfortable " -"with these steps or run into issues." +"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:35 msgid "" -"If your Synapse Admin API is exposed to the internet for some reason like" -" running the Synapse Admin Role [Link](configuring-playbook-synapse-" -"admin.md) or running " -"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:" -" true` in your playbook config. If your API is not externally exposed you" -" should still be able to on the local host for your synapse run these " -"commands." +"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:37 msgid "" -"The following command works on semi up to date Windows 10 installs and " -"All Windows 11 installations and other systems that ship curl. `curl " -"--header \"Authorization: Bearer \" -X POST " -"https://matrix.example.com/_synapse/admin/v1/users/@bot.draupnir:example.com/override_ratelimit`" -" Replace `@bot.draupnir:example.com` with the MXID of your Draupnir and " -"example.com with your homeserver domain. You can easily obtain an access " -"token for a homeserver admin account the same way you can obtain an " -"access token for Draupnir itself. If you made Draupnir Admin you can just" -" use the Draupnir token." +"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:39 +#: ../../../docs/configuring-playbook-bot-draupnir.md:43 +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 +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 +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 +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 msgid "Create a management room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:41 +#: ../../../docs/configuring-playbook-bot-draupnir.md:57 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 " @@ -142,13 +167,13 @@ msgid "" "it is important that you only invite trusted users to this room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:43 +#: ../../../docs/configuring-playbook-bot-draupnir.md:59 msgid "" "If you make the management room encrypted (E2EE), then you MUST enable " -"and use Pantalaimon (see below)." +"and use Pantalaimon (see [below](#configuration-with-e2ee-support))." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:45 +#: ../../../docs/configuring-playbook-bot-draupnir.md:61 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" @@ -156,43 +181,58 @@ msgid "" "room ID. The room ID will look something like `!qporfwt:example.com`." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:47 +#: ../../../docs/configuring-playbook-bot-draupnir.md:63 msgid "" "Finally invite the `@bot.draupnir:example.com` account you created " "earlier into the room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:49 +#: ../../../docs/configuring-playbook-bot-draupnir.md:65 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:51 +#: ../../../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" +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. To support E2EE, Draupnir needs to [use Pantalaimon" -"](configuring-playbook-pantalaimon.md)." +"moderated rooms." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:53 -msgid "a. Configuration with E2EE support" +#: ../../../docs/configuring-playbook-bot-draupnir.md:80 +msgid "" +"To support E2EE, Draupnir needs to [use Pantalaimon](configuring-" +"playbook-pantalaimon.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:55 +#: ../../../docs/configuring-playbook-bot-draupnir.md:82 +msgid "Configuration with E2EE support" +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." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:57 -#: ../../../docs/configuring-playbook-bot-draupnir.md:92 +#: ../../../docs/configuring-playbook-bot-draupnir.md:86 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:76 +#: ../../../docs/configuring-playbook-bot-draupnir.md:100 msgid "" "The playbook's `group_vars` will configure other required settings. If " "using this role separately without the playbook, you also need to " @@ -201,65 +241,108 @@ msgid "" "playbook's `group_vars`:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:88 -msgid "b. Configuration without E2EE support" +#: ../../../docs/configuring-playbook-bot-draupnir.md:112 +msgid "Configuration without E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:90 +#: ../../../docs/configuring-playbook-bot-draupnir.md:114 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:94 +#: ../../../docs/configuring-playbook-bot-draupnir.md:116 msgid "" -"You must replace `ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and " -"`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own values." +"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:104 -msgid "c. Migrating from Mjolnir (Only required if migrating.)" +#: ../../../docs/configuring-playbook-bot-draupnir.md:122 +msgid "Abuse Reports" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:106 +#: ../../../docs/configuring-playbook-bot-draupnir.md:124 +msgid "Draupnir supports two methods to receive reports in the management room." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:126 +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 +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 +msgid "Extending the configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:136 +msgid "" +"You can configure additional options by adding the " +"`matrix_bot_draupnir_configuration_extension_yaml` variable." +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:138 +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 +msgid "Migrating from Mjolnir (Only required if migrating)" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-draupnir.md:154 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:108 +#: ../../../docs/configuring-playbook-bot-draupnir.md:156 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:110 +#: ../../../docs/configuring-playbook-bot-draupnir.md:158 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:112 +#: ../../../docs/configuring-playbook-bot-draupnir.md:160 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:119 +#: ../../../docs/configuring-playbook-bot-draupnir.md:167 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:121 +#: ../../../docs/configuring-playbook-bot-draupnir.md:169 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:123 +#: ../../../docs/configuring-playbook-bot-draupnir.md:171 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:125 +#: ../../../docs/configuring-playbook-bot-draupnir.md:173 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" @@ -268,7 +351,7 @@ msgid "" "`just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:127 +#: ../../../docs/configuring-playbook-bot-draupnir.md:175 msgid "" "If you change the Pantalaimon's password " "(`matrix_bot_draupnir_pantalaimon_password` in your `vars.yml` file) " @@ -279,32 +362,32 @@ msgid "" " know its new password." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:129 +#: ../../../docs/configuring-playbook-bot-draupnir.md:177 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:131 +#: ../../../docs/configuring-playbook-bot-draupnir.md:179 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:133 +#: ../../../docs/configuring-playbook-bot-draupnir.md:181 msgid "Below is a **non-exhaustive quick-start guide** for the impatient." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:135 +#: ../../../docs/configuring-playbook-bot-draupnir.md:183 msgid "Making Draupnir join and protect a room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:137 +#: ../../../docs/configuring-playbook-bot-draupnir.md:185 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:139 +#: ../../../docs/configuring-playbook-bot-draupnir.md:187 msgid "" "Invite the bot to the room manually ([inviting Draupnir to rooms](https" "://the-draupnir-project.github.io/draupnir-documentation/moderator" @@ -312,13 +395,13 @@ msgid "" "the bot *may* ask for confirmation in the Management Room" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:141 +#: ../../../docs/configuring-playbook-bot-draupnir.md:189 msgid "" "[Give the bot permissions to do its job](#giving-draupnir-permissions-to-" "do-its-job)" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:143 +#: ../../../docs/configuring-playbook-bot-draupnir.md:191 msgid "" "Tell it to protect the room (using the [rooms command](https://the-" "draupnir-project.github.io/draupnir-documentation/moderator/managing-" @@ -327,7 +410,7 @@ msgid "" "!qporfwt:example.com`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:145 +#: ../../../docs/configuring-playbook-bot-draupnir.md:193 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" @@ -336,11 +419,11 @@ msgid "" " and [Enabling built-in protections](#enabling-built-in-protections)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:147 +#: ../../../docs/configuring-playbook-bot-draupnir.md:195 msgid "Giving Draupnir permissions to do its job" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:149 +#: ../../../docs/configuring-playbook-bot-draupnir.md:197 msgid "" "For Draupnir to do its job, you need to [give it permissions](https" "://the-draupnir-project.github.io/draupnir-documentation/moderator" @@ -348,7 +431,7 @@ msgid "" "protecting. This involves **giving it an Administrator power level**." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:151 +#: ../../../docs/configuring-playbook-bot-draupnir.md:199 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 " @@ -357,11 +440,11 @@ msgid "" " it)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:153 +#: ../../../docs/configuring-playbook-bot-draupnir.md:201 msgid "Subscribing to a public policy list" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:155 +#: ../../../docs/configuring-playbook-bot-draupnir.md:203 msgid "" "We recommend **subscribing to a public [policy list](https://the-" "draupnir-project.github.io/draupnir-documentation/concepts/policy-" @@ -370,24 +453,24 @@ msgid "" "watch-command-to-subscribe-to-policy-rooms)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:157 +#: ../../../docs/configuring-playbook-bot-draupnir.md:205 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:159 +#: ../../../docs/configuring-playbook-bot-draupnir.md:207 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:161 +#: ../../../docs/configuring-playbook-bot-draupnir.md:209 msgid "Creating your own policy lists and rules" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:163 +#: ../../../docs/configuring-playbook-bot-draupnir.md:211 msgid "" "We also recommend **creating your own policy lists** with the [list " "create](https://the-draupnir-project.github.io/draupnir-" @@ -395,7 +478,7 @@ msgid "" "create-command-to-create-a-policy-room) command." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:165 +#: ../../../docs/configuring-playbook-bot-draupnir.md:213 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 " @@ -404,7 +487,7 @@ msgid "" "command, the bot will invite you to the policy list room." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:167 +#: ../../../docs/configuring-playbook-bot-draupnir.md:215 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 " @@ -415,7 +498,7 @@ msgid "" "recommendation)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:169 +#: ../../../docs/configuring-playbook-bot-draupnir.md:217 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" @@ -423,19 +506,19 @@ msgid "" "targeting users." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:171 +#: ../../../docs/configuring-playbook-bot-draupnir.md:219 msgid "" "To create rules, you run commands in the Management Room (**not** in the " "policy list room)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:173 +#: ../../../docs/configuring-playbook-bot-draupnir.md:221 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:174 +#: ../../../docs/configuring-playbook-bot-draupnir.md:222 msgid "" "(ban all users on a given homeserver by using a [wildcard](https://the-" "draupnir-project.github.io/draupnir-documentation/moderator/managing-" @@ -443,34 +526,34 @@ msgid "" "all users are fake`" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:176 +#: ../../../docs/configuring-playbook-bot-draupnir.md:224 msgid "As a result of running these commands, you may observe:" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:178 +#: ../../../docs/configuring-playbook-bot-draupnir.md:226 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:179 +#: ../../../docs/configuring-playbook-bot-draupnir.md:227 msgid "" "applying these rules against all rooms that Draupnir is an Administrator " "in" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:181 +#: ../../../docs/configuring-playbook-bot-draupnir.md:229 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:183 +#: ../../../docs/configuring-playbook-bot-draupnir.md:231 msgid "Enabling built-in protections" msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:185 +#: ../../../docs/configuring-playbook-bot-draupnir.md:233 msgid "" "You can also **turn on various built-in [protections](https://the-" "draupnir-project.github.io/draupnir-documentation/protections)** like " @@ -478,75 +561,179 @@ msgid "" "room to invite-only\")." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:187 +#: ../../../docs/configuring-playbook-bot-draupnir.md:235 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:189 +#: ../../../docs/configuring-playbook-bot-draupnir.md:237 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:191 +#: ../../../docs/configuring-playbook-bot-draupnir.md:239 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:193 +#: ../../../docs/configuring-playbook-bot-draupnir.md:241 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:195 +#: ../../../docs/configuring-playbook-bot-draupnir.md:243 msgid "" "To **disable a given protection**, send a command like this: `!draupnir " "disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)." msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:197 -msgid "Extending the configuration" -msgstr "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/the-draupnir-project/Draupnir) to learn " +#~ "what it does and why it might " +#~ "be useful to you." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:199 -msgid "" -"You can configure additional options by adding the " -"`matrix_bot_draupnir_configuration_extension_yaml` variable to your " -"`inventory/host_vars/matrix.example.com/vars.yml` file." -msgstr "" +#~ msgid "If your migrating from Mjolnir skip to step 5b." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:201 -msgid "" -"For example to change Draupnir's `recordIgnoredInvites` option to `true` " -"you would add the following to your `vars.yml` file." -msgstr "" +#~ msgid "" +#~ "The playbook does not automatically " +#~ "create users for you. The bot " +#~ "requires an access token to be " +#~ "able to connect to your homeserver." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:215 -msgid "Abuse Reports" -msgstr "" +#~ msgid "" +#~ "You **need to register the bot " +#~ "user manually** before setting up the" +#~ " bot." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:217 -msgid "Draupnir supports two methods to receive reports in the management room." -msgstr "" +#~ msgid "" +#~ "If you would like Draupnir to be" +#~ " able to deactivate users, move " +#~ "aliases, shutdown rooms, show abuse " +#~ "reports ([see below](#abuse-reports)), etc " +#~ "then it must be a server admin " +#~ "so you need to change `admin=no` " +#~ "to `admin=yes` in the command above." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:219 -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 "" +#~ msgid "" +#~ "Refer to the documentation on [how " +#~ "to obtain an access token](obtaining-" +#~ "access-tokens.md)." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-draupnir.md:225 -msgid "" -"The other method polls an synapse admin API endpoint and is hence only " -"available when using synapse and when the Draupnir user is an admin user " -"(see step 1). To enable it, set `pollReports: true` in Draupnir's config:" -msgstr "" +#~ msgid "" +#~ "You will need to prevent Synapse " +#~ "from rate limiting the bot's account." +#~ " This is not an optional step. " +#~ "If you do not do this step " +#~ "Draupnir will crash. This can be " +#~ "done using Synapse's [admin API](https" +#~ "://matrix-" +#~ "org.github.io/synapse/latest/admin_api/user_admin_api.html" +#~ "#override-ratelimiting-for-users). Please " +#~ "ask for help if you are " +#~ "uncomfortable with these steps or run" +#~ " into issues." +#~ msgstr "" + +#~ msgid "" +#~ "If your Synapse Admin API is " +#~ "exposed to the internet for some " +#~ "reason like running the Synapse Admin" +#~ " Role [Link](configuring-playbook-synapse-" +#~ "admin.md) or running " +#~ "`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:" +#~ " true` in your playbook config. If" +#~ " your API is not externally exposed" +#~ " you should still be able to on" +#~ " the local host for your synapse " +#~ "run these commands." +#~ msgstr "" + +#~ msgid "" +#~ "The following command works on semi " +#~ "up to date Windows 10 installs and" +#~ " All Windows 11 installations and " +#~ "other systems that ship curl. `curl " +#~ "--header \"Authorization: Bearer \"" +#~ " -X POST " +#~ "https://matrix.example.com/_synapse/admin/v1/users/@bot.draupnir:example.com/override_ratelimit`" +#~ " Replace `@bot.draupnir:example.com` with the " +#~ "MXID of your Draupnir and example.com" +#~ " with your homeserver domain. You can" +#~ " easily obtain an access token for" +#~ " a homeserver admin account the same" +#~ " way you can obtain an access " +#~ "token for Draupnir itself. If you " +#~ "made Draupnir Admin you can just " +#~ "use the Draupnir token." +#~ msgstr "" + +#~ msgid "" +#~ "If you make the management room " +#~ "encrypted (E2EE), then you MUST enable" +#~ " and use Pantalaimon (see below)." +#~ msgstr "" + +#~ 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. To support E2EE, " +#~ "Draupnir needs to [use Pantalaimon" +#~ "](configuring-playbook-pantalaimon.md)." +#~ msgstr "" + +#~ msgid "a. Configuration with E2EE support" +#~ msgstr "" + +#~ msgid "b. Configuration without E2EE support" +#~ msgstr "" + +#~ msgid "" +#~ "You must replace " +#~ "`ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and " +#~ "`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own " +#~ "values." +#~ msgstr "" + +#~ msgid "c. Migrating from Mjolnir (Only required if migrating.)" +#~ msgstr "" + +#~ msgid "" +#~ "You can configure additional options by" +#~ " adding the " +#~ "`matrix_bot_draupnir_configuration_extension_yaml` variable " +#~ "to your `inventory/host_vars/matrix.example.com/vars.yml`" +#~ " file." +#~ msgstr "" + +#~ msgid "" +#~ "For example to change Draupnir's " +#~ "`recordIgnoredInvites` option to `true` you" +#~ " would add the following to your " +#~ "`vars.yml` file." +#~ msgstr "" + +#~ msgid "" +#~ "The other method polls an synapse " +#~ "admin API endpoint and is hence " +#~ "only available when using synapse and" +#~ " when the Draupnir user is an " +#~ "admin user (see step 1). To enable" +#~ " it, set `pollReports: true` in " +#~ "Draupnir's config:" +#~ msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po index ea89191dd..8dbd4665d 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -49,8 +49,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:9 msgid "" -"See the project's [documentation](https://github.com/matrix-org/go-neb) " -"to learn what it does and why it might be useful to you." +"See the project's [documentation](https://github.com/matrix-org/go-" +"neb/blob/master/README.md) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bot-go-neb.md:11 @@ -207,3 +208,10 @@ msgid "" "/matrix-org/go-neb)." msgstr "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/matrix-org/go-neb) to learn what it" +#~ " does and why it might be " +#~ "useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po index a0e5ceba7..e551070dc 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -36,9 +36,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:7 msgid "" -"See the project's [documentation](https://github.com/etkecc/honoroit#how-" -"it-looks-like) to learn what it does with screenshots and why it might be" -" useful to you." +"See the project's " +"[documentation](https://github.com/etkecc/honoroit/blob/main/README.md) " +"to learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bot-honoroit.md:9 @@ -166,3 +166,11 @@ msgid "" "[documentation](https://github.com/etkecc/honoroit#features)." msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/etkecc/honoroit#how-it-" +#~ "looks-like) to learn what it does " +#~ "with screenshots and why it might " +#~ "be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po index cc7e35bd2..fb61172cc 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -43,7 +43,7 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:7 msgid "" "See the project's [documentation](https://github.com/moan0s/matrix-" -"registration-bot#supported-commands) to learn what it does and why it " +"registration-bot/blob/master/README.md) to learn what it does and why it " "might be useful to you." msgstr "" @@ -145,3 +145,11 @@ msgid "" "etc… you can use:" msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/moan0s/matrix-" +#~ "registration-bot#supported-commands) to learn " +#~ "what it does and why it might " +#~ "be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po index 6c3e1858a..5148da31a 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -39,8 +39,8 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:7 msgid "" "See the project's [documentation](https://github.com/anoadragon453" -"/matrix-reminder-bot#usage) to learn what it does and why it might be " -"useful to you." +"/matrix-reminder-bot/blob/master/README.md) to learn what it does and why" +" it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:9 @@ -133,3 +133,11 @@ msgid "" "bot#usage)." msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/anoadragon453/matrix-" +#~ "reminder-bot#usage) to learn what it " +#~ "does and why it might be useful" +#~ " to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po index 7a323cbe2..cbadc9714 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -32,22 +32,23 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:5 msgid "" -"See the project's [documentation](https://github.com/matrix-org/mjolnir) " -"to learn what it does and why it might be useful to you." +"See the project's [documentation](https://github.com/matrix-" +"org/mjolnir/blob/main/README.md) to learn what it does and why it might " +"be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:7 -msgid "Register the bot account" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:9 -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 "Register the bot account" msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:11 -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-mjolnir.md:13 @@ -73,8 +74,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:25 msgid "" -"Refer to the documentation on [how to obtain an access token](obtaining-" -"access-tokens.md)." +"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-mjolnir.md:27 @@ -83,43 +85,65 @@ msgstr "" #: ../../../docs/configuring-playbook-bot-mjolnir.md:29 msgid "" -"You will need to prevent Synapse from rate limiting the bot's account. " -"This is not an optional step. If you do not do this step Mjolnir will " -"crash. This can be done using Synapse's [admin API](https://matrix-" -"org.github.io/synapse/latest/admin_api/user_admin_api.html#override-" -"ratelimiting-for-users). Please ask for help if you are uncomfortable " -"with these steps or run into issues." +"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:31 msgid "" -"If your Synapse Admin API is exposed to the internet for some reason like" -" running the Synapse Admin Role [Link](configuring-playbook-synapse-" -"admin.md) or running " -"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:" -" true` in your playbook config. If your API is not externally exposed you" -" should still be able to on the local host for your synapse run these " -"commands." +"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:33 msgid "" -"The following command works on semi up to date Windows 10 installs and " -"All Windows 11 installations and other systems that ship curl. `curl " -"--header \"Authorization: Bearer \" -X POST " -"https://matrix.example.com/_synapse/admin/v1/users/@bot.mjolnir:example.com/override_ratelimit`" -" Replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir and " -"example.com with your homeserver domain. You can easily obtain an access " -"token for a homeserver admin account the same way you can obtain an " -"access token for Mjolnir itself. If you made Mjolnir Admin you can just " -"use the Mjolnir token." +"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:35 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:39 +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 +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 +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 +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 msgid "Create a management room" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:37 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:53 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 " @@ -128,13 +152,13 @@ msgid "" "it is important that you only invite trusted users to this room." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:39 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:55 msgid "" "If you make the management room encrypted (E2EE), then you MUST enable " -"and use Pantalaimon (see below)." +"and use Pantalaimon (see [below](#configuration-with-e2ee-support))." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:41 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:57 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" @@ -142,44 +166,58 @@ msgid "" "room ID. The room ID will look something like `!qporfwt:example.com`." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:43 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:59 msgid "" "Finally invite the `@bot.mjolnir:example.com` account you created earlier" " into the room." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:45 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:61 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:47 +#: ../../../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" +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. To support E2EE, Mjolnir needs to [use Pantalaimon" -"](configuring-playbook-pantalaimon.md)." +"moderated rooms." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:49 -msgid "a. Configuration with E2EE support" +#: ../../../docs/configuring-playbook-bot-mjolnir.md:76 +msgid "" +"To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-" +"pantalaimon.md)." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:51 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:78 +msgid "Configuration with E2EE support" +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." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:53 -#: ../../../docs/configuring-playbook-bot-mjolnir.md:88 -#: ../../../docs/configuring-playbook-bot-mjolnir.md:102 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:82 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:72 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:96 msgid "" "The playbook's `group_vars` will configure other required settings. If " "using this role separately without the playbook, you also need to " @@ -188,53 +226,80 @@ msgid "" "playbook's `group_vars`:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:84 -msgid "b. Configuration without E2EE support" +#: ../../../docs/configuring-playbook-bot-mjolnir.md:108 +msgid "Configuration without E2EE support" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:86 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:110 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:90 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:112 msgid "" -"You must replace `ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and " -"`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own values." +"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:100 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:118 msgid "Adding Mjolnir synapse antispam module (optional)" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:112 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:120 +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 +msgid "Extending the configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-bot-mjolnir.md:132 +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 +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 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:114 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:150 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:121 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:157 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:123 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:159 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:125 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:161 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:127 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:163 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" @@ -243,7 +308,7 @@ msgid "" "`just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:129 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:165 msgid "" "If you change the Pantalaimon's password " "(`matrix_bot_mjolnir_pantalaimon_password` in your `vars.yml` file) " @@ -254,11 +319,11 @@ msgid "" "know its new password." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:131 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:167 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:133 +#: ../../../docs/configuring-playbook-bot-mjolnir.md:169 msgid "" "You can refer to the upstream [documentation](https://github.com/matrix-" "org/mjolnir) for additional ways to use and configure Mjolnir. Check out " @@ -266,16 +331,113 @@ msgid "" "#quickstart-guide) for some basic commands you can give to the bot." msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:135 -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 "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/matrix-org/mjolnir) to learn what it " +#~ "does and why it might be useful" +#~ " to you." +#~ msgstr "" -#: ../../../docs/configuring-playbook-bot-mjolnir.md:137 -msgid "" -"For example to change Mjolnir's `recordIgnoredInvites` option to `true` " -"you would add the following to your `vars.yml` file." -msgstr "" +#~ msgid "" +#~ "The playbook does not automatically " +#~ "create users for you. The bot " +#~ "requires an access token to be " +#~ "able to connect to your homeserver." +#~ msgstr "" + +#~ msgid "" +#~ "You **need to register the bot " +#~ "user manually** before setting up the" +#~ " bot." +#~ msgstr "" + +#~ msgid "" +#~ "Refer to the documentation on [how " +#~ "to obtain an access token](obtaining-" +#~ "access-tokens.md)." +#~ msgstr "" + +#~ msgid "" +#~ "You will need to prevent Synapse " +#~ "from rate limiting the bot's account." +#~ " This is not an optional step. " +#~ "If you do not do this step " +#~ "Mjolnir will crash. This can be " +#~ "done using Synapse's [admin API](https" +#~ "://matrix-" +#~ "org.github.io/synapse/latest/admin_api/user_admin_api.html" +#~ "#override-ratelimiting-for-users). Please " +#~ "ask for help if you are " +#~ "uncomfortable with these steps or run" +#~ " into issues." +#~ msgstr "" + +#~ msgid "" +#~ "If your Synapse Admin API is " +#~ "exposed to the internet for some " +#~ "reason like running the Synapse Admin" +#~ " Role [Link](configuring-playbook-synapse-" +#~ "admin.md) or running " +#~ "`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:" +#~ " true` in your playbook config. If" +#~ " your API is not externally exposed" +#~ " you should still be able to on" +#~ " the local host for your synapse " +#~ "run these commands." +#~ msgstr "" + +#~ msgid "" +#~ "The following command works on semi " +#~ "up to date Windows 10 installs and" +#~ " All Windows 11 installations and " +#~ "other systems that ship curl. `curl " +#~ "--header \"Authorization: Bearer \"" +#~ " -X POST " +#~ "https://matrix.example.com/_synapse/admin/v1/users/@bot.mjolnir:example.com/override_ratelimit`" +#~ " Replace `@bot.mjolnir:example.com` with the " +#~ "MXID of your Mjolnir and example.com " +#~ "with your homeserver domain. You can " +#~ "easily obtain an access token for " +#~ "a homeserver admin account the same " +#~ "way you can obtain an access token" +#~ " for Mjolnir itself. If you made " +#~ "Mjolnir Admin you can just use the" +#~ " Mjolnir token." +#~ msgstr "" + +#~ msgid "" +#~ "If you make the management room " +#~ "encrypted (E2EE), then you MUST enable" +#~ " and use Pantalaimon (see below)." +#~ msgstr "" + +#~ 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. To support E2EE, " +#~ "Mjolnir needs to [use Pantalaimon" +#~ "](configuring-playbook-pantalaimon.md)." +#~ msgstr "" + +#~ msgid "a. Configuration with E2EE support" +#~ msgstr "" + +#~ msgid "b. Configuration without E2EE support" +#~ msgstr "" + +#~ msgid "" +#~ "You must replace " +#~ "`ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and " +#~ "`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own " +#~ "values." +#~ msgstr "" + +#~ msgid "" +#~ "For example to change Mjolnir's " +#~ "`recordIgnoredInvites` option to `true` you" +#~ " would add the following to your " +#~ "`vars.yml` file." +#~ msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po index 0cc472964..39afd04fa 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -44,8 +44,8 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:7 msgid "" "See the project's [documentation](https://src.miscworks.net/fair/matrix-" -"appservice-kakaotalk) to learn what it does and why it might be useful to" -" you." +"appservice-kakaotalk/src/branch/master/README.md) to learn what it does " +"and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:9 @@ -227,3 +227,11 @@ msgid "" "in the future, as that would break the Double Puppeting feature" msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://src.miscworks.net/fair/matrix-" +#~ "appservice-kakaotalk) to learn what it " +#~ "does and why it might be useful" +#~ " to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po index 7973bfcd1..ce60bf716 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -32,8 +32,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:5 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://github.com/kelaresg/go-skype-" +"bridge/blob/master/README.md) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:7 @@ -97,3 +98,9 @@ msgstr "" msgid "Send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po index 392e7645b..86ee04111 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -42,9 +42,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-heisenbridge.md:7 msgid "" "See the project's " -"[README](https://github.com/hifi/heisenbridge/blob/master/README.md) to " -"learn what it does and why it might be useful to you. You can also take a" -" look at [this demonstration " +"[documentation](https://github.com/hifi/heisenbridge/blob/master/README.md)" +" to learn what it does and why it might be useful to you. You can also " +"take a look at [this demonstration " "video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)." msgstr "" @@ -182,3 +182,13 @@ msgid "" "[#heisenbridge:vi.fi](https://matrix.to/#/#heisenbridge:vi.fi) for help." msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[README](https://github.com/hifi/heisenbridge/blob/master/README.md)" +#~ " to learn what it does and why" +#~ " it might be useful to you. You" +#~ " can also take a look at [this" +#~ " demonstration " +#~ "video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po index 3e2ad96e1..14ef06275 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -33,15 +33,15 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:5 msgid "" "Hookshot can bridge [Webhooks](https://en.wikipedia.org/wiki/Webhook) " -"from software project management services such as GitHub, GitLab, JIRA, " +"from software project management services such as GitHub, GitLab, Jira, " "and Figma, as well as generic webhooks." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:7 msgid "" "See the project's [documentation](https://matrix-org.github.io/matrix-" -"hookshot/latest/hookshot.html) to learn what it does in detail and why it" -" might be useful to you." +"hookshot/latest/hookshot.html) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:9 @@ -52,152 +52,172 @@ msgid "" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:11 -msgid "Setup Instructions" +msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:13 -msgid "" -"Refer to the [official instructions](https://matrix-org.github.io/matrix-" -"hookshot/latest/setup.html) to learn what the individual options do." +msgid "Download GitHub app private key (optional)" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:15 msgid "" -"Enable the bridge by adding `matrix_hookshot_enabled: true` to your " -"`vars.yml` file" -msgstr "" - -#: ../../../docs/configuring-playbook-bridge-hookshot.md:16 -msgid "" -"For each of the services (GitHub, GitLab, Jira, Figma, generic webhooks) " -"fill in the respective variables `matrix_hookshot_service_*` listed in " -"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml) as " -"required." +"If you're setting up the GitHub bridge, you need to create your GitHub " +"app, and generate a private key file of it." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:17 msgid "" -"Take special note of the `matrix_hookshot_*_enabled` variables. Services " -"that need no further configuration are enabled by default (GitLab, " -"Generic), while you must first add the required configuration and enable " -"the others (GitHub, Jira, Figma)." -msgstr "" - -#: ../../../docs/configuring-playbook-bridge-hookshot.md:18 -msgid "" -"If you're setting up the GitHub bridge, you'll need to generate and " -"download a private key file after you created your GitHub app. Copy the " -"contents of that file to the variable " -"`matrix_hookshot_github_private_key` so the playbook can install it for " -"you, or use one of the [other methods](#manage-github-private-key-with-" -"aux-role) explained below." +"You need to download the private key file, if you will install the file " +"manually or with the `aux` role. For details, see [the section below" +"](#manage-github-private-key-with-aux-role)." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:19 -msgid "" -"If you've already installed Matrix services using the playbook before, " -"you'll need to re-run it (`--tags=setup-all,start`). If not, proceed with" -" [configuring other playbook services](configuring-playbook.md) and then " -"with [Installing](installing.md). Get back to this guide once ready. " -"Hookshot can be set up individually using the tag `setup-hookshot`." +msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md:21 msgid "" -"Other configuration options are available via the " +"Add the following configuration to your " +"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to " +"replace `GITHUB_PRIVATE_KEY_HERE` with the one created [above](#download-" +"github-app-private-key)." +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:35 +msgid "" +"For each of the services (GitHub, GitLab, Jira, Figma, and generic " +"webhooks) fill in the respective variables `matrix_hookshot_service_*` " +"listed in [main.yml](../roles/custom/matrix-bridge-" +"hookshot/defaults/main.yml) as required." +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:37 +msgid "" +"Take special note of the `matrix_hookshot_*_enabled` variables. Services " +"that need no further configuration are enabled by default (GitLab and " +"generic webhooks), while you must first add the required configuration " +"and enable the others (GitHub, Jira, and Figma)." +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:39 +msgid "Extending the configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:41 +msgid "" +"You can configure additional options by adding the " "`matrix_hookshot_configuration_extension_yaml` and " -"`matrix_hookshot_registration_extension_yaml` variables, see the comments" -" in [main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml) " -"for how to use them." +"`matrix_hookshot_registration_extension_yaml` variables." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:23 -msgid "Finally, run the playbook (see [installing](installing.md))." -msgstr "" - -#: ../../../docs/configuring-playbook-bridge-hookshot.md:25 -msgid "End-to-bridge encryption" -msgstr "" - -#: ../../../docs/configuring-playbook-bridge-hookshot.md:27 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:43 msgid "" -"You can enable [encryption](https://matrix-org.github.io/matrix-" -"hookshot/latest/advanced/encryption.html) for Hookshot by adding " -"`matrix_hookshot_encryption_enabled: true` to your configuration " -"(`vars.yml`) and [executing the playbook](installing.md) again." +"Refer the [official instructions](https://matrix-org.github.io/matrix-" +"hookshot/latest/setup.html) and the comments in " +"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml) to " +"learn what the individual options do." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:29 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:45 +msgid "Installing" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:47 msgid "" -"Should the crypto store be corrupted, you can reset it by executing this " -"Ansible playbook with the tag `reset-hookshot-encryption` added, for " -"example `ansible-playbook -i inventory/hosts setup.yml --tags=reset-" -"hookshot-encryption`." +"After configuring the playbook, run it with [playbook tags](playbook-" +"tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:31 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:54 +msgid "" +"The shortcut commands with the [`just` program](just.md) are also " +"available: `just install-service hookshot` or `just setup-all`" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:56 +msgid "" +"`just install-service hookshot` 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-bridge-hookshot.md:58 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:33 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:60 msgid "" "To use the bridge, you need to create a room and invite the Hookshot bot " "(`@hookshot:example.com`) to it." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:35 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:62 msgid "" "Make sure the bot is able to send state events (usually the Moderator " "power level in clients)." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:37 -msgid "Send a `!hookshot help` message to see a list of help commands." +#: ../../../docs/configuring-playbook-bridge-hookshot.md:64 +msgid "" +"Send `!hookshot help` to the room to see the bridge's help menu for " +"additional commands." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:39 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:66 msgid "" "Refer to [Hookshot's documentation](https://matrix-org.github.io/matrix-" "hookshot/latest/usage.html) for more details about using the bridge's " "various features." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:41 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:68 msgid "" -"**Important**: Note that the different listeners are bound to certain " -"paths which might differ from those assumed by the hookshot " -"documentation, see [URLs for bridges setup](#urls-for-bridges-setup) " -"below." +"💡 **Note**: the different listeners are bound to certain paths which " +"might differ from those assumed by the hookshot documentation. See [URLs " +"for bridges setup](#urls-for-bridges-setup) below." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:43 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:70 +msgid "Reset crypto store" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:72 +msgid "" +"Should the crypto store be corrupted, you can reset it by executing this " +"Ansible playbook with the tag `reset-hookshot-encryption` added:" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-hookshot.md:78 msgid "More setup documentation" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:45 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:80 msgid "URLs for bridges setup" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:47 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:82 msgid "" "Unless indicated otherwise, the following endpoints are reachable on your" " `matrix.` subdomain (if the feature is enabled)." msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md -msgid "listener" +msgid "Listener" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md -msgid "default path" +msgid "Default path" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md -msgid "variable" +msgid "Variable" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md -msgid "used as" +msgid "Used as" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md @@ -261,7 +281,7 @@ msgid "`matrix_hookshot_jira_oauth_endpoint`" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md -msgid "JIRA OAuth" +msgid "Jira OAuth" msgstr "" #: ../../../docs/configuring-playbook-bridge-hookshot.md @@ -348,71 +368,72 @@ msgstr "" msgid "Prometheus" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:61 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:96 msgid "" "Also see the various `matrix_hookshot_container_labels_*` variables in " -"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml), which" -" expose URLs publicly." +"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml), " +"which expose URLs publicly" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:63 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:98 msgid "" "The different listeners are also reachable *internally* in the docker-" "network via the container's name (configured by " "`matrix_hookshot_container_url`) and on different ports (e.g. " -"`matrix_hookshot_appservice_port`). Read [main.yml](/roles/custom/matrix-" -"bridge-hookshot/defaults/main.yml) in detail for more info." +"`matrix_hookshot_appservice_port`). Read [main.yml](../roles/custom" +"/matrix-bridge-hookshot/defaults/main.yml) in detail for more info." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:65 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:100 msgid "Manage GitHub Private Key with aux role" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:67 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:102 msgid "" "The GitHub bridge requires you to install a private key file. This can be" " done in multiple ways:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:68 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:104 msgid "" "copy the *contents* of the downloaded file and set the variable " "`matrix_hookshot_github_private_key` to the contents (see example in " -"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml))." +"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml))." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:69 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:105 msgid "" "somehow copy the file to the path `{{ matrix_hookshot_base_path }}/{{ " "matrix_hookshot_github_private_key_file }}` (default: `/matrix/hookshot" "/private-key.pem`) on the server manually." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:70 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:106 msgid "" "use the [`aux` role](https://github.com/mother-of-all-self-hosting" "/ansible-role-aux) to copy the file from an arbitrary path on your " "ansible client to the correct path on the server." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:72 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:108 msgid "" "To use the `aux` role, make sure the `matrix_hookshot_github_private_key`" -" variable is empty. Then add the following additional configuration:" +" variable is empty. Then add the following configuration to your " +"`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:83 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:119 msgid "" "For more information, see the documentation in the [default configuration" " of the aux role](https://github.com/mother-of-all-self-hosting/ansible-" "role-aux/blob/main/defaults/main.yml)." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:85 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:121 msgid "Provisioning API" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:87 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:123 msgid "" "The provisioning API will be enabled automatically if you set " "`matrix_dimension_enabled: true` and provided a " @@ -422,11 +443,11 @@ msgid "" "`matrix_hookshot_container_url` and `matrix_hookshot_provisioning_port`." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:89 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:125 msgid "Metrics" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:91 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:127 msgid "" "Metrics are **only enabled by default** if the builtin [Prometheus" "](configuring-playbook-prometheus-grafana.md) is enabled (by default, " @@ -435,32 +456,32 @@ msgid "" "set up your own Dashboard for displaying them." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:93 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:129 msgid "" "To explicitly enable metrics, use `matrix_hookshot_metrics_enabled: " "true`. This only exposes metrics over the container network, however." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:95 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:131 msgid "" "**To collect metrics from an external Prometheus server**, besides " "enabling metrics as described above, you will also need to enable metrics" " exposure on `https://matrix.example.com/metrics/hookshot` by:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:97 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:133 msgid "" "either enabling metrics exposure for Hookshot via " "`matrix_hookshot_metrics_proxying_enabled: true`" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:98 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:134 msgid "" "or enabling metrics exposure for all services via " "`matrix_metrics_exposure_enabled: true`" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:100 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:136 msgid "" "Whichever one you go with, by default metrics are exposed publicly " "**without** password-protection. See [the Prometheus and Grafana docs" @@ -468,11 +489,11 @@ msgid "" "protection for metrics." msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:102 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:138 msgid "Collision with matrix-appservice-webhooks" msgstr "" -#: ../../../docs/configuring-playbook-bridge-hookshot.md:104 +#: ../../../docs/configuring-playbook-bridge-hookshot.md:140 msgid "" "If you are also running [matrix-appservice-webhooks](configuring-" "playbook-bridge-appservice-webhooks.md), it reserves its namespace by the" @@ -482,3 +503,175 @@ msgid "" "`matrix_hookshot_generic_userIdPrefix: '_webhooks_'`)." msgstr "" +#~ msgid "" +#~ "Hookshot can bridge " +#~ "[Webhooks](https://en.wikipedia.org/wiki/Webhook) from " +#~ "software project management services such " +#~ "as GitHub, GitLab, JIRA, and Figma, " +#~ "as well as generic webhooks." +#~ msgstr "" + +#~ msgid "" +#~ "See the project's [documentation](https://matrix-" +#~ "org.github.io/matrix-hookshot/latest/hookshot.html) to " +#~ "learn what it does in detail and" +#~ " why it might be useful to you." +#~ msgstr "" + +#~ msgid "Setup Instructions" +#~ msgstr "" + +#~ msgid "" +#~ "Refer to the [official instructions](https" +#~ "://matrix-org.github.io/matrix-hookshot/latest/setup.html)" +#~ " to learn what the individual options" +#~ " do." +#~ msgstr "" + +#~ msgid "" +#~ "Enable the bridge by adding " +#~ "`matrix_hookshot_enabled: true` to your " +#~ "`vars.yml` file" +#~ msgstr "" + +#~ msgid "" +#~ "For each of the services (GitHub, " +#~ "GitLab, Jira, Figma, generic webhooks) " +#~ "fill in the respective variables " +#~ "`matrix_hookshot_service_*` listed in " +#~ "[main.yml](/roles/custom/matrix-bridge-" +#~ "hookshot/defaults/main.yml) as required." +#~ msgstr "" + +#~ msgid "" +#~ "Take special note of the " +#~ "`matrix_hookshot_*_enabled` variables. Services that" +#~ " need no further configuration are " +#~ "enabled by default (GitLab, Generic), " +#~ "while you must first add the " +#~ "required configuration and enable the " +#~ "others (GitHub, Jira, Figma)." +#~ msgstr "" + +#~ msgid "" +#~ "If you're setting up the GitHub " +#~ "bridge, you'll need to generate and " +#~ "download a private key file after " +#~ "you created your GitHub app. Copy " +#~ "the contents of that file to the" +#~ " variable `matrix_hookshot_github_private_key` so " +#~ "the playbook can install it for " +#~ "you, or use one of the [other " +#~ "methods](#manage-github-private-key-with-" +#~ "aux-role) explained below." +#~ msgstr "" + +#~ msgid "" +#~ "If you've already installed Matrix " +#~ "services using the playbook before, " +#~ "you'll need to re-run it (`--tags" +#~ "=setup-all,start`). If not, proceed with" +#~ " [configuring other playbook services" +#~ "](configuring-playbook.md) and then with " +#~ "[Installing](installing.md). Get back to this" +#~ " guide once ready. Hookshot can be" +#~ " set up individually using the tag" +#~ " `setup-hookshot`." +#~ msgstr "" + +#~ msgid "" +#~ "Other configuration options are available " +#~ "via the `matrix_hookshot_configuration_extension_yaml` " +#~ "and `matrix_hookshot_registration_extension_yaml` " +#~ "variables, see the comments in " +#~ "[main.yml](/roles/custom/matrix-bridge-" +#~ "hookshot/defaults/main.yml) for how to use " +#~ "them." +#~ msgstr "" + +#~ msgid "Finally, run the playbook (see [installing](installing.md))." +#~ msgstr "" + +#~ msgid "End-to-bridge encryption" +#~ msgstr "" + +#~ msgid "" +#~ "You can enable [encryption](https://matrix-" +#~ "org.github.io/matrix-hookshot/latest/advanced/encryption.html)" +#~ " for Hookshot by adding " +#~ "`matrix_hookshot_encryption_enabled: true` to your" +#~ " configuration (`vars.yml`) and [executing " +#~ "the playbook](installing.md) again." +#~ msgstr "" + +#~ msgid "" +#~ "Should the crypto store be corrupted," +#~ " you can reset it by executing " +#~ "this Ansible playbook with the tag " +#~ "`reset-hookshot-encryption` added, for " +#~ "example `ansible-playbook -i inventory/hosts" +#~ " setup.yml --tags=reset-hookshot-encryption`." +#~ msgstr "" + +#~ msgid "Send a `!hookshot help` message to see a list of help commands." +#~ msgstr "" + +#~ msgid "" +#~ "**Important**: Note that the different " +#~ "listeners are bound to certain paths " +#~ "which might differ from those assumed" +#~ " by the hookshot documentation, see " +#~ "[URLs for bridges setup](#urls-for-" +#~ "bridges-setup) below." +#~ msgstr "" + +#~ msgid "listener" +#~ msgstr "" + +#~ msgid "default path" +#~ msgstr "" + +#~ msgid "variable" +#~ msgstr "" + +#~ msgid "used as" +#~ msgstr "" + +#~ msgid "JIRA OAuth" +#~ msgstr "" + +#~ msgid "" +#~ "Also see the various " +#~ "`matrix_hookshot_container_labels_*` variables in " +#~ "[main.yml](/roles/custom/matrix-bridge-" +#~ "hookshot/defaults/main.yml), which expose URLs " +#~ "publicly." +#~ msgstr "" + +#~ msgid "" +#~ "The different listeners are also " +#~ "reachable *internally* in the docker-" +#~ "network via the container's name " +#~ "(configured by `matrix_hookshot_container_url`) and" +#~ " on different ports (e.g. " +#~ "`matrix_hookshot_appservice_port`). Read " +#~ "[main.yml](/roles/custom/matrix-bridge-" +#~ "hookshot/defaults/main.yml) in detail for more" +#~ " info." +#~ msgstr "" + +#~ msgid "" +#~ "copy the *contents* of the downloaded" +#~ " file and set the variable " +#~ "`matrix_hookshot_github_private_key` to the contents" +#~ " (see example in [main.yml](/roles/custom" +#~ "/matrix-bridge-hookshot/defaults/main.yml))." +#~ msgstr "" + +#~ msgid "" +#~ "To use the `aux` role, make sure" +#~ " the `matrix_hookshot_github_private_key` variable " +#~ "is empty. Then add the following " +#~ "additional configuration:" +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po index b9ffa1e42..3ee8066a8 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -32,8 +32,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:5 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://github.com/benkuly/matrix-sms-" +"bridge/blob/master/README.md) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:7 @@ -98,3 +99,9 @@ msgid "" "bridge/blob/master/README.md#user-guide) to see how this bridge works." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po index 1e8109cd3..badc8ae74 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -39,8 +39,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:7 msgid "" -"See the project's [documentation](https://github.com/mautrix/twitter) to " -"learn what it does and why it might be useful to you." +"See the project's " +"[documentation](https://github.com/mautrix/twitter/blob/master/README.md)" +" to learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:9 @@ -48,58 +49,61 @@ msgid "Prerequisite (optional)" msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:11 +msgid "Enable Appservice Double Puppet (optional)" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:13 msgid "" "If you want to set up [Double " "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) " "(hint: you most likely do) for this bridge automatically, you need to " "have enabled [Appservice Double Puppet](configuring-playbook-appservice-" -"double-puppet.md) or [Shared Secret Auth](configuring-playbook-shared-" -"secret-auth.md) service for this playbook." +"double-puppet.md) service for this playbook." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:13 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:15 msgid "" "For details about configuring Double Puppeting for this bridge, see the " "section below: [Set up Double Puppeting](#-set-up-double-puppeting)" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:15 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:17 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:17 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:19 msgid "" "To enable the bridge, add the following configuration to your " "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:23 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:25 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:25 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:27 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:32 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:34 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:34 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:36 msgid "" "The `ensure-matrix-users-created` playbook tag makes the playbook " "automatically create the bot's user account." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:36 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:38 msgid "" "The shortcut commands with the [`just` program](just.md) are also " "available: `just install-all` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:38 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:40 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" @@ -108,71 +112,60 @@ msgid "" "`just setup-all`, or these components will still remain installed." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:40 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:42 msgid "Usage" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:42 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:44 msgid "" "You then need to start a chat with `@twitterbot:example.com` (where " "`example.com` is your base domain, not the `matrix.` domain)." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:43 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:45 msgid "" "Send login-cookie to start the login. The bot should respond with " "instructions on how to proceed." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:45 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:47 msgid "" "You can learn more here about authentication from the bridge's [official " "documentation on " "Authentication](https://docs.mau.fi/bridges/python/twitter/authentication.html)." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:47 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:49 msgid "💡 Set up Double Puppeting" msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:49 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:51 msgid "" "After successfully enabling bridging, you may wish to set up [Double " "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) " "(hint: you most likely do)." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:51 +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:53 msgid "To set it up, you have 2 ways of going about it." msgstr "" -#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:53 -msgid "" -"Method 1: automatically, by enabling Appservice Double Puppet or Shared " -"Secret Auth" -msgstr "" - #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:55 -msgid "" -"The bridge automatically performs Double Puppeting if [Appservice Double " -"Puppet](configuring-playbook-appservice-double-puppet.md) or [Shared " -"Secret Auth](configuring-playbook-shared-secret-auth.md) service is " -"configured and enabled on the server for this playbook." +msgid "Method 1: automatically, by enabling Appservice Double Puppet" msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:57 msgid "" -"Enabling [Appservice Double Puppet](configuring-playbook-appservice-" -"double-puppet.md) is the recommended way of setting up Double Puppeting, " -"as it's easier to accomplish, works for all your users automatically, and" -" has less of a chance of breaking in the future." +"The bridge automatically performs Double Puppeting if [Appservice Double " +"Puppet](configuring-playbook-appservice-double-puppet.md) service is " +"configured and enabled on the server for this playbook." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:59 msgid "" -"Enabling double puppeting by enabling the [Shared Secret Auth" -"](configuring-playbook-shared-secret-auth.md) service works at the time " -"of writing, but is deprecated and will stop working in the future." +"This is the recommended way of setting up Double Puppeting, as it's " +"easier to accomplish, works for all your users automatically, and has " +"less of a chance of breaking in the future." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:61 @@ -181,9 +174,88 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:63 msgid "" -"This method is currently not available for the Mautrix-Twitter bridge, " -"but is on the " -"[roadmap](https://github.com/mautrix/twitter/blob/master/ROADMAP.md) " -"under Misc/Manual login with `login-matrix`" +"When using this method, **each user** that wishes to enable Double " +"Puppeting needs to follow the following steps:" 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)." +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:67 +msgid "" +"send the access token to the bot. Example: `login-matrix " +"MATRIX_ACCESS_TOKEN_HERE`" +msgstr "" + +#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:69 +msgid "" +"make sure you don't log out the `Mautrix-Slack` device some time in the " +"future, as that would break the Double Puppeting feature" +msgstr "" + +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/mautrix/twitter) to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + +#~ msgid "" +#~ "If you want to set up [Double " +#~ "Puppeting](https://docs.mau.fi/bridges/general/double-" +#~ "puppeting.html) (hint: you most likely " +#~ "do) for this bridge automatically, you" +#~ " need to have enabled [Appservice " +#~ "Double Puppet](configuring-playbook-appservice-" +#~ "double-puppet.md) or [Shared Secret Auth" +#~ "](configuring-playbook-shared-secret-auth.md) " +#~ "service for this playbook." +#~ msgstr "" + +#~ msgid "" +#~ "Method 1: automatically, by enabling " +#~ "Appservice Double Puppet or Shared " +#~ "Secret Auth" +#~ msgstr "" + +#~ msgid "" +#~ "The bridge automatically performs Double " +#~ "Puppeting if [Appservice Double Puppet" +#~ "](configuring-playbook-appservice-double-" +#~ "puppet.md) or [Shared Secret Auth" +#~ "](configuring-playbook-shared-secret-auth.md) " +#~ "service is configured and enabled on " +#~ "the server for this playbook." +#~ msgstr "" + +#~ msgid "" +#~ "Enabling [Appservice Double Puppet](configuring-" +#~ "playbook-appservice-double-puppet.md) is " +#~ "the recommended way of setting up " +#~ "Double Puppeting, as it's easier to " +#~ "accomplish, works for all your users " +#~ "automatically, and has less of a " +#~ "chance of breaking in the future." +#~ msgstr "" + +#~ msgid "" +#~ "Enabling double puppeting by enabling " +#~ "the [Shared Secret Auth](configuring-" +#~ "playbook-shared-secret-auth.md) service " +#~ "works at the time of writing, but" +#~ " is deprecated and will stop working" +#~ " in the future." +#~ msgstr "" + +#~ msgid "" +#~ "This method is currently not available" +#~ " for the Mautrix-Twitter bridge, but" +#~ " is on the " +#~ "[roadmap](https://github.com/mautrix/twitter/blob/master/ROADMAP.md)" +#~ " under Misc/Manual login with `login-" +#~ "matrix`" +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po index 673a7908b..16822cbfc 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -35,8 +35,8 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:5 msgid "" "See the project's " -"[documentation](https://github.com/mautrix/wsproxy#readme) to learn what " -"it does and why it might be useful to you." +"[documentation](https://github.com/mautrix/wsproxy/blob/master/README.md)" +" to learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:7 @@ -143,3 +143,10 @@ msgid "" "running `android-sms` and/or `matrix-imessage` on your device(s)." msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/mautrix/wsproxy#readme) to" +#~ " learn what it does and why it" +#~ " might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po index ee082570c..715823a51 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -54,8 +54,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:9 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://gitlab.com/mx-puppet/discord" +"/mx-puppet-discord/blob/master/README.md) to learn what it does and why " +"it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:11 @@ -137,3 +138,9 @@ msgstr "" msgid "Also send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po index 0e89d39f8..4381c17cf 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -33,8 +33,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:5 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://gitlab.com/xangelix-pub/matrix" +"/mx-puppet-groupme/blob/master/README.md) to learn what it does and why " +"it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:7 @@ -121,3 +122,9 @@ msgstr "" msgid "Also send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po index 02d3399ae..80130e822 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -44,8 +44,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:7 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://gitlab.com/mx-puppet/slack/mx-" +"puppet-slack/blob/master/README.md) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:9 @@ -138,3 +139,9 @@ msgstr "" msgid "Also send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po index 46bb77cc2..e95f4c70a 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -32,8 +32,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:5 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://github.com/icewind1991/mx-" +"puppet-steam/blob/master/README.md) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:7 @@ -114,3 +115,9 @@ msgstr "" msgid "Also send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po index 4e21b4966..1583475ca 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -39,8 +39,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:7 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://github.com/Sorunome/mx-puppet-" +"twitter/blob/master/README.md) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:9 @@ -128,3 +129,9 @@ msgstr "" msgid "Also send `help` to the bot to see the commands available." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po index c70b924fd..7bc3831ab 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -45,8 +45,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-postmoogle.md:9 msgid "" -"See the project's [documentation](https://github.com/etkecc/postmoogle) " -"to learn what it does and why it might be useful to you." +"See the project's " +"[documentation](https://github.com/etkecc/postmoogle/blob/master/README.md)" +" to learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-postmoogle.md:11 @@ -195,3 +196,10 @@ msgid "" " it to `DEBUG` with the following additional configuration:" msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/etkecc/postmoogle) to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po index 9adff616c..6fd0059f3 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -33,8 +33,9 @@ msgstr "" #: ../../../docs/configuring-playbook-bridge-wechat.md:5 msgid "" -"See the project page to learn what it does and why it might be useful to " -"you." +"See the project's [documentation](https://github.com/duo/matrix-" +"wechat/blob/master/README.md) to learn what it does and why it might be " +"useful to you." msgstr "" #: ../../../docs/configuring-playbook-bridge-wechat.md:7 @@ -96,3 +97,9 @@ msgstr "" msgid "Send `help` to the bot to see the available commands." msgstr "" +#~ msgid "" +#~ "See the project page to learn what" +#~ " it does and why it might be" +#~ " useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po index dfac1cb02..8b73bae84 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -226,33 +226,59 @@ msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:87 msgid "" -"To enable Email2Matrix, run the playbook with [playbook tags](playbook-" +"After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:93 +#: ../../../docs/configuring-playbook-email2matrix.md:94 msgid "**Notes**:" msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:95 +#: ../../../docs/configuring-playbook-email2matrix.md:96 msgid "" "The shortcut commands with the [`just` program](just.md) are also " -"available: `just run-tags setup-email2matrix,start` or `just setup-all`" +"available: `just install-service email2matrix` or `just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-email2matrix.md:97 +#: ../../../docs/configuring-playbook-email2matrix.md:98 msgid "" -"`just run-tags setup-email2matrix,start` is useful for maintaining your " -"setup quickly when its components remain unchanged. If you adjust your " +"`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:99 +#: ../../../docs/configuring-playbook-email2matrix.md:100 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 "" +#~ msgid "" +#~ "To enable Email2Matrix, run the playbook" +#~ " with [playbook tags](playbook-tags.md) as" +#~ " below:" +#~ msgstr "" + +#~ msgid "" +#~ "The shortcut commands with the [`just`" +#~ " program](just.md) are also available: " +#~ "`just run-tags setup-email2matrix,start` " +#~ "or `just setup-all`" +#~ msgstr "" + +#~ msgid "" +#~ "`just run-tags setup-email2matrix,start` " +#~ "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 "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po index a02b8c7dd..49d8e8fe4 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -35,8 +35,9 @@ msgstr "" #: ../../../docs/configuring-playbook-ldap-auth.md:5 msgid "" -"See that project's documentation to learn what it does and why it might " -"be useful to you." +"See the project's [documentation](https://github.com/matrix-org/matrix-" +"synapse-ldap3/blob/main/README.rst) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-ldap-auth.md:7 @@ -81,3 +82,9 @@ msgid "" "](configuring-playbook-matrix-ldap-registration-proxy.md)." msgstr "" +#~ msgid "" +#~ "See that project's documentation to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ma1sd.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ma1sd.po index c716e47a8..fd9b19f79 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ma1sd.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ma1sd.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -52,8 +52,9 @@ msgstr "" #: ../../../docs/configuring-playbook-ma1sd.md:9 msgid "" -"See the project's [documentation](https://github.com/ma1uta/ma1sd) to " -"learn what it does and why it might be useful to you." +"See the project's " +"[documentation](https://github.com/ma1uta/ma1sd/blob/master/README.md) to" +" learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-ma1sd.md:11 @@ -332,3 +333,10 @@ msgid "" "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" +#~ msgid "" +#~ "See the project's " +#~ "[documentation](https://github.com/ma1uta/ma1sd) to learn" +#~ " what it does and why it might" +#~ " be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po index 9e50af971..43934ff04 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -42,101 +42,107 @@ msgstr "" msgid "" "In short, it's a sort of automation and firewalling service, which is " "helpful if you're instaling Matrix services in a controlled corporate " -"environment. See that project's documentation to learn what it does and " -"why it might be useful to you." +"environment." msgstr "" #: ../../../docs/configuring-playbook-matrix-corporal.md:13 msgid "" +"See the project's [documentation](https://github.com/devture/matrix-" +"corporal/blob/main/README.md) to learn what it does and why it might be " +"useful to you." +msgstr "" + +#: ../../../docs/configuring-playbook-matrix-corporal.md:15 +msgid "" "If you decide that you'd like to let this playbook install it for you, " "you'd need to also:" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:14 +#: ../../../docs/configuring-playbook-matrix-corporal.md:16 msgid "" "(required) [set up the Shared Secret Auth password provider module" "](configuring-playbook-shared-secret-auth.md)" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:15 +#: ../../../docs/configuring-playbook-matrix-corporal.md:17 msgid "" "(optional, but encouraged) [set up the REST authentication password " "provider module](configuring-playbook-rest-auth.md)" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:17 +#: ../../../docs/configuring-playbook-matrix-corporal.md:19 msgid "Adjusting the playbook configuration" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:19 +#: ../../../docs/configuring-playbook-matrix-corporal.md:21 msgid "" "Add the following configuration to your " "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your " "needs):" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:72 +#: ../../../docs/configuring-playbook-matrix-corporal.md:74 msgid "" "Matrix Corporal operates with a specific Matrix user on your server. By " "default, it's `matrix-corporal` (controllable by the " "`matrix_corporal_reconciliation_user_id_local_part` setting, see above)." msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:74 +#: ../../../docs/configuring-playbook-matrix-corporal.md:76 msgid "" "No matter what Matrix user ID you configure to run it with, make sure " "that:" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:76 +#: ../../../docs/configuring-playbook-matrix-corporal.md:78 msgid "" "the Matrix Corporal user is created by [registering it](registering-" "users.md) **with administrator privileges**. Use a password you remember," " as you'll need to log in from time to time to create or join rooms" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:78 +#: ../../../docs/configuring-playbook-matrix-corporal.md:80 msgid "" "the Matrix Corporal user is joined and has Admin/Moderator-level access " "to any rooms you want it to manage" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:80 +#: ../../../docs/configuring-playbook-matrix-corporal.md:82 msgid "Using a locally-stored static policy" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:82 +#: ../../../docs/configuring-playbook-matrix-corporal.md:84 msgid "" "If you'd like to use a [static policy file](https://github.com/devture" "/matrix-corporal/blob/master/docs/policy-providers.md#static-file-pull-" "style-policy-provider), you can use a configuration like this:" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:114 +#: ../../../docs/configuring-playbook-matrix-corporal.md:116 msgid "" "To learn more about what the policy configuration, see the matrix-" "corporal documentation on [policy](https://github.com/devture/matrix-" "corporal/blob/master/docs/policy.md)." msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:116 +#: ../../../docs/configuring-playbook-matrix-corporal.md:118 msgid "Installing" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:118 +#: ../../../docs/configuring-playbook-matrix-corporal.md:120 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:125 +#: ../../../docs/configuring-playbook-matrix-corporal.md:127 msgid "" "The shortcut commands with the [`just` program](just.md) are also " "available: `just run-tags setup-aux-files,setup-corporal,start` or `just " "setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:127 +#: ../../../docs/configuring-playbook-matrix-corporal.md:129 msgid "" "`just run-tags setup-aux-files,setup-corporal,start` is useful for " "maintaining your setup quickly when its components remain unchanged. If " @@ -145,33 +151,33 @@ msgid "" "`just setup-all` runs the `ensure-matrix-users-created` tag too." msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:129 +#: ../../../docs/configuring-playbook-matrix-corporal.md:131 msgid "Matrix Corporal files" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:131 +#: ../../../docs/configuring-playbook-matrix-corporal.md:133 msgid "" "The following local filesystem paths are mounted in the `matrix-corporal`" " container and can be used in your configuration (or policy):" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:133 +#: ../../../docs/configuring-playbook-matrix-corporal.md:135 msgid "`/matrix/corporal/config` is mounted at `/etc/matrix-corporal` (read-only)" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:135 +#: ../../../docs/configuring-playbook-matrix-corporal.md:137 msgid "" "`/matrix/corporal/var` is mounted at `/var/matrix-corporal` (read and " "write)" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:137 +#: ../../../docs/configuring-playbook-matrix-corporal.md:139 msgid "" "`/matrix/corporal/cache` is mounted at `/var/cache/matrix-corporal` (read" " and write)" msgstr "" -#: ../../../docs/configuring-playbook-matrix-corporal.md:139 +#: ../../../docs/configuring-playbook-matrix-corporal.md:141 msgid "" "As an example: you can create your own configuration files in " "`/matrix/corporal/config` and they will appear in `/etc/matrix-corporal` " @@ -182,3 +188,13 @@ msgid "" "and write)." msgstr "" +#~ msgid "" +#~ "In short, it's a sort of " +#~ "automation and firewalling service, which " +#~ "is helpful if you're instaling Matrix" +#~ " services in a controlled corporate " +#~ "environment. See that project's documentation" +#~ " to learn what it does and why" +#~ " it might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po index eaca549e9..4e47061d4 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -34,7 +34,8 @@ msgstr "" #: ../../../docs/configuring-playbook-pantalaimon.md:5 msgid "" "See the project's [documentation](https://github.com/matrix-" -"org/pantalaimon) to learn what it does and why it might be useful to you." +"org/pantalaimon/blob/master/README.md) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-pantalaimon.md:7 @@ -90,3 +91,10 @@ msgid "" "these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/matrix-org/pantalaimon) to learn what it" +#~ " does and why it might be " +#~ "useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-rest-auth.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-rest-auth.po index 2a1d13324..ec978d039 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-rest-auth.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-rest-auth.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -35,8 +35,9 @@ msgstr "" #: ../../../docs/configuring-playbook-rest-auth.md:5 msgid "" -"See that project's documentation to learn what it does and why it might " -"be useful to you." +"See the project's [documentation](https://github.com/ma1uta/matrix-" +"synapse-rest-password-provider/blob/master/README.md) to learn what it " +"does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-rest-auth.md:7 @@ -87,3 +88,9 @@ msgid "" "these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" +#~ msgid "" +#~ "See that project's documentation to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po index 7c14374e6..7c1c8bc8b 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -35,8 +35,9 @@ msgstr "" #: ../../../docs/configuring-playbook-shared-secret-auth.md:5 msgid "" -"See that project's documentation to learn what it does and why it might " -"be useful to you." +"See the project's [documentation](https://github.com/devture/matrix-" +"synapse-shared-secret-auth/blob/master/README.md) to learn what it does " +"and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-shared-secret-auth.md:7 @@ -86,3 +87,9 @@ msgid "" "these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" +#~ msgid "" +#~ "See that project's documentation to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-sygnal.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-sygnal.po index 258e8279d..81646fa21 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-sygnal.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-sygnal.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -32,8 +32,9 @@ msgstr "" #: ../../../docs/configuring-playbook-sygnal.md:5 msgid "" -"See the project's [documentation](https://github.com/matrix-org/sygnal) " -"to learn what it does and why it might be useful to you." +"See the project's [documentation](https://github.com/matrix-" +"org/sygnal/blob/master/README.md) to learn what it does and why it might " +"be useful to you." msgstr "" #: ../../../docs/configuring-playbook-sygnal.md:7 @@ -199,3 +200,10 @@ msgid "" "/matrix-org/sygnal/blob/master/docs/applications.md) document." msgstr "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/matrix-org/sygnal) to learn what it " +#~ "does and why it might be useful" +#~ " to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po index acd1713e0..bf5494b8b 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -33,15 +33,20 @@ msgstr "" #: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:5 msgid "" -"See that project's [documentation](https://github.com/matrix-org/synapse-" -"auto-accept-invite) to learn what it does and why it might be useful to " -"you. In short, it automatically accepts room invites. You can specify " -"that only 1:1 room invites are auto-accepted. Defaults to false if not " +"In short, it automatically accepts room invites. You can specify that " +"only 1:1 room invites are auto-accepted. Defaults to false if not " "specified." msgstr "" #: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:7 msgid "" +"See the project's [documentation](https://github.com/matrix-org/synapse-" +"auto-accept-invite/blob/main/README.md) to learn what it does and why it " +"might be useful to you." +msgstr "" + +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:9 +msgid "" "**Note**: Synapse [v1.109.0](https://github.com/element-" "hq/synapse/releases/tag/v1.109.0), the same feature [has been " "merged](https://github.com/element-hq/synapse/pull/17147) into Synapse " @@ -51,11 +56,11 @@ msgid "" "party module." msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:9 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:11 msgid "Configuration" msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:11 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:13 msgid "" "If you decide that you'd like to let this playbook install the [synapse-" "auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-" @@ -63,11 +68,11 @@ msgid "" "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:19 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:21 msgid "Synapse worker deployments" msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:21 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:23 msgid "" "In a [workerized Synapse deployment](https://github.com/spantaleev" "/matrix-docker-ansible-" @@ -77,17 +82,17 @@ msgid "" "is `null`). For example, add this to your configuration:" msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:27 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:29 msgid "" "There might be an [issue with federation](https://github.com/matrix-org" "/synapse-auto-accept-invite/issues/18)." msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:29 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:31 msgid "Native alternative" msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:31 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:33 msgid "" "Since Synapse [v1.109.0](https://github.com/element-" "hq/synapse/releases/tag/v1.109.0), the functionality provided by the " @@ -96,7 +101,19 @@ msgid "" "/element-hq/synapse/pull/17147) part of Synapse." msgstr "" -#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:33 +#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:35 msgid "Here's example configuration for using the **native** Synapse feature:" msgstr "" +#~ msgid "" +#~ "See that project's " +#~ "[documentation](https://github.com/matrix-org/synapse-" +#~ "auto-accept-invite) to learn what it" +#~ " does and why it might be " +#~ "useful to you. In short, it " +#~ "automatically accepts room invites. You " +#~ "can specify that only 1:1 room " +#~ "invites are auto-accepted. Defaults to" +#~ " false if not specified." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po index a7359c3c0..cb5655ca9 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -40,8 +40,9 @@ msgstr "" #: ../../../docs/configuring-playbook-synapse-auto-compressor.md:7 msgid "" "See the project's [documentation](https://github.com/matrix-org/rust-" -"synapse-compress-state/#automated-tool-synapse_auto_compressor) to learn " -"what it does and why it might be useful to you." +"synapse-compress-state/blob/master/README.md#automated-tool-" +"synapse_auto_compressor) to learn what it does and why it might be useful" +" to you." msgstr "" #: ../../../docs/configuring-playbook-synapse-auto-compressor.md:9 @@ -106,3 +107,11 @@ msgid "" "unstable." msgstr "" +#~ msgid "" +#~ "See the project's [documentation](https://github.com" +#~ "/matrix-org/rust-synapse-compress-state" +#~ "/#automated-tool-synapse_auto_compressor) to " +#~ "learn what it does and why it " +#~ "might be useful to you." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po index 2e0c82766..6803bc2ba 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -32,20 +32,35 @@ msgstr "" #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:5 msgid "" -"See that project's documentation to learn what it does and why it might " -"be useful to you. In short, it lets you fight invite-spam by " -"automatically blocking invitiations from a list of servers specified by " -"you (blacklisting)." +"It lets you fight invite-spam by automatically blocking invitiations from" +" a list of servers specified by you (blacklisting)." msgstr "" #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:7 -msgid "Adjusting the playbook configuration" +msgid "" +"See the project's [documentation](https://github.com/t2bot/synapse-" +"simple-antispam/blob/master/README.md) to learn what it does and why it " +"might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:9 +msgid "Adjusting the playbook configuration" +msgstr "" + +#: ../../../docs/configuring-playbook-synapse-simple-antispam.md:11 msgid "" "Add the following configuration to your " "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your " "needs):" msgstr "" +#~ msgid "" +#~ "See that project's documentation to " +#~ "learn what it does and why it " +#~ "might be useful to you. In short," +#~ " it lets you fight invite-spam " +#~ "by automatically blocking invitiations from" +#~ " a list of servers specified by " +#~ "you (blacklisting)." +#~ msgstr "" + diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po index ddb720e35..d33faf33d 100644 --- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po +++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-16 12:05+0900\n" +"POT-Creation-Date: 2024-12-20 09:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -237,71 +237,71 @@ msgstr "" #: ../../../docs/configuring-playbook-user-verification-service.md:90 msgid "" -"After these variables have been set, run the playbook with [playbook tags" -"](playbook-tags.md) as below to restart UVS:" +"After configuring the playbook, run it with [playbook tags](playbook-" +"tags.md) as below:" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:96 +#: ../../../docs/configuring-playbook-user-verification-service.md:97 msgid "" "The shortcut commands with the [`just` program](just.md) are also " -"available: `just run-tags setup-matrix-user-verification-service,start` " -"or `just setup-all`" +"available: `just install-service matrix-user-verification-service` or " +"`just setup-all`" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:98 +#: ../../../docs/configuring-playbook-user-verification-service.md:99 msgid "" -"`just run-tags setup-matrix-user-verification-service,start` 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." +"`just install-service matrix-user-verification-service` 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-user-verification-service.md:100 +#: ../../../docs/configuring-playbook-user-verification-service.md:101 msgid "Logging" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:102 +#: ../../../docs/configuring-playbook-user-verification-service.md:103 msgid "The configuration variable `UVS_LOG_LEVEL` can be set to:" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:103 +#: ../../../docs/configuring-playbook-user-verification-service.md:104 msgid "warning" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:104 +#: ../../../docs/configuring-playbook-user-verification-service.md:105 msgid "info" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:105 +#: ../../../docs/configuring-playbook-user-verification-service.md:106 msgid "debug" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:107 +#: ../../../docs/configuring-playbook-user-verification-service.md:108 msgid "TLS Certificate Checking" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:109 +#: ../../../docs/configuring-playbook-user-verification-service.md:110 msgid "" "If the Matrix Homeserver does not provide a valid TLS certificate, UVS " "will fail with the following error message:" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:111 +#: ../../../docs/configuring-playbook-user-verification-service.md:112 msgid "message: 'No response received: [object Object]'," msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:113 +#: ../../../docs/configuring-playbook-user-verification-service.md:114 msgid "This also applies to self-signed and let's encrypt staging certificates." msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:115 +#: ../../../docs/configuring-playbook-user-verification-service.md:116 msgid "" "To disable certificate validation altogether (INSECURE! Not suitable for " "production use!) set: `NODE_TLS_REJECT_UNAUTHORIZED=0`" msgstr "" -#: ../../../docs/configuring-playbook-user-verification-service.md:117 +#: ../../../docs/configuring-playbook-user-verification-service.md:118 msgid "" "Alternatively, it is possible to inject your own CA certificates into the" " container by mounting a PEM file with additional trusted CAs into the " @@ -309,3 +309,31 @@ msgid "" "it." msgstr "" +#~ msgid "" +#~ "After these variables have been set, " +#~ "run the playbook with [playbook tags" +#~ "](playbook-tags.md) as below to restart " +#~ "UVS:" +#~ msgstr "" + +#~ msgid "" +#~ "The shortcut commands with the [`just`" +#~ " program](just.md) are also available: " +#~ "`just run-tags setup-matrix-user-" +#~ "verification-service,start` or `just setup-" +#~ "all`" +#~ msgstr "" + +#~ msgid "" +#~ "`just run-tags setup-matrix-user-" +#~ "verification-service,start` 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 "" +