ansol/matrix-docker-ansible-deploy
7
0
Fork 0
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy.git synced 2025-02-08 02:06:44 +00:00
Code Issues Projects Releases Wiki Activity
e5c5b3aa9f
matrix-docker-ansible-deploy/i18n/translation-templates/docs/configuring-playbook-turn.pot

134 lines
6.6 KiB
Plaintext
Raw Normal View History

Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
# SOME DESCRIPTIVE TITLE.
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
# Copyright (C) 2018-2025, Slavi Pantaleev, Aine Etke, MDAD community members
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
# This file is distributed under the same license as the matrix-docker-ansible-deploy package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: matrix-docker-ansible-deploy \n"
"Report-Msgid-Bugs-To: \n"
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
"POT-Creation-Date: 2025-01-27 09:54+0200\n"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../../docs/configuring-playbook-turn.md:1
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
msgid "Configuring a TURN server (optional, advanced)"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:3
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
msgid "By default, this playbook installs and configures the [coturn](https://github.com/coturn/coturn) as a TURN server, through which clients can make audio/video calls even from [NAT](https://en.wikipedia.org/wiki/Network_address_translation)-ed networks. It also configures the Synapse chat server by default, so that it points to the coturn TURN server installed by the playbook. If that's okay, you can skip this document."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:5
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
msgid "If you'd like to stop the playbook installing the server, see the section [below](#disabling-coturn) to check the configuration for disabling it."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:7
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
msgid "Adjusting the playbook configuration"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:9
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
msgid "Define public IP manually (optional)"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:11
msgid "In the `hosts` file we explicitly ask for your server's external IP address when defining `ansible_host`, because the same value is used for configuring coturn."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:13
msgid "If you'd rather use a local IP for `ansible_host`, add the following configuration to your `vars.yml` file. Make sure to replace `YOUR_PUBLIC_IP` with the pubic IP used by the server."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:19
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
msgid "If you'd like to rely on external IP address auto-detection (not recommended unless you need it), set an empty value to the variable. The playbook will automatically contact an [EchoIP](https://github.com/mpolden/echoip)-compatible service (`https://ifconfig.co/json` by default) to determine your server's IP address. This API endpoint is configurable via the `matrix_coturn_turn_external_ip_address_auto_detection_echoip_service_url` variable."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:21
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
msgid "If your server has multiple external IP addresses, the coturn role offers a different variable for specifying them:"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:28
msgid "Change the authentication mechanism (optional)"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:30
msgid "The playbook uses the [`auth-secret` authentication method](https://github.com/coturn/coturn/blob/873cabd6a2e5edd7e9cc5662cac3ffe47fe87a8e/README.turnserver#L186-L199) by default, but you may switch to the [`lt-cred-mech` method](https://github.com/coturn/coturn/blob/873cabd6a2e5edd7e9cc5662cac3ffe47fe87a8e/README.turnserver#L178) which [some report](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3191) to be working better."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:32
msgid "To do so, add the following configuration to your `vars.yml` file:"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:38
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
msgid "Regardless of the selected authentication method, the playbook generates secrets automatically and passes them to the homeserver and coturn."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:40
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
msgid "If [Jitsi](configuring-playbook-jitsi.md) is installed, note that switching to `lt-cred-mech` will disable the integration between Jitsi and your coturn server, as Jitsi seems to support the `auth-secret` authentication method only."
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:42
msgid "Use your own external coturn server (optional)"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:44
msgid "If you'd like to use another TURN server (be it coturn or some other one), add the following configuration to your `vars.yml` file. Make sure to replace `HOSTNAME_OR_IP` with your own."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:58
msgid "If you have or want to enable Jitsi, you might want to enable the TURN server there too. If you do not do it, Jitsi will fall back to an upstream service."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:65
msgid "You can put multiple host/port combinations if you'd like to."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:67
msgid "Extending the configuration"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:69
msgid "There are some additional things you may wish to configure about the TURN server."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:71
msgid "Take a look at:"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
#: ../../../docs/configuring-playbook-turn.md:73
msgid "`roles/custom/matrix-coturn/defaults/main.yml` for some variables that you can customize via your `vars.yml` file"
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:75
Sync i18n with recent changes
2025-01-27 07:56:21 +00:00
msgid "Disabling coturn"
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:77
msgid "If, for some reason, you'd like for the playbook to not install coturn (or to uninstall it if it was previously installed), add the following configuration to your `vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:83
msgid "In that case, Synapse would not point to any coturn servers and audio/video call functionality may fail."
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:85
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:87
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:94
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-turn.md:96
msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too."
Initial work on translations / localization Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2024-12-20 07:37:38 +00:00
msgstr ""
Reference in New Issue Copy Permalink