mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-24 05:25:56 +00:00
236 lines
8.5 KiB
Plaintext
236 lines
8.5 KiB
Plaintext
|
# 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 <EMAIL@ADDRESS>, 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 <EMAIL@ADDRESS>\n"
|
||
|
|
"Language: jp\n"
|
||
|
|
"Language-Team: jp <LL@li.org>\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-client-element-web.md:1
|
||
|
|
msgid "Configuring Element Web (optional)"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:3
|
||
|
|
msgid ""
|
||
|
|
"By default, this playbook installs the [Element Web](https://github.com"
|
||
|
|
"/element-hq/element-web) Matrix client for you. If that's okay, you can "
|
||
|
|
"skip this document."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:5
|
||
|
|
msgid ""
|
||
|
|
"💡 **Note**: the latest version of Element Web is also available on the "
|
||
|
|
"web, hosted by 3rd parties. If you trust giving your credentials to the "
|
||
|
|
"following 3rd party Single Page Applications, you can consider using it "
|
||
|
|
"from there and avoiding the (small) overhead of self-hosting (by "
|
||
|
|
"[disabling Element Web](#disabling-element-web)):"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:7
|
||
|
|
msgid ""
|
||
|
|
"[app.element.io](https://app.element.io/), hosted by "
|
||
|
|
"[Element](https://element.io/)"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:8
|
||
|
|
msgid "[app.etke.cc](https://app.etke.cc/), hosted by [etke.cc](https://etke.cc/)"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:10
|
||
|
|
msgid "Disabling Element Web"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:12
|
||
|
|
msgid ""
|
||
|
|
"If you'd like for the playbook to not install Element Web (or to "
|
||
|
|
"uninstall it if it was previously installed), add the following "
|
||
|
|
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||
|
|
"file:"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:18
|
||
|
|
msgid "Adjusting the playbook configuration"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:20
|
||
|
|
msgid ""
|
||
|
|
"The playbook provides some customization variables you could use to "
|
||
|
|
"change Element Web's settings."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:22
|
||
|
|
msgid ""
|
||
|
|
"Their defaults are defined in [`roles/custom/matrix-client-"
|
||
|
|
"element/defaults/main.yml`](../roles/custom/matrix-client-"
|
||
|
|
"element/defaults/main.yml) and they ultimately end up in the generated "
|
||
|
|
"`/matrix/element/config.json` file (on the server). This file is "
|
||
|
|
"generated from the [`roles/custom/matrix-client-"
|
||
|
|
"element/templates/config.json.j2`](../roles/custom/matrix-client-"
|
||
|
|
"element/templates/config.json.j2) template."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:24
|
||
|
|
msgid ""
|
||
|
|
"**If there's an existing variable** which controls a setting you wish to "
|
||
|
|
"change, you can simply define that variable in your configuration file "
|
||
|
|
"(`inventory/host_vars/matrix.example.com/vars.yml`) and [re-run the "
|
||
|
|
"playbook](installing.md) to apply the changes."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:26
|
||
|
|
msgid ""
|
||
|
|
"Alternatively, **if there is no pre-defined variable** for an Element Web"
|
||
|
|
" setting you wish to change:"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:28
|
||
|
|
msgid ""
|
||
|
|
"you can either **request a variable to be created** (or you can submit "
|
||
|
|
"such a contribution yourself). Keep in mind that it's **probably not a "
|
||
|
|
"good idea** to create variables for each one of Element Web's various "
|
||
|
|
"settings that rarely get used."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:30
|
||
|
|
msgid ""
|
||
|
|
"or, you can **extend and override the default configuration** "
|
||
|
|
"([`config.json.j2`](../roles/custom/matrix-client-"
|
||
|
|
"element/templates/config.json.j2)) by making use of the "
|
||
|
|
"`matrix_client_element_configuration_extension_json_` variable. You can "
|
||
|
|
"find information about this in [`roles/custom/matrix-client-"
|
||
|
|
"element/defaults/main.yml`](../roles/custom/matrix-client-"
|
||
|
|
"element/defaults/main.yml)."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:32
|
||
|
|
msgid ""
|
||
|
|
"or, if extending the configuration is still not powerful enough for your "
|
||
|
|
"needs, you can **override the configuration completely** using "
|
||
|
|
"`matrix_client_element_configuration_default` (or "
|
||
|
|
"`matrix_client_element_configuration`). You can find information about "
|
||
|
|
"this in [`roles/custom/matrix-client-"
|
||
|
|
"element/defaults/main.yml`](../roles/custom/matrix-client-"
|
||
|
|
"element/defaults/main.yml)."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:34
|
||
|
|
msgid "Themes"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:36
|
||
|
|
msgid ""
|
||
|
|
"To change the look of Element Web, you can define your own themes "
|
||
|
|
"manually by using the "
|
||
|
|
"`matrix_client_element_setting_defaults_custom_themes` setting."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:38
|
||
|
|
msgid ""
|
||
|
|
"Or better yet, you can automatically pull it all themes provided by the "
|
||
|
|
"[aaronraimist/element-themes](https://github.com/aaronraimist/element-"
|
||
|
|
"themes) project by simply flipping a flag "
|
||
|
|
"(`matrix_client_element_themes_enabled: true`)."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:40
|
||
|
|
msgid ""
|
||
|
|
"If you make your own theme, we encourage you to submit it to the "
|
||
|
|
"**aaronraimist/element-themes** project, so that the whole community "
|
||
|
|
"could easily enjoy it."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:42
|
||
|
|
msgid ""
|
||
|
|
"Note that for a custom theme to work well, all Element Web instances that"
|
||
|
|
" you use must have the same theme installed."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:44
|
||
|
|
msgid "Adjusting the Element Web URL"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:46
|
||
|
|
msgid ""
|
||
|
|
"By default, this playbook installs Element Web on the `element.` "
|
||
|
|
"subdomain (`element.example.com`) and requires you to [adjust your DNS "
|
||
|
|
"records](#adjusting-dns-records)."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:48
|
||
|
|
msgid ""
|
||
|
|
"By tweaking the `matrix_client_element_hostname` and "
|
||
|
|
"`matrix_client_element_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-client-element-web.md:50
|
||
|
|
msgid ""
|
||
|
|
"Example additional configuration for your "
|
||
|
|
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:61
|
||
|
|
msgid "Adjusting DNS records"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:63
|
||
|
|
msgid ""
|
||
|
|
"Once you've decided on the domain and path, **you may need to adjust your"
|
||
|
|
" DNS** records to point the Element Web domain to the Matrix server."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:65
|
||
|
|
msgid ""
|
||
|
|
"By default, you will need to create a CNAME record for `element`. See "
|
||
|
|
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:67
|
||
|
|
msgid ""
|
||
|
|
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
|
||
|
|
" extra DNS configuration."
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:69
|
||
|
|
msgid "Installing"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:71
|
||
|
|
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-client-element-web.md:78
|
||
|
|
msgid ""
|
||
|
|
"The shortcut commands with the [`just` program](just.md) are also "
|
||
|
|
"available: `just install-all` or `just setup-all`"
|
||
|
|
msgstr ""
|
||
|
|
|
||
|
|
#: ../../../docs/configuring-playbook-client-element-web.md:80
|
||
|
|
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 ""
|
||
|
|
|