# SOME DESCRIPTIVE TITLE. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community # members # This file is distributed under the same license as the # matrix-docker-ansible-deploy package. # FIRST AUTHOR , 2024. # #, fuzzy 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" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" "Language-Team: jp \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.16.0\n" #: ../../../docs/configuring-playbook-dimension.md:1 msgid "Setting up Dimension integration manager (optional, unmaintained)" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:3 msgid "" "**[Dimension](https://dimension.t2bot.io) can only be installed after " "Matrix services are installed and running.** If you're just installing " "Matrix services for the first time, please continue with the " "[Configuration](configuring-playbook.md) / [Installation](installing.md) " "flow and come back here later." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:5 msgid "" "**Note**: Dimension is **[officially " "unmaintained](https://github.com/spantaleev/matrix-docker-ansible-" "deploy/issues/2806#issuecomment-1673559299)**. We recommend not bothering" " with installing it." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:7 msgid "" "**Note**: This playbook now supports running " "[Dimension](https://dimension.t2bot.io) in both a federated and " "[unfederated](https://github.com/turt2live/matrix-" "dimension/blob/master/docs/unfederated.md) environments. This is handled " "automatically based on the value of " "`matrix_homeserver_federation_enabled`. Enabling Dimension, means that " "the `openid` API endpoints will be exposed on the Matrix Federation port " "(usually `8448`), even if [federation](configuring-playbook-" "federation.md) is disabled. It's something to be aware of, especially in " "terms of firewall whitelisting (make sure port `8448` is accessible)." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:9 msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:11 msgid "" "To enable Dimension, add this to your configuration file " "(`inventory/host_vars/matrix.example.com/vars.yml`):" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:17 msgid "Define admin users" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:19 msgid "" "These users can modify the integrations this Dimension supports. Add this" " to your configuration file " "(`inventory/host_vars/matrix.example.com/vars.yml`):" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:27 msgid "" "The admin interface is accessible within Element Web by accessing it in " "any room and clicking the cog wheel/settings icon in the top right. " "Currently, Dimension can be opened in Element Web by the \"Add widgets, " "bridges, & bots\" link in the room information." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:29 msgid "Access token" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:31 msgid "" "We recommend that you create a dedicated Matrix user for Dimension " "(`dimension` is a good username). Follow our [Registering users" "](registering-users.md) guide to learn how to register **a regular (non-" "admin) user**." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:33 msgid "" "You are required to specify an access token (belonging to this new user) " "for Dimension to work. To get an access token for the Dimension user, you" " can follow the documentation on [how to do obtain an access token" "](obtaining-access-tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:35 msgid "" "**Access tokens are sensitive information. Do not include them in any bug" " reports, messages, or logs. Do not share the access token with anyone.**" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:37 msgid "" "Add access token to your configuration file " "(`inventory/host_vars/matrix.example.com/vars.yml`):" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:43 msgid "" "For more information on how to acquire an access token, visit " "[https://t2bot.io/docs/access_tokens](https://t2bot.io/docs/access_tokens)." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:45 msgid "Adjusting the Dimension URL" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:47 msgid "" "By default, this playbook installs Dimension on the `dimension.` " "subdomain (`dimension.example.com`) and requires you to [adjust your DNS " "records](#adjusting-dns-records)." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:49 msgid "" "By tweaking the `matrix_dimension_hostname` and " "`matrix_dimension_path_prefix` variables, you can easily make the service" " available at a **different hostname and/or path** than the default one." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:51 msgid "" "Example additional configuration for your " "`inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:62 msgid "" "**Note**: While there is a `matrix_dimension_path_prefix` variable for " "changing the path where Dimension is served, overriding it is not " "possible due to [this Dimension issue](https://github.com/turt2live" "/matrix-dimension/issues/510). You must serve Dimension at a dedicated " "subdomain." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:64 msgid "Adjusting DNS records" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:66 msgid "" "Once you've decided on the domain and path, **you may need to adjust your" " DNS** records to point the Dimension domain to the Matrix server." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:68 msgid "" "By default, you will need to create a CNAME record for `dimension`. See " "[Configuring DNS](configuring-dns.md) for details about DNS changes." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:70 msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:72 msgid "" "After configuring the playbook and potentially [adjusting your DNS " "records](#adjusting-dns-records), run the playbook with [playbook tags" "](playbook-tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:79 msgid "**Notes**:" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:81 msgid "" "The shortcut commands with the [`just` program](just.md) are also " "available: `just install-all` or `just setup-all`" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:83 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" "runtime) than `just setup-all`) when its components remain unchanged. If " "you adjust your `vars.yml` to remove other components, you'd need to run " "`just setup-all`, or these components will still remain installed. Note " "these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:85 msgid "" "After Dimension has been installed you may need to log out and log back " "in for it to pick up the new integration manager. Then you can access " "integrations in Element Web by opening a room, clicking the Room info " "button (`i`) button in the top right corner of the screen, and then " "clicking Add widgets, bridges & bots." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:87 msgid "Jitsi domain" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:89 msgid "" "By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as " "the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video " "conference widgets. For users running [a self-hosted Jitsi instance" "](./configuring-playbook-jitsi.md), you will likely want the widget to " "use your own Jitsi instance. Currently there is no way to configure this " "via the playbook, see [this issue](https://github.com/turt2live/matrix-" "dimension/issues/345) for details." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:91 msgid "" "In the interim until the above limitation is resolved, an admin user " "needs to configure the domain via the admin ui once dimension is running." " In Element Web, go to *Manage Integrations* → *Settings* " "→ *Widgets* → *Jitsi Conference Settings* and set " "*Jitsi Domain* and *Jitsi Script URL* appropriately." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:93 msgid "Additional features" msgstr "" #: ../../../docs/configuring-playbook-dimension.md:95 msgid "" "To use a more custom configuration, you can define a " "`matrix_dimension_configuration_extension_yaml` string variable and put " "your configuration in it. To learn more about how to do this, refer to " "the information about `matrix_dimension_configuration_extension_yaml` in " "the [default variables file](../roles/custom/matrix-" "dimension/defaults/main.yml) of the Dimension component." msgstr "" #: ../../../docs/configuring-playbook-dimension.md:97 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 ""