Sync i18n with recent changes
This commit is contained in:
Slavi Pantaleev
@ -1,5 +1,5 @@
|
||||
# SOME DESCRIPTIVE TITLE.
|
||||
# Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community members
|
||||
# Copyright (C) 2018-2025, Slavi Pantaleev, Aine Etke, MDAD community members
|
||||
# This file is distributed under the same license as the matrix-docker-ansible-deploy package.
|
||||
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
||||
#
|
||||
@ -8,7 +8,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2024-12-28 10:25+0200\n"
|
||||
"POT-Creation-Date: 2025-01-27 09:54+0200\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
@ -21,7 +21,7 @@ msgid "Setting up Dimension integration manager (optional, unmaintained)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:3
|
||||
#: ../../../docs/configuring-playbook-dimension.md:91
|
||||
#: ../../../docs/configuring-playbook-dimension.md:109
|
||||
msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
@ -30,7 +30,7 @@ msgid "Dimension is **[officially unmaintained](https://github.com/spantaleev/ma
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:5
|
||||
msgid "This playbook now supports running Dimension in both a federated and [unfederated](https://github.com/turt2live/matrix-dimension/blob/master/docs/unfederated.md) environments. This is handled automatically based on the value of `matrix_homeserver_federation_enabled`. Enabling Dimension, means that the `openid` API endpoints will be exposed on the Matrix Federation port (usually `8448`), even if [federation](configuring-playbook-federation.md) is disabled. It's something to be aware of, especially in terms of firewall whitelisting (make sure port `8448` is accessible)."
|
||||
msgid "This playbook now supports running Dimension in both a federated and [unfederated](https://github.com/turt2live/matrix-dimension/blob/master/docs/unfederated.md) environments. This is handled automatically based on the value of `matrix_homeserver_federation_enabled`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:7
|
||||
@ -46,133 +46,165 @@ msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:13
|
||||
msgid "Install Matrix services"
|
||||
msgid "Open Matrix Federation port"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:15
|
||||
msgid "Dimension can only be installed after Matrix services are installed and running. If you're just installing Matrix services for the first time, please continue with the [Configuration](configuring-playbook.md) / [Installation](installing.md) and come back here later."
|
||||
msgid "Enabling the Dimension service will automatically reconfigure your Synapse homeserver to expose the `openid` API endpoints on the Matrix Federation port (usually `8448`), even if [federation](configuring-playbook-federation.md) is disabled. If you enable the component, make sure that the port is accessible."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:17
|
||||
msgid "Register a dedicated Matrix user (optional, recommended)"
|
||||
msgid "Install Matrix services"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:19
|
||||
msgid "We recommend that you create a dedicated Matrix user for Dimension (`dimension` is a good username)."
|
||||
msgid "Dimension can only be installed after Matrix services are installed and running. If you're just installing Matrix services for the first time, please continue with the [Configuration](configuring-playbook.md) / [Installation](installing.md) and come back here later."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:21
|
||||
msgid "Generate a strong password for the user. You can create one with a command like `pwgen -s 64 1`."
|
||||
msgid "Register a dedicated Matrix user (optional, recommended)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:23
|
||||
msgid "We recommend that you create a dedicated Matrix user for Dimension (`dimension` is a good username)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:25
|
||||
msgid "Generate a strong password for the user. You can create one with a command like `pwgen -s 64 1`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:27
|
||||
msgid "You can use the playbook to [register a new user](registering-users.md):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:29
|
||||
#: ../../../docs/configuring-playbook-dimension.md:33
|
||||
msgid "Obtain an access token"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:31
|
||||
#: ../../../docs/configuring-playbook-dimension.md:35
|
||||
msgid "Dimension requires an access token to be able to connect to your homeserver. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:33
|
||||
msgid "⚠️ **Warning**: Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:35
|
||||
msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:37
|
||||
msgid "To enable Dimension, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`). Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)."
|
||||
msgid "[!WARNING] Access tokens are sensitive information. Do not include them in any bug reports, messages, or logs. Do not share the access token with anyone."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:45
|
||||
msgid "Define admin users"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:47
|
||||
msgid "These users can modify the integrations this Dimension supports. Add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:55
|
||||
msgid "The admin interface is accessible within Element Web by accessing it in any room and clicking the cog wheel/settings icon in the top right. Currently, Dimension can be opened in Element Web by the \"Add widgets, bridges, & bots\" link in the room information."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:57
|
||||
msgid "Adjusting the Dimension URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:59
|
||||
msgid "By default, this playbook installs Dimension on the `dimension.` subdomain (`dimension.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:61
|
||||
msgid "By tweaking the `matrix_dimension_hostname` and `matrix_dimension_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:63
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:74
|
||||
msgid "**Note**: While there is a `matrix_dimension_path_prefix` variable for changing the path where Dimension is served, overriding it is not possible due to [this Dimension issue](https://github.com/turt2live/matrix-dimension/issues/510). You must serve Dimension at a dedicated subdomain."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:76
|
||||
#: ../../../docs/configuring-playbook-dimension.md:40
|
||||
msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:78
|
||||
msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Dimension domain to the Matrix server."
|
||||
#: ../../../docs/configuring-playbook-dimension.md:42
|
||||
msgid "By default, this playbook installs Dimension on the `dimension.` subdomain (`dimension.example.com`) and requires you to create a CNAME record for `dimension`, which targets `matrix.example.com`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:80
|
||||
msgid "By default, you will need to create a CNAME record for `dimension`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
#: ../../../docs/configuring-playbook-dimension.md:44
|
||||
msgid "When setting, replace `example.com` with your own."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:82
|
||||
msgid "Installing"
|
||||
#: ../../../docs/configuring-playbook-dimension.md:46
|
||||
msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:84
|
||||
msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:"
|
||||
#: ../../../docs/configuring-playbook-dimension.md:48
|
||||
msgid "To enable Dimension, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to replace `ACCESS_TOKEN_HERE` with the one created [above](#obtain-an-access-token)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:56
|
||||
msgid "Define admin users"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:58
|
||||
msgid "To define admin users who can modify the integrations this Dimension supports, add the following configuration to your `vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:66
|
||||
msgid "The admin interface is accessible within Element Web by accessing it in any room and clicking the cog wheel/settings icon in the top right. Currently, Dimension can be opened in Element Web by the \"Add widgets, bridges, & bots\" link in the room information."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:68
|
||||
msgid "Adjusting the Dimension URL (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:70
|
||||
msgid "By tweaking the `matrix_dimension_hostname` and `matrix_dimension_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:72
|
||||
msgid "Example additional configuration for your `vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:83
|
||||
msgid "After changing the domain, **you may need to adjust your DNS** records to point the Dimension domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:85
|
||||
msgid "If you've decided to reuse the `matrix.` domain, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:87
|
||||
msgid "**Note**: while there is a `matrix_dimension_path_prefix` variable for changing the path where Dimension is served, overriding it is not possible due to [this Dimension issue](https://github.com/turt2live/matrix-dimension/issues/510). You'd need to serve Dimension at a dedicated subdomain."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:89
|
||||
msgid "Extending the configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:91
|
||||
msgid "There are some additional things you may wish to configure about the component."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:93
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgid "Take a look at:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:95
|
||||
msgid "`roles/custom/matrix-dimension/defaults/main.yml` for some variables that you can customize via your `vars.yml` file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:96
|
||||
msgid "`roles/custom/matrix-dimension/templates/config.yaml.j2` for the component's default configuration. You can override settings (even those that don't have dedicated playbook variables) using the `matrix_dimension_configuration_extension_yaml` variable"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:98
|
||||
msgid "You can find all configuration options on [GitHub page of Dimension project](https://github.com/turt2live/matrix-dimension/blob/master/config/default.yaml)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:100
|
||||
msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:102
|
||||
msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:111
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:113
|
||||
msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed. Note these shortcuts run the `ensure-matrix-users-created` tag too."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:97
|
||||
msgid "After Dimension has been installed you may need to log out and log back in for it to pick up the new integration manager. Then you can access integrations in Element Web by opening a room, clicking the Room info button (`i`) button in the top right corner of the screen, and then clicking Add widgets, bridges & bots."
|
||||
#: ../../../docs/configuring-playbook-dimension.md:115
|
||||
msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:99
|
||||
msgid "Jitsi domain"
|
||||
#: ../../../docs/configuring-playbook-dimension.md:117
|
||||
msgid "After Dimension has been installed you may need to log out and log back in for it to pick up the new integration manager. Then you can access integrations in Element Web by opening a room, clicking the room info button (`i`) on the top right corner, and then clicking the \"Add widgets, bridges, & bots\" link."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:101
|
||||
msgid "By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video conference widgets. For users running [a self-hosted Jitsi instance](./configuring-playbook-jitsi.md), you will likely want the widget to use your own Jitsi instance. Currently there is no way to configure this via the playbook, see [this issue](https://github.com/turt2live/matrix-dimension/issues/345) for details."
|
||||
#: ../../../docs/configuring-playbook-dimension.md:119
|
||||
msgid "Set up a Jitsi widget"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:103
|
||||
msgid "In the interim until the above limitation is resolved, an admin user needs to configure the domain via the admin ui once dimension is running. In Element Web, go to *Manage Integrations* → *Settings* → *Widgets* → *Jitsi Conference Settings* and set *Jitsi Domain* and *Jitsi Script URL* appropriately."
|
||||
#: ../../../docs/configuring-playbook-dimension.md:121
|
||||
msgid "By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video conference widgets. For users running [a self-hosted Jitsi instance](configuring-playbook-jitsi.md), you will likely want the widget to use your own Jitsi instance."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:105
|
||||
msgid "Additional features"
|
||||
#: ../../../docs/configuring-playbook-dimension.md:123
|
||||
msgid "To set up the widget, an admin user needs to configure the domain via the admin UI once Dimension is running. In Element Web, go to *Manage Integrations* → *Settings* → *Widgets* → *Jitsi Conference Settings* and set *Jitsi Domain* and *Jitsi Script URL* appropriately."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:107
|
||||
msgid "To use a more custom configuration, you can define a `matrix_dimension_configuration_extension_yaml` string variable and put your configuration in it. To learn more about how to do this, refer to the information about `matrix_dimension_configuration_extension_yaml` in the [default variables file](../roles/custom/matrix-dimension/defaults/main.yml) of the Dimension component."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dimension.md:109
|
||||
msgid "You can find all configuration options on [GitHub page of Dimension project](https://github.com/turt2live/matrix-dimension/blob/master/config/default.yaml)."
|
||||
#: ../../../docs/configuring-playbook-dimension.md:125
|
||||
msgid "There is unfortunately no way to configure the widget via the playbook. See [this issue](https://github.com/turt2live/matrix-dimension/issues/345) for details."
|
||||
msgstr ""
|
||||
|
||||
Reference in New Issue
Block a user