mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2025-01-14 04:07:19 +01:00
Use msgcat to avoid word-wrapping in .po files
This commit is contained in:
Slavi Pantaleev
parent
36429d8bd3
commit
71e5f1103d
@ -32,3 +32,11 @@ sphinx-intl update \
|
||||
--pot-dir ${base_path}/i18n/translation-templates \
|
||||
--locale-dir ${base_path}/i18n/locales \
|
||||
--language ${LANGUAGE}
|
||||
|
||||
# Post-process all .po files to remove word-wrapping.
|
||||
#
|
||||
# Tools for editing .po files like Poedit don't use word-wrapping,
|
||||
# and us not using word-wrapping here means diffs can be smaller.
|
||||
for po_file in $(find ${base_path}/i18n/locales -name '*.po'); do
|
||||
msgcat --no-wrap -o "$po_file" "$po_file"
|
||||
done
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -8,34 +8,23 @@
|
||||
#, 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-20 09:53+0200\n"
|
||||
"PO-Revision-Date: 2024-12-20 09:52+0200\n"
|
||||
"PO-Revision-Date: 2024-12-20 14:33+0200\n"
|
||||
"Last-Translator: \n"
|
||||
"Language: bg\n"
|
||||
"Language-Team: bg <LL@li.org>\n"
|
||||
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
|
||||
"Language: bg\n"
|
||||
"MIME-Version: 1.0\n"
|
||||
"Content-Type: text/plain; charset=utf-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
|
||||
"Generated-By: Babel 2.16.0\n"
|
||||
"X-Generator: Poedit 3.4.2\n"
|
||||
|
||||
#: ../../../README.md:1
|
||||
msgid ""
|
||||
"[![Support room on 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) "
|
||||
"[](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) "
|
||||
"[](https://liberapay.com/s.pantaleev/donate)"
|
||||
msgid "[](https://matrix.to/#/#matrix-docker-ansible-deploy:devture.com) [](https://liberapay.com/s.pantaleev/donate)"
|
||||
msgstr "[](https://matrix.to/#/#matrix-docker-ansible-deploy:devture.com) [](https://liberapay.com/s.pantaleev/donate)"
|
||||
|
||||
#: ../../../README.md:1
|
||||
msgid "Support room on Matrix"
|
||||
@ -46,9 +35,7 @@ msgid "donate"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:3
|
||||
msgid ""
|
||||
"Matrix (An open network for secure, decentralized communication) server "
|
||||
"setup using Ansible and Docker"
|
||||
msgid "Matrix (An open network for secure, decentralized communication) server setup using Ansible and Docker"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:5
|
||||
@ -56,38 +43,19 @@ msgid "🎯 Purpose"
|
||||
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), свързани с "
|
||||
"това."
|
||||
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), свързани с това."
|
||||
|
||||
#: ../../../README.md:9
|
||||
msgid ""
|
||||
"That is, it lets you join the Matrix network using your own user ID like "
|
||||
"`@alice:example.com`, all hosted on your own server (see "
|
||||
"[prerequisites](docs/prerequisites.md))."
|
||||
msgid "That is, it lets you join the Matrix network using your own user ID like `@alice:example.com`, all hosted on your own server (see [prerequisites](docs/prerequisites.md))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:11
|
||||
msgid ""
|
||||
"We run all [supported services](#-supported-services) in "
|
||||
"[Docker](https://www.docker.com/) containers (see [the container images "
|
||||
"we use](docs/container-images.md)), which lets us have a predictable and "
|
||||
"up-to-date setup, across multiple supported distros (see "
|
||||
"[prerequisites](docs/prerequisites.md)) and [architectures](docs"
|
||||
"/alternative-architectures.md) (x86/amd64 being recommended)."
|
||||
msgid "We run all [supported services](#-supported-services) in [Docker](https://www.docker.com/) containers (see [the container images we use](docs/container-images.md)), which lets us have a predictable and up-to-date setup, across multiple supported distros (see [prerequisites](docs/prerequisites.md)) and [architectures](docs/alternative-architectures.md) (x86/amd64 being recommended)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:13
|
||||
msgid ""
|
||||
"Installation (upgrades) and some maintenance tasks are automated using "
|
||||
"[Ansible](https://www.ansible.com/) (see [our Ansible "
|
||||
"guide](docs/ansible.md))."
|
||||
msgid "Installation (upgrades) and some maintenance tasks are automated using [Ansible](https://www.ansible.com/) (see [our Ansible guide](docs/ansible.md))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:15
|
||||
@ -95,27 +63,11 @@ msgid "☁ Self-hosting or Managed / SaaS"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:17
|
||||
msgid ""
|
||||
"This Ansible playbook tries to make self-hosting and maintaining a Matrix"
|
||||
" server fairly easy (see [Getting started](#-getting-started)). Still, "
|
||||
"running any service smoothly requires knowledge, time and effort."
|
||||
msgid "This Ansible playbook tries to make self-hosting and maintaining a Matrix server fairly easy (see [Getting started](#-getting-started)). Still, running any service smoothly requires knowledge, time and effort."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:19
|
||||
msgid ""
|
||||
"If you like the [FOSS](https://en.wikipedia.org/wiki/Free_and_open-"
|
||||
"source_software) spirit of this Ansible playbook, but prefer to put the "
|
||||
"responsibility on someone else, you can also [get a managed Matrix server"
|
||||
" from "
|
||||
"etke.cc](https://etke.cc?utm_source=github&utm_medium=readme&utm_campaign=mdad)"
|
||||
" (both hosting and on-premises) - a service built on top of this Ansible "
|
||||
"playbook but with [additional "
|
||||
"components](https://etke.cc/help/extras/?utm_source=github&utm_medium=readme&utm_campaign=mdad)"
|
||||
" and "
|
||||
"[services](https://etke.cc/services/?utm_source=github&utm_medium=readme&utm_campaign=mdad)"
|
||||
" which all help you run a Matrix server with ease. Be advised that "
|
||||
"etke.cc operates on a subscription-based approach and there is no \"just "
|
||||
"set up my server once and be done with it\" option."
|
||||
msgid "If you like the [FOSS](https://en.wikipedia.org/wiki/Free_and_open-source_software) spirit of this Ansible playbook, but prefer to put the responsibility on someone else, you can also [get a managed Matrix server from etke.cc](https://etke.cc?utm_source=github&utm_medium=readme&utm_campaign=mdad) (both hosting and on-premises) - a service built on top of this Ansible playbook but with [additional components](https://etke.cc/help/extras/?utm_source=github&utm_medium=readme&utm_campaign=mdad) and [services](https://etke.cc/services/?utm_source=github&utm_medium=readme&utm_campaign=mdad) which all help you run a Matrix server with ease. Be advised that etke.cc operates on a subscription-based approach and there is no \"just set up my server once and be done with it\" option."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:21
|
||||
@ -123,51 +75,31 @@ msgid "🚀 Getting started"
|
||||
msgstr "🚀 Стартиране"
|
||||
|
||||
#: ../../../README.md:23
|
||||
msgid ""
|
||||
"We have detailed documentation in the [docs/](./docs) directory - see the"
|
||||
" Table of Contents in the [documentation README](./docs/README.md)."
|
||||
msgid "We have detailed documentation in the [docs/](./docs) directory - see the Table of Contents in the [documentation README](./docs/README.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:25
|
||||
msgid ""
|
||||
"While the [list of supported services](#-supported-services) and "
|
||||
"documentation is very extensive, you don't need to read through "
|
||||
"everything. We recommend:"
|
||||
msgid "While the [list of supported services](#-supported-services) and documentation is very extensive, you don't need to read through everything. We recommend:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:27
|
||||
msgid ""
|
||||
"Starting with the basics. You can always add/remove or tweak services "
|
||||
"later on."
|
||||
msgid "Starting with the basics. You can always add/remove or tweak services later on."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:29
|
||||
msgid ""
|
||||
"Following our installation guide. There are two guides available for "
|
||||
"beginners and advanced users:"
|
||||
msgid "Following our installation guide. There are two guides available for beginners and advanced users:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:31
|
||||
msgid ""
|
||||
"⚡ **[Quick start](./docs/quick-start.md) (for beginners)**: this is "
|
||||
"recommended for those who do not have an existing Matrix server and want "
|
||||
"to start quickly with \"opinionated defaults\"."
|
||||
msgid "⚡ **[Quick start](./docs/quick-start.md) (for beginners)**: this is recommended for those who do not have an existing Matrix server and want to start quickly with \"opinionated defaults\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:33
|
||||
msgid ""
|
||||
"**Full installation guide (for advanced users)**: if you need to import "
|
||||
"an existing Matrix server's data into the new server or want to learn "
|
||||
"more while setting up the server, follow this guide by starting with the "
|
||||
"**[Prerequisites](./docs/prerequisites.md)** documentation page."
|
||||
msgid "**Full installation guide (for advanced users)**: if you need to import an existing Matrix server's data into the new server or want to learn more while setting up the server, follow this guide by starting with the **[Prerequisites](./docs/prerequisites.md)** documentation page."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:35
|
||||
msgid ""
|
||||
"If you experience an issue on configuring the playbook, setting up your "
|
||||
"server, maintaining services on it, etc., please take a look at our "
|
||||
"[FAQ](./docs/faq.md). If you cannot find an answer to your question, feel"
|
||||
" free to ask for [help and support](#-support)."
|
||||
msgid "If you experience an issue on configuring the playbook, setting up your server, maintaining services on it, etc., please take a look at our [FAQ](./docs/faq.md). If you cannot find an answer to your question, feel free to ask for [help and support](#-support)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:37
|
||||
@ -175,11 +107,7 @@ msgid "✔ Supported services"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:39
|
||||
msgid ""
|
||||
"Using this playbook, you can get the following list of services "
|
||||
"configured on your server. Basically, this playbook aims to get you up-"
|
||||
"and-running with all the necessities around Matrix, without you having to"
|
||||
" do anything else."
|
||||
msgid "Using this playbook, you can get the following list of services configured on your server. Basically, this playbook aims to get you up-and-running with all the necessities around Matrix, without you having to do anything else."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:41
|
||||
@ -187,19 +115,11 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:43
|
||||
msgid ""
|
||||
"The list below is exhaustive. It includes optional or even some advanced "
|
||||
"components that you will most likely not need. Sticking with the defaults"
|
||||
" (which install a subset of the above components) is the best choice, "
|
||||
"especially for a new installation. You can always re-run the playbook "
|
||||
"later to add or remove components."
|
||||
msgid "The list below is exhaustive. It includes optional or even some advanced components that you will most likely not need. Sticking with the defaults (which install a subset of the above components) is the best choice, especially for a new installation. You can always re-run the playbook later to add or remove components."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:45
|
||||
msgid ""
|
||||
"Deprecated or unmaintained services are not listed. You can find "
|
||||
"documentations for them [here](docs/configuring-playbook.md#deprecated--"
|
||||
"unmaintained--removed-services)."
|
||||
msgid "Deprecated or unmaintained services are not listed. You can find documentations for them [here](docs/configuring-playbook.md#deprecated--unmaintained--removed-services)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:47
|
||||
@ -207,9 +127,7 @@ msgid "Homeserver"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:49
|
||||
msgid ""
|
||||
"The homeserver is the backbone of your Matrix system. Choose one from the"
|
||||
" following list."
|
||||
msgid "The homeserver is the backbone of your Matrix system. Choose one from the following list."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -226,7 +144,7 @@ msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid "Documentation"
|
||||
msgstr ""
|
||||
msgstr "Документация"
|
||||
|
||||
#: ../../../README.md
|
||||
msgid "[Synapse](https://github.com/element-hq/synapse)"
|
||||
@ -237,9 +155,7 @@ msgid "✅"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Storing your data and managing your presence in the "
|
||||
"[Matrix](http://matrix.org/) network"
|
||||
msgid "Storing your data and managing your presence in the [Matrix](http://matrix.org/) network"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -255,11 +171,7 @@ msgid "❌"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Storing your data and managing your presence in the "
|
||||
"[Matrix](http://matrix.org/) network. Conduit is a lightweight open-"
|
||||
"source server implementation of the Matrix Specification with a focus on "
|
||||
"easy setup and low system requirements"
|
||||
msgid "Storing your data and managing your presence in the [Matrix](http://matrix.org/) network. Conduit is a lightweight open-source server implementation of the Matrix Specification with a focus on easy setup and low system requirements"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -271,10 +183,7 @@ msgid "[Dendrite](https://github.com/matrix-org/dendrite)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Storing your data and managing your presence in the "
|
||||
"[Matrix](http://matrix.org/) network. Dendrite is a second-generation "
|
||||
"Matrix homeserver written in Go, an alternative to Synapse."
|
||||
msgid "Storing your data and managing your presence in the [Matrix](http://matrix.org/) network. Dendrite is a second-generation Matrix homeserver written in Go, an alternative to Synapse."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -283,7 +192,7 @@ msgstr ""
|
||||
|
||||
#: ../../../README.md:57
|
||||
msgid "Clients"
|
||||
msgstr ""
|
||||
msgstr "Клиенти"
|
||||
|
||||
#: ../../../README.md:59
|
||||
msgid "Web clients for Matrix that you can host on your own domains."
|
||||
@ -294,9 +203,7 @@ msgid "[Element Web](https://github.com/element-hq/element-web)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Default Matrix web client, configured to connect to your own Synapse "
|
||||
"server"
|
||||
msgid "Default Matrix web client, configured to connect to your own Synapse server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -344,9 +251,7 @@ msgid "Server Components"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:70
|
||||
msgid ""
|
||||
"Services that run on the server to make the various parts of your "
|
||||
"installation work."
|
||||
msgid "Services that run on the server to make the various parts of your installation work."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -354,9 +259,7 @@ msgid "[PostgreSQL](https://www.postgresql.org/)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Database for Synapse. [Using an external PostgreSQL server](docs"
|
||||
"/configuring-playbook-external-postgres.md) is also possible."
|
||||
msgid "Database for Synapse. [Using an external PostgreSQL server](docs/configuring-playbook-external-postgres.md) is also possible."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -380,10 +283,7 @@ msgid "[Traefik](https://doc.traefik.io/traefik/)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Web server, listening on ports 80, 443 and 8448 - standing in front of "
|
||||
"all the other services. Using your own webserver [is possible](docs"
|
||||
"/configuring-playbook-own-webserver.md)"
|
||||
msgid "Web server, listening on ports 80, 443 and 8448 - standing in front of all the other services. Using your own webserver [is possible](docs/configuring-playbook-own-webserver.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -407,9 +307,7 @@ msgid "[Exim](https://www.exim.org/)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Mail server, through which all Matrix services send outgoing email (can "
|
||||
"be configured to relay through another SMTP server)"
|
||||
msgid "Mail server, through which all Matrix services send outgoing email (can be configured to relay through another SMTP server)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -449,9 +347,7 @@ msgid "Extend and modify how users are authenticated on your homeserver."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-synapse-rest-auth](https://github.com/ma1uta/matrix-synapse-rest-"
|
||||
"password-provider) (advanced)"
|
||||
msgid "[matrix-synapse-rest-auth](https://github.com/ma1uta/matrix-synapse-rest-password-provider) (advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -463,9 +359,7 @@ msgid "[Link](docs/configuring-playbook-rest-auth.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-synapse-shared-secret-auth](https://github.com/devture/matrix-"
|
||||
"synapse-shared-secret-auth) (advanced)"
|
||||
msgid "[matrix-synapse-shared-secret-auth](https://github.com/devture/matrix-synapse-shared-secret-auth) (advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -477,9 +371,7 @@ msgid "[Link](docs/configuring-playbook-shared-secret-auth.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-synapse-ldap3](https://github.com/matrix-org/matrix-synapse-"
|
||||
"ldap3) (advanced)"
|
||||
msgid "[matrix-synapse-ldap3](https://github.com/matrix-org/matrix-synapse-ldap3) (advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -491,16 +383,11 @@ msgid "[Link](docs/configuring-playbook-ldap-auth.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-ldap-registration-"
|
||||
"proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy)"
|
||||
" (advanced)"
|
||||
msgid "[matrix-ldap-registration-proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy) (advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"A proxy that handles Matrix registration requests and forwards them to "
|
||||
"LDAP."
|
||||
msgid "A proxy that handles Matrix registration requests and forwards them to LDAP."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -520,9 +407,7 @@ msgid "[Link](docs/configuring-playbook-matrix-registration.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[Matrix User Verification Service](https://github.com/matrix-org/matrix-"
|
||||
"user-verification-service) (UVS)"
|
||||
msgid "[Matrix User Verification Service](https://github.com/matrix-org/matrix-user-verification-service) (UVS)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -534,9 +419,7 @@ msgid "[Link](docs/configuring-playbook-user-verification-service.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[synapse-simple-antispam](https://github.com/t2bot/synapse-simple-"
|
||||
"antispam) (advanced)"
|
||||
msgid "[synapse-simple-antispam](https://github.com/t2bot/synapse-simple-antispam) (advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -560,9 +443,7 @@ msgid "[Goofys](https://github.com/kahing/goofys)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[Amazon S3](https://aws.amazon.com/s3/) (or other S3-compatible object "
|
||||
"store) storage for Synapse's content repository (`media_store`) files"
|
||||
msgid "[Amazon S3](https://aws.amazon.com/s3/) (or other S3-compatible object store) storage for Synapse's content repository (`media_store`) files"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -570,9 +451,7 @@ msgid "[Link](docs/configuring-playbook-s3-goofys.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[synapse-s3-storage-provider](https://github.com/matrix-org/synapse-s3"
|
||||
"-storage-provider)"
|
||||
msgid "[synapse-s3-storage-provider](https://github.com/matrix-org/synapse-s3-storage-provider)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -584,10 +463,7 @@ msgid "[matrix-media-repo](https://github.com/turt2live/matrix-media-repo)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"matrix-media-repo is a highly customizable multi-domain media repository "
|
||||
"for Matrix. Intended for medium to large deployments, this media repo de-"
|
||||
"duplicates media while being fully compliant with the specification."
|
||||
msgid "matrix-media-repo is a highly customizable multi-domain media repository for Matrix. Intended for medium to large deployments, this media repo de-duplicates media while being fully compliant with the specification."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -599,9 +475,7 @@ msgid "Bridges"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:108
|
||||
msgid ""
|
||||
"Bridges can be used to connect your Matrix installation with third-party "
|
||||
"communication networks."
|
||||
msgid "Bridges can be used to connect your Matrix installation with third-party communication networks."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -705,16 +579,11 @@ msgid "[mautrix-meta](https://github.com/mautrix/instagram)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Bridge to [Messenger](https://messenger.com/) and "
|
||||
"[Instagram](https://instagram.com/)"
|
||||
msgid "Bridge to [Messenger](https://messenger.com/) and [Instagram](https://instagram.com/)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Link for [Messenger](docs/configuring-playbook-bridge-mautrix-meta-"
|
||||
"messenger.md) / [Instagram](docs/configuring-playbook-bridge-mautrix-"
|
||||
"meta-instagram.md)"
|
||||
msgid "Link for [Messenger](docs/configuring-playbook-bridge-mautrix-meta-messenger.md) / [Instagram](docs/configuring-playbook-bridge-mautrix-meta-instagram.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -742,9 +611,7 @@ msgid "[Link](docs/configuring-playbook-bridge-beeper-linkedin.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-appservice-irc](https://github.com/matrix-org/matrix-appservice-"
|
||||
"irc)"
|
||||
msgid "[matrix-appservice-irc](https://github.com/matrix-org/matrix-appservice-irc)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -756,15 +623,11 @@ msgid "[Link](docs/configuring-playbook-bridge-appservice-irc.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-appservice-kakaotalk](https://src.miscworks.net/fair/matrix-"
|
||||
"appservice-kakaotalk)"
|
||||
msgid "[matrix-appservice-kakaotalk](https://src.miscworks.net/fair/matrix-appservice-kakaotalk)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Bridge to "
|
||||
"[Kakaotalk](https://www.kakaocorp.com/page/service/service/KakaoTalk?lang=ENG)"
|
||||
msgid "Bridge to [Kakaotalk](https://www.kakaocorp.com/page/service/service/KakaoTalk?lang=ENG)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -772,9 +635,7 @@ msgid "[Link](docs/configuring-playbook-bridge-appservice-kakaotalk.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-appservice-discord](https://github.com/matrix-org/matrix-"
|
||||
"appservice-discord)"
|
||||
msgid "[matrix-appservice-discord](https://github.com/matrix-org/matrix-appservice-discord)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -786,9 +647,7 @@ msgid "[Link](docs/configuring-playbook-bridge-appservice-discord.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-appservice-slack](https://github.com/matrix-org/matrix-"
|
||||
"appservice-slack)"
|
||||
msgid "[matrix-appservice-slack](https://github.com/matrix-org/matrix-appservice-slack)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -800,9 +659,7 @@ msgid "[matrix-hookshot](https://github.com/matrix-org/matrix-hookshot)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Bridge for generic webhooks and multiple project management services, "
|
||||
"such as GitHub, GitLab, Figma, and Jira in particular"
|
||||
msgid "Bridge for generic webhooks and multiple project management services, such as GitHub, GitLab, Figma, and Jira in particular"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -838,9 +695,7 @@ msgid "[Heisenbridge](https://github.com/hifi/heisenbridge)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Bouncer-style bridge to "
|
||||
"[IRC](https://wikipedia.org/wiki/Internet_Relay_Chat)"
|
||||
msgid "Bouncer-style bridge to [IRC](https://wikipedia.org/wiki/Internet_Relay_Chat)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -896,9 +751,7 @@ msgid "[Link](docs/configuring-playbook-bridge-mx-puppet-twitter.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[mx-puppet-discord](https://gitlab.com/mx-puppet/discord/mx-puppet-"
|
||||
"discord)"
|
||||
msgid "[mx-puppet-discord](https://gitlab.com/mx-puppet/discord/mx-puppet-discord)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -906,9 +759,7 @@ msgid "[Link](docs/configuring-playbook-bridge-mx-puppet-discord.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[mx-puppet-groupme](https://gitlab.com/xangelix-pub/matrix/mx-puppet-"
|
||||
"groupme)"
|
||||
msgid "[mx-puppet-groupme](https://gitlab.com/xangelix-pub/matrix/mx-puppet-groupme)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -968,11 +819,7 @@ msgid "[baibot](https://github.com/etkecc/baibot)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"A bot that exposes the power of "
|
||||
"[AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large "
|
||||
"Language Models](https://en.wikipedia.org/wiki/Large_language_model) to "
|
||||
"you"
|
||||
msgid "A bot that exposes the power of [AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large Language Models](https://en.wikipedia.org/wiki/Large_language_model) to you"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -980,9 +827,7 @@ msgid "[Link](docs/configuring-playbook-bot-baibot.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-reminder-bot](https://github.com/anoadragon453/matrix-reminder-"
|
||||
"bot)"
|
||||
msgid "[matrix-reminder-bot](https://github.com/anoadragon453/matrix-reminder-bot)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -994,9 +839,7 @@ msgid "[Link](docs/configuring-playbook-bot-matrix-reminder-bot.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-registration-bot](https://github.com/moan0s/matrix-registration-"
|
||||
"bot)"
|
||||
msgid "[matrix-registration-bot](https://github.com/moan0s/matrix-registration-bot)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -1052,9 +895,7 @@ msgid "A moderation tool for Matrix (Fork of Mjolnir)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[Link](docs/configuring-playbook-bot-draupnir.md) (for [appservice "
|
||||
"mode](docs/configuring-playbook-appservice-draupnir-for-all.md))"
|
||||
msgid "[Link](docs/configuring-playbook-bot-draupnir.md) (for [appservice mode](docs/configuring-playbook-appservice-draupnir-for-all.md))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -1074,22 +915,15 @@ msgid "Administration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:158
|
||||
msgid ""
|
||||
"Services that help you in administrating and monitoring your Matrix "
|
||||
"installation."
|
||||
msgid "Services that help you in administrating and monitoring your Matrix installation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[matrix-alertmanager-receiver](https://github.com/metio/matrix-"
|
||||
"alertmanager-receiver)"
|
||||
msgid "[matrix-alertmanager-receiver](https://github.com/metio/matrix-alertmanager-receiver)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Prometheus' "
|
||||
"[Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/) "
|
||||
"client"
|
||||
msgid "Prometheus' [Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/) client"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -1097,9 +931,7 @@ msgid "[Link](docs/configuring-playbook-alertmanager-receiver.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[Matrix Authentication Service](https://github.com/element-hq/matrix-"
|
||||
"authentication-service/)"
|
||||
msgid "[Matrix Authentication Service](https://github.com/element-hq/matrix-authentication-service/)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -1127,19 +959,11 @@ msgid "Metrics and Graphs"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Consists of the [Prometheus](https://prometheus.io) time-series database "
|
||||
"server, the Prometheus [node-exporter](https://prometheus.io/docs/guides"
|
||||
"/node-exporter/) host metrics exporter, and the "
|
||||
"[Grafana](https://grafana.com/) web UI, with [prometheus-nginxlog-"
|
||||
"exporter](https://github.com/martin-helmich/prometheus-nginxlog-"
|
||||
"exporter/) being available too"
|
||||
msgid "Consists of the [Prometheus](https://prometheus.io) time-series database server, the Prometheus [node-exporter](https://prometheus.io/docs/guides/node-exporter/) host metrics exporter, and the [Grafana](https://grafana.com/) web UI, with [prometheus-nginxlog-exporter](https://github.com/martin-helmich/prometheus-nginxlog-exporter/) being available too"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[Link](docs/configuring-playbook-prometheus-grafana.md) (for [prometheus-"
|
||||
"nginxlog-exporter](docs/configuring-playbook-prometheus-nginxlog.md))"
|
||||
msgid "[Link](docs/configuring-playbook-prometheus-grafana.md) (for [prometheus-nginxlog-exporter](docs/configuring-playbook-prometheus-nginxlog.md))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -1167,15 +991,11 @@ msgid "[Link](docs/configuring-playbook-rageshake.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[synapse-usage-exporter](https://github.com/loelkes/synapse-usage-"
|
||||
"exporter)"
|
||||
msgid "[synapse-usage-exporter](https://github.com/loelkes/synapse-usage-exporter)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"Export the usage statistics of a Synapse homeserver to be scraped by "
|
||||
"Prometheus."
|
||||
msgid "Export the usage statistics of a Synapse homeserver to be scraped by Prometheus."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -1195,11 +1015,7 @@ msgid "[sliding-sync](https://github.com/matrix-org/sliding-sync)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"(Superseded by Simplified Sliding Sync integrated into Synapse > `1.114` "
|
||||
"and Conduit > `0.6.0`) Sliding Sync support for clients which require it "
|
||||
"(e.g. old Element X versions before Simplified Sliding Sync was "
|
||||
"developed)"
|
||||
msgid "(Superseded by Simplified Sliding Sync integrated into Synapse > `1.114` and Conduit > `0.6.0`) Sliding Sync support for clients which require it (e.g. old Element X versions before Simplified Sliding Sync was developed)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -1207,9 +1023,7 @@ msgid "[Link](docs/configuring-playbook-sliding-sync-proxy.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[synapse_auto_accept_invite](https://github.com/matrix-org/synapse-auto-"
|
||||
"accept-invite)"
|
||||
msgid "[synapse_auto_accept_invite](https://github.com/matrix-org/synapse-auto-accept-invite)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -1221,15 +1035,11 @@ msgid "[Link](docs/configuring-playbook-synapse-auto-accept-invite.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"[synapse_auto_compressor](https://github.com/matrix-org/rust-synapse-"
|
||||
"compress-state/#automated-tool-synapse_auto_compressor)"
|
||||
msgid "[synapse_auto_compressor](https://github.com/matrix-org/rust-synapse-compress-state/#automated-tool-synapse_auto_compressor)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
msgid ""
|
||||
"A cli tool that automatically compresses `state_groups` database table in"
|
||||
" background."
|
||||
msgid "A cli tool that automatically compresses `state_groups` database table in background."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md
|
||||
@ -1325,15 +1135,11 @@ msgid "🆕 Changes"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:189
|
||||
msgid ""
|
||||
"This playbook evolves over time, sometimes with backward-incompatible "
|
||||
"changes."
|
||||
msgid "This playbook evolves over time, sometimes with backward-incompatible changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:191
|
||||
msgid ""
|
||||
"When updating the playbook, refer to [the changelog](CHANGELOG.md) to "
|
||||
"catch up with what's new."
|
||||
msgid "When updating the playbook, refer to [the changelog](CHANGELOG.md) to catch up with what's new."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:193
|
||||
@ -1341,23 +1147,15 @@ msgid "🆘 Support"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:195
|
||||
msgid ""
|
||||
"Matrix room: [#matrix-docker-ansible-"
|
||||
"deploy:devture.com](https://matrix.to/#/#matrix-docker-ansible-"
|
||||
"deploy:devture.com)"
|
||||
msgid "Matrix room: [#matrix-docker-ansible-deploy:devture.com](https://matrix.to/#/#matrix-docker-ansible-deploy:devture.com)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:197
|
||||
msgid ""
|
||||
"IRC channel: `#matrix-docker-ansible-deploy` on the [Libera "
|
||||
"Chat](https://libera.chat/) IRC network (irc.libera.chat:6697)"
|
||||
msgid "IRC channel: `#matrix-docker-ansible-deploy` on the [Libera Chat](https://libera.chat/) IRC network (irc.libera.chat:6697)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:199
|
||||
msgid ""
|
||||
"GitHub issues: [spantaleev/matrix-docker-ansible-"
|
||||
"deploy/issues](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/issues)"
|
||||
msgid "GitHub issues: [spantaleev/matrix-docker-ansible-deploy/issues](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:201
|
||||
@ -1365,9 +1163,7 @@ msgid "🌐 Translation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:203
|
||||
msgid ""
|
||||
"See the [i18n/README.md](i18n/README.md) file for more information about "
|
||||
"translation."
|
||||
msgid "See the [i18n/README.md](i18n/README.md) file for more information about translation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:205
|
||||
@ -1379,21 +1175,9 @@ msgid "🤝 Related"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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-"
|
||||
"hosting non-Matrix services (see its [List of supported "
|
||||
"services](https://github.com/mother-of-all-self-hosting/mash-"
|
||||
"playbook/blob/main/docs/supported-services.md))."
|
||||
msgid "You may also be interested in [mash-playbook](https://github.com/mother-of-all-self-hosting/mash-playbook) - another Ansible playbook for self-hosting non-Matrix services (see its [List of supported services](https://github.com/mother-of-all-self-hosting/mash-playbook/blob/main/docs/supported-services.md))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../README.md:211
|
||||
msgid ""
|
||||
"mash-playbook also makes use of [Traefik](./docs/configuring-playbook-"
|
||||
"traefik.md) as its reverse-proxy, so with minor [interoperability "
|
||||
"adjustments](https://github.com/mother-of-all-self-hosting/mash-"
|
||||
"playbook/blob/main/docs/interoperability.md), you can make matrix-docker-"
|
||||
"ansible-deploy and mash-playbook co-exist and host Matrix and non-Matrix "
|
||||
"services on the same server."
|
||||
msgid "mash-playbook also makes use of [Traefik](./docs/configuring-playbook-traefik.md) as its reverse-proxy, so with minor [interoperability adjustments](https://github.com/mother-of-all-self-hosting/mash-playbook/blob/main/docs/interoperability.md), you can make matrix-docker-ansible-deploy and mash-playbook co-exist and host Matrix and non-Matrix services on the same server."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -22,157 +22,47 @@ msgid "2023"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:3
|
||||
msgid ""
|
||||
"2023 was a year filled with many changes for matrix-docker-ansible-"
|
||||
"deploy. In this post, we're looking backward at some of the major changes"
|
||||
" that happened this year, as well as taking a glimpse of what's ahead in "
|
||||
"2024."
|
||||
msgid "2023 was a year filled with many changes for matrix-docker-ansible-deploy. In this post, we're looking backward at some of the major changes that happened this year, as well as taking a glimpse of what's ahead in 2024."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:5
|
||||
msgid ""
|
||||
"2023 is probably [the year of AI](https://journal.everypixel.com/2023"
|
||||
"-the-year-of-ai), with millions of people jumping aboard "
|
||||
"[OpenAI](https://openai.com/)'s [ChatGPT](https://openai.com/chatgpt) "
|
||||
"train. matrix-docker-ansible-deploy is no stranger to this and 2023 began"
|
||||
" with a PR from [bertybuttface](https://github.com/bertybuttface) who "
|
||||
"added support for [matrix-chatgpt-bot](https://github.com/matrixgpt"
|
||||
"/matrix-chatgpt-bot) (see the [changelog "
|
||||
"entry](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#chatgpt-support)). While OpenAI's chat GPT website was frequently "
|
||||
"overloaded in the past, their API was up which made using this bot both "
|
||||
"convenient and more reliable."
|
||||
msgid "2023 is probably [the year of AI](https://journal.everypixel.com/2023-the-year-of-ai), with millions of people jumping aboard [OpenAI](https://openai.com/)'s [ChatGPT](https://openai.com/chatgpt) train. matrix-docker-ansible-deploy is no stranger to this and 2023 began with a PR from [bertybuttface](https://github.com/bertybuttface) who added support for [matrix-chatgpt-bot](https://github.com/matrixgpt/matrix-chatgpt-bot) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#chatgpt-support)). While OpenAI's chat GPT website was frequently overloaded in the past, their API was up which made using this bot both convenient and more reliable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:7
|
||||
msgid ""
|
||||
"AI aside, with the playbook's focus being containers, we're **doubling "
|
||||
"down on being \"container native\"** and becoming more interoperable for "
|
||||
"people hosting other containers on the Matrix server. In "
|
||||
"[2022](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/YEAR-IN-"
|
||||
"REVIEW.md#2022), we've announced a few sibling Ansible playbooks, their "
|
||||
"use of [Traefik](https://doc.traefik.io/traefik/) and the possiblity of "
|
||||
"matrix-docker-ansible-deploy also switching to this reverse-proxy. This "
|
||||
"prediction materialized quickly. The **largest change** in the playbook "
|
||||
"in 2023 happened way back in February - matrix-docker-ansible-deploy "
|
||||
"[starting the switch from nginx to Traefik](https://github.com/spantaleev"
|
||||
"/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#backward-compatibility-reverse-proxy-configuration-changes-and-initial-"
|
||||
"traefik-support) and then quickly [making Treafik the default reverse-"
|
||||
"proxy](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#traefik-is-the-default-reverse-proxy-now). As noted in the changelog "
|
||||
"entries, we envisioned a quick and complete elimination of `matrix-nginx-"
|
||||
"proxy`, but at the end of 2023, it hasn't happened yet. The playbook is "
|
||||
"already using Traefik as the front-most reverse-proxy, but nginx (via "
|
||||
"`matrix-nginx-proxy`) is still around - it has taken a step back and is "
|
||||
"only used internally for new setups. Work got to a stall due to:"
|
||||
msgid "AI aside, with the playbook's focus being containers, we're **doubling down on being \"container native\"** and becoming more interoperable for people hosting other containers on the Matrix server. In [2022](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/YEAR-IN-REVIEW.md#2022), we've announced a few sibling Ansible playbooks, their use of [Traefik](https://doc.traefik.io/traefik/) and the possiblity of matrix-docker-ansible-deploy also switching to this reverse-proxy. This prediction materialized quickly. The **largest change** in the playbook in 2023 happened way back in February - matrix-docker-ansible-deploy [starting the switch from nginx to Traefik](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#backward-compatibility-reverse-proxy-configuration-changes-and-initial-traefik-support) and then quickly [making Treafik the default reverse-proxy](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#traefik-is-the-default-reverse-proxy-now). As noted in the changelog entries, we envisioned a quick and complete elimination of `matrix-nginx-proxy`, but at the end of 2023, it hasn't happened yet. The playbook is already using Traefik as the front-most reverse-proxy, but nginx (via `matrix-nginx-proxy`) is still around - it has taken a step back and is only used internally for new setups. Work got to a stall due to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:9
|
||||
msgid ""
|
||||
"complexity: untangling the overly large and messy `matrix-nginx-proxy` "
|
||||
"component is difficult"
|
||||
msgid "complexity: untangling the overly large and messy `matrix-nginx-proxy` component is difficult"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:10
|
||||
msgid ""
|
||||
"the current setup became \"good enough\" because nginx has become an "
|
||||
"internal implementation detail for those who have migrated to Traefik. "
|
||||
"Traefik is already the default public reverse-proxy and gives better "
|
||||
"possibilities to people wishing to run other web-exposed containers on "
|
||||
"their Matrix server via [Docker "
|
||||
"Compose](https://docs.docker.com/compose/), other Ansible playbooks like "
|
||||
"[mash-playbook](https://github.com/mother-of-all-self-hosting/mash-"
|
||||
"playbook) (more about this one, below) or any other way."
|
||||
msgid "the current setup became \"good enough\" because nginx has become an internal implementation detail for those who have migrated to Traefik. Traefik is already the default public reverse-proxy and gives better possibilities to people wishing to run other web-exposed containers on their Matrix server via [Docker Compose](https://docs.docker.com/compose/), other Ansible playbooks like [mash-playbook](https://github.com/mother-of-all-self-hosting/mash-playbook) (more about this one, below) or any other way."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:12
|
||||
msgid ""
|
||||
"`matrix-nginx-proxy` is no longer in the way of us being interoperable, "
|
||||
"but its ugly internal details are still there. It is one more proxy in "
|
||||
"the long chain of reverse-proxies we have and we'd like to cut it out. "
|
||||
"This would both make things simpler and also boost performance."
|
||||
msgid "`matrix-nginx-proxy` is no longer in the way of us being interoperable, but its ugly internal details are still there. It is one more proxy in the long chain of reverse-proxies we have and we'd like to cut it out. This would both make things simpler and also boost performance."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:14
|
||||
msgid ""
|
||||
"The delay in eliminating `matrix-nginx-proxy` has probably been welcome "
|
||||
"by many existing users who decided to postpone the Traefik migration a "
|
||||
"bit longer. In 2024, work on eliminating `matrix-nginx-proxy` will "
|
||||
"continue with rapid pace. People who are still using `matrix-nginx-proxy`"
|
||||
" as their front-most reverse-proxy will need to rework their setup. About"
|
||||
" a year of putting it off has been long enough."
|
||||
msgid "The delay in eliminating `matrix-nginx-proxy` has probably been welcome by many existing users who decided to postpone the Traefik migration a bit longer. In 2024, work on eliminating `matrix-nginx-proxy` will continue with rapid pace. People who are still using `matrix-nginx-proxy` as their front-most reverse-proxy will need to rework their setup. About a year of putting it off has been long enough."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:16
|
||||
msgid ""
|
||||
"This large Traefik reverse-proxy change was also accompanied by another "
|
||||
"internal change which began in 2022, but continued in 2023 - **moving "
|
||||
"non-Matrix-related roles from being internal to the playbook to living "
|
||||
"their own life outside of it**. Various roles were made more decoupled "
|
||||
"and moved outside of the playbook, so that other projects (like the "
|
||||
"[mash-playbook](https://github.com/mother-of-all-self-hosting/mash-"
|
||||
"playbook) Ansible playbook or other Ansible playbooks) could benefit from"
|
||||
" them. This led to the **death of a few sibling playbooks** ([gitea-"
|
||||
"docker-ansible-deploy](https://github.com/spantaleev/gitea-docker-"
|
||||
"ansible-deploy), [nextcloud-docker-ansible-"
|
||||
"deploy](https://github.com/spantaleev/nextcloud-docker-ansible-deploy), "
|
||||
"[peertube-docker-ansible-deploy](https://github.com/spantaleev/peertube-"
|
||||
"docker-ansible-deploy), [vaultwarden-docker-ansible-"
|
||||
"deploy](https://github.com/spantaleev/vaultwarden-docker-ansible-"
|
||||
"deploy)), but brought life to something better, which supports all these "
|
||||
"services and more."
|
||||
msgid "This large Traefik reverse-proxy change was also accompanied by another internal change which began in 2022, but continued in 2023 - **moving non-Matrix-related roles from being internal to the playbook to living their own life outside of it**. Various roles were made more decoupled and moved outside of the playbook, so that other projects (like the [mash-playbook](https://github.com/mother-of-all-self-hosting/mash-playbook) Ansible playbook or other Ansible playbooks) could benefit from them. This led to the **death of a few sibling playbooks** ([gitea-docker-ansible-deploy](https://github.com/spantaleev/gitea-docker-ansible-deploy), [nextcloud-docker-ansible-deploy](https://github.com/spantaleev/nextcloud-docker-ansible-deploy), [peertube-docker-ansible-deploy](https://github.com/spantaleev/peertube-docker-ansible-deploy), [vaultwarden-docker-ansible-deploy](https://github.com/spantaleev/vaultwarden-docker-ansible-deploy)), but brought life to something better, which supports all these services and more."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:18
|
||||
msgid ""
|
||||
"[mash-playbook](https://github.com/mother-of-all-self-hosting/mash-"
|
||||
"playbook) is a new Ansible playbook that a few of us (matrix-docker-"
|
||||
"ansible-deploy contributors) have launched in 2023. It has quickly grown "
|
||||
"to supports [60+ services](https://github.com/mother-of-all-self-hosting"
|
||||
"/mash-playbook/blob/main/docs/supported-services.md) and aims to do the "
|
||||
"same for [FOSS](https://en.wikipedia.org/wiki/Free_and_open-"
|
||||
"source_software) service hosting, as matrix-docker-ansible-deploy has "
|
||||
"done for Matrix - providing a clean and secure way to run a bunch of "
|
||||
"services in containers on a regular server (that is to say, without "
|
||||
"Kubernetes, etc.). Thanks to Traefik and Ansible role reuse, it's easy to"
|
||||
" host both mash-playbook services and matrix-docker-ansible-deploy "
|
||||
"services on the same server - see mash-playbook's "
|
||||
"[interoperability](https://github.com/mother-of-all-self-hosting/mash-"
|
||||
"playbook/blob/main/docs/interoperability.md) documentation page. If "
|
||||
"you've been looking for a holiday project or your New Year's Resolutions "
|
||||
"list contains \"self-hosting more services\", then you're welcome to give"
|
||||
" this new playbook a try and join its Matrix room ([#mash-"
|
||||
"playbook:devture.com](https://matrix.to/#/#mash-playbook:devture.com))."
|
||||
msgid "[mash-playbook](https://github.com/mother-of-all-self-hosting/mash-playbook) is a new Ansible playbook that a few of us (matrix-docker-ansible-deploy contributors) have launched in 2023. It has quickly grown to supports [60+ services](https://github.com/mother-of-all-self-hosting/mash-playbook/blob/main/docs/supported-services.md) and aims to do the same for [FOSS](https://en.wikipedia.org/wiki/Free_and_open-source_software) service hosting, as matrix-docker-ansible-deploy has done for Matrix - providing a clean and secure way to run a bunch of services in containers on a regular server (that is to say, without Kubernetes, etc.). Thanks to Traefik and Ansible role reuse, it's easy to host both mash-playbook services and matrix-docker-ansible-deploy services on the same server - see mash-playbook's [interoperability](https://github.com/mother-of-all-self-hosting/mash-playbook/blob/main/docs/interoperability.md) documentation page. If you've been looking for a holiday project or your New Year's Resolutions list contains \"self-hosting more services\", then you're welcome to give this new playbook a try and join its Matrix room ([#mash-playbook:devture.com](https://matrix.to/#/#mash-playbook:devture.com))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:20
|
||||
msgid ""
|
||||
"Because many of the roles are now external to this playbook (defined in "
|
||||
"the [requirements.yml](https://github.com/spantaleev/matrix-docker-"
|
||||
"ansible-"
|
||||
"deploy/blob/da27655ef34999fa924bc0a5e641dbd9ba06f133/requirements.yml) "
|
||||
"file), running `make roles` (or better yet `just roles` via the [just "
|
||||
"tool](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#support-for-running-commands-via-just)) becomes a necessity each time "
|
||||
"one pulls playbook updates (`git pull`). Pulling external roles happens "
|
||||
"via the [ansible-galaxy](https://docs.ansible.com/ansible/latest/cli"
|
||||
"/ansible-galaxy.html) command-line tool, but if available, the playbook "
|
||||
"would also use the much faster [agru](https://github.com/etkecc/agru) "
|
||||
"tool (developed by [Aine](https://gitlab.com/etke.cc) from "
|
||||
"[etke.cc](https://etke.cc/) this year)."
|
||||
msgid "Because many of the roles are now external to this playbook (defined in the [requirements.yml](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/da27655ef34999fa924bc0a5e641dbd9ba06f133/requirements.yml) file), running `make roles` (or better yet `just roles` via the [just tool](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#support-for-running-commands-via-just)) becomes a necessity each time one pulls playbook updates (`git pull`). Pulling external roles happens via the [ansible-galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html) command-line tool, but if available, the playbook would also use the much faster [agru](https://github.com/etkecc/agru) tool (developed by [Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/) this year)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:22
|
||||
msgid ""
|
||||
"With the internal (but important) details out of the way, we can now talk"
|
||||
" more about **new features that landed in matrix-docker-ansible-deploy in"
|
||||
" 2023**."
|
||||
msgid "With the internal (but important) details out of the way, we can now talk more about **new features that landed in matrix-docker-ansible-deploy in 2023**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:24
|
||||
@ -180,40 +70,19 @@ msgid "The following **new** **bridges** were added to the playbook in 2023:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:26
|
||||
msgid ""
|
||||
"(2023-01-11) [mautrix-slack](https://mau.dev/mautrix/slack), thanks to a "
|
||||
"PR by [Cody Neiman](https://github.com/xangelix) (see the [changelog "
|
||||
"entry](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#mautrix-slack-support))"
|
||||
msgid "(2023-01-11) [mautrix-slack](https://mau.dev/mautrix/slack), thanks to a PR by [Cody Neiman](https://github.com/xangelix) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#mautrix-slack-support))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:27
|
||||
msgid ""
|
||||
"(2023-07-21) [mautrix-gmessages](https://github.com/mautrix/gmessages), "
|
||||
"thanks to a PR by [Shreyas Ajjarapu](https://github.com/shreyasajj) (see "
|
||||
"the [changelog entry](https://github.com/spantaleev/matrix-docker-"
|
||||
"ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#mautrix-gmessages-support))"
|
||||
msgid "(2023-07-21) [mautrix-gmessages](https://github.com/mautrix/gmessages), thanks to a PR by [Shreyas Ajjarapu](https://github.com/shreyasajj) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#mautrix-gmessages-support))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:28
|
||||
msgid ""
|
||||
"(2023-08-23) [mautrix-wsproxy](https://github.com/mautrix/wsproxy) for "
|
||||
"Apple iMessage bridging (when combined with the [mautrix-"
|
||||
"imessage](https://github.com/mautrix/imessage) bridge running on your Mac"
|
||||
" or Android phone), thanks to a PR by [Johan "
|
||||
"Swetzén](https://github.com/jswetzen)"
|
||||
msgid "(2023-08-23) [mautrix-wsproxy](https://github.com/mautrix/wsproxy) for Apple iMessage bridging (when combined with the [mautrix-imessage](https://github.com/mautrix/imessage) bridge running on your Mac or Android phone), thanks to a PR by [Johan Swetzén](https://github.com/jswetzen)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:30
|
||||
msgid ""
|
||||
"This brings the total number of **[bridges that the playbook "
|
||||
"supports](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/docs/configuring-"
|
||||
"playbook.md#bridging-other-networks) up to 30**. There are alternative "
|
||||
"bridge implementations for various networks and protocols, so the number "
|
||||
"of \"unique bridged networks\" is surely much smaller."
|
||||
msgid "This brings the total number of **[bridges that the playbook supports](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/docs/configuring-playbook.md#bridging-other-networks) up to 30**. There are alternative bridge implementations for various networks and protocols, so the number of \"unique bridged networks\" is surely much smaller."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:32
|
||||
@ -221,204 +90,79 @@ msgid "A few other **major components and changes** landed in 2023:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:34
|
||||
msgid ""
|
||||
"(2023-02-10) The [Draupnir](https://github.com/the-draupnir-"
|
||||
"project/Draupnir) moderation tool (successor to "
|
||||
"[Mjolnir](https://github.com/matrix-org/mjolnir)), thanks to a PR by "
|
||||
"[FSG-Cat](https://github.com/FSG-Cat) (see the [changelog "
|
||||
"entry](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#draupnir-moderation-tool-bot-support))"
|
||||
msgid "(2023-02-10) The [Draupnir](https://github.com/the-draupnir-project/Draupnir) moderation tool (successor to [Mjolnir](https://github.com/matrix-org/mjolnir)), thanks to a PR by [FSG-Cat](https://github.com/FSG-Cat) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#draupnir-moderation-tool-bot-support))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:35
|
||||
msgid ""
|
||||
"(2023-02-10) [Matrix User Verification Service](https://github.com"
|
||||
"/matrix-org/matrix-user-verification-service) to add Matrix "
|
||||
"Authentication Support to our Jitsi setup, thanks to a PR by [Jakob "
|
||||
"S.](https://github.com/jakicoll) from [zakk gGmbH](https://github.com"
|
||||
"/zakk-it) (see the [changelog entry](https://github.com/spantaleev"
|
||||
"/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#matrix-"
|
||||
"authentication-support-for-jitsi))"
|
||||
msgid "(2023-02-10) [Matrix User Verification Service](https://github.com/matrix-org/matrix-user-verification-service) to add Matrix Authentication Support to our Jitsi setup, thanks to a PR by [Jakob S.](https://github.com/jakicoll) from [zakk gGmbH](https://github.com/zakk-it) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#matrix-authentication-support-for-jitsi))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:36
|
||||
msgid ""
|
||||
"(2023-02-25) The [rageshake](https://github.com/matrix-org/rageshake) bug"
|
||||
" report server, thanks to a PR by [Benjamin "
|
||||
"Kampmann](https://github.com/gnunicorn) (see the [changelog "
|
||||
"entry](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#rageshake-support))"
|
||||
msgid "(2023-02-25) The [rageshake](https://github.com/matrix-org/rageshake) bug report server, thanks to a PR by [Benjamin Kampmann](https://github.com/gnunicorn) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#rageshake-support))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:37
|
||||
msgid ""
|
||||
"(2023-03-07) [Sliding Sync proxy](https://github.com/matrix-org/sliding-"
|
||||
"sync) (currently a necessary component for [Element "
|
||||
"X](https://element.io/labs/element-x) to work), thanks to: [Benjamin "
|
||||
"Kampmann](https://github.com/gnunicorn) and [FSG-Cat](https://github.com"
|
||||
"/FSG-Cat) (see the [changelog entry](https://github.com/spantaleev"
|
||||
"/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#sliding-sync-proxy-element-x-support))"
|
||||
msgid "(2023-03-07) [Sliding Sync proxy](https://github.com/matrix-org/sliding-sync) (currently a necessary component for [Element X](https://element.io/labs/element-x) to work), thanks to: [Benjamin Kampmann](https://github.com/gnunicorn) and [FSG-Cat](https://github.com/FSG-Cat) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#sliding-sync-proxy-element-x-support))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:38
|
||||
msgid ""
|
||||
"(2023-03-12) synapse-auto-compressor to periodically and automatically "
|
||||
"run [rust-synapse-compress-state](https://github.com/matrix-org/rust-"
|
||||
"synapse-compress-state), thanks to a PR by "
|
||||
"[Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/) (see "
|
||||
"the [changelog entry](https://github.com/spantaleev/matrix-docker-"
|
||||
"ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#synapse-auto-compressor-support))"
|
||||
msgid "(2023-03-12) synapse-auto-compressor to periodically and automatically run [rust-synapse-compress-state](https://github.com/matrix-org/rust-synapse-compress-state), thanks to a PR by [Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#synapse-auto-compressor-support))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:39
|
||||
msgid ""
|
||||
"(2023-07-17) [matrix-media-repo](https://github.com/turt2live/matrix-"
|
||||
"media-repo), thanks to a PR by [Michael Hollister](https://github.com"
|
||||
"/Michael-Hollister) from [FUTO](https://www.futo.org/), the creators of "
|
||||
"the [Circles app](https://circu.li/) (see the [changelog "
|
||||
"entry](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#matrix-"
|
||||
"media-repo-support))"
|
||||
msgid "(2023-07-17) [matrix-media-repo](https://github.com/turt2live/matrix-media-repo), thanks to a PR by [Michael Hollister](https://github.com/Michael-Hollister) from [FUTO](https://www.futo.org/), the creators of the [Circles app](https://circu.li/) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#matrix-media-repo-support))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:40
|
||||
msgid ""
|
||||
"(2023-08-31) [SchildiChat Web](https://github.com/SchildiChat"
|
||||
"/schildichat-desktop) client app (fork of [Element "
|
||||
"Web)](https://github.com/element-hq/element-web), thanks to a PR by "
|
||||
"[Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/) (see "
|
||||
"the [changelog entry](https://github.com/spantaleev/matrix-docker-"
|
||||
"ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#schildichat-support))"
|
||||
msgid "(2023-08-31) [SchildiChat Web](https://github.com/SchildiChat/schildichat-desktop) client app (fork of [Element Web)](https://github.com/element-hq/element-web), thanks to a PR by [Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#schildichat-support))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:41
|
||||
msgid ""
|
||||
"(2023-10-18) Postgres parameters auto-tuning, thanks to a PR by "
|
||||
"[Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/) (see "
|
||||
"the [changelog entry](https://github.com/spantaleev/matrix-docker-"
|
||||
"ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#postgres-parameters-are-automatically-tuned-now))"
|
||||
msgid "(2023-10-18) Postgres parameters auto-tuning, thanks to a PR by [Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/) (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#postgres-parameters-are-automatically-tuned-now))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:42
|
||||
msgid ""
|
||||
"(2023-10-23) Enabling federation of the room directory for Synapse (see "
|
||||
"the [changelog entry](https://github.com/spantaleev/matrix-docker-"
|
||||
"ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#enabling-allow_public_rooms_over_federation-by-default-for-synapse))"
|
||||
msgid "(2023-10-23) Enabling federation of the room directory for Synapse (see the [changelog entry](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#enabling-allow_public_rooms_over_federation-by-default-for-synapse))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:44
|
||||
msgid ""
|
||||
"The most recent change in the list above (Enabling federation of the room"
|
||||
" directory for Synapse) has been somewhat **controversial** as it goes "
|
||||
"against upstream defaults for Synapse. Nevertheless, we believe it "
|
||||
"**promotes the well-being of the Matrix Federation by improving room "
|
||||
"discovery**."
|
||||
msgid "The most recent change in the list above (Enabling federation of the room directory for Synapse) has been somewhat **controversial** as it goes against upstream defaults for Synapse. Nevertheless, we believe it **promotes the well-being of the Matrix Federation by improving room discovery**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:46
|
||||
msgid ""
|
||||
"**Matrix Federation Stats** (containing the percentage of servers "
|
||||
"publishing their room directory publicly) are posted to "
|
||||
"[TWIM](https://matrix.org/category/this-week-in-matrix/) each week by "
|
||||
"[Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/). The "
|
||||
"number of servers which [currently published their room directory "
|
||||
"publicly](https://matrix.org/blog/2023/12/2/this-week-in-"
|
||||
"matrix-2023-12-22/#matrix-federation-stats) stands at `26.6%`, which is:"
|
||||
msgid "**Matrix Federation Stats** (containing the percentage of servers publishing their room directory publicly) are posted to [TWIM](https://matrix.org/category/this-week-in-matrix/) each week by [Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/). The number of servers which [currently published their room directory publicly](https://matrix.org/blog/2023/12/2/this-week-in-matrix-2023-12-22/#matrix-federation-stats) stands at `26.6%`, which is:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:48
|
||||
msgid ""
|
||||
"**2.4% more** than when it was when [first published to "
|
||||
"TWIM](https://matrix.org/blog/2023/11/03/this-week-in-matrix-2023-11-03"
|
||||
"/#matrix-federation-stats) (1 month earlier, in November)"
|
||||
msgid "**2.4% more** than when it was when [first published to TWIM](https://matrix.org/blog/2023/11/03/this-week-in-matrix-2023-11-03/#matrix-federation-stats) (1 month earlier, in November)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:49
|
||||
msgid ""
|
||||
"likely about **15+% more** than from before we flipped the switch (in "
|
||||
"October)"
|
||||
msgid "likely about **15+% more** than from before we flipped the switch (in October)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:51
|
||||
msgid ""
|
||||
"Hopefully, Synapse defaults would also change the same way and we'd see "
|
||||
"the number of servers publicly listing their room directory grow faster."
|
||||
msgid "Hopefully, Synapse defaults would also change the same way and we'd see the number of servers publicly listing their room directory grow faster."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:53
|
||||
msgid ""
|
||||
"With this configuration change in place, projects like "
|
||||
"[MatrixRooms.info](https://matrixrooms.info/) (made by "
|
||||
"[etke.cc](https://etke.cc/)) and potentially others in the future, can "
|
||||
"discover, index the metadata (room address, title, topic, number of "
|
||||
"users, etc.) and make public rooms browsable & searchable across the "
|
||||
"whole Matrix Federation. It'd be great if users joining Matrix could more"
|
||||
" easily find interesting communities that match their interests!"
|
||||
msgid "With this configuration change in place, projects like [MatrixRooms.info](https://matrixrooms.info/) (made by [etke.cc](https://etke.cc/)) and potentially others in the future, can discover, index the metadata (room address, title, topic, number of users, etc.) and make public rooms browsable & searchable across the whole Matrix Federation. It'd be great if users joining Matrix could more easily find interesting communities that match their interests!"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:55
|
||||
msgid ""
|
||||
"On the **media side of things**, besides Jitsi getting better Matrix "
|
||||
"integration (via the aforementioned Matrix User Verification Service), "
|
||||
"we've also had some [Coturn security "
|
||||
"tightening](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
|
||||
"#backward-compatibility-tightening-coturn-security-can-lead-to-"
|
||||
"connectivity-issues) as well as [performance "
|
||||
"optimizations](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#coturn-"
|
||||
"can-now-use-host-networking) for configurations exposing lots of network "
|
||||
"ports."
|
||||
msgid "On the **media side of things**, besides Jitsi getting better Matrix integration (via the aforementioned Matrix User Verification Service), we've also had some [Coturn security tightening](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#backward-compatibility-tightening-coturn-security-can-lead-to-connectivity-issues) as well as [performance optimizations](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#coturn-can-now-use-host-networking) for configurations exposing lots of network ports."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:57
|
||||
msgid ""
|
||||
"[Element Call](https://github.com/element-hq/element-call) seems to have "
|
||||
"become a nice and polished product lately (as proclaimed in [The Matrix "
|
||||
"Holiday Update 2023](https://matrix.org/blog/2023/12/25/the-matrix-"
|
||||
"holiday-update-2023/)), so 2024 is likely the year we'll see support for "
|
||||
"it in the playbook. Element Call depends on the "
|
||||
"[LiveKit](https://livekit.io/) streaming server (which is also useful to "
|
||||
"developers even by itself), so the first step is likely to see LiveKit "
|
||||
"support in mash-playbook via a reusable Ansible role. Such a LiveKit "
|
||||
"Ansible role could later easily land in matrix-docker-ansible-deploy and "
|
||||
"an Element Call static website could be hooked to it."
|
||||
msgid "[Element Call](https://github.com/element-hq/element-call) seems to have become a nice and polished product lately (as proclaimed in [The Matrix Holiday Update 2023](https://matrix.org/blog/2023/12/25/the-matrix-holiday-update-2023/)), so 2024 is likely the year we'll see support for it in the playbook. Element Call depends on the [LiveKit](https://livekit.io/) streaming server (which is also useful to developers even by itself), so the first step is likely to see LiveKit support in mash-playbook via a reusable Ansible role. Such a LiveKit Ansible role could later easily land in matrix-docker-ansible-deploy and an Element Call static website could be hooked to it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:59
|
||||
msgid ""
|
||||
"Besides these highlights, there were many other relatively large changes "
|
||||
"announced in our [CHANGELOG](https://github.com/spantaleev/matrix-docker-"
|
||||
"ansible-"
|
||||
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md) and "
|
||||
"hundreds of other more minor (but still important) playbook changes that "
|
||||
"didn't get a mention."
|
||||
msgid "Besides these highlights, there were many other relatively large changes announced in our [CHANGELOG](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md) and hundreds of other more minor (but still important) playbook changes that didn't get a mention."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:61
|
||||
msgid ""
|
||||
"We have **hundreds of contributors to thank for their hard work** on "
|
||||
"making Matrix self-hosting better for all of us! It should be noted that "
|
||||
"**support comes in many shapes**, not only in raw code commits and "
|
||||
"financial help (via [donations](https://liberapay.com/s.pantaleev) or "
|
||||
"using the [etke.cc managed Matrix hosting service](https://etke.cc/) "
|
||||
"which is based on matrix-docker-ansible-deploy). It also comes in the "
|
||||
"shape of code reviews, helping others with "
|
||||
"[issues](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/issues), reporting new issues, participating in our support room "
|
||||
"on Matrix ([#matrix-docker-ansible-deploy:devture.com](https://matrix.to"
|
||||
"/#/#matrix-docker-ansible-deploy:devture.com)), etc. To everyone who has "
|
||||
"been there to make matrix-docker-ansible-deploy better in 2023, thank "
|
||||
"you! 🙇♂️"
|
||||
msgid "We have **hundreds of contributors to thank for their hard work** on making Matrix self-hosting better for all of us! It should be noted that **support comes in many shapes**, not only in raw code commits and financial help (via [donations](https://liberapay.com/s.pantaleev) or using the [etke.cc managed Matrix hosting service](https://etke.cc/) which is based on matrix-docker-ansible-deploy). It also comes in the shape of code reviews, helping others with [issues](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues), reporting new issues, participating in our support room on Matrix ([#matrix-docker-ansible-deploy:devture.com](https://matrix.to/#/#matrix-docker-ansible-deploy:devture.com)), etc. To everyone who has been there to make matrix-docker-ansible-deploy better in 2023, thank you! 🙇♂️"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:64
|
||||
@ -426,34 +170,11 @@ msgid "2022"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:66
|
||||
msgid ""
|
||||
"For [matrix-docker-ansible-deploy](https://github.com/spantaleev/matrix-"
|
||||
"docker-ansible-deploy/), 2022 started with **breaking the** "
|
||||
"[**Synapse**](https://github.com/element-hq/synapse) **monopoly** by "
|
||||
"[adding support](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#dendrite-support) for the [Dendrite](https://github.com/matrix-"
|
||||
"org/dendrite) Matrix homeserver in early January. This required various "
|
||||
"internal changes so that the [Ansible](https://www.ansible.com/) playbook"
|
||||
" would not be Synapse-centric anymore. This groundwork paved the way for "
|
||||
"continuing in this direction and we [added "
|
||||
"support](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#conduit-support) for [Conduit](https://conduit.rs/) in August."
|
||||
msgid "For [matrix-docker-ansible-deploy](https://github.com/spantaleev/matrix-docker-ansible-deploy/), 2022 started with **breaking the** [**Synapse**](https://github.com/element-hq/synapse) **monopoly** by [adding support](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#dendrite-support) for the [Dendrite](https://github.com/matrix-org/dendrite) Matrix homeserver in early January. This required various internal changes so that the [Ansible](https://www.ansible.com/) playbook would not be Synapse-centric anymore. This groundwork paved the way for continuing in this direction and we [added support](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#conduit-support) for [Conduit](https://conduit.rs/) in August."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:68
|
||||
msgid ""
|
||||
"When it comes to the `matrix-docker-ansible-deploy` Ansible playbook, "
|
||||
"2022 was the year of the non-Synapse homeserver implementation. In "
|
||||
"practice, none of these homeserver implementations seem ready for prime-"
|
||||
"time yet and there is no migration path when coming from Synapse. Having "
|
||||
"done our job of adding support for these alternative homeserver "
|
||||
"implementations, we can say that we're not getting in the way of future "
|
||||
"progress. It's time for the Dendrite developers to push harder "
|
||||
"(development-wise) and for the Synapse developers to take a well-deserved"
|
||||
" long (infinite) break, and we may get to see more people migrating away "
|
||||
"from Synapse in the next year(s)."
|
||||
msgid "When it comes to the `matrix-docker-ansible-deploy` Ansible playbook, 2022 was the year of the non-Synapse homeserver implementation. In practice, none of these homeserver implementations seem ready for prime-time yet and there is no migration path when coming from Synapse. Having done our job of adding support for these alternative homeserver implementations, we can say that we're not getting in the way of future progress. It's time for the Dendrite developers to push harder (development-wise) and for the Synapse developers to take a well-deserved long (infinite) break, and we may get to see more people migrating away from Synapse in the next year(s)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:70
|
||||
@ -461,35 +182,19 @@ msgid "Support for the following new **bridges** was added:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:72
|
||||
msgid ""
|
||||
"[Postmoogle](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#postmoogle-email-bridge-support) for bi-directional email bridging, "
|
||||
"which supersedes my old and simplistic "
|
||||
"[email2matrix](https://github.com/devture/email2matrix) one-way bridge-"
|
||||
"bot"
|
||||
msgid "[Postmoogle](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#postmoogle-email-bridge-support) for bi-directional email bridging, which supersedes my old and simplistic [email2matrix](https://github.com/devture/email2matrix) one-way bridge-bot"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:73
|
||||
msgid ""
|
||||
"[mautrix-discord](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#mautrix-discord-support)"
|
||||
msgid "[mautrix-discord](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#mautrix-discord-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:74
|
||||
msgid ""
|
||||
"[go-skype-bridge](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#go-"
|
||||
"skype-bridge-bridging-support)"
|
||||
msgid "[go-skype-bridge](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#go-skype-bridge-bridging-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:75
|
||||
msgid ""
|
||||
"[matrix-appservice-kakaotalk](https://github.com/spantaleev/matrix-"
|
||||
"docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix-"
|
||||
"appservice-kakaotalk-support)"
|
||||
msgid "[matrix-appservice-kakaotalk](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix-appservice-kakaotalk-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:77
|
||||
@ -497,38 +202,23 @@ msgid "Support for the following new **bots** was added:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:79
|
||||
msgid ""
|
||||
"[buscarron bot](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#buscarron-bot-support)"
|
||||
msgid "[buscarron bot](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#buscarron-bot-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:80
|
||||
msgid ""
|
||||
"[Honoroit bot](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#honoroit-bot-support)"
|
||||
msgid "[Honoroit bot](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#honoroit-bot-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:81
|
||||
msgid ""
|
||||
"[matrix-registration-bot](https://github.com/spantaleev/matrix-docker-"
|
||||
"ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#matrix-registration-bot-support)"
|
||||
msgid "[matrix-registration-bot](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix-registration-bot-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:82
|
||||
msgid ""
|
||||
"[matrix-hookshot](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix-"
|
||||
"hookshot-bridging-support)"
|
||||
msgid "[matrix-hookshot](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix-hookshot-bridging-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:83
|
||||
msgid ""
|
||||
"[maubot](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#maubot-"
|
||||
"support)"
|
||||
msgid "[maubot](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#maubot-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:85
|
||||
@ -536,144 +226,65 @@ msgid "Support for the following new **components and services** was added:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:87
|
||||
msgid ""
|
||||
"[BorgBackup](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#borg-"
|
||||
"backup-support)"
|
||||
msgid "[BorgBackup](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#borg-backup-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:88
|
||||
msgid ""
|
||||
"[Cactus Comments](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#cactus-"
|
||||
"comments-support)"
|
||||
msgid "[Cactus Comments](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#cactus-comments-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:89
|
||||
msgid ""
|
||||
"[Cinny](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#cinny-"
|
||||
"support) client support"
|
||||
msgid "[Cinny](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#cinny-support) client support"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:90
|
||||
msgid ""
|
||||
"[ntfy](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#ntfy-"
|
||||
"push-notifications-support) notifications"
|
||||
msgid "[ntfy](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#ntfy-push-notifications-support) notifications"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:91
|
||||
msgid ""
|
||||
"[matrix-ldap-registration-proxy](https://github.com/spantaleev/matrix-"
|
||||
"docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix-"
|
||||
"ldap-registration-proxy-support)"
|
||||
msgid "[matrix-ldap-registration-proxy](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix-ldap-registration-proxy-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:92
|
||||
msgid ""
|
||||
"[matrix\\_encryption\\_disabler support](https://github.com/spantaleev"
|
||||
"/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#matrix_encryption_disabler-support)"
|
||||
msgid "[matrix\\_encryption\\_disabler support](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix_encryption_disabler-support)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:93
|
||||
msgid ""
|
||||
"[synapse-s3-storage-provider](https://github.com/spantaleev/matrix-"
|
||||
"docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#synapse-s3"
|
||||
"-storage-provider-support) to stop the Synapse media store from being a "
|
||||
"scalability problem. This brought along [another "
|
||||
"feature](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#synapse-container-image-customization-support) - an easier way to "
|
||||
"customize the Synapse container image without having to fork and self-"
|
||||
"build all of it from scratch"
|
||||
msgid "[synapse-s3-storage-provider](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#synapse-s3-storage-provider-support) to stop the Synapse media store from being a scalability problem. This brought along [another feature](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#synapse-container-image-customization-support) - an easier way to customize the Synapse container image without having to fork and self-build all of it from scratch"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:95
|
||||
msgid ""
|
||||
"Besides these major user-visible changes, a lot of work also happened "
|
||||
"**under the hood**:"
|
||||
msgid "Besides these major user-visible changes, a lot of work also happened **under the hood**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:97
|
||||
msgid ""
|
||||
"we made [major improvements to Synapse "
|
||||
"workers](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#potential-backward-compatibility-break-major-improvements-to-synapse-"
|
||||
"workers) - adding support for stream writers and for running multiple "
|
||||
"workers of various kinds (federation senders, pushers, background task "
|
||||
"processing workers, etc.)"
|
||||
msgid "we made [major improvements to Synapse workers](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#potential-backward-compatibility-break-major-improvements-to-synapse-workers) - adding support for stream writers and for running multiple workers of various kinds (federation senders, pushers, background task processing workers, etc.)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:98
|
||||
msgid ""
|
||||
"we [improved the compatibility of (Synapse + workers) with the rest of "
|
||||
"the playbook](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#backward-compatibility-break-changing-how-reverse-proxying-to-synapse-"
|
||||
"works---now-via-a-matrix-synapse-reverse-proxy-companion-service) by "
|
||||
"introducing a new `matrix-synapse-reverse-proxy-companion-service` "
|
||||
"service"
|
||||
msgid "we [improved the compatibility of (Synapse + workers) with the rest of the playbook](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#backward-compatibility-break-changing-how-reverse-proxying-to-synapse-works---now-via-a-matrix-synapse-reverse-proxy-companion-service) by introducing a new `matrix-synapse-reverse-proxy-companion-service` service"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:99
|
||||
msgid ""
|
||||
"we started [splitting various Ansible roles out of the Matrix playbook "
|
||||
"and into independent roles](https://github.com/spantaleev/matrix-docker-"
|
||||
"ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
|
||||
"#the-playbook-now-uses-external-roles-for-some-things) (e.g. `matrix-"
|
||||
"postgres` -> [ansible-role-postgres](https://github.com/mother-of-all-"
|
||||
"self-hosting/ansible-role-postgres)), which could be included in other "
|
||||
"Ansible playbooks. In fact, these roles already power a few **interesting"
|
||||
" other sibling playbooks**:"
|
||||
msgid "we started [splitting various Ansible roles out of the Matrix playbook and into independent roles](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#the-playbook-now-uses-external-roles-for-some-things) (e.g. `matrix-postgres` -> [ansible-role-postgres](https://github.com/mother-of-all-self-hosting/ansible-role-postgres)), which could be included in other Ansible playbooks. In fact, these roles already power a few **interesting other sibling playbooks**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:100
|
||||
msgid ""
|
||||
"[gitea-docker-ansible-deploy](https://github.com/spantaleev/gitea-docker-"
|
||||
"ansible-deploy), for deploying a [Gitea](https://gitea.io/) (self-hosted "
|
||||
"[Git](https://git-scm.com/) service) server"
|
||||
msgid "[gitea-docker-ansible-deploy](https://github.com/spantaleev/gitea-docker-ansible-deploy), for deploying a [Gitea](https://gitea.io/) (self-hosted [Git](https://git-scm.com/) service) server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:101
|
||||
msgid ""
|
||||
"[nextcloud-docker-ansible-deploy](https://github.com/spantaleev"
|
||||
"/nextcloud-docker-ansible-deploy), for deploying a "
|
||||
"[Nextcloud](https://nextcloud.com/) groupware server"
|
||||
msgid "[nextcloud-docker-ansible-deploy](https://github.com/spantaleev/nextcloud-docker-ansible-deploy), for deploying a [Nextcloud](https://nextcloud.com/) groupware server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:102
|
||||
msgid ""
|
||||
"[vaultwarden-docker-ansible-deploy](https://github.com/spantaleev"
|
||||
"/vaultwarden-docker-ansible-deploy), for deploying a "
|
||||
"[Vaultwarden](https://github.com/dani-garcia/vaultwarden) password "
|
||||
"manager server (unofficial [Bitwarden](https://bitwarden.com/) compatible"
|
||||
" server)"
|
||||
msgid "[vaultwarden-docker-ansible-deploy](https://github.com/spantaleev/vaultwarden-docker-ansible-deploy), for deploying a [Vaultwarden](https://github.com/dani-garcia/vaultwarden) password manager server (unofficial [Bitwarden](https://bitwarden.com/) compatible server)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:104
|
||||
msgid ""
|
||||
"These sibling playbooks co-exist nicely with one another due to using "
|
||||
"[Traefik](https://traefik.io/) for reverse-proxying, instead of trying to"
|
||||
" overtake the whole server by running their own "
|
||||
"[nginx](https://nginx.org/) reverse-proxy. Hopefully soon, the Matrix "
|
||||
"playbook will follow suit and be powered by Traefik by default."
|
||||
msgid "These sibling playbooks co-exist nicely with one another due to using [Traefik](https://traefik.io/) for reverse-proxying, instead of trying to overtake the whole server by running their own [nginx](https://nginx.org/) reverse-proxy. Hopefully soon, the Matrix playbook will follow suit and be powered by Traefik by default."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../YEAR-IN-REVIEW.md:106
|
||||
msgid ""
|
||||
"Last, but not least, to optimize our [etke.cc managed Matrix hosting "
|
||||
"service](https://etke.cc/)'s performance (but also individual Ansible "
|
||||
"playbook runs for people self-hosting by themselves using the playbook), "
|
||||
"we've [improved playbook runtime 2-5x](https://github.com/spantaleev"
|
||||
"/matrix-docker-ansible-"
|
||||
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#2x-5x-"
|
||||
"performance-improvements-in-playbook-runtime) by employing various "
|
||||
"Ansible tricks."
|
||||
msgid "Last, but not least, to optimize our [etke.cc managed Matrix hosting service](https://etke.cc/)'s performance (but also individual Ansible playbook runs for people self-hosting by themselves using the playbook), we've [improved playbook runtime 2-5x](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) by employing various Ansible tricks."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,29 +26,19 @@ msgid "Table of Contents"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:3
|
||||
msgid ""
|
||||
"⬇️ Installaton guides <!-- NOTE: the 🚀 emoji is used by \"Getting "
|
||||
"started\" on README.md -->"
|
||||
msgid "⬇️ Installaton guides <!-- NOTE: the 🚀 emoji is used by \"Getting started\" on README.md -->"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:5
|
||||
msgid ""
|
||||
"There are two installation guides available for beginners and advanced "
|
||||
"users."
|
||||
msgid "There are two installation guides available for beginners and advanced users."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:7
|
||||
msgid ""
|
||||
"⚡ **[Quick start](quick-start.md) (for beginners)**: this is recommended "
|
||||
"for those who do not have an existing Matrix server and want to start "
|
||||
"quickly with \"opinionated defaults\"."
|
||||
msgid "⚡ **[Quick start](quick-start.md) (for beginners)**: this is recommended for those who do not have an existing Matrix server and want to start quickly with \"opinionated defaults\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:9
|
||||
msgid ""
|
||||
"**Full installation guide (for advanced users)**: if you need to import "
|
||||
"an existing Matrix server's data into the new server or want to learn "
|
||||
"more while setting up the server, follow this guide."
|
||||
msgid "**Full installation guide (for advanced users)**: if you need to import an existing Matrix server's data into the new server or want to learn more while setting up the server, follow this guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:11
|
||||
@ -76,59 +66,39 @@ msgid "🛠️ Configuration options"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:28
|
||||
msgid ""
|
||||
"You can check useful documentation for configuring components here: "
|
||||
"[Configuring the playbook](configuring-playbook.md)"
|
||||
msgid "You can check useful documentation for configuring components here: [Configuring the playbook](configuring-playbook.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:30
|
||||
msgid ""
|
||||
"[Administration](configuring-playbook.md#administration) - services that "
|
||||
"help you in administrating and monitoring your Matrix installation"
|
||||
msgid "[Administration](configuring-playbook.md#administration) - services that help you in administrating and monitoring your Matrix installation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:32
|
||||
msgid ""
|
||||
"[Authentication and user-related](configuring-playbook.md#authentication-"
|
||||
"and-user-related) - extend and modify how users are authenticated on your"
|
||||
" homeserver"
|
||||
msgid "[Authentication and user-related](configuring-playbook.md#authentication-and-user-related) - extend and modify how users are authenticated on your homeserver"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:34
|
||||
msgid ""
|
||||
"[Bots](configuring-playbook.md#bots) - bots provide various additional "
|
||||
"functionality to your installation"
|
||||
msgid "[Bots](configuring-playbook.md#bots) - bots provide various additional functionality to your installation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:36
|
||||
msgid ""
|
||||
"[Bridges](configuring-playbook.md#bridging-other-networks) - bridges can "
|
||||
"be used to connect your Matrix installation with third-party "
|
||||
"communication networks"
|
||||
msgid "[Bridges](configuring-playbook.md#bridging-other-networks) - bridges can be used to connect your Matrix installation with third-party communication networks"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:38
|
||||
msgid ""
|
||||
"[Clients](configuring-playbook.md#clients) - web clients for Matrix that "
|
||||
"you can host on your own domains"
|
||||
msgid "[Clients](configuring-playbook.md#clients) - web clients for Matrix that you can host on your own domains"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:40
|
||||
msgid ""
|
||||
"[Core service adjustments](configuring-playbook.md#core-service-"
|
||||
"adjustments) - backbone of your Matrix system"
|
||||
msgid "[Core service adjustments](configuring-playbook.md#core-service-adjustments) - backbone of your Matrix system"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:42
|
||||
msgid ""
|
||||
"[File Storage](configuring-playbook.md#file-storage) - use alternative "
|
||||
"file storage to the default `media_store` folder"
|
||||
msgid "[File Storage](configuring-playbook.md#file-storage) - use alternative file storage to the default `media_store` folder"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:46
|
||||
msgid ""
|
||||
"[Other specialized services](configuring-playbook.md#other-specialized-"
|
||||
"services) - various services that don't fit any other categories"
|
||||
msgid "[Other specialized services](configuring-playbook.md#other-specialized-services) - various services that don't fit any other categories"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:48
|
||||
@ -136,10 +106,7 @@ msgid "👨🔧 Maintenance"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:50
|
||||
msgid ""
|
||||
"If your server and services experience issues, feel free to come to [our "
|
||||
"support room](https://matrix.to/#/#matrix-docker-ansible-"
|
||||
"deploy:devture.com) and ask for help."
|
||||
msgid "If your server and services experience issues, feel free to come to [our support room](https://matrix.to/#/#matrix-docker-ansible-deploy:devture.com) and ask for help."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:54
|
||||
@ -163,15 +130,11 @@ msgid "[Upgrading services](maintenance-upgrading-services.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:64
|
||||
msgid ""
|
||||
"Other documentation pages <!-- NOTE: this header's title and the section "
|
||||
"below need optimization -->"
|
||||
msgid "Other documentation pages <!-- NOTE: this header's title and the section below need optimization -->"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:66
|
||||
msgid ""
|
||||
"ℹ️ **[FAQ](faq.md)** - various Frequently Asked Questions about Matrix, "
|
||||
"with a focus on this Ansible playbook"
|
||||
msgid "ℹ️ **[FAQ](faq.md)** - various Frequently Asked Questions about Matrix, with a focus on this Ansible playbook"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/README.md:70
|
||||
@ -209,4 +172,3 @@ msgstr ""
|
||||
#: ../../../docs/README.md:86
|
||||
msgid "[Updating users passwords](updating-users-passwords.md)"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,15 +26,11 @@ msgid "Alternative architectures"
|
||||
msgstr "Алтернативни архитектури"
|
||||
|
||||
#: ../../../docs/alternative-architectures.md:3
|
||||
msgid ""
|
||||
"As stated in the [Prerequisites](prerequisites.md), currently only "
|
||||
"`amd64` (`x86_64`) is fully supported."
|
||||
msgid "As stated in the [Prerequisites](prerequisites.md), currently only `amd64` (`x86_64`) is fully supported."
|
||||
msgstr "Както е посочено в [Предусловия](prerequisites.md), в момента само `amd64` (`x86_64`) е напълно поддържана архитектура."
|
||||
|
||||
#: ../../../docs/alternative-architectures.md:5
|
||||
msgid ""
|
||||
"The playbook automatically determines the target server's architecture "
|
||||
"(the `matrix_architecture` variable) to be one of the following:"
|
||||
msgid "The playbook automatically determines the target server's architecture (the `matrix_architecture` variable) to be one of the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/alternative-architectures.md:7
|
||||
@ -50,9 +46,7 @@ msgid "`arm64`"
|
||||
msgstr "`arm64`"
|
||||
|
||||
#: ../../../docs/alternative-architectures.md:11
|
||||
msgid ""
|
||||
"Some tools and container images can be built on the host or other "
|
||||
"measures can be used to install on that architecture."
|
||||
msgid "Some tools and container images can be built on the host or other measures can be used to install on that architecture."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/alternative-architectures.md:13
|
||||
@ -60,19 +54,9 @@ msgid "Implementation details"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/alternative-architectures.md:15
|
||||
msgid ""
|
||||
"For `amd64`, prebuilt container images (see the [container images we use"
|
||||
"](container-images.md)) are used for all components (except [Hydrogen"
|
||||
"](configuring-playbook-client-hydrogen.md), which goes through self-"
|
||||
"building)."
|
||||
msgid "For `amd64`, prebuilt container images (see the [container images we use](container-images.md)) are used for all components (except [Hydrogen](configuring-playbook-client-hydrogen.md), which goes through self-building)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/alternative-architectures.md:17
|
||||
msgid ""
|
||||
"For other architecture (`arm64`, `arm32`), components which have a "
|
||||
"prebuilt image make use of it. If the component is not available for the "
|
||||
"specific architecture, [self-building](self-building.md) will be used. "
|
||||
"Not all components support self-building though, so your mileage may "
|
||||
"vary."
|
||||
msgid "For other architecture (`arm64`, `arm32`), components which have a prebuilt image make use of it. If the component is not available for the specific architecture, [self-building](self-building.md) will be used. Not all components support self-building though, so your mileage may vary."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,17 +26,11 @@ msgid "Running this playbook"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:4
|
||||
msgid ""
|
||||
"This playbook is meant to be run using "
|
||||
"[Ansible](https://www.ansible.com/)."
|
||||
msgid "This playbook is meant to be run using [Ansible](https://www.ansible.com/)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:6
|
||||
msgid ""
|
||||
"Ansible typically runs on your local computer and carries out tasks on a "
|
||||
"remote server. If your local computer cannot run Ansible, you can also "
|
||||
"run Ansible on some server somewhere (including the server you wish to "
|
||||
"install to)."
|
||||
msgid "Ansible typically runs on your local computer and carries out tasks on a remote server. If your local computer cannot run Ansible, you can also run Ansible on some server somewhere (including the server you wish to install to)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:8
|
||||
@ -44,30 +38,19 @@ msgid "Supported Ansible versions"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:10
|
||||
msgid ""
|
||||
"To manually check which version of Ansible you're on, run: `ansible "
|
||||
"--version`."
|
||||
msgid "To manually check which version of Ansible you're on, run: `ansible --version`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:12
|
||||
msgid ""
|
||||
"For the **best experience**, we recommend getting the **latest version of"
|
||||
" Ansible available**."
|
||||
msgid "For the **best experience**, we recommend getting the **latest version of Ansible available**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:14
|
||||
msgid ""
|
||||
"We're not sure what's the minimum version of Ansible that can run this "
|
||||
"playbook successfully. The lowest version that we've confirmed (on "
|
||||
"2022-11-26) to be working fine is: `ansible-core` (`2.11.7`) combined "
|
||||
"with `ansible` (`4.10.0`)."
|
||||
msgid "We're not sure what's the minimum version of Ansible that can run this playbook successfully. The lowest version that we've confirmed (on 2022-11-26) to be working fine is: `ansible-core` (`2.11.7`) combined with `ansible` (`4.10.0`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:16
|
||||
msgid ""
|
||||
"If your distro ships with an Ansible version older than this, you may run"
|
||||
" into issues. Consider [Upgrading Ansible](#upgrading-ansible) or [using "
|
||||
"Ansible via Docker](#using-ansible-via-docker)."
|
||||
msgid "If your distro ships with an Ansible version older than this, you may run into issues. Consider [Upgrading Ansible](#upgrading-ansible) or [using Ansible via Docker](#using-ansible-via-docker)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:18
|
||||
@ -75,45 +58,23 @@ msgid "Upgrading Ansible"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:20
|
||||
msgid ""
|
||||
"Depending on your distribution, you may be able to upgrade Ansible in a "
|
||||
"few different ways:"
|
||||
msgid "Depending on your distribution, you may be able to upgrade Ansible in a few different ways:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:22
|
||||
msgid ""
|
||||
"by using an additional repository (PPA, etc.), which provides newer "
|
||||
"Ansible versions. See instructions for "
|
||||
"[CentOS](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html"
|
||||
"#installing-ansible-on-rhel-centos-or-fedora), "
|
||||
"[Debian](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html"
|
||||
"#installing-ansible-on-debian), or "
|
||||
"[Ubuntu](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html"
|
||||
"#installing-ansible-on-ubuntu) on the Ansible website."
|
||||
msgid "by using an additional repository (PPA, etc.), which provides newer Ansible versions. See instructions for [CentOS](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#installing-ansible-on-rhel-centos-or-fedora), [Debian](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#installing-ansible-on-debian), or [Ubuntu](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#installing-ansible-on-ubuntu) on the Ansible website."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:24
|
||||
msgid ""
|
||||
"by removing the Ansible package (`yum remove ansible` or `apt-get remove "
|
||||
"ansible`) and installing via "
|
||||
"[pip](https://pip.pypa.io/en/stable/installation/) (`pip install "
|
||||
"ansible`)."
|
||||
msgid "by removing the Ansible package (`yum remove ansible` or `apt-get remove ansible`) and installing via [pip](https://pip.pypa.io/en/stable/installation/) (`pip install ansible`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:26
|
||||
msgid ""
|
||||
"If using the `pip` method, do note that the `ansible-playbook` binary may"
|
||||
" not be on the `$PATH` (https://linuxconfig.org/linux-path-environment-"
|
||||
"variable), but in some more special location like `/usr/local/bin"
|
||||
"/ansible-playbook`. You may need to invoke it using the full path."
|
||||
msgid "If using the `pip` method, do note that the `ansible-playbook` binary may not be on the `$PATH` (https://linuxconfig.org/linux-path-environment-variable), but in some more special location like `/usr/local/bin/ansible-playbook`. You may need to invoke it using the full path."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:28
|
||||
msgid ""
|
||||
"**Note**: Both of the above methods are a bad way to run system software "
|
||||
"such as Ansible. If you find yourself needing to resort to such hacks, "
|
||||
"please consider reporting a bug to your distribution and/or switching to "
|
||||
"a sane distribution, which provides up-to-date software."
|
||||
msgid "**Note**: Both of the above methods are a bad way to run system software such as Ansible. If you find yourself needing to resort to such hacks, please consider reporting a bug to your distribution and/or switching to a sane distribution, which provides up-to-date software."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:30
|
||||
@ -121,25 +82,15 @@ msgid "Using Ansible via Docker"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:32
|
||||
msgid ""
|
||||
"Alternatively, you can run Ansible inside a Docker container (powered by "
|
||||
"the [devture/ansible](https://hub.docker.com/r/devture/ansible/) Docker "
|
||||
"image)."
|
||||
msgid "Alternatively, you can run Ansible inside a Docker container (powered by the [devture/ansible](https://hub.docker.com/r/devture/ansible/) Docker image)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:34
|
||||
msgid ""
|
||||
"This ensures that you're using a very recent Ansible version, which is "
|
||||
"less likely to be incompatible with the playbook."
|
||||
msgid "This ensures that you're using a very recent Ansible version, which is less likely to be incompatible with the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:36
|
||||
msgid ""
|
||||
"You can either [run Ansible in a container on the Matrix server itself"
|
||||
"](#running-ansible-in-a-container-on-the-matrix-server-itself) or [run "
|
||||
"Ansible in a container on another computer (not the Matrix server"
|
||||
")](#running-ansible-in-a-container-on-another-computer-not-the-matrix-"
|
||||
"server)."
|
||||
msgid "You can either [run Ansible in a container on the Matrix server itself](#running-ansible-in-a-container-on-the-matrix-server-itself) or [run Ansible in a container on another computer (not the Matrix server)](#running-ansible-in-a-container-on-another-computer-not-the-matrix-server)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:38
|
||||
@ -147,52 +98,27 @@ msgid "Running Ansible in a container on the Matrix server itself"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:40
|
||||
msgid ""
|
||||
"To run Ansible in a (Docker) container on the Matrix server itself, you "
|
||||
"need to have a working Docker installation. Docker is normally installed "
|
||||
"by the playbook, so this may be a bit of a chicken and egg problem. To "
|
||||
"solve it:"
|
||||
msgid "To run Ansible in a (Docker) container on the Matrix server itself, you need to have a working Docker installation. Docker is normally installed by the playbook, so this may be a bit of a chicken and egg problem. To solve it:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:42
|
||||
msgid ""
|
||||
"you **either** need to install Docker manually first. Follow [the "
|
||||
"upstream instructions](https://docs.docker.com/engine/install/) for your "
|
||||
"distribution and consider setting "
|
||||
"`matrix_playbook_docker_installation_enabled: false` in your `vars.yml` "
|
||||
"file, to prevent the playbook from installing Docker"
|
||||
msgid "you **either** need to install Docker manually first. Follow [the upstream instructions](https://docs.docker.com/engine/install/) for your distribution and consider setting `matrix_playbook_docker_installation_enabled: false` in your `vars.yml` file, to prevent the playbook from installing Docker"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:43
|
||||
msgid ""
|
||||
"**or** you need to run the playbook in another way (e.g. [Running Ansible"
|
||||
" in a container on another computer (not the Matrix server)](#running-"
|
||||
"ansible-in-a-container-on-another-computer-not-the-matrix-server)) at "
|
||||
"least the first time around"
|
||||
msgid "**or** you need to run the playbook in another way (e.g. [Running Ansible in a container on another computer (not the Matrix server)](#running-ansible-in-a-container-on-another-computer-not-the-matrix-server)) at least the first time around"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:45
|
||||
msgid ""
|
||||
"Once you have a working Docker installation on the server, **clone the "
|
||||
"playbook** somewhere on the server and configure it as per usual "
|
||||
"(`inventory/hosts`, `inventory/host_vars/..`, etc.), as described in "
|
||||
"[configuring the playbook](configuring-playbook.md)."
|
||||
msgid "Once you have a working Docker installation on the server, **clone the playbook** somewhere on the server and configure it as per usual (`inventory/hosts`, `inventory/host_vars/..`, etc.), as described in [configuring the playbook](configuring-playbook.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:47
|
||||
msgid ""
|
||||
"You would then need to add `ansible_connection=community.docker.nsenter` "
|
||||
"to the host line in `inventory/hosts`. This tells Ansible to connect to "
|
||||
"the \"remote\" machine by switching Linux namespaces with "
|
||||
"[nsenter](https://man7.org/linux/man-pages/man1/nsenter.1.html), instead "
|
||||
"of using SSH."
|
||||
msgid "You would then need to add `ansible_connection=community.docker.nsenter` to the host line in `inventory/hosts`. This tells Ansible to connect to the \"remote\" machine by switching Linux namespaces with [nsenter](https://man7.org/linux/man-pages/man1/nsenter.1.html), instead of using SSH."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:49
|
||||
msgid ""
|
||||
"Alternatively, you can leave your `inventory/hosts` as is and specify the"
|
||||
" connection type in **each** `ansible-playbook` call you do later, like "
|
||||
"this: `ansible-playbook --connection=community.docker.nsenter …`"
|
||||
msgid "Alternatively, you can leave your `inventory/hosts` as is and specify the connection type in **each** `ansible-playbook` call you do later, like this: `ansible-playbook --connection=community.docker.nsenter …`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:51 ../../../docs/ansible.md:71
|
||||
@ -200,23 +126,15 @@ msgid "Run this from the playbook's directory:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:63 ../../../docs/ansible.md:84
|
||||
msgid ""
|
||||
"Once you execute the above command, you'll be dropped into a `/work` "
|
||||
"directory inside a Docker container. The `/work` directory contains the "
|
||||
"playbook's code."
|
||||
msgid "Once you execute the above command, you'll be dropped into a `/work` directory inside a Docker container. The `/work` directory contains the playbook's code."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:65 ../../../docs/ansible.md:86
|
||||
msgid ""
|
||||
"First, consider running `git config --global --add safe.directory /work` "
|
||||
"to [resolve directory ownership issues](#resolve-directory-ownership-"
|
||||
"issues)."
|
||||
msgid "First, consider running `git config --global --add safe.directory /work` to [resolve directory ownership issues](#resolve-directory-ownership-issues)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:67
|
||||
msgid ""
|
||||
"Finally, you can execute `ansible-playbook …` (or `ansible-playbook "
|
||||
"--connection=community.docker.nsenter …`) commands as per normal now."
|
||||
msgid "Finally, you can execute `ansible-playbook …` (or `ansible-playbook --connection=community.docker.nsenter …`) commands as per normal now."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:69
|
||||
@ -224,10 +142,7 @@ msgid "Running Ansible in a container on another computer (not the Matrix server
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:82
|
||||
msgid ""
|
||||
"The above command tries to mount an SSH key (`$HOME/.ssh/id_rsa`) into "
|
||||
"the container (at `/root/.ssh/id_rsa`). If your SSH key is at a different"
|
||||
" path (not in `$HOME/.ssh/id_rsa`), adjust that part."
|
||||
msgid "The above command tries to mount an SSH key (`$HOME/.ssh/id_rsa`) into the container (at `/root/.ssh/id_rsa`). If your SSH key is at a different path (not in `$HOME/.ssh/id_rsa`), adjust that part."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:88
|
||||
@ -239,22 +154,15 @@ msgid "If you don't use SSH keys for authentication"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:92
|
||||
msgid ""
|
||||
"If you don't use SSH keys for authentication, simply remove that whole "
|
||||
"line (`-v $HOME/.ssh/id_rsa:/root/.ssh/id_rsa:ro`)."
|
||||
msgid "If you don't use SSH keys for authentication, simply remove that whole line (`-v $HOME/.ssh/id_rsa:/root/.ssh/id_rsa:ro`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:94
|
||||
msgid ""
|
||||
"To authenticate at your server using a password, you need to add a "
|
||||
"package. So, when you are in the shell of the ansible docker container "
|
||||
"(the previously used `docker run -it …` command), run:"
|
||||
msgid "To authenticate at your server using a password, you need to add a package. So, when you are in the shell of the ansible docker container (the previously used `docker run -it …` command), run:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:100
|
||||
msgid ""
|
||||
"Then, to be asked for the password whenever running an `ansible-"
|
||||
"playbook` command add `--ask-pass` to the arguments of the command."
|
||||
msgid "Then, to be asked for the password whenever running an `ansible-playbook` command add `--ask-pass` to the arguments of the command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:102
|
||||
@ -262,23 +170,13 @@ msgid "Resolve directory ownership issues"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:104
|
||||
msgid ""
|
||||
"Because you're `root` in the container running Ansible and this likely "
|
||||
"differs fom the owner (your regular user account) of the playbook "
|
||||
"directory outside of the container, certain playbook features which use "
|
||||
"`git` locally may report warnings such as:"
|
||||
msgid "Because you're `root` in the container running Ansible and this likely differs fom the owner (your regular user account) of the playbook directory outside of the container, certain playbook features which use `git` locally may report warnings such as:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:106
|
||||
msgid ""
|
||||
"fatal: unsafe repository ('/work' is owned by someone else) To add an "
|
||||
"exception for this directory, call: git config --global --add "
|
||||
"safe.directory /work"
|
||||
msgid "fatal: unsafe repository ('/work' is owned by someone else) To add an exception for this directory, call: git config --global --add safe.directory /work"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/ansible.md:110
|
||||
msgid ""
|
||||
"These errors can be resolved by making `git` trust the playbook directory"
|
||||
" by running `git config --global --add safe.directory /work`"
|
||||
msgid "These errors can be resolved by making `git` trust the playbook directory by running `git config --global --add safe.directory /work`"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -22,9 +22,7 @@ msgstr ""
|
||||
"Generated-By: Babel 2.16.0\n"
|
||||
|
||||
#: ../../../docs/configuring-captcha.md:1
|
||||
msgid ""
|
||||
"(Adapted from the [upstream project](https://github.com/element-"
|
||||
"hq/synapse/blob/develop/docs/CAPTCHA_SETUP.md))"
|
||||
msgid "(Adapted from the [upstream project](https://github.com/element-hq/synapse/blob/develop/docs/CAPTCHA_SETUP.md))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-captcha.md:3
|
||||
@ -32,17 +30,11 @@ msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-captcha.md:5
|
||||
msgid ""
|
||||
"Captcha can be enabled for this home server. This file explains how to do"
|
||||
" that."
|
||||
msgid "Captcha can be enabled for this home server. This file explains how to do that."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-captcha.md:7
|
||||
msgid ""
|
||||
"The captcha mechanism used is Google's "
|
||||
"[ReCaptcha](https://www.google.com/recaptcha/). This requires API keys "
|
||||
"from Google. If your homeserver is Dendrite then "
|
||||
"[hCapcha](https://www.hcaptcha.com) can be used instead."
|
||||
msgid "The captcha mechanism used is Google's [ReCaptcha](https://www.google.com/recaptcha/). This requires API keys from Google. If your homeserver is Dendrite then [hCapcha](https://www.hcaptcha.com) can be used instead."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-captcha.md:9
|
||||
@ -64,9 +56,7 @@ msgid "<http://www.google.com/recaptcha/admin>"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-captcha.md:17
|
||||
msgid ""
|
||||
"Must be a reCAPTCHA **v2** key using the \"I'm not a robot\" Checkbox "
|
||||
"option"
|
||||
msgid "Must be a reCAPTCHA **v2** key using the \"I'm not a robot\" Checkbox option"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-captcha.md:19
|
||||
@ -74,9 +64,7 @@ msgid "Setting ReCaptcha keys"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-captcha.md:21
|
||||
msgid ""
|
||||
"Once registered as above, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Once registered as above, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-captcha.md:35
|
||||
@ -90,4 +78,3 @@ msgstr ""
|
||||
#: ../../../docs/configuring-captcha.md:43
|
||||
msgid "Setting hCaptcha keys"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,10 +26,7 @@ msgid "Configuring your DNS settings"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:3
|
||||
msgid ""
|
||||
"<sup>[Prerequisites](prerequisites.md) > Configuring your DNS settings > "
|
||||
"[Getting the playbook](getting-the-playbook.md) > [Configuring the "
|
||||
"playbook](configuring-playbook.md) > [Installing](installing.md)</sup>"
|
||||
msgid "<sup>[Prerequisites](prerequisites.md) > Configuring your DNS settings > [Getting the playbook](getting-the-playbook.md) > [Configuring the playbook](configuring-playbook.md) > [Installing](installing.md)</sup>"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:5
|
||||
@ -41,30 +38,19 @@ msgid "DNS setting for server delegation (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:9
|
||||
msgid ""
|
||||
"In the sample `vars.yml` ([`examples/vars.yml`](../examples/vars.yml)), "
|
||||
"we recommend to use a short user ID like `@alice:example.com` instead of "
|
||||
"`@alice:matrix.example.com`."
|
||||
msgid "In the sample `vars.yml` ([`examples/vars.yml`](../examples/vars.yml)), we recommend to use a short user ID like `@alice:example.com` instead of `@alice:matrix.example.com`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:11
|
||||
msgid ""
|
||||
"To use such an ID, you don't need to install anything on the actual "
|
||||
"`example.com` server. Instead, you need to instruct the Matrix network "
|
||||
"that Matrix services for `example.com` are redirected over to "
|
||||
"`matrix.example.com`. This redirection is also known as \"delegation\"."
|
||||
msgid "To use such an ID, you don't need to install anything on the actual `example.com` server. Instead, you need to instruct the Matrix network that Matrix services for `example.com` are redirected over to `matrix.example.com`. This redirection is also known as \"delegation\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:13
|
||||
msgid ""
|
||||
"As we discuss in [Server Delegation](howto-server-delegation.md), server "
|
||||
"delegation can be configured in either of these ways:"
|
||||
msgid "As we discuss in [Server Delegation](howto-server-delegation.md), server delegation can be configured in either of these ways:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:15
|
||||
msgid ""
|
||||
"Setting up a `/.well-known/matrix/server` file on the base domain "
|
||||
"(`example.com`)"
|
||||
msgid "Setting up a `/.well-known/matrix/server` file on the base domain (`example.com`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:16
|
||||
@ -72,29 +58,15 @@ msgid "Setting up a `_matrix._tcp` DNS SRV record"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:18
|
||||
msgid ""
|
||||
"For simplicity reasons, this playbook recommends you to set up server "
|
||||
"delegation via a `/.well-known/matrix/server` file, instead of using a "
|
||||
"DNS SRV record."
|
||||
msgid "For simplicity reasons, this playbook recommends you to set up server delegation via a `/.well-known/matrix/server` file, instead of using a DNS SRV record."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:20
|
||||
msgid ""
|
||||
"If you choose the recommended method (file-based delegation), you do not "
|
||||
"need to configure the DNS record to enable server delegation. You will "
|
||||
"need to add a necessary configuration later, when you [finalize the "
|
||||
"installation](installing.md#finalize-the-installation) after installing "
|
||||
"and starting Matrix services."
|
||||
msgid "If you choose the recommended method (file-based delegation), you do not need to configure the DNS record to enable server delegation. You will need to add a necessary configuration later, when you [finalize the installation](installing.md#finalize-the-installation) after installing and starting Matrix services."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:22
|
||||
msgid ""
|
||||
"On the other hand, if you choose this method (setting up a DNS SRV "
|
||||
"record), you need to configure the additional DNS record as well as "
|
||||
"adjust SSL certificate handling. Take a look at this documentation for "
|
||||
"more information: [Server Delegation via a DNS SRV record (advanced"
|
||||
")](howto-server-delegation.md#server-delegation-via-a-dns-srv-record-"
|
||||
"advanced)"
|
||||
msgid "On the other hand, if you choose this method (setting up a DNS SRV record), you need to configure the additional DNS record as well as adjust SSL certificate handling. Take a look at this documentation for more information: [Server Delegation via a DNS SRV record (advanced)](howto-server-delegation.md#server-delegation-via-a-dns-srv-record-advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:24
|
||||
@ -102,10 +74,7 @@ msgid "DNS settings for services enabled by default"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:26
|
||||
msgid ""
|
||||
"To serve the base domain (`example.com`) and [Element Web](configuring-"
|
||||
"playbook-client-element-web.md) with the default subdomain, adjust DNS "
|
||||
"records as below."
|
||||
msgid "To serve the base domain (`example.com`) and [Element Web](configuring-playbook-client-element-web.md) with the default subdomain, adjust DNS records as below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md
|
||||
@ -161,20 +130,11 @@ msgid "`matrix.example.com`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:33
|
||||
msgid ""
|
||||
"As the table illustrates, you need to create 2 subdomains "
|
||||
"(`matrix.example.com` and `element.example.com`) and point both of them "
|
||||
"to your server's IP address (DNS `A` record or `CNAME` record is fine)."
|
||||
msgid "As the table illustrates, you need to create 2 subdomains (`matrix.example.com` and `element.example.com`) and point both of them to your server's IP address (DNS `A` record or `CNAME` record is fine)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:35
|
||||
msgid ""
|
||||
"The `element.example.com` subdomain is necessary, because this playbook "
|
||||
"installs the [Element Web](https://github.com/element-hq/element-web) "
|
||||
"client for you by default. If you'd rather instruct the playbook not to "
|
||||
"install Element Web (`matrix_client_element_enabled: false` when "
|
||||
"[Configuring the playbook](configuring-playbook.md) later), feel free to "
|
||||
"skip the `element.example.com` DNS record."
|
||||
msgid "The `element.example.com` subdomain is necessary, because this playbook installs the [Element Web](https://github.com/element-hq/element-web) client for you by default. If you'd rather instruct the playbook not to install Element Web (`matrix_client_element_enabled: false` when [Configuring the playbook](configuring-playbook.md) later), feel free to skip the `element.example.com` DNS record."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:37
|
||||
@ -182,9 +142,7 @@ msgid "Be mindful as to how long it will take for the DNS records to propagate."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:39
|
||||
msgid ""
|
||||
"If you are using Cloudflare DNS, make sure to disable the proxy and set "
|
||||
"all records to \"DNS only\". Otherwise, fetching certificates will fail."
|
||||
msgid "If you are using Cloudflare DNS, make sure to disable the proxy and set all records to \"DNS only\". Otherwise, fetching certificates will fail."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:41
|
||||
@ -192,9 +150,7 @@ msgid "DNS settings for optional services/features"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:43
|
||||
msgid ""
|
||||
"For other services which may need subdomain settings, see the table below"
|
||||
" and configure the DNS (`CNAME`) records accordingly."
|
||||
msgid "For other services which may need subdomain settings, see the table below and configure the DNS (`CNAME`) records accordingly."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md
|
||||
@ -218,9 +174,7 @@ msgid "`jitsi`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md
|
||||
msgid ""
|
||||
"[Prometheus/Grafana](configuring-playbook-prometheus-grafana.md) "
|
||||
"monitoring system"
|
||||
msgid "[Prometheus/Grafana](configuring-playbook-prometheus-grafana.md) monitoring system"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md
|
||||
@ -332,9 +286,7 @@ msgid "443"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md
|
||||
msgid ""
|
||||
"[Postmoogle](configuring-playbook-bridge-postmoogle.md)/[Email2Matrix"
|
||||
"](configuring-playbook-email2matrix.md) email bridges"
|
||||
msgid "[Postmoogle](configuring-playbook-bridge-postmoogle.md)/[Email2Matrix](configuring-playbook-email2matrix.md) email bridges"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md
|
||||
@ -374,20 +326,11 @@ msgid "SRV record for ma1sd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:68
|
||||
msgid ""
|
||||
"To make ma1sd enable its federation features, you need to set up a "
|
||||
"`_matrix-identity._tcp` SRV record. Don't confuse this with the "
|
||||
"`_matrix._tcp` SRV record for server delegation. See the table above and "
|
||||
"[this section](configuring-playbook-ma1sd.md#adjusting-dns-records) for "
|
||||
"values which need to be specified."
|
||||
msgid "To make ma1sd enable its federation features, you need to set up a `_matrix-identity._tcp` SRV record. Don't confuse this with the `_matrix._tcp` SRV record for server delegation. See the table above and [this section](configuring-playbook-ma1sd.md#adjusting-dns-records) for values which need to be specified."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:70
|
||||
msgid ""
|
||||
"When setting up a SRV record, if you are asked for a service and protocol"
|
||||
" instead of a hostname split the host value from the table where the "
|
||||
"period is. For example use service as `_matrix-identity` and protocol as "
|
||||
"`_tcp`."
|
||||
msgid "When setting up a SRV record, if you are asked for a service and protocol instead of a hostname split the host value from the table where the period is. For example use service as `_matrix-identity` and protocol as `_tcp`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:72
|
||||
@ -395,16 +338,9 @@ msgid "MX and TXT records for Postmoogle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:74
|
||||
msgid ""
|
||||
"To make Postmoogle enable its email sending features, you need to "
|
||||
"configure MX and TXT (SPF, DMARC, and DKIM) records. See the table above "
|
||||
"for values which need to be specified."
|
||||
msgid "To make Postmoogle enable its email sending features, you need to configure MX and TXT (SPF, DMARC, and DKIM) records. See the table above for values which need to be specified."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-dns.md:78
|
||||
msgid ""
|
||||
"[▶️](getting-the-playbook.md) When you're done with the DNS configuration"
|
||||
" and ready to proceed, continue with [Getting the playbook](getting-the-"
|
||||
"playbook.md)."
|
||||
msgid "[▶️](getting-the-playbook.md) When you're done with the DNS configuration and ready to proceed, continue with [Getting the playbook](getting-the-playbook.md)."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -22,37 +22,19 @@ msgstr ""
|
||||
"Generated-By: Babel 2.16.0\n"
|
||||
|
||||
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:1
|
||||
msgid ""
|
||||
"Setting up Prometheus Alertmanager integration via matrix-alertmanager-"
|
||||
"receiver (optional)"
|
||||
msgid "Setting up Prometheus Alertmanager integration via matrix-alertmanager-receiver (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [matrix-alertmanager-"
|
||||
"receiver](https://github.com/metio/matrix-alertmanager-receiver) service "
|
||||
"for you. It's a "
|
||||
"[client](https://prometheus.io/docs/alerting/latest/clients/) for "
|
||||
"Prometheus' "
|
||||
"[Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/),"
|
||||
" allowing you to deliver alerts to Matrix rooms."
|
||||
msgid "The playbook can install and configure the [matrix-alertmanager-receiver](https://github.com/metio/matrix-alertmanager-receiver) service for you. It's a [client](https://prometheus.io/docs/alerting/latest/clients/) for Prometheus' [Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/), allowing you to deliver alerts to Matrix rooms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:5
|
||||
msgid ""
|
||||
"See the project's [documentation](https://github.com/metio/matrix-"
|
||||
"alertmanager-receiver/blob/main/README.md) to learn what it does and why "
|
||||
"it might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/metio/matrix-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 ""
|
||||
"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 & "
|
||||
"Grafana stack](./configuring-playbook-prometheus-grafana.md) installed by"
|
||||
" this playbook, because the Alertmanager component is not installed by "
|
||||
"it."
|
||||
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 & Grafana stack](./configuring-playbook-prometheus-grafana.md) installed by this playbook, because the Alertmanager component is not installed by it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:9
|
||||
@ -64,22 +46,15 @@ msgid "Register the bot account"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:13
|
||||
msgid ""
|
||||
"This service uses a bot (with a username specified in "
|
||||
"`matrix_alertmanager_receiver_config_matrix_user_id_localpart`) for "
|
||||
"delivering messages."
|
||||
msgid "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:15
|
||||
msgid ""
|
||||
"The playbook does not automatically create users for you. 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-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`."
|
||||
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
|
||||
@ -91,10 +66,7 @@ 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)."
|
||||
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
|
||||
@ -102,21 +74,15 @@ 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."
|
||||
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."
|
||||
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."
|
||||
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
|
||||
@ -124,17 +90,11 @@ 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)."
|
||||
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."
|
||||
msgid "See `roles/custom/matrix-alertmanager-receiver/defaults/main.yml` for additional configuration variables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:63
|
||||
@ -142,26 +102,15 @@ msgid "Adjusting the matrix-alertmanager-receiver URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"(https://matrix.example.com/matrix-alertmanager-receiver). This makes it "
|
||||
"easy to install it, because it **doesn't require additional DNS records "
|
||||
"to be set up**. If that's okay, you can skip this section."
|
||||
msgid "By default, this playbook installs matrix-alertmanager-receiver on the `matrix.` subdomain, at the `/matrix-alertmanager-receiver` path (https://matrix.example.com/matrix-alertmanager-receiver). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
" the service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_alertmanager_receiver_hostname` and `matrix_alertmanager_receiver_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-alertmanager-receiver.md:69
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:77
|
||||
@ -169,10 +118,7 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:81
|
||||
@ -180,9 +126,7 @@ msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:85
|
||||
@ -190,10 +134,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87
|
||||
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:"
|
||||
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-alertmanager-receiver.md:94
|
||||
@ -201,24 +142,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:98
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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:100
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:102
|
||||
@ -230,127 +162,5 @@ msgid "Configure your Prometheus Alertmanager with configuration like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:123
|
||||
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`."
|
||||
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 ""
|
||||
#~ "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 ""
|
||||
|
||||
|
||||
@ -26,28 +26,15 @@ msgid "Setting up Appservice Double Puppet (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:3
|
||||
msgid ""
|
||||
"Appservice Double Puppet is a homeserver appservice through which bridges"
|
||||
" (and potentially other services) can impersonate any user on the "
|
||||
"homeserver."
|
||||
msgid "Appservice Double Puppet is a homeserver appservice through which bridges (and potentially other services) can impersonate any user on the homeserver."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:5
|
||||
msgid ""
|
||||
"This is useful for performing [double-"
|
||||
"puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) via"
|
||||
" the [appservice method](https://docs.mau.fi/bridges/general/double-"
|
||||
"puppeting.html#appservice-method-new). The Appservice Double Puppet "
|
||||
"service is an implementation of this approach."
|
||||
msgid "This is useful for performing [double-puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) via the [appservice method](https://docs.mau.fi/bridges/general/double-puppeting.html#appservice-method-new). The Appservice Double Puppet service is an implementation of this approach."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:7
|
||||
msgid ""
|
||||
"Previously, bridges supported performing [double-"
|
||||
"puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
|
||||
"with the help of the [Shared Secret Auth password provider module"
|
||||
"](./configuring-playbook-shared-secret-auth.md), but this old and hacky "
|
||||
"solution has been superseded by this Appservice Double Puppet method."
|
||||
msgid "Previously, bridges supported performing [double-puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) with the help of the [Shared Secret Auth password provider module](./configuring-playbook-shared-secret-auth.md), but this old and hacky solution has been superseded by this Appservice Double Puppet method."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:9
|
||||
@ -55,10 +42,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:11
|
||||
msgid ""
|
||||
"To enable the Appservice Double Puppet service, add the following "
|
||||
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"file:"
|
||||
msgid "To enable the Appservice Double Puppet service, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:17
|
||||
@ -66,9 +50,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:19
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:26
|
||||
@ -76,24 +58,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:28
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:30
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-double-puppet.md:32
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:34
|
||||
@ -101,8 +74,5 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:36
|
||||
msgid ""
|
||||
"When enabled, double puppeting will automatically be enabled for all "
|
||||
"bridges that support double puppeting via the appservice method."
|
||||
msgid "When enabled, double puppeting will automatically be enabled for all bridges that support double puppeting via the appservice method."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,17 +26,11 @@ msgid "Setting up Draupnir for All/D4A (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [Draupnir](https://github.com"
|
||||
"/the-draupnir-project/Draupnir) moderation tool for you in appservice "
|
||||
"mode."
|
||||
msgid "The playbook can install and configure the [Draupnir](https://github.com/the-draupnir-project/Draupnir) moderation tool for you in appservice mode."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:5
|
||||
msgid ""
|
||||
"Appservice mode can be used together with the regular [Draupnir bot"
|
||||
"](configuring-playbook-bot-draupnir.md) or independently. Details about "
|
||||
"the differences between the 2 modes are described below."
|
||||
msgid "Appservice mode can be used together with the regular [Draupnir bot](configuring-playbook-bot-draupnir.md) or independently. Details about the differences between the 2 modes are described below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:7
|
||||
@ -44,43 +38,23 @@ msgid "Draupnir Appservice mode compared to Draupnir bot mode"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:9
|
||||
msgid ""
|
||||
"The administrative functions for managing the appservice are alpha "
|
||||
"quality and very limited. However, the experience of using an appservice-"
|
||||
"provisioned Draupnir is on par with the experience of using Draupnir from"
|
||||
" bot mode except in the case of avatar customisation as described later "
|
||||
"on in this document."
|
||||
msgid "The administrative functions for managing the appservice are alpha quality and very limited. However, the experience of using an appservice-provisioned Draupnir is on par with the experience of using Draupnir from bot mode except in the case of avatar customisation as described later on in this document."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:11
|
||||
msgid ""
|
||||
"Draupnir for all is the way to go if you need more than 1 Draupnir "
|
||||
"instance, but you don't need access to Synapse Admin features as they are"
|
||||
" not accessible through Draupnir for All (Even though the commands do "
|
||||
"show up in help)."
|
||||
msgid "Draupnir for all is the way to go if you need more than 1 Draupnir instance, but you don't need access to Synapse Admin features as they are not accessible through Draupnir for All (Even though the commands do show up in help)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:13
|
||||
msgid ""
|
||||
"Draupnir for all in the playbook is rate-limit-exempt automatically as "
|
||||
"its appservice configuration file does not specify any rate limits."
|
||||
msgid "Draupnir for all in the playbook is rate-limit-exempt automatically as its appservice configuration file does not specify any rate limits."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:15
|
||||
msgid ""
|
||||
"Normal Draupnir does come with the benefit of access to Synapse Admin "
|
||||
"features. You are also able to more easily customise your normal Draupnir"
|
||||
" than D4A as D4A even on the branch with the Avatar command (To be "
|
||||
"Upstreamed to Mainline Draupnir) that command is clunky as it requires "
|
||||
"the use of things like Element Web devtools. In normal Draupnir this is a"
|
||||
" quick operation where you login to Draupnir with a normal client and set"
|
||||
" Avatar and Display name normally."
|
||||
msgid "Normal Draupnir does come with the benefit of access to Synapse Admin features. You are also able to more easily customise your normal Draupnir than D4A as D4A even on the branch with the Avatar command (To be Upstreamed to Mainline Draupnir) that command is clunky as it requires the use of things like Element Web devtools. In normal Draupnir this is a quick operation where you login to Draupnir with a normal client and set Avatar and Display name normally."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:17
|
||||
msgid ""
|
||||
"Draupnir for all does not support external tooling like "
|
||||
"[MRU](https://mru.rory.gay) as it can't access Draupnir's user account."
|
||||
msgid "Draupnir for all does not support external tooling like [MRU](https://mru.rory.gay) as it can't access Draupnir's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:19
|
||||
@ -92,9 +66,7 @@ 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. "
|
||||
"You **need to create the room manually** before setting up the bot."
|
||||
msgid "The playbook does not create a management room for your Main Draupnir. You **need to create the room manually** before setting up the bot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:25
|
||||
@ -102,25 +74,15 @@ 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."
|
||||
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: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"
|
||||
" your bot must have sufficient powerlevel to send custom state events. "
|
||||
"This is default 50 or moderator as Element clients call this powerlevel."
|
||||
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 your bot must have sufficient powerlevel to send custom state events. This is default 50 or moderator as Element clients call this powerlevel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:33
|
||||
msgid ""
|
||||
"As noted in the Draupnir install instructions the control room is "
|
||||
"sensitive. **Anyone in this room can control the bot so it is important "
|
||||
"that you only invite trusted users to this room.**"
|
||||
msgid "As noted in the Draupnir install instructions the control room is 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:35
|
||||
@ -132,11 +94,7 @@ msgid "Next, set an alias to the management room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:39
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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:41
|
||||
@ -144,10 +102,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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. Make sure to "
|
||||
"replace `MANAGEMENT_ROOM_ALIAS_HERE`."
|
||||
msgid "Add the following configuration to your `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:51
|
||||
@ -155,22 +110,15 @@ msgid "Extending the configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:53
|
||||
msgid ""
|
||||
"You can configure additional options by adding the "
|
||||
"`matrix_appservice_draupnir_for_all_extension_yaml` variable."
|
||||
msgid "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: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:"
|
||||
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."
|
||||
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
|
||||
@ -179,19 +127,11 @@ 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."
|
||||
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."
|
||||
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
|
||||
@ -199,30 +139,19 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:90
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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:92
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:94
|
||||
@ -230,17 +159,11 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:98
|
||||
msgid ""
|
||||
"The installation of Draupnir for all in this playbook is very much Alpha "
|
||||
"quality. Usage-wise, Draupnir for all is almost identical to Draupnir bot"
|
||||
" mode."
|
||||
msgid "The installation of Draupnir for all in this playbook is very much Alpha quality. Usage-wise, Draupnir for all is almost identical to Draupnir bot mode."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:100
|
||||
@ -248,32 +171,15 @@ msgid "Granting Users the ability to use D4A"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"to this list we have 2 primary options. Using the chat to tell Draupnir "
|
||||
"to do this for us or if you want to automatically do it by sending "
|
||||
"`m.policy.rule.user` events that target the subject you want to allow "
|
||||
"provisioning for with the `org.matrix.mjolnir.allow` recomendation. Using"
|
||||
" the chat is recomended."
|
||||
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 to this list we have 2 primary options. Using the chat to tell Draupnir to do this for us or if you want to automatically do it by sending `m.policy.rule.user` events that target the subject you want to allow provisioning for with the `org.matrix.mjolnir.allow` recomendation. Using the chat is recomended."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"this is true or false. (This is considered a bug and is documented in "
|
||||
"issue [#297](https://github.com/the-draupnir-"
|
||||
"project/Draupnir/issues/297))"
|
||||
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 this is true or false. (This is considered a bug and is documented in issue [#297](https://github.com/the-draupnir-project/Draupnir/issues/297))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"wildcard like `@*:example.com` to allow all users on example.com to "
|
||||
"register. We use /plain to force the client to not attempt to mess with "
|
||||
"this command as it can break Wildcard commands especially."
|
||||
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 wildcard like `@*:example.com` to allow all users on example.com to register. We use /plain to force the client to not attempt to mess with this command as it can break Wildcard commands especially."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:108
|
||||
@ -281,141 +187,9 @@ msgid "How to provision a D4A once you are allowed to"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:110
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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:112
|
||||
msgid ""
|
||||
"Congratulations if you made it all the way here because you now have a "
|
||||
"fully working Draupnir for all deployment."
|
||||
msgid "Congratulations if you made it all the way here because you now have a fully working Draupnir for all deployment."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Installation"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Create a main management room."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The playbook does not create a "
|
||||
#~ "management room for your Main Draupnir."
|
||||
#~ " This task you have to do on"
|
||||
#~ " your own."
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@ -26,50 +26,27 @@ msgid "Setting up BorgBackup (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure "
|
||||
"[BorgBackup](https://www.borgbackup.org/) (short: Borg) with "
|
||||
"[borgmatic](https://torsion.org/borgmatic/) for you."
|
||||
msgid "The playbook can install and configure [BorgBackup](https://www.borgbackup.org/) (short: Borg) with [borgmatic](https://torsion.org/borgmatic/) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:5
|
||||
msgid ""
|
||||
"BorgBackup is a deduplicating backup program with optional compression "
|
||||
"and encryption. That means your daily incremental backups can be stored "
|
||||
"in a fraction of the space and is safe whether you store it at home or on"
|
||||
" a cloud service."
|
||||
msgid "BorgBackup is a deduplicating backup program with optional compression and encryption. That means your daily incremental backups can be stored in a fraction of the space and is safe whether you store it at home or on a cloud service."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:7
|
||||
msgid ""
|
||||
"You will need a remote server where BorgBackup will store the backups. "
|
||||
"There are hosted, BorgBackup compatible solutions available, such as "
|
||||
"[BorgBase](https://www.borgbase.com)."
|
||||
msgid "You will need a remote server where BorgBackup will store the backups. There are hosted, BorgBackup compatible solutions available, such as [BorgBase](https://www.borgbase.com)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:9
|
||||
msgid ""
|
||||
"The backup will run based on `backup_borg_schedule` var (systemd timer "
|
||||
"calendar), default: 4am every day."
|
||||
msgid "The backup will run based on `backup_borg_schedule` var (systemd timer calendar), default: 4am every day."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:11
|
||||
msgid ""
|
||||
"By default, if you're using the integrated Postgres database server (as "
|
||||
"opposed to [an external Postgres server](configuring-playbook-external-"
|
||||
"postgres.md)), backups with BorgBackup will also include dumps of your "
|
||||
"Postgres database. An alternative solution for backing up the Postgres "
|
||||
"database is [postgres backup](configuring-playbook-postgres-backup.md). "
|
||||
"If you decide to go with another solution, you can disable Postgres-"
|
||||
"backup support for BorgBackup using the `backup_borg_postgresql_enabled` "
|
||||
"variable."
|
||||
msgid "By default, if you're using the integrated Postgres database server (as opposed to [an external Postgres server](configuring-playbook-external-postgres.md)), backups with BorgBackup will also include dumps of your Postgres database. An alternative solution for backing up the Postgres database is [postgres backup](configuring-playbook-postgres-backup.md). If you decide to go with another solution, you can disable Postgres-backup support for BorgBackup using the `backup_borg_postgresql_enabled` variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:13
|
||||
msgid ""
|
||||
"**Note**: the component is not managed by this repository but its [own "
|
||||
"repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
|
||||
"backup_borg)."
|
||||
msgid "**Note**: the component is not managed by this repository but its [own repository](https://github.com/mother-of-all-self-hosting/ansible-role-backup_borg)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:15
|
||||
@ -77,10 +54,7 @@ msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:17
|
||||
msgid ""
|
||||
"If you do not disable Postgres-backup support, make sure that the "
|
||||
"Postgres version of your homeserver's database is compatible with "
|
||||
"borgmatic."
|
||||
msgid "If you do not disable Postgres-backup support, make sure that the Postgres version of your homeserver's database is compatible with borgmatic."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:19
|
||||
@ -88,21 +62,15 @@ msgid "Create a new SSH key:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:25
|
||||
msgid ""
|
||||
"This can be done on any machine and you don't need to place the key in "
|
||||
"the `.ssh` folder. It will be added to the Ansible config later."
|
||||
msgid "This can be done on any machine and you don't need to place the key in the `.ssh` folder. It will be added to the Ansible config later."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:27
|
||||
msgid ""
|
||||
"Add the **public** part of this SSH key (the `matrix-borg-backup.pub` "
|
||||
"file) to your BorgBackup provider/server:"
|
||||
msgid "Add the **public** part of this SSH key (the `matrix-borg-backup.pub` file) to your BorgBackup provider/server:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:29
|
||||
msgid ""
|
||||
"If you plan to use a hosted solution, follow their instructions. If you "
|
||||
"have your own server, copy the key over:"
|
||||
msgid "If you plan to use a hosted solution, follow their instructions. If you have your own server, copy the key over:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:39
|
||||
@ -110,9 +78,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:41
|
||||
msgid ""
|
||||
"Minimal working configuration "
|
||||
"(`inventory/host_vars/matrix.example.com/vars.yml`) to enable BorgBackup:"
|
||||
msgid "Minimal working configuration (`inventory/host_vars/matrix.example.com/vars.yml`) to enable BorgBackup:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:58
|
||||
@ -128,50 +94,27 @@ msgid "HOST - SSH host of a provider/server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:62
|
||||
msgid ""
|
||||
"REPO - BorgBackup repository name, it will be initialized on backup "
|
||||
"start, eg: `matrix`, regarding Syntax see [Remote "
|
||||
"repositories](https://borgbackup.readthedocs.io/en/stable/usage/general.html"
|
||||
"#repository-urls)"
|
||||
msgid "REPO - BorgBackup repository name, it will be initialized on backup start, eg: `matrix`, regarding Syntax see [Remote repositories](https://borgbackup.readthedocs.io/en/stable/usage/general.html#repository-urls)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:63
|
||||
msgid ""
|
||||
"PASSPHRASE - passphrase used for encrypting backups, you may generate it "
|
||||
"with `pwgen -s 64 1` or use any password manager"
|
||||
msgid "PASSPHRASE - passphrase used for encrypting backups, you may generate it with `pwgen -s 64 1` or use any password manager"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:64
|
||||
msgid ""
|
||||
"PRIVATE KEY - the content of the **private** part of the SSH key you "
|
||||
"created before. The whole key (all of its belonging lines) under "
|
||||
"`backup_borg_ssh_key_private` needs to be indented with 2 spaces"
|
||||
msgid "PRIVATE KEY - the content of the **private** part of the SSH key you created before. The whole key (all of its belonging lines) under `backup_borg_ssh_key_private` needs to be indented with 2 spaces"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:66
|
||||
msgid ""
|
||||
"To backup without encryption, add `backup_borg_encryption: 'none'` to "
|
||||
"your vars. This will also enable the "
|
||||
"`backup_borg_unknown_unencrypted_repo_access_is_ok` variable."
|
||||
msgid "To backup without encryption, add `backup_borg_encryption: 'none'` to your vars. This will also enable the `backup_borg_unknown_unencrypted_repo_access_is_ok` variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:68
|
||||
msgid ""
|
||||
"`backup_borg_location_source_directories` defines the list of directories"
|
||||
" to back up: it's set to `{{ matrix_base_data_path }}` by default, which "
|
||||
"is the base directory for every service's data, such as Synapse, Postgres"
|
||||
" and the bridges. You might want to exclude certain directories or file "
|
||||
"patterns from the backup using the "
|
||||
"`backup_borg_location_exclude_patterns` variable."
|
||||
msgid "`backup_borg_location_source_directories` defines the list of directories to back up: it's set to `{{ matrix_base_data_path }}` by default, which is the base directory for every service's data, such as Synapse, Postgres and the bridges. You might want to exclude certain directories or file patterns from the backup using the `backup_borg_location_exclude_patterns` variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:70
|
||||
msgid ""
|
||||
"Check the [backup_borg role](https://github.com/mother-of-all-self-"
|
||||
"hosting/ansible-role-backup_borg)'s "
|
||||
"[defaults/main.yml](https://github.com/mother-of-all-self-hosting"
|
||||
"/ansible-role-backup_borg/blob/main/defaults/main.yml) file for the full "
|
||||
"list of available options."
|
||||
msgid "Check the [backup_borg role](https://github.com/mother-of-all-self-hosting/ansible-role-backup_borg)'s [defaults/main.yml](https://github.com/mother-of-all-self-hosting/ansible-role-backup_borg/blob/main/defaults/main.yml) file for the full list of available options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:72
|
||||
@ -179,25 +122,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:74
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:81
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.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."
|
||||
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-backup-borg.md:85
|
||||
@ -205,12 +138,5 @@ msgid "Manually start a backup"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-backup-borg.md:87
|
||||
msgid ""
|
||||
"For testing your setup it can be helpful to not wait until 4am. If you "
|
||||
"want to run the backup immediately, log onto the server and run "
|
||||
"`systemctl start matrix-backup-borg`. This will not return until the "
|
||||
"backup is done, so possibly a long time. Consider using "
|
||||
"[tmux](https://en.wikipedia.org/wiki/Tmux) if your SSH connection is "
|
||||
"unstable."
|
||||
msgid "For testing your setup it can be helpful to not wait until 4am. If you want to run the backup immediately, log onto the server and run `systemctl start matrix-backup-borg`. This will not return until the backup is done, so possibly a long time. Consider using [tmux](https://en.wikipedia.org/wiki/Tmux) if your SSH connection is unstable."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,24 +26,15 @@ msgid "Serving the base domain (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:3
|
||||
msgid ""
|
||||
"By default, this playbook sets up services on your Matrix server "
|
||||
"(`matrix.example.com`), but has it configured so that it presents itself "
|
||||
"as the base domain (`example.com`). To have this server officially be "
|
||||
"responsible for Matrix services for the base domain (`example.com`), you "
|
||||
"need to set up server delegation / redirection."
|
||||
msgid "By default, this playbook sets up services on your Matrix server (`matrix.example.com`), but has it configured so that it presents itself as the base domain (`example.com`). To have this server officially be responsible for Matrix services for the base domain (`example.com`), you need to set up server delegation / redirection."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:5
|
||||
msgid ""
|
||||
"As we discuss in [Server Delegation](howto-server-delegation.md), server "
|
||||
"delegation / redirection can be configured in either of these ways:"
|
||||
msgid "As we discuss in [Server Delegation](howto-server-delegation.md), server delegation / redirection can be configured in either of these ways:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:7
|
||||
msgid ""
|
||||
"Setting up a `/.well-known/matrix/server` file on the base domain "
|
||||
"(`example.com`)"
|
||||
msgid "Setting up a `/.well-known/matrix/server` file on the base domain (`example.com`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:8
|
||||
@ -51,15 +42,11 @@ msgid "Setting up a `_matrix._tcp` DNS SRV record"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:10
|
||||
msgid ""
|
||||
"For simplicity reasons, this playbook recommends you to set up server "
|
||||
"delegation via a `/.well-known/matrix/server` file."
|
||||
msgid "For simplicity reasons, this playbook recommends you to set up server delegation via a `/.well-known/matrix/server` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:12
|
||||
msgid ""
|
||||
"However, those who don't have a separate server to dedicate to the base "
|
||||
"domain have trouble arranging this."
|
||||
msgid "However, those who don't have a separate server to dedicate to the base domain have trouble arranging this."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:14
|
||||
@ -67,33 +54,19 @@ msgid "Usually, there are 2 options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:16
|
||||
msgid ""
|
||||
"either get a separate server for the base domain, just for serving the "
|
||||
"files necessary for [Server Delegation via a well-known file](howto-"
|
||||
"server-delegation.md#server-delegation-via-a-well-known-file)"
|
||||
msgid "either get a separate server for the base domain, just for serving the files necessary for [Server Delegation via a well-known file](howto-server-delegation.md#server-delegation-via-a-well-known-file)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:18
|
||||
msgid ""
|
||||
"or, arrange for the Matrix server to serve the base domain. This either "
|
||||
"involves you [using your own webserver](configuring-playbook-own-"
|
||||
"webserver.md) or making the integrated webserver serve the base domain "
|
||||
"for you."
|
||||
msgid "or, arrange for the Matrix server to serve the base domain. This either involves you [using your own webserver](configuring-playbook-own-webserver.md) or making the integrated webserver serve the base domain for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:20
|
||||
msgid ""
|
||||
"This documentation page tells you how to do the latter. With some easy "
|
||||
"changes, we make it possible to serve the base domain from the Matrix "
|
||||
"server via the integrated webserver."
|
||||
msgid "This documentation page tells you how to do the latter. With some easy changes, we make it possible to serve the base domain from the Matrix server via the integrated webserver."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:22
|
||||
msgid ""
|
||||
"Just [**adjust your DNS records**](configuring-dns.md), so that your base"
|
||||
" domain is pointed to the Matrix server's IP address (using a DNS `A` "
|
||||
"record) **and then add the following configuration** to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Just [**adjust your DNS records**](configuring-dns.md), so that your base domain is pointed to the Matrix server's IP address (using a DNS `A` record) **and then add the following configuration** to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:28
|
||||
@ -101,28 +74,15 @@ msgid "Doing this, the playbook will:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:30
|
||||
msgid ""
|
||||
"obtain an SSL certificate for the base domain, just like it does for all "
|
||||
"other domains (see [how we handle SSL certificates](configuring-playbook-"
|
||||
"ssl-certificates.md))"
|
||||
msgid "obtain an SSL certificate for the base domain, just like it does for all other domains (see [how we handle SSL certificates](configuring-playbook-ssl-certificates.md))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:32
|
||||
msgid ""
|
||||
"serve the `/.well-known/matrix/*` files which are necessary for "
|
||||
"[Federation Server Discovery](configuring-well-known.md#federation-"
|
||||
"server-discovery) (also see [Server Delegation](howto-server-"
|
||||
"delegation.md)) and [Client-Server discovery](configuring-well-known.md"
|
||||
"#client-server-discovery)"
|
||||
msgid "serve the `/.well-known/matrix/*` files which are necessary for [Federation Server Discovery](configuring-well-known.md#federation-server-discovery) (also see [Server Delegation](howto-server-delegation.md)) and [Client-Server discovery](configuring-well-known.md#client-server-discovery)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:34
|
||||
msgid ""
|
||||
"serve a simple homepage at `https://example.com` with content `Hello from"
|
||||
" example.com` (configurable via the "
|
||||
"`matrix_static_files_file_index_html_template` variable). You can also "
|
||||
"[serve a more complicated static website](#serving-a-static-website-at-"
|
||||
"the-base-domain)."
|
||||
msgid "serve a simple homepage at `https://example.com` with content `Hello from example.com` (configurable via the `matrix_static_files_file_index_html_template` variable). You can also [serve a more complicated static website](#serving-a-static-website-at-the-base-domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:36
|
||||
@ -130,33 +90,19 @@ msgid "Serving a static website at the base domain"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:38
|
||||
msgid ""
|
||||
"By default, when \"serving the base domain\" is enabled, the playbook "
|
||||
"hosts a simple `index.html` webpage at `/matrix/static-"
|
||||
"files/public/index.html`. The content of this page is taken from the "
|
||||
"`matrix_static_files_file_index_html_template` variable."
|
||||
msgid "By default, when \"serving the base domain\" is enabled, the playbook hosts a simple `index.html` webpage at `/matrix/static-files/public/index.html`. The content of this page is taken from the `matrix_static_files_file_index_html_template` variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:40
|
||||
msgid ""
|
||||
"If you'd like to host your own static website (more than a single "
|
||||
"`index.html` page) at the base domain, you can disable the creation of "
|
||||
"this default `index.html` page like this:"
|
||||
msgid "If you'd like to host your own static website (more than a single `index.html` page) at the base domain, you can disable the creation of this default `index.html` page like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:54
|
||||
msgid ""
|
||||
"With this configuration, Ansible will no longer mess around with the "
|
||||
"`/matrix/static-files/public/index.html` file."
|
||||
msgid "With this configuration, Ansible will no longer mess around with the `/matrix/static-files/public/index.html` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:56
|
||||
msgid ""
|
||||
"You are then free to upload any static website files to `/matrix/static-"
|
||||
"files/public` and they will get served at the base domain. You can do so "
|
||||
"manually or by using the [ansible-role-aux](https://github.com/mother-of-"
|
||||
"all-self-hosting/ansible-role-aux) Ansible role, which is part of this "
|
||||
"playbook already."
|
||||
msgid "You are then free to upload any static website files to `/matrix/static-files/public` and they will get served at the base domain. You can do so manually or by using the [ansible-role-aux](https://github.com/mother-of-all-self-hosting/ansible-role-aux) Ansible role, which is part of this playbook already."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:58
|
||||
@ -164,10 +110,7 @@ msgid "Serving a more complicated website at the base domain"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:60
|
||||
msgid ""
|
||||
"If you'd like to serve an even more complicated (dynamic) website from "
|
||||
"the Matrix server, relying on the playbook to serve the base domain is "
|
||||
"not the best choice."
|
||||
msgid "If you'd like to serve an even more complicated (dynamic) website from the Matrix server, relying on the playbook to serve the base domain is not the best choice."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:62
|
||||
@ -179,28 +122,19 @@ msgid "**One way is to host your base domain elsewhere**. This involves:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:65
|
||||
msgid ""
|
||||
"you stopping to serve it from the Matrix server: remove "
|
||||
"`matrix_static_files_container_labels_base_domain_enabled` from your "
|
||||
"configuration"
|
||||
msgid "you stopping to serve it from the Matrix server: remove `matrix_static_files_container_labels_base_domain_enabled` from your configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:66
|
||||
msgid ""
|
||||
"[configuring Matrix Delegation via well-known](./configuring-well-"
|
||||
"known.md)"
|
||||
msgid "[configuring Matrix Delegation via well-known](./configuring-well-known.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:68
|
||||
msgid ""
|
||||
"**Another way is to serve the base domain from another (your own) "
|
||||
"container on the Matrix server**. This involves:"
|
||||
msgid "**Another way is to serve the base domain from another (your own) container on the Matrix server**. This involves:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:69
|
||||
msgid ""
|
||||
"telling the playbook to only serve `example.com/.well-known/matrix` files"
|
||||
" by adjusting your `vars.yml` configuration like this:"
|
||||
msgid "telling the playbook to only serve `example.com/.well-known/matrix` files by adjusting your `vars.yml` configuration like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:70
|
||||
@ -208,10 +142,7 @@ msgid "keep `matrix_static_files_container_labels_base_domain_enabled: true`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:71
|
||||
msgid ""
|
||||
"add an extra: "
|
||||
"`matrix_static_files_container_labels_base_domain_traefik_path_prefix: "
|
||||
"/.well-known/matrix`"
|
||||
msgid "add an extra: `matrix_static_files_container_labels_base_domain_traefik_path_prefix: /.well-known/matrix`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:72
|
||||
@ -219,23 +150,13 @@ msgid "building and running a new container on the Matrix server:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:73
|
||||
msgid ""
|
||||
"it should be connected to the `traefik` network, so that Traefik can "
|
||||
"reverse-proxy to it"
|
||||
msgid "it should be connected to the `traefik` network, so that Traefik can reverse-proxy to it"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:74
|
||||
msgid ""
|
||||
"it should have appropriate [container "
|
||||
"labels](https://docs.docker.com/config/labels-custom-metadata/), which "
|
||||
"instruct Traefik to reverse-proxy to it"
|
||||
msgid "it should have appropriate [container labels](https://docs.docker.com/config/labels-custom-metadata/), which instruct Traefik to reverse-proxy to it"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-base-domain-serving.md:76
|
||||
msgid ""
|
||||
"How you'll be managing building and running this container is up-to-you. "
|
||||
"You may use of the primitives from [ansible-role-aux](https://github.com"
|
||||
"/mother-of-all-self-hosting/ansible-role-aux) Ansible role to organize it"
|
||||
" yourself, or you can set it up in another way."
|
||||
msgid "How you'll be managing building and running this container is up-to-you. You may use of the primitives from [ansible-role-aux](https://github.com/mother-of-all-self-hosting/ansible-role-aux) Ansible role to organize it yourself, or you can set it up in another way."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,31 +26,15 @@ msgid "Setting up baibot (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:8
|
||||
msgid ""
|
||||
"🤖 [baibot](https://github.com/etkecc/baibot) (pronounced bye-bot) is a "
|
||||
"[Matrix](https://matrix.org/) bot developed by "
|
||||
"[etke.cc](https://etke.cc/) that exposes the power of "
|
||||
"[AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large "
|
||||
"Language Models](https://en.wikipedia.org/wiki/Large_language_model) to "
|
||||
"you. 🤖"
|
||||
msgid "🤖 [baibot](https://github.com/etkecc/baibot) (pronounced bye-bot) is a [Matrix](https://matrix.org/) bot developed by [etke.cc](https://etke.cc/) that exposes the power of [AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large Language Models](https://en.wikipedia.org/wiki/Large_language_model) to you. 🤖"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:10
|
||||
msgid ""
|
||||
"It supports [OpenAI](https://openai.com/)'s "
|
||||
"[ChatGPT](https://openai.com/blog/chatgpt/) models, as many well as other"
|
||||
" [☁️ "
|
||||
"providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
|
||||
msgid "It supports [OpenAI](https://openai.com/)'s [ChatGPT](https://openai.com/blog/chatgpt/) models, as many well as other [☁️ providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:12
|
||||
msgid ""
|
||||
"It's designed as a more private and [✨ "
|
||||
"featureful](https://github.com/etkecc/baibot/?tab=readme-ov-"
|
||||
"file#-features) alternative to [matrix-chatgpt-bot](./configuring-"
|
||||
"playbook-bot-chatgpt.md). See the "
|
||||
"[baibot](https://github.com/etkecc/baibot) project and its documentation "
|
||||
"for more information."
|
||||
msgid "It's designed as a more private and [✨ featureful](https://github.com/etkecc/baibot/?tab=readme-ov-file#-features) alternative to [matrix-chatgpt-bot](./configuring-playbook-bot-chatgpt.md). See the [baibot](https://github.com/etkecc/baibot) project and its documentation for more information."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:14
|
||||
@ -58,9 +42,7 @@ msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:16
|
||||
msgid ""
|
||||
"API access to one or more LLM [☁️ "
|
||||
"providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
|
||||
msgid "API access to one or more LLM [☁️ providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:18
|
||||
@ -68,10 +50,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:20
|
||||
msgid ""
|
||||
"There are **a lot of configuration options** (some required, some "
|
||||
"possibly required, some optional), so they're **split into multiple "
|
||||
"sections below**:"
|
||||
msgid "There are **a lot of configuration options** (some required, some possibly required, some optional), so they're **split into multiple sections below**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:23
|
||||
@ -91,16 +70,11 @@ msgid "[🤖 Configuring agents via Ansible](#-configuring-agents-via-ansible)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:27
|
||||
msgid ""
|
||||
"[🤝 Configuring initial default handlers](#-configuring-initial-default-"
|
||||
"handlers)"
|
||||
msgid "[🤝 Configuring initial default handlers](#-configuring-initial-default-handlers)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:29
|
||||
msgid ""
|
||||
"Depending on your current `vars.yml` file and desired configuration, "
|
||||
"**you may require more than just the [base configuration](#base-"
|
||||
"configuration)**."
|
||||
msgid "Depending on your current `vars.yml` file and desired configuration, **you may require more than just the [base configuration](#base-configuration)**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:31
|
||||
@ -108,15 +82,11 @@ msgid "Base configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:33
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:71
|
||||
msgid ""
|
||||
"As mentioned above, **this may not be enough**. Continue with the "
|
||||
"configuration sections below."
|
||||
msgid "As mentioned above, **this may not be enough**. Continue with the configuration sections below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:73
|
||||
@ -129,25 +99,16 @@ msgid "This is an addition to the [base configuration](#base-configuration)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:77
|
||||
msgid ""
|
||||
"To specify who is considered a bot [👮♂️ "
|
||||
"Administrator](https://github.com/etkecc/baibot/blob/main/docs/access.md#administrators),"
|
||||
" you either need to specify "
|
||||
"`matrix_bot_baibot_config_access_admin_patterns` or `matrix_admin`. The "
|
||||
"latter is a single variable which affects all bridges and bots."
|
||||
msgid "To specify who is considered a bot [👮♂️ Administrator](https://github.com/etkecc/baibot/blob/main/docs/access.md#administrators), you either need to specify `matrix_bot_baibot_config_access_admin_patterns` or `matrix_admin`. The latter is a single variable which affects all bridges and bots."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:79
|
||||
msgid ""
|
||||
"If `matrix_admin` is already configured in your `vars.yml` configuration,"
|
||||
" you can skip this section."
|
||||
msgid "If `matrix_admin` is already configured in your `vars.yml` configuration, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:81
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:110
|
||||
msgid ""
|
||||
"**If necessary**, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "**If necessary**, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:95
|
||||
@ -155,44 +116,27 @@ msgid "👥 Initial users configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:97
|
||||
msgid ""
|
||||
"By default, **all users on your homeserver are considered allowed "
|
||||
"users**. If that's OK, you can skip this section."
|
||||
msgid "By default, **all users on your homeserver are considered allowed users**. If that's OK, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:101
|
||||
msgid ""
|
||||
"To specify who is considered a bot [👥 "
|
||||
"User](https://github.com/etkecc/baibot/blob/main/docs/access.md#user), "
|
||||
"you may:"
|
||||
msgid "To specify who is considered a bot [👥 User](https://github.com/etkecc/baibot/blob/main/docs/access.md#user), you may:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:103
|
||||
msgid ""
|
||||
"define an **initial** value for "
|
||||
"`matrix_bot_baibot_config_initial_global_config_user_patterns` Ansible "
|
||||
"variable, as shown below"
|
||||
msgid "define an **initial** value for `matrix_bot_baibot_config_initial_global_config_user_patterns` Ansible variable, as shown below"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:104
|
||||
msgid ""
|
||||
"configure the list at runtime via the bot's `!bai access set-users "
|
||||
"SPACE_SEPARATED_PATTERNS` command"
|
||||
msgid "configure the list at runtime via the bot's `!bai access set-users SPACE_SEPARATED_PATTERNS` command"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:106
|
||||
msgid ""
|
||||
"Configuring "
|
||||
"`matrix_bot_baibot_config_initial_global_config_user_patterns` is "
|
||||
"optional, but it can be useful to pre-configure the bot with a list of "
|
||||
"users who should have access to the bot's features."
|
||||
msgid "Configuring `matrix_bot_baibot_config_initial_global_config_user_patterns` is optional, but it can be useful to pre-configure the bot with a list of users who should have access to the bot's features."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:108
|
||||
msgid ""
|
||||
"**Note**: Once initially configured, the allowed users list **cannot be "
|
||||
"managed via Ansible anymore**. It can only be managed subsequently via "
|
||||
"bot commands."
|
||||
msgid "**Note**: Once initially configured, the allowed users list **cannot be managed via Ansible anymore**. It can only be managed subsequently via bot commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:122
|
||||
@ -200,61 +144,31 @@ msgid "🤖 Configuring agents via Ansible"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:124
|
||||
msgid ""
|
||||
"You are **not required** to define agents "
|
||||
"[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"
|
||||
"#static-configuration) via Ansible. **To get started quickly**, you can "
|
||||
"**skip this section and define agents at runtime via chat commands** "
|
||||
"(following the bot's guidance)."
|
||||
msgid "You are **not required** to define agents [statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md#static-configuration) via Ansible. **To get started quickly**, you can **skip this section and define agents at runtime via chat commands** (following the bot's guidance)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:126
|
||||
msgid ""
|
||||
"Privileged users (like the [👮♂️ Administrator](#️-administrator-"
|
||||
"configuration), but potentially others too - see the upstream [🔒 "
|
||||
"access](https://github.com/etkecc/baibot/blob/main/docs/access.md) "
|
||||
"documentation) can **define agents dynamically at any time** via chat "
|
||||
"commands."
|
||||
msgid "Privileged users (like the [👮♂️ Administrator](#️-administrator-configuration), but potentially others too - see the upstream [🔒 access](https://github.com/etkecc/baibot/blob/main/docs/access.md) documentation) can **define agents dynamically at any time** via chat commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:128
|
||||
msgid ""
|
||||
"The Ansible role includes preset variables for easily enabling some [🤖 "
|
||||
"agents](https://github.com/etkecc/baibot/blob/main/docs/agents.md) on "
|
||||
"various [☁️ "
|
||||
"providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md) "
|
||||
"(e.g. OpenAI, etc)."
|
||||
msgid "The Ansible role includes preset variables for easily enabling some [🤖 agents](https://github.com/etkecc/baibot/blob/main/docs/agents.md) on various [☁️ providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md) (e.g. OpenAI, etc)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:130
|
||||
msgid ""
|
||||
"Besides the presets, the Ansible role also includes support for "
|
||||
"configuring additional statically-defined agents via the "
|
||||
"`matrix_bot_baibot_config_agents_static_definitions_custom` Ansible "
|
||||
"variable."
|
||||
msgid "Besides the presets, the Ansible role also includes support for configuring additional statically-defined agents via the `matrix_bot_baibot_config_agents_static_definitions_custom` Ansible variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:132
|
||||
msgid ""
|
||||
"Agents defined statically and those created dynamically (via chat) are "
|
||||
"named differently, so **conflict cannot arise**."
|
||||
msgid "Agents defined statically and those created dynamically (via chat) are named differently, so **conflict cannot arise**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:134
|
||||
msgid ""
|
||||
"Depending on your propensity for "
|
||||
"[GitOps](https://en.wikipedia.org/wiki/DevOps#GitOps), you may prefer to "
|
||||
"define agents statically via Ansible, or you may wish to do it "
|
||||
"dynamically via chat."
|
||||
msgid "Depending on your propensity for [GitOps](https://en.wikipedia.org/wiki/DevOps#GitOps), you may prefer to define agents statically via Ansible, or you may wish to do it dynamically via chat."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:136
|
||||
msgid ""
|
||||
"Before proceeding, we recommend reading the upstream documentation on "
|
||||
"[How to choose a "
|
||||
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md"
|
||||
"#how-to-choose-a-provider). In short, it's probably best to go with "
|
||||
"[OpenAI](#openai)."
|
||||
msgid "Before proceeding, we recommend reading the upstream documentation on [How to choose a provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#how-to-choose-a-provider). In short, it's probably best to go with [OpenAI](#openai)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:138
|
||||
@ -262,12 +176,7 @@ msgid "Anthropic"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:140
|
||||
msgid ""
|
||||
"You can statically-define a single [🤖 "
|
||||
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "
|
||||
"instance powered by the [Anthropic "
|
||||
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#anthropic)"
|
||||
" with the help of the playbook's preset variables."
|
||||
msgid "You can statically-define a single [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) instance powered by the [Anthropic provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#anthropic) with the help of the playbook's preset variables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:142
|
||||
@ -281,19 +190,14 @@ msgstr ""
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:193
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:221
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:251
|
||||
msgid ""
|
||||
"If you'd like to use more than one model, take a look at the [Configuring"
|
||||
" additional agents (without a preset)](#configuring-additional-agents-"
|
||||
"without-a-preset) section below."
|
||||
msgid "If you'd like to use more than one model, take a look at the [Configuring additional agents (without a preset)](#configuring-additional-agents-without-a-preset) section below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:162
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:195
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:223
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:253
|
||||
msgid ""
|
||||
"💡 You may also wish to use this new agent for [🤝 Configuring initial "
|
||||
"default handlers](#-configuring-initial-default-handlers)."
|
||||
msgid "💡 You may also wish to use this new agent for [🤝 Configuring initial default handlers](#-configuring-initial-default-handlers)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:164
|
||||
@ -301,20 +205,11 @@ msgid "Groq"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:166
|
||||
msgid ""
|
||||
"You can statically-define a single [🤖 "
|
||||
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "
|
||||
"instance powered by the [Groq "
|
||||
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#groq)"
|
||||
" with the help of the playbook's preset variables."
|
||||
msgid "You can statically-define a single [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) instance powered by the [Groq provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#groq) with the help of the playbook's preset variables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:191
|
||||
msgid ""
|
||||
"Because this is a "
|
||||
"[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"
|
||||
"#static-configuration)-defined agent, it will be given a `static/` ID "
|
||||
"prefix and will be named `static/groq`."
|
||||
msgid "Because this is a [statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md#static-configuration)-defined agent, it will be given a `static/` ID prefix and will be named `static/groq`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:197
|
||||
@ -322,20 +217,11 @@ msgid "Mistral"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:199
|
||||
msgid ""
|
||||
"You can statically-define a single [🤖 "
|
||||
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "
|
||||
"instance powered by the [🇫🇷 Mistral "
|
||||
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#mistral)"
|
||||
" with the help of the playbook's preset variables."
|
||||
msgid "You can statically-define a single [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) instance powered by the [🇫🇷 Mistral provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#mistral) with the help of the playbook's preset variables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:219
|
||||
msgid ""
|
||||
"Because this is a "
|
||||
"[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"
|
||||
"#static-configuration)-defined agent, it will be given a `static/` ID "
|
||||
"prefix and will be named `static/mistral`."
|
||||
msgid "Because this is a [statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md#static-configuration)-defined agent, it will be given a `static/` ID prefix and will be named `static/mistral`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:225
|
||||
@ -343,29 +229,15 @@ msgid "OpenAI"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:227
|
||||
msgid ""
|
||||
"You can statically-define a single [🤖 "
|
||||
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "
|
||||
"instance powered by the [OpenAI "
|
||||
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openai)"
|
||||
" with the help of the playbook's preset variables."
|
||||
msgid "You can statically-define a single [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) instance powered by the [OpenAI provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openai) with the help of the playbook's preset variables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:229
|
||||
msgid ""
|
||||
"The OpenAI provider is **only meant to be used with OpenAI's official "
|
||||
"API** and compatibility with other services (which do not fully adhere to"
|
||||
" the OpenAI API spec completely) is limited. **If you're targeting an "
|
||||
"OpenAI-compatible service**, use the [OpenAI Compatible](#openai-"
|
||||
"compatible) provider instead."
|
||||
msgid "The OpenAI provider is **only meant to be used with OpenAI's official API** and compatibility with other services (which do not fully adhere to the OpenAI API spec completely) is limited. **If you're targeting an OpenAI-compatible service**, use the [OpenAI Compatible](#openai-compatible) provider instead."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:249
|
||||
msgid ""
|
||||
"Because this is a "
|
||||
"[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"
|
||||
"#static-configuration)-defined agent, it will be given a `static/` ID "
|
||||
"prefix and will be named `static/openai`."
|
||||
msgid "Because this is a [statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md#static-configuration)-defined agent, it will be given a `static/` ID prefix and will be named `static/openai`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:255
|
||||
@ -373,37 +245,19 @@ msgid "OpenAI Compatible"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:257
|
||||
msgid ""
|
||||
"You can statically-define a single [🤖 "
|
||||
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "
|
||||
"instance powered by the [OpenAI Compatible "
|
||||
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md"
|
||||
"#openai-compatible) with the help of the playbook's preset variables."
|
||||
msgid "You can statically-define a single [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) instance powered by the [OpenAI Compatible provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openai-compatible) with the help of the playbook's preset variables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:259
|
||||
msgid ""
|
||||
"This provider allows you to use OpenAI-compatible API services like "
|
||||
"[OpenRouter](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openrouter),"
|
||||
" [Together "
|
||||
"AI](https://github.com/etkecc/baibot/blob/main/docs/providers.md"
|
||||
"#together-ai), etc."
|
||||
msgid "This provider allows you to use OpenAI-compatible API services like [OpenRouter](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openrouter), [Together AI](https://github.com/etkecc/baibot/blob/main/docs/providers.md#together-ai), etc."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:261
|
||||
msgid ""
|
||||
"Some of these popular services already have **shortcut** providers (see "
|
||||
"[supported "
|
||||
"providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md"
|
||||
"#supported-providers) leading to this one behind the scenes - this make "
|
||||
"it easier to get started."
|
||||
msgid "Some of these popular services already have **shortcut** providers (see [supported providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md#supported-providers) leading to this one behind the scenes - this make it easier to get started."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:263
|
||||
msgid ""
|
||||
"As of this moment, the playbook does not include presets for any of these"
|
||||
" services, so you'll need to [Configuring additional agents (without a "
|
||||
"preset)](#configuring-additional-agents-without-a-preset)."
|
||||
msgid "As of this moment, the playbook does not include presets for any of these services, so you'll need to [Configuring additional agents (without a preset)](#configuring-additional-agents-without-a-preset)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:265
|
||||
@ -411,63 +265,35 @@ msgid "Configuring additional agents (without a preset)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:267
|
||||
msgid ""
|
||||
"The Ansible role may be lacking preset variables for some [☁️ "
|
||||
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md), "
|
||||
"or you may wish to statically-define an agent on the same provider twice "
|
||||
"(or more) with different configuration."
|
||||
msgid "The Ansible role may be lacking preset variables for some [☁️ provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md), or you may wish to statically-define an agent on the same provider twice (or more) with different configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:269
|
||||
msgid ""
|
||||
"It's possible to inject your own agent configuration using the "
|
||||
"`matrix_bot_baibot_config_agents_static_definitions_custom` Ansible "
|
||||
"variable."
|
||||
msgid "It's possible to inject your own agent configuration using the `matrix_bot_baibot_config_agents_static_definitions_custom` Ansible variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:271
|
||||
msgid ""
|
||||
"You can also define providers at runtime, by chatting with the bot, so "
|
||||
"using Ansible is not a requirement."
|
||||
msgid "You can also define providers at runtime, by chatting with the bot, so using Ansible is not a requirement."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:273
|
||||
msgid ""
|
||||
"Below is an an **example** demonstrating **statically-defining agents via"
|
||||
" Ansible without using presets**:"
|
||||
msgid "Below is an an **example** demonstrating **statically-defining agents via Ansible without using presets**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:312
|
||||
msgid ""
|
||||
"Because these are "
|
||||
"[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"
|
||||
"#static-configuration)-defined agents, they will be given a `static/` ID "
|
||||
"prefix and will be named `static/my-openai-gpt-3.5-turbo-agent` and "
|
||||
"`static/my-ollama-agent`, respectively."
|
||||
msgid "Because these are [statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md#static-configuration)-defined agents, they will be given a `static/` ID prefix and will be named `static/my-openai-gpt-3.5-turbo-agent` and `static/my-ollama-agent`, respectively."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:314
|
||||
msgid ""
|
||||
"💡 To figure out what to put in the `config` section, refer to the [☁️ "
|
||||
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md) "
|
||||
"page, which contains **sample configuration YAML for each provider**."
|
||||
msgid "💡 To figure out what to put in the `config` section, refer to the [☁️ provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md) page, which contains **sample configuration YAML for each provider**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:316
|
||||
msgid ""
|
||||
"As with any [🤖 "
|
||||
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md), "
|
||||
"defining them means they exist. To actually make use of them, they need "
|
||||
"to be configured as handlers globally or in a specific room - see [Mixing"
|
||||
" & matching "
|
||||
"models](https://github.com/etkecc/baibot/blob/main/docs/features.md#mixing"
|
||||
"--matching-models)."
|
||||
msgid "As with any [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md), defining them means they exist. To actually make use of them, they need to be configured as handlers globally or in a specific room - see [Mixing & matching models](https://github.com/etkecc/baibot/blob/main/docs/features.md#mixing--matching-models)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:318
|
||||
msgid ""
|
||||
"💡 You may also wish to use these new agents for [🤝 Configuring initial "
|
||||
"default handlers](#-configuring-initial-default-handlers)."
|
||||
msgid "💡 You may also wish to use these new agents for [🤝 Configuring initial default handlers](#-configuring-initial-default-handlers)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:320
|
||||
@ -475,11 +301,7 @@ msgid "🤝 Configuring initial default handlers"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:322
|
||||
msgid ""
|
||||
"This section is only useful if you're [🤖 Configuring agents via Ansible"
|
||||
"](#-configuring-agents-via-ansible), as it lets you put these agents to "
|
||||
"use as soon as the bot starts (by adjusting the bot's **initial global "
|
||||
"configuration**)."
|
||||
msgid "This section is only useful if you're [🤖 Configuring agents via Ansible](#-configuring-agents-via-ansible), as it lets you put these agents to use as soon as the bot starts (by adjusting the bot's **initial global configuration**)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:324
|
||||
@ -487,75 +309,43 @@ msgid "If you're not configuring agents via Ansible, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:326
|
||||
msgid ""
|
||||
"This section is only useful the first time around. **Once initially "
|
||||
"configured the global configuration cannot be managed Ansible**, but only"
|
||||
" via bot commands."
|
||||
msgid "This section is only useful the first time around. **Once initially configured the global configuration cannot be managed Ansible**, but only via bot commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:328
|
||||
msgid ""
|
||||
"baibot supports [various "
|
||||
"purposes](https://github.com/etkecc/baibot/blob/main/docs/features.md):"
|
||||
msgid "baibot supports [various purposes](https://github.com/etkecc/baibot/blob/main/docs/features.md):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:330
|
||||
msgid ""
|
||||
"[💬 text-"
|
||||
"generation](https://github.com/etkecc/baibot/blob/main/docs/features.md"
|
||||
"#-text-generation): communicating with you via text"
|
||||
msgid "[💬 text-generation](https://github.com/etkecc/baibot/blob/main/docs/features.md#-text-generation): communicating with you via text"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:332
|
||||
msgid ""
|
||||
"[🦻 speech-to-"
|
||||
"text](https://github.com/etkecc/baibot/blob/main/docs/features.md"
|
||||
"#-speech-to-text): turning your voice messages into text"
|
||||
msgid "[🦻 speech-to-text](https://github.com/etkecc/baibot/blob/main/docs/features.md#-speech-to-text): turning your voice messages into text"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:334
|
||||
msgid ""
|
||||
"[🗣️ text-to-"
|
||||
"speech](https://github.com/etkecc/baibot/blob/main/docs/features.md"
|
||||
"#-text-to-speech): turning bot or users text messages into voice messages"
|
||||
msgid "[🗣️ text-to-speech](https://github.com/etkecc/baibot/blob/main/docs/features.md#-text-to-speech): turning bot or users text messages into voice messages"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:336
|
||||
msgid ""
|
||||
"[🖌️ image-"
|
||||
"generation](https://github.com/etkecc/baibot/blob/main/docs/features.md"
|
||||
"#-image-generation): generating images based on instructions"
|
||||
msgid "[🖌️ image-generation](https://github.com/etkecc/baibot/blob/main/docs/features.md#-image-generation): generating images based on instructions"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:338
|
||||
msgid ""
|
||||
"❓ catch-all: special purposes, indicating use as a fallback (when no "
|
||||
"specific handler is configured)"
|
||||
msgid "❓ catch-all: special purposes, indicating use as a fallback (when no specific handler is configured)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:340
|
||||
msgid ""
|
||||
"[Mixing & matching "
|
||||
"models](https://github.com/etkecc/baibot/blob/main/docs/features.md#mixing"
|
||||
"--matching-models) is made possible by the bot's ability to have "
|
||||
"different [🤝 "
|
||||
"handlers](https://github.com/etkecc/baibot/blob/main/docs/configuration/handlers.md)"
|
||||
" configured for different purposes."
|
||||
msgid "[Mixing & matching models](https://github.com/etkecc/baibot/blob/main/docs/features.md#mixing--matching-models) is made possible by the bot's ability to have different [🤝 handlers](https://github.com/etkecc/baibot/blob/main/docs/configuration/handlers.md) configured for different purposes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:342
|
||||
msgid ""
|
||||
"This configuration can be done as a global fallback, or per-room. Both of"
|
||||
" these [🛠️ "
|
||||
"configurations](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md)"
|
||||
" are managed at runtime (viat chat), but **the global configuration can "
|
||||
"have some initial defaults configured via Ansible**."
|
||||
msgid "This configuration can be done as a global fallback, or per-room. Both of these [🛠️ configurations](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md) are managed at runtime (viat chat), but **the global configuration can have some initial defaults configured via Ansible**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:344
|
||||
msgid ""
|
||||
"You can configure the **initial values** for these via Ansible, via the "
|
||||
"`matrix_bot_baibot_config_initial_global_config_handler_*` variables."
|
||||
msgid "You can configure the **initial values** for these via Ansible, via the `matrix_bot_baibot_config_initial_global_config_handler_*` variables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:346
|
||||
@ -563,11 +353,7 @@ msgid "Example **additional** `vars.yml` configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:363
|
||||
msgid ""
|
||||
"**Note**: these are initial defaults for the bot's global configuration. "
|
||||
"As such, changing any of these values subsequently has no effect on the "
|
||||
"bot's behavior. **Once initially configured the global configuration "
|
||||
"cannot be managed Ansible**, but only via bot commands."
|
||||
msgid "**Note**: these are initial defaults for the bot's global configuration. As such, changing any of these values subsequently has no effect on the bot's behavior. **Once initially configured the global configuration cannot be managed Ansible**, but only via bot commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:365
|
||||
@ -575,9 +361,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:367
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:374
|
||||
@ -585,35 +369,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:376
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:378
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-baibot.md:380
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:382
|
||||
msgid ""
|
||||
"If you change the bot password (`matrix_bot_baibot_config_user_password` "
|
||||
"in your `vars.yml` file) subsequently, the bot user's credentials on the "
|
||||
"homeserver won't be updated automatically. If you'd like to change the "
|
||||
"bot user's password, use a tool like [synapse-admin](configuring-"
|
||||
"playbook-synapse-admin.md) to change it, and then update "
|
||||
"`matrix_bot_baibot_config_user_password` to let the bot know its new "
|
||||
"password."
|
||||
msgid "If you change the bot password (`matrix_bot_baibot_config_user_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_baibot_config_user_password` to let the bot know its new password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:384
|
||||
@ -625,40 +393,23 @@ msgid "To use the bot, invite the `@baibot:example.com` bot user into a room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:388
|
||||
msgid ""
|
||||
"If you're an allowed bot [👥 "
|
||||
"user](https://github.com/etkecc/baibot/blob/main/docs/access.md#user) "
|
||||
"(see [👥 Initial users configuration](#-initial-users-configuration)), the"
|
||||
" bot will accept your invitation and join the room."
|
||||
msgid "If you're an allowed bot [👥 user](https://github.com/etkecc/baibot/blob/main/docs/access.md#user) (see [👥 Initial users configuration](#-initial-users-configuration)), the bot will accept your invitation and join the room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:390
|
||||
msgid ""
|
||||
"After joining, the bot will introduce itself and show information about "
|
||||
"the [✨ "
|
||||
"features](https://github.com/etkecc/baibot/blob/main/docs/features.md) "
|
||||
"that are enabled for it."
|
||||
msgid "After joining, the bot will introduce itself and show information about the [✨ features](https://github.com/etkecc/baibot/blob/main/docs/features.md) that are enabled for it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:392
|
||||
msgid ""
|
||||
"If you've [🤖 configured one or more agents via Ansible](#-configuring-"
|
||||
"agents-via-ansible) and have [🤝 configured initial default handlers"
|
||||
"](#configuring-initial-default-handlers), the bot will immediately be "
|
||||
"able to make use of these agents for this new room. Otherwise, you will "
|
||||
"need to configure agents and/or handlers via chat commands."
|
||||
msgid "If you've [🤖 configured one or more agents via Ansible](#-configuring-agents-via-ansible) and have [🤝 configured initial default handlers](#configuring-initial-default-handlers), the bot will immediately be able to make use of these agents for this new room. Otherwise, you will need to configure agents and/or handlers via chat commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:394
|
||||
msgid ""
|
||||
"Send `!bai help` to the room at any time to see the bot's help menu for "
|
||||
"additional commands."
|
||||
msgid "Send `!bai help` to the room at any time to see the bot's help menu for additional commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:396
|
||||
msgid ""
|
||||
"You can also refer to the upstream "
|
||||
"[baibot](https://github.com/etkecc/baibot) project's documentation."
|
||||
msgid "You can also refer to the upstream [baibot](https://github.com/etkecc/baibot) project's documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:398
|
||||
@ -666,23 +417,13 @@ msgid "Debugging"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:400
|
||||
msgid ""
|
||||
"As with all other services, you can find service logs in [systemd-"
|
||||
"journald](https://www.freedesktop.org/software/systemd/man/systemd-"
|
||||
"journald.service.html) by running something like `journalctl -fu matrix-"
|
||||
"bot-baibot`"
|
||||
msgid "As with all other services, you can find service logs in [systemd-journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html) by running something like `journalctl -fu matrix-bot-baibot`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:402
|
||||
msgid ""
|
||||
"The default logging level for this service is `info`, but you can "
|
||||
"increase it to `debug` (or even `trace`) with the following additional "
|
||||
"configuration:"
|
||||
msgid "The default logging level for this service is `info`, but you can increase it to `debug` (or even `trace`) with the following additional configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-baibot.md:416
|
||||
msgid ""
|
||||
"**Alternatively**, you can use a single variable to set the logging level"
|
||||
" for all of the above (bot + all libraries):"
|
||||
msgid "**Alternatively**, you can use a single variable to set the logging level for all of the above (bot + all libraries):"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,15 +26,11 @@ msgid "Setting up Buscarron (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure "
|
||||
"[Buscarron](https://github.com/etkecc/buscarron) for you."
|
||||
msgid "The playbook can install and configure [Buscarron](https://github.com/etkecc/buscarron) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:5
|
||||
msgid ""
|
||||
"Buscarron is bot that receives HTTP POST submissions of web forms and "
|
||||
"forwards them to a Matrix room."
|
||||
msgid "Buscarron is bot that receives HTTP POST submissions of web forms and forwards them to a Matrix room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:7
|
||||
@ -42,9 +38,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:9
|
||||
msgid ""
|
||||
"To enable Buscarron, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Buscarron, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:32
|
||||
@ -52,24 +46,15 @@ msgid "Adjusting the Buscarron URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:34
|
||||
msgid ""
|
||||
"By default, this playbook installs Buscarron on the `buscarron.` "
|
||||
"subdomain (`buscarron.example.com`) and requires you to [adjust your DNS "
|
||||
"records](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs Buscarron on the `buscarron.` subdomain (`buscarron.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:36
|
||||
msgid ""
|
||||
"By tweaking the `matrix_bot_buscarron_hostname` and "
|
||||
"`matrix_bot_buscarron_path_prefix` variables, you can easily make the "
|
||||
"service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_bot_buscarron_hostname` and `matrix_bot_buscarron_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-bot-buscarron.md:38
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:49
|
||||
@ -77,21 +62,15 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:51
|
||||
msgid ""
|
||||
"Once you've decided on the domain and path, **you may need to adjust your"
|
||||
" DNS** records to point the Buscarron domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Buscarron domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:53
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `buscarron`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `buscarron`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:55
|
||||
msgid ""
|
||||
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
|
||||
" extra DNS configuration."
|
||||
msgid "If you've decided to reuse the `matrix.` domain, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:57
|
||||
@ -99,10 +78,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:59
|
||||
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:"
|
||||
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-bot-buscarron.md:66
|
||||
@ -110,34 +86,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:68
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:70
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-buscarron.md:72
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:74
|
||||
msgid ""
|
||||
"If you change the bot password (`matrix_bot_buscarron_password` in your "
|
||||
"`vars.yml` file) subsequently, the bot user's credentials on the "
|
||||
"homeserver won't be updated automatically. If you'd like to change the "
|
||||
"bot user's password, use a tool like [synapse-admin](configuring-"
|
||||
"playbook-synapse-admin.md) to change it, and then update "
|
||||
"`matrix_bot_buscarron_password` to let the bot know its new password."
|
||||
msgid "If you change the bot password (`matrix_bot_buscarron_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_buscarron_password` to let the bot know its new password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:76
|
||||
@ -145,16 +106,11 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:78
|
||||
msgid ""
|
||||
"To use the bot, invite the `@bot.buscarron:example.com` to the room you "
|
||||
"specified in a config, after that any point your form to the form url, "
|
||||
"example for the `contact` form:"
|
||||
msgid "To use the bot, invite the `@bot.buscarron:example.com` to the room you specified in a config, after that any point your form to the form url, example for the `contact` form:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:86
|
||||
msgid ""
|
||||
"**Note**: to fight against spam, Buscarron is **very aggressive when it "
|
||||
"comes to banning** and will ban you if:"
|
||||
msgid "**Note**: to fight against spam, Buscarron is **very aggressive when it comes to banning** and will ban you if:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:88
|
||||
@ -162,27 +118,17 @@ msgid "if you hit the homepage (HTTP `GET` request to `/`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:89
|
||||
msgid ""
|
||||
"if you submit a form to the wrong URL (`POST` request to `/non-existing-"
|
||||
"form`)"
|
||||
msgid "if you submit a form to the wrong URL (`POST` request to `/non-existing-form`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:90
|
||||
msgid ""
|
||||
"if `hasemail` is enabled for the form (like in the example above) and you"
|
||||
" don't submit an `email` field"
|
||||
msgid "if `hasemail` is enabled for the form (like in the example above) and you don't submit an `email` field"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:92
|
||||
msgid ""
|
||||
"If you get banned, you'd need to restart the process by running the "
|
||||
"playbook with `--tags=start` or running `systemctl restart matrix-bot-"
|
||||
"buscarron` on the server."
|
||||
msgid "If you get banned, you'd need to restart the process by running the playbook with `--tags=start` or running `systemctl restart matrix-bot-buscarron` on the server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-buscarron.md:94
|
||||
msgid ""
|
||||
"You can also refer to the upstream "
|
||||
"[documentation](https://github.com/etkecc/buscarron)."
|
||||
msgid "You can also refer to the upstream [documentation](https://github.com/etkecc/buscarron)."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,25 +26,15 @@ msgid "Setting up matrix-bot-chatgpt (optional, unmaintained)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:3
|
||||
msgid ""
|
||||
"**Note**: [matrix-chatgpt-bot](https://github.com/matrixgpt/matrix-"
|
||||
"chatgpt-bot) is now an archived (**unmaintained**) project. Talking to "
|
||||
"ChatGPT (and many other LLM providers) can happen via the much more "
|
||||
"featureful [baibot](https://github.com/etkecc/baibot), which can be "
|
||||
"installed using [this playbook](configuring-playbook-bot-baibot.md). "
|
||||
"Consider using that bot instead of this one."
|
||||
msgid "**Note**: [matrix-chatgpt-bot](https://github.com/matrixgpt/matrix-chatgpt-bot) is now an archived (**unmaintained**) project. Talking to ChatGPT (and many other LLM providers) can happen via the much more featureful [baibot](https://github.com/etkecc/baibot), which can be installed using [this playbook](configuring-playbook-bot-baibot.md). Consider using that bot instead of this one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-chatgpt-"
|
||||
"bot](https://github.com/matrixgpt/matrix-chatgpt-bot) for you."
|
||||
msgid "The playbook can install and configure [matrix-chatgpt-bot](https://github.com/matrixgpt/matrix-chatgpt-bot) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:7
|
||||
msgid ""
|
||||
"Talk to [ChatGPT](https://openai.com/blog/chatgpt/) via your favourite "
|
||||
"Matrix client!"
|
||||
msgid "Talk to [ChatGPT](https://openai.com/blog/chatgpt/) via your favourite Matrix client!"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:9
|
||||
@ -52,9 +42,7 @@ msgid "Register the bot account"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:11
|
||||
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 "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-chatgpt.md:13
|
||||
@ -62,9 +50,7 @@ msgid "You **need to register the bot user manually** before setting up the bot.
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:15
|
||||
msgid ""
|
||||
"Choose a strong password for the bot. You can generate a good password "
|
||||
"with a command like this: `pwgen -s 64 1`."
|
||||
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-bot-chatgpt.md:17
|
||||
@ -76,18 +62,11 @@ msgid "Get an access token and create encryption keys"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:25
|
||||
msgid ""
|
||||
"Refer to the documentation on [how to obtain an access token](obtaining-"
|
||||
"access-tokens.md)."
|
||||
msgid "Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:27
|
||||
msgid ""
|
||||
"To make sure the bot can read encrypted messages, it will need an "
|
||||
"encryption key, just like any other new user. While obtaining the access "
|
||||
"token, follow the prompts to setup a backup key. More information can be "
|
||||
"found in the [Element "
|
||||
"documentation](https://element.io/help#encryption6)."
|
||||
msgid "To make sure the bot can read encrypted messages, it will need an encryption key, just like any other new user. While obtaining the access token, follow the prompts to setup a backup key. More information can be found in the [Element documentation](https://element.io/help#encryption6)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:29
|
||||
@ -95,10 +74,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:31
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
|
||||
"needs):"
|
||||
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-chatgpt.md:52
|
||||
@ -110,9 +86,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:56
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:63
|
||||
@ -120,24 +94,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:65
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:67
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-chatgpt.md:69
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:71
|
||||
@ -145,15 +110,9 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:73
|
||||
msgid ""
|
||||
"To use the bot, invite the `@bot.chatgpt:example.com` to the room you "
|
||||
"specified in a config, after that start speaking to it, use the prefix if"
|
||||
" you configured one or mention the bot."
|
||||
msgid "To use the bot, invite the `@bot.chatgpt:example.com` to the room you specified in a config, after that start speaking to it, use the prefix if you configured one or mention the bot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-chatgpt.md:75
|
||||
msgid ""
|
||||
"You can also refer to the upstream "
|
||||
"[documentation](https://github.com/matrixgpt/matrix-chatgpt-bot)."
|
||||
msgid "You can also refer to the upstream [documentation](https://github.com/matrixgpt/matrix-chatgpt-bot)."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,30 +26,19 @@ msgid "Setting up Draupnir (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [Draupnir](https://github.com"
|
||||
"/the-draupnir-project/Draupnir) moderation bot for you."
|
||||
msgid "The playbook can install and configure the [Draupnir](https://github.com/the-draupnir-project/Draupnir) moderation bot for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:5
|
||||
msgid ""
|
||||
"See the project's [documentation](https://github.com/the-draupnir-"
|
||||
"project/Draupnir/blob/main/README.md) to learn what it does and why it "
|
||||
"might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/the-draupnir-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
|
||||
msgid ""
|
||||
"This documentation page is about installing Draupnir in bot mode. As an "
|
||||
"alternative, you can run a multi-instance Draupnir deployment by "
|
||||
"installing [Draupnir in appservice mode](./configuring-playbook-"
|
||||
"appservice-draupnir-for-all.md) (called Draupnir-for-all) instead."
|
||||
msgid "This documentation page is about installing Draupnir in bot mode. As an alternative, you can run a multi-instance Draupnir deployment by installing [Draupnir in appservice mode](./configuring-playbook-appservice-draupnir-for-all.md) (called Draupnir-for-all) instead."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:9
|
||||
msgid ""
|
||||
"If your migrating from Mjolnir skip to [this section](#migrating-from-"
|
||||
"mjolnir-only-required-if-migrating)."
|
||||
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
|
||||
@ -61,15 +50,11 @@ msgid "Register the bot account"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.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."
|
||||
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
|
||||
msgid ""
|
||||
"Choose a strong password for the bot. You can generate a good password "
|
||||
"with a command like this: `pwgen -s 64 1`."
|
||||
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-bot-draupnir.md:19
|
||||
@ -77,11 +62,7 @@ msgid "You can use the playbook to [register a new user](registering-users.md):"
|
||||
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 "
|
||||
"then it must be a server admin so you need to change `admin=no` to "
|
||||
"`admin=yes` in the command above."
|
||||
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:27
|
||||
@ -89,10 +70,7 @@ msgid "Get an access token"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:29
|
||||
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)."
|
||||
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-bot-draupnir.md:31
|
||||
@ -100,59 +78,31 @@ msgid "Make sure the account is free from rate limiting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:33
|
||||
msgid ""
|
||||
"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.**"
|
||||
msgid "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 ""
|
||||
"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."
|
||||
msgid "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 ""
|
||||
"To expose the APIs publicly, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file."
|
||||
msgid "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: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)."
|
||||
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)."
|
||||
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:"
|
||||
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."
|
||||
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
|
||||
@ -160,32 +110,19 @@ msgid "Create a management room"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"bot and where you will send commands to the bot, such as the command to "
|
||||
"ban a user from another room. Anyone in this room can control the bot so "
|
||||
"it is important that you only invite trusted users to this room."
|
||||
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 bot and where you will send commands to the bot, such as the command to ban a user from another room. 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-bot-draupnir.md:59
|
||||
msgid ""
|
||||
"If you make the management room encrypted (E2EE), then you MUST enable "
|
||||
"and use Pantalaimon (see [below](#configuration-with-e2ee-support))."
|
||||
msgid "If you make the management room encrypted (E2EE), then you MUST enable and use Pantalaimon (see [below](#configuration-with-e2ee-support))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
" the room's settings, clicking Advanced, and then copying the internal "
|
||||
"room ID. The room ID will look something like `!qporfwt:example.com`."
|
||||
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 the room's settings, clicking Advanced, and then copying the internal room ID. The room ID will look something like `!qporfwt:example.com`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:63
|
||||
msgid ""
|
||||
"Finally invite the `@bot.draupnir:example.com` account you created "
|
||||
"earlier into the room."
|
||||
msgid "Finally invite the `@bot.draupnir:example.com` account you created earlier into the room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:65
|
||||
@ -193,10 +130,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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`."
|
||||
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
|
||||
@ -204,16 +138,11 @@ 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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:80
|
||||
msgid ""
|
||||
"To support E2EE, Draupnir needs to [use Pantalaimon](configuring-"
|
||||
"playbook-pantalaimon.md)."
|
||||
msgid "To support E2EE, Draupnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:82
|
||||
@ -221,25 +150,15 @@ 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."
|
||||
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:86
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
|
||||
"needs):"
|
||||
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:100
|
||||
msgid ""
|
||||
"The playbook's `group_vars` will configure other required settings. If "
|
||||
"using this role separately without the playbook, you also need to "
|
||||
"configure the two URLs that Draupnir uses to reach the homeserver, one "
|
||||
"through Pantalaimon and one \"raw\". This example is taken from the "
|
||||
"playbook's `group_vars`:"
|
||||
msgid "The playbook's `group_vars` will configure other required settings. If using this role separately without the playbook, you also need to configure the two URLs that Draupnir uses to reach the homeserver, one through Pantalaimon and one \"raw\". This example is taken from the playbook's `group_vars`:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:112
|
||||
@ -247,17 +166,11 @@ msgid "Configuration without E2EE support"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:116
|
||||
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)."
|
||||
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-bot-draupnir.md:122
|
||||
@ -269,19 +182,11 @@ 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:"
|
||||
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."
|
||||
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
|
||||
@ -289,16 +194,11 @@ 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."
|
||||
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:"
|
||||
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
|
||||
@ -306,15 +206,11 @@ 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."
|
||||
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:156
|
||||
msgid ""
|
||||
"That is all you need to do due to that Draupnir can complete migration on"
|
||||
" its own."
|
||||
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:158
|
||||
@ -322,9 +218,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:160
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:167
|
||||
@ -332,35 +226,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:171
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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:173
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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) "
|
||||
"subsequently, its credentials on the homeserver won't be updated "
|
||||
"automatically. If you'd like to change the password, use a tool like "
|
||||
"[synapse-admin](configuring-playbook-synapse-admin.md) to change it, and "
|
||||
"then update `matrix_bot_draupnir_pantalaimon_password` to let Pantalaimon"
|
||||
" know its new password."
|
||||
msgid "If you change the Pantalaimon's password (`matrix_bot_draupnir_pantalaimon_password` in your `vars.yml` file) subsequently, its credentials on the homeserver won't be updated automatically. If you'd like to change the password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_draupnir_pantalaimon_password` to let Pantalaimon know its new password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:177
|
||||
@ -368,10 +246,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:181
|
||||
@ -383,41 +258,23 @@ msgid "Making Draupnir join and protect a room"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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:"
|
||||
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:187
|
||||
msgid ""
|
||||
"Invite the bot to the room manually ([inviting Draupnir to rooms](https"
|
||||
"://the-draupnir-project.github.io/draupnir-documentation/moderator"
|
||||
"/managing-protected-rooms#inviting-draupnir-to-rooms)). Before joining, "
|
||||
"the bot *may* ask for confirmation in the Management Room"
|
||||
msgid "Invite the bot to the room manually ([inviting Draupnir to rooms](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#inviting-draupnir-to-rooms)). Before joining, the bot *may* ask for confirmation in the Management Room"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:189
|
||||
msgid ""
|
||||
"[Give the bot permissions to do its job](#giving-draupnir-permissions-to-"
|
||||
"do-its-job)"
|
||||
msgid "[Give the bot permissions to do its job](#giving-draupnir-permissions-to-do-its-job)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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-"
|
||||
"protected-rooms#using-the-draupnir-rooms-command)) by sending the "
|
||||
"following command to the Management Room: `!draupnir rooms add "
|
||||
"!qporfwt:example.com`"
|
||||
msgid "Tell it to protect the room (using the [rooms command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#using-the-draupnir-rooms-command)) by sending the following command to the Management Room: `!draupnir rooms add !qporfwt:example.com`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
" a public policy list](#subscribing-to-a-public-policy-list), [Create "
|
||||
"your own own policy and rules](#creating-your-own-policy-lists-and-rules)"
|
||||
" and [Enabling built-in protections](#enabling-built-in-protections)."
|
||||
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 a public policy list](#subscribing-to-a-public-policy-list), [Create your own own policy and rules](#creating-your-own-policy-lists-and-rules) and [Enabling built-in protections](#enabling-built-in-protections)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:195
|
||||
@ -425,20 +282,11 @@ msgid "Giving Draupnir permissions to do its job"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
"/managing-protected-rooms#giving-draupnir-permissions) in rooms it's "
|
||||
"protecting. This involves **giving it an Administrator power level**."
|
||||
msgid "For Draupnir to do its job, you need to [give it permissions](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-protected-rooms#giving-draupnir-permissions) in rooms it's protecting. This involves **giving it an Administrator power level**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"soon as they are available. If the bot is under-privileged, it may fail "
|
||||
"to apply protections and may not retry for a while (or until your restart"
|
||||
" it)."
|
||||
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 soon as they are available. If the bot is under-privileged, it may fail to apply protections and may not retry for a while (or until your restart it)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:201
|
||||
@ -446,25 +294,15 @@ msgid "Subscribing to a public policy list"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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-"
|
||||
"lists)** using the [watch command](https://the-draupnir-project.github.io"
|
||||
"/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-"
|
||||
"watch-command-to-subscribe-to-policy-rooms)."
|
||||
msgid "We recommend **subscribing to a public [policy list](https://the-draupnir-project.github.io/draupnir-documentation/concepts/policy-lists)** using the [watch command](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-watch-command-to-subscribe-to-policy-rooms)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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: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`"
|
||||
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:209
|
||||
@ -472,59 +310,31 @@ msgid "Creating your own policy lists and rules"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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-"
|
||||
"documentation/moderator/managing-policy-lists#using-draupnirs-list-"
|
||||
"create-command-to-create-a-policy-room) command."
|
||||
msgid "We also recommend **creating your own policy lists** with the [list create](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-list-create-command-to-create-a-policy-room) command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"list having a name (shortcode) of `my-bans` and stored in a public `#my-"
|
||||
"bans-bl:example.com` room on your server. As soon as you run this "
|
||||
"command, the bot will invite you to the policy list room."
|
||||
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 list having a name (shortcode) of `my-bans` and stored in a public `#my-bans-bl:example.com` room on your server. As soon as you run this command, the bot will invite you to the policy list room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"of: `user`, `room` or `server`). These entities are mentioned on the "
|
||||
"[policy lists](https://the-draupnir-project.github.io/draupnir-"
|
||||
"documentation/concepts/policy-lists) documentation page and in the Matrix"
|
||||
" Spec [here](https://spec.matrix.org/v1.11/client-server-api/#mban-"
|
||||
"recommendation)."
|
||||
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 of: `user`, `room` or `server`). These entities are mentioned on the [policy lists](https://the-draupnir-project.github.io/draupnir-documentation/concepts/policy-lists) documentation page and in the Matrix Spec [here](https://spec.matrix.org/v1.11/client-server-api/#mban-recommendation)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
"/draupnir-documentation/moderator/managing-users#the-ban-command) and "
|
||||
"targeting users."
|
||||
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/draupnir-documentation/moderator/managing-users#the-ban-command) and targeting users."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:219
|
||||
msgid ""
|
||||
"To create rules, you run commands in the Management Room (**not** in the "
|
||||
"policy list room)."
|
||||
msgid "To create rules, you run commands in the Management Room (**not** in the policy list room)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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`"
|
||||
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:222
|
||||
msgid ""
|
||||
"(ban all users on a given homeserver by using a [wildcard](https://the-"
|
||||
"draupnir-project.github.io/draupnir-documentation/moderator/managing-"
|
||||
"users#wildcards)): `!draupnir ban @*:example.org my-bans Spam server - "
|
||||
"all users are fake`"
|
||||
msgid "(ban all users on a given homeserver by using a [wildcard](https://the-draupnir-project.github.io/draupnir-documentation/moderator/managing-users#wildcards)): `!draupnir ban @*:example.org my-bans Spam server - all users are fake`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-draupnir.md:224
|
||||
@ -532,22 +342,15 @@ msgid "As a result of running these commands, you may observe:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
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:227
|
||||
msgid ""
|
||||
"applying these rules against all rooms that Draupnir is an Administrator "
|
||||
"in"
|
||||
msgid "applying these rules against all rooms that Draupnir is an Administrator in"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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)."
|
||||
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:231
|
||||
@ -555,186 +358,25 @@ msgid "Enabling built-in protections"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"`JoinWaveShortCircuit` (\"If X amount of users join in Y time, set the "
|
||||
"room to invite-only\")."
|
||||
msgid "You can also **turn on various built-in [protections](https://the-draupnir-project.github.io/draupnir-documentation/protections)** like `JoinWaveShortCircuit` (\"If X amount of users join in Y time, set the room to invite-only\")."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:237
|
||||
msgid ""
|
||||
"To **see the configuration options for a given protection**, send a "
|
||||
"`!draupnir config get PROTECTION_NAME` (e.g. `!draupnir config get "
|
||||
"JoinWaveShortCircuit`)."
|
||||
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: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`)."
|
||||
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:241
|
||||
msgid ""
|
||||
"To **enable a given protection**, send a command like this: `!draupnir "
|
||||
"enable PROTECTION_NAME` (e.g. `!draupnir enable JoinWaveShortCircuit`)."
|
||||
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:243
|
||||
msgid ""
|
||||
"To **disable a given protection**, send a command like this: `!draupnir "
|
||||
"disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)."
|
||||
msgid "To **disable a given protection**, send a command like this: `!draupnir disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)."
|
||||
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 ""
|
||||
|
||||
#~ msgid "If your migrating from Mjolnir skip to step 5b."
|
||||
#~ 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 ""
|
||||
#~ "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 ""
|
||||
|
||||
#~ 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 "
|
||||
#~ "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 <access_token>\""
|
||||
#~ " -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 ""
|
||||
|
||||
|
||||
@ -22,33 +22,19 @@ msgid "Setting up Go-NEB (optional, unmaintained)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:3
|
||||
msgid ""
|
||||
"**Note**: [Go-NEB](https://github.com/matrix-org/go-neb) is now an "
|
||||
"archived (**unmaintained**) project. We recommend not bothering with "
|
||||
"installing it. While not a 1:1 replacement, the bridge's author suggests "
|
||||
"taking a look at [matrix-hookshot](https://github.com/matrix-org/matrix-"
|
||||
"hookshot) as a replacement, which can also be installed using [this "
|
||||
"playbook](configuring-playbook-bridge-hookshot.md). Consider using that "
|
||||
"bot instead of this one."
|
||||
msgid "**Note**: [Go-NEB](https://github.com/matrix-org/go-neb) is now an archived (**unmaintained**) project. We recommend not bothering with installing it. While not a 1:1 replacement, the bridge's author suggests taking a look at [matrix-hookshot](https://github.com/matrix-org/matrix-hookshot) as a replacement, which can also be installed using [this playbook](configuring-playbook-bridge-hookshot.md). Consider using that bot instead of this one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure [Go-NEB](https://github.com"
|
||||
"/matrix-org/go-neb) for you."
|
||||
msgid "The playbook can install and configure [Go-NEB](https://github.com/matrix-org/go-neb) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:7
|
||||
msgid ""
|
||||
"Go-NEB is a Matrix bot written in Go. It is the successor to Matrix-NEB, "
|
||||
"the original Matrix bot written in Python."
|
||||
msgid "Go-NEB is a Matrix bot written in Go. It is the successor to Matrix-NEB, the original Matrix bot written in Python."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:9
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -56,10 +42,7 @@ msgid "Registering the bot account"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:13
|
||||
msgid ""
|
||||
"The playbook does not automatically create users for you. The bot "
|
||||
"requires at least 1 access token to be able to connect to your "
|
||||
"homeserver."
|
||||
msgid "The playbook does not automatically create users for you. The bot requires at least 1 access token to be able to connect to your homeserver."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:15
|
||||
@ -67,9 +50,7 @@ msgid "You **need to register the bot user manually** before setting up the bot.
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.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`."
|
||||
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-bot-go-neb.md:19
|
||||
@ -77,9 +58,7 @@ msgid "You can use the playbook to [register a new user](registering-users.md):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:25
|
||||
msgid ""
|
||||
"Once the user is created you can [obtain an access token](obtaining-"
|
||||
"access-tokens.md)."
|
||||
msgid "Once the user is created you can [obtain an access token](obtaining-access-tokens.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:27
|
||||
@ -87,9 +66,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:29
|
||||
msgid ""
|
||||
"To enable Go-NEB, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Go-NEB, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:193
|
||||
@ -97,24 +74,15 @@ msgid "Adjusting the Go-NEB URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:195
|
||||
msgid ""
|
||||
"By default, this playbook installs Go-NEB on the `goneb.` subdomain "
|
||||
"(`goneb.example.com`) and requires you to [adjust your DNS records"
|
||||
"](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs Go-NEB on the `goneb.` subdomain (`goneb.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:197
|
||||
msgid ""
|
||||
"By tweaking the `matrix_bot_go_neb_hostname` and "
|
||||
"`matrix_bot_go_neb_path_prefix` variables, you can easily make the "
|
||||
"service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_bot_go_neb_hostname` and `matrix_bot_go_neb_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-bot-go-neb.md:199
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:210
|
||||
@ -122,21 +90,15 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:212
|
||||
msgid ""
|
||||
"Once you've decided on the domain and path, **you may need to adjust your"
|
||||
" DNS** records to point the Go-NEB domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Go-NEB domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:214
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `goneb`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `goneb`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:216
|
||||
msgid ""
|
||||
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
|
||||
" extra DNS configuration."
|
||||
msgid "If you've decided to reuse the `matrix.` domain, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:218
|
||||
@ -144,10 +106,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:220
|
||||
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:"
|
||||
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-bot-go-neb.md:227
|
||||
@ -155,24 +114,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:229
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:231
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-go-neb.md:233
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:235
|
||||
@ -180,35 +130,17 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:237
|
||||
msgid ""
|
||||
"To use the bot, invite it to any existing Matrix room (`/invite @bot.go-"
|
||||
"neb:example.com` where `example.com` is your base domain, not the "
|
||||
"`matrix.` domain). Make sure you are granted with the sufficient "
|
||||
"permission if you are not the room owner."
|
||||
msgid "To use the bot, invite it to any existing Matrix room (`/invite @bot.go-neb:example.com` where `example.com` is your base domain, not the `matrix.` domain). Make sure you are granted with the sufficient permission if you are not the room owner."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:239
|
||||
msgid ""
|
||||
"Basic usage is like this: `!echo hi` or `!imgur puppies` or `!giphy "
|
||||
"matrix`"
|
||||
msgid "Basic usage is like this: `!echo hi` or `!imgur puppies` or `!giphy matrix`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:241
|
||||
msgid ""
|
||||
"If you enabled the github_cmd service you can get the supported commands "
|
||||
"via `!github help`"
|
||||
msgid "If you enabled the github_cmd service you can get the supported commands via `!github help`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-go-neb.md:243
|
||||
msgid ""
|
||||
"You can also refer to the upstream [Documentation](https://github.com"
|
||||
"/matrix-org/go-neb)."
|
||||
msgid "You can also refer to the upstream [Documentation](https://github.com/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 ""
|
||||
|
||||
|
||||
@ -26,9 +26,7 @@ msgid "Setting up Honoroit (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure "
|
||||
"[Honoroit](https://github.com/etkecc/honoroit) for you."
|
||||
msgid "The playbook can install and configure [Honoroit](https://github.com/etkecc/honoroit) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:5
|
||||
@ -36,10 +34,7 @@ msgid "It's a bot you can use to setup **your own helpdesk on matrix**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:7
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -47,9 +42,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:11
|
||||
msgid ""
|
||||
"To enable Honoroit, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Honoroit, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:26
|
||||
@ -57,25 +50,15 @@ msgid "Adjusting the Honoroit URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:28
|
||||
msgid ""
|
||||
"By default, this playbook installs Honoroit on the `matrix.` subdomain, "
|
||||
"at the `/honoroit` path (https://matrix.example.com/honoroit). This makes"
|
||||
" it easy to install it, because it **doesn't require additional DNS "
|
||||
"records to be set up**. If that's okay, you can skip this section."
|
||||
msgid "By default, this playbook installs Honoroit on the `matrix.` subdomain, at the `/honoroit` path (https://matrix.example.com/honoroit). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:30
|
||||
msgid ""
|
||||
"By tweaking the `matrix_bot_honoroit_hostname` and "
|
||||
"`matrix_bot_honoroit_path_prefix` variables, you can easily make the "
|
||||
"service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_bot_honoroit_hostname` and `matrix_bot_honoroit_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-bot-honoroit.md:32
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:40
|
||||
@ -83,9 +66,7 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:42
|
||||
msgid ""
|
||||
"If you've changed the default hostname, **you may need to adjust your "
|
||||
"DNS** records to point the Honoroit domain to the Matrix server."
|
||||
msgid "If you've changed the default hostname, **you may need to adjust your DNS** records to point the Honoroit domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:44
|
||||
@ -93,9 +74,7 @@ msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:46
|
||||
msgid ""
|
||||
"If you've decided to use the default hostname, you won't need to do any "
|
||||
"extra DNS configuration."
|
||||
msgid "If you've decided to use the default hostname, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:48
|
||||
@ -103,10 +82,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:50
|
||||
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:"
|
||||
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-bot-honoroit.md:57
|
||||
@ -114,34 +90,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:59
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:61
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-honoroit.md:63
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:65
|
||||
msgid ""
|
||||
"If you change the bot password (`matrix_bot_honoroit_password` in your "
|
||||
"`vars.yml` file) subsequently, the bot user's credentials on the "
|
||||
"homeserver won't be updated automatically. If you'd like to change the "
|
||||
"bot user's password, use a tool like [synapse-admin](configuring-"
|
||||
"playbook-synapse-admin.md) to change it, and then update "
|
||||
"`matrix_bot_honoroit_password` to let the bot know its new password."
|
||||
msgid "If you change the bot password (`matrix_bot_honoroit_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_honoroit_password` to let the bot know its new password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:67
|
||||
@ -149,29 +110,13 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:69
|
||||
msgid ""
|
||||
"To use the bot, invite the `@honoroit:example.com` to the room you "
|
||||
"specified in config, after that any Matrix user can send a message to the"
|
||||
" `@honoroit:example.com` to start a new thread in that room."
|
||||
msgid "To use the bot, invite the `@honoroit:example.com` to the room you specified in config, after that any Matrix user can send a message to the `@honoroit:example.com` to start a new thread in that room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:71
|
||||
msgid ""
|
||||
"Send `!ho help` to the room to see the bot's help menu for additional "
|
||||
"commands."
|
||||
msgid "Send `!ho help` to the room to see the bot's help menu for additional commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-honoroit.md:73
|
||||
msgid ""
|
||||
"You can also refer to the upstream "
|
||||
"[documentation](https://github.com/etkecc/honoroit#features)."
|
||||
msgid "You can also refer to the upstream [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 ""
|
||||
|
||||
|
||||
@ -26,26 +26,15 @@ msgid "Setting up matrix-registration-bot (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-registration-"
|
||||
"bot](https://github.com/moan0s/matrix-registration-bot) for you."
|
||||
msgid "The playbook can install and configure [matrix-registration-bot](https://github.com/moan0s/matrix-registration-bot) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:5
|
||||
msgid ""
|
||||
"The bot allows you to easily **create and manage registration tokens** "
|
||||
"aka. invitation codes. It can be used for an invitation-based server, "
|
||||
"where you invite someone by sending them a registration token (tokens "
|
||||
"look like this: `rbalQ0zkaDSRQCOp`). They can register as per normal but "
|
||||
"have to provide a valid registration token in the final step of the "
|
||||
"registration process."
|
||||
msgid "The bot allows you to easily **create and manage registration tokens** aka. invitation codes. It can be used for an invitation-based server, where you invite someone by sending them a registration token (tokens look like this: `rbalQ0zkaDSRQCOp`). They can register as per normal but have to provide a valid registration token in the final step of the registration process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:7
|
||||
msgid ""
|
||||
"See the project's [documentation](https://github.com/moan0s/matrix-"
|
||||
"registration-bot/blob/master/README.md) to learn what it does and why it "
|
||||
"might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/moan0s/matrix-registration-bot/blob/master/README.md) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:9
|
||||
@ -53,9 +42,7 @@ msgid "Configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:11
|
||||
msgid ""
|
||||
"To enable the bot, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:30
|
||||
@ -67,9 +54,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:34
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:41
|
||||
@ -77,36 +62,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:43
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:45
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-matrix-registration-bot.md:47
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:49
|
||||
msgid ""
|
||||
"If you change the bot password "
|
||||
"(`matrix_bot_matrix_registration_bot_bot_password` in your `vars.yml` "
|
||||
"file) subsequently, the bot user's credentials on the homeserver won't be"
|
||||
" updated automatically. If you'd like to change the bot user's password, "
|
||||
"use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to"
|
||||
" change it, and then update "
|
||||
"`matrix_bot_matrix_registration_bot_bot_password` to let the bot know its"
|
||||
" new password."
|
||||
msgid "If you change the bot password (`matrix_bot_matrix_registration_bot_bot_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_matrix_registration_bot_bot_password` to let the bot know its new password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:51
|
||||
@ -114,10 +82,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:53
|
||||
msgid ""
|
||||
"To use the bot, start a chat with `@bot.matrix-registration-"
|
||||
"bot:example.com` (where `example.com` is your base domain, not the "
|
||||
"`matrix.` domain)."
|
||||
msgid "To use the bot, start a chat with `@bot.matrix-registration-bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:55
|
||||
@ -125,32 +90,13 @@ msgid "In this room send `help` and the bot will reply with all options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:57
|
||||
msgid ""
|
||||
"You can also refer to the upstream [Usage "
|
||||
"documentation](https://github.com/moan0s/matrix-registration-bot"
|
||||
"#supported-commands)."
|
||||
msgid "You can also refer to the upstream [Usage documentation](https://github.com/moan0s/matrix-registration-bot#supported-commands)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:59
|
||||
msgid ""
|
||||
"If you have any questions, or if you need help setting it up, read the "
|
||||
"[troublshooting guide](https://github.com/moan0s/matrix-registration-"
|
||||
"bot/blob/main/docs/troubleshooting.md) or join [#matrix-registration-"
|
||||
"bot:hyteck.de](https://matrix.to/#/#matrix-registration-bot:hyteck.de)."
|
||||
msgid "If you have any questions, or if you need help setting it up, read the [troublshooting guide](https://github.com/moan0s/matrix-registration-bot/blob/main/docs/troubleshooting.md) or join [#matrix-registration-bot:hyteck.de](https://matrix.to/#/#matrix-registration-bot:hyteck.de)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:61
|
||||
msgid ""
|
||||
"To clean the cache (session & encryption data) after you changed the "
|
||||
"bot's username, changed the login method from access_token to password "
|
||||
"etc… you can use:"
|
||||
msgid "To clean the cache (session & encryption data) after you changed the bot's username, changed the login method from access_token to password 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 ""
|
||||
|
||||
|
||||
@ -26,22 +26,15 @@ msgid "Setting up matrix-reminder-bot (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-reminder-"
|
||||
"bot](https://github.com/anoadragon453/matrix-reminder-bot) for you."
|
||||
msgid "The playbook can install and configure [matrix-reminder-bot](https://github.com/anoadragon453/matrix-reminder-bot) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:5
|
||||
msgid ""
|
||||
"It's a bot you can use to **schedule one-off & recurring reminders and "
|
||||
"alarms**."
|
||||
msgid "It's a bot you can use to **schedule one-off & recurring reminders and alarms**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:7
|
||||
msgid ""
|
||||
"See the project's [documentation](https://github.com/anoadragon453"
|
||||
"/matrix-reminder-bot/blob/master/README.md) to learn what it does and why"
|
||||
" it might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/anoadragon453/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
|
||||
@ -49,9 +42,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:11
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:26
|
||||
@ -59,9 +50,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:28
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:35
|
||||
@ -69,36 +58,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:37
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:39
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-matrix-reminder-bot.md:41
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:43
|
||||
msgid ""
|
||||
"If you change the bot password "
|
||||
"(`matrix_bot_matrix_reminder_bot_matrix_user_password` in your `vars.yml`"
|
||||
" file) subsequently, the bot user's credentials on the homeserver won't "
|
||||
"be updated automatically. If you'd like to change the bot user's "
|
||||
"password, use a tool like [synapse-admin](configuring-playbook-synapse-"
|
||||
"admin.md) to change it, and then update "
|
||||
"`matrix_bot_matrix_reminder_bot_matrix_user_password` to let the bot know"
|
||||
" its new password."
|
||||
msgid "If you change the bot password (`matrix_bot_matrix_reminder_bot_matrix_user_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_matrix_reminder_bot_matrix_user_password` to let the bot know its new password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:45
|
||||
@ -106,15 +78,11 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:47
|
||||
msgid ""
|
||||
"To use the bot, start a chat with `@bot.matrix-reminder-bot:example.com` "
|
||||
"(where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bot, start a chat with `@bot.matrix-reminder-bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:49
|
||||
msgid ""
|
||||
"You can also add the bot to any existing Matrix room (`/invite @bot"
|
||||
".matrix-reminder-bot:example.com`)."
|
||||
msgid "You can also add the bot to any existing Matrix room (`/invite @bot.matrix-reminder-bot:example.com`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:51
|
||||
@ -122,23 +90,9 @@ msgid "Basic usage is like this: `!remindme in 2 minutes; This is a test`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:53
|
||||
msgid ""
|
||||
"Send `!help reminders` to the room to see the bot's help menu for "
|
||||
"additional commands."
|
||||
msgid "Send `!help reminders` to the room to see the bot's help menu for additional commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:55
|
||||
msgid ""
|
||||
"You can also refer to the upstream [Usage "
|
||||
"documentation](https://github.com/anoadragon453/matrix-reminder-"
|
||||
"bot#usage)."
|
||||
msgid "You can also refer to the upstream [Usage documentation](https://github.com/anoadragon453/matrix-reminder-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 ""
|
||||
|
||||
|
||||
@ -26,23 +26,15 @@ msgid "Setting up maubot (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure "
|
||||
"[maubot](https://github.com/maubot/maubot) for you."
|
||||
msgid "The playbook can install and configure [maubot](https://github.com/maubot/maubot) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:5
|
||||
msgid ""
|
||||
"After setting up maubot, you can use the web management interface to make"
|
||||
" it do things. The default location of the management interface is "
|
||||
"`matrix.example.com/_matrix/maubot/`"
|
||||
msgid "After setting up maubot, you can use the web management interface to make it do things. The default location of the management interface is `matrix.example.com/_matrix/maubot/`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:7
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://docs.mau.fi/maubot/usage/basic.html) to learn "
|
||||
"what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://docs.mau.fi/maubot/usage/basic.html) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:9
|
||||
@ -50,15 +42,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:11
|
||||
msgid ""
|
||||
"To enable maubot, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable maubot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:26
|
||||
msgid ""
|
||||
"You can add multiple admins. The admin accounts are only used to access "
|
||||
"the maubot administration interface."
|
||||
msgid "You can add multiple admins. The admin accounts are only used to access the maubot administration interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:28
|
||||
@ -66,26 +54,15 @@ msgid "Adjusting the maubot URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:30
|
||||
msgid ""
|
||||
"By default, this playbook installs maubot on the `matrix.` subdomain, at "
|
||||
"the `/_matrix/maubot/` path (https://matrix.example.com/_matrix/maubot/)."
|
||||
" This makes it easy to install it, because it **doesn't require "
|
||||
"additional DNS records to be set up**. If that's okay, you can skip this "
|
||||
"section."
|
||||
msgid "By default, this playbook installs maubot on the `matrix.` subdomain, at the `/_matrix/maubot/` path (https://matrix.example.com/_matrix/maubot/). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:32
|
||||
msgid ""
|
||||
"By tweaking the `matrix_bot_maubot_hostname` and "
|
||||
"`matrix_bot_maubot_path_prefix` variables, you can easily make the "
|
||||
"service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_bot_maubot_hostname` and `matrix_bot_maubot_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-bot-maubot.md:34
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:42
|
||||
@ -93,9 +70,7 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:44
|
||||
msgid ""
|
||||
"If you've changed the default hostname, **you may need to adjust your "
|
||||
"DNS** records to point the maubot domain to the Matrix server."
|
||||
msgid "If you've changed the default hostname, **you may need to adjust your DNS** records to point the maubot domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:46
|
||||
@ -103,9 +78,7 @@ msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:48
|
||||
msgid ""
|
||||
"If you've decided to use the default hostname, you won't need to do any "
|
||||
"extra DNS configuration."
|
||||
msgid "If you've decided to use the default hostname, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:50
|
||||
@ -113,10 +86,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:52
|
||||
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:"
|
||||
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-bot-maubot.md:59
|
||||
@ -124,35 +94,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:61
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:63
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-maubot.md:65
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:67
|
||||
msgid ""
|
||||
"If you change the bot password (`matrix_bot_maubot_initial_password` in "
|
||||
"your `vars.yml` file) subsequently, the bot user's credentials on the "
|
||||
"homeserver won't be updated automatically. If you'd like to change the "
|
||||
"bot user's password, use a tool like [synapse-admin](configuring-"
|
||||
"playbook-synapse-admin.md) to change it, and then update "
|
||||
"`matrix_bot_maubot_initial_password` to let the bot know its new "
|
||||
"password."
|
||||
msgid "If you change the bot password (`matrix_bot_maubot_initial_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_maubot_initial_password` to let the bot know its new password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:69
|
||||
@ -160,9 +114,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:71
|
||||
msgid ""
|
||||
"By default, you can visit `matrix.example.com/_matrix/maubot/` to manage "
|
||||
"your available plugins, clients and instances."
|
||||
msgid "By default, you can visit `matrix.example.com/_matrix/maubot/` to manage your available plugins, clients and instances."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:73
|
||||
@ -170,24 +122,15 @@ msgid "You should start in the following order"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:74
|
||||
msgid ""
|
||||
"**Create one or more clients**: A client is a Matrix account which the "
|
||||
"bot will use to message. By default, the playbook creates a `bot.maubot` "
|
||||
"account (as per the configuration above). You only need to [obtain an "
|
||||
"access token](#obtaining-an-access-token) for it"
|
||||
msgid "**Create one or more clients**: A client is a Matrix account which the bot will use to message. By default, the playbook creates a `bot.maubot` account (as per the configuration above). You only need to [obtain an access token](#obtaining-an-access-token) for it"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:75
|
||||
msgid ""
|
||||
"**Upload some Plugins**: Plugins can be obtained from "
|
||||
"[here](https://github.com/maubot/maubot#plugins) or any other source."
|
||||
msgid "**Upload some Plugins**: Plugins can be obtained from [here](https://github.com/maubot/maubot#plugins) or any other source."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:76
|
||||
msgid ""
|
||||
"**Create an instance**: An instance is the actual bot. You have to "
|
||||
"specify a client which the bot instance will use and the plugin (how the "
|
||||
"bot will behave)"
|
||||
msgid "**Create an instance**: An instance is the actual bot. You have to specify a client which the bot instance will use and the plugin (how the bot will behave)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:78
|
||||
@ -195,20 +138,9 @@ msgid "Obtaining an access token"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:80
|
||||
msgid ""
|
||||
"This can be done via `mbc login` then `mbc auth` (see the [maubot "
|
||||
"documentation](https://docs.mau.fi/maubot/usage/cli/auth.html)). To run "
|
||||
"these commands, you'll first need to `exec` into the maubot container "
|
||||
"with `docker exec -it matrix-bot-maubot sh`."
|
||||
msgid "This can be done via `mbc login` then `mbc auth` (see the [maubot documentation](https://docs.mau.fi/maubot/usage/cli/auth.html)). To run these commands, you'll first need to `exec` into the maubot container with `docker exec -it matrix-bot-maubot sh`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-maubot.md:82
|
||||
msgid ""
|
||||
"Alternatively, you can follow our generic [obtain an access token"
|
||||
"](obtaining-access-tokens.md) documentation. Be aware that you'd better "
|
||||
"use the **Obtain an access token via curl** method (not **Obtain an "
|
||||
"access token via Element Web**) as the latter will give your bot issues "
|
||||
"in encrypted rooms. Read "
|
||||
"[more](https://docs.mau.fi/maubot/usage/basic.html#creating-clients)."
|
||||
msgid "Alternatively, you can follow our generic [obtain an access token](obtaining-access-tokens.md) documentation. Be aware that you'd better use the **Obtain an access token via curl** method (not **Obtain an access token via Element Web**) as the latter will give your bot issues in encrypted rooms. Read [more](https://docs.mau.fi/maubot/usage/basic.html#creating-clients)."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,16 +26,11 @@ msgid "Setting up Mjolnir (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [Mjolnir](https://github.com"
|
||||
"/matrix-org/mjolnir) moderation bot for you."
|
||||
msgid "The playbook can install and configure the [Mjolnir](https://github.com/matrix-org/mjolnir) moderation bot for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -47,15 +42,11 @@ msgid "Register the bot account"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:11
|
||||
msgid ""
|
||||
"The playbook does not automatically create users for you. 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
|
||||
msgid ""
|
||||
"Choose a strong password for the bot. You can generate a good password "
|
||||
"with a command like this: `pwgen -s 64 1`."
|
||||
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-bot-mjolnir.md:15
|
||||
@ -63,10 +54,7 @@ msgid "You can use the playbook to [register a new user](registering-users.md):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:21
|
||||
msgid ""
|
||||
"If you would like Mjolnir to be able to deactivate users, move aliases, "
|
||||
"shutdown rooms, etc then it must be a server admin so you need to change "
|
||||
"`admin=no` to `admin=yes` in the command above."
|
||||
msgid "If you would like Mjolnir to be able to deactivate users, move aliases, shutdown rooms, 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-mjolnir.md:23
|
||||
@ -74,10 +62,7 @@ msgid "Get an access token"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:25
|
||||
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)."
|
||||
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-bot-mjolnir.md:27
|
||||
@ -85,59 +70,31 @@ msgid "Make sure the account is free from rate limiting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:29
|
||||
msgid ""
|
||||
"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.**"
|
||||
msgid "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 ""
|
||||
"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."
|
||||
msgid "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 ""
|
||||
"To expose the APIs publicly, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file."
|
||||
msgid "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: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)."
|
||||
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)."
|
||||
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:"
|
||||
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."
|
||||
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
|
||||
@ -145,32 +102,19 @@ msgid "Create a management room"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"bot and where you will send commands to the bot, such as the command to "
|
||||
"ban a user from another room. Anyone in this room can control the bot so "
|
||||
"it is important that you only invite trusted users to this room."
|
||||
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 bot and where you will send commands to the bot, such as the command to ban a user from another room. 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-bot-mjolnir.md:55
|
||||
msgid ""
|
||||
"If you make the management room encrypted (E2EE), then you MUST enable "
|
||||
"and use Pantalaimon (see [below](#configuration-with-e2ee-support))."
|
||||
msgid "If you make the management room encrypted (E2EE), then you MUST enable and use Pantalaimon (see [below](#configuration-with-e2ee-support))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
" the room's settings, clicking Advanced, and then copying the internal "
|
||||
"room ID. The room ID will look something like `!qporfwt:example.com`."
|
||||
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 the room's settings, clicking Advanced, and then copying the internal room ID. The room ID will look something like `!qporfwt:example.com`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:59
|
||||
msgid ""
|
||||
"Finally invite the `@bot.mjolnir:example.com` account you created earlier"
|
||||
" into the room."
|
||||
msgid "Finally invite the `@bot.mjolnir:example.com` account you created earlier into the room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:61
|
||||
@ -178,10 +122,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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`."
|
||||
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
|
||||
@ -189,16 +130,11 @@ 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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:76
|
||||
msgid ""
|
||||
"To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-"
|
||||
"pantalaimon.md)."
|
||||
msgid "To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-pantalaimon.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:78
|
||||
@ -206,25 +142,15 @@ 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."
|
||||
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:82
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
|
||||
"needs):"
|
||||
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:96
|
||||
msgid ""
|
||||
"The playbook's `group_vars` will configure other required settings. If "
|
||||
"using this role separately without the playbook, you also need to "
|
||||
"configure the two URLs that Mjolnir uses to reach the homeserver, one "
|
||||
"through Pantalaimon and one \"raw\". This example is taken from the "
|
||||
"playbook's `group_vars`:"
|
||||
msgid "The playbook's `group_vars` will configure other required settings. If using this role separately without the playbook, you also need to configure the two URLs that Mjolnir uses to reach the homeserver, one through Pantalaimon and one \"raw\". This example is taken from the playbook's `group_vars`:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:108
|
||||
@ -232,17 +158,11 @@ msgid "Configuration without E2EE support"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:112
|
||||
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)."
|
||||
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-bot-mjolnir.md:118
|
||||
@ -250,10 +170,7 @@ msgid "Adding Mjolnir synapse antispam module (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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):"
|
||||
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
|
||||
@ -261,17 +178,11 @@ 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."
|
||||
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:"
|
||||
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
|
||||
@ -279,9 +190,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:150
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:157
|
||||
@ -289,35 +198,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:161
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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:163
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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) "
|
||||
"subsequently, its credentials on the homeserver won't be updated "
|
||||
"automatically. If you'd like to change the password, use a tool like "
|
||||
"[synapse-admin](configuring-playbook-synapse-admin.md) to change it, and "
|
||||
"then update `matrix_bot_mjolnir_pantalaimon_password` to let Pantalaimon "
|
||||
"know its new password."
|
||||
msgid "If you change the Pantalaimon's password (`matrix_bot_mjolnir_pantalaimon_password` in your `vars.yml` file) subsequently, its credentials on the homeserver won't be updated automatically. If you'd like to change the password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_mjolnir_pantalaimon_password` to let Pantalaimon know its new password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bot-mjolnir.md:167
|
||||
@ -325,120 +218,5 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"their [quickstart guide](https://github.com/matrix-org/mjolnir"
|
||||
"#quickstart-guide) for some basic commands you can give to the bot."
|
||||
msgid "You can refer to the upstream [documentation](https://github.com/matrix-org/mjolnir) for additional ways to use and configure Mjolnir. Check out their [quickstart guide](https://github.com/matrix-org/mjolnir#quickstart-guide) for some basic commands you can give to the bot."
|
||||
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 ""
|
||||
|
||||
#~ 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 <access_token>\""
|
||||
#~ " -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 ""
|
||||
|
||||
|
||||
@ -26,38 +26,23 @@ msgid "Setting up Appservice Discord bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:3
|
||||
msgid ""
|
||||
"**Note**: bridging to [Discord](https://discordapp.com/) can also happen "
|
||||
"via the [mx-puppet-discord](configuring-playbook-bridge-mx-puppet-"
|
||||
"discord.md) and [mautrix-discord](configuring-playbook-bridge-mautrix-"
|
||||
"discord.md) bridges supported by the playbook."
|
||||
msgid "**Note**: bridging to [Discord](https://discordapp.com/) can also happen via the [mx-puppet-discord](configuring-playbook-bridge-mx-puppet-discord.md) and [mautrix-discord](configuring-playbook-bridge-mautrix-discord.md) bridges supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:4
|
||||
msgid ""
|
||||
"For using as a Bot we are recommend the Appservice Discord bridge (the "
|
||||
"one being discussed here), because it supports plumbing."
|
||||
msgid "For using as a Bot we are recommend the Appservice Discord bridge (the one being discussed here), because it supports plumbing."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:5
|
||||
msgid ""
|
||||
"For personal use we recommend the [mautrix-discord](configuring-playbook-"
|
||||
"bridge-mautrix-discord.md) bridge, because it is the most fully-featured "
|
||||
"and stable of the 3 Discord bridges supported by the playbook."
|
||||
msgid "For personal use we recommend the [mautrix-discord](configuring-playbook-bridge-mautrix-discord.md) bridge, because it is the most fully-featured and stable of the 3 Discord bridges supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:7
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-appservice-"
|
||||
"discord](https://github.com/matrix-org/matrix-appservice-discord) for "
|
||||
"you."
|
||||
msgid "The playbook can install and configure [matrix-appservice-discord](https://github.com/matrix-org/matrix-appservice-discord) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:9
|
||||
msgid ""
|
||||
"See the project's [documentation](https://github.com/matrix-org/matrix-"
|
||||
"appservice-discord/blob/master/README.md) to learn what it does and why "
|
||||
"it might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/matrix-org/matrix-appservice-discord/blob/master/README.md) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:11
|
||||
@ -65,10 +50,7 @@ msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:13
|
||||
msgid ""
|
||||
"Create a Discord Application "
|
||||
"[here](https://discordapp.com/developers/applications). Then retrieve "
|
||||
"Client ID, and create a bot from the Bot tab and retrieve the Bot token."
|
||||
msgid "Create a Discord Application [here](https://discordapp.com/developers/applications). Then retrieve Client ID, and create a bot from the Bot tab and retrieve the Bot token."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:15
|
||||
@ -76,9 +58,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:17
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-appservice-discord.md:31
|
||||
@ -86,9 +66,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:33
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:40
|
||||
@ -96,24 +74,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:42
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:44
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-appservice-discord.md:46
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:48
|
||||
@ -121,17 +90,11 @@ msgid "Self-Service Bridging (Manual)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:50
|
||||
msgid ""
|
||||
"Self-service bridging allows you to bridge specific and existing Matrix "
|
||||
"rooms to specific Discord rooms. To enable it, add the following "
|
||||
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"file:"
|
||||
msgid "Self-service bridging allows you to bridge specific and existing Matrix rooms to specific Discord rooms. To enable it, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:56
|
||||
msgid ""
|
||||
"**Note**: If self-service bridging is not enabled, `!discord help` "
|
||||
"commands will return no results."
|
||||
msgid "**Note**: If self-service bridging is not enabled, `!discord help` commands will return no results."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:58
|
||||
@ -140,9 +103,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:60
|
||||
msgid ""
|
||||
"Once self-service is enabled, start a chat with "
|
||||
"`@_discord_bot:example.com` and say `!discord help bridge`."
|
||||
msgid "Once self-service is enabled, start a chat with `@_discord_bot:example.com` and say `!discord help bridge`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:62
|
||||
@ -150,16 +111,11 @@ msgid "Then, follow the instructions in the help output message."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:64
|
||||
msgid ""
|
||||
"If the bot is not already in the Discord server, follow the provided "
|
||||
"invite link. This may require you to be a administrator of the Discord "
|
||||
"server."
|
||||
msgid "If the bot is not already in the Discord server, follow the provided invite link. This may require you to be a administrator of the Discord server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:66
|
||||
msgid ""
|
||||
"On the Discord side, you can say `!matrix help` to get a list of "
|
||||
"available commands to manage the bridge and Matrix users."
|
||||
msgid "On the Discord side, you can say `!matrix help` to get a list of available commands to manage the bridge and Matrix users."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:68
|
||||
@ -171,26 +127,15 @@ msgid "Portal Bridging (Automatic)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:72
|
||||
msgid ""
|
||||
"Through portal bridging, Matrix rooms will automatically be created by "
|
||||
"the bot and bridged to the relevant Discord room. This is done by simply "
|
||||
"joining a room with a specific name pattern "
|
||||
"(`#_discord_<guildID>_<channelID>`)."
|
||||
msgid "Through portal bridging, Matrix rooms will automatically be created by the bot and bridged to the relevant Discord room. This is done by simply joining a room with a specific name pattern (`#_discord_<guildID>_<channelID>`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:74
|
||||
msgid ""
|
||||
"All Matrix rooms created this way are **listed publicly** by default, and"
|
||||
" you will not have admin permissions to change this. To get more control,"
|
||||
" [make yourself a room Administrator](#getting-administrator-access-in-a"
|
||||
"-portal-bridged-room). You can then unlist the room from the directory "
|
||||
"and change the join rules."
|
||||
msgid "All Matrix rooms created this way are **listed publicly** by default, and you will not have admin permissions to change this. To get more control, [make yourself a room Administrator](#getting-administrator-access-in-a-portal-bridged-room). You can then unlist the room from the directory and change the join rules."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:76
|
||||
msgid ""
|
||||
"To disable portal bridging, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To disable portal bridging, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:84
|
||||
@ -198,26 +143,15 @@ msgid "To get started with Portal Bridging:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:86
|
||||
msgid ""
|
||||
"To invite the bot to Discord, retrieve the invite link from the `{{ "
|
||||
"matrix_appservice_discord_config_path }}/invite_link` file on the server "
|
||||
"(this defaults to `/matrix/appservice-discord/config/invite_link`). You "
|
||||
"need to peek at the file on the server via SSH, etc., because it's not "
|
||||
"available via HTTP(S)."
|
||||
msgid "To invite the bot to Discord, retrieve the invite link from the `{{ matrix_appservice_discord_config_path }}/invite_link` file on the server (this defaults to `/matrix/appservice-discord/config/invite_link`). You need to peek at the file on the server via SSH, etc., because it's not available via HTTP(S)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:87
|
||||
msgid ""
|
||||
"Room addresses follow this syntax: `#_discord_<guildID>_<channelID>`. You"
|
||||
" can easily find the guild and channel IDs by logging into Discord in a "
|
||||
"browser and opening the desired channel. The URL will have this format: "
|
||||
"`discord.com/channels/<guildID>/<channelID>`."
|
||||
msgid "Room addresses follow this syntax: `#_discord_<guildID>_<channelID>`. You can easily find the guild and channel IDs by logging into Discord in a browser and opening the desired channel. The URL will have this format: `discord.com/channels/<guildID>/<channelID>`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:88
|
||||
msgid ""
|
||||
"Once you have figured out the appropriate room address, you can join by "
|
||||
"doing `/join #_discord_<guildID>_<channelID>` in your Matrix client."
|
||||
msgid "Once you have figured out the appropriate room address, you can join by doing `/join #_discord_<guildID>_<channelID>` in your Matrix client."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:90
|
||||
@ -225,23 +159,13 @@ msgid "Getting Administrator access in a portal bridged room"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:92
|
||||
msgid ""
|
||||
"By default, you won't have Administrator access in rooms created by the "
|
||||
"bridge."
|
||||
msgid "By default, you won't have Administrator access in rooms created by the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:94
|
||||
msgid ""
|
||||
"To adjust room access privileges or do various other things (change the "
|
||||
"room name subsequently, etc.), you'd wish to become an Administrator."
|
||||
msgid "To adjust room access privileges or do various other things (change the room name subsequently, etc.), you'd wish to become an Administrator."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:96
|
||||
msgid ""
|
||||
"There's the Discord bridge's guide for [setting privileges on bridge "
|
||||
"managed rooms](https://github.com/matrix-org/matrix-appservice-"
|
||||
"discord/blob/master/docs/howto.md#set-privileges-on-bridge-managed-"
|
||||
"rooms). To do the same with our container setup, run the following "
|
||||
"command on the server:"
|
||||
msgid "There's the Discord bridge's guide for [setting privileges on bridge managed rooms](https://github.com/matrix-org/matrix-appservice-discord/blob/master/docs/howto.md#set-privileges-on-bridge-managed-rooms). To do the same with our container setup, run the following command on the server:"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,24 +26,15 @@ msgid "Setting up Appservice IRC bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:3
|
||||
msgid ""
|
||||
"**Note**: bridging to "
|
||||
"[IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) can also happen "
|
||||
"via the [Heisenbridge](configuring-playbook-bridge-heisenbridge.md) "
|
||||
"bridge supported by the playbook."
|
||||
msgid "**Note**: bridging to [IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) can also happen via the [Heisenbridge](configuring-playbook-bridge-heisenbridge.md) bridge supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure the [matrix-appservice-"
|
||||
"irc](https://github.com/matrix-org/matrix-appservice-irc) bridge for you."
|
||||
msgid "The playbook can install and configure the [matrix-appservice-irc](https://github.com/matrix-org/matrix-appservice-irc) bridge for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:7
|
||||
msgid ""
|
||||
"See the project's [documentation](https://github.com/matrix-org/matrix-"
|
||||
"appservice-irc/blob/master/HOWTO.md) to learn what it does and why it "
|
||||
"might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/matrix-org/matrix-appservice-irc/blob/master/HOWTO.md) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:9
|
||||
@ -51,9 +42,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:11
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-appservice-irc.md:63
|
||||
@ -61,9 +50,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:65
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:72
|
||||
@ -71,24 +58,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:74
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:76
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-appservice-irc.md:78
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:80
|
||||
@ -96,8 +74,5 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:82
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `@irc_bot:example.com` "
|
||||
"(where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@irc_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,27 +26,15 @@ msgid "Setting up Appservice Kakaotalk bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-appservice-"
|
||||
"kakaotalk](https://src.miscworks.net/fair/matrix-appservice-kakaotalk) "
|
||||
"for you. `matrix-appservice-kakaotalk` is a bridge to "
|
||||
"[Kakaotalk](https://www.kakaocorp.com/page/service/service/KakaoTalk?lang=ENG)"
|
||||
" based on [node-kakao](https://github.com/storycraft/node-kakao) (now "
|
||||
"unmaintained) and some [mautrix-"
|
||||
"facebook](https://github.com/mautrix/facebook) code."
|
||||
msgid "The playbook can install and configure [matrix-appservice-kakaotalk](https://src.miscworks.net/fair/matrix-appservice-kakaotalk) for you. `matrix-appservice-kakaotalk` is a bridge to [Kakaotalk](https://www.kakaocorp.com/page/service/service/KakaoTalk?lang=ENG) based on [node-kakao](https://github.com/storycraft/node-kakao) (now unmaintained) and some [mautrix-facebook](https://github.com/mautrix/facebook) code."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:5
|
||||
msgid ""
|
||||
"⚠️ **Warning**: there have been recent reports (~2022-09-16) that **using"
|
||||
" this bridge may get your account banned**."
|
||||
msgid "⚠️ **Warning**: there have been recent reports (~2022-09-16) that **using this bridge may get your account banned**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:7
|
||||
msgid ""
|
||||
"See the project's [documentation](https://src.miscworks.net/fair/matrix-"
|
||||
"appservice-kakaotalk/src/branch/master/README.md) to learn what it does "
|
||||
"and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://src.miscworks.net/fair/matrix-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
|
||||
@ -54,18 +42,11 @@ msgid "Prerequisite (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:11
|
||||
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 [Shared Secret Auth](configuring-playbook-shared-secret-"
|
||||
"auth.md) for this playbook."
|
||||
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 [Shared Secret Auth](configuring-playbook-shared-secret-auth.md) for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:13
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-appservice-kakaotalk.md:15
|
||||
@ -73,16 +54,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:17
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-appservice-kakaotalk.md:23
|
||||
msgid ""
|
||||
"You may optionally wish to add some [Additional configuration"
|
||||
"](#additional-configuration), or to [prepare for double-puppeting](#set-"
|
||||
"up-double-puppeting) before the initial installation."
|
||||
msgid "You may optionally wish to add some [Additional configuration](#additional-configuration), or to [prepare for double-puppeting](#set-up-double-puppeting) before the initial installation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:25
|
||||
@ -90,9 +66,7 @@ msgid "Additional configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:27
|
||||
msgid ""
|
||||
"There are some additional things you may wish to configure about the "
|
||||
"bridge."
|
||||
msgid "There are some additional things you may wish to configure about the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:29
|
||||
@ -100,18 +74,11 @@ msgid "Take a look at:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:31
|
||||
msgid ""
|
||||
"`roles/custom/matrix-bridge-appservice-kakaotalk/defaults/main.yml` for "
|
||||
"some variables that you can customize via your `vars.yml` file"
|
||||
msgid "`roles/custom/matrix-bridge-appservice-kakaotalk/defaults/main.yml` for some variables that you can customize via your `vars.yml` file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:32
|
||||
msgid ""
|
||||
"`roles/custom/matrix-bridge-appservice-"
|
||||
"kakaotalk/templates/config.yaml.j2` for the bridge's default "
|
||||
"configuration. You can override settings (even those that don't have "
|
||||
"dedicated playbook variables) using the "
|
||||
"`matrix_appservice_kakaotalk_configuration_extension_yaml` variable"
|
||||
msgid "`roles/custom/matrix-bridge-appservice-kakaotalk/templates/config.yaml.j2` for the bridge's default configuration. You can override settings (even those that don't have dedicated playbook variables) using the `matrix_appservice_kakaotalk_configuration_extension_yaml` variable"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:34
|
||||
@ -119,9 +86,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:36
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:43
|
||||
@ -129,24 +94,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:45
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:47
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-appservice-kakaotalk.md:49
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:51
|
||||
@ -154,17 +110,11 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:53
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@kakaotalkbot:example.com` (where `example.com` is your base domain, not"
|
||||
" the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@kakaotalkbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:55
|
||||
msgid ""
|
||||
"Send `login --save EMAIL_OR_PHONE_NUMBER` to the bridge bot to enable "
|
||||
"bridging for your Kakaotalk account. The `--save` flag may be omitted, if"
|
||||
" you'd rather not save your password."
|
||||
msgid "Send `login --save EMAIL_OR_PHONE_NUMBER` to the bridge bot to enable bridging for your Kakaotalk account. The `--save` flag may be omitted, if you'd rather not save your password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:57
|
||||
@ -172,10 +122,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:59
|
||||
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)."
|
||||
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-appservice-kakaotalk.md:61
|
||||
@ -187,17 +134,11 @@ msgid "Method 1: automatically, by enabling Shared Secret Auth"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:65
|
||||
msgid ""
|
||||
"The bridge automatically performs Double Puppeting if [Shared Secret Auth"
|
||||
"](configuring-playbook-shared-secret-auth.md) service is configured and "
|
||||
"enabled on the server for this playbook."
|
||||
msgid "The bridge automatically performs Double Puppeting if [Shared Secret Auth](configuring-playbook-shared-secret-auth.md) service is configured and enabled on the server for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:67
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-appservice-kakaotalk.md:69
|
||||
@ -205,34 +146,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:71
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:73
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-appservice-kakaotalk.md:75
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:77
|
||||
msgid ""
|
||||
"make sure you don't log out the `Appservice-Kakaotalk` device some time "
|
||||
"in the future, as that would break the Double Puppeting feature"
|
||||
msgid "make sure you don't log out the `Appservice-Kakaotalk` device some time 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 ""
|
||||
|
||||
|
||||
@ -31,37 +31,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:4
|
||||
msgid ""
|
||||
"Bridging to [Slack](https://slack.com) can also happen via the [mx-"
|
||||
"puppet-slack](configuring-playbook-bridge-mx-puppet-slack.md) and "
|
||||
"[mautrix-slack](configuring-playbook-bridge-mautrix-slack.md) bridges "
|
||||
"supported by the playbook."
|
||||
msgid "Bridging to [Slack](https://slack.com) can also happen via the [mx-puppet-slack](configuring-playbook-bridge-mx-puppet-slack.md) and [mautrix-slack](configuring-playbook-bridge-mautrix-slack.md) bridges supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:5
|
||||
msgid ""
|
||||
"Currently (as of November, 2024) **this component is not available for "
|
||||
"new installation unless you have already created a classic Slack "
|
||||
"application** (which the bridge makes use of in order to enable bridging "
|
||||
"between Slack and Matrix), because the creation of classic Slack "
|
||||
"applications has been discontinued since June 4 2024. The author of the "
|
||||
"bridge claims [here](https://github.com/matrix-org/matrix-appservice-"
|
||||
"slack/issues/789#issuecomment-2172947787) that he plans to support the "
|
||||
"modern Slack application and until then \"the best (and only) option for "
|
||||
"new installations is to use the webhook bridging\"."
|
||||
msgid "Currently (as of November, 2024) **this component is not available for new installation unless you have already created a classic Slack application** (which the bridge makes use of in order to enable bridging between Slack and Matrix), because the creation of classic Slack applications has been discontinued since June 4 2024. The author of the bridge claims [here](https://github.com/matrix-org/matrix-appservice-slack/issues/789#issuecomment-2172947787) that he plans to support the modern Slack application and until then \"the best (and only) option for new installations is to use the webhook bridging\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:7
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-appservice-"
|
||||
"slack](https://github.com/matrix-org/matrix-appservice-slack) for you."
|
||||
msgid "The playbook can install and configure [matrix-appservice-slack](https://github.com/matrix-org/matrix-appservice-slack) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:9
|
||||
msgid ""
|
||||
"See the project's [documentation](https://github.com/matrix-org/matrix-"
|
||||
"appservice-slack/blob/master/README.md) to learn what it does and why it "
|
||||
"might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/matrix-org/matrix-appservice-slack/blob/master/README.md) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:11
|
||||
@ -73,22 +55,15 @@ msgid "Create a Classic Slack App"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:15
|
||||
msgid ""
|
||||
"First, you need to create a Classic Slack App "
|
||||
"[here](https://api.slack.com/apps?new_classic_app=1)."
|
||||
msgid "First, you need to create a Classic Slack App [here](https://api.slack.com/apps?new_classic_app=1)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:17
|
||||
msgid ""
|
||||
"Name the app \"matrixbot\" (or anything else you'll remember). Select the"
|
||||
" team/workspace this app will belong to. Click on bot users and add a new"
|
||||
" bot user. We will use this account to bridge the the rooms."
|
||||
msgid "Name the app \"matrixbot\" (or anything else you'll remember). Select the team/workspace this app will belong to. Click on bot users and add a new bot user. We will use this account to bridge the the rooms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:19
|
||||
msgid ""
|
||||
"Then, click on Event Subscriptions and enable them and use the request "
|
||||
"url: `https://matrix.example.com/appservice-slack`."
|
||||
msgid "Then, click on Event Subscriptions and enable them and use the request url: `https://matrix.example.com/appservice-slack`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:21
|
||||
@ -136,20 +111,11 @@ msgid "files:write:user (if you want to bridge files)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:36
|
||||
msgid ""
|
||||
"**Note**: In order to make Slack files visible to Matrix users, this "
|
||||
"bridge will make Slack files visible to anyone with the url (including "
|
||||
"files in private channels). This is different than the current behavior "
|
||||
"in Slack, which only allows authenticated access to media posted in "
|
||||
"private channels. See MSC701 for details."
|
||||
msgid "**Note**: In order to make Slack files visible to Matrix users, this bridge will make Slack files visible to anyone with the url (including files in private channels). This is different than the current behavior in Slack, which only allows authenticated access to media posted in private channels. See MSC701 for details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:38
|
||||
msgid ""
|
||||
"Click on \"Install App\" and \"Install App to Workspace\". Note the "
|
||||
"access tokens shown. You will need the Bot User OAuth Access Token and if"
|
||||
" you want to bridge files, the OAuth Access Token whenever you link a "
|
||||
"room."
|
||||
msgid "Click on \"Install App\" and \"Install App to Workspace\". Note the access tokens shown. You will need the Bot User OAuth Access Token and if you want to bridge files, the OAuth Access Token whenever you link a room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:40
|
||||
@ -161,10 +127,7 @@ msgid "Create a new Matrix room to act as the administration control room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:44
|
||||
msgid ""
|
||||
"Note its internal room ID. This can be done in Element Web by sending a "
|
||||
"message, opening the options for that message and choosing \"view "
|
||||
"source\". The room ID will be displayed near the top."
|
||||
msgid "Note its internal room ID. This can be done in Element Web by sending a message, opening the options for that message and choosing \"view source\". The room ID will be displayed near the top."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:46
|
||||
@ -172,15 +135,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:48
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-appservice-slack.md:64
|
||||
msgid ""
|
||||
"Other configuration options are available via the "
|
||||
"`matrix_appservice_slack_configuration_extension_yaml` variable."
|
||||
msgid "Other configuration options are available via the `matrix_appservice_slack_configuration_extension_yaml` variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:66
|
||||
@ -188,30 +147,19 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:68
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:77
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:79
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-appservice-slack.md:81
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:83
|
||||
@ -219,42 +167,27 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:85
|
||||
msgid ""
|
||||
"To use the bridge, you need to send `/invite @slackbot:example.com` to "
|
||||
"invite the bridge bot user into the admin room."
|
||||
msgid "To use the bridge, you need to send `/invite @slackbot:example.com` to invite the bridge bot user into the admin room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:87
|
||||
msgid ""
|
||||
"If Team Sync is not enabled, for each channel you would like to bridge, "
|
||||
"perform the following steps:"
|
||||
msgid "If Team Sync is not enabled, for each channel you would like to bridge, perform the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:89
|
||||
msgid ""
|
||||
"Create a Matrix room in the usual manner for your client. Take a note of "
|
||||
"its Matrix room ID - it will look something like `!qporfwt:example.com`."
|
||||
msgid "Create a Matrix room in the usual manner for your client. Take a note of its Matrix room ID - it will look something like `!qporfwt:example.com`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:90
|
||||
msgid ""
|
||||
"Invite the bot user to both the Slack and Matrix channels you would like "
|
||||
"to bridge using `/invite @matrixbot` for Slack and `/invite "
|
||||
"@slackbot:example.com` for Matrix."
|
||||
msgid "Invite the bot user to both the Slack and Matrix channels you would like to bridge using `/invite @matrixbot` for Slack and `/invite @slackbot:example.com` for Matrix."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:91
|
||||
msgid ""
|
||||
"Determine the \"channel ID\" that Slack uses to identify the channel. You"
|
||||
" can see it when you open a given Slack channel in a browser. The URL "
|
||||
"reads like this: `https://app.slack.com/client/XXX/<the channel "
|
||||
"ID>/details/`."
|
||||
msgid "Determine the \"channel ID\" that Slack uses to identify the channel. You can see it when you open a given Slack channel in a browser. The URL reads like this: `https://app.slack.com/client/XXX/<the channel ID>/details/`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:92
|
||||
msgid ""
|
||||
"Issue a link command in the administration control room with these "
|
||||
"collected values as arguments:"
|
||||
msgid "Issue a link command in the administration control room with these collected values as arguments:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:94
|
||||
@ -278,10 +211,7 @@ msgid "Channels can be unlinked again by sending this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:120
|
||||
msgid ""
|
||||
"Unlinking doesn't only disconnect the bridge, but also makes the slackbot"
|
||||
" leave the bridged Matrix room. So in case you want to re-link later, "
|
||||
"don't forget to re-invite the slackbot into this room again."
|
||||
msgid "Unlinking doesn't only disconnect the bridge, but also makes the slackbot leave the bridged Matrix room. So in case you want to re-link later, don't forget to re-invite the slackbot into this room again."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:122
|
||||
@ -297,9 +227,7 @@ msgid "Linking: \"Room is now pending-name\""
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:128
|
||||
msgid ""
|
||||
"This typically means that you haven't used the correct Slack channel ID. "
|
||||
"Unlink the room and recheck 'Determine the \"channel ID\"' from above."
|
||||
msgid "This typically means that you haven't used the correct Slack channel ID. Unlink the room and recheck 'Determine the \"channel ID\"' from above."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:130
|
||||
@ -312,15 +240,9 @@ msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:134
|
||||
#, python-format
|
||||
msgid ""
|
||||
"`WARN SlackEventHandler Ignoring message from unrecognised Slack channel "
|
||||
"ID : %s (%s) <the channel ID> <some other ID>`"
|
||||
msgid "`WARN SlackEventHandler Ignoring message from unrecognised Slack channel ID : %s (%s) <the channel ID> <some other ID>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:136
|
||||
msgid ""
|
||||
"then unlink your room, reinvite the bot and re-link it again. This may "
|
||||
"particularly hit you, if you tried to unsuccessfully link your room "
|
||||
"multiple times without unlinking it after each failed attempt."
|
||||
msgid "then unlink your room, reinvite the bot and re-link it again. This may particularly hit you, if you tried to unsuccessfully link your room multiple times without unlinking it after each failed attempt."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,27 +26,15 @@ msgid "Setting up Appservice Webhooks bridging (optional, deprecated)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:3
|
||||
msgid ""
|
||||
"**Note**: This bridge has been deprecated. We recommend not bothering "
|
||||
"with installing it. While not a 1:1 replacement, the bridge's author "
|
||||
"suggests taking a look at [matrix-hookshot](https://github.com/matrix-org"
|
||||
"/matrix-hookshot) as a replacement, which can also be installed using "
|
||||
"[this playbook](configuring-playbook-bridge-hookshot.md). Consider using "
|
||||
"that bridge instead of this one."
|
||||
msgid "**Note**: This bridge has been deprecated. We recommend not bothering with installing it. While not a 1:1 replacement, the bridge's author suggests taking a look at [matrix-hookshot](https://github.com/matrix-org/matrix-hookshot) as a replacement, which can also be installed using [this playbook](configuring-playbook-bridge-hookshot.md). Consider using that bridge instead of this one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-appservice-"
|
||||
"webhooks](https://github.com/turt2live/matrix-appservice-webhooks) for "
|
||||
"you. This bridge provides support for Slack-compatible webhooks."
|
||||
msgid "The playbook can install and configure [matrix-appservice-webhooks](https://github.com/turt2live/matrix-appservice-webhooks) for you. This bridge provides support for Slack-compatible webhooks."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:7
|
||||
msgid ""
|
||||
"See the project's [documentation](https://github.com/turt2live/matrix-"
|
||||
"appservice-webhooks/blob/master/README.md) to learn what it does and why "
|
||||
"it might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/turt2live/matrix-appservice-webhooks/blob/master/README.md) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:9
|
||||
@ -54,9 +42,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:11
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-appservice-webhooks.md:27
|
||||
@ -64,9 +50,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:29
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:36
|
||||
@ -74,24 +58,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:38
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:40
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-appservice-webhooks.md:42
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:44
|
||||
@ -99,27 +74,19 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:46
|
||||
msgid ""
|
||||
"To use the bridge, you need to invite the bridge bot user to your room in"
|
||||
" either way."
|
||||
msgid "To use the bridge, you need to invite the bridge bot user to your room in either way."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:48
|
||||
msgid ""
|
||||
"Send `/invite @_webhook:example.com` (**Note**: Make sure you have "
|
||||
"administration permissions in your room)"
|
||||
msgid "Send `/invite @_webhook:example.com` (**Note**: Make sure you have administration permissions in your room)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:49
|
||||
msgid ""
|
||||
"Add the bridge bot to a private channel (personal channels imply you "
|
||||
"being an administrator)"
|
||||
msgid "Add the bridge bot to a private channel (personal channels imply you being an administrator)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:51
|
||||
msgid ""
|
||||
"You then need to send a message to the bridge bot in order to receive a "
|
||||
"private message including the webhook link:"
|
||||
msgid "You then need to send a message to the bridge bot in order to receive a private message including the webhook link:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:57
|
||||
@ -135,23 +102,13 @@ msgid "Setting Webhooks with Dimension integration manager"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:83
|
||||
msgid ""
|
||||
"If you're using the [Dimension integration manager](configuring-playbook-"
|
||||
"dimension.md), you can configure the Webhooks bridge with it."
|
||||
msgid "If you're using the [Dimension integration manager](configuring-playbook-dimension.md), you can configure the Webhooks bridge with it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:85
|
||||
msgid ""
|
||||
"To configure it, open the Dimension integration manager, and go to "
|
||||
"\"Settings\" and \"Bridges\", then select edit action for \"Webhook "
|
||||
"Bridge\"."
|
||||
msgid "To configure it, open the Dimension integration manager, and go to \"Settings\" and \"Bridges\", then select edit action for \"Webhook Bridge\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:87
|
||||
msgid ""
|
||||
"On the UI, press \"Add self-hosted Bridge\" button and populate "
|
||||
"\"Provisioning URL\" and \"Shared Secret\" values from `/matrix"
|
||||
"/appservice-webhooks/config/config.yaml` file's homeserver URL value and "
|
||||
"provisioning secret value, respectively."
|
||||
msgid "On the UI, press \"Add self-hosted Bridge\" button and populate \"Provisioning URL\" and \"Shared Secret\" values from `/matrix/appservice-webhooks/config/config.yaml` file's homeserver URL value and provisioning secret value, respectively."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,19 +26,11 @@ msgid "Setting up Beeper Linkedin bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [beeper-"
|
||||
"linkedin](https://github.com/beeper/linkedin) for you, for bridging to "
|
||||
"[LinkedIn](https://www.linkedin.com/) Messaging. This bridge is based on "
|
||||
"the mautrix-python framework and can be configured in a similar way to "
|
||||
"the other mautrix bridges"
|
||||
msgid "The playbook can install and configure [beeper-linkedin](https://github.com/beeper/linkedin) for you, for bridging to [LinkedIn](https://www.linkedin.com/) Messaging. This bridge is based on the mautrix-python framework and can be configured in a similar way to the other mautrix bridges"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:5
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://github.com/beeper/linkedin/blob/master/README.md)"
|
||||
" to learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/beeper/linkedin/blob/master/README.md) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:7
|
||||
@ -46,34 +38,23 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:9
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-beeper-linkedin.md:15
|
||||
msgid ""
|
||||
"There are some additional things you may wish to configure about the "
|
||||
"bridge before you continue."
|
||||
msgid "There are some additional things you may wish to configure about the bridge before you continue."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:17
|
||||
msgid ""
|
||||
"Encryption support is off by default. If you would like to enable "
|
||||
"encryption, add the following to your `vars.yml` file:"
|
||||
msgid "Encryption support is off by default. If you would like to enable encryption, add the following to your `vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:24
|
||||
msgid ""
|
||||
"If you would like to be able to administrate the bridge from your account"
|
||||
" it can be configured like this:"
|
||||
msgid "If you would like to be able to administrate the bridge from your account it can be configured like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:33
|
||||
msgid ""
|
||||
"You may wish to look at `roles/custom/matrix-bridge-beeper-"
|
||||
"linkedin/templates/config.yaml.j2` to find other things you would like to"
|
||||
" configure."
|
||||
msgid "You may wish to look at `roles/custom/matrix-bridge-beeper-linkedin/templates/config.yaml.j2` to find other things you would like to configure."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:35
|
||||
@ -81,9 +62,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:37
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:44
|
||||
@ -91,53 +70,31 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:46
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:48
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-beeper-linkedin.md:50
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:52
|
||||
msgid ""
|
||||
"Set up Double Puppeting by enabling Appservice Double Puppet or Shared "
|
||||
"Secret Auth"
|
||||
msgid "Set up Double Puppeting by enabling Appservice Double Puppet or Shared Secret Auth"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:54
|
||||
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 "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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:56
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:58
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:60
|
||||
@ -145,29 +102,19 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:62
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@linkedinbot:example.com` (where `example.com` is your base domain, not "
|
||||
"the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@linkedinbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:64
|
||||
msgid ""
|
||||
"Send `login YOUR_LINKEDIN_EMAIL_ADDRESS` to the bridge bot to enable "
|
||||
"bridging for your LinkedIn account."
|
||||
msgid "Send `login YOUR_LINKEDIN_EMAIL_ADDRESS` to the bridge bot to enable bridging for your LinkedIn account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:66
|
||||
msgid ""
|
||||
"If you run into trouble, check the [Troubleshooting](#troubleshooting) "
|
||||
"section below."
|
||||
msgid "If you run into trouble, check the [Troubleshooting](#troubleshooting) section below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:68
|
||||
msgid ""
|
||||
"After successfully enabling bridging, you may wish to [set up Double "
|
||||
"Puppeting](#set-up-double-puppeting-by-enabling-appservice-double-puppet-"
|
||||
"or-shared-secret-auth), if you haven't already done so."
|
||||
msgid "After successfully enabling bridging, you may wish to [set up Double Puppeting](#set-up-double-puppeting-by-enabling-appservice-double-puppet-or-shared-secret-auth), if you haven't already done so."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:70
|
||||
@ -179,10 +126,5 @@ msgid "Bridge asking for 2FA even if you don't have 2FA enabled"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:74
|
||||
msgid ""
|
||||
"If you don't have 2FA enabled and are logging in from a strange IP for "
|
||||
"the first time, LinkedIn will send an email with a one-time code. You can"
|
||||
" use this code to authorize the bridge session. In my experience, once "
|
||||
"the IP is authorized, you will not be asked again."
|
||||
msgid "If you don't have 2FA enabled and are logging in from a strange IP for the first time, LinkedIn will send an email with a one-time code. You can use this code to authorize the bridge session. In my experience, once the IP is authorized, you will not be asked again."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,16 +26,11 @@ msgid "Setting up Go Skype Bridge bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [go-skype-"
|
||||
"bridge](https://github.com/kelaresg/go-skype-bridge) for you."
|
||||
msgid "The playbook can install and configure [go-skype-bridge](https://github.com/kelaresg/go-skype-bridge) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -43,10 +38,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:9
|
||||
msgid ""
|
||||
"To enable the [Skype](https://www.skype.com/) bridge, add the following "
|
||||
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"file:"
|
||||
msgid "To enable the [Skype](https://www.skype.com/) bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:15
|
||||
@ -54,9 +46,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:17
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:24
|
||||
@ -64,24 +54,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:26
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:28
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-go-skype-bridge.md:30
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:32
|
||||
@ -89,19 +70,9 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:34
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `Skype bridge bot` with "
|
||||
"the handle `@skypebridgebot:example.com` (where `example.com` is your "
|
||||
"base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `Skype bridge bot` with the handle `@skypebridgebot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:36
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,27 +26,15 @@ msgid "Setting up Heisenbridge bouncer-style IRC bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:3
|
||||
msgid ""
|
||||
"**Note**: bridging to "
|
||||
"[IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) can also happen "
|
||||
"via the [matrix-appservice-irc](configuring-playbook-bridge-appservice-"
|
||||
"irc.md) bridge supported by the playbook."
|
||||
msgid "**Note**: bridging to [IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) can also happen via the [matrix-appservice-irc](configuring-playbook-bridge-appservice-irc.md) bridge supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure "
|
||||
"[Heisenbridge](https://github.com/hifi/heisenbridge) - the bouncer-style "
|
||||
"[IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) bridge for you."
|
||||
msgid "The playbook can install and configure [Heisenbridge](https://github.com/hifi/heisenbridge) - the bouncer-style [IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) bridge for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:7
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[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)."
|
||||
msgid "See the project's [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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:9
|
||||
@ -54,16 +42,11 @@ msgid "Configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:11
|
||||
msgid ""
|
||||
"To enable Heisenbridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Heisenbridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:24
|
||||
msgid ""
|
||||
"For a more complete list of variables that you could override, see the "
|
||||
"[`defaults/main.yml` file](../roles/custom/matrix-bridge-"
|
||||
"heisenbridge/defaults/main.yml) of the Heisenbridge Ansible role."
|
||||
msgid "For a more complete list of variables that you could override, see the [`defaults/main.yml` file](../roles/custom/matrix-bridge-heisenbridge/defaults/main.yml) of the Heisenbridge Ansible role."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:26
|
||||
@ -71,32 +54,19 @@ msgid "Adjusting the Heisenbridge URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:28
|
||||
msgid ""
|
||||
"By default, this playbook installs Heisenbridge on the `matrix.` "
|
||||
"subdomain, at the `/heisenbridge` path "
|
||||
"(https://matrix.example.com/heisenbridge). It would handle media requests"
|
||||
" there (see the [release notes for Heisenbridge "
|
||||
"v1.15.0](https://github.com/hifi/heisenbridge/releases/tag/v1.15.0))."
|
||||
msgid "By default, this playbook installs Heisenbridge on the `matrix.` subdomain, at the `/heisenbridge` path (https://matrix.example.com/heisenbridge). It would handle media requests there (see the [release notes for Heisenbridge v1.15.0](https://github.com/hifi/heisenbridge/releases/tag/v1.15.0))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:30
|
||||
msgid ""
|
||||
"This makes it easy to install it, because it **doesn't require additional"
|
||||
" DNS records to be set up**. If that's okay, you can skip this section."
|
||||
msgid "This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:32
|
||||
msgid ""
|
||||
"By tweaking the `matrix_heisenbridge_hostname` and "
|
||||
"`matrix_heisenbridge_path_prefix` variables, you can easily make the "
|
||||
"service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_heisenbridge_hostname` and `matrix_heisenbridge_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-bridge-heisenbridge.md:34
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:42
|
||||
@ -104,9 +74,7 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:44
|
||||
msgid ""
|
||||
"If you've changed the default hostname, **you may need to adjust your "
|
||||
"DNS** records to point the Heisenbridge domain to the Matrix server."
|
||||
msgid "If you've changed the default hostname, **you may need to adjust your DNS** records to point the Heisenbridge domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:46
|
||||
@ -114,9 +82,7 @@ msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:48
|
||||
msgid ""
|
||||
"If you've decided to use the default hostname, you won't need to do any "
|
||||
"extra DNS configuration."
|
||||
msgid "If you've decided to use the default hostname, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:50
|
||||
@ -124,10 +90,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:52
|
||||
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:"
|
||||
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-bridge-heisenbridge.md:59
|
||||
@ -135,24 +98,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:61
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:63
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-heisenbridge.md:65
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:67
|
||||
@ -160,11 +114,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:69
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@heisenbridge:example.com` (where `example.com` is your base domain, not"
|
||||
" the `matrix.` domain). If the bridge ignores you and a DM is not "
|
||||
"accepted then the owner setting may be wrong."
|
||||
msgid "To use the bridge, you need to start a chat with `@heisenbridge:example.com` (where `example.com` is your base domain, not the `matrix.` domain). If the bridge ignores you and a DM is not accepted then the owner setting may be wrong."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:71
|
||||
@ -172,24 +122,9 @@ msgid "Help is available for all commands with the `-h` switch."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:73
|
||||
msgid ""
|
||||
"You can also learn the basics by watching [this demonstration "
|
||||
"video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)."
|
||||
msgid "You can also learn the basics by watching [this demonstration video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:75
|
||||
msgid ""
|
||||
"If you encounter issues or feel lost you can join the project room at "
|
||||
"[#heisenbridge:vi.fi](https://matrix.to/#/#heisenbridge:vi.fi) for help."
|
||||
msgid "If you encounter issues or feel lost you can join the project room at [#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 ""
|
||||
|
||||
|
||||
@ -26,30 +26,19 @@ msgid "Setting up matrix-hookshot (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-"
|
||||
"hookshot](https://github.com/matrix-org/matrix-hookshot) for you."
|
||||
msgid "The playbook can install and configure [matrix-hookshot](https://github.com/matrix-org/matrix-hookshot) for you."
|
||||
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, "
|
||||
"and Figma, as well as generic webhooks."
|
||||
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 ""
|
||||
|
||||
#: ../../../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 and why it might be "
|
||||
"useful to you."
|
||||
msgid "See the project's [documentation](https://matrix-org.github.io/matrix-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
|
||||
msgid ""
|
||||
"**Note**: the playbook also supports [matrix-appservice-webhooks"
|
||||
"](configuring-playbook-bridge-appservice-webhooks.md), which however was "
|
||||
"deprecated by its author."
|
||||
msgid "**Note**: the playbook also supports [matrix-appservice-webhooks](configuring-playbook-bridge-appservice-webhooks.md), which however was deprecated by its author."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md:11
|
||||
@ -61,16 +50,11 @@ msgid "Download GitHub app private key (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md:15
|
||||
msgid ""
|
||||
"If you're setting up the GitHub bridge, you need to create your GitHub "
|
||||
"app, and generate a private key file of it."
|
||||
msgid "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 ""
|
||||
"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)."
|
||||
msgid "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
|
||||
@ -78,27 +62,15 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md:21
|
||||
msgid ""
|
||||
"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)."
|
||||
msgid "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."
|
||||
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)."
|
||||
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
|
||||
@ -106,18 +78,11 @@ 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."
|
||||
msgid "You can configure additional options by adding the `matrix_hookshot_configuration_extension_yaml` and `matrix_hookshot_registration_extension_yaml` variables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md:43
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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:45
|
||||
@ -125,24 +90,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md:47
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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`"
|
||||
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."
|
||||
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
|
||||
@ -150,35 +106,23 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:62
|
||||
msgid ""
|
||||
"Make sure the bot is able to send state events (usually the Moderator "
|
||||
"power level in clients)."
|
||||
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:64
|
||||
msgid ""
|
||||
"Send `!hookshot help` to the room to see the bridge's help menu for "
|
||||
"additional commands."
|
||||
msgid "Send `!hookshot help` to the room to see the bridge's help menu for additional commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:68
|
||||
msgid ""
|
||||
"💡 **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."
|
||||
msgid "💡 **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:70
|
||||
@ -186,9 +130,7 @@ 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:"
|
||||
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
|
||||
@ -200,9 +142,7 @@ msgid "URLs for bridges setup"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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)."
|
||||
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
|
||||
@ -358,11 +298,7 @@ msgid "`/metrics/hookshot`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
||||
msgid ""
|
||||
"`matrix_hookshot_metrics_enabled` and exposure enabled via "
|
||||
"`matrix_hookshot_metrics_proxying_enabled` or "
|
||||
"`matrix_metrics_exposure_enabled`. Read more in the [Metrics "
|
||||
"section](#metrics) below."
|
||||
msgid "`matrix_hookshot_metrics_enabled` and exposure enabled via `matrix_hookshot_metrics_proxying_enabled` or `matrix_metrics_exposure_enabled`. Read more in the [Metrics section](#metrics) below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
||||
@ -370,19 +306,11 @@ msgid "Prometheus"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
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 ""
|
||||
|
||||
#: ../../../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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md:100
|
||||
@ -390,44 +318,27 @@ msgid "Manage GitHub Private Key with aux role"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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:"
|
||||
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: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))."
|
||||
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 ""
|
||||
|
||||
#: ../../../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."
|
||||
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: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."
|
||||
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:108
|
||||
msgid ""
|
||||
"To use the `aux` role, make sure the `matrix_hookshot_github_private_key`"
|
||||
" variable is empty. Then add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To use the `aux` role, make sure the `matrix_hookshot_github_private_key` 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: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)."
|
||||
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:121
|
||||
@ -435,13 +346,7 @@ msgid "Provisioning API"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"`matrix_hookshot_provisioning_secret`, unless you override it either way."
|
||||
" To use hookshot with dimension, you will need to enter as \"Provisioning"
|
||||
" URL\": `http://matrix-hookshot:9002`, which is made up of the variables "
|
||||
"`matrix_hookshot_container_url` and `matrix_hookshot_provisioning_port`."
|
||||
msgid "The provisioning API will be enabled automatically if you set `matrix_dimension_enabled: true` and provided a `matrix_hookshot_provisioning_secret`, unless you override it either way. To use hookshot with dimension, you will need to enter as \"Provisioning URL\": `http://matrix-hookshot:9002`, which is made up of the variables `matrix_hookshot_container_url` and `matrix_hookshot_provisioning_port`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md:125
|
||||
@ -449,45 +354,27 @@ msgid "Metrics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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, "
|
||||
"Prometheus isn't enabled). If so, metrics will automatically be collected"
|
||||
" by Prometheus and made available in Grafana. You will, however, need to "
|
||||
"set up your own Dashboard for displaying them."
|
||||
msgid "Metrics are **only enabled by default** if the builtin [Prometheus](configuring-playbook-prometheus-grafana.md) is enabled (by default, Prometheus isn't enabled). If so, metrics will automatically be collected by Prometheus and made available in Grafana. You will, however, need to set up your own Dashboard for displaying them."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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: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:"
|
||||
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:133
|
||||
msgid ""
|
||||
"either enabling metrics exposure for Hookshot via "
|
||||
"`matrix_hookshot_metrics_proxying_enabled: true`"
|
||||
msgid "either enabling metrics exposure for Hookshot via `matrix_hookshot_metrics_proxying_enabled: true`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md:134
|
||||
msgid ""
|
||||
"or enabling metrics exposure for all services via "
|
||||
"`matrix_metrics_exposure_enabled: true`"
|
||||
msgid "or enabling metrics exposure for all services via `matrix_metrics_exposure_enabled: true`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
"](configuring-playbook-prometheus-grafana.md) for details about password-"
|
||||
"protection for metrics."
|
||||
msgid "Whichever one you go with, by default metrics are exposed publicly **without** password-protection. See [the Prometheus and Grafana docs](configuring-playbook-prometheus-grafana.md) for details about password-protection for metrics."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-hookshot.md:138
|
||||
@ -495,184 +382,5 @@ msgid "Collision with matrix-appservice-webhooks"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
" default setting `matrix_appservice_webhooks_user_prefix: '_webhook_'`. "
|
||||
"You should take care if you modify its or hookshot's prefix that they do "
|
||||
"not collide with each other's namespace (default "
|
||||
"`matrix_hookshot_generic_userIdPrefix: '_webhooks_'`)."
|
||||
msgid "If you are also running [matrix-appservice-webhooks](configuring-playbook-bridge-appservice-webhooks.md), it reserves its namespace by the default setting `matrix_appservice_webhooks_user_prefix: '_webhook_'`. You should take care if you modify its or hookshot's prefix that they do not collide with each other's namespace (default `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 ""
|
||||
|
||||
|
||||
@ -26,23 +26,15 @@ msgid "Setting up Matrix SMS bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-sms-"
|
||||
"bridge](https://github.com/benkuly/matrix-sms-bridge) for you."
|
||||
msgid "The playbook can install and configure [matrix-sms-bridge](https://github.com/benkuly/matrix-sms-bridge) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
msgid ""
|
||||
"**The bridge uses [android-sms-gateway-"
|
||||
"server](https://github.com/RebekkaMa/android-sms-gateway-server). You "
|
||||
"need to configure it first.**"
|
||||
msgid "**The bridge uses [android-sms-gateway-server](https://github.com/RebekkaMa/android-sms-gateway-server). You need to configure it first.**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:9
|
||||
@ -50,9 +42,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:11
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-matrix-bridge-sms.md:34
|
||||
@ -60,9 +50,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:36
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:43
|
||||
@ -70,24 +58,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:45
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:47
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-matrix-bridge-sms.md:49
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:51
|
||||
@ -95,14 +74,5 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:53
|
||||
msgid ""
|
||||
"Read the [user guide](https://github.com/benkuly/matrix-sms-"
|
||||
"bridge/blob/master/README.md#user-guide) to see how this bridge works."
|
||||
msgid "Read the [user guide](https://github.com/benkuly/matrix-sms-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 ""
|
||||
|
||||
|
||||
@ -26,38 +26,23 @@ msgid "Setting up Mautrix Discord bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:3
|
||||
msgid ""
|
||||
"**Note**: bridging to [Discord](https://discordapp.com/) can also happen "
|
||||
"via the [mx-puppet-discord](configuring-playbook-bridge-mx-puppet-"
|
||||
"discord.md) and [matrix-appservice-discord](configuring-playbook-bridge-"
|
||||
"appservice-discord.md) bridges supported by the playbook."
|
||||
msgid "**Note**: bridging to [Discord](https://discordapp.com/) can also happen via the [mx-puppet-discord](configuring-playbook-bridge-mx-puppet-discord.md) and [matrix-appservice-discord](configuring-playbook-bridge-appservice-discord.md) bridges supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:4
|
||||
msgid ""
|
||||
"For using as a Bot we recommend the [Appservice Discord](configuring-"
|
||||
"playbook-bridge-appservice-discord.md), because it supports plumbing."
|
||||
msgid "For using as a Bot we recommend the [Appservice Discord](configuring-playbook-bridge-appservice-discord.md), because it supports plumbing."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:5
|
||||
msgid ""
|
||||
"For personal use with a discord account we recommend the `mautrix-"
|
||||
"discord` bridge (the one being discussed here), because it is the most "
|
||||
"fully-featured and stable of the 3 Discord bridges supported by the "
|
||||
"playbook."
|
||||
msgid "For personal use with a discord account we recommend the `mautrix-discord` bridge (the one being discussed here), because it is the most fully-featured and stable of the 3 Discord bridges supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:7
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"discord](https://github.com/mautrix/discord) for you."
|
||||
msgid "The playbook can install and configure [mautrix-discord](https://github.com/mautrix/discord) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:9
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://docs.mau.fi/bridges/go/discord/index.html) to "
|
||||
"learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://docs.mau.fi/bridges/go/discord/index.html) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:11
|
||||
@ -65,21 +50,11 @@ msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:13
|
||||
msgid ""
|
||||
"There are 2 ways to login to discord using this bridge, either by "
|
||||
"[scanning a QR code](#method-1-login-using-qr-code-recommended) using the"
|
||||
" Discord mobile app **or** by using a [Discord token](#method-2-login-"
|
||||
"using-discord-token-not-recommended)."
|
||||
msgid "There are 2 ways to login to discord using this bridge, either by [scanning a QR code](#method-1-login-using-qr-code-recommended) using the Discord mobile app **or** by using a [Discord token](#method-2-login-using-discord-token-not-recommended)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:15
|
||||
msgid ""
|
||||
"If this is a dealbreaker for you, consider using one of the other Discord"
|
||||
" bridges supported by the playbook: [mx-puppet-discord](configuring-"
|
||||
"playbook-bridge-mx-puppet-discord.md) or [matrix-appservice-discord"
|
||||
"](configuring-playbook-bridge-appservice-discord.md). These come with "
|
||||
"their own complexity and limitations, however, so we recommend that you "
|
||||
"proceed with this one if possible."
|
||||
msgid "If this is a dealbreaker for you, consider using one of the other Discord bridges supported by the playbook: [mx-puppet-discord](configuring-playbook-bridge-mx-puppet-discord.md) or [matrix-appservice-discord](configuring-playbook-bridge-appservice-discord.md). These come with their own complexity and limitations, however, so we recommend that you proceed with this one if possible."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:17
|
||||
@ -87,19 +62,11 @@ msgid "Enable Appservice Double Puppet or Shared Secret Auth (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:19
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:21
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-discord.md:23
|
||||
@ -107,16 +74,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:25
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-discord.md:31
|
||||
msgid ""
|
||||
"You may optionally wish to add some [Additional configuration"
|
||||
"](#additional-configuration), or to [prepare for double-puppeting](#set-"
|
||||
"up-double-puppeting) before the initial installation."
|
||||
msgid "You may optionally wish to add some [Additional configuration](#additional-configuration), or to [prepare for double-puppeting](#set-up-double-puppeting) before the initial installation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:33
|
||||
@ -124,9 +86,7 @@ msgid "Additional configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:35
|
||||
msgid ""
|
||||
"There are some additional things you may wish to configure about the "
|
||||
"bridge."
|
||||
msgid "There are some additional things you may wish to configure about the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:37
|
||||
@ -134,17 +94,11 @@ msgid "Take a look at:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:39
|
||||
msgid ""
|
||||
"`roles/custom/matrix-bridge-mautrix-discord/defaults/main.yml` for some "
|
||||
"variables that you can customize via your `vars.yml` file"
|
||||
msgid "`roles/custom/matrix-bridge-mautrix-discord/defaults/main.yml` for some variables that you can customize via your `vars.yml` file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:40
|
||||
msgid ""
|
||||
"`roles/custom/matrix-bridge-mautrix-discord/templates/config.yaml.j2` for"
|
||||
" the bridge's default configuration. You can override settings (even "
|
||||
"those that don't have dedicated playbook variables) using the "
|
||||
"`matrix_mautrix_discord_configuration_extension_yaml` variable"
|
||||
msgid "`roles/custom/matrix-bridge-mautrix-discord/templates/config.yaml.j2` for the bridge's default configuration. You can override settings (even those that don't have dedicated playbook variables) using the `matrix_mautrix_discord_configuration_extension_yaml` variable"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:42
|
||||
@ -152,9 +106,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:44
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:51
|
||||
@ -162,24 +114,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:53
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:55
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-discord.md:57
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:59
|
||||
@ -195,9 +138,7 @@ msgid "Method 1: Login using QR code (recommended)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:65
|
||||
msgid ""
|
||||
"For using this bridge, you would need to authenticate by **scanning a QR "
|
||||
"code** with the Discord app on your phone."
|
||||
msgid "For using this bridge, you would need to authenticate by **scanning a QR code** with the Discord app on your phone."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:67
|
||||
@ -209,15 +150,7 @@ msgid "Method 2: Login using Discord token (not recommended)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:71
|
||||
msgid ""
|
||||
"To acquire the token, open Discord in a private browser window. Then open"
|
||||
" the developer settings (keyboard shortcut might be \"ctrl+shift+i\" or "
|
||||
"by pressing \"F12\"). Navigate to the \"Network\" tab then reload the "
|
||||
"page. In the URL filter or search bar type \"/api\" and find the response"
|
||||
" with the file name of \"library\". Under the request headers you should "
|
||||
"find a variable called \"Authorization\", this is the token to your "
|
||||
"Discord account. After copying the token, you can close the browser "
|
||||
"window."
|
||||
msgid "To acquire the token, open Discord in a private browser window. Then open the developer settings (keyboard shortcut might be \"ctrl+shift+i\" or by pressing \"F12\"). Navigate to the \"Network\" tab then reload the page. In the URL filter or search bar type \"/api\" and find the response with the file name of \"library\". Under the request headers you should find a variable called \"Authorization\", this is the token to your Discord account. After copying the token, you can close the browser window."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:73
|
||||
@ -225,34 +158,23 @@ msgid "Bridging"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:75
|
||||
msgid ""
|
||||
"Start a chat with `@discordbot:example.com` (where `example.com` is your "
|
||||
"base domain, not the `matrix.` domain)."
|
||||
msgid "Start a chat with `@discordbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:76
|
||||
msgid ""
|
||||
"If you would like to login to Discord using a token, send `login-token` "
|
||||
"command, otherwise, send `login-qr` command."
|
||||
msgid "If you would like to login to Discord using a token, send `login-token` command, otherwise, send `login-qr` command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:77
|
||||
msgid ""
|
||||
"You'll see a QR code which you need to scan with the Discord app on your "
|
||||
"phone. You can scan it with the camera app too, which will open Discord, "
|
||||
"which will then instruct you to scan it a 2nd time in the Discord app."
|
||||
msgid "You'll see a QR code which you need to scan with the Discord app on your phone. You can scan it with the camera app too, which will open Discord, which will then instruct you to scan it a 2nd time in the Discord app."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:78
|
||||
msgid ""
|
||||
"After confirming (in the Discord app) that you'd like to allow this "
|
||||
"login, the bot should respond with \"Succcessfully authenticated as …\""
|
||||
msgid "After confirming (in the Discord app) that you'd like to allow this login, the bot should respond with \"Succcessfully authenticated as …\""
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:79
|
||||
msgid ""
|
||||
"Now that you're logged in, you can send a `help` command to the bot "
|
||||
"again, to see additional commands you have access to"
|
||||
msgid "Now that you're logged in, you can send a `help` command to the bot again, to see additional commands you have access to"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:80
|
||||
@ -268,15 +190,11 @@ msgid "send `guilds status` to see the list of guilds"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:83
|
||||
msgid ""
|
||||
"for each guild that you'd like bridged, send `guilds bridge GUILD_ID "
|
||||
"--entire`"
|
||||
msgid "for each guild that you'd like bridged, send `guilds bridge GUILD_ID --entire`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:84
|
||||
msgid ""
|
||||
"You may wish to uninstall the Discord app from your phone now. It's not "
|
||||
"needed for the bridge to function."
|
||||
msgid "You may wish to uninstall the Discord app from your phone now. It's not needed for the bridge to function."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:86
|
||||
@ -284,10 +202,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:88
|
||||
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)."
|
||||
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-discord.md:90
|
||||
@ -295,32 +210,19 @@ msgid "To set it up, you have 2 ways of going about it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:92
|
||||
msgid ""
|
||||
"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
|
||||
"Secret Auth"
|
||||
msgid "Method 1: automatically, by enabling Appservice Double Puppet or Shared Secret Auth"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:94
|
||||
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 "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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:96
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:98
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:100
|
||||
@ -328,26 +230,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:102
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:104
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-discord.md:106
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:108
|
||||
msgid ""
|
||||
"make sure you don't log out the `Mautrix-Discord` device some time in the"
|
||||
" future, as that would break the Double Puppeting feature"
|
||||
msgid "make sure you don't log out the `Mautrix-Discord` device some time in the future, as that would break the Double Puppeting feature"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,25 +26,15 @@ msgid "Setting up Mautrix Facebook bridging (optional, deprecated)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:3
|
||||
msgid ""
|
||||
"**Note**: This bridge has been deprecated in favor of the [mautrix-"
|
||||
"meta](https://github.com/mautrix/meta) Messenger/Instagram bridge, which "
|
||||
"can be installed using [this playbook](configuring-playbook-bridge-"
|
||||
"mautrix-meta-messenger.md). Consider using that bridge instead of this "
|
||||
"one."
|
||||
msgid "**Note**: This bridge has been deprecated in favor of the [mautrix-meta](https://github.com/mautrix/meta) Messenger/Instagram bridge, which can be installed using [this playbook](configuring-playbook-bridge-mautrix-meta-messenger.md). Consider using that bridge instead of this one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"facebook](https://github.com/mautrix/facebook) for you."
|
||||
msgid "The playbook can install and configure [mautrix-facebook](https://github.com/mautrix/facebook) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:7
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://github.com/mautrix/facebook/blob/master/ROADMAP.md)"
|
||||
" to learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/mautrix/facebook/blob/master/ROADMAP.md) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:9
|
||||
@ -52,18 +42,11 @@ msgid "Prerequisite (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:11
|
||||
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 [Shared Secret Auth](configuring-playbook-shared-secret-"
|
||||
"auth.md) for this playbook."
|
||||
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 [Shared Secret Auth](configuring-playbook-shared-secret-auth.md) for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:13
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-facebook.md:15
|
||||
@ -71,27 +54,19 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:17
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-facebook.md:23
|
||||
msgid ""
|
||||
"There are some additional things you may wish to configure about the "
|
||||
"bridge before you continue."
|
||||
msgid "There are some additional things you may wish to configure about the bridge before you continue."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:25
|
||||
msgid ""
|
||||
"Encryption support is off by default. If you would like to enable "
|
||||
"encryption, add the following to your `vars.yml` file:"
|
||||
msgid "Encryption support is off by default. If you would like to enable encryption, add the following to your `vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:35
|
||||
msgid ""
|
||||
"If you would like to be able to administrate the bridge from your account"
|
||||
" it can be configured like this:"
|
||||
msgid "If you would like to be able to administrate the bridge from your account it can be configured like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:44
|
||||
@ -99,11 +74,7 @@ msgid "Using both would look like"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:56
|
||||
msgid ""
|
||||
"You may wish to look at `roles/custom/matrix-bridge-mautrix-"
|
||||
"facebook/templates/config.yaml.j2` and `roles/custom/matrix-bridge-"
|
||||
"mautrix-facebook/defaults/main.yml` to find other things you would like "
|
||||
"to configure."
|
||||
msgid "You may wish to look at `roles/custom/matrix-bridge-mautrix-facebook/templates/config.yaml.j2` and `roles/custom/matrix-bridge-mautrix-facebook/defaults/main.yml` to find other things you would like to configure."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:58
|
||||
@ -111,9 +82,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:60
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:67
|
||||
@ -121,24 +90,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:69
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:71
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-facebook.md:73
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:75
|
||||
@ -146,24 +106,15 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:77
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@facebookbot:example.com` (where `example.com` is your base domain, not "
|
||||
"the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@facebookbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:79
|
||||
msgid ""
|
||||
"Send `login YOUR_FACEBOOK_EMAIL_ADDRESS` to the bridge bot to enable "
|
||||
"bridging for your Facebook Messenger account. You can learn more here "
|
||||
"about authentication from the bridge's [official documentation on "
|
||||
"Authentication](https://docs.mau.fi/bridges/python/facebook/authentication.html)."
|
||||
msgid "Send `login YOUR_FACEBOOK_EMAIL_ADDRESS` to the bridge bot to enable bridging for your Facebook Messenger account. You can learn more here about authentication from the bridge's [official documentation on Authentication](https://docs.mau.fi/bridges/python/facebook/authentication.html)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:81
|
||||
msgid ""
|
||||
"If you run into trouble, check the [Troubleshooting](#troubleshooting) "
|
||||
"section below."
|
||||
msgid "If you run into trouble, check the [Troubleshooting](#troubleshooting) section below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:83
|
||||
@ -171,10 +122,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:85
|
||||
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)."
|
||||
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-facebook.md:87
|
||||
@ -186,17 +134,11 @@ msgid "Method 1: automatically, by enabling Shared Secret Auth"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:91
|
||||
msgid ""
|
||||
"The bridge automatically performs Double Puppeting if [Shared Secret Auth"
|
||||
"](configuring-playbook-shared-secret-auth.md) service is configured and "
|
||||
"enabled on the server for this playbook."
|
||||
msgid "The bridge automatically performs Double Puppeting if [Shared Secret Auth](configuring-playbook-shared-secret-auth.md) service is configured and enabled on the server for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:93
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-facebook.md:95
|
||||
@ -204,27 +146,19 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:97
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:99
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-facebook.md:101
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:103
|
||||
msgid ""
|
||||
"make sure you don't log out the `Mautrix-Facebook` device some time in "
|
||||
"the future, as that would break the Double Puppeting feature"
|
||||
msgid "make sure you don't log out the `Mautrix-Facebook` device some time in the future, as that would break the Double Puppeting feature"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:105
|
||||
@ -236,25 +170,15 @@ msgid "Facebook rejecting login attempts and forcing you to change password"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:109
|
||||
msgid ""
|
||||
"If your Matrix server is in a wildly different location than where you "
|
||||
"usually use your Facebook account from, the bridge's login attempts may "
|
||||
"be outright rejected by Facebook. Along with that, Facebook may even "
|
||||
"force you to change the account's password."
|
||||
msgid "If your Matrix server is in a wildly different location than where you usually use your Facebook account from, the bridge's login attempts may be outright rejected by Facebook. Along with that, Facebook may even force you to change the account's password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:111
|
||||
msgid ""
|
||||
"If you happen to run into this problem while [setting up "
|
||||
"bridging](#usage), try to first get a successful session up by logging in"
|
||||
" to Facebook through the Matrix server's IP address."
|
||||
msgid "If you happen to run into this problem while [setting up bridging](#usage), try to first get a successful session up by logging in to Facebook through the Matrix server's IP address."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:113
|
||||
msgid ""
|
||||
"The easiest way to do this may be to use "
|
||||
"[sshuttle](https://sshuttle.readthedocs.io/) to proxy your traffic "
|
||||
"through the Matrix server."
|
||||
msgid "The easiest way to do this may be to use [sshuttle](https://sshuttle.readthedocs.io/) to proxy your traffic through the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:115
|
||||
@ -262,10 +186,7 @@ msgid "Example command for proxying your traffic through the Matrix server:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:121
|
||||
msgid ""
|
||||
"Once connected, you should be able to verify that you're browsing the web"
|
||||
" through the Matrix server's IP by checking "
|
||||
"[icanhazip](https://icanhazip.com/)."
|
||||
msgid "Once connected, you should be able to verify that you're browsing the web through the Matrix server's IP by checking [icanhazip](https://icanhazip.com/)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:123
|
||||
@ -277,11 +198,5 @@ msgid "Once logged in, proceed to [set up bridging](#usage)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:127
|
||||
msgid ""
|
||||
"If that doesn't work, enable 2FA (see: [Facebook help page on enabling "
|
||||
"2FA](https://www.facebook.com/help/148233965247823)) and try to login "
|
||||
"again with a new password, and entering the 2FA code when prompted, it "
|
||||
"may take more then one try, in between attempts, check facebook.com to "
|
||||
"see if they are requiring another password change"
|
||||
msgid "If that doesn't work, enable 2FA (see: [Facebook help page on enabling 2FA](https://www.facebook.com/help/148233965247823)) and try to login again with a new password, and entering the 2FA code when prompted, it may take more then one try, in between attempts, check facebook.com to see if they are requiring another password change"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,17 +26,11 @@ msgid "Setting up Mautrix Google Messages bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"gmessages](https://github.com/mautrix/gmessages) for you, for bridging to"
|
||||
" [Google Messages](https://messages.google.com/)."
|
||||
msgid "The playbook can install and configure [mautrix-gmessages](https://github.com/mautrix/gmessages) for you, for bridging to [Google Messages](https://messages.google.com/)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:5
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://docs.mau.fi/bridges/go/gmessages/index.html) to "
|
||||
"learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://docs.mau.fi/bridges/go/gmessages/index.html) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:7
|
||||
@ -44,18 +38,11 @@ msgid "Prerequisite (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:9
|
||||
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) for this playbook."
|
||||
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) for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:11
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-gmessages.md:13
|
||||
@ -63,9 +50,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:15
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-gmessages.md:21
|
||||
@ -73,9 +58,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:23
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:30
|
||||
@ -83,24 +66,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:32
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:34
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-gmessages.md:36
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:38
|
||||
@ -108,10 +82,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:40
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@gmessagesbot:example.com` (where `example.com` is your base domain, not"
|
||||
" the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@gmessagesbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:42
|
||||
@ -119,10 +90,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:44
|
||||
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)."
|
||||
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-gmessages.md:46
|
||||
@ -134,17 +102,11 @@ msgid "Method 1: automatically, by enabling Appservice Double Puppet"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:50
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-gmessages.md:52
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-gmessages.md:54
|
||||
@ -152,26 +114,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:56
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:58
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-gmessages.md:60
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:62
|
||||
msgid ""
|
||||
"make sure you don't log out the `Mautrix-gmessages` device some time in "
|
||||
"the future, as that would break the Double Puppeting feature"
|
||||
msgid "make sure you don't log out the `Mautrix-gmessages` device some time in the future, as that would break the Double Puppeting feature"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,16 +26,11 @@ msgid "Setting up Mautrix Google Chat bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"googlechat](https://github.com/mautrix/googlechat) for you."
|
||||
msgid "The playbook can install and configure [mautrix-googlechat](https://github.com/mautrix/googlechat) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:5
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://docs.mau.fi/bridges/python/googlechat/index.html)"
|
||||
" to learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://docs.mau.fi/bridges/python/googlechat/index.html) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:7
|
||||
@ -43,19 +38,11 @@ msgid "Prerequisite (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:9
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:11
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-googlechat.md:13
|
||||
@ -63,10 +50,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:15
|
||||
msgid ""
|
||||
"To enable the [Google Chat](https://chat.google.com/) bridge, add the "
|
||||
"following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable the [Google Chat](https://chat.google.com/) bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:21
|
||||
@ -74,9 +58,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:23
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:30
|
||||
@ -84,24 +66,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:32
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:34
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-googlechat.md:36
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:38
|
||||
@ -109,38 +82,23 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:40
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `googlechat bridge bot` "
|
||||
"with handle `@googlechatbot:example.com` (where `example.com` is your "
|
||||
"base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `googlechat bridge bot` with handle `@googlechatbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:42
|
||||
msgid ""
|
||||
"Send `login` to the bridge bot to receive a link to the portal from which"
|
||||
" you can enable the bridging. Open the link sent by the bot and follow "
|
||||
"the instructions."
|
||||
msgid "Send `login` to the bridge bot to receive a link to the portal from which you can enable the bridging. Open the link sent by the bot and follow the instructions."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:44
|
||||
msgid ""
|
||||
"Automatic login may not work. If it does not, reload the page and select "
|
||||
"the \"Manual login\" checkbox before starting. Manual login involves "
|
||||
"logging into your Google account normally and then manually getting the "
|
||||
"OAuth token from browser cookies with developer tools."
|
||||
msgid "Automatic login may not work. If it does not, reload the page and select the \"Manual login\" checkbox before starting. Manual login involves logging into your Google account normally and then manually getting the OAuth token from browser cookies with developer tools."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:46
|
||||
msgid ""
|
||||
"Once logged in, recent chats should show up as new conversations "
|
||||
"automatically. Other chats will get portals as you receive messages."
|
||||
msgid "Once logged in, recent chats should show up as new conversations automatically. Other chats will get portals as you receive messages."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:48
|
||||
msgid ""
|
||||
"You can learn more about authentication from the bridge's [official "
|
||||
"documentation on "
|
||||
"Authentication](https://docs.mau.fi/bridges/python/googlechat/authentication.html)."
|
||||
msgid "You can learn more about authentication from the bridge's [official documentation on Authentication](https://docs.mau.fi/bridges/python/googlechat/authentication.html)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:50
|
||||
@ -148,10 +106,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:52
|
||||
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)."
|
||||
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-googlechat.md:54
|
||||
@ -159,32 +114,19 @@ msgid "To set it up, you have 2 ways of going about it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:56
|
||||
msgid ""
|
||||
"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
|
||||
"Secret Auth"
|
||||
msgid "Method 1: automatically, by enabling Appservice Double Puppet or Shared Secret Auth"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:58
|
||||
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 "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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:60
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:62
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:64
|
||||
@ -192,26 +134,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:66
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:68
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-googlechat.md:70
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:72
|
||||
msgid ""
|
||||
"make sure you don't log out the `Mautrix-googlechat` device some time in "
|
||||
"the future, as that would break the Double Puppeting feature"
|
||||
msgid "make sure you don't log out the `Mautrix-googlechat` device some time in the future, as that would break the Double Puppeting feature"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,25 +26,15 @@ msgid "Setting up Mautrix Hangouts bridging (optional, deprecated)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:3
|
||||
msgid ""
|
||||
"💡 **Note**: This bridge has been deprecated in favor of [Google Chat "
|
||||
"bridge](https://github.com/mautrix/googlechat), which can be installed "
|
||||
"using [this playbook](configuring-playbook-bridge-mautrix-googlechat.md)."
|
||||
" Installing the mautrix-hangouts bridge is **no longer possible**. For "
|
||||
"now, this documentation page remains here for historical purposes."
|
||||
msgid "💡 **Note**: This bridge has been deprecated in favor of [Google Chat bridge](https://github.com/mautrix/googlechat), which can be installed using [this playbook](configuring-playbook-bridge-mautrix-googlechat.md). Installing the mautrix-hangouts bridge is **no longer possible**. For now, this documentation page remains here for historical purposes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"hangouts](https://github.com/mautrix/hangouts) for you."
|
||||
msgid "The playbook can install and configure [mautrix-hangouts](https://github.com/mautrix/hangouts) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:7
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://docs.mau.fi/bridges/python/hangouts/index.html) "
|
||||
"to learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://docs.mau.fi/bridges/python/hangouts/index.html) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:9
|
||||
@ -52,18 +42,11 @@ msgid "Prerequisite (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:11
|
||||
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 [Shared Secret Auth](configuring-playbook-shared-secret-"
|
||||
"auth.md) for this playbook."
|
||||
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 [Shared Secret Auth](configuring-playbook-shared-secret-auth.md) for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:13
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-hangouts.md:15
|
||||
@ -71,10 +54,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:17
|
||||
msgid ""
|
||||
"To enable the [Google Hangouts](https://hangouts.google.com/) bridge, add"
|
||||
" the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable the [Google Hangouts](https://hangouts.google.com/) bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:23
|
||||
@ -82,9 +62,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:25
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:32
|
||||
@ -92,24 +70,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:34
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:36
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-hangouts.md:38
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:40
|
||||
@ -117,38 +86,23 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:42
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `Hangouts bridge bot` "
|
||||
"with handle `@hangoutsbot:example.com` (where `example.com` is your base "
|
||||
"domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `Hangouts bridge bot` with handle `@hangoutsbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:44
|
||||
msgid ""
|
||||
"Send `login` to the bridge bot to receive a link to the portal from which"
|
||||
" you can enable the bridging. Open the link sent by the bot and follow "
|
||||
"the instructions."
|
||||
msgid "Send `login` to the bridge bot to receive a link to the portal from which you can enable the bridging. Open the link sent by the bot and follow the instructions."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:46
|
||||
msgid ""
|
||||
"Automatic login may not work. If it does not, reload the page and select "
|
||||
"the \"Manual login\" checkbox before starting. Manual login involves "
|
||||
"logging into your Google account normally and then manually getting the "
|
||||
"OAuth token from browser cookies with developer tools."
|
||||
msgid "Automatic login may not work. If it does not, reload the page and select the \"Manual login\" checkbox before starting. Manual login involves logging into your Google account normally and then manually getting the OAuth token from browser cookies with developer tools."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:48
|
||||
msgid ""
|
||||
"Once logged in, recent chats should show up as new conversations "
|
||||
"automatically. Other chats will get portals as you receive messages."
|
||||
msgid "Once logged in, recent chats should show up as new conversations automatically. Other chats will get portals as you receive messages."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:50
|
||||
msgid ""
|
||||
"You can learn more about authentication from the bridge's [official "
|
||||
"documentation on "
|
||||
"Authentication](https://docs.mau.fi/bridges/python/hangouts/authentication.html)."
|
||||
msgid "You can learn more about authentication from the bridge's [official documentation on Authentication](https://docs.mau.fi/bridges/python/hangouts/authentication.html)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:52
|
||||
@ -156,10 +110,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:54
|
||||
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)."
|
||||
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-hangouts.md:56
|
||||
@ -171,17 +122,11 @@ msgid "Method 1: automatically, by enabling Shared Secret Auth"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:60
|
||||
msgid ""
|
||||
"The bridge automatically performs Double Puppeting if [Shared Secret Auth"
|
||||
"](configuring-playbook-shared-secret-auth.md) service is configured and "
|
||||
"enabled on the server for this playbook."
|
||||
msgid "The bridge automatically performs Double Puppeting if [Shared Secret Auth](configuring-playbook-shared-secret-auth.md) service is configured and enabled on the server for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:62
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-hangouts.md:64
|
||||
@ -189,26 +134,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:66
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:68
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-hangouts.md:70
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:72
|
||||
msgid ""
|
||||
"make sure you don't log out the `Mautrix-Hangouts` device some time in "
|
||||
"the future, as that would break the Double Puppeting feature"
|
||||
msgid "make sure you don't log out the `Mautrix-Hangouts` device some time in the future, as that would break the Double Puppeting feature"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,25 +26,15 @@ msgid "Setting up Mautrix Instagram bridging (optional, deprecated)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:3
|
||||
msgid ""
|
||||
"**Note**: This bridge has been deprecated in favor of the [mautrix-"
|
||||
"meta](https://github.com/mautrix/meta) Messenger/Instagram bridge, which "
|
||||
"can be installed using [this playbook](configuring-playbook-bridge-"
|
||||
"mautrix-meta-instagram.md). Consider using that bridge instead of this "
|
||||
"one."
|
||||
msgid "**Note**: This bridge has been deprecated in favor of the [mautrix-meta](https://github.com/mautrix/meta) Messenger/Instagram bridge, which can be installed using [this playbook](configuring-playbook-bridge-mautrix-meta-instagram.md). Consider using that bridge instead of this one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"instagram](https://github.com/mautrix/instagram) for you."
|
||||
msgid "The playbook can install and configure [mautrix-instagram](https://github.com/mautrix/instagram) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:7
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://docs.mau.fi/bridges/python/instagram/index.html) "
|
||||
"to learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://docs.mau.fi/bridges/python/instagram/index.html) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:9
|
||||
@ -52,35 +42,23 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:11
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-instagram.md:17
|
||||
msgid ""
|
||||
"There are some additional things you may wish to configure about the "
|
||||
"bridge before you continue."
|
||||
msgid "There are some additional things you may wish to configure about the bridge before you continue."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:19
|
||||
msgid ""
|
||||
"Encryption support is off by default. If you would like to enable "
|
||||
"encryption, add the following to your `vars.yml` file:"
|
||||
msgid "Encryption support is off by default. If you would like to enable encryption, add the following to your `vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:29
|
||||
msgid ""
|
||||
"If you would like to be able to administrate the bridge from your account"
|
||||
" it can be configured like this:"
|
||||
msgid "If you would like to be able to administrate the bridge from your account it can be configured like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:43
|
||||
msgid ""
|
||||
"You may wish to look at `roles/custom/matrix-bridge-mautrix-"
|
||||
"instagram/templates/config.yaml.j2` and `roles/custom/matrix-bridge-"
|
||||
"mautrix-instagram/defaults/main.yml` to find other things you would like "
|
||||
"to configure."
|
||||
msgid "You may wish to look at `roles/custom/matrix-bridge-mautrix-instagram/templates/config.yaml.j2` and `roles/custom/matrix-bridge-mautrix-instagram/defaults/main.yml` to find other things you would like to configure."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:45
|
||||
@ -88,9 +66,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:47
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:54
|
||||
@ -98,24 +74,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:56
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:58
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-instagram.md:60
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:62
|
||||
@ -123,22 +90,13 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:64
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@instagrambot:example.com` (where `example.com` is your base domain, not"
|
||||
" the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@instagrambot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:66
|
||||
msgid ""
|
||||
"Send `login YOUR_INSTAGRAM_EMAIL_ADDRESS YOUR_INSTAGRAM_PASSWORD` to the "
|
||||
"bridge bot to enable bridging for your instagram/Messenger account."
|
||||
msgid "Send `login YOUR_INSTAGRAM_EMAIL_ADDRESS YOUR_INSTAGRAM_PASSWORD` to the bridge bot to enable bridging for your instagram/Messenger account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:68
|
||||
msgid ""
|
||||
"You can learn more here about authentication from the bridge's [official "
|
||||
"documentation on "
|
||||
"Authentication](https://docs.mau.fi/bridges/python/instagram/authentication.html)."
|
||||
msgid "You can learn more here about authentication from the bridge's [official documentation on Authentication](https://docs.mau.fi/bridges/python/instagram/authentication.html)."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,30 +26,15 @@ msgid "Setting up Instagram bridging via Mautrix Meta (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [mautrix-"
|
||||
"meta](https://github.com/mautrix/meta) Messenger/Instagram bridge for "
|
||||
"you."
|
||||
msgid "The playbook can install and configure the [mautrix-meta](https://github.com/mautrix/meta) Messenger/Instagram bridge for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:5
|
||||
msgid ""
|
||||
"Since this bridge component can bridge to both "
|
||||
"[Messenger](https://messenger.com/) and "
|
||||
"[Instagram](https://instagram.com/) and you may wish to do both at the "
|
||||
"same time, the playbook makes it available via 2 different Ansible roles "
|
||||
"(`matrix-bridge-mautrix-meta-messenger` and `matrix-bridge-mautrix-meta-"
|
||||
"instagram`). The latter is a reconfigured copy of the first one (created "
|
||||
"by `just rebuild-mautrix-meta-instagram` and `bin/rebuild-mautrix-meta-"
|
||||
"instagram.sh`)."
|
||||
msgid "Since this bridge component can bridge to both [Messenger](https://messenger.com/) and [Instagram](https://instagram.com/) and you may wish to do both at the same time, the playbook makes it available via 2 different Ansible roles (`matrix-bridge-mautrix-meta-messenger` and `matrix-bridge-mautrix-meta-instagram`). The latter is a reconfigured copy of the first one (created by `just rebuild-mautrix-meta-instagram` and `bin/rebuild-mautrix-meta-instagram.sh`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:7
|
||||
msgid ""
|
||||
"This documentation page only deals with the bridge's ability to bridge to"
|
||||
" Instagram. For bridging to Facebook/Messenger, see [Setting up Messenger"
|
||||
" bridging via Mautrix Meta](configuring-playbook-bridge-mautrix-meta-"
|
||||
"messenger.md)."
|
||||
msgid "This documentation page only deals with the bridge's ability to bridge to Instagram. For bridging to Facebook/Messenger, see [Setting up Messenger bridging via Mautrix Meta](configuring-playbook-bridge-mautrix-meta-messenger.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:9
|
||||
@ -61,18 +46,11 @@ msgid "Migrating from the old mautrix-instagram bridge"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:13
|
||||
msgid ""
|
||||
"If you've been using the [mautrix-instagram](./configuring-playbook-"
|
||||
"bridge-mautrix-instagram.md) bridge, **you'd better get rid of it first**"
|
||||
" or the 2 bridges will be in conflict:"
|
||||
msgid "If you've been using the [mautrix-instagram](./configuring-playbook-bridge-mautrix-instagram.md) bridge, **you'd better get rid of it first** or the 2 bridges will be in conflict:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:15
|
||||
msgid ""
|
||||
"both trying to use `@instagrambot:example.com` as their username. This "
|
||||
"conflict may be resolved by adjusting "
|
||||
"`matrix_mautrix_instagram_appservice_bot_username` or "
|
||||
"`matrix_mautrix_meta_instagram_appservice_username`"
|
||||
msgid "both trying to use `@instagrambot:example.com` as their username. This conflict may be resolved by adjusting `matrix_mautrix_instagram_appservice_bot_username` or `matrix_mautrix_meta_instagram_appservice_username`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:16
|
||||
@ -80,17 +58,11 @@ msgid "both trying to bridge the same DMs"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:18
|
||||
msgid ""
|
||||
"To do so, send a `clean-rooms` command to the management room with the "
|
||||
"old bridge bot (`@instagrambot:example.com`). It gives you a list of "
|
||||
"portals and groups of portals you may purge. Proceed with sending "
|
||||
"commands like `clean recommended`, etc."
|
||||
msgid "To do so, send a `clean-rooms` command to the management room with the old bridge bot (`@instagrambot:example.com`). It gives you a list of portals and groups of portals you may purge. Proceed with sending commands like `clean recommended`, etc."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:20
|
||||
msgid ""
|
||||
"Then, consider disabling the old bridge in your configuration, so it "
|
||||
"won't recreate the portals when you receive new messages."
|
||||
msgid "Then, consider disabling the old bridge in your configuration, so it won't recreate the portals when you receive new messages."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:22
|
||||
@ -98,18 +70,11 @@ msgid "Enable Appservice Double Puppet (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:24
|
||||
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) service for this playbook."
|
||||
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) service for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:26
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-meta-instagram.md:28
|
||||
@ -117,15 +82,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:30
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-meta-instagram.md:36
|
||||
msgid ""
|
||||
"Before proceeding to [re-running the playbook](./installing.md), you may "
|
||||
"wish to adjust the configuration further. See below."
|
||||
msgid "Before proceeding to [re-running the playbook](./installing.md), you may wish to adjust the configuration further. See below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:38
|
||||
@ -153,37 +114,23 @@ msgid "`admin` - Use and administer the bridge"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:48
|
||||
msgid ""
|
||||
"The permissions are following the sequence: nothing < `relay` < `user` < "
|
||||
"`admin`."
|
||||
msgid "The permissions are following the sequence: nothing < `relay` < `user` < `admin`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:50
|
||||
msgid ""
|
||||
"The default permissions are set via "
|
||||
"`matrix_mautrix_meta_instagram_bridge_permissions_default` and are "
|
||||
"somewhat like this:"
|
||||
msgid "The default permissions are set via `matrix_mautrix_meta_instagram_bridge_permissions_default` and are somewhat like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:59
|
||||
msgid ""
|
||||
"If you don't define the `matrix_admin` in your configuration (e.g. "
|
||||
"`matrix_admin: @alice:example.com`), then there's no admin by default."
|
||||
msgid "If you don't define the `matrix_admin` in your configuration (e.g. `matrix_admin: @alice:example.com`), then there's no admin by default."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:61
|
||||
msgid ""
|
||||
"You may redefine "
|
||||
"`matrix_mautrix_meta_instagram_bridge_permissions_default` any way you "
|
||||
"see fit, or add extra permissions using "
|
||||
"`matrix_mautrix_meta_instagram_bridge_permissions_custom` like this:"
|
||||
msgid "You may redefine `matrix_mautrix_meta_instagram_bridge_permissions_default` any way you see fit, or add extra permissions using `matrix_mautrix_meta_instagram_bridge_permissions_custom` like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:68
|
||||
msgid ""
|
||||
"You may wish to look at `roles/custom/matrix-bridge-mautrix-meta-"
|
||||
"instagram/templates/config.yaml.j2` to find more information on the "
|
||||
"permissions settings and other options you would like to configure."
|
||||
msgid "You may wish to look at `roles/custom/matrix-bridge-mautrix-meta-instagram/templates/config.yaml.j2` to find more information on the permissions settings and other options you would like to configure."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:70
|
||||
@ -191,9 +138,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:72
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:79
|
||||
@ -201,24 +146,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:81
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:83
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-meta-instagram.md:85
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:87
|
||||
@ -226,10 +162,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:89
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@instagrambot:example.com` (where `example.com` is your base domain, not"
|
||||
" the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@instagrambot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:91
|
||||
@ -237,10 +170,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:93
|
||||
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)."
|
||||
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-meta-instagram.md:95
|
||||
@ -252,17 +182,11 @@ msgid "Method 1: automatically, by enabling Appservice Double Puppet"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:99
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-meta-instagram.md:101
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-meta-instagram.md:103
|
||||
@ -270,27 +194,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:105
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:107
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-meta-instagram.md:109
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:111
|
||||
msgid ""
|
||||
"make sure you don't log out the session for which you obtained an access "
|
||||
"token some time in the future, as that would break the Double Puppeting "
|
||||
"feature"
|
||||
msgid "make sure you don't log out the session for which you obtained an access token some time in the future, as that would break the Double Puppeting feature"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,30 +26,15 @@ msgid "Setting up Messenger bridging via Mautrix Meta (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [mautrix-"
|
||||
"meta](https://github.com/mautrix/meta) Messenger/Instagram bridge for "
|
||||
"you."
|
||||
msgid "The playbook can install and configure the [mautrix-meta](https://github.com/mautrix/meta) Messenger/Instagram bridge for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:5
|
||||
msgid ""
|
||||
"Since this bridge component can bridge to both "
|
||||
"[Messenger](https://messenger.com/) and "
|
||||
"[Instagram](https://instagram.com/) and you may wish to do both at the "
|
||||
"same time, the playbook makes it available via 2 different Ansible roles "
|
||||
"(`matrix-bridge-mautrix-meta-messenger` and `matrix-bridge-mautrix-meta-"
|
||||
"instagram`). The latter is a reconfigured copy of the first one (created "
|
||||
"by `just rebuild-mautrix-meta-instagram` and `bin/rebuild-mautrix-meta-"
|
||||
"instagram.sh`)."
|
||||
msgid "Since this bridge component can bridge to both [Messenger](https://messenger.com/) and [Instagram](https://instagram.com/) and you may wish to do both at the same time, the playbook makes it available via 2 different Ansible roles (`matrix-bridge-mautrix-meta-messenger` and `matrix-bridge-mautrix-meta-instagram`). The latter is a reconfigured copy of the first one (created by `just rebuild-mautrix-meta-instagram` and `bin/rebuild-mautrix-meta-instagram.sh`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:7
|
||||
msgid ""
|
||||
"This documentation page only deals with the bridge's ability to bridge to"
|
||||
" Facebook Messenger. For bridging to Instagram, see [Setting up Instagram"
|
||||
" bridging via Mautrix Meta](configuring-playbook-bridge-mautrix-meta-"
|
||||
"instagram.md)."
|
||||
msgid "This documentation page only deals with the bridge's ability to bridge to Facebook Messenger. For bridging to Instagram, see [Setting up Instagram bridging via Mautrix Meta](configuring-playbook-bridge-mautrix-meta-instagram.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:9
|
||||
@ -61,34 +46,19 @@ msgid "Migrating from the old mautrix-facebook bridge"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:13
|
||||
msgid ""
|
||||
"If you've been using the [mautrix-facebook](./configuring-playbook-"
|
||||
"bridge-mautrix-facebook.md) bridge, it's possible to migrate the database"
|
||||
" using [instructions from the bridge "
|
||||
"documentation](https://docs.mau.fi/bridges/go/meta/facebook-"
|
||||
"migration.html) (advanced)."
|
||||
msgid "If you've been using the [mautrix-facebook](./configuring-playbook-bridge-mautrix-facebook.md) bridge, it's possible to migrate the database using [instructions from the bridge documentation](https://docs.mau.fi/bridges/go/meta/facebook-migration.html) (advanced)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:15
|
||||
msgid ""
|
||||
"Then you may wish to get rid of the Facebook bridge. To do so, send a "
|
||||
"`clean-rooms` command to the management room with the old bridge bot "
|
||||
"(`@facebookbot:example.com`). It gives you a list of portals and groups "
|
||||
"of portals you may purge. Proceed with sending commands like `clean "
|
||||
"recommended`, etc."
|
||||
msgid "Then you may wish to get rid of the Facebook bridge. To do so, send a `clean-rooms` command to the management room with the old bridge bot (`@facebookbot:example.com`). It gives you a list of portals and groups of portals you may purge. Proceed with sending commands like `clean recommended`, etc."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:17
|
||||
msgid ""
|
||||
"Then, consider disabling the old bridge in your configuration, so it "
|
||||
"won't recreate the portals when you receive new messages."
|
||||
msgid "Then, consider disabling the old bridge in your configuration, so it won't recreate the portals when you receive new messages."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:19
|
||||
msgid ""
|
||||
"**Note**: the user ID of the new bridge bot is "
|
||||
"`@messengerbot:example.com`, not `@facebookbot:example.com`. After "
|
||||
"disabling the old bridge, its bot user will stop responding to a command."
|
||||
msgid "**Note**: the user ID of the new bridge bot is `@messengerbot:example.com`, not `@facebookbot:example.com`. After disabling the old bridge, its bot user will stop responding to a command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:21
|
||||
@ -96,18 +66,11 @@ msgid "Enable Appservice Double Puppet (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:23
|
||||
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) service for this playbook."
|
||||
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) service for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:25
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-meta-messenger.md:27
|
||||
@ -115,15 +78,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:29
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-meta-messenger.md:35
|
||||
msgid ""
|
||||
"Before proceeding to [re-running the playbook](./installing.md), you may "
|
||||
"wish to adjust the configuration further. See below."
|
||||
msgid "Before proceeding to [re-running the playbook](./installing.md), you may wish to adjust the configuration further. See below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:37
|
||||
@ -131,9 +90,7 @@ msgid "Bridge mode"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:39
|
||||
msgid ""
|
||||
"As mentioned above, the [mautrix-meta](https://github.com/mautrix/meta) "
|
||||
"bridge supports multiple modes of operation."
|
||||
msgid "As mentioned above, the [mautrix-meta](https://github.com/mautrix/meta) bridge supports multiple modes of operation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:41
|
||||
@ -145,36 +102,19 @@ msgid "(`facebook`) Facebook via `facebook.com`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:44
|
||||
msgid ""
|
||||
"(`facebook-tor`) Facebook via "
|
||||
"`facebookwkhpilnemxj7asaniu7vnjjbiltxjqhye3mhbshg7kx5tfyd.onion` "
|
||||
"([Tor](https://www.torproject.org/)) - does not currently proxy media "
|
||||
"downloads"
|
||||
msgid "(`facebook-tor`) Facebook via `facebookwkhpilnemxj7asaniu7vnjjbiltxjqhye3mhbshg7kx5tfyd.onion` ([Tor](https://www.torproject.org/)) - does not currently proxy media downloads"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:45
|
||||
msgid ""
|
||||
"(default) (`messenger`) Messenger via `messenger.com` - usable even "
|
||||
"without a Facebook account"
|
||||
msgid "(default) (`messenger`) Messenger via `messenger.com` - usable even without a Facebook account"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:47
|
||||
msgid ""
|
||||
"You may switch the mode via the `matrix_mautrix_meta_messenger_meta_mode`"
|
||||
" variable. The playbook defaults to the `messenger` mode, because it's "
|
||||
"most universal (every Facebook user has a Messenger account, but the "
|
||||
"opposite is not true)."
|
||||
msgid "You may switch the mode via the `matrix_mautrix_meta_messenger_meta_mode` variable. The playbook defaults to the `messenger` mode, because it's most universal (every Facebook user has a Messenger account, but the opposite is not true)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:49
|
||||
msgid ""
|
||||
"Note that switching the mode (especially between `facebook*` and "
|
||||
"`messenger`) will intentionally make the bridge use another database "
|
||||
"(`matrix_mautrix_meta_facebook` or `matrix_mautrix_meta_messenger`) to "
|
||||
"isolate the 2 instances. Switching between Tor and non-Tor may be "
|
||||
"possible without dataloss, but your mileage may vary. Before switching to"
|
||||
" a new mode, you may wish to de-configure the old one (send `help` to the"
|
||||
" bridge bot and unbridge your portals, etc.)."
|
||||
msgid "Note that switching the mode (especially between `facebook*` and `messenger`) will intentionally make the bridge use another database (`matrix_mautrix_meta_facebook` or `matrix_mautrix_meta_messenger`) to isolate the 2 instances. Switching between Tor and non-Tor may be possible without dataloss, but your mileage may vary. Before switching to a new mode, you may wish to de-configure the old one (send `help` to the bridge bot and unbridge your portals, etc.)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:51
|
||||
@ -202,37 +142,23 @@ msgid "`admin` - Use and administer the bridge"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:61
|
||||
msgid ""
|
||||
"The permissions are following the sequence: nothing < `relay` < `user` < "
|
||||
"`admin`."
|
||||
msgid "The permissions are following the sequence: nothing < `relay` < `user` < `admin`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:63
|
||||
msgid ""
|
||||
"The default permissions are set via "
|
||||
"`matrix_mautrix_meta_messenger_bridge_permissions_default` and are "
|
||||
"somewhat like this:"
|
||||
msgid "The default permissions are set via `matrix_mautrix_meta_messenger_bridge_permissions_default` and are somewhat like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:72
|
||||
msgid ""
|
||||
"If you don't define the `matrix_admin` in your configuration (e.g. "
|
||||
"`matrix_admin: @alice:example.com`), then there's no admin by default."
|
||||
msgid "If you don't define the `matrix_admin` in your configuration (e.g. `matrix_admin: @alice:example.com`), then there's no admin by default."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:74
|
||||
msgid ""
|
||||
"You may redefine "
|
||||
"`matrix_mautrix_meta_messenger_bridge_permissions_default` any way you "
|
||||
"see fit, or add extra permissions using "
|
||||
"`matrix_mautrix_meta_messenger_bridge_permissions_custom` like this:"
|
||||
msgid "You may redefine `matrix_mautrix_meta_messenger_bridge_permissions_default` any way you see fit, or add extra permissions using `matrix_mautrix_meta_messenger_bridge_permissions_custom` like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:81
|
||||
msgid ""
|
||||
"You may wish to look at `roles/custom/matrix-bridge-mautrix-meta-"
|
||||
"messenger/templates/config.yaml.j2` to find more information on the "
|
||||
"permissions settings and other options you would like to configure."
|
||||
msgid "You may wish to look at `roles/custom/matrix-bridge-mautrix-meta-messenger/templates/config.yaml.j2` to find more information on the permissions settings and other options you would like to configure."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:83
|
||||
@ -240,9 +166,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:85
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:92
|
||||
@ -250,24 +174,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:94
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:96
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-meta-messenger.md:98
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:100
|
||||
@ -275,26 +190,15 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:102
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@messengerbot:example.com` (where `example.com` is your base domain, not"
|
||||
" the `matrix.` domain). Note that the user ID of the bridge's bot is not "
|
||||
"`@facebookbot:example.com`."
|
||||
msgid "To use the bridge, you need to start a chat with `@messengerbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). Note that the user ID of the bridge's bot is not `@facebookbot:example.com`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:104
|
||||
msgid ""
|
||||
"You then need to send a `login` command and follow the bridge bot's "
|
||||
"instructions."
|
||||
msgid "You then need to send a `login` command and follow the bridge bot's instructions."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:106
|
||||
msgid ""
|
||||
"Given that the bot is configured in `messenger` [bridge mode](#bridge-"
|
||||
"mode) by default, you will need to log in to "
|
||||
"[messenger.com](https://messenger.com/) (not `facebook.com`!) and obtain "
|
||||
"the cookies from there as per [the bridge's authentication "
|
||||
"instructions](https://docs.mau.fi/bridges/go/meta/authentication.html)."
|
||||
msgid "Given that the bot is configured in `messenger` [bridge mode](#bridge-mode) by default, you will need to log in to [messenger.com](https://messenger.com/) (not `facebook.com`!) and obtain the cookies from there as per [the bridge's authentication instructions](https://docs.mau.fi/bridges/go/meta/authentication.html)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:108
|
||||
@ -302,10 +206,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:110
|
||||
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)."
|
||||
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-meta-messenger.md:112
|
||||
@ -317,17 +218,11 @@ msgid "Method 1: automatically, by enabling Appservice Double Puppet"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:116
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-meta-messenger.md:118
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-meta-messenger.md:120
|
||||
@ -335,27 +230,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:122
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:124
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-meta-messenger.md:126
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:128
|
||||
msgid ""
|
||||
"make sure you don't log out the session for which you obtained an access "
|
||||
"token some time in the future, as that would break the Double Puppeting "
|
||||
"feature"
|
||||
msgid "make sure you don't log out the session for which you obtained an access token some time in the future, as that would break the Double Puppeting feature"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,23 +26,15 @@ msgid "Setting up Mautrix Signal bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"signal](https://github.com/mautrix/signal) for you."
|
||||
msgid "The playbook can install and configure [mautrix-signal](https://github.com/mautrix/signal) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:5
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://docs.mau.fi/bridges/python/signal/index.html) to "
|
||||
"learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://docs.mau.fi/bridges/python/signal/index.html) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:7
|
||||
msgid ""
|
||||
"**Note**: This revamped version of the [mautrix-signal (legacy"
|
||||
")](configuring-playbook-bridge-mautrix-signal.md) may increase the CPU "
|
||||
"usage of your homeserver."
|
||||
msgid "**Note**: This revamped version of the [mautrix-signal (legacy)](configuring-playbook-bridge-mautrix-signal.md) may increase the CPU usage of your homeserver."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:9
|
||||
@ -54,18 +46,11 @@ msgid "Prepare Postgres database on external Postgres server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:13
|
||||
msgid ""
|
||||
"If you're running with the Postgres database server integrated by the "
|
||||
"playbook (which is the default), you don't need to do anything special "
|
||||
"and can easily proceed with installing."
|
||||
msgid "If you're running with the Postgres database server integrated by the playbook (which is the default), you don't need to do anything special and can easily proceed with installing."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:15
|
||||
msgid ""
|
||||
"However, if you're [using an external Postgres server](configuring-"
|
||||
"playbook-external-postgres.md), you'd need to manually prepare a Postgres"
|
||||
" database for this bridge and adjust the variables related to that "
|
||||
"(`matrix_mautrix_signal_database_*`)."
|
||||
msgid "However, if you're [using an external Postgres server](configuring-playbook-external-postgres.md), you'd need to manually prepare a Postgres database for this bridge and adjust the variables related to that (`matrix_mautrix_signal_database_*`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:17
|
||||
@ -73,18 +58,11 @@ msgid "Enable Appservice Double Puppet"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:19
|
||||
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) service for this playbook."
|
||||
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) service for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:21
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-signal.md:23
|
||||
@ -92,15 +70,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:25
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-signal.md:31
|
||||
msgid ""
|
||||
"There are some additional things you may wish to configure about the "
|
||||
"bridge before you continue."
|
||||
msgid "There are some additional things you may wish to configure about the bridge before you continue."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:33
|
||||
@ -124,9 +98,7 @@ msgid "admin - Use and administer the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:41
|
||||
msgid ""
|
||||
"The permissions are following the sequence: nothing < relay < user < "
|
||||
"admin."
|
||||
msgid "The permissions are following the sequence: nothing < relay < user < admin."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:43
|
||||
@ -134,29 +106,19 @@ msgid "The default permissions are set as follows:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:51
|
||||
msgid ""
|
||||
"If you want to augment the preset permissions, you might want to set the "
|
||||
"additional permissions with the following settings in your `vars.yml` "
|
||||
"file:"
|
||||
msgid "If you want to augment the preset permissions, you might want to set the additional permissions with the following settings in your `vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:60
|
||||
msgid ""
|
||||
"This will add the admin permission to the specific user, while keeping "
|
||||
"the default permissions."
|
||||
msgid "This will add the admin permission to the specific user, while keeping the default permissions."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:62
|
||||
msgid ""
|
||||
"In case you want to replace the default permissions settings "
|
||||
"**completely**, populate the following item within your `vars.yml` file:"
|
||||
msgid "In case you want to replace the default permissions settings **completely**, populate the following item within your `vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:70
|
||||
msgid ""
|
||||
"You may wish to look at `roles/custom/matrix-bridge-mautrix-"
|
||||
"signal/templates/config.yaml.j2` to find more information on the "
|
||||
"permissions settings and other options you would like to configure."
|
||||
msgid "You may wish to look at `roles/custom/matrix-bridge-mautrix-signal/templates/config.yaml.j2` to find more information on the permissions settings and other options you would like to configure."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:72
|
||||
@ -164,9 +126,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:74
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:81
|
||||
@ -174,24 +134,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:83
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:85
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-signal.md:87
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:89
|
||||
@ -199,9 +150,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:91
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `@signalbot:example.com`"
|
||||
" (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@signalbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:93
|
||||
@ -209,10 +158,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:95
|
||||
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)."
|
||||
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-signal.md:97
|
||||
@ -224,17 +170,11 @@ msgid "Method 1: automatically, by enabling Appservice Double Puppet"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:101
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-signal.md:103
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-signal.md:105
|
||||
@ -242,26 +182,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:107
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:109
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-signal.md:111
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:113
|
||||
msgid ""
|
||||
"make sure you don't log out the `Mautrix-Signal` device some time in the "
|
||||
"future, as that would break the Double Puppeting feature"
|
||||
msgid "make sure you don't log out the `Mautrix-Signal` device some time in the future, as that would break the Double Puppeting feature"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,48 +26,27 @@ msgid "Setting up Mautrix Slack bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:3
|
||||
msgid ""
|
||||
"**Note**: bridging to [Slack](https://slack.com/) can also happen via the"
|
||||
" [mx-puppet-slack](configuring-playbook-bridge-mx-puppet-slack.md) and "
|
||||
"[matrix-appservice-slack](configuring-playbook-bridge-appservice-"
|
||||
"slack.md) bridges supported by the playbook."
|
||||
msgid "**Note**: bridging to [Slack](https://slack.com/) can also happen via the [mx-puppet-slack](configuring-playbook-bridge-mx-puppet-slack.md) and [matrix-appservice-slack](configuring-playbook-bridge-appservice-slack.md) bridges supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:4
|
||||
msgid ""
|
||||
"For using as a Bot we recommend the [Appservice Slack](configuring-"
|
||||
"playbook-bridge-appservice-slack.md), because it supports plumbing. Note "
|
||||
"that it is not available for new installation unless you have already "
|
||||
"created a classic Slack application, because the creation of classic "
|
||||
"Slack applications, which this bridge makes use of, has been "
|
||||
"discontinued."
|
||||
msgid "For using as a Bot we recommend the [Appservice Slack](configuring-playbook-bridge-appservice-slack.md), because it supports plumbing. Note that it is not available for new installation unless you have already created a classic Slack application, because the creation of classic Slack applications, which this bridge makes use of, has been discontinued."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:5
|
||||
msgid ""
|
||||
"For personal use with a slack account we recommend the `mautrix-slack` "
|
||||
"bridge (the one being discussed here), because it is the most fully-"
|
||||
"featured and stable of the 3 Slack bridges supported by the playbook."
|
||||
msgid "For personal use with a slack account we recommend the `mautrix-slack` bridge (the one being discussed here), because it is the most fully-featured and stable of the 3 Slack bridges supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:7
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"slack](https://github.com/mautrix/slack) for you."
|
||||
msgid "The playbook can install and configure [mautrix-slack](https://github.com/mautrix/slack) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:9
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://docs.mau.fi/bridges/go/slack/index.html) to learn"
|
||||
" what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://docs.mau.fi/bridges/go/slack/index.html) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:11
|
||||
msgid ""
|
||||
"See the [features and "
|
||||
"roadmap](https://github.com/mautrix/slack/blob/main/ROADMAP.md) for more "
|
||||
"information."
|
||||
msgid "See the [features and roadmap](https://github.com/mautrix/slack/blob/main/ROADMAP.md) for more information."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:13
|
||||
@ -75,19 +54,11 @@ msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:15
|
||||
msgid ""
|
||||
"For using this bridge, you would need to authenticate by **providing your"
|
||||
" username and password** (legacy) or by using a **token login**. See more"
|
||||
" information in the "
|
||||
"[docs](https://docs.mau.fi/bridges/go/slack/authentication.html)."
|
||||
msgid "For using this bridge, you would need to authenticate by **providing your username and password** (legacy) or by using a **token login**. See more information in the [docs](https://docs.mau.fi/bridges/go/slack/authentication.html)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:17
|
||||
msgid ""
|
||||
"Note that neither of these methods are officially supported by Slack. "
|
||||
"[matrix-appservice-slack](configuring-playbook-bridge-appservice-"
|
||||
"slack.md) uses a Slack bot account which is the only officially supported"
|
||||
" method for bridging a Slack channel."
|
||||
msgid "Note that neither of these methods are officially supported by Slack. [matrix-appservice-slack](configuring-playbook-bridge-appservice-slack.md) uses a Slack bot account which is the only officially supported method for bridging a Slack channel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:19
|
||||
@ -95,18 +66,11 @@ msgid "Enable Appservice Double Puppet (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:21
|
||||
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) service for this playbook."
|
||||
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) service for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:23
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-slack.md:25
|
||||
@ -114,16 +78,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:27
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-slack.md:33
|
||||
msgid ""
|
||||
"You may optionally wish to add some [Additional configuration"
|
||||
"](#additional-configuration), or to [prepare for double-puppeting](#set-"
|
||||
"up-double-puppeting) before the initial installation."
|
||||
msgid "You may optionally wish to add some [Additional configuration](#additional-configuration), or to [prepare for double-puppeting](#set-up-double-puppeting) before the initial installation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:35
|
||||
@ -131,9 +90,7 @@ msgid "Additional configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:37
|
||||
msgid ""
|
||||
"There are some additional options you may wish to configure with the "
|
||||
"bridge."
|
||||
msgid "There are some additional options you may wish to configure with the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:39
|
||||
@ -141,17 +98,11 @@ msgid "Take a look at:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:41
|
||||
msgid ""
|
||||
"`roles/custom/matrix-bridge-mautrix-slack/defaults/main.yml` for some "
|
||||
"variables that you can customize via your `vars.yml` file"
|
||||
msgid "`roles/custom/matrix-bridge-mautrix-slack/defaults/main.yml` for some variables that you can customize via your `vars.yml` file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:42
|
||||
msgid ""
|
||||
"`roles/custom/matrix-bridge-mautrix-slack/templates/config.yaml.j2` for "
|
||||
"the bridge's default configuration. You can override settings (even those"
|
||||
" that don't have dedicated playbook variables) using the "
|
||||
"`matrix_mautrix_slack_configuration_extension_yaml` variable"
|
||||
msgid "`roles/custom/matrix-bridge-mautrix-slack/templates/config.yaml.j2` for the bridge's default configuration. You can override settings (even those that don't have dedicated playbook variables) using the `matrix_mautrix_slack_configuration_extension_yaml` variable"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:44
|
||||
@ -159,9 +110,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:46
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:53
|
||||
@ -169,24 +118,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:55
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:57
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-slack.md:59
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:61
|
||||
@ -194,36 +134,23 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:63
|
||||
msgid ""
|
||||
"Start a chat with `@slackbot:example.com` (where `example.com` is your "
|
||||
"base domain, not the `matrix.` domain)."
|
||||
msgid "Start a chat with `@slackbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:64
|
||||
msgid ""
|
||||
"If you would like to login to Slack using a token, send the `login-token`"
|
||||
" command, otherwise, send the `login-password` command. Read "
|
||||
"[here](https://docs.mau.fi/bridges/go/slack/authentication.html) on how "
|
||||
"to retrieve your token and cookie token."
|
||||
msgid "If you would like to login to Slack using a token, send the `login-token` command, otherwise, send the `login-password` command. Read [here](https://docs.mau.fi/bridges/go/slack/authentication.html) on how to retrieve your token and cookie token."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:65
|
||||
msgid ""
|
||||
"The bot should respond with \"Successfully logged into <email> for team "
|
||||
"<workspace>\""
|
||||
msgid "The bot should respond with \"Successfully logged into <email> for team <workspace>\""
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:66
|
||||
msgid ""
|
||||
"Now that you're logged in, you can send a `help` command to the bot "
|
||||
"again, to see additional commands you have access to."
|
||||
msgid "Now that you're logged in, you can send a `help` command to the bot again, to see additional commands you have access to."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:67
|
||||
msgid ""
|
||||
"Slack channels should automatically begin bridging if you authenticated "
|
||||
"using a token. Otherwise, you must wait to receive a message in the "
|
||||
"channel if you used password authentication."
|
||||
msgid "Slack channels should automatically begin bridging if you authenticated using a token. Otherwise, you must wait to receive a message in the channel if you used password authentication."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:69
|
||||
@ -231,10 +158,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:71
|
||||
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)."
|
||||
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-slack.md:73
|
||||
@ -246,17 +170,11 @@ msgid "Method 1: automatically, by enabling Appservice Double Puppet"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:77
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-slack.md:79
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-slack.md:81
|
||||
@ -264,26 +182,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:83
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:85
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-slack.md:87
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:89
|
||||
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"
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,16 +26,11 @@ msgid "Setting up Mautrix Telegram bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"telegram](https://github.com/mautrix/telegram) for you."
|
||||
msgid "The playbook can install and configure [mautrix-telegram](https://github.com/mautrix/telegram) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:5
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://docs.mau.fi/bridges/python/telegram/index.html) "
|
||||
"to learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://docs.mau.fi/bridges/python/telegram/index.html) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:7
|
||||
@ -43,19 +38,11 @@ msgid "Prerequisite (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:9
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:11
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-telegram.md:13
|
||||
@ -63,11 +50,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:15
|
||||
msgid ""
|
||||
"You'll need to obtain API keys from "
|
||||
"[https://my.telegram.org/apps](https://my.telegram.org/apps) and then add"
|
||||
" the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "You'll need to obtain API keys from [https://my.telegram.org/apps](https://my.telegram.org/apps) and then add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:23
|
||||
@ -75,9 +58,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:25
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:32
|
||||
@ -85,24 +66,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:34
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:36
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-telegram.md:38
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:40
|
||||
@ -110,19 +82,11 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:42
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@telegrambot:example.com` (where `example.com` is your base domain, not "
|
||||
"the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@telegrambot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:44
|
||||
msgid ""
|
||||
"If you want to use the relay-bot feature ([relay bot "
|
||||
"documentation](https://docs.mau.fi/bridges/python/telegram/relay-"
|
||||
"bot.html)), which allows anonymous user to chat with telegram users, add "
|
||||
"the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "If you want to use the relay-bot feature ([relay bot documentation](https://docs.mau.fi/bridges/python/telegram/relay-bot.html)), which allows anonymous user to chat with telegram users, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:54
|
||||
@ -130,17 +94,11 @@ msgid "You might also want to give permissions to administrate the bot:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:63
|
||||
msgid ""
|
||||
"More details about permissions in this example: "
|
||||
"https://github.com/mautrix/telegram/blob/master/mautrix_telegram/example-"
|
||||
"config.yaml#L410"
|
||||
msgid "More details about permissions in this example: https://github.com/mautrix/telegram/blob/master/mautrix_telegram/example-config.yaml#L410"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:65
|
||||
msgid ""
|
||||
"If you like to exclude all groups from syncing and use the Telgeram-"
|
||||
"Bridge only for direct chats, you can add the following additional "
|
||||
"playbook configuration:"
|
||||
msgid "If you like to exclude all groups from syncing and use the Telgeram-Bridge only for direct chats, you can add the following additional playbook configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:71
|
||||
@ -148,10 +106,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:73
|
||||
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)."
|
||||
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-telegram.md:75
|
||||
@ -159,32 +114,19 @@ msgid "To set it up, you have 2 ways of going about it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:77
|
||||
msgid ""
|
||||
"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
|
||||
"Secret Auth"
|
||||
msgid "Method 1: automatically, by enabling Appservice Double Puppet or Shared Secret Auth"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:79
|
||||
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 "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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:81
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:83
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:85
|
||||
@ -192,32 +134,21 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:87
|
||||
msgid ""
|
||||
"**Note**: This method for enabling Double Puppeting can be configured "
|
||||
"only after you've already set up bridging."
|
||||
msgid "**Note**: This method for enabling Double Puppeting can be configured only after you've already set up bridging."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:89
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:91
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-telegram.md:93
|
||||
msgid ""
|
||||
"send `login-matrix` to the bot and follow instructions about how to send "
|
||||
"the access token to it"
|
||||
msgid "send `login-matrix` to the bot and follow instructions about how to send the access token to it"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:95
|
||||
msgid ""
|
||||
"make sure you don't log out the `Mautrix-Telegram` device some time in "
|
||||
"the future, as that would break the Double Puppeting feature"
|
||||
msgid "make sure you don't log out the `Mautrix-Telegram` device some time in the future, as that would break the Double Puppeting feature"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,23 +26,15 @@ msgid "Setting up Mautrix Twitter bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:3
|
||||
msgid ""
|
||||
"**Note**: bridging to [Twitter](https://twitter.com/) can also happen via"
|
||||
" the [mx-puppet-twitter](configuring-playbook-bridge-mx-puppet-"
|
||||
"twitter.md) bridge supported by the playbook."
|
||||
msgid "**Note**: bridging to [Twitter](https://twitter.com/) can also happen via the [mx-puppet-twitter](configuring-playbook-bridge-mx-puppet-twitter.md) bridge supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"twitter](https://github.com/mautrix/twitter) for you."
|
||||
msgid "The playbook can install and configure [mautrix-twitter](https://github.com/mautrix/twitter) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:7
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -54,18 +46,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) service for this playbook."
|
||||
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) service for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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)"
|
||||
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:17
|
||||
@ -73,9 +58,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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:"
|
||||
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:25
|
||||
@ -83,9 +66,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:27
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:34
|
||||
@ -93,24 +74,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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."
|
||||
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:38
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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:40
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:42
|
||||
@ -118,22 +90,15 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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)."
|
||||
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:45
|
||||
msgid ""
|
||||
"Send login-cookie to start the login. The bot should respond with "
|
||||
"instructions on how to proceed."
|
||||
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: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)."
|
||||
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:49
|
||||
@ -141,10 +106,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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)."
|
||||
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:53
|
||||
@ -156,17 +118,11 @@ msgid "Method 1: automatically, by enabling Appservice Double Puppet"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:57
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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 ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -174,89 +130,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:63
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "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)."
|
||||
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`"
|
||||
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"
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,16 +26,11 @@ msgid "Setting up Mautrix Whatsapp bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"whatsapp](https://github.com/mautrix/whatsapp) for you."
|
||||
msgid "The playbook can install and configure [mautrix-whatsapp](https://github.com/mautrix/whatsapp) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:5
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://docs.mau.fi/bridges/go/whatsapp/index.html) to "
|
||||
"learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://docs.mau.fi/bridges/go/whatsapp/index.html) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:7
|
||||
@ -43,19 +38,11 @@ msgid "Prerequisite (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:9
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:11
|
||||
msgid ""
|
||||
"For details about configuring Double Puppeting for this bridge, see the "
|
||||
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
|
||||
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-whatsapp.md:13
|
||||
@ -63,34 +50,23 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:15
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-whatsapp.md:21
|
||||
msgid ""
|
||||
"Whatsapp multidevice beta is required, now it is enough if Whatsapp is "
|
||||
"connected to the Internet every 2 weeks."
|
||||
msgid "Whatsapp multidevice beta is required, now it is enough if Whatsapp is connected to the Internet every 2 weeks."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:23
|
||||
msgid ""
|
||||
"The relay bot functionality is off by default. If you would like to "
|
||||
"enable the relay bot, add the following to your `vars.yml` file:"
|
||||
msgid "The relay bot functionality is off by default. If you would like to enable the relay bot, add the following to your `vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:29
|
||||
msgid ""
|
||||
"By default, only admins are allowed to set themselves as relay users. To "
|
||||
"allow anyone on your homeserver to set themselves as relay users add this"
|
||||
" to your `vars.yml` file:"
|
||||
msgid "By default, only admins are allowed to set themselves as relay users. To allow anyone on your homeserver to set themselves as relay users add this to your `vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:35
|
||||
msgid ""
|
||||
"If you want to activate the relay bot in a room, send `!wa set-relay`. To"
|
||||
" deactivate, send `!wa unset-relay`."
|
||||
msgid "If you want to activate the relay bot in a room, send `!wa set-relay`. To deactivate, send `!wa unset-relay`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:37
|
||||
@ -98,9 +74,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:39
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:46
|
||||
@ -108,24 +82,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:48
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:50
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-whatsapp.md:52
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:54
|
||||
@ -133,10 +98,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:56
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@whatsappbot:example.com` (where `example.com` is your base domain, not "
|
||||
"the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@whatsappbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:58
|
||||
@ -144,10 +106,7 @@ msgid "💡 Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:60
|
||||
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)."
|
||||
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-whatsapp.md:62
|
||||
@ -155,32 +114,19 @@ msgid "To set it up, you have 2 ways of going about it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:64
|
||||
msgid ""
|
||||
"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
|
||||
"Secret Auth"
|
||||
msgid "Method 1: automatically, by enabling Appservice Double Puppet or Shared Secret Auth"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:66
|
||||
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 "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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:68
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:70
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:72
|
||||
@ -188,26 +134,17 @@ msgid "Method 2: manually, by asking each user to provide a working access token
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:74
|
||||
msgid ""
|
||||
"When using this method, **each user** that wishes to enable Double "
|
||||
"Puppeting needs to follow the following steps:"
|
||||
msgid "When using this method, **each user** that wishes to enable Double Puppeting needs to follow the following steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:76
|
||||
msgid ""
|
||||
"retrieve a Matrix access token for yourself. Refer to the documentation "
|
||||
"on [how to do that](obtaining-access-tokens.md)."
|
||||
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-whatsapp.md:78
|
||||
msgid ""
|
||||
"send the access token to the bot. Example: `login-matrix "
|
||||
"MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgid "send the access token to the bot. Example: `login-matrix MATRIX_ACCESS_TOKEN_HERE`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:80
|
||||
msgid ""
|
||||
"make sure you don't log out the `Mautrix-Whatsapp` device some time in "
|
||||
"the future, as that would break the Double Puppeting feature"
|
||||
msgid "make sure you don't log out the `Mautrix-Whatsapp` device some time in the future, as that would break the Double Puppeting feature"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -22,22 +22,15 @@ msgstr ""
|
||||
"Generated-By: Babel 2.16.0\n"
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:1
|
||||
msgid ""
|
||||
"Setting up Mautrix wsproxy for bridging Android SMS or Apple iMessage "
|
||||
"(optional)"
|
||||
msgid "Setting up Mautrix wsproxy for bridging Android SMS or Apple iMessage (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [mautrix-"
|
||||
"wsproxy](https://github.com/mautrix/wsproxy) for you."
|
||||
msgid "The playbook can install and configure [mautrix-wsproxy](https://github.com/mautrix/wsproxy) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:5
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://github.com/mautrix/wsproxy/blob/master/README.md)"
|
||||
" to learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [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
|
||||
@ -45,16 +38,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:9
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-wsproxy.md:21
|
||||
msgid ""
|
||||
"Note that the tokens must match what is compiled into the [mautrix-"
|
||||
"imessage](https://github.com/mautrix/imessage) bridge running on your Mac"
|
||||
" or Android device."
|
||||
msgid "Note that the tokens must match what is compiled into the [mautrix-imessage](https://github.com/mautrix/imessage) bridge running on your Mac or Android device."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:23
|
||||
@ -62,23 +50,15 @@ msgid "Adjusting the wsproxy URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:25
|
||||
msgid ""
|
||||
"By default, this playbook installs wsproxy on the `wsproxy.` subdomain "
|
||||
"(`wsproxy.example.com`) and requires you to [adjust your DNS records"
|
||||
"](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs wsproxy on the `wsproxy.` subdomain (`wsproxy.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:27
|
||||
msgid ""
|
||||
"By tweaking the `matrix_mautrix_wsproxy_hostname` variable, you can "
|
||||
"easily make the service available at a **different hostname** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_mautrix_wsproxy_hostname` variable, you can easily make the service available at a **different hostname** than the default one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:29
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:36
|
||||
@ -86,15 +66,11 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:38
|
||||
msgid ""
|
||||
"Once you've decided on the domain, **you may need to adjust your DNS** "
|
||||
"records to point the wsproxy domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain, **you may need to adjust your DNS** records to point the wsproxy domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:40
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `wsproxy`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `wsproxy`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:42
|
||||
@ -102,10 +78,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:44
|
||||
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:"
|
||||
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-bridge-mautrix-wsproxy.md:51
|
||||
@ -113,24 +86,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:53
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:55
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-wsproxy.md:57
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:59
|
||||
@ -138,16 +102,5 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:61
|
||||
msgid ""
|
||||
"Follow the [matrix-imessage "
|
||||
"documenation](https://docs.mau.fi/bridges/go/imessage/index.html) for "
|
||||
"running `android-sms` and/or `matrix-imessage` on your device(s)."
|
||||
msgid "Follow the [matrix-imessage documenation](https://docs.mau.fi/bridges/go/imessage/index.html) for 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 ""
|
||||
|
||||
|
||||
@ -26,38 +26,23 @@ msgid "Setting up MX Puppet Discord bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:3
|
||||
msgid ""
|
||||
"**Note**: bridging to [Discord](https://discordapp.com/) can also happen "
|
||||
"via the [matrix-appservice-discord](configuring-playbook-bridge-"
|
||||
"appservice-discord.md)and [mautrix-discord](configuring-playbook-bridge-"
|
||||
"mautrix-discord.md) bridges supported by the playbook."
|
||||
msgid "**Note**: bridging to [Discord](https://discordapp.com/) can also happen via the [matrix-appservice-discord](configuring-playbook-bridge-appservice-discord.md)and [mautrix-discord](configuring-playbook-bridge-mautrix-discord.md) bridges supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:4
|
||||
msgid ""
|
||||
"For using as a Bot we recommend the [Appservice Discord](configuring-"
|
||||
"playbook-bridge-appservice-discord.md), because it supports plumbing."
|
||||
msgid "For using as a Bot we recommend the [Appservice Discord](configuring-playbook-bridge-appservice-discord.md), because it supports plumbing."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:5
|
||||
msgid ""
|
||||
"For personal use with a discord account we recommend the [mautrix-discord"
|
||||
"](configuring-playbook-bridge-mautrix-discord.md) bridge, because it is "
|
||||
"the most fully-featured and stable of the 3 Discord bridges supported by "
|
||||
"the playbook."
|
||||
msgid "For personal use with a discord account we recommend the [mautrix-discord](configuring-playbook-bridge-mautrix-discord.md) bridge, because it is the most fully-featured and stable of the 3 Discord bridges supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:7
|
||||
msgid ""
|
||||
"The playbook can install and configure [mx-puppet-"
|
||||
"discord](https://gitlab.com/mx-puppet/discord/mx-puppet-discord) for you."
|
||||
msgid "The playbook can install and configure [mx-puppet-discord](https://gitlab.com/mx-puppet/discord/mx-puppet-discord) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:9
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -65,10 +50,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:13
|
||||
msgid ""
|
||||
"To enable the [Discord](https://discordapp.com/) bridge, add the "
|
||||
"following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable the [Discord](https://discordapp.com/) bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:19
|
||||
@ -76,9 +58,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:21
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:28
|
||||
@ -86,24 +66,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:30
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:32
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-mx-puppet-discord.md:34
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:36
|
||||
@ -111,18 +82,11 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:38
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `Discord Puppet Bridge` "
|
||||
"with the handle `@_discordpuppet_bot:example.com` (where `example.com` is"
|
||||
" your base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `Discord Puppet Bridge` with the handle `@_discordpuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:40
|
||||
msgid ""
|
||||
"Three authentication methods are available, Legacy Token, OAuth and xoxc "
|
||||
"token. See mx-puppet-discord [documentation](https://gitlab.com/mx-"
|
||||
"puppet/discord/mx-puppet-discord) for more information about how to "
|
||||
"configure the bridge."
|
||||
msgid "Three authentication methods are available, Legacy Token, OAuth and xoxc token. See mx-puppet-discord [documentation](https://gitlab.com/mx-puppet/discord/mx-puppet-discord) for more information about how to configure the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:42
|
||||
@ -130,18 +94,9 @@ msgid "Once logged in, send `list` to the bot user to list the available rooms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:44
|
||||
msgid ""
|
||||
"Clicking rooms in the list will result in you receiving an invitation to "
|
||||
"the bridged room."
|
||||
msgid "Clicking rooms in the list will result in you receiving an invitation to the bridged room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:46
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,17 +26,11 @@ msgid "Setting up MX Puppet GroupMe bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [mx-puppet-"
|
||||
"groupme](https://gitlab.com/xangelix-pub/matrix/mx-puppet-groupme) for "
|
||||
"you."
|
||||
msgid "The playbook can install and configure [mx-puppet-groupme](https://gitlab.com/xangelix-pub/matrix/mx-puppet-groupme) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -44,10 +38,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:9
|
||||
msgid ""
|
||||
"To enable the [GroupMe](https://groupme.com/) bridge, add the following "
|
||||
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"file:"
|
||||
msgid "To enable the [GroupMe](https://groupme.com/) bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:15
|
||||
@ -55,9 +46,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:17
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:24
|
||||
@ -65,24 +54,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:26
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:28
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-mx-puppet-groupme.md:30
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:32
|
||||
@ -90,10 +70,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:34
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `GroupMe Puppet Bridge` "
|
||||
"with the handle `@_groupmepuppet_bot:example.com` (where `example.com` is"
|
||||
" your base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `GroupMe Puppet Bridge` with the handle `@_groupmepuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:36
|
||||
@ -101,31 +78,17 @@ msgid "One authentication method is available."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:38
|
||||
msgid ""
|
||||
"To link your GroupMe account, go to "
|
||||
"[dev.groupme.com](https://dev.groupme.com/), sign in, and select \"Access"
|
||||
" Token\" from the top menu. Copy the token and message the bridge with:"
|
||||
msgid "To link your GroupMe account, go to [dev.groupme.com](https://dev.groupme.com/), sign in, and select \"Access Token\" from the top menu. Copy the token and message the bridge with:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:44
|
||||
msgid ""
|
||||
"Once logged in, send `listrooms` to the bot user to list the available "
|
||||
"rooms."
|
||||
msgid "Once logged in, send `listrooms` to the bot user to list the available rooms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:46
|
||||
msgid ""
|
||||
"Clicking rooms in the list will result in you receiving an invitation to "
|
||||
"the bridged room."
|
||||
msgid "Clicking rooms in the list will result in you receiving an invitation to the bridged room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:48
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,9 +26,7 @@ msgid "Setting up MX Puppet Instagram bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [mx-puppet-"
|
||||
"instagram](https://github.com/Sorunome/mx-puppet-instagram) for you."
|
||||
msgid "The playbook can install and configure [mx-puppet-instagram](https://github.com/Sorunome/mx-puppet-instagram) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:5
|
||||
@ -40,10 +38,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:9
|
||||
msgid ""
|
||||
"To enable the [Instagram](https://www.instagram.com/) bridge, add the "
|
||||
"following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable the [Instagram](https://www.instagram.com/) bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:15
|
||||
@ -51,9 +46,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:17
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:24
|
||||
@ -61,24 +54,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:26
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:28
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-mx-puppet-instagram.md:30
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:32
|
||||
@ -86,22 +70,15 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:34
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `Instagram Puppet "
|
||||
"Bridge` with the handle `@_instagrampuppet_bot:example.com` (where "
|
||||
"`example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `Instagram Puppet Bridge` with the handle `@_instagrampuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:36
|
||||
msgid ""
|
||||
"Send `link <username> <password>` to the bridge bot to link your "
|
||||
"instagram account."
|
||||
msgid "Send `link <username> <password>` to the bridge bot to link your instagram account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:38
|
||||
msgid ""
|
||||
"The `list` commands shows which accounts are linked and which `puppetId` "
|
||||
"is associated."
|
||||
msgid "The `list` commands shows which accounts are linked and which `puppetId` is associated."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:40
|
||||
@ -109,9 +86,7 @@ msgid "For double-puppeting, you probably want to issue these commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:42
|
||||
msgid ""
|
||||
"`settype $puppetId puppet` to enable puppeting for the link (instead of "
|
||||
"relaying)"
|
||||
msgid "`settype $puppetId puppet` to enable puppeting for the link (instead of relaying)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:43
|
||||
@ -119,20 +94,13 @@ msgid "`setautoinvite $puppetId 1` to automatically invite you to chats"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:44
|
||||
msgid ""
|
||||
"`setmatrixtoken $accessToken` to set the access token to enable puppeting"
|
||||
" from the other side (the \"double\" in double puppeting)"
|
||||
msgid "`setmatrixtoken $accessToken` to set the access token to enable puppeting from the other side (the \"double\" in double puppeting)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:46
|
||||
msgid ""
|
||||
"If you are linking only one Instagram account, your `$puppetId` is "
|
||||
"probably 1, but use the `list` command find out."
|
||||
msgid "If you are linking only one Instagram account, your `$puppetId` is probably 1, but use the `list` command find out."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:48
|
||||
msgid ""
|
||||
"The `help` command shows which commands are available, though at the time"
|
||||
" of writing, not every command is fully implemented."
|
||||
msgid "The `help` command shows which commands are available, though at the time of writing, not every command is fully implemented."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,17 +26,9 @@ msgid "Setting up MX Puppet Skype bridging (optional, removed)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-skype.md:3
|
||||
msgid ""
|
||||
"The playbook used to be able to install and configure [mx-puppet-"
|
||||
"skype](https://github.com/Sorunome/mx-puppet-skype), but no longer "
|
||||
"includes this component, because it has been broken and unmaintained for "
|
||||
"a long time."
|
||||
msgid "The playbook used to be able to install and configure [mx-puppet-skype](https://github.com/Sorunome/mx-puppet-skype), but no longer includes this component, because it has been broken and unmaintained for a long time."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-skype.md:5
|
||||
msgid ""
|
||||
"Bridging to [Skype](https://www.skype.com/) can also happen via the [go-"
|
||||
"skype-bridge](configuring-playbook-bridge-go-skype-bridge.md) bridge "
|
||||
"supported by the playbook."
|
||||
msgid "Bridging to [Skype](https://www.skype.com/) can also happen via the [go-skype-bridge](configuring-playbook-bridge-go-skype-bridge.md) bridge supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -22,28 +22,15 @@ msgid "Setting up MX Puppet Slack bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:3
|
||||
msgid ""
|
||||
"**Note**: bridging to [Slack](https://slack.com) can also happen via the "
|
||||
"[matrix-appservice-slack](configuring-playbook-bridge-appservice-"
|
||||
"slack.md) and [mautrix-slack](configuring-playbook-bridge-mautrix-"
|
||||
"slack.md) bridges supported by the playbook. Note that `matrix-"
|
||||
"appservice-slack` is not available for new installation unless you have "
|
||||
"already created a classic Slack application, because the creation of "
|
||||
"classic Slack applications, which this bridge makes use of, has been "
|
||||
"discontinued."
|
||||
msgid "**Note**: bridging to [Slack](https://slack.com) can also happen via the [matrix-appservice-slack](configuring-playbook-bridge-appservice-slack.md) and [mautrix-slack](configuring-playbook-bridge-mautrix-slack.md) bridges supported by the playbook. Note that `matrix-appservice-slack` is not available for new installation unless you have already created a classic Slack application, because the creation of classic Slack applications, which this bridge makes use of, has been discontinued."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure [mx-puppet-"
|
||||
"slack](https://gitlab.com/mx-puppet/slack/mx-puppet-slack) for you."
|
||||
msgid "The playbook can install and configure [mx-puppet-slack](https://gitlab.com/mx-puppet/slack/mx-puppet-slack) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:7
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -51,10 +38,7 @@ msgid "Prerequisite"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:11
|
||||
msgid ""
|
||||
"Follow the [OAuth credentials](https://gitlab.com/mx-puppet/slack/mx-"
|
||||
"puppet-slack#option-2-oauth) instructions to create a new Slack app, "
|
||||
"setting the redirect URL to `https://matrix.example.com/slack/oauth`."
|
||||
msgid "Follow the [OAuth credentials](https://gitlab.com/mx-puppet/slack/mx-puppet-slack#option-2-oauth) instructions to create a new Slack app, setting the redirect URL to `https://matrix.example.com/slack/oauth`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:13
|
||||
@ -62,10 +46,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:15
|
||||
msgid ""
|
||||
"To enable the [Slack](https://slack.com/) bridge, add the following "
|
||||
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"file:"
|
||||
msgid "To enable the [Slack](https://slack.com/) bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:24
|
||||
@ -73,9 +54,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:26
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:33
|
||||
@ -83,24 +62,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:35
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:37
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-mx-puppet-slack.md:39
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:41
|
||||
@ -108,18 +78,11 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:43
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `Slack Puppet Bridge` "
|
||||
"with the handle `@_slackpuppet_bot:example.com` (where `example.com` is "
|
||||
"your base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `Slack Puppet Bridge` with the handle `@_slackpuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:45
|
||||
msgid ""
|
||||
"Three authentication methods are available, Legacy Token, OAuth and xoxc "
|
||||
"token. See mx-puppet-slack [documentation](https://gitlab.com/mx-"
|
||||
"puppet/slack/mx-puppet-slack) for more information about how to configure"
|
||||
" the bridge."
|
||||
msgid "Three authentication methods are available, Legacy Token, OAuth and xoxc token. See mx-puppet-slack [documentation](https://gitlab.com/mx-puppet/slack/mx-puppet-slack) for more information about how to configure the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:47
|
||||
@ -127,18 +90,9 @@ msgid "Once logged in, send `list` to the bot user to list the available rooms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:49
|
||||
msgid ""
|
||||
"Clicking rooms in the list will result in you receiving an invitation to "
|
||||
"the bridged room."
|
||||
msgid "Clicking rooms in the list will result in you receiving an invitation to the bridged room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:51
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,16 +26,11 @@ msgid "Setting up MX Puppet Steam bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [mx-puppet-"
|
||||
"steam](https://github.com/icewind1991/mx-puppet-steam) for you."
|
||||
msgid "The playbook can install and configure [mx-puppet-steam](https://github.com/icewind1991/mx-puppet-steam) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -43,10 +38,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:9
|
||||
msgid ""
|
||||
"To enable the [Steam](https://steampowered.com/) bridge, add the "
|
||||
"following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable the [Steam](https://steampowered.com/) bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:15
|
||||
@ -54,9 +46,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:17
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:24
|
||||
@ -64,24 +54,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:26
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:28
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-mx-puppet-steam.md:30
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:32
|
||||
@ -89,17 +70,11 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:34
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `Steam Puppet Bridge` "
|
||||
"with the handle `@_steampuppet_bot:example.com` (where `example.com` is "
|
||||
"your base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `Steam Puppet Bridge` with the handle `@_steampuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:36
|
||||
msgid ""
|
||||
"Three authentication methods are available, Legacy Token, OAuth and xoxc "
|
||||
"token. See mx-puppet-steam [documentation](https://github.com/icewind1991"
|
||||
"/mx-puppet-steam) for more information about how to configure the bridge."
|
||||
msgid "Three authentication methods are available, Legacy Token, OAuth and xoxc token. See mx-puppet-steam [documentation](https://github.com/icewind1991/mx-puppet-steam) for more information about how to configure the bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:38
|
||||
@ -107,18 +82,9 @@ msgid "Once logged in, send `list` to the bot user to list the available rooms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:40
|
||||
msgid ""
|
||||
"Clicking rooms in the list will result in you receiving an invitation to "
|
||||
"the bridged room."
|
||||
msgid "Clicking rooms in the list will result in you receiving an invitation to the bridged room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:42
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,23 +26,15 @@ msgid "Setting up MX Puppet Twitter bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:3
|
||||
msgid ""
|
||||
"**Note**: bridging to [Twitter](https://twitter.com/) can also happen via"
|
||||
" the [mautrix-twitter](configuring-playbook-bridge-mautrix-twitter.md) "
|
||||
"bridge supported by the playbook."
|
||||
msgid "**Note**: bridging to [Twitter](https://twitter.com/) can also happen via the [mautrix-twitter](configuring-playbook-bridge-mautrix-twitter.md) bridge supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure [mx-puppet-"
|
||||
"twitter](https://github.com/Sorunome/mx-puppet-twitter) for you."
|
||||
msgid "The playbook can install and configure [mx-puppet-twitter](https://github.com/Sorunome/mx-puppet-twitter) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:7
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -50,9 +42,7 @@ msgid "Prerequisite"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:11
|
||||
msgid ""
|
||||
"Make an app on "
|
||||
"[developer.twitter.com](https://developer.twitter.com/en/apps)."
|
||||
msgid "Make an app on [developer.twitter.com](https://developer.twitter.com/en/apps)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:13
|
||||
@ -60,10 +50,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:15
|
||||
msgid ""
|
||||
"To enable the [Twitter](https://twitter.com) bridge, add the following "
|
||||
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"file:"
|
||||
msgid "To enable the [Twitter](https://twitter.com) bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:26
|
||||
@ -71,9 +58,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:28
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:35
|
||||
@ -81,24 +66,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:37
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:39
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-mx-puppet-twitter.md:41
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:43
|
||||
@ -106,10 +82,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:45
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with `Twitter Puppet Bridge` "
|
||||
"with the handle `@_twitterpuppet_bot:example.com` (where `example.com` is"
|
||||
" your base domain, not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `Twitter Puppet Bridge` with the handle `@_twitterpuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:47
|
||||
@ -121,18 +94,9 @@ msgid "Once logged in, send `list` to the bot user to list the available rooms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:51
|
||||
msgid ""
|
||||
"Clicking rooms in the list will result in you receiving an invitation to "
|
||||
"the bridged room."
|
||||
msgid "Clicking rooms in the list will result in you receiving an invitation to the bridged room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:53
|
||||
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 ""
|
||||
|
||||
|
||||
@ -22,29 +22,19 @@ msgid "Setting up Postmoogle email bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:3
|
||||
msgid ""
|
||||
"**Note**: email bridging can also happen via the [email2matrix"
|
||||
"](configuring-playbook-email2matrix.md) bridge supported by the playbook."
|
||||
msgid "**Note**: email bridging can also happen via the [email2matrix](configuring-playbook-email2matrix.md) bridge supported by the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure "
|
||||
"[Postmoogle](https://github.com/etkecc/postmoogle) for you."
|
||||
msgid "The playbook can install and configure [Postmoogle](https://github.com/etkecc/postmoogle) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:7
|
||||
msgid ""
|
||||
"Postmoogle is a bridge you can use to have its bot user forward emails to"
|
||||
" Matrix rooms. It runs an SMTP email server and allows you to assign "
|
||||
"mailbox addresses to the rooms."
|
||||
msgid "Postmoogle is a bridge you can use to have its bot user forward emails to Matrix rooms. It runs an SMTP email server and allows you to assign mailbox addresses to the rooms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:9
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -52,9 +42,7 @@ msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:13
|
||||
msgid ""
|
||||
"Open the following ports on your server to be able to receive incoming "
|
||||
"emails:"
|
||||
msgid "Open the following ports on your server to be able to receive incoming emails:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:15
|
||||
@ -66,18 +54,11 @@ msgid "`587/tcp`: Submission (TLS-encrypted SMTP)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:18
|
||||
msgid ""
|
||||
"If you don't open these ports, you will still be able to send emails, but"
|
||||
" not receive any."
|
||||
msgid "If you don't open these ports, you will still be able to send emails, but not receive any."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:20
|
||||
msgid ""
|
||||
"These port numbers are configurable via the "
|
||||
"`matrix_postmoogle_smtp_host_bind_port` and "
|
||||
"`matrix_postmoogle_submission_host_bind_port` variables, but other email "
|
||||
"servers will try to deliver on these default (standard) ports, so "
|
||||
"changing them is of little use."
|
||||
msgid "These port numbers are configurable via the `matrix_postmoogle_smtp_host_bind_port` and `matrix_postmoogle_submission_host_bind_port` variables, but other email servers will try to deliver on these default (standard) ports, so changing them is of little use."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:22
|
||||
@ -85,9 +66,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:24
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:45
|
||||
@ -95,10 +74,7 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:47
|
||||
msgid ""
|
||||
"You will also need to add several DNS records so that Postmoogle can send"
|
||||
" emails. See [Configuring DNS](configuring-dns.md) for details about DNS "
|
||||
"changes."
|
||||
msgid "You will also need to add several DNS records so that Postmoogle can send emails. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:49
|
||||
@ -106,9 +82,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:51
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:58
|
||||
@ -116,34 +90,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:60
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create a user account of the bridge's bot."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create a user account of the bridge's bot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:62
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-postmoogle.md:64
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:66
|
||||
msgid ""
|
||||
"If you change the bridge's bot password (`matrix_postmoogle_password` in "
|
||||
"your `vars.yml` file) subsequently, the bot user's credentials on the "
|
||||
"homeserver won't be updated automatically. If you'd like to change the "
|
||||
"bot user's password, use a tool like [synapse-admin](configuring-"
|
||||
"playbook-synapse-admin.md) to change it, and then update "
|
||||
"`matrix_postmoogle_password` to let the bot know its new password."
|
||||
msgid "If you change the bridge's bot password (`matrix_postmoogle_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_postmoogle_password` to let the bot know its new password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:68
|
||||
@ -151,28 +110,19 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:70
|
||||
msgid ""
|
||||
"To use the bridge, invite the `@postmoogle:example.com` bot user into a "
|
||||
"room you want to use as a mailbox."
|
||||
msgid "To use the bridge, invite the `@postmoogle:example.com` bot user into a room you want to use as a mailbox."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:72
|
||||
msgid ""
|
||||
"Then send `!pm mailbox NAME` to expose this Matrix room as an inbox with "
|
||||
"the email address `NAME@matrix.example.com`. Emails sent to that email "
|
||||
"address will be forwarded to the room."
|
||||
msgid "Then send `!pm mailbox NAME` to expose this Matrix room as an inbox with the email address `NAME@matrix.example.com`. Emails sent to that email address will be forwarded to the room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:74
|
||||
msgid ""
|
||||
"Send `!pm help` to the room to see the bridge's help menu for additional "
|
||||
"commands."
|
||||
msgid "Send `!pm help` to the room to see the bridge's help menu for additional commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:76
|
||||
msgid ""
|
||||
"You can also refer to the upstream "
|
||||
"[documentation](https://github.com/etkecc/postmoogle)."
|
||||
msgid "You can also refer to the upstream [documentation](https://github.com/etkecc/postmoogle)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:78
|
||||
@ -180,23 +130,9 @@ msgid "Debug/Logs"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:80
|
||||
msgid ""
|
||||
"As with all other services, you can find their logs in [systemd-"
|
||||
"journald](https://www.freedesktop.org/software/systemd/man/systemd-"
|
||||
"journald.service.html) by running something like `journalctl -fu matrix-"
|
||||
"postmoogle`"
|
||||
msgid "As with all other services, you can find their logs in [systemd-journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html) by running something like `journalctl -fu matrix-postmoogle`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:82
|
||||
msgid ""
|
||||
"The default logging level for this bridge is `INFO`, but you can increase"
|
||||
" it to `DEBUG` with the following additional configuration:"
|
||||
msgid "The default logging level for this bridge is `INFO`, but you can increase 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 ""
|
||||
|
||||
|
||||
@ -26,17 +26,11 @@ msgid "Setting up WeChat bridging (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-wechat.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [matrix-"
|
||||
"wechat](https://github.com/duo/matrix-wechat) bridge for you (for "
|
||||
"bridging to the [WeChat](https://www.wechat.com/) network)."
|
||||
msgid "The playbook can install and configure the [matrix-wechat](https://github.com/duo/matrix-wechat) bridge for you (for bridging to the [WeChat](https://www.wechat.com/) network)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-wechat.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -44,9 +38,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-wechat.md:9
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-wechat.md:15
|
||||
@ -54,9 +46,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-wechat.md:17
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-wechat.md:24
|
||||
@ -64,24 +54,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-wechat.md:26
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-wechat.md:28
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-wechat.md:30
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-wechat.md:32
|
||||
@ -89,18 +70,9 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-wechat.md:34
|
||||
msgid ""
|
||||
"Once the bridge is installed, start a chat with `@wechatbot:example.com` "
|
||||
"(where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgid "Once the bridge is installed, start a chat with `@wechatbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-bridge-wechat.md:36
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,41 +26,27 @@ msgid "Setting up Cactus Comments (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [Cactus "
|
||||
"Comments](https://cactus.chat) system for you."
|
||||
msgid "The playbook can install and configure the [Cactus Comments](https://cactus.chat) system for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:5
|
||||
msgid ""
|
||||
"Cactus Comments is a **federated comment system** built on Matrix. It "
|
||||
"respects your privacy, and puts you in control."
|
||||
msgid "Cactus Comments is a **federated comment system** built on Matrix. It respects your privacy, and puts you in control."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:7
|
||||
msgid ""
|
||||
"See the project's [documentation](https://cactus.chat/docs/getting-"
|
||||
"started/introduction/) to learn what it does and why it might be useful "
|
||||
"to you."
|
||||
msgid "See the project's [documentation](https://cactus.chat/docs/getting-started/introduction/) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:9
|
||||
msgid ""
|
||||
"The playbook contains 2 roles for configuring different pieces of the "
|
||||
"Cactus Comments system:"
|
||||
msgid "The playbook contains 2 roles for configuring different pieces of the Cactus Comments system:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:11
|
||||
msgid ""
|
||||
"`matrix-cactus-comments` - the backend appservice integrating with the "
|
||||
"Matrix homeserver"
|
||||
msgid "`matrix-cactus-comments` - the backend appservice integrating with the Matrix homeserver"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:13
|
||||
msgid ""
|
||||
"`matrix-cactus-comments-client` - a static website server serving the "
|
||||
"[cactus-client](https://cactus.chat/docs/client/introduction/) static "
|
||||
"assets (`cactus.js` and `styles.css`)"
|
||||
msgid "`matrix-cactus-comments-client` - a static website server serving the [cactus-client](https://cactus.chat/docs/client/introduction/) static assets (`cactus.js` and `styles.css`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:15
|
||||
@ -72,9 +58,7 @@ msgid "Configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:19
|
||||
msgid ""
|
||||
"To enable Cactus Comments, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Cactus Comments, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:41
|
||||
@ -82,26 +66,15 @@ msgid "Adjusting the Cactus Comments' client URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:43
|
||||
msgid ""
|
||||
"By default, this playbook installs Cactus Comments' client on the "
|
||||
"`matrix.` subdomain, at the `/cactus-comments` path "
|
||||
"(https://matrix.example.com/cactus-comments). This makes it easy to "
|
||||
"install it, because it **doesn't require additional DNS records to be set"
|
||||
" up**. If that's okay, you can skip this section."
|
||||
msgid "By default, this playbook installs Cactus Comments' client on the `matrix.` subdomain, at the `/cactus-comments` path (https://matrix.example.com/cactus-comments). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:45
|
||||
msgid ""
|
||||
"By tweaking the `matrix_cactus_comments_client_hostname` and "
|
||||
"`matrix_cactus_comments_client_path_prefix` variables, you can easily "
|
||||
"make the service available at a **different hostname and/or path** than "
|
||||
"the default one."
|
||||
msgid "By tweaking the `matrix_cactus_comments_client_hostname` and `matrix_cactus_comments_client_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-cactus-comments.md:47
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:56
|
||||
@ -109,10 +82,7 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:58
|
||||
msgid ""
|
||||
"If you've changed the default hostname, **you may need to adjust your "
|
||||
"DNS** records to point the Cactus Comments' client domain to the Matrix "
|
||||
"server."
|
||||
msgid "If you've changed the default hostname, **you may need to adjust your DNS** records to point the Cactus Comments' client domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:60
|
||||
@ -120,9 +90,7 @@ msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:62
|
||||
msgid ""
|
||||
"If you've decided to use the default hostname, you won't need to do any "
|
||||
"extra DNS configuration."
|
||||
msgid "If you've decided to use the default hostname, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:64
|
||||
@ -130,10 +98,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:66
|
||||
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:"
|
||||
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-cactus-comments.md:73
|
||||
@ -141,24 +106,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:75
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:77
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:79
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:81
|
||||
@ -166,22 +122,15 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:83
|
||||
msgid ""
|
||||
"Upon starting Cactus Comments, a `bot.cactusbot` user account is created "
|
||||
"automatically."
|
||||
msgid "Upon starting Cactus Comments, a `bot.cactusbot` user account is created automatically."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:85
|
||||
msgid ""
|
||||
"To get started, send a `help` message to the `@bot.cactusbot:example.com`"
|
||||
" bot to confirm it's working."
|
||||
msgid "To get started, send a `help` message to the `@bot.cactusbot:example.com` bot to confirm it's working."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:87
|
||||
msgid ""
|
||||
"Then, register a site by sending `register <YourSiteName>` (where "
|
||||
"`<YourSiteName>` is a unique identifier you choose. It does not have to "
|
||||
"match your domain). You will then be invited into a moderation room."
|
||||
msgid "Then, register a site by sending `register <YourSiteName>` (where `<YourSiteName>` is a unique identifier you choose. It does not have to match your domain). You will then be invited into a moderation room."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:89
|
||||
@ -193,23 +142,15 @@ msgid "Embed Cactus Comments"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:93
|
||||
msgid ""
|
||||
"The official [documentation](https://cactus.chat/docs/getting-started"
|
||||
"/quick-start/) provides a useful guide to embed Cactus Comments on your "
|
||||
"website."
|
||||
msgid "The official [documentation](https://cactus.chat/docs/getting-started/quick-start/) provides a useful guide to embed Cactus Comments on your website."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:95
|
||||
msgid ""
|
||||
"After including the JavaScript and CSS asset files, insert a `<div>` "
|
||||
"where you'd like to display the comment section:"
|
||||
msgid "After including the JavaScript and CSS asset files, insert a `<div>` where you'd like to display the comment section:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:101
|
||||
msgid ""
|
||||
"Then, you need to initialize the comment section. Make sure to replace "
|
||||
"`example.com` with your base domain and `<YourSiteName>` with the one "
|
||||
"that has been registered above:"
|
||||
msgid "Then, you need to initialize the comment section. Make sure to replace `example.com` with your base domain and `<YourSiteName>` with the one that has been registered above:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:115
|
||||
@ -217,22 +158,13 @@ msgid "Adjust the domain name for self-hosting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:117
|
||||
msgid ""
|
||||
"To have the assets served from your homeserver (not from `cactus.chat`), "
|
||||
"you need to adjust the domain name on the official documentation."
|
||||
msgid "To have the assets served from your homeserver (not from `cactus.chat`), you need to adjust the domain name on the official documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:119
|
||||
msgid ""
|
||||
"Make sure to replace `example.com` with your base domain before you "
|
||||
"include the following lines, instead of the one provided by the official "
|
||||
"documentation:"
|
||||
msgid "Make sure to replace `example.com` with your base domain before you include the following lines, instead of the one provided by the official documentation:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-cactus-comments.md:126
|
||||
msgid ""
|
||||
"**Note**: if the `matrix_cactus_comments_client_hostname` and "
|
||||
"`matrix_cactus_comments_client_path_prefix` variables are tweaked, you "
|
||||
"would need to adjust the URLs of the assets accordingly."
|
||||
msgid "**Note**: if the `matrix_cactus_comments_client_hostname` and `matrix_cactus_comments_client_path_prefix` variables are tweaked, you would need to adjust the URLs of the assets accordingly."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,30 +26,19 @@ msgid "Setting up Cinny (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:3
|
||||
msgid ""
|
||||
"This playbook can install the [Cinny](https://github.com/ajbura/cinny) "
|
||||
"Matrix web client for you."
|
||||
msgid "This playbook can install the [Cinny](https://github.com/ajbura/cinny) Matrix web client for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:5
|
||||
msgid ""
|
||||
"Cinny is a web client focusing primarily on simple, elegant and secure "
|
||||
"interface. It can be installed alongside or instead of [Element Web"
|
||||
"](./configuring-playbook-client-element-web.md)."
|
||||
msgid "Cinny is a web client focusing primarily on simple, elegant and secure interface. It can be installed alongside or instead of [Element Web](./configuring-playbook-client-element-web.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:7
|
||||
msgid ""
|
||||
"💡 **Note**: the latest version of Cinny 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:"
|
||||
msgid "💡 **Note**: the latest version of Cinny 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:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:9
|
||||
msgid ""
|
||||
"[app.cinny.in](https://app.cinny.in), hosted by the "
|
||||
"[Cinny](https://cinny.in/) developers"
|
||||
msgid "[app.cinny.in](https://app.cinny.in), hosted by the [Cinny](https://cinny.in/) developers"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:11
|
||||
@ -57,9 +46,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:13
|
||||
msgid ""
|
||||
"To enable Cinny, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Cinny, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:19
|
||||
@ -67,32 +54,19 @@ msgid "Adjusting the Cinny URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:21
|
||||
msgid ""
|
||||
"By default, this playbook installs Cinny on the `cinny.` subdomain "
|
||||
"(`cinny.example.com`) and requires you to [adjust your DNS records"
|
||||
"](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs Cinny on the `cinny.` subdomain (`cinny.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:23
|
||||
msgid ""
|
||||
"By tweaking the `matrix_client_cinny_hostname` variable, you can easily "
|
||||
"make the service available at a **different hostname** than the default "
|
||||
"one."
|
||||
msgid "By tweaking the `matrix_client_cinny_hostname` variable, you can easily make the service available at a **different hostname** than the default one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:25
|
||||
msgid ""
|
||||
"While a `matrix_client_cinny_path_prefix` variable exists for tweaking "
|
||||
"the path-prefix, it's [not supported "
|
||||
"anymore](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/issues/3701), because Cinny requires an application rebuild (with "
|
||||
"a tweaked build config) to be functional under a custom path."
|
||||
msgid "While a `matrix_client_cinny_path_prefix` variable exists for tweaking the path-prefix, it's [not supported anymore](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3701), because Cinny requires an application rebuild (with a tweaked build config) to be functional under a custom path."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:27
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:34
|
||||
@ -100,21 +74,15 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:36
|
||||
msgid ""
|
||||
"Once you've decided on the domain, **you may need to adjust your DNS** "
|
||||
"records to point the Cinny domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain, **you may need to adjust your DNS** records to point the Cinny domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:38
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `cinny`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `cinny`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:40
|
||||
msgid ""
|
||||
"If you've adjusted `matrix_client_cinny_hostname`, you will need to "
|
||||
"adjust your DNS configuration accordingly."
|
||||
msgid "If you've adjusted `matrix_client_cinny_hostname`, you will need to adjust your DNS configuration accordingly."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:42
|
||||
@ -122,25 +90,13 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:44
|
||||
msgid ""
|
||||
"After configuring the playbook and [adjusting your DNS records"
|
||||
"](#adjusting-dns-records), run the playbook with [playbook tags"
|
||||
"](playbook-tags.md) as below:"
|
||||
msgid "After configuring the playbook and [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-cinny.md:51
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-cinny.md:53
|
||||
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."
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,25 +26,15 @@ 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."
|
||||
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)):"
|
||||
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/)"
|
||||
msgid "[app.element.io](https://app.element.io/), hosted by [Element](https://element.io/)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-element-web.md:8
|
||||
@ -56,11 +46,7 @@ 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:"
|
||||
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
|
||||
@ -68,64 +54,31 @@ 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."
|
||||
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."
|
||||
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."
|
||||
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:"
|
||||
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."
|
||||
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)."
|
||||
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)."
|
||||
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
|
||||
@ -133,31 +86,19 @@ 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."
|
||||
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`)."
|
||||
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."
|
||||
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."
|
||||
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
|
||||
@ -165,24 +106,15 @@ 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)."
|
||||
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."
|
||||
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:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-element-web.md:61
|
||||
@ -190,21 +122,15 @@ 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."
|
||||
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."
|
||||
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."
|
||||
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
|
||||
@ -212,25 +138,13 @@ 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:"
|
||||
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`"
|
||||
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."
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,15 +26,11 @@ msgid "Setting up Hydrogen (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:3
|
||||
msgid ""
|
||||
"This playbook can install the [Hydrogen](https://github.com/element-hq"
|
||||
"/hydrogen-web) Matrix web client for you."
|
||||
msgid "This playbook can install the [Hydrogen](https://github.com/element-hq/hydrogen-web) Matrix web client for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:5
|
||||
msgid ""
|
||||
"Hydrogen is a lightweight web client that supports mobile and legacy web "
|
||||
"browsers. It can be installed alongside or instead of Element Web."
|
||||
msgid "Hydrogen is a lightweight web client that supports mobile and legacy web browsers. It can be installed alongside or instead of Element Web."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:7
|
||||
@ -42,9 +38,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:9
|
||||
msgid ""
|
||||
"To enable Hydrogen, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Hydrogen, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:15
|
||||
@ -52,24 +46,15 @@ msgid "Adjusting the Hydrogen URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:17
|
||||
msgid ""
|
||||
"By default, this playbook installs Hydrogen on the `hydrogen.` subdomain "
|
||||
"(`hydrogen.example.com`) and requires you to [adjust your DNS records"
|
||||
"](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs Hydrogen on the `hydrogen.` subdomain (`hydrogen.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:19
|
||||
msgid ""
|
||||
"By tweaking the `matrix_client_hydrogen_hostname` and "
|
||||
"`matrix_client_hydrogen_path_prefix` variables, you can easily make the "
|
||||
"service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_client_hydrogen_hostname` and `matrix_client_hydrogen_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-hydrogen.md:21
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:32
|
||||
@ -77,21 +62,15 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:34
|
||||
msgid ""
|
||||
"Once you've decided on the domain and path, **you may need to adjust your"
|
||||
" DNS** records to point the Hydrogen domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Hydrogen domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:36
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `hydrogen`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `hydrogen`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:38
|
||||
msgid ""
|
||||
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
|
||||
" extra DNS configuration."
|
||||
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-hydrogen.md:40
|
||||
@ -99,25 +78,13 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-hydrogen.md:42
|
||||
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:"
|
||||
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-hydrogen.md:49
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-hydrogen.md:51
|
||||
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."
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,31 +26,19 @@ msgid "Setting up SchildiChat Web (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:3
|
||||
msgid ""
|
||||
"This playbook can install the [SchildiChat "
|
||||
"Web](https://github.com/SchildiChat/schildichat-desktop) Matrix client "
|
||||
"for you."
|
||||
msgid "This playbook can install the [SchildiChat Web](https://github.com/SchildiChat/schildichat-desktop) Matrix client for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:5
|
||||
msgid ""
|
||||
"SchildiChat Web is a feature-rich messenger for Matrix based on Element "
|
||||
"Web with some extras and tweaks. It can be installed alongside or instead"
|
||||
" of Element Web."
|
||||
msgid "SchildiChat Web is a feature-rich messenger for Matrix based on Element Web with some extras and tweaks. It can be installed alongside or instead of Element Web."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:7
|
||||
msgid ""
|
||||
"💡 **Note**: the latest version of SchildiChat Web is also available on "
|
||||
"the web, hosted by 3rd parties. If you trust giving your credentials to "
|
||||
"the following 3rd party Single Page Application, you can consider using "
|
||||
"it from there:"
|
||||
msgid "💡 **Note**: the latest version of SchildiChat Web is also available on the web, hosted by 3rd parties. If you trust giving your credentials to the following 3rd party Single Page Application, you can consider using it from there:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:9
|
||||
msgid ""
|
||||
"[app.schildi.chat](https://app.schildi.chat/), hosted by the "
|
||||
"[SchildiChat](https://schildi.chat/) developers"
|
||||
msgid "[app.schildi.chat](https://app.schildi.chat/), hosted by the [SchildiChat](https://schildi.chat/) developers"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:11
|
||||
@ -58,70 +46,35 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:13
|
||||
msgid ""
|
||||
"To enable SchildiChat Web, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable SchildiChat Web, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:19
|
||||
msgid ""
|
||||
"The playbook provides some customization variables you could use to "
|
||||
"change SchildiChat Web's settings."
|
||||
msgid "The playbook provides some customization variables you could use to change SchildiChat Web's settings."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:21
|
||||
msgid ""
|
||||
"Their defaults are defined in [`roles/custom/matrix-client-"
|
||||
"schildichat/defaults/main.yml`](../roles/custom/matrix-client-"
|
||||
"schildichat/defaults/main.yml) and they ultimately end up in the "
|
||||
"generated `/matrix/schildichat/config.json` file (on the server). This "
|
||||
"file is generated from the [`roles/custom/matrix-client-"
|
||||
"schildichat/templates/config.json.j2`](../roles/custom/matrix-client-"
|
||||
"schildichat/templates/config.json.j2) template."
|
||||
msgid "Their defaults are defined in [`roles/custom/matrix-client-schildichat/defaults/main.yml`](../roles/custom/matrix-client-schildichat/defaults/main.yml) and they ultimately end up in the generated `/matrix/schildichat/config.json` file (on the server). This file is generated from the [`roles/custom/matrix-client-schildichat/templates/config.json.j2`](../roles/custom/matrix-client-schildichat/templates/config.json.j2) template."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:23
|
||||
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."
|
||||
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-schildichat-web.md:25
|
||||
msgid ""
|
||||
"Alternatively, **if there is no pre-defined variable** for a SchildiChat "
|
||||
"Web setting you wish to change:"
|
||||
msgid "Alternatively, **if there is no pre-defined variable** for a SchildiChat Web setting you wish to change:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:27
|
||||
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 SchildiChat Web's various"
|
||||
" settings that rarely get used."
|
||||
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 SchildiChat Web's various settings that rarely get used."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:29
|
||||
msgid ""
|
||||
"or, you can **extend and override the default configuration** "
|
||||
"([`config.json.j2`](../roles/custom/matrix-client-"
|
||||
"schildichat/templates/config.json.j2)) by making use of the "
|
||||
"`matrix_client_schildichat_configuration_extension_json_` variable. You "
|
||||
"can find information about this in [`roles/custom/matrix-client-"
|
||||
"schildichat/defaults/main.yml`](../roles/custom/matrix-client-"
|
||||
"schildichat/defaults/main.yml)."
|
||||
msgid "or, you can **extend and override the default configuration** ([`config.json.j2`](../roles/custom/matrix-client-schildichat/templates/config.json.j2)) by making use of the `matrix_client_schildichat_configuration_extension_json_` variable. You can find information about this in [`roles/custom/matrix-client-schildichat/defaults/main.yml`](../roles/custom/matrix-client-schildichat/defaults/main.yml)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:31
|
||||
msgid ""
|
||||
"or, if extending the configuration is still not powerful enough for your "
|
||||
"needs, you can **override the configuration completely** using "
|
||||
"`matrix_client_schildichat_configuration_default` (or "
|
||||
"`matrix_client_schildichat_configuration`). You can find information "
|
||||
"about this in [`roles/custom/matrix-client-"
|
||||
"schildichat/defaults/main.yml`](../roles/custom/matrix-client-"
|
||||
"schildichat/defaults/main.yml)."
|
||||
msgid "or, if extending the configuration is still not powerful enough for your needs, you can **override the configuration completely** using `matrix_client_schildichat_configuration_default` (or `matrix_client_schildichat_configuration`). You can find information about this in [`roles/custom/matrix-client-schildichat/defaults/main.yml`](../roles/custom/matrix-client-schildichat/defaults/main.yml)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:33
|
||||
@ -129,31 +82,19 @@ msgid "Themes"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:35
|
||||
msgid ""
|
||||
"To change the look of SchildiChat Web, you can define your own themes "
|
||||
"manually by using the "
|
||||
"`matrix_client_schildichat_setting_defaults_custom_themes` setting."
|
||||
msgid "To change the look of SchildiChat Web, you can define your own themes manually by using the `matrix_client_schildichat_setting_defaults_custom_themes` setting."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:37
|
||||
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_schildichat_themes_enabled: true`)."
|
||||
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_schildichat_themes_enabled: true`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:39
|
||||
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."
|
||||
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-schildichat-web.md:41
|
||||
msgid ""
|
||||
"Note that for a custom theme to work well, all SchildiChat Web instances "
|
||||
"that you use must have the same theme installed."
|
||||
msgid "Note that for a custom theme to work well, all SchildiChat Web instances that you use must have the same theme installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:43
|
||||
@ -161,24 +102,15 @@ msgid "Adjusting the SchildiChat Web URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:45
|
||||
msgid ""
|
||||
"By default, this playbook installs SchildiChat Web on the `schildichat.` "
|
||||
"subdomain (`schildichat.example.com`) and requires you to [adjust your "
|
||||
"DNS records](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs SchildiChat Web on the `schildichat.` subdomain (`schildichat.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:47
|
||||
msgid ""
|
||||
"By tweaking the `matrix_client_schildichat_hostname` and "
|
||||
"`matrix_client_schildichat_path_prefix` variables, you can easily make "
|
||||
"the service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_client_schildichat_hostname` and `matrix_client_schildichat_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-schildichat-web.md:49
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:60
|
||||
@ -186,21 +118,15 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:62
|
||||
msgid ""
|
||||
"Once you've decided on the domain and path, **you may need to adjust your"
|
||||
" DNS** records to point the SchildiChat Web domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the SchildiChat Web domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:64
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `schildichat`. See"
|
||||
" [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `schildichat`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:66
|
||||
msgid ""
|
||||
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
|
||||
" extra DNS configuration."
|
||||
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-schildichat-web.md:68
|
||||
@ -208,25 +134,13 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-client-schildichat-web.md:70
|
||||
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:"
|
||||
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-schildichat-web.md:77
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
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-schildichat-web.md:79
|
||||
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."
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,10 +26,7 @@ msgid "Configuring Conduit (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:3
|
||||
msgid ""
|
||||
"By default, this playbook configures the [Synapse](https://github.com"
|
||||
"/element-hq/synapse) Matrix server, but you can also use "
|
||||
"[Conduit](https://conduit.rs)."
|
||||
msgid "By default, this playbook configures the [Synapse](https://github.com/element-hq/synapse) Matrix server, but you can also use [Conduit](https://conduit.rs)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:5
|
||||
@ -37,19 +34,11 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:7
|
||||
msgid ""
|
||||
"**You can't switch an existing Matrix server's implementation** (e.g. "
|
||||
"Synapse -> Conduit). Proceed below only if you're OK with losing data or "
|
||||
"you're dealing with a server on a new domain name, which hasn't "
|
||||
"participated in the Matrix federation yet."
|
||||
msgid "**You can't switch an existing Matrix server's implementation** (e.g. Synapse -> Conduit). Proceed below only if you're OK with losing data or you're dealing with a server on a new domain name, which hasn't participated in the Matrix federation yet."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:9
|
||||
msgid ""
|
||||
"**homeserver implementations other than Synapse may not be fully "
|
||||
"functional**. The playbook may also not assist you in an optimal way "
|
||||
"(like it does with Synapse). Make yourself familiar with the downsides "
|
||||
"before proceeding"
|
||||
msgid "**homeserver implementations other than Synapse may not be fully functional**. The playbook may also not assist you in an optimal way (like it does with Synapse). Make yourself familiar with the downsides before proceeding"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:11
|
||||
@ -57,9 +46,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:13
|
||||
msgid ""
|
||||
"To use Conduit, you **generally** need to add the following configuration"
|
||||
" to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To use Conduit, you **generally** need to add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:19
|
||||
@ -67,32 +54,19 @@ msgid "Creating the first user account"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:21
|
||||
msgid ""
|
||||
"Since it is difficult to create the first user account on Conduit (see "
|
||||
"[famedly/conduit#276](https://gitlab.com/famedly/conduit/-/issues/276) "
|
||||
"and "
|
||||
"[famedly/conduit#354](https://gitlab.com/famedly/conduit/-/merge_requests/354))"
|
||||
" and it does not support [registering users](registering-users.md) (via "
|
||||
"the command line or via the playbook) like Synapse and Dendrite do, we "
|
||||
"recommend the following procedure:"
|
||||
msgid "Since it is difficult to create the first user account on Conduit (see [famedly/conduit#276](https://gitlab.com/famedly/conduit/-/issues/276) and [famedly/conduit#354](https://gitlab.com/famedly/conduit/-/merge_requests/354)) and it does not support [registering users](registering-users.md) (via the command line or via the playbook) like Synapse and Dendrite do, we recommend the following procedure:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:23
|
||||
msgid ""
|
||||
"Add `matrix_conduit_allow_registration: true` to your `vars.yml` the "
|
||||
"first time around, temporarily"
|
||||
msgid "Add `matrix_conduit_allow_registration: true` to your `vars.yml` the first time around, temporarily"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:24
|
||||
msgid ""
|
||||
"Run the playbook (`ansible-playbook -i inventory/hosts setup.yml --tags"
|
||||
"=setup-all,start` - see [Installing](installing.md))"
|
||||
msgid "Run the playbook (`ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start` - see [Installing](installing.md))"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:25
|
||||
msgid ""
|
||||
"Create your first user via Element Web or any other client which supports"
|
||||
" creating users"
|
||||
msgid "Create your first user via Element Web or any other client which supports creating users"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:26
|
||||
@ -100,15 +74,11 @@ msgid "Get rid of `matrix_conduit_allow_registration: true` from your `vars.yml`
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:27
|
||||
msgid ""
|
||||
"Run the playbook again (`ansible-playbook -i inventory/hosts setup.yml "
|
||||
"--tags=setup-conduit,start` would be enough this time)"
|
||||
msgid "Run the playbook again (`ansible-playbook -i inventory/hosts setup.yml --tags=setup-conduit,start` would be enough this time)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:28
|
||||
msgid ""
|
||||
"You can now use your server safely. Additional users can be created by "
|
||||
"messaging the internal Conduit bot"
|
||||
msgid "You can now use your server safely. Additional users can be created by messaging the internal Conduit bot"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:30
|
||||
@ -116,23 +86,13 @@ msgid "Configuring bridges / appservices"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:32
|
||||
msgid ""
|
||||
"Automatic appservice setup is currently unsupported when using Conduit. "
|
||||
"After setting up the service as usual you may notice that it is unable to"
|
||||
" start."
|
||||
msgid "Automatic appservice setup is currently unsupported when using Conduit. After setting up the service as usual you may notice that it is unable to start."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:34
|
||||
msgid ""
|
||||
"You will have to manually register appservices using the the [register-"
|
||||
"appservice](https://gitlab.com/famedly/conduit/-/blob/next/APPSERVICES.md)"
|
||||
" command."
|
||||
msgid "You will have to manually register appservices using the the [register-appservice](https://gitlab.com/famedly/conduit/-/blob/next/APPSERVICES.md) command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-conduit.md:36
|
||||
msgid ""
|
||||
"Find the `registration.yaml` in the `/matrix` directory, for example "
|
||||
"`/matrix/mautrix-signal/bridge/registration.yaml`, then pass the content "
|
||||
"to Conduit:"
|
||||
msgid "Find the `registration.yaml` in the `/matrix` directory, for example `/matrix/mautrix-signal/bridge/registration.yaml`, then pass the content to Conduit:"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,10 +26,7 @@ msgid "Configuring Dendrite (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:3
|
||||
msgid ""
|
||||
"By default, this playbook configures the [Synapse](https://github.com"
|
||||
"/element-hq/synapse) Matrix server, but you can also use "
|
||||
"[Dendrite](https://github.com/matrix-org/dendrite)."
|
||||
msgid "By default, this playbook configures the [Synapse](https://github.com/element-hq/synapse) Matrix server, but you can also use [Dendrite](https://github.com/matrix-org/dendrite)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:5
|
||||
@ -37,19 +34,11 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:7
|
||||
msgid ""
|
||||
"**You can't switch an existing Matrix server's implementation** (e.g. "
|
||||
"Synapse -> Dendrite). Proceed below only if you're OK with losing data or"
|
||||
" you're dealing with a server on a new domain name, which hasn't "
|
||||
"participated in the Matrix federation yet."
|
||||
msgid "**You can't switch an existing Matrix server's implementation** (e.g. Synapse -> Dendrite). Proceed below only if you're OK with losing data or you're dealing with a server on a new domain name, which hasn't participated in the Matrix federation yet."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:9
|
||||
msgid ""
|
||||
"**homeserver implementations other than Synapse may not be fully "
|
||||
"functional**. The playbook may also not assist you in an optimal way "
|
||||
"(like it does with Synapse). Make yourself familiar with the downsides "
|
||||
"before proceeding"
|
||||
msgid "**homeserver implementations other than Synapse may not be fully functional**. The playbook may also not assist you in an optimal way (like it does with Synapse). Make yourself familiar with the downsides before proceeding"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:11
|
||||
@ -57,71 +46,35 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:13
|
||||
msgid ""
|
||||
"To use Dendrite, you **generally** need to add the following "
|
||||
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"file:"
|
||||
msgid "To use Dendrite, you **generally** need to add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:19
|
||||
msgid ""
|
||||
"The playbook provides lots of customization variables you could use to "
|
||||
"change Dendrite's settings."
|
||||
msgid "The playbook provides lots of customization variables you could use to change Dendrite's settings."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:21
|
||||
msgid ""
|
||||
"Their defaults are defined in [`roles/custom/matrix-"
|
||||
"dendrite/defaults/main.yml`](../roles/custom/matrix-"
|
||||
"dendrite/defaults/main.yml) and they ultimately end up in the generated "
|
||||
"`/matrix/dendrite/config/dendrite.yaml` file (on the server). This file "
|
||||
"is generated from the [`roles/custom/matrix-"
|
||||
"dendrite/templates/dendrite/dendrite.yaml.j2`](../roles/custom/matrix-"
|
||||
"dendrite/templates/dendrite/dendrite.yaml.j2) template."
|
||||
msgid "Their defaults are defined in [`roles/custom/matrix-dendrite/defaults/main.yml`](../roles/custom/matrix-dendrite/defaults/main.yml) and they ultimately end up in the generated `/matrix/dendrite/config/dendrite.yaml` file (on the server). This file is generated from the [`roles/custom/matrix-dendrite/templates/dendrite/dendrite.yaml.j2`](../roles/custom/matrix-dendrite/templates/dendrite/dendrite.yaml.j2) template."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:23
|
||||
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."
|
||||
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-dendrite.md:25
|
||||
msgid ""
|
||||
"Alternatively, **if there is no pre-defined variable** for a Dendrite "
|
||||
"setting you wish to change:"
|
||||
msgid "Alternatively, **if there is no pre-defined variable** for a Dendrite setting you wish to change:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:27
|
||||
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 Dendrite's various "
|
||||
"settings that rarely get used."
|
||||
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 Dendrite's various settings that rarely get used."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:29
|
||||
msgid ""
|
||||
"or, you can **extend and override the default configuration** "
|
||||
"([`dendrite.yaml.j2`](../roles/custom/matrix-"
|
||||
"dendrite/templates/dendrite/dendrite.yaml.j2)) by making use of the "
|
||||
"`matrix_dendrite_configuration_extension_yaml` variable. You can find "
|
||||
"information about this in [`roles/custom/matrix-"
|
||||
"dendrite/defaults/main.yml`](../roles/custom/matrix-"
|
||||
"dendrite/defaults/main.yml)."
|
||||
msgid "or, you can **extend and override the default configuration** ([`dendrite.yaml.j2`](../roles/custom/matrix-dendrite/templates/dendrite/dendrite.yaml.j2)) by making use of the `matrix_dendrite_configuration_extension_yaml` variable. You can find information about this in [`roles/custom/matrix-dendrite/defaults/main.yml`](../roles/custom/matrix-dendrite/defaults/main.yml)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:31
|
||||
msgid ""
|
||||
"or, if extending the configuration is still not powerful enough for your "
|
||||
"needs, you can **override the configuration completely** using "
|
||||
"`matrix_dendrite_configuration` (or "
|
||||
"`matrix_dendrite_configuration_yaml`). You can find information about "
|
||||
"this in [`roles/custom/matrix-"
|
||||
"dendrite/defaults/main.yml`](../roles/custom/matrix-"
|
||||
"dendrite/defaults/main.yml)."
|
||||
msgid "or, if extending the configuration is still not powerful enough for your needs, you can **override the configuration completely** using `matrix_dendrite_configuration` (or `matrix_dendrite_configuration_yaml`). You can find information about this in [`roles/custom/matrix-dendrite/defaults/main.yml`](../roles/custom/matrix-dendrite/defaults/main.yml)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:33
|
||||
@ -129,24 +82,13 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:35
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:42
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dendrite.md:44
|
||||
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."
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,34 +26,15 @@ 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."
|
||||
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."
|
||||
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)."
|
||||
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
|
||||
@ -61,9 +42,7 @@ 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`):"
|
||||
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
|
||||
@ -71,18 +50,11 @@ 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`):"
|
||||
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."
|
||||
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
|
||||
@ -90,37 +62,23 @@ 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**."
|
||||
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)."
|
||||
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.**"
|
||||
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`):"
|
||||
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)."
|
||||
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
|
||||
@ -128,32 +86,19 @@ 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)."
|
||||
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."
|
||||
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:"
|
||||
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."
|
||||
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
|
||||
@ -161,15 +106,11 @@ 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."
|
||||
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."
|
||||
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
|
||||
@ -177,10 +118,7 @@ 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:"
|
||||
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
|
||||
@ -188,28 +126,15 @@ 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`"
|
||||
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."
|
||||
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."
|
||||
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
|
||||
@ -217,23 +142,11 @@ 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."
|
||||
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."
|
||||
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
|
||||
@ -241,19 +154,9 @@ 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."
|
||||
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)."
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,18 +26,11 @@ msgid "Setting up Dynamic DNS (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:3
|
||||
msgid ""
|
||||
"The playbook can configure Dynamic DNS with "
|
||||
"[ddclient](https://github.com/ddclient/ddclient) for you. It is a Perl "
|
||||
"client used to update dynamic DNS entries for accounts on Dynamic DNS "
|
||||
"Network Service Provider."
|
||||
msgid "The playbook can configure Dynamic DNS with [ddclient](https://github.com/ddclient/ddclient) for you. It is a Perl client used to update dynamic DNS entries for accounts on Dynamic DNS Network Service Provider."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:5
|
||||
msgid ""
|
||||
"Most cloud providers / ISPs will charge you extra for a static IP "
|
||||
"address. If you're not hosting a highly reliable homeserver you can "
|
||||
"workaround this via dynamic DNS."
|
||||
msgid "Most cloud providers / ISPs will charge you extra for a static IP address. If you're not hosting a highly reliable homeserver you can workaround this via dynamic DNS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:7
|
||||
@ -45,9 +38,7 @@ msgid "Prerequisite"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:9
|
||||
msgid ""
|
||||
"You'll need to get a username and password from your DNS provider. Please"
|
||||
" consult with the provider about how to retrieve them."
|
||||
msgid "You'll need to get a username and password from your DNS provider. Please consult with the provider about how to retrieve them."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:11
|
||||
@ -55,9 +46,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:13
|
||||
msgid ""
|
||||
"To enable dynamic DNS, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable dynamic DNS, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:26
|
||||
@ -65,25 +54,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:28
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:35
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:37
|
||||
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."
|
||||
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-dynamic-dns.md:39
|
||||
@ -97,4 +76,3 @@ msgstr ""
|
||||
#: ../../../docs/configuring-playbook-dynamic-dns.md:43
|
||||
msgid "https://matrix.org/docs/guides/free-small-matrix-server"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,37 +26,23 @@ msgid "Adjusting email-sending settings (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:3
|
||||
msgid ""
|
||||
"By default, this playbook sets up an [Exim](https://www.exim.org/) email "
|
||||
"server through which all Matrix services send emails."
|
||||
msgid "By default, this playbook sets up an [Exim](https://www.exim.org/) email server through which all Matrix services send emails."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:5
|
||||
msgid ""
|
||||
"The email server would attempt to deliver emails directly to their final "
|
||||
"destination. This may or may not work, depending on your domain "
|
||||
"configuration (SPF settings, etc.)"
|
||||
msgid "The email server would attempt to deliver emails directly to their final destination. This may or may not work, depending on your domain configuration (SPF settings, etc.)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:7
|
||||
msgid ""
|
||||
"By default, emails are sent from `matrix@matrix.example.com`, as "
|
||||
"specified by the `exim_relay_sender_address` playbook variable."
|
||||
msgid "By default, emails are sent from `matrix@matrix.example.com`, as specified by the `exim_relay_sender_address` playbook variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:9
|
||||
msgid ""
|
||||
"⚠️ **Warning**: On some cloud providers (Google Cloud, etc.), [port 25 is"
|
||||
" always blocked](https://cloud.google.com/compute/docs/tutorials/sending-"
|
||||
"mail/), so sending email directly from your server is not possible. You "
|
||||
"will need to [relay email through another SMTP server](#relaying-email-"
|
||||
"through-another-smtp-server)."
|
||||
msgid "⚠️ **Warning**: On some cloud providers (Google Cloud, etc.), [port 25 is always blocked](https://cloud.google.com/compute/docs/tutorials/sending-mail/), so sending email directly from your server is not possible. You will need to [relay email through another SMTP server](#relaying-email-through-another-smtp-server)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:11
|
||||
msgid ""
|
||||
"💡 To improve deliverability, we recommend [relaying email through another"
|
||||
" SMTP server](#relaying-email-through-another-smtp-server) anyway."
|
||||
msgid "💡 To improve deliverability, we recommend [relaying email through another SMTP server](#relaying-email-through-another-smtp-server) anyway."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:13
|
||||
@ -64,10 +50,7 @@ msgid "Firewall settings"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:15
|
||||
msgid ""
|
||||
"No matter whether you send email directly (the default) or you relay "
|
||||
"email through another host (see how below), you'll probably need to allow"
|
||||
" outgoing traffic for TCP ports 25/587 (depending on configuration)."
|
||||
msgid "No matter whether you send email directly (the default) or you relay email through another host (see how below), you'll probably need to allow outgoing traffic for TCP ports 25/587 (depending on configuration)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:17
|
||||
@ -75,18 +58,11 @@ msgid "Relaying email through another SMTP server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:19
|
||||
msgid ""
|
||||
"If you'd like to relay email through another SMTP server, add the "
|
||||
"following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
|
||||
"needs):"
|
||||
msgid "If you'd like to relay email through another SMTP server, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:31
|
||||
msgid ""
|
||||
"**Note**: only the secure submission protocol (using `STARTTLS`, usually "
|
||||
"on port `587`) is supported. **SMTPS** (encrypted SMTP, usually on port "
|
||||
"`465`) **is not supported**."
|
||||
msgid "**Note**: only the secure submission protocol (using `STARTTLS`, usually on port `587`) is supported. **SMTPS** (encrypted SMTP, usually on port `465`) **is not supported**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:33
|
||||
@ -94,26 +70,15 @@ msgid "Configuations for sending emails using Sendgrid"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:35
|
||||
msgid ""
|
||||
"An easy and free SMTP service to set up is "
|
||||
"[Sendgrid](https://sendgrid.com/), the free tier allows for up to 100 "
|
||||
"emails per day to be sent. In the settings below you can provide any "
|
||||
"email for `exim_relay_sender_address`."
|
||||
msgid "An easy and free SMTP service to set up is [Sendgrid](https://sendgrid.com/), the free tier allows for up to 100 emails per day to be sent. In the settings below you can provide any email for `exim_relay_sender_address`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:37
|
||||
msgid ""
|
||||
"The only other thing you need to change is the "
|
||||
"`exim_relay_relay_auth_password`, which you can generate at "
|
||||
"https://app.sendgrid.com/settings/api_keys. The API key password looks "
|
||||
"something like `SG.955oW1mLSfwds7i9Yd6IA5Q.q8GTaB8q9kGDzasegdG6u95fQ-"
|
||||
"6zkdwrPP8bOeuI`."
|
||||
msgid "The only other thing you need to change is the `exim_relay_relay_auth_password`, which you can generate at https://app.sendgrid.com/settings/api_keys. The API key password looks something like `SG.955oW1mLSfwds7i9Yd6IA5Q.q8GTaB8q9kGDzasegdG6u95fQ-6zkdwrPP8bOeuI`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:39
|
||||
msgid ""
|
||||
"Note that the `exim_relay_relay_auth_username` is literally the string "
|
||||
"`apikey`, it's always the same for Sendgrid."
|
||||
msgid "Note that the `exim_relay_relay_auth_username` is literally the string `apikey`, it's always the same for Sendgrid."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:51
|
||||
@ -121,8 +86,5 @@ msgid "Troubleshooting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email.md:53
|
||||
msgid ""
|
||||
"If you're having trouble with email not being delivered, it may be useful"
|
||||
" to inspect the mailer logs: `journalctl -f -u matrix-exim-relay`."
|
||||
msgid "If you're having trouble with email not being delivered, it may be useful to inspect the mailer logs: `journalctl -f -u matrix-exim-relay`."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,24 +26,15 @@ msgid "Setting up Email2Matrix (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:3
|
||||
msgid ""
|
||||
"**Note**: email bridging can also happen via the [Postmoogle"
|
||||
"](configuring-playbook-bridge-postmoogle.md) bridge supported by the "
|
||||
"playbook. Postmoogle is much more powerful and easier to use, so we "
|
||||
"recommend that you use it, instead of Email2Matrix."
|
||||
msgid "**Note**: email bridging can also happen via the [Postmoogle](configuring-playbook-bridge-postmoogle.md) bridge supported by the playbook. Postmoogle is much more powerful and easier to use, so we recommend that you use it, instead of Email2Matrix."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure "
|
||||
"[email2matrix](https://github.com/devture/email2matrix) for you."
|
||||
msgid "The playbook can install and configure [email2matrix](https://github.com/devture/email2matrix) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:7
|
||||
msgid ""
|
||||
"See the project's "
|
||||
"[documentation](https://github.com/devture/email2matrix/blob/master/docs/README.md)"
|
||||
" to learn what it does and why it might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/devture/email2matrix/blob/master/docs/README.md) to learn what it does and why it might be useful to you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:9
|
||||
@ -55,11 +46,7 @@ msgid "DNS configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:13
|
||||
msgid ""
|
||||
"It's not strictly necessary, but you may increase the chances that "
|
||||
"incoming emails reach your server by adding an `MX` record for "
|
||||
"`matrix.example.com`, as described in the [Configuring DNS](configuring-"
|
||||
"dns.md) documentation page."
|
||||
msgid "It's not strictly necessary, but you may increase the chances that incoming emails reach your server by adding an `MX` record for `matrix.example.com`, as described in the [Configuring DNS](configuring-dns.md) documentation page."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:15
|
||||
@ -67,31 +54,19 @@ msgid "Port availability"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:17
|
||||
msgid ""
|
||||
"Ensure that port 25 is available on your Matrix server and open in your "
|
||||
"firewall."
|
||||
msgid "Ensure that port 25 is available on your Matrix server and open in your firewall."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:19
|
||||
msgid ""
|
||||
"If you have `postfix` or some other email server software installed, you "
|
||||
"may need to manually remove it first (unless you need it, of course)."
|
||||
msgid "If you have `postfix` or some other email server software installed, you may need to manually remove it first (unless you need it, of course)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:21
|
||||
msgid ""
|
||||
"If you really need to run an email server on the Matrix machine for other"
|
||||
" purposes, it may be possible to run Email2Matrix on another port (with a"
|
||||
" configuration like `matrix_email2matrix_smtp_host_bind_port: "
|
||||
"\"127.0.0.01:2525\"`) and have your other email server relay messages "
|
||||
"there."
|
||||
msgid "If you really need to run an email server on the Matrix machine for other purposes, it may be possible to run Email2Matrix on another port (with a configuration like `matrix_email2matrix_smtp_host_bind_port: \"127.0.0.01:2525\"`) and have your other email server relay messages there."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:23
|
||||
msgid ""
|
||||
"For details about using Email2Matrix alongside "
|
||||
"[Postfix](http://www.postfix.org/), see "
|
||||
"[here](https://github.com/devture/email2matrix/blob/master/docs/setup_with_postfix.md)."
|
||||
msgid "For details about using Email2Matrix alongside [Postfix](http://www.postfix.org/), see [here](https://github.com/devture/email2matrix/blob/master/docs/setup_with_postfix.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:25
|
||||
@ -99,18 +74,11 @@ msgid "Creating a user"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:27
|
||||
msgid ""
|
||||
"Before enabling Email2Matrix, you'd most likely wish to create a "
|
||||
"dedicated user (or more) that would be sending messages on the Matrix "
|
||||
"side. Take note of the user's ID as it needs to be specified as "
|
||||
"`MatrixUserId` on your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"file later."
|
||||
msgid "Before enabling Email2Matrix, you'd most likely wish to create a dedicated user (or more) that would be sending messages on the Matrix side. Take note of the user's ID as it needs to be specified as `MatrixUserId` on your `inventory/host_vars/matrix.example.com/vars.yml` file later."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:29
|
||||
msgid ""
|
||||
"Refer to [Registering users](registering-users.md) for ways to create a "
|
||||
"user. A regular (non-admin) user works best."
|
||||
msgid "Refer to [Registering users](registering-users.md) for ways to create a user. A regular (non-admin) user works best."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:31
|
||||
@ -118,17 +86,11 @@ msgid "Creating a shared room"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:33
|
||||
msgid ""
|
||||
"After creating the sender user, you should create one or more Matrix "
|
||||
"rooms that you share with that user. It doesn't matter who creates and "
|
||||
"owns the rooms and who joins later (you or the sender user)."
|
||||
msgid "After creating the sender user, you should create one or more Matrix rooms that you share with that user. It doesn't matter who creates and owns the rooms and who joins later (you or the sender user)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:35
|
||||
msgid ""
|
||||
"What matters is that both you and the sender user are part of the same "
|
||||
"room and that the sender user has enough privileges in the room to be "
|
||||
"able to send messages there."
|
||||
msgid "What matters is that both you and the sender user are part of the same room and that the sender user has enough privileges in the room to be able to send messages there."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:37
|
||||
@ -136,10 +98,7 @@ msgid "Inviting additional people to the room is okay too."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:39
|
||||
msgid ""
|
||||
"Take note of each room's room ID (different clients show the room ID in a"
|
||||
" different place). You'll need the room ID when [configuring the playbook"
|
||||
"](#adjusting-the-playbook-configuration) below."
|
||||
msgid "Take note of each room's room ID (different clients show the room ID in a different place). You'll need the room ID when [configuring the playbook](#adjusting-the-playbook-configuration) below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:41
|
||||
@ -147,11 +106,7 @@ msgid "Obtaining an access token for the sender user"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:43
|
||||
msgid ""
|
||||
"In order for the sender user created above to be able to send messages to"
|
||||
" the room, we'll need to obtain an access token for it. Refer to the "
|
||||
"documentation on [how to obtain an access token](obtaining-access-"
|
||||
"tokens.md)."
|
||||
msgid "In order for the sender user created above to be able to send messages to the room, we'll need to obtain an access token for it. Refer to the documentation on [how to obtain an access token](obtaining-access-tokens.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:45
|
||||
@ -159,10 +114,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:47
|
||||
msgid ""
|
||||
"After doing the preparation steps above, add the following configuration "
|
||||
"to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to "
|
||||
"your needs):"
|
||||
msgid "After doing the preparation steps above, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:72
|
||||
@ -170,31 +122,19 @@ msgid "where:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:74
|
||||
msgid ""
|
||||
"MailboxName - local-part of the email address, through which emails are "
|
||||
"bridged to the room whose ID is defined with MatrixRoomId"
|
||||
msgid "MailboxName - local-part of the email address, through which emails are bridged to the room whose ID is defined with MatrixRoomId"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:75
|
||||
msgid ""
|
||||
"MatrixRoomId - internal ID of the room, to which received emails are sent"
|
||||
" as Matrix message"
|
||||
msgid "MatrixRoomId - internal ID of the room, to which received emails are sent as Matrix message"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:76
|
||||
msgid ""
|
||||
"MatrixHomeserverUrl - URL of your Matrix homeserver, through which to "
|
||||
"send Matrix messages. You can also set `MatrixHomeserverUrl` to the "
|
||||
"container URL where your homeserver's Client-Server API lives by using "
|
||||
"the `{{ matrix_addons_homeserver_client_api_url }}` variable"
|
||||
msgid "MatrixHomeserverUrl - URL of your Matrix homeserver, through which to send Matrix messages. You can also set `MatrixHomeserverUrl` to the container URL where your homeserver's Client-Server API lives by using the `{{ matrix_addons_homeserver_client_api_url }}` variable"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:77
|
||||
msgid ""
|
||||
"MatrixUserId - the full ID of the sender user which sends bridged "
|
||||
"messages to the room. On this configuration it is "
|
||||
"`@email2matrix1:example.com` and `@email2matrix2:example.com` (where "
|
||||
"`example.com` is your base domain, not the `matrix.` domain)"
|
||||
msgid "MatrixUserId - the full ID of the sender user which sends bridged messages to the room. On this configuration it is `@email2matrix1:example.com` and `@email2matrix2:example.com` (where `example.com` is your base domain, not the `matrix.` domain)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:78
|
||||
@ -210,15 +150,11 @@ msgid "IgnoreBody - if set to \"true\", the message body is not bridged to Matri
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:81
|
||||
msgid ""
|
||||
"SkipMarkdown - if set to \"true\", emails are bridged as plain text "
|
||||
"Matrix message instead of Markdown (actually HTML)"
|
||||
msgid "SkipMarkdown - if set to \"true\", emails are bridged as plain text Matrix message instead of Markdown (actually HTML)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:83
|
||||
msgid ""
|
||||
"Refer to the official documentation "
|
||||
"[here](https://github.com/devture/email2matrix/blob/master/docs/configuration.md)."
|
||||
msgid "Refer to the official documentation [here](https://github.com/devture/email2matrix/blob/master/docs/configuration.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:85
|
||||
@ -226,9 +162,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:87
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:94
|
||||
@ -236,50 +170,13 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:96
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-service email2matrix` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-service email2matrix` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-email2matrix.md:98
|
||||
msgid ""
|
||||
"`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."
|
||||
msgid "`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: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."
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,18 +26,11 @@ msgid "Setting up Etherpad (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:3
|
||||
msgid ""
|
||||
"[Etherpad](https://etherpad.org) is an open source collaborative text "
|
||||
"editor that can be embedded in a Matrix chat room using the [Dimension "
|
||||
"integration manager](https://dimension.t2bot.io) or used as standalone "
|
||||
"web app."
|
||||
msgid "[Etherpad](https://etherpad.org) is an open source collaborative text editor that can be embedded in a Matrix chat room using the [Dimension integration manager](https://dimension.t2bot.io) or used as standalone web app."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:5
|
||||
msgid ""
|
||||
"When enabled together with the Jitsi audio/video conferencing system (see"
|
||||
" [our docs on Jitsi](configuring-playbook-jitsi.md)), it will be made "
|
||||
"available as an option during the conferences."
|
||||
msgid "When enabled together with the Jitsi audio/video conferencing system (see [our docs on Jitsi](configuring-playbook-jitsi.md)), it will be made available as an option during the conferences."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:7
|
||||
@ -45,9 +38,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:9
|
||||
msgid ""
|
||||
"To enable Etherpad, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Etherpad, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:19
|
||||
@ -55,23 +46,15 @@ msgid "Adjusting the Etherpad URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:21
|
||||
msgid ""
|
||||
"By default, this playbook installs Etherpad on the `etherpad.` subdomain "
|
||||
"(`etherpad.example.com`) and requires you to [adjust your DNS records"
|
||||
"](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs Etherpad on the `etherpad.` subdomain (`etherpad.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:23
|
||||
msgid ""
|
||||
"By tweaking the `etherpad_hostname` and `etherpad_path_prefix` variables,"
|
||||
" you can easily make the service available at a **different hostname "
|
||||
"and/or path** than the default one."
|
||||
msgid "By tweaking the `etherpad_hostname` and `etherpad_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-etherpad.md:25
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:36
|
||||
@ -79,21 +62,15 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:38
|
||||
msgid ""
|
||||
"Once you've decided on the domain and path, **you may need to adjust your"
|
||||
" DNS** records to point the Etherpad domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Etherpad domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:40
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `etherpad`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `etherpad`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:42
|
||||
msgid ""
|
||||
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
|
||||
" extra DNS configuration."
|
||||
msgid "If you've decided to reuse the `matrix.` domain, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:44
|
||||
@ -101,10 +78,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:46
|
||||
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:"
|
||||
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-etherpad.md:53
|
||||
@ -112,35 +86,19 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:55
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the Etherpad admin user (`etherpad_admin_username`)."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the Etherpad admin user (`etherpad_admin_username`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:57
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:59
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:61
|
||||
msgid ""
|
||||
"If you change the Etherpad admin user's password "
|
||||
"(`etherpad_admin_password` in your `vars.yml` file) subsequently, the "
|
||||
"admin user's credentials on the homeserver won't be updated "
|
||||
"automatically. If you'd like to change the admin user's password, use a "
|
||||
"tool like [synapse-admin](configuring-playbook-synapse-admin.md) to "
|
||||
"change it, and then update `etherpad_admin_password` to let the admin "
|
||||
"user know its new password."
|
||||
msgid "If you change the Etherpad admin user's password (`etherpad_admin_password` in your `vars.yml` file) subsequently, the admin user's credentials on the homeserver won't be updated automatically. If you'd like to change the admin user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `etherpad_admin_password` to let the admin user know its new password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:63
|
||||
@ -148,17 +106,11 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:65
|
||||
msgid ""
|
||||
"The Etherpad UI should be available at `https://etherpad.example.com`, "
|
||||
"while the admin UI (if enabled) should then be available at "
|
||||
"`https://etherpad.example.com/admin`."
|
||||
msgid "The Etherpad UI should be available at `https://etherpad.example.com`, while the admin UI (if enabled) should then be available at `https://etherpad.example.com/admin`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:67
|
||||
msgid ""
|
||||
"If you've [decided on another hostname or path-prefix](#adjusting-the-"
|
||||
"etherpad-url) (e.g. `https://matrix.example.com/etherpad`), adjust these "
|
||||
"URLs accordingly before usage."
|
||||
msgid "If you've [decided on another hostname or path-prefix](#adjusting-the-etherpad-url) (e.g. `https://matrix.example.com/etherpad`), adjust these URLs accordingly before usage."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:69
|
||||
@ -166,38 +118,23 @@ msgid "Managing / Deleting old pads"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:71
|
||||
msgid ""
|
||||
"If you want to manage and remove old unused pads from Etherpad, you will "
|
||||
"first need to able Admin access as described above."
|
||||
msgid "If you want to manage and remove old unused pads from Etherpad, you will first need to able Admin access as described above."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:73
|
||||
msgid ""
|
||||
"Then from the plugin manager page "
|
||||
"(`https://etherpad.example.com/admin/plugins`, install the `adminpads2` "
|
||||
"plugin. Once installed, you should have a \"Manage pads\" section in the "
|
||||
"Admin web-UI."
|
||||
msgid "Then from the plugin manager page (`https://etherpad.example.com/admin/plugins`, install the `adminpads2` plugin. Once installed, you should have a \"Manage pads\" section in the Admin web-UI."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:75
|
||||
msgid ""
|
||||
"How to use Etherpad widgets without an integration manager (like "
|
||||
"Dimension)"
|
||||
msgid "How to use Etherpad widgets without an integration manager (like Dimension)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:77
|
||||
msgid ""
|
||||
"This is how it works in Element Web, it might work quite similar with "
|
||||
"other clients:"
|
||||
msgid "This is how it works in Element Web, it might work quite similar with other clients:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:79
|
||||
msgid ""
|
||||
"To integrate a standalone Etherpad in a room, create your pad by visiting"
|
||||
" `https://etherpad.example.com`. When the pad opens, copy the URL and "
|
||||
"send a command like this to the room: `/addwidget URL`. You will then "
|
||||
"find your integrated Etherpad within the right sidebar in the `Widgets` "
|
||||
"section."
|
||||
msgid "To integrate a standalone Etherpad in a room, create your pad by visiting `https://etherpad.example.com`. When the pad opens, copy the URL and send a command like this to the room: `/addwidget URL`. You will then find your integrated Etherpad within the right sidebar in the `Widgets` section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:81
|
||||
@ -205,17 +142,11 @@ msgid "Set Dimension default to the self-hosted Etherpad (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:83
|
||||
msgid ""
|
||||
"If you decided to install [Dimension integration manager](configuring-"
|
||||
"playbook-dimension.md) alongside Etherpad, the Dimension administrator "
|
||||
"users can configure the default URL template."
|
||||
msgid "If you decided to install [Dimension integration manager](configuring-playbook-dimension.md) alongside Etherpad, the Dimension administrator users can configure the default URL template."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:85
|
||||
msgid ""
|
||||
"The Dimension configuration menu can be accessed with the sprocket icon "
|
||||
"as you begin to add a widget to a room in Element Web. There you will "
|
||||
"find the Etherpad Widget Configuration action beneath the _Widgets_ tab."
|
||||
msgid "The Dimension configuration menu can be accessed with the sprocket icon as you begin to add a widget to a room in Element Web. There you will find the Etherpad Widget Configuration action beneath the _Widgets_ tab."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:87
|
||||
@ -223,9 +154,7 @@ msgid "Removing the integrated Etherpad chat"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:89
|
||||
msgid ""
|
||||
"If you wish to disable the Etherpad chat button, you can do it by "
|
||||
"appending `?showChat=false` to the end of the pad URL, or the template."
|
||||
msgid "If you wish to disable the Etherpad chat button, you can do it by appending `?showChat=false` to the end of the pad URL, or the template."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:91
|
||||
@ -237,15 +166,9 @@ msgid "Known issues"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:95
|
||||
msgid ""
|
||||
"If your Etherpad widget fails to load, this might be due to Dimension "
|
||||
"generating a Pad name so long, the Etherpad app rejects it."
|
||||
msgid "If your Etherpad widget fails to load, this might be due to Dimension generating a Pad name so long, the Etherpad app rejects it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-etherpad.md:97
|
||||
msgid ""
|
||||
"`$roomId_$padName` can end up being longer than 50 characters. You can "
|
||||
"avoid having this problem by altering the template so it only contains "
|
||||
"the three word random identifier `$padName`."
|
||||
msgid "`$roomId_$padName` can end up being longer than 50 characters. You can avoid having this problem by altering the template so it only contains the three word random identifier `$padName`."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -22,56 +22,25 @@ msgid "Using an external PostgreSQL server (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-external-postgres.md:3
|
||||
msgid ""
|
||||
"By default, this playbook would set up a PostgreSQL database server on "
|
||||
"your machine, running in a Docker container. If that's okay, you can skip"
|
||||
" this document."
|
||||
msgid "By default, this playbook would set up a PostgreSQL database server on your machine, running in a Docker container. If that's okay, you can skip this document."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-external-postgres.md:5
|
||||
msgid ""
|
||||
"**Note**: using **an external Postgres server is currently [not very "
|
||||
"seamless](https://github.com/spantaleev/matrix-docker-ansible-"
|
||||
"deploy/issues/1682#issuecomment-1061461683) when it comes to enabling "
|
||||
"various other playbook services** - you will need to create a new "
|
||||
"database/credentials for each service and to point each service to its "
|
||||
"corresponding database using custom `vars.yml` configuration. **For the "
|
||||
"best experience with the playbook, stick to using the integrated Postgres"
|
||||
" server**."
|
||||
msgid "**Note**: using **an external Postgres server is currently [not very seamless](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/1682#issuecomment-1061461683) when it comes to enabling various other playbook services** - you will need to create a new database/credentials for each service and to point each service to its corresponding database using custom `vars.yml` configuration. **For the best experience with the playbook, stick to using the integrated Postgres server**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-external-postgres.md:7
|
||||
msgid ""
|
||||
"If you'd like to use an external Postgres server that you manage, add the"
|
||||
" following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
|
||||
"needs):"
|
||||
msgid "If you'd like to use an external Postgres server that you manage, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-external-postgres.md:23
|
||||
msgid ""
|
||||
"The database (as specified in `matrix_synapse_database_database`) must "
|
||||
"exist and be accessible with the given credentials. It must be empty or "
|
||||
"contain a valid Synapse database. If empty, Synapse would populate it the"
|
||||
" first time it runs."
|
||||
msgid "The database (as specified in `matrix_synapse_database_database`) must exist and be accessible with the given credentials. It must be empty or contain a valid Synapse database. If empty, Synapse would populate it the first time it runs."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-external-postgres.md:25
|
||||
msgid ""
|
||||
"**Note**: the external server that you specify in "
|
||||
"`matrix_synapse_database_host` must be accessible from within the "
|
||||
"`matrix-synapse` Docker container (and possibly other containers too). "
|
||||
"This means that it either needs to be a publicly accessible hostname or "
|
||||
"that it's a hostname on the same Docker network where all containers "
|
||||
"installed by this playbook run (a network called `matrix` by default). "
|
||||
"Using a local PostgreSQL instance on the host (running on the same "
|
||||
"machine, but not in a container) is not possible."
|
||||
msgid "**Note**: the external server that you specify in `matrix_synapse_database_host` must be accessible from within the `matrix-synapse` Docker container (and possibly other containers too). This means that it either needs to be a publicly accessible hostname or that it's a hostname on the same Docker network where all containers installed by this playbook run (a network called `matrix` by default). Using a local PostgreSQL instance on the host (running on the same machine, but not in a container) is not possible."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-external-postgres.md:27
|
||||
msgid ""
|
||||
"The connection to your external Postgres server **will not be SSL "
|
||||
"encrypted**, as [we don't support that yet](https://github.com/spantaleev"
|
||||
"/matrix-docker-ansible-deploy/issues/89)."
|
||||
msgid "The connection to your external Postgres server **will not be SSL encrypted**, as [we don't support that yet](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/89)."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,23 +26,11 @@ msgid "Controlling Matrix federation (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:3
|
||||
msgid ""
|
||||
"By default, your server federates with the whole Matrix network. That is,"
|
||||
" people on your server can communicate with people on any other Matrix "
|
||||
"server."
|
||||
msgid "By default, your server federates with the whole Matrix network. That is, people on your server can communicate with people on any other Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:5
|
||||
msgid ""
|
||||
"**Note**: in the sample `vars.yml` "
|
||||
"([`examples/vars.yml`](../examples/vars.yml)), we recommend to use a "
|
||||
"short user ID like `@alice:example.com` instead of "
|
||||
"`@alice:matrix.example.com` and set up [server delegation](howto-server-"
|
||||
"delegation.md) / redirection. Without a proper configuration, your server"
|
||||
" will effectively not be part of the Matrix network. If you find your "
|
||||
"server is not federated, make sure to [check whether services work"
|
||||
"](maintenance-checking-services.md) and your server is properly "
|
||||
"delegated."
|
||||
msgid "**Note**: in the sample `vars.yml` ([`examples/vars.yml`](../examples/vars.yml)), we recommend to use a short user ID like `@alice:example.com` instead of `@alice:matrix.example.com` and set up [server delegation](howto-server-delegation.md) / redirection. Without a proper configuration, your server will effectively not be part of the Matrix network. If you find your server is not federated, make sure to [check whether services work](maintenance-checking-services.md) and your server is properly delegated."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:7
|
||||
@ -50,17 +38,11 @@ msgid "Federating only with select servers"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:9
|
||||
msgid ""
|
||||
"To make your server only federate with servers of your choosing, add the "
|
||||
"following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
|
||||
"needs):"
|
||||
msgid "To make your server only federate with servers of your choosing, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:17
|
||||
msgid ""
|
||||
"If you wish to disable federation, you can do that with an empty list "
|
||||
"(`[]`), or better yet by completely disabling federation (see below)."
|
||||
msgid "If you wish to disable federation, you can do that with an empty list (`[]`), or better yet by completely disabling federation (see below)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:19
|
||||
@ -68,15 +50,11 @@ msgid "Exposing the room directory over federation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:21
|
||||
msgid ""
|
||||
"By default, your server's public rooms directory is not exposed to other "
|
||||
"servers via federation."
|
||||
msgid "By default, your server's public rooms directory is not exposed to other servers via federation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:23
|
||||
msgid ""
|
||||
"If you wish to expose it, add this to your configuration file "
|
||||
"(`inventory/host_vars/matrix.example.com/vars.yml`):"
|
||||
msgid "If you wish to expose it, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:29
|
||||
@ -84,56 +62,29 @@ msgid "Disabling federation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:31
|
||||
msgid ""
|
||||
"To completely disable federation, isolating your server from the rest of "
|
||||
"the Matrix network, add this to your configuration file "
|
||||
"(`inventory/host_vars/matrix.example.com/vars.yml`):"
|
||||
msgid "To completely disable federation, isolating your server from the rest of the Matrix network, add this to your configuration file (`inventory/host_vars/matrix.example.com/vars.yml`):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:37
|
||||
msgid ""
|
||||
"With that, your server's users will only be able to talk among "
|
||||
"themselves, but not to anyone who is on another server."
|
||||
msgid "With that, your server's users will only be able to talk among themselves, but not to anyone who is on another server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:39
|
||||
msgid ""
|
||||
"**Disabling federation does not necessarily disable the federation port**"
|
||||
" (`8448`). Services like [Dimension](configuring-playbook-dimension.md) "
|
||||
"and [ma1sd](configuring-playbook-ma1sd.md) normally rely on `openid` APIs"
|
||||
" exposed on that port. Even if you disable federation and only if "
|
||||
"necessary, we may still be exposing the federation port and serving the "
|
||||
"`openid` APIs there. To override this and completely disable Synapse's "
|
||||
"federation port use:"
|
||||
msgid "**Disabling federation does not necessarily disable the federation port** (`8448`). Services like [Dimension](configuring-playbook-dimension.md) and [ma1sd](configuring-playbook-ma1sd.md) normally rely on `openid` APIs exposed on that port. Even if you disable federation and only if necessary, we may still be exposing the federation port and serving the `openid` APIs there. To override this and completely disable Synapse's federation port use:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:51
|
||||
msgid ""
|
||||
"Changing the federation port from 8448 to a different port to use a CDN "
|
||||
"that only accepts 443/80 ports"
|
||||
msgid "Changing the federation port from 8448 to a different port to use a CDN that only accepts 443/80 ports"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:53
|
||||
msgid ""
|
||||
"Why? This change could be useful for people running small Synapse "
|
||||
"instances on small severs/VPSes to avoid being impacted by a simple "
|
||||
"DOS/DDOS when bandwidth, RAM, an CPU resources are limited and if your "
|
||||
"hosting provider does not provide a DOS/DDOS protection."
|
||||
msgid "Why? This change could be useful for people running small Synapse instances on small severs/VPSes to avoid being impacted by a simple DOS/DDOS when bandwidth, RAM, an CPU resources are limited and if your hosting provider does not provide a DOS/DDOS protection."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:55
|
||||
msgid ""
|
||||
"The following changes in the configuration file "
|
||||
"(`inventory/host_vars/matrix.example.com/vars.yml`) will allow this and "
|
||||
"make it possible to proxy the federation through a CDN such as CloudFlare"
|
||||
" or any other:"
|
||||
msgid "The following changes in the configuration file (`inventory/host_vars/matrix.example.com/vars.yml`) will allow this and make it possible to proxy the federation through a CDN such as CloudFlare or any other:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-federation.md:66
|
||||
msgid ""
|
||||
"**Use this at you own risk as all the possible side-effects of doing this"
|
||||
" are not fully known. However, it has been tested and works fine and "
|
||||
"passes all the tests on <https://federationtester.matrix.org/> without "
|
||||
"issues.**"
|
||||
msgid "**Use this at you own risk as all the possible side-effects of doing this are not fully known. However, it has been tested and works fine and passes all the tests on <https://federationtester.matrix.org/> without issues.**"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,23 +26,15 @@ msgid "Setting up the Jitsi video-conferencing platform (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:3
|
||||
msgid ""
|
||||
"The playbook can install the [Jitsi](https://jitsi.org/) video-"
|
||||
"conferencing platform and integrate it with Element clients ([Element Web"
|
||||
"](configuring-playbook-client-element-web.md)/Desktop, Android and iOS)."
|
||||
msgid "The playbook can install the [Jitsi](https://jitsi.org/) video-conferencing platform and integrate it with Element clients ([Element Web](configuring-playbook-client-element-web.md)/Desktop, Android and iOS)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:5
|
||||
msgid ""
|
||||
"Jitsi installation is **not enabled by default**, because it's not a core"
|
||||
" component of Matrix services."
|
||||
msgid "Jitsi installation is **not enabled by default**, because it's not a core component of Matrix services."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:7
|
||||
msgid ""
|
||||
"The setup done by the playbook is very similar to [docker-jitsi-"
|
||||
"meet](https://github.com/jitsi/docker-jitsi-meet). You can refer to the "
|
||||
"documentation there for many of the options here."
|
||||
msgid "The setup done by the playbook is very similar to [docker-jitsi-meet](https://github.com/jitsi/docker-jitsi-meet). You can refer to the documentation there for many of the options here."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:9
|
||||
@ -58,12 +50,7 @@ msgid "`4443/tcp` - RTP media fallback over TCP"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:14
|
||||
msgid ""
|
||||
"`10000/udp` - RTP media over UDP. Depending on your firewall/NAT setup, "
|
||||
"incoming RTP packets on port `10000` may have the external IP of your "
|
||||
"firewall as destination address, due to the usage of STUN in JVB (see "
|
||||
"[`jitsi_jvb_stun_servers`](https://github.com/mother-of-all-self-hosting"
|
||||
"/ansible-role-jitsi/blob/main/defaults/main.yml))."
|
||||
msgid "`10000/udp` - RTP media over UDP. Depending on your firewall/NAT setup, incoming RTP packets on port `10000` may have the external IP of your firewall as destination address, due to the usage of STUN in JVB (see [`jitsi_jvb_stun_servers`](https://github.com/mother-of-all-self-hosting/ansible-role-jitsi/blob/main/defaults/main.yml))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:16
|
||||
@ -71,9 +58,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:18
|
||||
msgid ""
|
||||
"To enable Jitsi, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Jitsi, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:24
|
||||
@ -81,22 +66,15 @@ msgid "Adjusting the Jitsi URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:26
|
||||
msgid ""
|
||||
"By default, this playbook installs Jitsi on the `jitsi.` subdomain "
|
||||
"(`jitsi.example.com`) and requires you to [adjust your DNS records"
|
||||
"](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs Jitsi on the `jitsi.` subdomain (`jitsi.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:28
|
||||
msgid ""
|
||||
"By tweaking the `jitsi_hostname` variable, you can easily make the "
|
||||
"service available at a **different hostname** than the default one."
|
||||
msgid "By tweaking the `jitsi_hostname` variable, you can easily make the service available at a **different hostname** than the default one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:30
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:37
|
||||
@ -104,15 +82,11 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:39
|
||||
msgid ""
|
||||
"Once you've decided on the domain and path, **you may need to adjust your"
|
||||
" DNS** records to point the Jitsi domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Jitsi domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:41
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `jitsi`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `jitsi`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:43
|
||||
@ -120,36 +94,23 @@ msgid "(Optional) Configure Jitsi authentication and guests mode"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:45
|
||||
msgid ""
|
||||
"By default the Jitsi Meet instance does not require any kind of login and"
|
||||
" is open to use for anyone without registration."
|
||||
msgid "By default the Jitsi Meet instance does not require any kind of login and is open to use for anyone without registration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:47
|
||||
msgid ""
|
||||
"If you're fine with such an open Jitsi instance, please skip to "
|
||||
"[Installing](#installing)."
|
||||
msgid "If you're fine with such an open Jitsi instance, please skip to [Installing](#installing)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:49
|
||||
msgid ""
|
||||
"If you would like to control who is allowed to open meetings on your new "
|
||||
"Jitsi instance, then please follow the following steps to enable Jitsi's "
|
||||
"authentication and optionally guests mode."
|
||||
msgid "If you would like to control who is allowed to open meetings on your new Jitsi instance, then please follow the following steps to enable Jitsi's authentication and optionally guests mode."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:51
|
||||
msgid ""
|
||||
"Currently, there are three supported authentication modes: 'internal' "
|
||||
"(default), 'matrix' and 'ldap'."
|
||||
msgid "Currently, there are three supported authentication modes: 'internal' (default), 'matrix' and 'ldap'."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:53
|
||||
msgid ""
|
||||
"**Note**: Authentication is not tested via the playbook's self-checks. We"
|
||||
" therefore recommend that you manually verify if authentication is "
|
||||
"required by jitsi. For this, try to manually create a conference on "
|
||||
"jitsi.example.com in your browser."
|
||||
msgid "**Note**: Authentication is not tested via the playbook's self-checks. We therefore recommend that you manually verify if authentication is required by jitsi. For this, try to manually create a conference on jitsi.example.com in your browser."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:55
|
||||
@ -157,35 +118,19 @@ msgid "Authenticate using Jitsi accounts (Auth-Type 'internal')"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:57
|
||||
msgid ""
|
||||
"The default authentication mechanism is 'internal' auth, which requires "
|
||||
"jitsi-accounts to be setup and is the recommended setup, as it also works"
|
||||
" in federated rooms. With authentication enabled, all meeting rooms have "
|
||||
"to be opened by a registered user, after which guests are free to join. "
|
||||
"If a registered host is not yet present, guests are put on hold in "
|
||||
"individual waiting rooms."
|
||||
msgid "The default authentication mechanism is 'internal' auth, which requires jitsi-accounts to be setup and is the recommended setup, as it also works in federated rooms. With authentication enabled, all meeting rooms have to be opened by a registered user, after which guests are free to join. If a registered host is not yet present, guests are put on hold in individual waiting rooms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:59
|
||||
msgid ""
|
||||
"Add these lines to your `inventory/host_vars/matrix.example.com/vars.yml`"
|
||||
" configuration:"
|
||||
msgid "Add these lines to your `inventory/host_vars/matrix.example.com/vars.yml` configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:71
|
||||
msgid ""
|
||||
"**Caution**: Accounts added here and subsequently removed will not be "
|
||||
"automatically removed from the Prosody server until user account cleaning"
|
||||
" is integrated into the playbook."
|
||||
msgid "**Caution**: Accounts added here and subsequently removed will not be automatically removed from the Prosody server until user account cleaning is integrated into the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:73
|
||||
msgid ""
|
||||
"**If you get an error** like this: \"Error: Account creation/modification"
|
||||
" not supported.\", it's likely that you had previously installed Jitsi "
|
||||
"without auth/guest support. In such a case, you should look into "
|
||||
"[Rebuilding your Jitsi installation](#rebuilding-your-jitsi-"
|
||||
"installation)."
|
||||
msgid "**If you get an error** like this: \"Error: Account creation/modification not supported.\", it's likely that you had previously installed Jitsi without auth/guest support. In such a case, you should look into [Rebuilding your Jitsi installation](#rebuilding-your-jitsi-installation)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:75
|
||||
@ -193,18 +138,11 @@ msgid "Authenticate using Matrix OpenID (Auth-Type 'matrix')"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:77
|
||||
msgid ""
|
||||
"**Attention: Probably breaks Jitsi in federated rooms and does not allow "
|
||||
"sharing conference links with guests.**"
|
||||
msgid "**Attention: Probably breaks Jitsi in federated rooms and does not allow sharing conference links with guests.**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:79
|
||||
msgid ""
|
||||
"Using this authentication type require a [Matrix User Verification "
|
||||
"Service](https://github.com/matrix-org/matrix-user-verification-service)."
|
||||
" By default, this playbook creates and configures a user-verification-"
|
||||
"service to run locally, see [configuring-user-verification-service"
|
||||
"](configuring-playbook-user-verification-service.md)."
|
||||
msgid "Using this authentication type require a [Matrix User Verification Service](https://github.com/matrix-org/matrix-user-verification-service). By default, this playbook creates and configures a user-verification-service to run locally, see [configuring-user-verification-service](configuring-playbook-user-verification-service.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:81
|
||||
@ -212,10 +150,7 @@ msgid "To enable set this configuration at host level:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:89
|
||||
msgid ""
|
||||
"For more information see also [https://github.com/matrix-org/prosody-mod-"
|
||||
"auth-matrix-user-verification](https://github.com/matrix-org/prosody-mod-"
|
||||
"auth-matrix-user-verification)."
|
||||
msgid "For more information see also [https://github.com/matrix-org/prosody-mod-auth-matrix-user-verification](https://github.com/matrix-org/prosody-mod-auth-matrix-user-verification)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:91
|
||||
@ -227,11 +162,7 @@ msgid "An example LDAP configuration could be:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:113
|
||||
msgid ""
|
||||
"For more information refer to the [docker-jitsi-"
|
||||
"meet](https://github.com/jitsi/docker-jitsi-meet#authentication-using-"
|
||||
"ldap) and the [saslauthd `LDAP_SASLAUTHD`](https://github.com/winlibs"
|
||||
"/cyrus-sasl/blob/master/saslauthd/LDAP_SASLAUTHD) documentation."
|
||||
msgid "For more information refer to the [docker-jitsi-meet](https://github.com/jitsi/docker-jitsi-meet#authentication-using-ldap) and the [saslauthd `LDAP_SASLAUTHD`](https://github.com/winlibs/cyrus-sasl/blob/master/saslauthd/LDAP_SASLAUTHD) documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:115
|
||||
@ -239,20 +170,11 @@ msgid "(Optional) Making your Jitsi server work on a LAN"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:117
|
||||
msgid ""
|
||||
"By default the Jitsi Meet instance does not work with a client in LAN "
|
||||
"(Local Area Network), even if others are connected from WAN. There are no"
|
||||
" video and audio. In the case of WAN to WAN everything is ok."
|
||||
msgid "By default the Jitsi Meet instance does not work with a client in LAN (Local Area Network), even if others are connected from WAN. There are no video and audio. In the case of WAN to WAN everything is ok."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:119
|
||||
msgid ""
|
||||
"The reason is the Jitsi VideoBridge git to LAN client the IP address of "
|
||||
"the docker image instead of the host. The "
|
||||
"[documentation](https://jitsi.github.io/handbook/docs/devops-guide"
|
||||
"/devops-guide-docker/#running-behind-nat-or-on-a-lan-environment) of "
|
||||
"Jitsi in docker suggest to add `JVB_ADVERTISE_IPS` in enviornment "
|
||||
"variable to make it work."
|
||||
msgid "The reason is the Jitsi VideoBridge git to LAN client the IP address of the docker image instead of the host. The [documentation](https://jitsi.github.io/handbook/docs/devops-guide/devops-guide-docker/#running-behind-nat-or-on-a-lan-environment) of Jitsi in docker suggest to add `JVB_ADVERTISE_IPS` in enviornment variable to make it work."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:121
|
||||
@ -260,9 +182,7 @@ msgid "Here is how to do it in the playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:123
|
||||
msgid ""
|
||||
"Add these two lines to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` configuration:"
|
||||
msgid "Add these two lines to your `inventory/host_vars/matrix.example.com/vars.yml` configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:130
|
||||
@ -270,42 +190,23 @@ msgid "(Optional) Fine tune Jitsi"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:132
|
||||
msgid ""
|
||||
"Sample **additional** `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"configuration to save up resources (explained below):"
|
||||
msgid "Sample **additional** `inventory/host_vars/matrix.example.com/vars.yml` configuration to save up resources (explained below):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:147
|
||||
msgid ""
|
||||
"You may want to **suspend unused video layers** until they are requested "
|
||||
"again, to save up resources on both server and clients. Read more on this"
|
||||
" feature [here](https://jitsi.org/blog/new-off-stage-layer-suppression-"
|
||||
"feature/)"
|
||||
msgid "You may want to **suspend unused video layers** until they are requested again, to save up resources on both server and clients. Read more on this feature [here](https://jitsi.org/blog/new-off-stage-layer-suppression-feature/)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:149
|
||||
msgid ""
|
||||
"You may wish to **disable audio levels** to avoid excessive refresh of "
|
||||
"the client-side page and decrease the CPU consumption involved."
|
||||
msgid "You may wish to **disable audio levels** to avoid excessive refresh of the client-side page and decrease the CPU consumption involved."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:151
|
||||
msgid ""
|
||||
"You may want to **limit the number of video feeds forwarded to each "
|
||||
"client**, to save up resources on both server and clients. As clients’ "
|
||||
"bandwidth and CPU may not bear the load, use this setting to avoid lag "
|
||||
"and crashes. This feature is found by default in other webconference "
|
||||
"applications such as Office 365 Teams (limit is set to 4). Read how it "
|
||||
"works [here](https://github.com/jitsi/jitsi-"
|
||||
"videobridge/blob/master/doc/last-n.md) and performance evaluation on this"
|
||||
" [study](https://jitsi.org/wp-"
|
||||
"content/uploads/2016/12/nossdav2015lastn.pdf)."
|
||||
msgid "You may want to **limit the number of video feeds forwarded to each client**, to save up resources on both server and clients. As clients’ bandwidth and CPU may not bear the load, use this setting to avoid lag and crashes. This feature is found by default in other webconference applications such as Office 365 Teams (limit is set to 4). Read how it works [here](https://github.com/jitsi/jitsi-videobridge/blob/master/doc/last-n.md) and performance evaluation on this [study](https://jitsi.org/wp-content/uploads/2016/12/nossdav2015lastn.pdf)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:153
|
||||
msgid ""
|
||||
"You may want to **limit the maximum video resolution**, to save up "
|
||||
"resources on both server and clients."
|
||||
msgid "You may want to **limit the maximum video resolution**, to save up resources on both server and clients."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:155
|
||||
@ -313,15 +214,11 @@ msgid "(Optional) Specify a Max number of participants on a Jitsi conference"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:157
|
||||
msgid ""
|
||||
"The playbook allows a user to set a max number of participants allowed to"
|
||||
" join a Jitsi conference. By default there is no limit."
|
||||
msgid "The playbook allows a user to set a max number of participants allowed to join a Jitsi conference. By default there is no limit."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:159
|
||||
msgid ""
|
||||
"In order to set the max number of participants use the following "
|
||||
"**additional** configuration:"
|
||||
msgid "In order to set the max number of participants use the following **additional** configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:165
|
||||
@ -329,73 +226,39 @@ msgid "(Optional) Additional JVBs"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:167
|
||||
msgid ""
|
||||
"By default, a single JVB ([Jitsi VideoBridge](https://github.com/jitsi"
|
||||
"/jitsi-videobridge)) is deployed on the same host as the Matrix server. "
|
||||
"To allow more video-conferences to happen at the same time, you may need "
|
||||
"to provision additional JVB services on other hosts."
|
||||
msgid "By default, a single JVB ([Jitsi VideoBridge](https://github.com/jitsi/jitsi-videobridge)) is deployed on the same host as the Matrix server. To allow more video-conferences to happen at the same time, you may need to provision additional JVB services on other hosts."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:169
|
||||
msgid ""
|
||||
"There is an ansible playbook that can be run with the following tag: "
|
||||
"`ansible-playbook -i inventory/hosts --limit jitsi_jvb_servers "
|
||||
"jitsi_jvb.yml --tags=common,setup-additional-jitsi-jvb,start`"
|
||||
msgid "There is an ansible playbook that can be run with the following tag: `ansible-playbook -i inventory/hosts --limit jitsi_jvb_servers jitsi_jvb.yml --tags=common,setup-additional-jitsi-jvb,start`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:171
|
||||
msgid ""
|
||||
"For this role to work you will need an additional section in the ansible "
|
||||
"hosts file with the details of the JVB hosts, for example:"
|
||||
msgid "For this role to work you will need an additional section in the ansible hosts file with the details of the JVB hosts, for example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:178
|
||||
msgid ""
|
||||
"Each JVB will require a server ID to be set so that it can be uniquely "
|
||||
"identified and this allows Jitsi to keep track of which conferences are "
|
||||
"on which JVB. The server ID is set with the variable "
|
||||
"`jitsi_jvb_server_id` which ends up as the JVB_WS_SERVER_ID environment "
|
||||
"variables in the JVB docker container. This variable can be set via the "
|
||||
"host file, a parameter to the ansible command or in the `vars.yaml` for "
|
||||
"the host which will have the additional JVB. For example:"
|
||||
msgid "Each JVB will require a server ID to be set so that it can be uniquely identified and this allows Jitsi to keep track of which conferences are on which JVB. The server ID is set with the variable `jitsi_jvb_server_id` which ends up as the JVB_WS_SERVER_ID environment variables in the JVB docker container. This variable can be set via the host file, a parameter to the ansible command or in the `vars.yaml` for the host which will have the additional JVB. For example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:190
|
||||
msgid ""
|
||||
"Note that the server ID `jvb-1` is reserved for the JVB instance running "
|
||||
"on the Matrix host and therefore should not be used as the ID of an "
|
||||
"additional jvb host."
|
||||
msgid "Note that the server ID `jvb-1` is reserved for the JVB instance running on the Matrix host and therefore should not be used as the ID of an additional jvb host."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:192
|
||||
msgid ""
|
||||
"The additional JVB will also need to expose the colibri web socket port "
|
||||
"and this can be done with the following variable:"
|
||||
msgid "The additional JVB will also need to expose the colibri web socket port and this can be done with the following variable:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:198
|
||||
msgid ""
|
||||
"The JVB will also need to know where the prosody xmpp server is located, "
|
||||
"similar to the server ID this can be set in the vars for the JVB by using"
|
||||
" the variable `jitsi_xmpp_server`. The Jitsi prosody container is "
|
||||
"deployed on the Matrix server by default so the value can be set to the "
|
||||
"Matrix domain. For example:"
|
||||
msgid "The JVB will also need to know where the prosody xmpp server is located, similar to the server ID this can be set in the vars for the JVB by using the variable `jitsi_xmpp_server`. The Jitsi prosody container is deployed on the Matrix server by default so the value can be set to the Matrix domain. For example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:204
|
||||
msgid ""
|
||||
"However, it can also be set the ip address of the Matrix server. This can"
|
||||
" be useful if you wish to use a private ip. For example:"
|
||||
msgid "However, it can also be set the ip address of the Matrix server. This can be useful if you wish to use a private ip. For example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:210
|
||||
msgid ""
|
||||
"For the JVB to be able to contact the XMPP server, the latter must expose"
|
||||
" the XMPP port (5222). By default, the Matrix server does not expose the "
|
||||
"port; only the XMPP container exposes it internally inside the host, "
|
||||
"which means that the first JVB (which runs on the Matrix server) can "
|
||||
"reach it but the additional JVB cannot. The port is exposed by setting "
|
||||
"`jitsi_prosody_container_jvb_host_bind_port` like this:"
|
||||
msgid "For the JVB to be able to contact the XMPP server, the latter must expose the XMPP port (5222). By default, the Matrix server does not expose the port; only the XMPP container exposes it internally inside the host, which means that the first JVB (which runs on the Matrix server) can reach it but the additional JVB cannot. The port is exposed by setting `jitsi_prosody_container_jvb_host_bind_port` like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:216
|
||||
@ -403,17 +266,11 @@ msgid "(The default is empty; if it's set then docker forwards the port.)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:218
|
||||
msgid ""
|
||||
"Applied together this will allow you to provision extra JVB instances "
|
||||
"which will register themselves with the prosody service and be available "
|
||||
"for jicofo to route conferences too."
|
||||
msgid "Applied together this will allow you to provision extra JVB instances which will register themselves with the prosody service and be available for jicofo to route conferences too."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:220
|
||||
msgid ""
|
||||
"To make Traefik reverse-proxy to these additional JVBs (living on other "
|
||||
"hosts), **you would need to add the following Traefik configuration "
|
||||
"extension**:"
|
||||
msgid "To make Traefik reverse-proxy to these additional JVBs (living on other hosts), **you would need to add the following Traefik configuration extension**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:256
|
||||
@ -421,11 +278,7 @@ msgid "(Optional) Enable Gravatar"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:258
|
||||
msgid ""
|
||||
"In the default Jisti Meet configuration, gravatar.com is enabled as an "
|
||||
"avatar service. This results in third party request leaking data to "
|
||||
"gravatar. Since Element clients already send the url of configured Matrix"
|
||||
" avatars to Jitsi, we disabled gravatar."
|
||||
msgid "In the default Jisti Meet configuration, gravatar.com is enabled as an avatar service. This results in third party request leaking data to gravatar. Since Element clients already send the url of configured Matrix avatars to Jitsi, we disabled gravatar."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:260
|
||||
@ -433,11 +286,7 @@ msgid "To enable Gravatar set:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:266
|
||||
msgid ""
|
||||
"**Beware**: This leaks information to a third party, namely the Gravatar-"
|
||||
"Service (unless configured otherwise: gravatar.com). Besides metadata, "
|
||||
"this includes the Matrix user_id and possibly the room identifier (via "
|
||||
"`referrer` header)."
|
||||
msgid "**Beware**: This leaks information to a third party, namely the Gravatar-Service (unless configured otherwise: gravatar.com). Besides metadata, this includes the Matrix user_id and possibly the room identifier (via `referrer` header)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:268
|
||||
@ -445,26 +294,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:270
|
||||
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:"
|
||||
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-jitsi.md:277
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:279
|
||||
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."
|
||||
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-jitsi.md:281
|
||||
@ -476,34 +314,19 @@ msgid "You can use the self-hosted Jitsi server in multiple ways:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:285
|
||||
msgid ""
|
||||
"**by adding a widget to a room via Element Web** (the one configured by "
|
||||
"the playbook at `https://element.example.com`). Just start a voice or a "
|
||||
"video call in a room containing more than 2 members and that would create"
|
||||
" a Jitsi widget which utilizes your self-hosted Jitsi server."
|
||||
msgid "**by adding a widget to a room via Element Web** (the one configured by the playbook at `https://element.example.com`). Just start a voice or a video call in a room containing more than 2 members and that would create a Jitsi widget which utilizes your self-hosted Jitsi server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:287
|
||||
msgid ""
|
||||
"**by adding a widget to a room via the Dimension integration manager**. "
|
||||
"You'll have to point the widget to your own Jitsi server manually. See "
|
||||
"our [Dimension integration manager](./configuring-playbook-dimension.md) "
|
||||
"documentation page for more details. Naturally, Dimension would need to "
|
||||
"be installed first (the playbook doesn't install it by default)."
|
||||
msgid "**by adding a widget to a room via the Dimension integration manager**. You'll have to point the widget to your own Jitsi server manually. See our [Dimension integration manager](./configuring-playbook-dimension.md) documentation page for more details. Naturally, Dimension would need to be installed first (the playbook doesn't install it by default)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:289
|
||||
msgid ""
|
||||
"**directly (without any Matrix integration)**. Just go to "
|
||||
"`https://jitsi.example.com`"
|
||||
msgid "**directly (without any Matrix integration)**. Just go to `https://jitsi.example.com`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:291
|
||||
msgid ""
|
||||
"**Note**: Element apps on mobile devices currently [don't support joining"
|
||||
" meetings on a self-hosted Jitsi server](https://github.com/element-hq"
|
||||
"/riot-web/blob/601816862f7d84ac47547891bd53effa73d32957/docs/jitsi.md"
|
||||
"#mobile-app-support)."
|
||||
msgid "**Note**: Element apps on mobile devices currently [don't support joining meetings on a self-hosted Jitsi server](https://github.com/element-hq/riot-web/blob/601816862f7d84ac47547891bd53effa73d32957/docs/jitsi.md#mobile-app-support)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:293
|
||||
@ -515,22 +338,15 @@ msgid "Rebuilding your Jitsi installation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:297
|
||||
msgid ""
|
||||
"**If you ever run into any trouble** or **if you change configuration "
|
||||
"(`jitsi_*` variables) too much**, we urge you to rebuild your Jitsi "
|
||||
"setup."
|
||||
msgid "**If you ever run into any trouble** or **if you change configuration (`jitsi_*` variables) too much**, we urge you to rebuild your Jitsi setup."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:299
|
||||
msgid ""
|
||||
"We normally don't require such manual intervention for other services, "
|
||||
"but Jitsi services generate a lot of configuration files on their own."
|
||||
msgid "We normally don't require such manual intervention for other services, but Jitsi services generate a lot of configuration files on their own."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:301
|
||||
msgid ""
|
||||
"These files are not all managed by Ansible (at least not yet), so you may"
|
||||
" sometimes need to delete them all and start fresh."
|
||||
msgid "These files are not all managed by Ansible (at least not yet), so you may sometimes need to delete them all and start fresh."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:303
|
||||
@ -538,20 +354,13 @@ msgid "To rebuild your Jitsi configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:305
|
||||
msgid ""
|
||||
"ask Ansible to stop all Jitsi services: `just run-tags stop-group "
|
||||
"--extra-vars=group=jitsi`"
|
||||
msgid "ask Ansible to stop all Jitsi services: `just run-tags stop-group --extra-vars=group=jitsi`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:306
|
||||
msgid ""
|
||||
"SSH into the server and do this and remove all Jitsi configuration & data"
|
||||
" (`rm -rf /matrix/jitsi`)"
|
||||
msgid "SSH into the server and do this and remove all Jitsi configuration & data (`rm -rf /matrix/jitsi`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-jitsi.md:307
|
||||
msgid ""
|
||||
"ask Ansible to set up Jitsi anew and restart services (`just install-"
|
||||
"service jitsi`)"
|
||||
msgid "ask Ansible to set up Jitsi anew and restart services (`just install-service jitsi`)"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -22,31 +22,19 @@ msgstr ""
|
||||
"Generated-By: Babel 2.16.0\n"
|
||||
|
||||
#: ../../../docs/configuring-playbook-ldap-auth.md:1
|
||||
msgid ""
|
||||
"Setting up the LDAP authentication password provider module (optional, "
|
||||
"advanced)"
|
||||
msgid "Setting up the LDAP authentication password provider module (optional, advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ldap-auth.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [matrix-synapse-"
|
||||
"ldap3](https://github.com/matrix-org/matrix-synapse-ldap3) LDAP Auth "
|
||||
"password provider for you."
|
||||
msgid "The playbook can install and configure the [matrix-synapse-ldap3](https://github.com/matrix-org/matrix-synapse-ldap3) LDAP Auth password provider for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ldap-auth.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
msgid ""
|
||||
"If you decide that you'd like to let this playbook install it for you, "
|
||||
"add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
|
||||
"needs):"
|
||||
msgid "If you decide that you'd like to let this playbook install it for you, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ldap-auth.md:24
|
||||
@ -54,10 +42,7 @@ msgid "Authenticating only using a password provider"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ldap-auth.md:26
|
||||
msgid ""
|
||||
"If you wish for users to **authenticate only against configured password "
|
||||
"providers** (like this one), **without consulting Synapse's local "
|
||||
"database**, feel free to disable it:"
|
||||
msgid "If you wish for users to **authenticate only against configured password providers** (like this one), **without consulting Synapse's local database**, feel free to disable it:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ldap-auth.md:32
|
||||
@ -65,11 +50,7 @@ msgid "Using ma1sd Identity Server for authentication"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ldap-auth.md:34
|
||||
msgid ""
|
||||
"If you wish to use the ma1sd Identity Server for LDAP authentication "
|
||||
"instead of [matrix-synapse-ldap3](https://github.com/matrix-org/matrix-"
|
||||
"synapse-ldap3) consult [Adjusting ma1sd Identity Server configuration"
|
||||
"](configuring-playbook-ma1sd.md#authentication)."
|
||||
msgid "If you wish to use the ma1sd Identity Server for LDAP authentication instead of [matrix-synapse-ldap3](https://github.com/matrix-org/matrix-synapse-ldap3) consult [Adjusting ma1sd Identity Server configuration](configuring-playbook-ma1sd.md#authentication)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ldap-auth.md:36
|
||||
@ -77,15 +58,5 @@ msgid "Handling user registration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ldap-auth.md:38
|
||||
msgid ""
|
||||
"If you wish for users to also be able to make new registrations against "
|
||||
"LDAP, you may **also** wish to [set up the ldap-registration-proxy"
|
||||
"](configuring-playbook-matrix-ldap-registration-proxy.md)."
|
||||
msgid "If you wish for users to also be able to make new registrations against LDAP, you may **also** wish to [set up the ldap-registration-proxy](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 ""
|
||||
|
||||
|
||||
@ -26,45 +26,23 @@ msgid "Setting up ma1sd Identity Server (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:3
|
||||
msgid ""
|
||||
"**⚠️Note**: ma1sd itself has also been unmaintained for years (the latest"
|
||||
" commit and release being from 2021). The role of identity servers in the"
|
||||
" Matrix specification also has an uncertain future. **We recommend not "
|
||||
"bothering with installing it unless it's the only way you can do what you"
|
||||
" need to do**. For example, certain things like LDAP integration can also"
|
||||
" be implemented via [the LDAP provider module for Synapse](./configuring-"
|
||||
"playbook-ldap-auth.md)."
|
||||
msgid "**⚠️Note**: ma1sd itself has also been unmaintained for years (the latest commit and release being from 2021). The role of identity servers in the Matrix specification also has an uncertain future. **We recommend not bothering with installing it unless it's the only way you can do what you need to do**. For example, certain things like LDAP integration can also be implemented via [the LDAP provider module for Synapse](./configuring-playbook-ldap-auth.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:5
|
||||
msgid ""
|
||||
"The playbook can configure the [ma1sd](https://github.com/ma1uta/ma1sd) "
|
||||
"Identity Server for you. It is a fork of [mxisd](https://github.com"
|
||||
"/kamax-io/mxisd) which was pronounced end of life 2019-06-21."
|
||||
msgid "The playbook can configure the [ma1sd](https://github.com/ma1uta/ma1sd) Identity Server for you. It is a fork of [mxisd](https://github.com/kamax-io/mxisd) which was pronounced end of life 2019-06-21."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:7
|
||||
msgid ""
|
||||
"ma1sd is used for 3PIDs (3rd party identifiers like E-mail and phone "
|
||||
"numbers) and some [enhanced "
|
||||
"features](https://github.com/ma1uta/ma1sd/#features). It is private by "
|
||||
"default, potentially at the expense of user discoverability."
|
||||
msgid "ma1sd is used for 3PIDs (3rd party identifiers like E-mail and phone numbers) and some [enhanced features](https://github.com/ma1uta/ma1sd/#features). It is private by default, potentially at the expense of user discoverability."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:9
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
msgid ""
|
||||
"**Note**: enabling ma1sd, 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 "**Note**: enabling ma1sd, 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-ma1sd.md:13
|
||||
@ -72,9 +50,7 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:15
|
||||
msgid ""
|
||||
"To make the ma1sd Identity Server enable its federation features, set up "
|
||||
"a SRV record that looks like this:"
|
||||
msgid "To make the ma1sd Identity Server enable its federation features, set up a SRV record that looks like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:17
|
||||
@ -82,24 +58,15 @@ msgid "Name: `_matrix-identity._tcp` (use this text as-is)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:18
|
||||
msgid ""
|
||||
"Content: `10 0 443 matrix.example.com` (replace `example.com` with your "
|
||||
"own)"
|
||||
msgid "Content: `10 0 443 matrix.example.com` (replace `example.com` with your own)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:20
|
||||
msgid ""
|
||||
"See [ma1sd's documentation](https://github.com/ma1uta/ma1sd/wiki/mxisd-"
|
||||
"and-your-privacy#choices-are-never-easy) for information on the privacy "
|
||||
"implications of setting up this SRV record."
|
||||
msgid "See [ma1sd's documentation](https://github.com/ma1uta/ma1sd/wiki/mxisd-and-your-privacy#choices-are-never-easy) for information on the privacy implications of setting up this SRV record."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:22
|
||||
msgid ""
|
||||
"**Note**: This `_matrix-identity._tcp` SRV record for the identity server"
|
||||
" is different from the `_matrix._tcp` that can be used for Synapse "
|
||||
"delegation. See [howto-server-delegation.md](howto-server-delegation.md) "
|
||||
"for more information about delegation."
|
||||
msgid "**Note**: This `_matrix-identity._tcp` SRV record for the identity server is different from the `_matrix._tcp` that can be used for Synapse delegation. See [howto-server-delegation.md](howto-server-delegation.md) for more information about delegation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:24
|
||||
@ -107,9 +74,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:26
|
||||
msgid ""
|
||||
"To enable ma1sd, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable ma1sd, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:32
|
||||
@ -117,23 +82,15 @@ msgid "Matrix.org lookup forwarding"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:34
|
||||
msgid ""
|
||||
"To ensure maximum discovery, you can make your identity server also "
|
||||
"forward lookups to the central matrix.org Identity server (at the cost of"
|
||||
" potentially leaking all your contacts information)."
|
||||
msgid "To ensure maximum discovery, you can make your identity server also forward lookups to the central matrix.org Identity server (at the cost of potentially leaking all your contacts information)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:36
|
||||
msgid ""
|
||||
"Enabling this is discouraged and you'd better [learn "
|
||||
"more](https://github.com/ma1uta/ma1sd/blob/master/docs/features/identity.md#lookups)"
|
||||
" before proceeding."
|
||||
msgid "Enabling this is discouraged and you'd better [learn more](https://github.com/ma1uta/ma1sd/blob/master/docs/features/identity.md#lookups) before proceeding."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:38
|
||||
msgid ""
|
||||
"To enable matrix.org forwarding, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable matrix.org forwarding, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:44
|
||||
@ -141,33 +98,19 @@ msgid "Additional features"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:46
|
||||
msgid ""
|
||||
"What this playbook configures for your is some bare minimum Identity "
|
||||
"Server functionality, so that you won't need to rely on external 3rd "
|
||||
"party services."
|
||||
msgid "What this playbook configures for your is some bare minimum Identity Server functionality, so that you won't need to rely on external 3rd party services."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:48
|
||||
msgid ""
|
||||
"A few variables can be toggled in this playbook to alter the ma1sd "
|
||||
"configuration that gets generated."
|
||||
msgid "A few variables can be toggled in this playbook to alter the ma1sd configuration that gets generated."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:50
|
||||
msgid ""
|
||||
"Still, ma1sd can do much more. You can refer to the [ma1sd "
|
||||
"website](https://github.com/ma1uta/ma1sd) for more details and "
|
||||
"configuration options."
|
||||
msgid "Still, ma1sd can do much more. You can refer to the [ma1sd website](https://github.com/ma1uta/ma1sd) for more details and configuration options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:52
|
||||
msgid ""
|
||||
"To use a more custom configuration, you can define a "
|
||||
"`matrix_ma1sd_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_ma1sd_configuration_extension_yaml` in the "
|
||||
"[default variables file](../roles/custom/matrix-ma1sd/defaults/main.yml) "
|
||||
"of the ma1sd component."
|
||||
msgid "To use a more custom configuration, you can define a `matrix_ma1sd_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_ma1sd_configuration_extension_yaml` in the [default variables file](../roles/custom/matrix-ma1sd/defaults/main.yml) of the ma1sd component."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:54
|
||||
@ -175,10 +118,7 @@ msgid "Customizing email templates"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:56
|
||||
msgid ""
|
||||
"If you'd like to change the default email templates used by ma1sd, take a"
|
||||
" look at the `matrix_ma1sd_threepid_medium_email_custom_` variables (in "
|
||||
"the `roles/custom/matrix-ma1sd/defaults/main.yml` file."
|
||||
msgid "If you'd like to change the default email templates used by ma1sd, take a look at the `matrix_ma1sd_threepid_medium_email_custom_` variables (in the `roles/custom/matrix-ma1sd/defaults/main.yml` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:58
|
||||
@ -186,59 +126,31 @@ msgid "ma1sd-controlled Registration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:60
|
||||
msgid ""
|
||||
"To use the "
|
||||
"[Registration](https://github.com/ma1uta/ma1sd/blob/master/docs/features/registration.md)"
|
||||
" feature of ma1sd, you can make use of the following variables:"
|
||||
msgid "To use the [Registration](https://github.com/ma1uta/ma1sd/blob/master/docs/features/registration.md) feature of ma1sd, you can make use of the following variables:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:62
|
||||
msgid ""
|
||||
"`matrix_synapse_enable_registration` - to enable user-initiated "
|
||||
"registration in Synapse"
|
||||
msgid "`matrix_synapse_enable_registration` - to enable user-initiated registration in Synapse"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:64
|
||||
msgid ""
|
||||
"`matrix_synapse_enable_registration_captcha` - to validate registering "
|
||||
"users using reCAPTCHA, as described in the [enabling reCAPTCHA"
|
||||
"](configuring-captcha.md) documentation."
|
||||
msgid "`matrix_synapse_enable_registration_captcha` - to validate registering users using reCAPTCHA, as described in the [enabling reCAPTCHA](configuring-captcha.md) documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:66
|
||||
msgid ""
|
||||
"`matrix_synapse_registrations_require_3pid` - a list of 3pid types (among"
|
||||
" `'email'`, `'msisdn'`) required by the Synapse server for registering"
|
||||
msgid "`matrix_synapse_registrations_require_3pid` - a list of 3pid types (among `'email'`, `'msisdn'`) required by the Synapse server for registering"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:68
|
||||
msgid ""
|
||||
"variables prefixed with `matrix_ma1sd_container_labels_` (e.g. "
|
||||
"`matrix_ma1sd_container_labels_matrix_client_3pid_registration_enabled`) "
|
||||
"- to configure the Traefik reverse-proxy to capture and send registration"
|
||||
" requests to ma1sd (instead of Synapse), so it can apply its additional "
|
||||
"functionality"
|
||||
msgid "variables prefixed with `matrix_ma1sd_container_labels_` (e.g. `matrix_ma1sd_container_labels_matrix_client_3pid_registration_enabled`) - to configure the Traefik reverse-proxy to capture and send registration requests to ma1sd (instead of Synapse), so it can apply its additional functionality"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:70
|
||||
msgid ""
|
||||
"`matrix_ma1sd_configuration_extension_yaml` - to configure ma1sd as "
|
||||
"required. See the [Registration feature's "
|
||||
"docs](https://github.com/ma1uta/ma1sd/blob/master/docs/features/registration.md)"
|
||||
" for inspiration. Also see the [Additional features](#additional-"
|
||||
"features) section below to learn more about how to use "
|
||||
"`matrix_ma1sd_configuration_extension_yaml`."
|
||||
msgid "`matrix_ma1sd_configuration_extension_yaml` - to configure ma1sd as required. See the [Registration feature's docs](https://github.com/ma1uta/ma1sd/blob/master/docs/features/registration.md) for inspiration. Also see the [Additional features](#additional-features) section below to learn more about how to use `matrix_ma1sd_configuration_extension_yaml`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:72
|
||||
msgid ""
|
||||
"**Note**: For this to work, either the homeserver needs to [federate"
|
||||
"](configuring-playbook-federation.md) or the `openid` APIs need to "
|
||||
"exposed on the federation port. When federation is disabled and ma1sd is "
|
||||
"enabled, we automatically expose the `openid` APIs (only!) on the "
|
||||
"federation port. Make sure the federation port (usually "
|
||||
"`https://matrix.example.com:8448`) is whitelisted in your firewall (even "
|
||||
"if you don't actually use/need federation)."
|
||||
msgid "**Note**: For this to work, either the homeserver needs to [federate](configuring-playbook-federation.md) or the `openid` APIs need to exposed on the federation port. When federation is disabled and ma1sd is enabled, we automatically expose the `openid` APIs (only!) on the federation port. Make sure the federation port (usually `https://matrix.example.com:8448`) is whitelisted in your firewall (even if you don't actually use/need federation)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:74
|
||||
@ -246,18 +158,11 @@ msgid "Authentication"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:76
|
||||
msgid ""
|
||||
"[Authentication](https://github.com/ma1uta/ma1sd/blob/master/docs/features/authentication.md)"
|
||||
" provides the possibility to use your own [Identity "
|
||||
"Stores](https://github.com/ma1uta/ma1sd/blob/master/docs/stores/README.md)"
|
||||
" (for example LDAP) to authenticate users on your Homeserver."
|
||||
msgid "[Authentication](https://github.com/ma1uta/ma1sd/blob/master/docs/features/authentication.md) provides the possibility to use your own [Identity Stores](https://github.com/ma1uta/ma1sd/blob/master/docs/stores/README.md) (for example LDAP) to authenticate users on your Homeserver."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:78
|
||||
msgid ""
|
||||
"To enable authentication against an LDAP server, add the following "
|
||||
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"file:"
|
||||
msgid "To enable authentication against an LDAP server, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:98
|
||||
@ -265,11 +170,7 @@ msgid "Example: SMS verification"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:100
|
||||
msgid ""
|
||||
"If your use case requires mobile verification, it is quite simple to "
|
||||
"integrate ma1sd with [Twilio](https://www.twilio.com/), an online "
|
||||
"telephony services gateway. Their prices are reasonable for low-volume "
|
||||
"projects and integration can be done with the following configuration:"
|
||||
msgid "If your use case requires mobile verification, it is quite simple to integrate ma1sd with [Twilio](https://www.twilio.com/), an online telephony services gateway. Their prices are reasonable for low-volume projects and integration can be done with the following configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:114
|
||||
@ -277,12 +178,7 @@ msgid "Example: Open Registration for every Domain"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:116
|
||||
msgid ""
|
||||
"If you want to open registration for any domain, you have to setup the "
|
||||
"allowed domains with ma1sd's `blacklist` and `whitelist`. The default "
|
||||
"behavior when neither the `blacklist`, nor the `whitelist` match, is to "
|
||||
"allow registration. Beware: you can't block toplevel domains (aka `.xy`) "
|
||||
"because the internal architecture of ma1sd doesn't allow that."
|
||||
msgid "If you want to open registration for any domain, you have to setup the allowed domains with ma1sd's `blacklist` and `whitelist`. The default behavior when neither the `blacklist`, nor the `whitelist` match, is to allow registration. Beware: you can't block toplevel domains (aka `.xy`) because the internal architecture of ma1sd doesn't allow that."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:130
|
||||
@ -290,25 +186,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:132
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:139
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:141
|
||||
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."
|
||||
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-ma1sd.md:143
|
||||
@ -316,28 +202,13 @@ msgid "Troubleshooting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:145
|
||||
msgid ""
|
||||
"If email address validation emails sent by ma1sd are not reaching you, "
|
||||
"you should look into [Adjusting email-sending settings](configuring-"
|
||||
"playbook-email.md)."
|
||||
msgid "If email address validation emails sent by ma1sd are not reaching you, you should look into [Adjusting email-sending settings](configuring-playbook-email.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:147
|
||||
msgid ""
|
||||
"If you'd like additional logging information, temporarily enable verbose "
|
||||
"logging for ma1sd."
|
||||
msgid "If you'd like additional logging information, temporarily enable verbose logging for ma1sd."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ma1sd.md:149
|
||||
msgid ""
|
||||
"To enable it, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable it, add the following configuration to your `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 ""
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -26,49 +26,31 @@ msgid "Setting up Matrix Corporal (optional, advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-corporal.md:5
|
||||
msgid ""
|
||||
"**WARNING**: This is an advanced feature! It requires prior experience "
|
||||
"with Matrix and a specific need for using [Matrix "
|
||||
"Corporal](https://github.com/devture/matrix-corporal). If you're unsure "
|
||||
"whether you have such a need, you most likely don't."
|
||||
msgid "**WARNING**: This is an advanced feature! It requires prior experience with Matrix and a specific need for using [Matrix Corporal](https://github.com/devture/matrix-corporal). If you're unsure whether you have such a need, you most likely don't."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-corporal.md:9
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-"
|
||||
"corporal](https://github.com/devture/matrix-corporal) for you."
|
||||
msgid "The playbook can install and configure [matrix-corporal](https://github.com/devture/matrix-corporal) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-corporal.md:11
|
||||
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."
|
||||
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."
|
||||
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."
|
||||
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:"
|
||||
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:16
|
||||
msgid ""
|
||||
"(required) [set up the Shared Secret Auth password provider module"
|
||||
"](configuring-playbook-shared-secret-auth.md)"
|
||||
msgid "(required) [set up the Shared Secret Auth password provider module](configuring-playbook-shared-secret-auth.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-corporal.md:17
|
||||
msgid ""
|
||||
"(optional, but encouraged) [set up the REST authentication password "
|
||||
"provider module](configuring-playbook-rest-auth.md)"
|
||||
msgid "(optional, but encouraged) [set up the REST authentication password provider module](configuring-playbook-rest-auth.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-corporal.md:19
|
||||
@ -76,36 +58,23 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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):"
|
||||
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: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)."
|
||||
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:76
|
||||
msgid ""
|
||||
"No matter what Matrix user ID you configure to run it with, make sure "
|
||||
"that:"
|
||||
msgid "No matter what Matrix user ID you configure to run it with, make sure that:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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"
|
||||
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:80
|
||||
msgid ""
|
||||
"the Matrix Corporal user is joined and has Admin/Moderator-level access "
|
||||
"to any rooms you want it to manage"
|
||||
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:82
|
||||
@ -113,17 +82,11 @@ msgid "Using a locally-stored static policy"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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:"
|
||||
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: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)."
|
||||
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:118
|
||||
@ -131,25 +94,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-corporal.md:120
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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`"
|
||||
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:129
|
||||
msgid ""
|
||||
"`just run-tags setup-aux-files,setup-corporal,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."
|
||||
msgid "`just run-tags setup-aux-files,setup-corporal,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 ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-corporal.md:131
|
||||
@ -157,9 +110,7 @@ msgid "Matrix Corporal files"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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):"
|
||||
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:135
|
||||
@ -167,35 +118,13 @@ msgid "`/matrix/corporal/config` is mounted at `/etc/matrix-corporal` (read-only
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-corporal.md:137
|
||||
msgid ""
|
||||
"`/matrix/corporal/var` is mounted at `/var/matrix-corporal` (read and "
|
||||
"write)"
|
||||
msgid "`/matrix/corporal/var` is mounted at `/var/matrix-corporal` (read and write)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-corporal.md:139
|
||||
msgid ""
|
||||
"`/matrix/corporal/cache` is mounted at `/var/cache/matrix-corporal` (read"
|
||||
" and write)"
|
||||
msgid "`/matrix/corporal/cache` is mounted at `/var/cache/matrix-corporal` (read and write)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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` "
|
||||
"in the Docker container. Your configuration (stuff in "
|
||||
"`matrix_corporal_policy_provider_config`) needs to refer to these files "
|
||||
"via the local container paths - `/etc/matrix-corporal` (read-only), `/var"
|
||||
"/matrix-corporal` (read and write), `/var/cache/matrix-corporal` (read "
|
||||
"and write)."
|
||||
msgid "As an example: you can create your own configuration files in `/matrix/corporal/config` and they will appear in `/etc/matrix-corporal` in the Docker container. Your configuration (stuff in `matrix_corporal_policy_provider_config`) needs to refer to these files via the local container paths - `/etc/matrix-corporal` (read-only), `/var/matrix-corporal` (read and write), `/var/cache/matrix-corporal` (read 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 ""
|
||||
|
||||
|
||||
@ -26,10 +26,7 @@ msgid "Setting up matrix-ldap-registration-proxy (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-ldap-registration-"
|
||||
"proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy)"
|
||||
" for you."
|
||||
msgid "The playbook can install and configure [matrix-ldap-registration-proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:5
|
||||
@ -37,10 +34,7 @@ msgid "This proxy handles Matrix registration requests and forwards them to LDAP
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:7
|
||||
msgid ""
|
||||
"**Note**: This does support the full Matrix specification for "
|
||||
"registrations. It only provide a very coarse implementation of a basic "
|
||||
"password registration."
|
||||
msgid "**Note**: This does support the full Matrix specification for registrations. It only provide a very coarse implementation of a basic password registration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:9
|
||||
@ -48,18 +42,11 @@ msgid "Quickstart"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:11
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:22
|
||||
msgid ""
|
||||
"If you already use the [synapse external password provider via LDAP"
|
||||
"](configuring-playbook-ldap-auth.md) (that is, you have "
|
||||
"`matrix_synapse_ext_password_provider_ldap_enabled: true` and other "
|
||||
"options in your configuration) you can use the following values as "
|
||||
"configuration:"
|
||||
msgid "If you already use the [synapse external password provider via LDAP](configuring-playbook-ldap-auth.md) (that is, you have `matrix_synapse_ext_password_provider_ldap_enabled: true` and other options in your configuration) you can use the following values as configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:35
|
||||
@ -67,24 +54,13 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:37
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:44
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:46
|
||||
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."
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,28 +26,15 @@ msgid "Storing Matrix media files using matrix-media-repo (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:3
|
||||
msgid ""
|
||||
"[matrix-media-repo](https://docs.t2bot.io/matrix-media-repo/) (often "
|
||||
"abbreviated \"MMR\") is a highly customizable multi-domain media "
|
||||
"repository for Matrix. Intended for medium to large environments "
|
||||
"consisting of several homeservers, this media repo de-duplicates media "
|
||||
"(including remote media) while being fully compliant with the "
|
||||
"specification."
|
||||
msgid "[matrix-media-repo](https://docs.t2bot.io/matrix-media-repo/) (often abbreviated \"MMR\") is a highly customizable multi-domain media repository for Matrix. Intended for medium to large environments consisting of several homeservers, this media repo de-duplicates media (including remote media) while being fully compliant with the specification."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:5
|
||||
msgid ""
|
||||
"Smaller/individual homeservers can still make use of this project's "
|
||||
"features, though it may be difficult to set up or have higher than "
|
||||
"expected resource consumption. Please do your research before deploying "
|
||||
"this as this project may not be useful for your environment."
|
||||
msgid "Smaller/individual homeservers can still make use of this project's features, though it may be difficult to set up or have higher than expected resource consumption. Please do your research before deploying this as this project may not be useful for your environment."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:7
|
||||
msgid ""
|
||||
"For a simpler alternative (which allows you to offload your media "
|
||||
"repository storage to S3, etc.), you can [configure S3 storage"
|
||||
"](configuring-playbook-s3.md) instead of setting up matrix-media-repo."
|
||||
msgid "For a simpler alternative (which allows you to offload your media repository storage to S3, etc.), you can [configure S3 storage](configuring-playbook-s3.md) instead of setting up matrix-media-repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md
|
||||
@ -63,9 +50,7 @@ msgid "[Additional configuration options](#configuring-the-media-repo)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md
|
||||
msgid ""
|
||||
"[Importing data from an existing media store](#importing-data-from-an-"
|
||||
"existing-media-store)"
|
||||
msgid "[Importing data from an existing media store](#importing-data-from-an-existing-media-store)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:15
|
||||
@ -73,27 +58,15 @@ msgid "Quickstart"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:17
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file and [re-run the "
|
||||
"installation process](./installing.md) for the playbook:"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file and [re-run the installation process](./installing.md) for the playbook:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:26
|
||||
msgid ""
|
||||
"The repo is pre-configured for integrating with the Postgres database, "
|
||||
"Traefik proxy and [Prometheus/Grafana](configuring-playbook-prometheus-"
|
||||
"grafana.md) (if metrics enabled) from this playbook for all the available"
|
||||
" homeserver roles. When the media repo is enabled, other media store "
|
||||
"roles should be disabled (if using Synapse with other media store roles)."
|
||||
msgid "The repo is pre-configured for integrating with the Postgres database, Traefik proxy and [Prometheus/Grafana](configuring-playbook-prometheus-grafana.md) (if metrics enabled) from this playbook for all the available homeserver roles. When the media repo is enabled, other media store roles should be disabled (if using Synapse with other media store roles)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:28
|
||||
msgid ""
|
||||
"By default, the media-repo will use the local filesystem for data "
|
||||
"storage. You can alternatively use a `s3` cloud backend as well. Access "
|
||||
"token caching is also enabled by default since the logout endpoints are "
|
||||
"proxied through the media repo."
|
||||
msgid "By default, the media-repo will use the local filesystem for data storage. You can alternatively use a `s3` cloud backend as well. Access token caching is also enabled by default since the logout endpoints are proxied through the media repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:30
|
||||
@ -105,12 +78,7 @@ msgid "Additional common configuration options:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:91
|
||||
msgid ""
|
||||
"Full list of configuration options with documentation can be found in "
|
||||
"[`roles/custom/matrix-media-"
|
||||
"repo/defaults/main.yml`](https://github.com/spantaleev/matrix-docker-"
|
||||
"ansible-deploy/blob/master/roles/custom/matrix-media-"
|
||||
"repo/defaults/main.yml)"
|
||||
msgid "Full list of configuration options with documentation can be found in [`roles/custom/matrix-media-repo/defaults/main.yml`](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/master/roles/custom/matrix-media-repo/defaults/main.yml)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:93
|
||||
@ -118,33 +86,19 @@ msgid "Signing Keys"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:95
|
||||
msgid ""
|
||||
"Authenticated media endpoints ([MSC3916](https://github.com/matrix-org"
|
||||
"/matrix-spec-proposals/pull/3916)) requires MMR to have a configured "
|
||||
"signing key to authorize outbound federation requests. Additionally, the "
|
||||
"signing key must be merged with your homeserver's signing key file."
|
||||
msgid "Authenticated media endpoints ([MSC3916](https://github.com/matrix-org/matrix-spec-proposals/pull/3916)) requires MMR to have a configured signing key to authorize outbound federation requests. Additionally, the signing key must be merged with your homeserver's signing key file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:97
|
||||
msgid ""
|
||||
"The playbook default is to generate a MMR signing key when invoking the "
|
||||
"setup role and merge it with your homeserver if you are using Synapse or "
|
||||
"Dendrite. This can be disabled if desired by setting the option in your "
|
||||
"inventory:"
|
||||
msgid "The playbook default is to generate a MMR signing key when invoking the setup role and merge it with your homeserver if you are using Synapse or Dendrite. This can be disabled if desired by setting the option in your inventory:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:103
|
||||
msgid ""
|
||||
"If you wish to manually generate the signing key and merge it with your "
|
||||
"homeserver's signing key file, see https://docs.t2bot.io/matrix-media-"
|
||||
"repo/v1.3.5/installation/signing-key/ for more details."
|
||||
msgid "If you wish to manually generate the signing key and merge it with your homeserver's signing key file, see https://docs.t2bot.io/matrix-media-repo/v1.3.5/installation/signing-key/ for more details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:105
|
||||
msgid ""
|
||||
"**Note that if you uninstall MMR from the playbook, it will not remove "
|
||||
"the old MMR signing key from your homeserver's signing key file. You will"
|
||||
" have to remove it manually.**"
|
||||
msgid "**Note that if you uninstall MMR from the playbook, it will not remove the old MMR signing key from your homeserver's signing key file. You will have to remove it manually.**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:107
|
||||
@ -152,20 +106,11 @@ msgid "Key backup and revoking"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:109
|
||||
msgid ""
|
||||
"Since your homeserver signing key file is modified by the playbook, a "
|
||||
"backup will be created in "
|
||||
"`HOMESERVER_DIR/config/example.com.signing.key.backup`. If you need to "
|
||||
"remove/revoke old keys, you can restore from this backup or remove the "
|
||||
"MMR key ID from your `example.com.signing.key` file."
|
||||
msgid "Since your homeserver signing key file is modified by the playbook, a backup will be created in `HOMESERVER_DIR/config/example.com.signing.key.backup`. If you need to remove/revoke old keys, you can restore from this backup or remove the MMR key ID from your `example.com.signing.key` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:111
|
||||
msgid ""
|
||||
"Additionally, its recommended after revoking a signing key to update your"
|
||||
" homeserver config file (`old_signing_keys` field for Synapse and "
|
||||
"`old_private_keys` for Dendrite). See your homeserver config file for "
|
||||
"further documentation on how to populate the field."
|
||||
msgid "Additionally, its recommended after revoking a signing key to update your homeserver config file (`old_signing_keys` field for Synapse and `old_private_keys` for Dendrite). See your homeserver config file for further documentation on how to populate the field."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:113
|
||||
@ -173,25 +118,15 @@ msgid "Importing data from an existing media store"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:115
|
||||
msgid ""
|
||||
"If you want to add this repo to an existing homeserver managed by the "
|
||||
"playbook, you will need to import existing media into MMR's database or "
|
||||
"you will lose access to older media while it is active. MMR versions up "
|
||||
"to `v1.3.3` only support importing from Synapse, but newer versions (at "
|
||||
"time of writing: only `latest`) also support importing from Dendrite."
|
||||
msgid "If you want to add this repo to an existing homeserver managed by the playbook, you will need to import existing media into MMR's database or you will lose access to older media while it is active. MMR versions up to `v1.3.3` only support importing from Synapse, but newer versions (at time of writing: only `latest`) also support importing from Dendrite."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:117
|
||||
msgid ""
|
||||
"**Before importing**: ensure you have an initial matrix-media-repo "
|
||||
"deployment by following the [quickstart](#quickstart) guide above"
|
||||
msgid "**Before importing**: ensure you have an initial matrix-media-repo deployment by following the [quickstart](#quickstart) guide above"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:119
|
||||
msgid ""
|
||||
"Depending on the homeserver implementation yu're using (Synapse, "
|
||||
"Dendrite), you'll need to use a different import tool (part of matrix-"
|
||||
"media-repo) and point it to the homeserver's database."
|
||||
msgid "Depending on the homeserver implementation yu're using (Synapse, Dendrite), you'll need to use a different import tool (part of matrix-media-repo) and point it to the homeserver's database."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:121
|
||||
@ -199,40 +134,26 @@ msgid "Importing data from the Synapse media store"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:123
|
||||
msgid ""
|
||||
"To import the Synapse media store, you're supposed to invoke the "
|
||||
"`import_synapse` tool which is part of the matrix-media-repo container "
|
||||
"image. Your Synapse database is called `synapse` by default, unless "
|
||||
"you've changed it by modifying `matrix_synapse_database_database`."
|
||||
msgid "To import the Synapse media store, you're supposed to invoke the `import_synapse` tool which is part of the matrix-media-repo container image. Your Synapse database is called `synapse` by default, unless you've changed it by modifying `matrix_synapse_database_database`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:125
|
||||
msgid ""
|
||||
"This guide here is adapted from the [upstream documentation about the "
|
||||
"import_synapse script](https://github.com/turt2live/matrix-media-repo"
|
||||
"#importing-media-from-synapse)."
|
||||
msgid "This guide here is adapted from the [upstream documentation about the import_synapse script](https://github.com/turt2live/matrix-media-repo#importing-media-from-synapse)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:127
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:149
|
||||
msgid ""
|
||||
"Run the following command on the server (after replacing "
|
||||
"`postgres_connection_password` in it with the value found in your "
|
||||
"`vars.yml` file):"
|
||||
msgid "Run the following command on the server (after replacing `postgres_connection_password` in it with the value found in your `vars.yml` file):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:139
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:161
|
||||
msgid ""
|
||||
"Enter `1` for the Machine ID when prompted (you are not doing any "
|
||||
"horizontal scaling) unless you know what you're doing."
|
||||
msgid "Enter `1` for the Machine ID when prompted (you are not doing any horizontal scaling) unless you know what you're doing."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:141
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:163
|
||||
msgid ""
|
||||
"This should output a `msg=\"Import completed\"` when finished "
|
||||
"successfully!"
|
||||
msgid "This should output a `msg=\"Import completed\"` when finished successfully!"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:143
|
||||
@ -240,18 +161,9 @@ msgid "Importing data from the Dendrite media store"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:145
|
||||
msgid ""
|
||||
"If you're using the [Dendrite](configuring-playbook-dendrite.md) "
|
||||
"homeserver instead of the default for this playbook (Synapse), follow "
|
||||
"this importing guide here."
|
||||
msgid "If you're using the [Dendrite](configuring-playbook-dendrite.md) homeserver instead of the default for this playbook (Synapse), follow this importing guide here."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-media-repo.md:147
|
||||
msgid ""
|
||||
"To import the Dendrite media store, you're supposed to invoke the "
|
||||
"`import_dendrite` tool which is part of the matrix-media-repo container "
|
||||
"image. Your Dendrite database is called `dendrite_mediaapi` by default, "
|
||||
"unless you've changed it by modifying "
|
||||
"`matrix_dendrite_media_api_database`."
|
||||
msgid "To import the Dendrite media store, you're supposed to invoke the `import_dendrite` tool which is part of the matrix-media-repo container image. Your Dendrite database is called `dendrite_mediaapi` by default, unless you've changed it by modifying `matrix_dendrite_media_api_database`."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,35 +26,23 @@ msgid "Setting up matrix-registration (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-"
|
||||
"registration](https://github.com/ZerataX/matrix-registration) for you."
|
||||
msgid "The playbook can install and configure [matrix-registration](https://github.com/ZerataX/matrix-registration) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:5
|
||||
msgid ""
|
||||
"**WARNING**: this is a poorly maintained and buggy project. It's better "
|
||||
"to avoid using it."
|
||||
msgid "**WARNING**: this is a poorly maintained and buggy project. It's better to avoid using it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:7
|
||||
msgid ""
|
||||
"**WARNING**: this is not related to [matrix-registration-bot"
|
||||
"](configuring-playbook-bot-matrix-registration-bot.md)"
|
||||
msgid "**WARNING**: this is not related to [matrix-registration-bot](configuring-playbook-bot-matrix-registration-bot.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:9
|
||||
msgid ""
|
||||
"matrix-registration is a simple python application to have a token based "
|
||||
"Matrix registration."
|
||||
msgid "matrix-registration is a simple python application to have a token based Matrix registration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:11
|
||||
msgid ""
|
||||
"Use matrix-registration to **create unique registration links**, which "
|
||||
"people can use to register on your Matrix server. It allows you to **keep"
|
||||
" your server's registration closed (private)**, but still allow certain "
|
||||
"people (these having a special link) to register a user account."
|
||||
msgid "Use matrix-registration to **create unique registration links**, which people can use to register on your Matrix server. It allows you to **keep your server's registration closed (private)**, but still allow certain people (these having a special link) to register a user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:13
|
||||
@ -62,17 +50,11 @@ msgid "**matrix-registration** provides 2 things:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:15
|
||||
msgid ""
|
||||
"**an API for creating registration tokens** (unique registration links). "
|
||||
"This API can be used via `curl` or via the playbook (see [Usage](#usage) "
|
||||
"below)"
|
||||
msgid "**an API for creating registration tokens** (unique registration links). This API can be used via `curl` or via the playbook (see [Usage](#usage) below)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:17
|
||||
msgid ""
|
||||
"**a user registration page**, where people can use these registration "
|
||||
"tokens. By default, exposed at `https://matrix.example.com/matrix-"
|
||||
"registration`"
|
||||
msgid "**a user registration page**, where people can use these registration tokens. By default, exposed at `https://matrix.example.com/matrix-registration`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:19
|
||||
@ -80,9 +62,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:21
|
||||
msgid ""
|
||||
"To enable matrix-registration, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable matrix-registration, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:30
|
||||
@ -90,26 +70,15 @@ msgid "Adjusting the matrix-registration URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:32
|
||||
msgid ""
|
||||
"By default, this playbook installs the matrix-registration on the "
|
||||
"`matrix.` subdomain, at the `/matrix-registration` path "
|
||||
"(https://matrix.example.com/matrix-registration). This makes it easy to "
|
||||
"install it, because it **doesn't require additional DNS records to be set"
|
||||
" up**. If that's okay, you can skip this section."
|
||||
msgid "By default, this playbook installs the matrix-registration on the `matrix.` subdomain, at the `/matrix-registration` path (https://matrix.example.com/matrix-registration). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:34
|
||||
msgid ""
|
||||
"By tweaking the `matrix_registration_hostname` and "
|
||||
"`matrix_registration_path_prefix` variables, you can easily make the "
|
||||
"service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_registration_hostname` and `matrix_registration_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-matrix-registration.md:36
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:44
|
||||
@ -117,10 +86,7 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:46
|
||||
msgid ""
|
||||
"If you've changed the default hostname, **you may need to adjust your "
|
||||
"DNS** records to point the matrix-registration domain to the Matrix "
|
||||
"server."
|
||||
msgid "If you've changed the default hostname, **you may need to adjust your DNS** records to point the matrix-registration domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:48
|
||||
@ -128,9 +94,7 @@ msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:50
|
||||
msgid ""
|
||||
"If you've decided to use the default hostname, you won't need to do any "
|
||||
"extra DNS configuration."
|
||||
msgid "If you've decided to use the default hostname, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:52
|
||||
@ -138,26 +102,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:54
|
||||
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:"
|
||||
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-matrix-registration.md:61
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:63
|
||||
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."
|
||||
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-matrix-registration.md:65
|
||||
@ -165,17 +118,11 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:67
|
||||
msgid ""
|
||||
"**matrix-registration** gets exposed at `https://matrix.example.com"
|
||||
"/matrix-registration`"
|
||||
msgid "**matrix-registration** gets exposed at `https://matrix.example.com/matrix-registration`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:69
|
||||
msgid ""
|
||||
"It provides various [APIs](https://github.com/ZerataX/matrix-"
|
||||
"registration/wiki/api) - for creating registration tokens, listing "
|
||||
"tokens, disabling tokens, etc. To make use of all of its capabilities, "
|
||||
"consider using `curl`."
|
||||
msgid "It provides various [APIs](https://github.com/ZerataX/matrix-registration/wiki/api) - for creating registration tokens, listing tokens, disabling tokens, etc. To make use of all of its capabilities, consider using `curl`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:71
|
||||
@ -191,16 +138,11 @@ msgid "To **create a new user registration token (link)**, use this command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:83
|
||||
msgid ""
|
||||
"The above command creates and returns a **one-time use** token, which "
|
||||
"**expires** on the 31st of December 2021. Adjust the `one_time` and "
|
||||
"`ex_date` variables as you see fit."
|
||||
msgid "The above command creates and returns a **one-time use** token, which **expires** on the 31st of December 2021. Adjust the `one_time` and `ex_date` variables as you see fit."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:85
|
||||
msgid ""
|
||||
"Share the unique registration link (generated by the command above) with "
|
||||
"users to let them register on your Matrix server."
|
||||
msgid "Share the unique registration link (generated by the command above) with users to let them register on your Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:87
|
||||
@ -212,8 +154,5 @@ msgid "To **list the existing user registration tokens**, use this command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-matrix-registration.md:96
|
||||
msgid ""
|
||||
"The shortcut command with `just` program is also available: `just run-"
|
||||
"tags list-matrix-registration-tokens`"
|
||||
msgid "The shortcut command with `just` program is also available: `just run-tags list-matrix-registration-tokens`"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,18 +26,11 @@ msgid "Setting up a Generic Mautrix Bridge (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure various "
|
||||
"[mautrix](https://github.com/mautrix) bridges (twitter, facebook, "
|
||||
"instagram, signal, hangouts, googlechat, etc.), as well as many other "
|
||||
"(non-mautrix) bridges. This is a common guide for configuring mautrix "
|
||||
"bridges."
|
||||
msgid "The playbook can install and configure various [mautrix](https://github.com/mautrix) bridges (twitter, facebook, instagram, signal, hangouts, googlechat, etc.), as well as many other (non-mautrix) bridges. This is a common guide for configuring mautrix bridges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:5
|
||||
msgid ""
|
||||
"You can see each bridge's features at in the `ROADMAP.md` file in its "
|
||||
"corresponding [mautrix](https://github.com/mautrix) repository."
|
||||
msgid "You can see each bridge's features at in the `ROADMAP.md` file in its corresponding [mautrix](https://github.com/mautrix) repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:7
|
||||
@ -45,34 +38,19 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:9
|
||||
msgid ""
|
||||
"To enable the bridge, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable the bridge, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:16
|
||||
msgid ""
|
||||
"There are some additional things you may wish to configure about the "
|
||||
"bridge before you continue. Each bridge may have additional requirements "
|
||||
"besides `_enabled: true`. For example, the mautrix-telegram bridge (our "
|
||||
"documentation page about it is [here](configuring-playbook-bridge-"
|
||||
"mautrix-telegram.md)) requires the `matrix_mautrix_telegram_api_id` and "
|
||||
"`matrix_mautrix_telegram_api_hash` variables to be defined. Refer to each"
|
||||
" bridge's individual documentation page for details about enabling "
|
||||
"bridges."
|
||||
msgid "There are some additional things you may wish to configure about the bridge before you continue. Each bridge may have additional requirements besides `_enabled: true`. For example, the mautrix-telegram bridge (our documentation page about it is [here](configuring-playbook-bridge-mautrix-telegram.md)) requires the `matrix_mautrix_telegram_api_id` and `matrix_mautrix_telegram_api_hash` variables to be defined. Refer to each bridge's individual documentation page for details about enabling bridges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:18
|
||||
msgid ""
|
||||
"To **configure a user as an administrator for all bridges**, add the "
|
||||
"following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To **configure a user as an administrator for all bridges**, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:24
|
||||
msgid ""
|
||||
"**Alternatively** (more verbose, but allows multiple admins to be "
|
||||
"configured), you can do the same on a per-bridge basis with:"
|
||||
msgid "**Alternatively** (more verbose, but allows multiple admins to be configured), you can do the same on a per-bridge basis with:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:33
|
||||
@ -80,10 +58,7 @@ msgid "encryption"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:35
|
||||
msgid ""
|
||||
"Encryption support is off by default. If you would like to enable "
|
||||
"encryption, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Encryption support is off by default. If you would like to enable encryption, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:37
|
||||
@ -100,10 +75,7 @@ msgid "relay mode"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:53
|
||||
msgid ""
|
||||
"Relay mode is off by default. If you would like to enable relay mode, add"
|
||||
" the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Relay mode is off by default. If you would like to enable relay mode, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:55
|
||||
@ -111,11 +83,7 @@ msgid "**for all bridges with relay mode support**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:70
|
||||
msgid ""
|
||||
"You can only have one "
|
||||
"`matrix_mautrix_SERVICENAME_configuration_extension_yaml` definition in "
|
||||
"`vars.yml` per bridge, so if you need multiple pieces of configuration "
|
||||
"there, just merge them like this:"
|
||||
msgid "You can only have one `matrix_mautrix_SERVICENAME_configuration_extension_yaml` definition in `vars.yml` per bridge, so if you need multiple pieces of configuration there, just merge them like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:82
|
||||
@ -131,11 +99,7 @@ msgid "Discovering additional configuration options"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:92
|
||||
msgid ""
|
||||
"You may wish to look at `roles/custom/matrix-bridge-mautrix-"
|
||||
"SERVICENAME/templates/config.yaml.j2` and `roles/custom/matrix-bridge-"
|
||||
"mautrix-SERVICENAME/defaults/main.yml` to find other things you would "
|
||||
"like to configure."
|
||||
msgid "You may wish to look at `roles/custom/matrix-bridge-mautrix-SERVICENAME/templates/config.yaml.j2` and `roles/custom/matrix-bridge-mautrix-SERVICENAME/defaults/main.yml` to find other things you would like to configure."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:94
|
||||
@ -143,9 +107,7 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:96
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:103
|
||||
@ -153,24 +115,15 @@ msgid "**Notes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:105
|
||||
msgid ""
|
||||
"The `ensure-matrix-users-created` playbook tag makes the playbook "
|
||||
"automatically create the bot's user account."
|
||||
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:107
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:109
|
||||
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."
|
||||
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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:111
|
||||
@ -178,24 +131,15 @@ msgid "Set up Double Puppeting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:113
|
||||
msgid ""
|
||||
"To set up [Double Puppeting](https://docs.mau.fi/bridges/general/double-"
|
||||
"puppeting.html) enable the [Appservice Double Puppet](configuring-"
|
||||
"playbook-appservice-double-puppet.md) service for this playbook."
|
||||
msgid "To set up [Double Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) enable the [Appservice Double Puppet](configuring-playbook-appservice-double-puppet.md) service for this playbook."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:115
|
||||
msgid ""
|
||||
"The bridge automatically performs Double Puppeting if [Shared Secret Auth"
|
||||
"](configuring-playbook-shared-secret-auth.md) is configured and enabled "
|
||||
"on the server for this playbook by adding"
|
||||
msgid "The bridge automatically performs Double Puppeting if [Shared Secret Auth](configuring-playbook-shared-secret-auth.md) is configured and enabled on the server for this playbook by adding"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:121
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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-mautrix-bridges.md:123
|
||||
@ -203,16 +147,11 @@ msgid "Controlling the logging level"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:129
|
||||
msgid ""
|
||||
"to `vars.yml` to control the logging level, where you may replace WARN "
|
||||
"with one of the following to control the verbosity of the logs generated:"
|
||||
" TRACE, DEBUG, INFO, WARN, ERROR, or FATAL."
|
||||
msgid "to `vars.yml` to control the logging level, where you may replace WARN with one of the following to control the verbosity of the logs generated: TRACE, DEBUG, INFO, WARN, ERROR, or FATAL."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:131
|
||||
msgid ""
|
||||
"If you have issues with a service, and are requesting support, the higher"
|
||||
" levels of logging will generally be more helpful."
|
||||
msgid "If you have issues with a service, and are requesting support, the higher levels of logging will generally be more helpful."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:133
|
||||
@ -220,24 +159,15 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:135
|
||||
msgid ""
|
||||
"To use the bridge, you need to start a chat with "
|
||||
"`@SERVICENAMEbot:example.com` (where `example.com` is your base domain, "
|
||||
"not the `matrix.` domain)."
|
||||
msgid "To use the bridge, you need to start a chat with `@SERVICENAMEbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:137
|
||||
msgid ""
|
||||
"Send `login` to the bridge bot to get started. You can learn more here "
|
||||
"about authentication from the bridge's official documentation on "
|
||||
"Authentication: "
|
||||
"https://docs.mau.fi/bridges/python/SERVICENAME/authentication.html"
|
||||
msgid "Send `login` to the bridge bot to get started. You can learn more here about authentication from the bridge's official documentation on Authentication: https://docs.mau.fi/bridges/python/SERVICENAME/authentication.html"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:139
|
||||
msgid ""
|
||||
"If you run into trouble, check the [Troubleshooting](#troubleshooting) "
|
||||
"section below."
|
||||
msgid "If you run into trouble, check the [Troubleshooting](#troubleshooting) section below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:141
|
||||
@ -245,16 +175,9 @@ msgid "Troubleshooting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:143
|
||||
msgid ""
|
||||
"For troubleshooting information with a specific bridge, please see the "
|
||||
"playbook documentation about it (some other document in in `docs/`) and "
|
||||
"the upstream ([mautrix](https://github.com/mautrix)) bridge documentation"
|
||||
" for that specific bridge."
|
||||
msgid "For troubleshooting information with a specific bridge, please see the playbook documentation about it (some other document in in `docs/`) and the upstream ([mautrix](https://github.com/mautrix)) bridge documentation for that specific bridge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-mautrix-bridges.md:145
|
||||
msgid ""
|
||||
"Reporting bridge bugs should happen upstream, in the corresponding "
|
||||
"mautrix repository, not to us."
|
||||
msgid "Reporting bridge bugs should happen upstream, in the corresponding mautrix repository, not to us."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -28,4 +28,3 @@ msgstr ""
|
||||
#: ../../../docs/configuring-playbook-nginx.md:3
|
||||
msgid "Since 2024-01, this playbook no longer uses nginx as its reverse-proxy."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,33 +26,19 @@ msgid "Setting up the ntfy push notifications server (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [ntfy](https://ntfy.sh/) push "
|
||||
"notifications server for you."
|
||||
msgid "The playbook can install and configure the [ntfy](https://ntfy.sh/) push notifications server for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:5
|
||||
msgid ""
|
||||
"Using the [UnifiedPush](https://unifiedpush.org) standard, ntfy enables "
|
||||
"self-hosted (Google-free) push notifications from Matrix (and other) "
|
||||
"servers to UnifiedPush-compatible Matrix compatible client apps running "
|
||||
"on Android and other devices."
|
||||
msgid "Using the [UnifiedPush](https://unifiedpush.org) standard, ntfy enables self-hosted (Google-free) push notifications from Matrix (and other) servers to UnifiedPush-compatible Matrix compatible client apps running on Android and other devices."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:7
|
||||
msgid ""
|
||||
"This role is intended to support UnifiedPush notifications for use with "
|
||||
"the Matrix and Matrix-related services that this playbook installs. This "
|
||||
"role is not intended to support all of ntfy's other features."
|
||||
msgid "This role is intended to support UnifiedPush notifications for use with the Matrix and Matrix-related services that this playbook installs. This role is not intended to support all of ntfy's other features."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:9
|
||||
msgid ""
|
||||
"**Note**: In contrast to push notifications using Google's FCM or Apple's"
|
||||
" APNs, the use of UnifiedPush allows each end-user to choose the push "
|
||||
"notification server that they prefer. As a consequence, deploying this "
|
||||
"ntfy server does not by itself ensure any particular user or device or "
|
||||
"client app will use it."
|
||||
msgid "**Note**: In contrast to push notifications using Google's FCM or Apple's APNs, the use of UnifiedPush allows each end-user to choose the push notification server that they prefer. As a consequence, deploying this ntfy server does not by itself ensure any particular user or device or client app will use it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:11
|
||||
@ -60,23 +46,15 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:13
|
||||
msgid ""
|
||||
"To enable ntfy, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable ntfy, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:27
|
||||
msgid ""
|
||||
"For a more complete list of variables that you could override, see the "
|
||||
"[`defaults/main.yml` file](https://github.com/mother-of-all-self-hosting"
|
||||
"/ansible-role-ntfy/blob/main/defaults/main.yml) of the ntfy Ansible role."
|
||||
msgid "For a more complete list of variables that you could override, see the [`defaults/main.yml` file](https://github.com/mother-of-all-self-hosting/ansible-role-ntfy/blob/main/defaults/main.yml) of the ntfy Ansible role."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:29
|
||||
msgid ""
|
||||
"For a complete list of ntfy config options that you could put in "
|
||||
"`ntfy_configuration_extension_yaml`, see the [ntfy config "
|
||||
"documentation](https://ntfy.sh/docs/config/#config-options)."
|
||||
msgid "For a complete list of ntfy config options that you could put in `ntfy_configuration_extension_yaml`, see the [ntfy config documentation](https://ntfy.sh/docs/config/#config-options)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:31
|
||||
@ -84,22 +62,15 @@ msgid "Adjusting the ntfy URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:33
|
||||
msgid ""
|
||||
"By default, this playbook installs ntfy on the `ntfy.` subdomain "
|
||||
"(`ntfy.example.com`) and requires you to [adjust your DNS records"
|
||||
"](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs ntfy on the `ntfy.` subdomain (`ntfy.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:35
|
||||
msgid ""
|
||||
"By tweaking the `ntfy_hostname` variable, you can easily make the service"
|
||||
" available at a **different hostname** than the default one."
|
||||
msgid "By tweaking the `ntfy_hostname` variable, you can easily make the service available at a **different hostname** than the default one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:37
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:44
|
||||
@ -107,15 +78,11 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:46
|
||||
msgid ""
|
||||
"Once you've decided on the domain, **you may need to adjust your DNS** "
|
||||
"records to point the ntfy domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain, **you may need to adjust your DNS** records to point the ntfy domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:48
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `ntfy`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `ntfy`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:50
|
||||
@ -123,26 +90,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:52
|
||||
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:"
|
||||
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-ntfy.md:59
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:61
|
||||
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."
|
||||
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-ntfy.md:63
|
||||
@ -150,9 +106,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:65
|
||||
msgid ""
|
||||
"To make use of your ntfy installation, on Android for example, you need "
|
||||
"two things:"
|
||||
msgid "To make use of your ntfy installation, on Android for example, you need two things:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:67
|
||||
@ -164,11 +118,7 @@ msgid "a UnifiedPush-compatible Matrix app"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:70
|
||||
msgid ""
|
||||
"You need to install the `ntfy` app on each device on which you want to "
|
||||
"receive push notifications through your ntfy server. The `ntfy` app will "
|
||||
"provide UnifiedPush notifications to any number of UnifiedPush-compatible"
|
||||
" messaging apps installed on the same device."
|
||||
msgid "You need to install the `ntfy` app on each device on which you want to receive push notifications through your ntfy server. The `ntfy` app will provide UnifiedPush notifications to any number of UnifiedPush-compatible messaging apps installed on the same device."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:72
|
||||
@ -176,15 +126,11 @@ msgid "Setting up the `ntfy` Android app"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:74
|
||||
msgid ""
|
||||
"Install the [ntfy Android app](https://ntfy.sh/docs/subscribe/phone/) "
|
||||
"from F-droid or Google Play."
|
||||
msgid "Install the [ntfy Android app](https://ntfy.sh/docs/subscribe/phone/) from F-droid or Google Play."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:75
|
||||
msgid ""
|
||||
"In its Settings -> `General: Default server`, enter your ntfy server URL,"
|
||||
" such as `https://ntfy.example.com`."
|
||||
msgid "In its Settings -> `General: Default server`, enter your ntfy server URL, such as `https://ntfy.example.com`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:76
|
||||
@ -192,11 +138,7 @@ msgid "In its Settings -> `Advanced: Connection protocol`, choose `WebSockets`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:78
|
||||
msgid ""
|
||||
"That is all you need to do in the ntfy app. It has many other features, "
|
||||
"but for our purposes you can ignore them. In particular you do not need "
|
||||
"to follow any instructions about subscribing to a notification topic as "
|
||||
"UnifiedPush will do that automatically."
|
||||
msgid "That is all you need to do in the ntfy app. It has many other features, but for our purposes you can ignore them. In particular you do not need to follow any instructions about subscribing to a notification topic as UnifiedPush will do that automatically."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:80
|
||||
@ -204,11 +146,7 @@ msgid "Setting up a UnifiedPush-compatible Matrix app"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:82
|
||||
msgid ""
|
||||
"Install any UnifiedPush-enabled Matrix app on that same device. The "
|
||||
"Matrix app will learn from the `ntfy` app that you have configured "
|
||||
"UnifiedPush on this device, and then it will tell your Matrix server to "
|
||||
"use it."
|
||||
msgid "Install any UnifiedPush-enabled Matrix app on that same device. The Matrix app will learn from the `ntfy` app that you have configured UnifiedPush on this device, and then it will tell your Matrix server to use it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:84
|
||||
@ -228,23 +166,15 @@ msgid "SchildiChat-android:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:90
|
||||
msgid ""
|
||||
"enable `Settings` -> `Notifications` -> `UnifiedPush: Force custom push "
|
||||
"gateway`."
|
||||
msgid "enable `Settings` -> `Notifications` -> `UnifiedPush: Force custom push gateway`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:91
|
||||
msgid ""
|
||||
"choose `Settings` -> `Notifications` -> `UnifiedPush: Re-register push "
|
||||
"distributor`. *(For info, a more complex alternative to achieve the same "
|
||||
"is: delete the relevant unifiedpush registration in `ntfy` app, force-"
|
||||
"close SchildiChat, re-open it.)*"
|
||||
msgid "choose `Settings` -> `Notifications` -> `UnifiedPush: Re-register push distributor`. *(For info, a more complex alternative to achieve the same is: delete the relevant unifiedpush registration in `ntfy` app, force-close SchildiChat, re-open it.)*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:92
|
||||
msgid ""
|
||||
"verify `Settings` -> `Notifications` -> `UnifiedPush: Notification "
|
||||
"targets` as described below in the \"Troubleshooting\" section."
|
||||
msgid "verify `Settings` -> `Notifications` -> `UnifiedPush: Notification targets` as described below in the \"Troubleshooting\" section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:94
|
||||
@ -256,21 +186,15 @@ msgid "choose `Settings` -> `Notifications` -> `Notification method` -> `ntfy`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:96
|
||||
msgid ""
|
||||
"verify `Settings` -> `Troubleshoot` -> `Troubleshoot notification "
|
||||
"settings`"
|
||||
msgid "verify `Settings` -> `Troubleshoot` -> `Troubleshoot notification settings`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:98
|
||||
msgid ""
|
||||
"If the Matrix app asks, \"Choose a distributor: FCM Fallback or ntfy\", "
|
||||
"then choose \"ntfy\"."
|
||||
msgid "If the Matrix app asks, \"Choose a distributor: FCM Fallback or ntfy\", then choose \"ntfy\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:100
|
||||
msgid ""
|
||||
"If the Matrix app doesn't seem to pick it up, try restarting it and try "
|
||||
"the Troubleshooting section below."
|
||||
msgid "If the Matrix app doesn't seem to pick it up, try restarting it and try the Troubleshooting section below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:102
|
||||
@ -278,20 +202,11 @@ msgid "Web App"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:104
|
||||
msgid ""
|
||||
"ntfy also has a web app to subscribe to and push to topics from the "
|
||||
"browser. This may be helpful to further troubleshoot UnifiedPush problems"
|
||||
" or to use ntfy for other purposes. The web app only runs in the browser "
|
||||
"locally (after downloading the JavaScript)."
|
||||
msgid "ntfy also has a web app to subscribe to and push to topics from the browser. This may be helpful to further troubleshoot UnifiedPush problems or to use ntfy for other purposes. The web app only runs in the browser locally (after downloading the JavaScript)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:106
|
||||
msgid ""
|
||||
"The web app is disabled in this playbook by default as the expectation is"
|
||||
" that most users won't use it. You can either use the [official hosted "
|
||||
"one](https://ntfy.sh/app) (it supports using other public reachable ntfy "
|
||||
"instances) or host it yourself by setting `ntfy_web_root: \"app\"` and "
|
||||
"re-running Ansible."
|
||||
msgid "The web app is disabled in this playbook by default as the expectation is that most users won't use it. You can either use the [official hosted one](https://ntfy.sh/app) (it supports using other public reachable ntfy instances) or host it yourself by setting `ntfy_web_root: \"app\"` and re-running Ansible."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:108
|
||||
@ -299,57 +214,25 @@ msgid "Troubleshooting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:110
|
||||
msgid ""
|
||||
"First check that the Matrix client app you are using supports "
|
||||
"UnifiedPush. There may well be different variants of the app."
|
||||
msgid "First check that the Matrix client app you are using supports UnifiedPush. There may well be different variants of the app."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:112
|
||||
msgid ""
|
||||
"Set the ntfy server's log level to 'DEBUG', as shown in the example "
|
||||
"settings above, and watch the server's logs with `sudo journalctl -fu "
|
||||
"matrix-ntfy`."
|
||||
msgid "Set the ntfy server's log level to 'DEBUG', as shown in the example settings above, and watch the server's logs with `sudo journalctl -fu matrix-ntfy`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:114
|
||||
msgid ""
|
||||
"To check if UnifiedPush is correctly configured on the client device, "
|
||||
"look at \"Settings -> Notifications -> Notification Targets\" in Element "
|
||||
"Android or SchildiChat Android, or \"Settings -> Notifications -> "
|
||||
"Devices\" in FluffyChat. There should be one entry for each Matrix client"
|
||||
" app that has enabled push notifications, and when that client is using "
|
||||
"UnifiedPush you should see a URL that begins with your ntfy server's URL."
|
||||
msgid "To check if UnifiedPush is correctly configured on the client device, look at \"Settings -> Notifications -> Notification Targets\" in Element Android or SchildiChat Android, or \"Settings -> Notifications -> Devices\" in FluffyChat. There should be one entry for each Matrix client app that has enabled push notifications, and when that client is using UnifiedPush you should see a URL that begins with your ntfy server's URL."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:116
|
||||
msgid ""
|
||||
"In the \"Notification Targets\" screen in Element Android or SchildiChat "
|
||||
"Android, two relevant URLs are shown, \"push\\_key\" and \"Url\", and "
|
||||
"both should begin with your ntfy server's URL. If \"push\\_key\" shows "
|
||||
"your server but \"Url\" shows an external server such as "
|
||||
"`up.schildi.chat` then push notifications will still work but are being "
|
||||
"routed through that external server before they reach your ntfy server. "
|
||||
"To rectify that, in SchildiChat (at least around version 1.4.20.sc55) you"
|
||||
" must enable the `Force custom push gateway` setting as described in the "
|
||||
"\"Usage\" section above."
|
||||
msgid "In the \"Notification Targets\" screen in Element Android or SchildiChat Android, two relevant URLs are shown, \"push\\_key\" and \"Url\", and both should begin with your ntfy server's URL. If \"push\\_key\" shows your server but \"Url\" shows an external server such as `up.schildi.chat` then push notifications will still work but are being routed through that external server before they reach your ntfy server. To rectify that, in SchildiChat (at least around version 1.4.20.sc55) you must enable the `Force custom push gateway` setting as described in the \"Usage\" section above."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:118
|
||||
msgid ""
|
||||
"If it is not working, useful tools are \"Settings -> Notifications -> Re-"
|
||||
"register push distributor\" and \"Settings -> Notifications -> "
|
||||
"Troubleshoot Notifications\" in SchildiChat Android (possibly also "
|
||||
"Element Android). In particular the \"Endpoint/FCM\" step of that "
|
||||
"troubleshooter should display your ntfy server's URL that it has "
|
||||
"discovered from the ntfy client app."
|
||||
msgid "If it is not working, useful tools are \"Settings -> Notifications -> Re-register push distributor\" and \"Settings -> Notifications -> Troubleshoot Notifications\" in SchildiChat Android (possibly also Element Android). In particular the \"Endpoint/FCM\" step of that troubleshooter should display your ntfy server's URL that it has discovered from the ntfy client app."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ntfy.md:120
|
||||
msgid ""
|
||||
"The simple [UnifiedPush "
|
||||
"troubleshooting](https://unifiedpush.org/users/troubleshooting/) app [UP-"
|
||||
"Example](https://f-droid.org/en/packages/org.unifiedpush.example/) can be"
|
||||
" used to manually test UnifiedPush registration and operation on an "
|
||||
"Android device."
|
||||
msgid "The simple [UnifiedPush troubleshooting](https://unifiedpush.org/users/troubleshooting/) app [UP-Example](https://f-droid.org/en/packages/org.unifiedpush.example/) can be used to manually test UnifiedPush registration and operation on an Android device."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -22,16 +22,11 @@ msgstr ""
|
||||
"Generated-By: Babel 2.16.0\n"
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:1
|
||||
msgid ""
|
||||
"Using your own webserver, instead of this playbook's Traefik reverse-"
|
||||
"proxy (optional, advanced)"
|
||||
msgid "Using your own webserver, instead of this playbook's Traefik reverse-proxy (optional, advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:3
|
||||
msgid ""
|
||||
"By default, this playbook installs its own [Traefik](https://traefik.io/)"
|
||||
" reverse-proxy server (in a Docker container) which listens on ports 80 "
|
||||
"and 443. If that's okay, you can skip this document."
|
||||
msgid "By default, this playbook installs its own [Traefik](https://traefik.io/) reverse-proxy server (in a Docker container) which listens on ports 80 and 443. If that's okay, you can skip this document."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:5
|
||||
@ -39,24 +34,15 @@ msgid "Traefik"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:7
|
||||
msgid ""
|
||||
"[Traefik](https://traefik.io/) is the default reverse-proxy for the "
|
||||
"playbook since [2023-02-26](../CHANGELOG.md/#2023-02-26) and serves **2 "
|
||||
"purposes**:"
|
||||
msgid "[Traefik](https://traefik.io/) is the default reverse-proxy for the playbook since [2023-02-26](../CHANGELOG.md/#2023-02-26) and serves **2 purposes**:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:9
|
||||
msgid ""
|
||||
"serving public traffic and providing SSL-termination with certificates "
|
||||
"obtained from [Let's Encrypt](https://letsencrypt.org/). See [Adjusting "
|
||||
"SSL certificate retrieval](./configuring-playbook-ssl-certificates.md)."
|
||||
msgid "serving public traffic and providing SSL-termination with certificates obtained from [Let's Encrypt](https://letsencrypt.org/). See [Adjusting SSL certificate retrieval](./configuring-playbook-ssl-certificates.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:11
|
||||
msgid ""
|
||||
"assists internal communication between addon services (briges, bots, "
|
||||
"etc.) and the homeserver via an internal entrypoint (`matrix-internal-"
|
||||
"matrix-client-api`)."
|
||||
msgid "assists internal communication between addon services (briges, bots, etc.) and the homeserver via an internal entrypoint (`matrix-internal-matrix-client-api`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:13
|
||||
@ -68,10 +54,7 @@ msgid "Traefik managed by the playbook"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:17
|
||||
msgid ""
|
||||
"To have the playbook install and use Traefik, add the following "
|
||||
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
|
||||
"file:"
|
||||
msgid "To have the playbook install and use Traefik, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:25
|
||||
@ -83,15 +66,11 @@ msgid "Traefik managed by you"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:53
|
||||
msgid ""
|
||||
"In this mode all roles will still have Traefik labels attached. You will,"
|
||||
" however, need to configure your Traefik instance and its entrypoints."
|
||||
msgid "In this mode all roles will still have Traefik labels attached. You will, however, need to configure your Traefik instance and its entrypoints."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:55
|
||||
msgid ""
|
||||
"By default, the playbook configured a `default` certificate resolver and "
|
||||
"multiple entrypoints."
|
||||
msgid "By default, the playbook configured a `default` certificate resolver and multiple entrypoints."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:57
|
||||
@ -103,42 +82,27 @@ msgid "`web` (TCP port `80`) - used for redirecting to HTTPS (`web-secure`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:60
|
||||
msgid ""
|
||||
"`web-secure` (TCP port `443`) - used for exposing the Matrix Client-"
|
||||
"Server API and all other services"
|
||||
msgid "`web-secure` (TCP port `443`) - used for exposing the Matrix Client-Server API and all other services"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:61
|
||||
msgid ""
|
||||
"`matrix-federation` (TCP port `8448`) - used for exposing the Matrix "
|
||||
"Federation API"
|
||||
msgid "`matrix-federation` (TCP port `8448`) - used for exposing the Matrix Federation API"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:62
|
||||
msgid ""
|
||||
"`matrix-internal-matrix-client-api` (TCP port `8008`) - used internally "
|
||||
"for addon services (bridges, bots) to communicate with the homserver"
|
||||
msgid "`matrix-internal-matrix-client-api` (TCP port `8008`) - used internally for addon services (bridges, bots) to communicate with the homserver"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:64
|
||||
msgid ""
|
||||
"Below is some configuration for running Traefik yourself, although we "
|
||||
"recommend using [Traefik managed by the playbook](#traefik-managed-by-"
|
||||
"the-playbook)."
|
||||
msgid "Below is some configuration for running Traefik yourself, although we recommend using [Traefik managed by the playbook](#traefik-managed-by-the-playbook)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:66
|
||||
msgid ""
|
||||
"Note that this configuration on its own does **not** redirect traffic on "
|
||||
"port 80 (plain HTTP) to port 443 for HTTPS. If you are not already doing "
|
||||
"this in Traefik, it can be added to Traefik in a [file "
|
||||
"provider](https://docs.traefik.io/v2.0/providers/file/) as follows:"
|
||||
msgid "Note that this configuration on its own does **not** redirect traffic on port 80 (plain HTTP) to port 443 for HTTPS. If you are not already doing this in Traefik, it can be added to Traefik in a [file provider](https://docs.traefik.io/v2.0/providers/file/) as follows:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:86
|
||||
msgid ""
|
||||
"You can use the following `docker-compose.yml` as example to launch "
|
||||
"Traefik."
|
||||
msgid "You can use the following `docker-compose.yml` as example to launch Traefik."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:122
|
||||
@ -158,22 +122,11 @@ msgid "There are 2 ways to go about it:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:130
|
||||
msgid ""
|
||||
"(recommended) [Fronting the integrated reverse-proxy webserver with "
|
||||
"another reverse-proxy](#fronting-the-integrated-reverse-proxy-webserver-"
|
||||
"with-another-reverse-proxy) - using the playbook-managed reverse-proxy "
|
||||
"(Traefik), but disabling SSL termination for it, exposing this reverse-"
|
||||
"proxy on a few local ports (e.g. `127.0.0.1:81`, etc.) and forwarding "
|
||||
"traffic from your own webserver to those few ports"
|
||||
msgid "(recommended) [Fronting the integrated reverse-proxy webserver with another reverse-proxy](#fronting-the-integrated-reverse-proxy-webserver-with-another-reverse-proxy) - using the playbook-managed reverse-proxy (Traefik), but disabling SSL termination for it, exposing this reverse-proxy on a few local ports (e.g. `127.0.0.1:81`, etc.) and forwarding traffic from your own webserver to those few ports"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:132
|
||||
msgid ""
|
||||
"(difficult) [Using no reverse-proxy on the Matrix side at all](#using-no-"
|
||||
"reverse-proxy-on-the-matrix-side-at-all) disabling the playbook-managed "
|
||||
"reverse-proxy (Traefik), exposing services one by one using "
|
||||
"`_host_bind_port` variables and forwarding traffic from your own "
|
||||
"webserver to those ports"
|
||||
msgid "(difficult) [Using no reverse-proxy on the Matrix side at all](#using-no-reverse-proxy-on-the-matrix-side-at-all) disabling the playbook-managed reverse-proxy (Traefik), exposing services one by one using `_host_bind_port` variables and forwarding traffic from your own webserver to those ports"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:134
|
||||
@ -181,57 +134,31 @@ msgid "Fronting the integrated reverse-proxy webserver with another reverse-prox
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:136
|
||||
msgid ""
|
||||
"This method is about leaving the integrated reverse-proxy webserver be, "
|
||||
"but making it not get in the way (using up important ports, trying to "
|
||||
"retrieve SSL certificates, etc.)."
|
||||
msgid "This method is about leaving the integrated reverse-proxy webserver be, but making it not get in the way (using up important ports, trying to retrieve SSL certificates, etc.)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:138
|
||||
msgid ""
|
||||
"If you wish to use another webserver, the integrated reverse-proxy "
|
||||
"webserver usually gets in the way because it attempts to fetch SSL "
|
||||
"certificates and binds to ports 80, 443 and 8448 (if Matrix Federation is"
|
||||
" enabled)."
|
||||
msgid "If you wish to use another webserver, the integrated reverse-proxy webserver usually gets in the way because it attempts to fetch SSL certificates and binds to ports 80, 443 and 8448 (if Matrix Federation is enabled)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:140
|
||||
msgid ""
|
||||
"You can disable such behavior and make the integrated reverse-proxy "
|
||||
"webserver only serve traffic locally on the host itself (or over a local "
|
||||
"network)."
|
||||
msgid "You can disable such behavior and make the integrated reverse-proxy webserver only serve traffic locally on the host itself (or over a local network)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:142
|
||||
msgid ""
|
||||
"This is the recommended way for using another reverse-proxy, because the "
|
||||
"integrated one would act as a black box and wire all Matrix services "
|
||||
"correctly. You would then only need to reverse-proxy a few individual "
|
||||
"domains and ports over to it."
|
||||
msgid "This is the recommended way for using another reverse-proxy, because the integrated one would act as a black box and wire all Matrix services correctly. You would then only need to reverse-proxy a few individual domains and ports over to it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:144
|
||||
msgid ""
|
||||
"To front Traefik with another reverse-proxy, you would need some "
|
||||
"configuration like this:"
|
||||
msgid "To front Traefik with another reverse-proxy, you would need some configuration like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:194
|
||||
msgid ""
|
||||
"Such a configuration would expose all services on a local port `81` and "
|
||||
"Matrix Federation on a local port `8449`. Your reverse-proxy "
|
||||
"configuration needs to send traffic to these ports. [`examples/reverse-"
|
||||
"proxies`](../examples/reverse-proxies/) contains examples for various "
|
||||
"webservers such as Apache2, Caddy, HAproxy, nginx and Nginx Proxy "
|
||||
"Manager."
|
||||
msgid "Such a configuration would expose all services on a local port `81` and Matrix Federation on a local port `8449`. Your reverse-proxy configuration needs to send traffic to these ports. [`examples/reverse-proxies`](../examples/reverse-proxies/) contains examples for various webservers such as Apache2, Caddy, HAproxy, nginx and Nginx Proxy Manager."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:196
|
||||
msgid ""
|
||||
"It's important that these webservers proxy-pass requests to the correct "
|
||||
"`ip:port` and also set the `Host` HTTP header appropriately. If you don't"
|
||||
" pass the `Host` header correctly, Traefik will return a `404 - not "
|
||||
"found` error."
|
||||
msgid "It's important that these webservers proxy-pass requests to the correct `ip:port` and also set the `Host` HTTP header appropriately. If you don't pass the `Host` header correctly, Traefik will return a `404 - not found` error."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:198
|
||||
@ -251,42 +178,17 @@ msgid "Using no reverse-proxy on the Matrix side at all"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:204
|
||||
msgid ""
|
||||
"Instead of [Fronting the integrated reverse-proxy webserver with another "
|
||||
"reverse-proxy](#fronting-the-integrated-reverse-proxy-webserver-with-"
|
||||
"another-reverse-proxy), you can also go another way -- completely "
|
||||
"disabling the playbook-managed Traefik reverse-proxy. You would then need"
|
||||
" to reverse-proxy from your own webserver directly to each individual "
|
||||
"Matrix service."
|
||||
msgid "Instead of [Fronting the integrated reverse-proxy webserver with another reverse-proxy](#fronting-the-integrated-reverse-proxy-webserver-with-another-reverse-proxy), you can also go another way -- completely disabling the playbook-managed Traefik reverse-proxy. You would then need to reverse-proxy from your own webserver directly to each individual Matrix service."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:206
|
||||
msgid ""
|
||||
"This is more difficult, as you would need to handle the configuration for"
|
||||
" each service manually. Enabling additional services would come with "
|
||||
"extra manual work you need to do."
|
||||
msgid "This is more difficult, as you would need to handle the configuration for each service manually. Enabling additional services would come with extra manual work you need to do."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:208
|
||||
msgid ""
|
||||
"Also, the Traefik reverse-proxy, besides fronting everything is also "
|
||||
"serving a 2nd purpose of allowing addons services to communicate with the"
|
||||
" Matrix homeserver thanks to its `matrix-internal-matrix-client-api` "
|
||||
"entrypoint (read more about it above). Disabling Traefik completely means"
|
||||
" the playbook would wire services to directly talk to the homeserver. "
|
||||
"This can work for basic setups, but not for more complex setups involving"
|
||||
" [matrix-media-repo](./configuring-playbook-matrix-media-repo.md), "
|
||||
"[matrix-corporal](./configuring-playbook-matrix-corporal.md) or other "
|
||||
"such services that need to \"steal routes\" from the homeserver."
|
||||
msgid "Also, the Traefik reverse-proxy, besides fronting everything is also serving a 2nd purpose of allowing addons services to communicate with the Matrix homeserver thanks to its `matrix-internal-matrix-client-api` entrypoint (read more about it above). Disabling Traefik completely means the playbook would wire services to directly talk to the homeserver. This can work for basic setups, but not for more complex setups involving [matrix-media-repo](./configuring-playbook-matrix-media-repo.md), [matrix-corporal](./configuring-playbook-matrix-corporal.md) or other such services that need to \"steal routes\" from the homeserver."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-own-webserver.md:210
|
||||
msgid ""
|
||||
"If your webserver is on the same machine, ensure your web server user "
|
||||
"(something like `http`, `apache`, `www-data`, `nginx`) is part of the "
|
||||
"`matrix` group. You should run something like this: `usermod -a -G matrix"
|
||||
" nginx`. This allows your webserver user to access files owned by the "
|
||||
"`matrix` group, so that it can serve static files from `/matrix/static-"
|
||||
"files`."
|
||||
msgid "If your webserver is on the same machine, ensure your web server user (something like `http`, `apache`, `www-data`, `nginx`) is part of the `matrix` group. You should run something like this: `usermod -a -G matrix nginx`. This allows your webserver user to access files owned by the `matrix` group, so that it can serve static files from `/matrix/static-files`."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,26 +26,15 @@ msgid "Setting up Pantalaimon (E2EE aware proxy daemon) (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-pantalaimon.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the "
|
||||
"[pantalaimon](https://github.com/matrix-org/pantalaimon) E2EE aware proxy"
|
||||
" daemon for you."
|
||||
msgid "The playbook can install and configure the [pantalaimon](https://github.com/matrix-org/pantalaimon) E2EE aware proxy daemon for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-pantalaimon.md:5
|
||||
msgid ""
|
||||
"See the project's [documentation](https://github.com/matrix-"
|
||||
"org/pantalaimon/blob/master/README.md) to learn what it does and why it "
|
||||
"might be useful to you."
|
||||
msgid "See the project's [documentation](https://github.com/matrix-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
|
||||
msgid ""
|
||||
"This role exposes Pantalaimon's API only within the container network, so"
|
||||
" bots and clients installed on the same machine can use it. In particular"
|
||||
" the [Draupnir](configuring-playbook-bot-draupnir.md) and [Mjolnir"
|
||||
"](configuring-playbook-bot-mjolnir.md) roles (and possibly others) can "
|
||||
"use it."
|
||||
msgid "This role exposes Pantalaimon's API only within the container network, so bots and clients installed on the same machine can use it. In particular the [Draupnir](configuring-playbook-bot-draupnir.md) and [Mjolnir](configuring-playbook-bot-mjolnir.md) roles (and possibly others) can use it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-pantalaimon.md:9
|
||||
@ -53,17 +42,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-pantalaimon.md:11
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
|
||||
"needs):"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-pantalaimon.md:17
|
||||
msgid ""
|
||||
"The default configuration should suffice. For advanced configuration, you"
|
||||
" can override the variables documented in the role's "
|
||||
"[defaults](../roles/custom/matrix-pantalaimon/defaults/main.yml)."
|
||||
msgid "The default configuration should suffice. For advanced configuration, you can override the variables documented in the role's [defaults](../roles/custom/matrix-pantalaimon/defaults/main.yml)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-pantalaimon.md:19
|
||||
@ -71,31 +54,13 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-pantalaimon.md:21
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-pantalaimon.md:28
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-pantalaimon.md:30
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@ -26,18 +26,11 @@ msgid "Setting up postgres backup (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [docker-postgres-backup-"
|
||||
"local](https://github.com/prodrigestivill/docker-postgres-backup-local) "
|
||||
"for you via the [ansible-role-postgres-backup](https://github.com/mother-"
|
||||
"of-all-self-hosting/ansible-role-postgres-backup) Ansible role."
|
||||
msgid "The playbook can install and configure [docker-postgres-backup-local](https://github.com/prodrigestivill/docker-postgres-backup-local) for you via the [ansible-role-postgres-backup](https://github.com/mother-of-all-self-hosting/ansible-role-postgres-backup) Ansible role."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md:5
|
||||
msgid ""
|
||||
"For a more complete backup solution (one that includes not only Postgres,"
|
||||
" but also other configuration/data files), you may wish to look into "
|
||||
"[BorgBackup](configuring-playbook-backup-borg.md) instead."
|
||||
msgid "For a more complete backup solution (one that includes not only Postgres, but also other configuration/data files), you may wish to look into [BorgBackup](configuring-playbook-backup-borg.md) instead."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md:7
|
||||
@ -45,15 +38,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md:9
|
||||
msgid ""
|
||||
"To enable Postgres backup, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Postgres backup, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md:15
|
||||
msgid ""
|
||||
"Refer to the table below for additional configuration variables and their"
|
||||
" default values."
|
||||
msgid "Refer to the table below for additional configuration variables and their default values."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md
|
||||
@ -77,10 +66,7 @@ msgid "`false`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md
|
||||
msgid ""
|
||||
"Set to true to use [docker-postgres-backup-"
|
||||
"local](https://github.com/prodrigestivill/docker-postgres-backup-local) "
|
||||
"to create automatic database backups"
|
||||
msgid "Set to true to use [docker-postgres-backup-local](https://github.com/prodrigestivill/docker-postgres-backup-local) to create automatic database backups"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md
|
||||
@ -160,24 +146,13 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md:29
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md:36
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-postgres-backup.md:38
|
||||
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."
|
||||
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 ""
|
||||
|
||||
|
||||
@ -22,16 +22,11 @@ msgstr ""
|
||||
"Generated-By: Babel 2.16.0\n"
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:1
|
||||
msgid ""
|
||||
"Enabling metrics and graphs (Prometheus, Grafana) for your Matrix server "
|
||||
"(optional)"
|
||||
msgid "Enabling metrics and graphs (Prometheus, Grafana) for your Matrix server (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:3
|
||||
msgid ""
|
||||
"The playbook can install [Grafana](https://grafana.com/) with "
|
||||
"[Prometheus](https://prometheus.io/) and configure performance metrics of"
|
||||
" your homeserver with graphs for you."
|
||||
msgid "The playbook can install [Grafana](https://grafana.com/) with [Prometheus](https://prometheus.io/) and configure performance metrics of your homeserver with graphs for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:5
|
||||
@ -39,16 +34,11 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:7
|
||||
msgid ""
|
||||
"To enable Grafana and/or Prometheus, add the following configuration to "
|
||||
"your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Grafana and/or Prometheus, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:33
|
||||
msgid ""
|
||||
"The retention policy of Prometheus metrics is [15 days by "
|
||||
"default](https://prometheus.io/docs/prometheus/latest/storage"
|
||||
"/#operational-aspects). Older data gets deleted automatically."
|
||||
msgid "The retention policy of Prometheus metrics is [15 days by default](https://prometheus.io/docs/prometheus/latest/storage/#operational-aspects). Older data gets deleted automatically."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:35
|
||||
@ -56,22 +46,15 @@ msgid "Adjusting the Grafana URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:37
|
||||
msgid ""
|
||||
"By default, this playbook installs Grafana web user-interface on the "
|
||||
"`stats.` subdomain (`stats.example.com`) and requires you to [adjust your"
|
||||
" DNS records](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs Grafana web user-interface on the `stats.` subdomain (`stats.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:39
|
||||
msgid ""
|
||||
"By tweaking the `grafana_hostname` variable, you can easily make the "
|
||||
"service available at a **different hostname** than the default one."
|
||||
msgid "By tweaking the `grafana_hostname` variable, you can easily make the service available at a **different hostname** than the default one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:41
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:48
|
||||
@ -79,21 +62,15 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:50
|
||||
msgid ""
|
||||
"Once you've decided on the domain, **you may need to adjust your DNS** "
|
||||
"records to point the Grafana domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain, **you may need to adjust your DNS** records to point the Grafana domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:52
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `stats`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `stats`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:54
|
||||
msgid ""
|
||||
"**Note**: It is possible to install Prometheus without installing "
|
||||
"Grafana. This case it is not required to create the CNAME record."
|
||||
msgid "**Note**: It is possible to install Prometheus without installing Grafana. This case it is not required to create the CNAME record."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:56
|
||||
@ -101,26 +78,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:58
|
||||
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:"
|
||||
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-prometheus-grafana.md:65
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:67
|
||||
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."
|
||||
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-prometheus-grafana.md:69
|
||||
@ -140,9 +106,7 @@ msgid "`prometheus_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"[Prometheus](https://prometheus.io) is a time series database. It holds "
|
||||
"all the data we're going to talk about."
|
||||
msgid "[Prometheus](https://prometheus.io) is a time series database. It holds all the data we're going to talk about."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -150,10 +114,7 @@ msgid "`prometheus_node_exporter_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"[Node Exporter](https://prometheus.io/docs/guides/node-exporter/) is an "
|
||||
"addon of sorts to Prometheus that collects generic system information "
|
||||
"such as CPU, memory, filesystem, and even system temperatures"
|
||||
msgid "[Node Exporter](https://prometheus.io/docs/guides/node-exporter/) is an addon of sorts to Prometheus that collects generic system information such as CPU, memory, filesystem, and even system temperatures"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -161,9 +122,7 @@ msgid "`prometheus_postgres_exporter_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"[Postgres Exporter](configuring-playbook-prometheus-postgres.md) is an "
|
||||
"addon of sorts to expose Postgres database metrics to Prometheus."
|
||||
msgid "[Postgres Exporter](configuring-playbook-prometheus-postgres.md) is an addon of sorts to expose Postgres database metrics to Prometheus."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -171,9 +130,7 @@ msgid "`matrix_prometheus_nginxlog_exporter_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"[NGINX Log Exporter](configuring-playbook-prometheus-nginxlog.md) is an "
|
||||
"addon of sorts to expose NGINX logs to Prometheus."
|
||||
msgid "[NGINX Log Exporter](configuring-playbook-prometheus-nginxlog.md) is an addon of sorts to expose NGINX logs to Prometheus."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -181,10 +138,7 @@ msgid "`grafana_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"[Grafana](https://grafana.com/) is the visual component. It shows (on the"
|
||||
" `stats.example.com` subdomain) the dashboards with the graphs that we're"
|
||||
" interested in"
|
||||
msgid "[Grafana](https://grafana.com/) is the visual component. It shows (on the `stats.example.com` subdomain) the dashboards with the graphs that we're interested in"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -192,11 +146,7 @@ msgid "`grafana_anonymous_access`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"By default you need to log in to see graphs. If you want to publicly "
|
||||
"share your graphs (e.g. when asking for help in "
|
||||
"[`#synapse:matrix.org`](https://matrix.to/#/#synapse:matrix.org?via=matrix.org&via=privacytools.io&via=mozilla.org))"
|
||||
" you'll want to enable this option."
|
||||
msgid "By default you need to log in to see graphs. If you want to publicly share your graphs (e.g. when asking for help in [`#synapse:matrix.org`](https://matrix.to/#/#synapse:matrix.org?via=matrix.org&via=privacytools.io&via=mozilla.org)) you'll want to enable this option."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -204,10 +154,7 @@ msgid "`grafana_default_admin_user`<br>`grafana_default_admin_password`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"By default Grafana creates a user with `admin` as the username and "
|
||||
"password. If you feel this is insecure and you want to change it "
|
||||
"beforehand, you can do that here"
|
||||
msgid "By default Grafana creates a user with `admin` as the username and password. If you feel this is insecure and you want to change it beforehand, you can do that here"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:81
|
||||
@ -215,24 +162,11 @@ msgid "Security and privacy"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:83
|
||||
msgid ""
|
||||
"Metrics and resulting graphs can contain a lot of information. This "
|
||||
"includes system specs but also usage patterns. This applies especially to"
|
||||
" small personal/family scale homeservers. Someone might be able to figure"
|
||||
" out when you wake up and go to sleep by looking at the graphs over time."
|
||||
" Think about this before enabling anonymous access. And you should really"
|
||||
" not forget to change your Grafana password."
|
||||
msgid "Metrics and resulting graphs can contain a lot of information. This includes system specs but also usage patterns. This applies especially to small personal/family scale homeservers. Someone might be able to figure out when you wake up and go to sleep by looking at the graphs over time. Think about this before enabling anonymous access. And you should really not forget to change your Grafana password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:85
|
||||
msgid ""
|
||||
"Most of our docker containers run with limited system access, but the "
|
||||
"`prometheus-node-exporter` has access to the host network stack and "
|
||||
"(readonly) root filesystem. This is required to report on them. If you "
|
||||
"don't like that, you can set `prometheus_node_exporter_enabled: false` "
|
||||
"(which is actually the default). You will still get Synapse metrics with "
|
||||
"this container disabled. Both of the dashboards will always be enabled, "
|
||||
"so you can still look at historical data after disabling either source."
|
||||
msgid "Most of our docker containers run with limited system access, but the `prometheus-node-exporter` has access to the host network stack and (readonly) root filesystem. This is required to report on them. If you don't like that, you can set `prometheus_node_exporter_enabled: false` (which is actually the default). You will still get Synapse metrics with this container disabled. Both of the dashboards will always be enabled, so you can still look at historical data after disabling either source."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:87
|
||||
@ -240,37 +174,19 @@ msgid "Collecting metrics to an external Prometheus server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:89
|
||||
msgid ""
|
||||
"**If the integrated Prometheus server is enabled** (`prometheus_enabled: "
|
||||
"true`), metrics are collected by it from each service via communication "
|
||||
"that happens over the container network. Each service does not need to "
|
||||
"expose its metrics \"publicly\"."
|
||||
msgid "**If the integrated Prometheus server is enabled** (`prometheus_enabled: true`), metrics are collected by it from each service via communication that happens over the container network. Each service does not need to expose its metrics \"publicly\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:91
|
||||
msgid ""
|
||||
"When you'd like **to collect metrics from an external Prometheus "
|
||||
"server**, you need to expose service metrics outside of the container "
|
||||
"network."
|
||||
msgid "When you'd like **to collect metrics from an external Prometheus server**, you need to expose service metrics outside of the container network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:93
|
||||
msgid ""
|
||||
"The playbook provides a single endpoint "
|
||||
"(`https://matrix.example.com/metrics/*`), under which various services "
|
||||
"may expose their metrics (e.g. `/metrics/node-exporter`, `/metrics"
|
||||
"/postgres-exporter`, `/metrics/hookshot`, etc). To expose all services on"
|
||||
" this `/metrics/*` feature, use `matrix_metrics_exposure_enabled`. To "
|
||||
"protect access using [Basic "
|
||||
"Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication),"
|
||||
" see `matrix_metrics_exposure_http_basic_auth_enabled` and "
|
||||
"`matrix_metrics_exposure_http_basic_auth_users` below."
|
||||
msgid "The playbook provides a single endpoint (`https://matrix.example.com/metrics/*`), under which various services may expose their metrics (e.g. `/metrics/node-exporter`, `/metrics/postgres-exporter`, `/metrics/hookshot`, etc). To expose all services on this `/metrics/*` feature, use `matrix_metrics_exposure_enabled`. To protect access using [Basic Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication), see `matrix_metrics_exposure_http_basic_auth_enabled` and `matrix_metrics_exposure_http_basic_auth_users` below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:95
|
||||
msgid ""
|
||||
"When using `matrix_metrics_exposure_enabled`, you don't need to expose "
|
||||
"metrics for individual services one by one."
|
||||
msgid "When using `matrix_metrics_exposure_enabled`, you don't need to expose metrics for individual services one by one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:97
|
||||
@ -282,12 +198,7 @@ msgid "`matrix_metrics_exposure_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to **enable metrics exposure for all services** on "
|
||||
"`https://matrix.example.com/metrics/*`. If you think this is too much, "
|
||||
"refer to the helpful (but nonexhaustive) list of individual "
|
||||
"`matrix_SERVICE_metrics_proxying_enabled` (or similar) variables below "
|
||||
"for exposing metrics on a per-service basis."
|
||||
msgid "Set this to `true` to **enable metrics exposure for all services** on `https://matrix.example.com/metrics/*`. If you think this is too much, refer to the helpful (but nonexhaustive) list of individual `matrix_SERVICE_metrics_proxying_enabled` (or similar) variables below for exposing metrics on a per-service basis."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -295,13 +206,7 @@ msgid "`matrix_metrics_exposure_http_basic_auth_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to protect all `https://matrix.example.com/metrics/*` "
|
||||
"endpoints with [Basic "
|
||||
"Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)"
|
||||
" (see the other variables below for supplying the actual credentials). "
|
||||
"When enabled, all endpoints beneath `/metrics` will be protected with the"
|
||||
" same credentials"
|
||||
msgid "Set this to `true` to protect all `https://matrix.example.com/metrics/*` endpoints with [Basic Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication) (see the other variables below for supplying the actual credentials). When enabled, all endpoints beneath `/metrics` will be protected with the same credentials"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -309,11 +214,7 @@ msgid "`matrix_metrics_exposure_http_basic_auth_users`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to the Basic Authentication credentials (raw `htpasswd` file "
|
||||
"content) used to protect `/metrics/*`. This htpasswd-file needs to be "
|
||||
"generated with the `htpasswd` tool and can include multiple "
|
||||
"username/password pairs."
|
||||
msgid "Set this to the Basic Authentication credentials (raw `htpasswd` file content) used to protect `/metrics/*`. This htpasswd-file needs to be generated with the `htpasswd` tool and can include multiple username/password pairs."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -321,9 +222,7 @@ msgid "`matrix_synapse_metrics_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to make Synapse expose metrics (locally, on the "
|
||||
"container network)"
|
||||
msgid "Set this to `true` to make Synapse expose metrics (locally, on the container network)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -331,20 +230,11 @@ msgid "`matrix_synapse_metrics_proxying_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to expose Synapse's metrics on "
|
||||
"`https://matrix.example.com/metrics/synapse/main-process` and "
|
||||
"`https://matrix.example.com/metrics/synapse/worker/TYPE-ID`. Read [below"
|
||||
"](#collecting-synapse-worker-metrics-to-an-external-prometheus-server) if"
|
||||
" you're running a Synapse worker setup (`matrix_synapse_workers_enabled: "
|
||||
"true`). To password-protect the metrics, see "
|
||||
"`matrix_metrics_exposure_http_basic_auth_users` above."
|
||||
msgid "Set this to `true` to expose Synapse's metrics on `https://matrix.example.com/metrics/synapse/main-process` and `https://matrix.example.com/metrics/synapse/worker/TYPE-ID`. Read [below](#collecting-synapse-worker-metrics-to-an-external-prometheus-server) if you're running a Synapse worker setup (`matrix_synapse_workers_enabled: true`). To password-protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` above."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to enable the node (general system stats) exporter "
|
||||
"(locally, on the container network)"
|
||||
msgid "Set this to `true` to enable the node (general system stats) exporter (locally, on the container network)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -352,16 +242,11 @@ msgid "`prometheus_node_exporter_container_labels_traefik_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to expose the node (general system stats) metrics on "
|
||||
"`https://matrix.example.com/metrics/node-exporter`. To password-protect "
|
||||
"the metrics, see `matrix_metrics_exposure_http_basic_auth_users` above."
|
||||
msgid "Set this to `true` to expose the node (general system stats) metrics on `https://matrix.example.com/metrics/node-exporter`. To password-protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` above."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to enable the [Postgres exporter](configuring-"
|
||||
"playbook-prometheus-postgres.md) (locally, on the container network)"
|
||||
msgid "Set this to `true` to enable the [Postgres exporter](configuring-playbook-prometheus-postgres.md) (locally, on the container network)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -369,18 +254,11 @@ msgid "`prometheus_postgres_exporter_container_labels_traefik_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to expose the [Postgres exporter](configuring-"
|
||||
"playbook-prometheus-postgres.md) metrics on "
|
||||
"`https://matrix.example.com/metrics/postgres-exporter`. To password-"
|
||||
"protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` "
|
||||
"above."
|
||||
msgid "Set this to `true` to expose the [Postgres exporter](configuring-playbook-prometheus-postgres.md) metrics on `https://matrix.example.com/metrics/postgres-exporter`. To password-protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` above."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to enable the [NGINX Log exporter](configuring-"
|
||||
"playbook-prometheus-nginxlog.md) (locally, on the container network)"
|
||||
msgid "Set this to `true` to enable the [NGINX Log exporter](configuring-playbook-prometheus-nginxlog.md) (locally, on the container network)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -388,9 +266,7 @@ msgid "`matrix_sliding_sync_metrics_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to make [Sliding Sync](configuring-playbook-sliding-"
|
||||
"sync-proxy.md) expose metrics (locally, on the container network)"
|
||||
msgid "Set this to `true` to make [Sliding Sync](configuring-playbook-sliding-sync-proxy.md) expose metrics (locally, on the container network)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -398,11 +274,7 @@ msgid "`matrix_sliding_sync_metrics_proxying_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to expose the [Sliding Sync](configuring-playbook-"
|
||||
"sliding-sync-proxy.md) metrics on `https://matrix.example.com/metrics"
|
||||
"/sliding-sync`. To password-protect the metrics, see "
|
||||
"`matrix_metrics_exposure_http_basic_auth_users` above."
|
||||
msgid "Set this to `true` to expose the [Sliding Sync](configuring-playbook-sliding-sync-proxy.md) metrics on `https://matrix.example.com/metrics/sliding-sync`. To password-protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` above."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -410,9 +282,7 @@ msgid "`matrix_bridge_hookshot_metrics_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to make [Hookshot](configuring-playbook-bridge-"
|
||||
"hookshot.md) expose metrics (locally, on the container network)"
|
||||
msgid "Set this to `true` to make [Hookshot](configuring-playbook-bridge-hookshot.md) expose metrics (locally, on the container network)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -420,11 +290,7 @@ msgid "`matrix_bridge_hookshot_metrics_proxying_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to expose the [Hookshot](configuring-playbook-bridge-"
|
||||
"hookshot.md) metrics on `https://matrix.example.com/metrics/hookshot`. To"
|
||||
" password-protect the metrics, see "
|
||||
"`matrix_metrics_exposure_http_basic_auth_users` above."
|
||||
msgid "Set this to `true` to expose the [Hookshot](configuring-playbook-bridge-hookshot.md) metrics on `https://matrix.example.com/metrics/hookshot`. To password-protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` above."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -432,13 +298,7 @@ msgid "`matrix_SERVICE_metrics_proxying_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Various other services/roles may provide similar `_metrics_enabled` and "
|
||||
"`_metrics_proxying_enabled` variables for exposing their metrics. Refer "
|
||||
"to each role for details. To password-protect the metrics, see "
|
||||
"`matrix_metrics_exposure_http_basic_auth_users` above or "
|
||||
"`matrix_SERVICE_container_labels_metrics_middleware_basic_auth_enabled`/`matrix_SERVICE_container_labels_metrics_middleware_basic_auth_users`"
|
||||
" variables provided by each role."
|
||||
msgid "Various other services/roles may provide similar `_metrics_enabled` and `_metrics_proxying_enabled` variables for exposing their metrics. Refer to each role for details. To password-protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` above or `matrix_SERVICE_container_labels_metrics_middleware_basic_auth_enabled`/`matrix_SERVICE_container_labels_metrics_middleware_basic_auth_users` variables provided by each role."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
@ -446,9 +306,7 @@ msgid "`matrix_media_repo_metrics_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md
|
||||
msgid ""
|
||||
"Set this to `true` to make media-repo expose metrics (locally, on the "
|
||||
"container network)"
|
||||
msgid "Set this to `true` to make media-repo expose metrics (locally, on the container network)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:118
|
||||
@ -456,23 +314,11 @@ msgid "Collecting Synapse worker metrics to an external Prometheus server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:120
|
||||
msgid ""
|
||||
"If you are using workers (`matrix_synapse_workers_enabled: true`) and "
|
||||
"have enabled `matrix_synapse_metrics_proxying_enabled` as described "
|
||||
"above, the playbook will also automatically expose all Synapse worker "
|
||||
"threads' metrics to "
|
||||
"`https://matrix.example.com/metrics/synapse/worker/ID`, where `ID` "
|
||||
"corresponds to the worker `id` as exemplified in "
|
||||
"`matrix_synapse_workers_enabled_list`."
|
||||
msgid "If you are using workers (`matrix_synapse_workers_enabled: true`) and have enabled `matrix_synapse_metrics_proxying_enabled` as described above, the playbook will also automatically expose all Synapse worker threads' metrics to `https://matrix.example.com/metrics/synapse/worker/ID`, where `ID` corresponds to the worker `id` as exemplified in `matrix_synapse_workers_enabled_list`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:122
|
||||
msgid ""
|
||||
"The playbook also generates an exemplary config file "
|
||||
"(`/matrix/synapse/external_prometheus.yml.template`) with all the correct"
|
||||
" paths which you can copy to your Prometheus server and adapt to your "
|
||||
"needs. Make sure to edit the specified `password_file` path and contents "
|
||||
"and path to your `synapse-v2.rules`. It will look a bit like this:"
|
||||
msgid "The playbook also generates an exemplary config file (`/matrix/synapse/external_prometheus.yml.template`) with all the correct paths which you can copy to your Prometheus server and adapt to your needs. Make sure to edit the specified `password_file` path and contents and path to your `synapse-v2.rules`. It will look a bit like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:150
|
||||
@ -480,34 +326,21 @@ msgid "More information"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:152
|
||||
msgid ""
|
||||
"[Enabling synapse-usage-exporter for Synapse usage statistics"
|
||||
"](configuring-playbook-synapse-usage-exporter.md)"
|
||||
msgid "[Enabling synapse-usage-exporter for Synapse usage statistics](configuring-playbook-synapse-usage-exporter.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:153
|
||||
msgid ""
|
||||
"[Understanding Synapse Performance Issues Through Grafana Graphs](https"
|
||||
"://element-"
|
||||
"hq.github.io/synapse/latest/usage/administration/understanding_synapse_through_grafana_graphs.html)"
|
||||
" at the Synapse Github Wiki"
|
||||
msgid "[Understanding Synapse Performance Issues Through Grafana Graphs](https://element-hq.github.io/synapse/latest/usage/administration/understanding_synapse_through_grafana_graphs.html) at the Synapse Github Wiki"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:154
|
||||
msgid ""
|
||||
"[The Prometheus scraping rules](https://github.com/element-"
|
||||
"hq/synapse/tree/master/contrib/prometheus) (we use v2)"
|
||||
msgid "[The Prometheus scraping rules](https://github.com/element-hq/synapse/tree/master/contrib/prometheus) (we use v2)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:155
|
||||
msgid ""
|
||||
"[The Synapse Grafana dashboard](https://github.com/element-"
|
||||
"hq/synapse/tree/master/contrib/grafana)"
|
||||
msgid "[The Synapse Grafana dashboard](https://github.com/element-hq/synapse/tree/master/contrib/grafana)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-grafana.md:156
|
||||
msgid ""
|
||||
"[The Node Exporter dashboard](https://github.com/rfrail3/grafana-"
|
||||
"dashboards) (for generic non-synapse performance graphs)"
|
||||
msgid "[The Node Exporter dashboard](https://github.com/rfrail3/grafana-dashboards) (for generic non-synapse performance graphs)"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,45 +26,27 @@ msgid "Enabling metrics and graphs for NginX logs (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:3
|
||||
msgid ""
|
||||
"It can be useful to have some (visual) insight into "
|
||||
"[nginx](https://nginx.org/) logs."
|
||||
msgid "It can be useful to have some (visual) insight into [nginx](https://nginx.org/) logs."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:5
|
||||
msgid ""
|
||||
"This adds [prometheus-nginxlog-exporter](https://github.com/martin-"
|
||||
"helmich/prometheus-nginxlog-exporter/) to your Matrix deployment."
|
||||
msgid "This adds [prometheus-nginxlog-exporter](https://github.com/martin-helmich/prometheus-nginxlog-exporter/) to your Matrix deployment."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:7
|
||||
msgid ""
|
||||
"It will collect access logs from various nginx reverse-proxies which may "
|
||||
"be used internally (e.g. `matrix-synapse-reverse-proxy-companion`, if "
|
||||
"Synapse workers are enabled) and will make them available at a "
|
||||
"Prometheus-compatible `/metrics` endpoint."
|
||||
msgid "It will collect access logs from various nginx reverse-proxies which may be used internally (e.g. `matrix-synapse-reverse-proxy-companion`, if Synapse workers are enabled) and will make them available at a Prometheus-compatible `/metrics` endpoint."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:9
|
||||
msgid ""
|
||||
"**Note**: nginx is only used internally by this Ansible playbook. With "
|
||||
"Traefik being our default reverse-proxy, collecting nginx metrics is less"
|
||||
" relevant."
|
||||
msgid "**Note**: nginx is only used internally by this Ansible playbook. With Traefik being our default reverse-proxy, collecting nginx metrics is less relevant."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:11
|
||||
msgid ""
|
||||
"To make use of this, you need to install [Prometheus](./configuring-"
|
||||
"playbook-prometheus-grafana.md) either via the playbook or externally. "
|
||||
"When using an external Prometheus, configuration adjustments are "
|
||||
"necessary - see [Save metrics on an external Prometheus server](#save-"
|
||||
"metrics-on-an-external-prometheus-server)."
|
||||
msgid "To make use of this, you need to install [Prometheus](./configuring-playbook-prometheus-grafana.md) either via the playbook or externally. When using an external Prometheus, configuration adjustments are necessary - see [Save metrics on an external Prometheus server](#save-metrics-on-an-external-prometheus-server)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:13
|
||||
msgid ""
|
||||
"If your setup includes [Grafana](./configuring-playbook-prometheus-"
|
||||
"grafana.md), a dedicated `NGINX PROXY` Grafana dashboard will be created."
|
||||
msgid "If your setup includes [Grafana](./configuring-playbook-prometheus-grafana.md), a dedicated `NGINX PROXY` Grafana dashboard will be created."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:15
|
||||
@ -72,9 +54,7 @@ msgid "Configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:17
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:23
|
||||
@ -82,25 +62,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:25
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:32
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:34
|
||||
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."
|
||||
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-prometheus-nginxlog.md:36
|
||||
@ -108,11 +78,7 @@ msgid "Docker Image Compatibility"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:38
|
||||
msgid ""
|
||||
"At the moment of writing only images for `amd64` and `arm64` "
|
||||
"architectures are available. The playbook currently does not support "
|
||||
"[self-building](./self-building.md) a container image on other "
|
||||
"architectures. You can however use a custom-build image by setting:"
|
||||
msgid "At the moment of writing only images for `amd64` and `arm64` architectures are available. The playbook currently does not support [self-building](./self-building.md) a container image on other architectures. You can however use a custom-build image by setting:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:45
|
||||
@ -120,13 +86,7 @@ msgid "Security and privacy"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:47
|
||||
msgid ""
|
||||
"Metrics and resulting graphs can contain a lot of information. NginX logs"
|
||||
" contain information like IP address, URLs, UserAgents and more. This "
|
||||
"information can reveal usage patterns and could be considered Personally "
|
||||
"Identifiable Information (PII). Think about this before enabling "
|
||||
"(anonymous) access. Please make sure you change the default Grafana "
|
||||
"password."
|
||||
msgid "Metrics and resulting graphs can contain a lot of information. NginX logs contain information like IP address, URLs, UserAgents and more. This information can reveal usage patterns and could be considered Personally Identifiable Information (PII). Think about this before enabling (anonymous) access. Please make sure you change the default Grafana password."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:49
|
||||
@ -134,44 +94,21 @@ msgid "Save metrics on an external Prometheus server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:51
|
||||
msgid ""
|
||||
"The playbook will automatically integrate the metrics into the "
|
||||
"[Prometheus](./configuring-playbook-prometheus-grafana.md) server "
|
||||
"provided with this playbook (if enabled). In such cases, the metrics "
|
||||
"endpoint is not exposed publicly - it's only available on the container "
|
||||
"network."
|
||||
msgid "The playbook will automatically integrate the metrics into the [Prometheus](./configuring-playbook-prometheus-grafana.md) server provided with this playbook (if enabled). In such cases, the metrics endpoint is not exposed publicly - it's only available on the container network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:53
|
||||
msgid ""
|
||||
"When using an external Prometheus server, you'll need to expose metrics "
|
||||
"publicly. See [Collecting metrics to an external Prometheus server"
|
||||
"](./configuring-playbook-prometheus-grafana.md#collecting-metrics-to-an-"
|
||||
"external-prometheus-server)."
|
||||
msgid "When using an external Prometheus server, you'll need to expose metrics publicly. See [Collecting metrics to an external Prometheus server](./configuring-playbook-prometheus-grafana.md#collecting-metrics-to-an-external-prometheus-server)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:55
|
||||
msgid ""
|
||||
"You can either use "
|
||||
"`matrix_prometheus_nginxlog_exporter_metrics_proxying_enabled: true` to "
|
||||
"expose just this one service, or `matrix_metrics_exposure_enabled: true` "
|
||||
"to expose all services."
|
||||
msgid "You can either use `matrix_prometheus_nginxlog_exporter_metrics_proxying_enabled: true` to expose just this one service, or `matrix_metrics_exposure_enabled: true` to expose all services."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:57
|
||||
msgid ""
|
||||
"Whichever way you go with, this service will expose its metrics endpoint "
|
||||
"**without password-protection** at "
|
||||
"`https://matrix.example.com/metrics/nginxlog` by default."
|
||||
msgid "Whichever way you go with, this service will expose its metrics endpoint **without password-protection** at `https://matrix.example.com/metrics/nginxlog` by default."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:59
|
||||
msgid ""
|
||||
"For password-protection, use "
|
||||
"(`matrix_metrics_exposure_http_basic_auth_enabled` and "
|
||||
"`matrix_metrics_exposure_http_basic_auth_users`) or "
|
||||
"(`matrix_prometheus_nginxlog_exporter_container_labels_metrics_middleware_basic_auth_enabled`"
|
||||
" and "
|
||||
"`matrix_prometheus_nginxlog_exporter_container_labels_metrics_middleware_basic_auth_users`)."
|
||||
msgid "For password-protection, use (`matrix_metrics_exposure_http_basic_auth_enabled` and `matrix_metrics_exposure_http_basic_auth_users`) or (`matrix_prometheus_nginxlog_exporter_container_labels_metrics_middleware_basic_auth_enabled` and `matrix_prometheus_nginxlog_exporter_container_labels_metrics_middleware_basic_auth_users`)."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,12 +26,7 @@ msgid "Enabling metrics and graphs for Postgres (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md:3
|
||||
msgid ""
|
||||
"Expanding on the metrics exposed by the [synapse exporter and the node "
|
||||
"exporter](configuring-playbook-prometheus-grafana.md), the playbook "
|
||||
"enables the [postgres exporter](https://github.com/prometheus-"
|
||||
"community/postgres_exporter) that exposes more detailed information about"
|
||||
" what's happening on your postgres database."
|
||||
msgid "Expanding on the metrics exposed by the [synapse exporter and the node exporter](configuring-playbook-prometheus-grafana.md), the playbook enables the [postgres exporter](https://github.com/prometheus-community/postgres_exporter) that exposes more detailed information about what's happening on your postgres database."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md:5
|
||||
@ -39,9 +34,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md:7
|
||||
msgid ""
|
||||
"To enable the postgres exporter, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable the postgres exporter, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md:13
|
||||
@ -49,25 +42,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md:15
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md:22
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md:24
|
||||
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."
|
||||
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-prometheus-postgres.md:26
|
||||
@ -87,11 +70,7 @@ msgid "`prometheus_postgres_exporter_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md
|
||||
msgid ""
|
||||
"Enable the postgres prometheus exporter. This sets up the docker "
|
||||
"container, connects it to the database and adds a 'job' to the prometheus"
|
||||
" config which tells prometheus about this new exporter. The default is "
|
||||
"'false'"
|
||||
msgid "Enable the postgres prometheus exporter. This sets up the docker container, connects it to the database and adds a 'job' to the prometheus config which tells prometheus about this new exporter. The default is 'false'"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md
|
||||
@ -99,9 +78,7 @@ msgid "`prometheus_postgres_exporter_database_username`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md
|
||||
msgid ""
|
||||
"The 'username' for the user that the exporter uses to connect to the "
|
||||
"database. The default is 'matrix_prometheus_postgres_exporter'"
|
||||
msgid "The 'username' for the user that the exporter uses to connect to the database. The default is 'matrix_prometheus_postgres_exporter'"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md
|
||||
@ -109,9 +86,7 @@ msgid "`prometheus_postgres_exporter_database_password`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md
|
||||
msgid ""
|
||||
"The 'password' for the user that the exporter uses to connect to the "
|
||||
"database. By default, this is auto-generated by the playbook"
|
||||
msgid "The 'password' for the user that the exporter uses to connect to the database. By default, this is auto-generated by the playbook"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md
|
||||
@ -119,13 +94,7 @@ msgid "`prometheus_postgres_exporter_container_labels_traefik_enabled`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md
|
||||
msgid ""
|
||||
"If set to `true`, exposes the Postgres exporter metrics on "
|
||||
"`https://matrix.example.com/metrics/postgres-exporter` for usage with an "
|
||||
"[external Prometheus server](configuring-playbook-prometheus-grafana.md"
|
||||
"#collecting-metrics-to-an-external-prometheus-server). To password-"
|
||||
"protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` "
|
||||
"on that other documentation page."
|
||||
msgid "If set to `true`, exposes the Postgres exporter metrics on `https://matrix.example.com/metrics/postgres-exporter` for usage with an [external Prometheus server](configuring-playbook-prometheus-grafana.md#collecting-metrics-to-an-external-prometheus-server). To password-protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` on that other documentation page."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md:35
|
||||
@ -133,8 +102,5 @@ msgid "More information"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-prometheus-postgres.md:37
|
||||
msgid ""
|
||||
"[The PostgresSQL dashboard](https://grafana.com/grafana/dashboards/9628) "
|
||||
"(generic postgres dashboard)"
|
||||
msgid "[The PostgresSQL dashboard](https://grafana.com/grafana/dashboards/9628) (generic postgres dashboard)"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,15 +26,11 @@ msgid "Setting up the rageshake bug report server (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [rageshake](https://github.com"
|
||||
"/matrix-org/rageshake) bug report server for you."
|
||||
msgid "The playbook can install and configure the [rageshake](https://github.com/matrix-org/rageshake) bug report server for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:5
|
||||
msgid ""
|
||||
"This is useful if you're developing your own applications and would like "
|
||||
"to collect bug reports for them."
|
||||
msgid "This is useful if you're developing your own applications and would like to collect bug reports for them."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:7
|
||||
@ -42,23 +38,15 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:9
|
||||
msgid ""
|
||||
"To enable rageshake, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable rageshake, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:15
|
||||
msgid ""
|
||||
"rageshake has various options which don't have dedicated Ansible "
|
||||
"variables. You can see the full list of options in the "
|
||||
"[`rageshake.sample.yaml` file](https://github.com/matrix-"
|
||||
"org/rageshake/blob/master/rageshake.sample.yaml)."
|
||||
msgid "rageshake has various options which don't have dedicated Ansible variables. You can see the full list of options in the [`rageshake.sample.yaml` file](https://github.com/matrix-org/rageshake/blob/master/rageshake.sample.yaml)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:17
|
||||
msgid ""
|
||||
"To set these, you can make use of the "
|
||||
"`matrix_rageshake_configuration_extension_yaml` variable like this:"
|
||||
msgid "To set these, you can make use of the `matrix_rageshake_configuration_extension_yaml` variable like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:27
|
||||
@ -66,23 +54,15 @@ msgid "Adjusting the rageshake URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:29
|
||||
msgid ""
|
||||
"By default, this playbook installs rageshake on the `rageshake.` "
|
||||
"subdomain (`rageshake.example.com`) and requires you to [adjust your DNS "
|
||||
"records](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs rageshake on the `rageshake.` subdomain (`rageshake.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:31
|
||||
msgid ""
|
||||
"By tweaking the `matrix_rageshake_hostname` and "
|
||||
"`matrix_rageshake_path_prefix` variables, you can easily make the service"
|
||||
" available at a **different hostname and/or path** than the default one."
|
||||
msgid "By tweaking the `matrix_rageshake_hostname` and `matrix_rageshake_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-rageshake.md:33
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:44
|
||||
@ -90,21 +70,15 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:46
|
||||
msgid ""
|
||||
"Once you've decided on the domain and path, **you may need to adjust your"
|
||||
" DNS** records to point the rageshake domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the rageshake domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:48
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `rageshake`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `rageshake`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:50
|
||||
msgid ""
|
||||
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
|
||||
" extra DNS configuration."
|
||||
msgid "If you've decided to reuse the `matrix.` domain, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:52
|
||||
@ -112,26 +86,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:54
|
||||
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:"
|
||||
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-rageshake.md:61
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:63
|
||||
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."
|
||||
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-rageshake.md:65
|
||||
@ -139,8 +102,5 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rageshake.md:67
|
||||
msgid ""
|
||||
"Refer to the [rageshake documentation](https://github.com/matrix-"
|
||||
"org/rageshake) for available APIs, etc."
|
||||
msgid "Refer to the [rageshake documentation](https://github.com/matrix-org/rageshake) for available APIs, etc."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -18,23 +18,15 @@ msgstr ""
|
||||
"Generated-By: Babel 2.16.0\n"
|
||||
|
||||
#: ../../../docs/configuring-playbook-rest-auth.md:1
|
||||
msgid ""
|
||||
"Setting up the REST authentication password provider module (optional, "
|
||||
"advanced)"
|
||||
msgid "Setting up the REST authentication password provider module (optional, advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rest-auth.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-synapse-rest-"
|
||||
"auth](https://github.com/ma1uta/matrix-synapse-rest-password-provider) "
|
||||
"for you."
|
||||
msgid "The playbook can install and configure [matrix-synapse-rest-auth](https://github.com/ma1uta/matrix-synapse-rest-password-provider) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rest-auth.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -42,10 +34,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rest-auth.md:9
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
|
||||
"needs):"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rest-auth.md:19
|
||||
@ -53,10 +42,7 @@ msgid "Authenticating only using a password provider"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rest-auth.md:21
|
||||
msgid ""
|
||||
"If you wish for users to **authenticate only against configured password "
|
||||
"providers** (like this one), **without consulting Synapse's local "
|
||||
"database**, feel free to disable it:"
|
||||
msgid "If you wish for users to **authenticate only against configured password providers** (like this one), **without consulting Synapse's local database**, feel free to disable it:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rest-auth.md:27
|
||||
@ -64,30 +50,13 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rest-auth.md:29
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rest-auth.md:36
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-rest-auth.md:38
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "See that project's documentation to "
|
||||
#~ "learn what it does and why it "
|
||||
#~ "might be useful to you."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@ -26,29 +26,19 @@ msgid "Configuring Riot-web (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:3
|
||||
msgid ""
|
||||
"By default, this playbook **used to install** the [Riot-"
|
||||
"web](https://github.com/element-hq/riot-web) Matrix client web "
|
||||
"application."
|
||||
msgid "By default, this playbook **used to install** the [Riot-web](https://github.com/element-hq/riot-web) Matrix client web application."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:5
|
||||
msgid ""
|
||||
"Riot has since been [renamed to Element](https://element.io/blog/welcome-"
|
||||
"to-element/)."
|
||||
msgid "Riot has since been [renamed to Element](https://element.io/blog/welcome-to-element/)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:7
|
||||
msgid ""
|
||||
"to learn more about Element Web and its configuration, see our dedicated "
|
||||
"[Configuring Element Web](configuring-playbook-client-element-web.md) "
|
||||
"documentation page"
|
||||
msgid "to learn more about Element Web and its configuration, see our dedicated [Configuring Element Web](configuring-playbook-client-element-web.md) documentation page"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:8
|
||||
msgid ""
|
||||
"to learn how to migrate from Riot to Element Web, see [Migrating to "
|
||||
"Element Web](#migrating-to-element-web) below"
|
||||
msgid "to learn how to migrate from Riot to Element Web, see [Migrating to Element Web](#migrating-to-element-web) below"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:10
|
||||
@ -60,17 +50,11 @@ msgid "Migrating your custom settings"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:14
|
||||
msgid ""
|
||||
"If you have custom `matrix_riot_web_` variables in your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file, you'll need to "
|
||||
"rename them (`matrix_riot_web_` -> `matrix_client_element_`)."
|
||||
msgid "If you have custom `matrix_riot_web_` variables in your `inventory/host_vars/matrix.example.com/vars.yml` file, you'll need to rename them (`matrix_riot_web_` -> `matrix_client_element_`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:16
|
||||
msgid ""
|
||||
"Some other playbook variables (but not all) with `riot` in their name are"
|
||||
" also renamed. The playbook checks and warns if you are using the old "
|
||||
"name for some commonly used ones."
|
||||
msgid "Some other playbook variables (but not all) with `riot` in their name are also renamed. The playbook checks and warns if you are using the old name for some commonly used ones."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:18
|
||||
@ -78,9 +62,7 @@ msgid "Domain migration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:20
|
||||
msgid ""
|
||||
"We used to set up Riot at the `riot.example.com` domain. The playbook now"
|
||||
" sets up Element Web at `element.example.com` by default."
|
||||
msgid "We used to set up Riot at the `riot.example.com` domain. The playbook now sets up Element Web at `element.example.com` by default."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:22
|
||||
@ -88,18 +70,11 @@ msgid "There are a few options for handling this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:24
|
||||
msgid ""
|
||||
"(**avoiding changes** - using the old `riot.example.com` domain and "
|
||||
"avoiding DNS changes) -- to keep using `riot.example.com` instead of "
|
||||
"`element.example.com`, override the domain at which the playbook serves "
|
||||
"Element Web: `matrix_server_fqn_element: \"riot.{{ matrix_domain }}\"`"
|
||||
msgid "(**avoiding changes** - using the old `riot.example.com` domain and avoiding DNS changes) -- to keep using `riot.example.com` instead of `element.example.com`, override the domain at which the playbook serves Element Web: `matrix_server_fqn_element: \"riot.{{ matrix_domain }}\"`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:26
|
||||
msgid ""
|
||||
"(**embracing changes** - using only `element.example.com`) - set up the "
|
||||
"`element.example.com` DNS record (see [Configuring DNS](configuring-"
|
||||
"dns.md)). You can drop the `riot.example.com` in this case."
|
||||
msgid "(**embracing changes** - using only `element.example.com`) - set up the `element.example.com` DNS record (see [Configuring DNS](configuring-dns.md)). You can drop the `riot.example.com` in this case."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:28
|
||||
@ -107,24 +82,13 @@ msgid "Re-running the playbook"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:30
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:37
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-riot-web.md:39
|
||||
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."
|
||||
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 ""
|
||||
|
||||
|
||||
@ -26,31 +26,19 @@ msgid "Storing Matrix media files on Amazon S3 with Goofys (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:3
|
||||
msgid ""
|
||||
"If you'd like to store Synapse's content repository (`media_store`) files"
|
||||
" on Amazon S3 (or other S3-compatible service), you can let this playbook"
|
||||
" configure [Goofys](https://github.com/kahing/goofys) for you."
|
||||
msgid "If you'd like to store Synapse's content repository (`media_store`) files on Amazon S3 (or other S3-compatible service), you can let this playbook configure [Goofys](https://github.com/kahing/goofys) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:5
|
||||
msgid ""
|
||||
"Another (and better performing) way to use S3 storage with Synapse is "
|
||||
"[synapse-s3-storage-provider](configuring-playbook-synapse-s3-storage-"
|
||||
"provider.md)."
|
||||
msgid "Another (and better performing) way to use S3 storage with Synapse is [synapse-s3-storage-provider](configuring-playbook-synapse-s3-storage-provider.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:7
|
||||
msgid ""
|
||||
"Using a Goofys-backed media store works, but performance may not be "
|
||||
"ideal. If possible, try to use a region which is close to your Matrix "
|
||||
"server."
|
||||
msgid "Using a Goofys-backed media store works, but performance may not be ideal. If possible, try to use a region which is close to your Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:9
|
||||
msgid ""
|
||||
"If you'd like to move your locally-stored media store data to Amazon S3 "
|
||||
"(or another S3-compatible object store), we also provide some migration "
|
||||
"instructions below."
|
||||
msgid "If you'd like to move your locally-stored media store data to Amazon S3 (or another S3-compatible object store), we also provide some migration instructions below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:11
|
||||
@ -58,25 +46,15 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:13
|
||||
msgid ""
|
||||
"After [creating the S3 bucket and configuring it](configuring-"
|
||||
"playbook-s3.md#bucket-creation-and-security-configuration), add the "
|
||||
"following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
|
||||
"needs):"
|
||||
msgid "After [creating the S3 bucket and configuring it](configuring-playbook-s3.md#bucket-creation-and-security-configuration), add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your needs):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:23
|
||||
msgid ""
|
||||
"You can use any S3-compatible object store by **additionally** "
|
||||
"configuring these variables:"
|
||||
msgid "You can use any S3-compatible object store by **additionally** configuring these variables:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:30
|
||||
msgid ""
|
||||
"If you have local media store files and wish to migrate to Backblaze B2 "
|
||||
"subsequently, follow our [migration guide to Backblaze B2](#migrating-to-"
|
||||
"backblaze-b2) below instead of applying this configuration as-is."
|
||||
msgid "If you have local media store files and wish to migrate to Backblaze B2 subsequently, follow our [migration guide to Backblaze B2](#migrating-to-backblaze-b2) below instead of applying this configuration as-is."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:32
|
||||
@ -84,23 +62,15 @@ msgid "Migrating from local filesystem storage to S3"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:34
|
||||
msgid ""
|
||||
"It's a good idea to [make a complete server backup](faq.md#how-do-i-back-"
|
||||
"up-the-data-on-my-server) before migrating your local media store to an "
|
||||
"S3-backed one."
|
||||
msgid "It's a good idea to [make a complete server backup](faq.md#how-do-i-back-up-the-data-on-my-server) before migrating your local media store to an S3-backed one."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:36
|
||||
msgid ""
|
||||
"After making the backup, follow one of the guides below for a migration "
|
||||
"path from a locally-stored media store to one stored on S3-compatible "
|
||||
"storage:"
|
||||
msgid "After making the backup, follow one of the guides below for a migration path from a locally-stored media store to one stored on S3-compatible storage:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:38
|
||||
msgid ""
|
||||
"[Migrating to any S3-compatible storage (universal, but likely slow"
|
||||
")](#migrating-to-any-s3-compatible-storage-universal-but-likely-slow)"
|
||||
msgid "[Migrating to any S3-compatible storage (universal, but likely slow)](#migrating-to-any-s3-compatible-storage-universal-but-likely-slow)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:39
|
||||
@ -116,34 +86,23 @@ msgid "Proceed with the steps below without stopping Matrix services"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:45
|
||||
msgid ""
|
||||
"Start by adding the base S3 configuration in your `vars.yml` file (seen "
|
||||
"above, may be different depending on the S3 provider of your choice)"
|
||||
msgid "Start by adding the base S3 configuration in your `vars.yml` file (seen above, may be different depending on the S3 provider of your choice)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:47
|
||||
msgid ""
|
||||
"In addition to the base configuration you see above, add this to your "
|
||||
"`vars.yml` file:"
|
||||
msgid "In addition to the base configuration you see above, add this to your `vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:53
|
||||
msgid ""
|
||||
"This enables S3 support, but mounts the S3 storage bucket to `/matrix/s3"
|
||||
"-media-store` without hooking it to your homeserver yet. Your homeserver "
|
||||
"will still continue using your local filesystem for its media store."
|
||||
msgid "This enables S3 support, but mounts the S3 storage bucket to `/matrix/s3-media-store` without hooking it to your homeserver yet. Your homeserver will still continue using your local filesystem for its media store."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:55
|
||||
msgid ""
|
||||
"Run the playbook to apply the changes: `ansible-playbook -i "
|
||||
"inventory/hosts setup.yml --tags=setup-all,start`"
|
||||
msgid "Run the playbook to apply the changes: `ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:57
|
||||
msgid ""
|
||||
"Do an **initial sync of your files** by running this **on the server** "
|
||||
"(it may take a very long time):"
|
||||
msgid "Do an **initial sync of your files** by running this **on the server** (it may take a very long time):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:63
|
||||
@ -152,15 +111,11 @@ msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:65
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:106
|
||||
msgid ""
|
||||
"Stop all Matrix services (`ansible-playbook -i inventory/hosts setup.yml "
|
||||
"--tags=stop`)"
|
||||
msgid "Stop all Matrix services (`ansible-playbook -i inventory/hosts setup.yml --tags=stop`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:67
|
||||
msgid ""
|
||||
"Start the S3 service by running this **on the server**: `systemctl start "
|
||||
"matrix-goofys`"
|
||||
msgid "Start the S3 service by running this **on the server**: `systemctl start matrix-goofys`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:69
|
||||
@ -168,43 +123,31 @@ msgid "Sync the files again by re-running the `rsync` command you see in step #5
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:71
|
||||
msgid ""
|
||||
"Stop the S3 service by running this **on the server**: `systemctl stop "
|
||||
"matrix-goofys`"
|
||||
msgid "Stop the S3 service by running this **on the server**: `systemctl stop matrix-goofys`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:73
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:114
|
||||
msgid ""
|
||||
"Get the old media store out of the way by running this command on the "
|
||||
"server:"
|
||||
msgid "Get the old media store out of the way by running this command on the server:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:79
|
||||
msgid ""
|
||||
"Remove the `matrix_s3_media_store_path` configuration from your "
|
||||
"`vars.yml` file (undoing step #3 above)"
|
||||
msgid "Remove the `matrix_s3_media_store_path` configuration from your `vars.yml` file (undoing step #3 above)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:81
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:122
|
||||
msgid ""
|
||||
"Run the playbook: `ansible-playbook -i inventory/hosts setup.yml --tags"
|
||||
"=setup-all,start`"
|
||||
msgid "Run the playbook: `ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:83
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:124
|
||||
msgid ""
|
||||
"You're done! Verify that loading existing (old) media files works and "
|
||||
"that you can upload new ones."
|
||||
msgid "You're done! Verify that loading existing (old) media files works and that you can upload new ones."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:85
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:126
|
||||
msgid ""
|
||||
"When confident that it all works, get rid of the local media store "
|
||||
"directory: `rm -rf /matrix/synapse/storage/media-store-local-backup`"
|
||||
msgid "When confident that it all works, get rid of the local media store directory: `rm -rf /matrix/synapse/storage/media-store-local-backup`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:87
|
||||
@ -212,9 +155,7 @@ msgid "Migrating to Backblaze B2"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:89
|
||||
msgid ""
|
||||
"While all Matrix services are running, run the following command on the "
|
||||
"server:"
|
||||
msgid "While all Matrix services are running, run the following command on the server:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:91
|
||||
@ -230,20 +171,13 @@ msgid "Run the command from step #1 again."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:110
|
||||
msgid ""
|
||||
"Doing this will sync any new files that may have been created locally in "
|
||||
"the meantime."
|
||||
msgid "Doing this will sync any new files that may have been created locally in the meantime."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:112
|
||||
msgid ""
|
||||
"Now that Matrix services aren't running, we're sure to get Backblaze B2 "
|
||||
"and your local media store fully in sync."
|
||||
msgid "Now that Matrix services aren't running, we're sure to get Backblaze B2 and your local media store fully in sync."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3-goofys.md:120
|
||||
msgid ""
|
||||
"Put the [Backblaze B2 settings](configuring-playbook-s3.md#backblaze-b2) "
|
||||
"in your `vars.yml` file"
|
||||
msgid "Put the [Backblaze B2 settings](configuring-playbook-s3.md#backblaze-b2) in your `vars.yml` file"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -22,37 +22,23 @@ msgstr ""
|
||||
"Generated-By: Babel 2.16.0\n"
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:1
|
||||
msgid ""
|
||||
"Storing Synapse media files on Amazon S3 or another compatible Object "
|
||||
"Storage (optional)"
|
||||
msgid "Storing Synapse media files on Amazon S3 or another compatible Object Storage (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:3
|
||||
msgid ""
|
||||
"By default, this playbook configures your server to store Synapse's "
|
||||
"content repository (`media_store`) files on the local filesystem. If "
|
||||
"that's okay, you can skip this document."
|
||||
msgid "By default, this playbook configures your server to store Synapse's content repository (`media_store`) files on the local filesystem. If that's okay, you can skip this document."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:5
|
||||
msgid ""
|
||||
"As an alternative to storing media files on the local filesystem, you can"
|
||||
" store them on [Amazon S3](https://aws.amazon.com/s3/) or another "
|
||||
"S3-compatible object store."
|
||||
msgid "As an alternative to storing media files on the local filesystem, you can store them on [Amazon S3](https://aws.amazon.com/s3/) or another S3-compatible object store."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:7
|
||||
msgid ""
|
||||
"You can do this either by sticking to Synapse's media repository and "
|
||||
"making that use S3 (read below for this method), or by switching to an "
|
||||
"external media storage implementation like [matrix-media-repo"
|
||||
"](configuring-playbook-matrix-media-repo.md)."
|
||||
msgid "You can do this either by sticking to Synapse's media repository and making that use S3 (read below for this method), or by switching to an external media storage implementation like [matrix-media-repo](configuring-playbook-matrix-media-repo.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:9
|
||||
msgid ""
|
||||
"First, [choose an Object Storage provider](#choosing-an-object-storage-"
|
||||
"provider)."
|
||||
msgid "First, [choose an Object Storage provider](#choosing-an-object-storage-provider)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:11
|
||||
@ -60,12 +46,7 @@ msgid "Then, [create the S3 bucket](#bucket-creation-and-security-configuration)
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:13
|
||||
msgid ""
|
||||
"Finally, [set up S3 storage for Synapse](#setting-up) (with [Goofys"
|
||||
"](configuring-playbook-s3-goofys.md), [synapse-s3-storage-provider"
|
||||
"](configuring-playbook-synapse-s3-storage-provider.md), or use s3 "
|
||||
"datastore with the [matrix-media-repo](https://docs.t2bot.io/matrix-"
|
||||
"media-repo/configuration/s3-datastore.html))."
|
||||
msgid "Finally, [set up S3 storage for Synapse](#setting-up) (with [Goofys](configuring-playbook-s3-goofys.md), [synapse-s3-storage-provider](configuring-playbook-synapse-s3-storage-provider.md), or use s3 datastore with the [matrix-media-repo](https://docs.t2bot.io/matrix-media-repo/configuration/s3-datastore.html))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:15
|
||||
@ -73,35 +54,19 @@ msgid "Choosing an Object Storage provider"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:17
|
||||
msgid ""
|
||||
"You can create [Amazon S3](https://aws.amazon.com/s3/) or another "
|
||||
"S3-compatible object storage like [Backblaze "
|
||||
"B2](https://www.backblaze.com/b2/cloud-storage.html), "
|
||||
"[Storj](https://storj.io), [Wasabi](https://wasabi.com), [Digital Ocean "
|
||||
"Spaces](https://www.digitalocean.com/products/spaces), etc."
|
||||
msgid "You can create [Amazon S3](https://aws.amazon.com/s3/) or another S3-compatible object storage like [Backblaze B2](https://www.backblaze.com/b2/cloud-storage.html), [Storj](https://storj.io), [Wasabi](https://wasabi.com), [Digital Ocean Spaces](https://www.digitalocean.com/products/spaces), etc."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:19
|
||||
msgid ""
|
||||
"Amazon S3, Backblaze B2, and Storj are pay-as-you with no minimum charges"
|
||||
" for storing too little data."
|
||||
msgid "Amazon S3, Backblaze B2, and Storj are pay-as-you with no minimum charges for storing too little data."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:21
|
||||
msgid ""
|
||||
"All these providers have different prices, with Storj appearing to be the"
|
||||
" cheapest (as of 2024-10, storage fee is $0.004 per GB/month, and egress "
|
||||
"fee is $0.007 per GB). Backblaze egress is free, but for only certain "
|
||||
"users for up to 3x the amount of data stored. Beyond that you will pay "
|
||||
"$0.01/GB of egress."
|
||||
msgid "All these providers have different prices, with Storj appearing to be the cheapest (as of 2024-10, storage fee is $0.004 per GB/month, and egress fee is $0.007 per GB). Backblaze egress is free, but for only certain users for up to 3x the amount of data stored. Beyond that you will pay $0.01/GB of egress."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:23
|
||||
msgid ""
|
||||
"Wasabi has a minimum charge of 1TB if you're storing less than 1TB, which"
|
||||
" becomes expensive if you need to store less data than that. Likewise, "
|
||||
"Digital Ocean Spaces has also a minimum charge of 250GB ($5/month as of "
|
||||
"2022-10)."
|
||||
msgid "Wasabi has a minimum charge of 1TB if you're storing less than 1TB, which becomes expensive if you need to store less data than that. Likewise, Digital Ocean Spaces has also a minimum charge of 250GB ($5/month as of 2022-10)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:25
|
||||
@ -109,9 +74,7 @@ msgid "Here are some of the important aspects of choosing the right provider:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:27
|
||||
msgid ""
|
||||
"if a provider is a company you like and trust (or dislike less than the "
|
||||
"others)"
|
||||
msgid "if a provider is a company you like and trust (or dislike less than the others)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:28
|
||||
@ -119,28 +82,19 @@ msgid "if a provider implements end-to-end encryption of your data"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:29
|
||||
msgid ""
|
||||
"if a provider has a data region close to your Matrix server (if it's "
|
||||
"farther away, high latency may cause slowdowns)"
|
||||
msgid "if a provider has a data region close to your Matrix server (if it's farther away, high latency may cause slowdowns)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:30
|
||||
msgid ""
|
||||
"if a provider's infrastructure such as data center is centralized or "
|
||||
"distributed"
|
||||
msgid "if a provider's infrastructure such as data center is centralized or distributed"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:31
|
||||
msgid ""
|
||||
"if a provider's price model is transparent (whether it includes hidden "
|
||||
"costs like minimum charge, minimum storage term, etc.)"
|
||||
msgid "if a provider's price model is transparent (whether it includes hidden costs like minimum charge, minimum storage term, etc.)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:32
|
||||
msgid ""
|
||||
"if a provider has free or cheap egress fee (in case you need to get the "
|
||||
"data out often, for some reason) - likely not too important for the "
|
||||
"common use-case"
|
||||
msgid "if a provider has free or cheap egress fee (in case you need to get the data out often, for some reason) - likely not too important for the common use-case"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:34
|
||||
@ -148,24 +102,15 @@ msgid "Bucket creation and Security Configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:36
|
||||
msgid ""
|
||||
"Now that you've [chosen an Object Storage provider](#choosing-an-object-"
|
||||
"storage-provider), you need to create a storage bucket."
|
||||
msgid "Now that you've [chosen an Object Storage provider](#choosing-an-object-storage-provider), you need to create a storage bucket."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:38
|
||||
msgid ""
|
||||
"How you do this varies from provider to provider, with Amazon S3 being "
|
||||
"the most complicated due to its vast number of services and complicated "
|
||||
"security policies."
|
||||
msgid "How you do this varies from provider to provider, with Amazon S3 being the most complicated due to its vast number of services and complicated security policies."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:40
|
||||
msgid ""
|
||||
"Below, we provider some guides for common providers. If you don't see "
|
||||
"yours, look at the others for inspiration or read some guides online "
|
||||
"about how to create a bucket. Feel free to contribute to this "
|
||||
"documentation with an update!"
|
||||
msgid "Below, we provider some guides for common providers. If you don't see yours, look at the others for inspiration or read some guides online about how to create a bucket. Feel free to contribute to this documentation with an update!"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:42
|
||||
@ -173,16 +118,11 @@ msgid "Amazon S3"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:44
|
||||
msgid ""
|
||||
"You'll need an Amazon S3 bucket and some IAM user credentials (access key"
|
||||
" + secret key) with full write access to the bucket. Example IAM security"
|
||||
" policy:"
|
||||
msgid "You'll need an Amazon S3 bucket and some IAM user credentials (access key + secret key) with full write access to the bucket. Example IAM security policy:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:65
|
||||
msgid ""
|
||||
"**Note**: This policy needs to be attached to an IAM user created from "
|
||||
"the **Security Credentials** menu. This is not a **Bucket Policy**."
|
||||
msgid "**Note**: This policy needs to be attached to an IAM user created from the **Security Credentials** menu. This is not a **Bucket Policy**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:67
|
||||
@ -190,19 +130,11 @@ msgid "Backblaze B2"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:69
|
||||
msgid ""
|
||||
"To use [Backblaze B2](https://www.backblaze.com/b2/cloud-storage.html) "
|
||||
"you first need to sign up."
|
||||
msgid "To use [Backblaze B2](https://www.backblaze.com/b2/cloud-storage.html) you first need to sign up."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:71
|
||||
msgid ""
|
||||
"You [can't easily change which region (US, Europe) your Backblaze account"
|
||||
" stores files "
|
||||
"in](https://old.reddit.com/r/backblaze/comments/hi1v90/make_the_choice_for_the_b2_data_center_region/),"
|
||||
" so make sure to carefully choose the region when signing up (hint: it's "
|
||||
"a hard to see dropdown below the username/password fields in the signup "
|
||||
"form)."
|
||||
msgid "You [can't easily change which region (US, Europe) your Backblaze account stores files in](https://old.reddit.com/r/backblaze/comments/hi1v90/make_the_choice_for_the_b2_data_center_region/), so make sure to carefully choose the region when signing up (hint: it's a hard to see dropdown below the username/password fields in the signup form)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:73
|
||||
@ -210,15 +142,11 @@ msgid "After logging in to Backblaze:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:75
|
||||
msgid ""
|
||||
"create a new **private** bucket through its user interface (you can call "
|
||||
"it something like `matrix-example-media-store`)"
|
||||
msgid "create a new **private** bucket through its user interface (you can call it something like `matrix-example-media-store`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:76
|
||||
msgid ""
|
||||
"note the **Endpoint** for your bucket (something like `s3.us-"
|
||||
"west-002.backblazeb2.com`)."
|
||||
msgid "note the **Endpoint** for your bucket (something like `s3.us-west-002.backblazeb2.com`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:77
|
||||
@ -226,15 +154,11 @@ msgid "adjust its Lifecycle Rules to: Keep only the last version of the file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:78
|
||||
msgid ""
|
||||
"go to [App Keys](https://secure.backblaze.com/app_keys.htm) and use the "
|
||||
"**Add a New Application Key** to create a new one"
|
||||
msgid "go to [App Keys](https://secure.backblaze.com/app_keys.htm) and use the **Add a New Application Key** to create a new one"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:79
|
||||
msgid ""
|
||||
"restrict it to the previously created bucket (e.g. `matrix-example-media-"
|
||||
"store`)"
|
||||
msgid "restrict it to the previously created bucket (e.g. `matrix-example-media-store`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:80
|
||||
@ -242,22 +166,15 @@ msgid "give it *Read & Write* access"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:82
|
||||
msgid ""
|
||||
"The `keyID` value is your **Access Key** and `applicationKey` is your "
|
||||
"**Secret Key**."
|
||||
msgid "The `keyID` value is your **Access Key** and `applicationKey` is your **Secret Key**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:84
|
||||
msgid ""
|
||||
"For configuring [Goofys](configuring-playbook-s3-goofys.md) or [s3"
|
||||
"-synapse-storage-provider](configuring-playbook-synapse-s3-storage-"
|
||||
"provider.md) you will need:"
|
||||
msgid "For configuring [Goofys](configuring-playbook-s3-goofys.md) or [s3-synapse-storage-provider](configuring-playbook-synapse-s3-storage-provider.md) you will need:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:86
|
||||
msgid ""
|
||||
"**Endpoint URL** - this is the **Endpoint** value you saw above, but "
|
||||
"prefixed with `https://`"
|
||||
msgid "**Endpoint URL** - this is the **Endpoint** value you saw above, but prefixed with `https://`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:88
|
||||
@ -265,9 +182,7 @@ msgid "**Region** - use the value you see in the Endpoint (e.g. `us-west-002`)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:90
|
||||
msgid ""
|
||||
"**Storage Class** - use `STANDARD`. Backblaze B2 does not have different "
|
||||
"storage classes, so it doesn't make sense to use any other value."
|
||||
msgid "**Storage Class** - use `STANDARD`. Backblaze B2 does not have different storage classes, so it doesn't make sense to use any other value."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:92
|
||||
@ -275,16 +190,11 @@ msgid "Other providers"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:94
|
||||
msgid ""
|
||||
"For other S3-compatible providers, you may not need to configure security"
|
||||
" policies, etc. (just like for [Backblaze B2](#backblaze-b2))."
|
||||
msgid "For other S3-compatible providers, you may not need to configure security policies, etc. (just like for [Backblaze B2](#backblaze-b2))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:96
|
||||
msgid ""
|
||||
"You most likely just need to create an S3 bucket and get some credentials"
|
||||
" (access key and secret key) for accessing the bucket in a read/write "
|
||||
"manner."
|
||||
msgid "You most likely just need to create an S3 bucket and get some credentials (access key and secret key) for accessing the bucket in a read/write manner."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:98
|
||||
@ -292,24 +202,17 @@ msgid "Setting up"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:100
|
||||
msgid ""
|
||||
"To set up Synapse to store files in S3, follow the instructions for the "
|
||||
"method of your choice:"
|
||||
msgid "To set up Synapse to store files in S3, follow the instructions for the method of your choice:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:102
|
||||
msgid ""
|
||||
"using [synapse-s3-storage-provider](configuring-playbook-synapse-s3"
|
||||
"-storage-provider.md) (recommended)"
|
||||
msgid "using [synapse-s3-storage-provider](configuring-playbook-synapse-s3-storage-provider.md) (recommended)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:103
|
||||
msgid ""
|
||||
"using [Goofys to mount the S3 store to the local filesystem](configuring-"
|
||||
"playbook-s3-goofys.md)"
|
||||
msgid "using [Goofys to mount the S3 store to the local filesystem](configuring-playbook-s3-goofys.md)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-s3.md:104
|
||||
msgid "using [matrix-media-repo](configuring-playbook-matrix-media-repo.md)"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -22,23 +22,15 @@ msgstr ""
|
||||
"Generated-By: Babel 2.16.0\n"
|
||||
|
||||
#: ../../../docs/configuring-playbook-shared-secret-auth.md:1
|
||||
msgid ""
|
||||
"Setting up the Shared Secret Auth password provider module (optional, "
|
||||
"advanced)"
|
||||
msgid "Setting up the Shared Secret Auth password provider module (optional, advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-shared-secret-auth.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [matrix-synapse-shared-secret-"
|
||||
"auth](https://github.com/devture/matrix-synapse-shared-secret-auth) for "
|
||||
"you."
|
||||
msgid "The playbook can install and configure [matrix-synapse-shared-secret-auth](https://github.com/devture/matrix-synapse-shared-secret-auth) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-shared-secret-auth.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
@ -46,9 +38,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-shared-secret-auth.md:9
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-shared-secret-auth.md:18
|
||||
@ -56,10 +46,7 @@ msgid "Authenticating only using a password provider"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-shared-secret-auth.md:20
|
||||
msgid ""
|
||||
"If you wish for users to **authenticate only against configured password "
|
||||
"providers** (like this one), **without consulting Synapse's local "
|
||||
"database**, feel free to disable it:"
|
||||
msgid "If you wish for users to **authenticate only against configured password providers** (like this one), **without consulting Synapse's local database**, feel free to disable it:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-shared-secret-auth.md:26
|
||||
@ -67,30 +54,13 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-shared-secret-auth.md:28
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-shared-secret-auth.md:35
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-shared-secret-auth.md:37
|
||||
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."
|
||||
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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "See that project's documentation to "
|
||||
#~ "learn what it does and why it "
|
||||
#~ "might be useful to you."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@ -26,30 +26,15 @@ msgid "Setting up the Sliding Sync proxy (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:3
|
||||
msgid ""
|
||||
"**Note**: The sliding-sync proxy is **not required** anymore as it's been"
|
||||
" replaced with a different method (called Simplified Sliding Sync) which "
|
||||
"is integrated into newer homeservers by default (**Conduit** homeserver "
|
||||
"from version `0.6.0` or **Synapse** from version `1.114`). This component"
|
||||
" and documentation remain here for historical purposes, but **installing "
|
||||
"this old sliding-sync proxy is generally not recommended anymore**."
|
||||
msgid "**Note**: The sliding-sync proxy is **not required** anymore as it's been replaced with a different method (called Simplified Sliding Sync) which is integrated into newer homeservers by default (**Conduit** homeserver from version `0.6.0` or **Synapse** from version `1.114`). This component and documentation remain here for historical purposes, but **installing this old sliding-sync proxy is generally not recommended anymore**."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:5
|
||||
msgid ""
|
||||
"The playbook can install and configure [sliding-sync](https://github.com"
|
||||
"/matrix-org/sliding-sync) proxy for you."
|
||||
msgid "The playbook can install and configure [sliding-sync](https://github.com/matrix-org/sliding-sync) proxy for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:7
|
||||
msgid ""
|
||||
"Sliding Sync is an implementation of [MSC3575](https://github.com/matrix-"
|
||||
"org/matrix-spec-proposals/blob/kegan/sync-v3/proposals/3575-sync.md) and "
|
||||
"a prerequisite for running Element X clients ([Element X "
|
||||
"iOS](https://github.com/element-hq/element-x-ios) and [Element X "
|
||||
"Android](https://github.com/element-hq/element-x-android)). See the "
|
||||
"project's [documentation](https://github.com/matrix-org/sliding-sync) to "
|
||||
"learn more."
|
||||
msgid "Sliding Sync is an implementation of [MSC3575](https://github.com/matrix-org/matrix-spec-proposals/blob/kegan/sync-v3/proposals/3575-sync.md) and a prerequisite for running Element X clients ([Element X iOS](https://github.com/element-hq/element-x-ios) and [Element X Android](https://github.com/element-hq/element-x-android)). See the project's [documentation](https://github.com/matrix-org/sliding-sync) to learn more."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:9
|
||||
@ -57,9 +42,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:11
|
||||
msgid ""
|
||||
"To enable Sliding Sync proxy, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Sliding Sync proxy, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:17
|
||||
@ -67,26 +50,15 @@ msgid "Adjusting the Sliding Sync proxy URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:19
|
||||
msgid ""
|
||||
"By default, this playbook installs the Sliding Sync proxy on the "
|
||||
"`matrix.` subdomain, at the `/sliding-sync` path "
|
||||
"(https://matrix.example.com/sliding-sync). This makes it easy to install "
|
||||
"it, because it **doesn't require additional DNS records to be set up**. "
|
||||
"If that's okay, you can skip this section."
|
||||
msgid "By default, this playbook installs the Sliding Sync proxy on the `matrix.` subdomain, at the `/sliding-sync` path (https://matrix.example.com/sliding-sync). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:21
|
||||
msgid ""
|
||||
"By tweaking the `matrix_sliding_sync_hostname` and "
|
||||
"`matrix_sliding_sync_path_prefix` variables, you can easily make the "
|
||||
"service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_sliding_sync_hostname` and `matrix_sliding_sync_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-sliding-sync-proxy.md:23
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:31
|
||||
@ -94,9 +66,7 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:33
|
||||
msgid ""
|
||||
"If you've changed the default hostname, **you may need to adjust your "
|
||||
"DNS** records to point the Honoroit domain to the Matrix server."
|
||||
msgid "If you've changed the default hostname, **you may need to adjust your DNS** records to point the Honoroit domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:35
|
||||
@ -104,9 +74,7 @@ msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:37
|
||||
msgid ""
|
||||
"If you've decided to use the default hostname, you won't need to do any "
|
||||
"extra DNS configuration."
|
||||
msgid "If you've decided to use the default hostname, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:39
|
||||
@ -114,26 +82,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:41
|
||||
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:"
|
||||
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-sliding-sync-proxy.md:48
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:50
|
||||
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."
|
||||
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-sliding-sync-proxy.md:52
|
||||
@ -141,10 +98,7 @@ msgid "External databases"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:54
|
||||
msgid ""
|
||||
"Please note that, if your setup utilizes an external database, you must "
|
||||
"also establish configuration for the sliding sync proxy. Alter the "
|
||||
"defaults below to suit your configuration:"
|
||||
msgid "Please note that, if your setup utilizes an external database, you must also establish configuration for the sliding sync proxy. Alter the defaults below to suit your configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:64
|
||||
@ -152,24 +106,13 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:66
|
||||
msgid ""
|
||||
"You **don't need to do anything special** to make use of the Sliding Sync"
|
||||
" proxy. Simply open your client which supports Sliding Sync (like Element"
|
||||
" X) and log in."
|
||||
msgid "You **don't need to do anything special** to make use of the Sliding Sync proxy. Simply open your client which supports Sliding Sync (like Element X) and log in."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:68
|
||||
msgid ""
|
||||
"When the Sliding Sync proxy is [installed](#installing), your `/.well-"
|
||||
"known/matrix/client` file is also updated. A new "
|
||||
"`org.matrix.msc3575.proxy` section and `url` property are added there and"
|
||||
" made to point to your Sliding Sync proxy's base URL (e.g. "
|
||||
"`https://matrix.example.com/sliding-sync`)."
|
||||
msgid "When the Sliding Sync proxy is [installed](#installing), your `/.well-known/matrix/client` file is also updated. A new `org.matrix.msc3575.proxy` section and `url` property are added there and made to point to your Sliding Sync proxy's base URL (e.g. `https://matrix.example.com/sliding-sync`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sliding-sync-proxy.md:70
|
||||
msgid ""
|
||||
"This allows clients which support Sliding Sync to detect the Sliding Sync"
|
||||
" proxy's URL and make use of it."
|
||||
msgid "This allows clients which support Sliding Sync to detect the Sliding Sync proxy's URL and make use of it."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,17 +26,11 @@ msgid "Adjusting SSL certificate retrieval (optional, advanced)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:3
|
||||
msgid ""
|
||||
"By default, this playbook retrieves and auto-renews free SSL certificates"
|
||||
" from [Let's Encrypt](https://letsencrypt.org/) for the domains it needs "
|
||||
"(e.g. `matrix.example.com` and others)"
|
||||
msgid "By default, this playbook retrieves and auto-renews free SSL certificates from [Let's Encrypt](https://letsencrypt.org/) for the domains it needs (e.g. `matrix.example.com` and others)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:5
|
||||
msgid ""
|
||||
"This guide is about using the integrated Traefik server and doesn't apply"
|
||||
" if you're using [your own webserver](configuring-playbook-own-"
|
||||
"webserver.md)."
|
||||
msgid "This guide is about using the integrated Traefik server and doesn't apply if you're using [your own webserver](configuring-playbook-own-webserver.md)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:7
|
||||
@ -44,16 +38,12 @@ msgid "Using staging Let's Encrypt certificates instead of real ones"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:9
|
||||
msgid ""
|
||||
"For testing purposes, you may wish to use staging certificates provide by"
|
||||
" Let's Encrypt."
|
||||
msgid "For testing purposes, you may wish to use staging certificates provide by Let's Encrypt."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:11
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:21
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:17
|
||||
@ -61,10 +51,7 @@ msgid "Disabling SSL termination"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:19
|
||||
msgid ""
|
||||
"For testing or other purposes, you may wish to install services without "
|
||||
"SSL termination and have services exposed to `http://` instead of "
|
||||
"`https://`."
|
||||
msgid "For testing or other purposes, you may wish to install services without SSL termination and have services exposed to `http://` instead of `https://`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:27
|
||||
@ -72,11 +59,7 @@ msgid "Using self-signed SSL certificates"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:29
|
||||
msgid ""
|
||||
"If you'd like to use your own SSL certificates, instead of the default "
|
||||
"(SSL certificates obtained automatically via "
|
||||
"[ACME](https://en.wikipedia.org/wiki/Automatic_Certificate_Management_Environment)"
|
||||
" from [Let's Encrypt](https://letsencrypt.org/)):"
|
||||
msgid "If you'd like to use your own SSL certificates, instead of the default (SSL certificates obtained automatically via [ACME](https://en.wikipedia.org/wiki/Automatic_Certificate_Management_Environment) from [Let's Encrypt](https://letsencrypt.org/)):"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:31
|
||||
@ -84,9 +67,7 @@ msgid "generate your self-signed certificate files"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:32
|
||||
msgid ""
|
||||
"follow the [Using your own SSL certificates](#using-your-own-ssl-"
|
||||
"certificates) documentation below"
|
||||
msgid "follow the [Using your own SSL certificates](#using-your-own-ssl-certificates) documentation below"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:34
|
||||
@ -98,30 +79,19 @@ msgid "To use your own SSL certificates with Traefik, you need to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:38
|
||||
msgid ""
|
||||
"disable "
|
||||
"[ACME](https://en.wikipedia.org/wiki/Automatic_Certificate_Management_Environment)"
|
||||
" / [Let's Encrypt](https://letsencrypt.org/) support"
|
||||
msgid "disable [ACME](https://en.wikipedia.org/wiki/Automatic_Certificate_Management_Environment) / [Let's Encrypt](https://letsencrypt.org/) support"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:39
|
||||
msgid ""
|
||||
"put a custom Traefik configuration file on the server, with the help of "
|
||||
"this Ansible playbook (via the [`aux` role](https://github.com/mother-of-"
|
||||
"all-self-hosting/ansible-role-aux)) or manually"
|
||||
msgid "put a custom Traefik configuration file on the server, with the help of this Ansible playbook (via the [`aux` role](https://github.com/mother-of-all-self-hosting/ansible-role-aux)) or manually"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:40
|
||||
msgid ""
|
||||
"register your custom configuration file with Traefik, by adding an extra "
|
||||
"provider of type [file](https://doc.traefik.io/traefik/providers/file/)"
|
||||
msgid "register your custom configuration file with Traefik, by adding an extra provider of type [file](https://doc.traefik.io/traefik/providers/file/)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:41
|
||||
msgid ""
|
||||
"put the SSL files on the server, with the help of this Ansible playbook "
|
||||
"(via the [`aux` role](https://github.com/mother-of-all-self-hosting"
|
||||
"/ansible-role-aux)) or manually"
|
||||
msgid "put the SSL files on the server, with the help of this Ansible playbook (via the [`aux` role](https://github.com/mother-of-all-self-hosting/ansible-role-aux)) or manually"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:89
|
||||
@ -129,12 +99,7 @@ msgid "Using a DNS-01 ACME challenge type, instead of HTTP-01"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:91
|
||||
msgid ""
|
||||
"You can configure Traefik to use the [DNS-01 challenge "
|
||||
"type](https://letsencrypt.org/docs/challenge-types/#dns-01-challenge) for"
|
||||
" Let's Encrypt. This is less commonly used than the default [HTTP-01 "
|
||||
"challenge type](https://letsencrypt.org/docs/challenge-"
|
||||
"types/#http-01-challenge), but it can be helpful to:"
|
||||
msgid "You can configure Traefik to use the [DNS-01 challenge type](https://letsencrypt.org/docs/challenge-types/#dns-01-challenge) for Let's Encrypt. This is less commonly used than the default [HTTP-01 challenge type](https://letsencrypt.org/docs/challenge-types/#http-01-challenge), but it can be helpful to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:93
|
||||
@ -142,33 +107,17 @@ msgid "hide your public IP from Let's Encrypt logs"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:94
|
||||
msgid ""
|
||||
"allow you to obtain SSL certificates for servers which are not accessible"
|
||||
" (via HTTP) from the public internet (and for which the HTTP-01 challenge"
|
||||
" would fail)"
|
||||
msgid "allow you to obtain SSL certificates for servers which are not accessible (via HTTP) from the public internet (and for which the HTTP-01 challenge would fail)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:96
|
||||
msgid ""
|
||||
"This is an example for how to edit the `vars.yml` file if you're using "
|
||||
"Cloudflare:"
|
||||
msgid "This is an example for how to edit the `vars.yml` file if you're using Cloudflare:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:111
|
||||
msgid ""
|
||||
"Make sure to change the value of \"provider\" to your particular DNS "
|
||||
"solution, and provide the appropriate environment variables. The full "
|
||||
"list of supported providers is available "
|
||||
"[here](https://doc.traefik.io/traefik/https/acme/#providers)."
|
||||
msgid "Make sure to change the value of \"provider\" to your particular DNS solution, and provide the appropriate environment variables. The full list of supported providers is available [here](https://doc.traefik.io/traefik/https/acme/#providers)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-ssl-certificates.md:113
|
||||
msgid ""
|
||||
"This example assumes you're using Cloudflare to manage your DNS zone. "
|
||||
"Note that it requires the use of two tokens: one for reading all zones "
|
||||
"(`CF_ZONE_API_TOKEN`) and another that must be able to edit the "
|
||||
"particular domain you're using (`CF_DNS_API_TOKEN`). For security, it's "
|
||||
"recommended that you create two fine-grained tokens for this purpose, but"
|
||||
" you might choose to use the same token for both."
|
||||
msgid "This example assumes you're using Cloudflare to manage your DNS zone. Note that it requires the use of two tokens: one for reading all zones (`CF_ZONE_API_TOKEN`) and another that must be able to edit the particular domain you're using (`CF_DNS_API_TOKEN`). For security, it's recommended that you create two fine-grained tokens for this purpose, but you might choose to use the same token for both."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,36 +26,23 @@ msgid "Setting up the Sygnal push gateway (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure the [Sygnal](https://github.com"
|
||||
"/matrix-org/sygnal) push gateway for you."
|
||||
msgid "The playbook can install and configure the [Sygnal](https://github.com/matrix-org/sygnal) push gateway for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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
|
||||
msgid ""
|
||||
"**Note**: most people don't need to install their own gateway. As "
|
||||
"Sygnal's [Notes for application developers](https://github.com/matrix-"
|
||||
"org/sygnal/blob/master/docs/applications.md) documentation says:"
|
||||
msgid "**Note**: most people don't need to install their own gateway. As Sygnal's [Notes for application developers](https://github.com/matrix-org/sygnal/blob/master/docs/applications.md) documentation says:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:9
|
||||
msgid ""
|
||||
"It is not feasible to allow end-users to configure their own Sygnal "
|
||||
"instance, because the Sygnal instance needs the appropriate FCM or APNs "
|
||||
"secrets that belong to the application."
|
||||
msgid "It is not feasible to allow end-users to configure their own Sygnal instance, because the Sygnal instance needs the appropriate FCM or APNs secrets that belong to the application."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:11
|
||||
msgid ""
|
||||
"This optional playbook component is only useful to people who "
|
||||
"develop/build their own Matrix client applications themselves."
|
||||
msgid "This optional playbook component is only useful to people who develop/build their own Matrix client applications themselves."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:13
|
||||
@ -63,50 +50,27 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:15
|
||||
msgid ""
|
||||
"To enable Sygnal, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Sygnal, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:43
|
||||
msgid ""
|
||||
"For a more complete example of available fields and values they can take,"
|
||||
" see `roles/custom/matrix-sygnal/templates/sygnal.yaml.j2` (or the "
|
||||
"[upstream `sygnal.yaml.sample` configuration file](https://github.com"
|
||||
"/matrix-org/sygnal/blob/master/sygnal.yaml.sample))."
|
||||
msgid "For a more complete example of available fields and values they can take, see `roles/custom/matrix-sygnal/templates/sygnal.yaml.j2` (or the [upstream `sygnal.yaml.sample` configuration file](https://github.com/matrix-org/sygnal/blob/master/sygnal.yaml.sample))."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:45
|
||||
msgid ""
|
||||
"Configuring [GCM/FCM](https://firebase.google.com/docs/cloud-messaging/) "
|
||||
"is easier, as it only requires that you provide some config values."
|
||||
msgid "Configuring [GCM/FCM](https://firebase.google.com/docs/cloud-messaging/) is easier, as it only requires that you provide some config values."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:47
|
||||
msgid ""
|
||||
"To configure [APNS](https://developer.apple.com/notifications/) (Apple "
|
||||
"Push Notification Service), you'd need to provide one or more certificate"
|
||||
" files. To do that, the above example configuration:"
|
||||
msgid "To configure [APNS](https://developer.apple.com/notifications/) (Apple Push Notification Service), you'd need to provide one or more certificate files. To do that, the above example configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:49
|
||||
msgid ""
|
||||
"makes use of the [`aux` role](https://github.com/mother-of-all-self-"
|
||||
"hosting/ansible-role-aux) (and its `aux_file_definitions` variable) to "
|
||||
"make the playbook install files into `/matrix/sygnal/data` (the "
|
||||
"`matrix_sygnal_data_path` variable). See [`defaults/main.yml` "
|
||||
"file](https://github.com/mother-of-all-self-hosting/ansible-role-"
|
||||
"aux/blob/main/defaults/main.yml) of the `aux` role for usage examples. It"
|
||||
" also makes sure the files are owned by `matrix:matrix`, so that Sygnal "
|
||||
"can read them. Of course, you can also install these files manually "
|
||||
"yourself, if you'd rather not use `aux`."
|
||||
msgid "makes use of the [`aux` role](https://github.com/mother-of-all-self-hosting/ansible-role-aux) (and its `aux_file_definitions` variable) to make the playbook install files into `/matrix/sygnal/data` (the `matrix_sygnal_data_path` variable). See [`defaults/main.yml` file](https://github.com/mother-of-all-self-hosting/ansible-role-aux/blob/main/defaults/main.yml) of the `aux` role for usage examples. It also makes sure the files are owned by `matrix:matrix`, so that Sygnal can read them. Of course, you can also install these files manually yourself, if you'd rather not use `aux`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:51
|
||||
msgid ""
|
||||
"references these files in the Sygnal configuration (`matrix_sygnal_apps`)"
|
||||
" using a path like `/data/..` (the `/matrix/sygnal/data` directory on the"
|
||||
" host system is mounted into the `/data` directory inside the container)"
|
||||
msgid "references these files in the Sygnal configuration (`matrix_sygnal_apps`) using a path like `/data/..` (the `/matrix/sygnal/data` directory on the host system is mounted into the `/data` directory inside the container)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:53
|
||||
@ -114,23 +78,15 @@ msgid "Adjusting the Sygnal URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:55
|
||||
msgid ""
|
||||
"By default, this playbook installs Sygnal on the `sygnal.` subdomain "
|
||||
"(`sygnal.example.com`) and requires you to [adjust your DNS records"
|
||||
"](#adjusting-dns-records)."
|
||||
msgid "By default, this playbook installs Sygnal on the `sygnal.` subdomain (`sygnal.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:57
|
||||
msgid ""
|
||||
"By tweaking the `matrix_sygnal_hostname` and `matrix_sygnal_path_prefix` "
|
||||
"variables, you can easily make the service available at a **different "
|
||||
"hostname and/or path** than the default one."
|
||||
msgid "By tweaking the `matrix_sygnal_hostname` and `matrix_sygnal_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-sygnal.md:59
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:70
|
||||
@ -138,21 +94,15 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:72
|
||||
msgid ""
|
||||
"Once you've decided on the domain and path, **you may need to adjust your"
|
||||
" DNS** records to point the Sygnal domain to the Matrix server."
|
||||
msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Sygnal domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:74
|
||||
msgid ""
|
||||
"By default, you will need to create a CNAME record for `sygnal`. See "
|
||||
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgid "By default, you will need to create a CNAME record for `sygnal`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:76
|
||||
msgid ""
|
||||
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
|
||||
" extra DNS configuration."
|
||||
msgid "If you've decided to reuse the `matrix.` domain, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:78
|
||||
@ -160,26 +110,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:80
|
||||
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:"
|
||||
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-sygnal.md:87
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:89
|
||||
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."
|
||||
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-sygnal.md:91
|
||||
@ -187,24 +126,9 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:93
|
||||
msgid ""
|
||||
"To make use of your Sygnal installation, you'd need to build your own "
|
||||
"Matrix client application, which uses the same API keys (for "
|
||||
"[GCM/FCM](https://firebase.google.com/docs/cloud-messaging/)) and "
|
||||
"certificates (for [APNS](https://developer.apple.com/notifications/)) and"
|
||||
" is to your Sygnal URL endpoint (e.g. `https://sygnal.example.com`)."
|
||||
msgid "To make use of your Sygnal installation, you'd need to build your own Matrix client application, which uses the same API keys (for [GCM/FCM](https://firebase.google.com/docs/cloud-messaging/)) and certificates (for [APNS](https://developer.apple.com/notifications/)) and is to your Sygnal URL endpoint (e.g. `https://sygnal.example.com`)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-sygnal.md:95
|
||||
msgid ""
|
||||
"Refer to Sygnal's [Notes for application developers](https://github.com"
|
||||
"/matrix-org/sygnal/blob/master/docs/applications.md) document."
|
||||
msgid "Refer to Sygnal's [Notes for application developers](https://github.com/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 ""
|
||||
|
||||
|
||||
@ -26,33 +26,15 @@ msgid "Setting up Synapse Admin (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [etkecc/synapse-"
|
||||
"admin](https://github.com/etkecc/synapse-admin) (a [feature-"
|
||||
"rich](https://github.com/etkecc/synapse-admin#fork-differences) fork of "
|
||||
"[Awesome-Technologies/synapse-admin](https://github.com/Awesome-"
|
||||
"Technologies/synapse-admin), community room: [#synapse-"
|
||||
"admin:etke.cc](https://matrix.to/#/#synapse-admin:etke.cc)) for you."
|
||||
msgid "The playbook can install and configure [etkecc/synapse-admin](https://github.com/etkecc/synapse-admin) (a [feature-rich](https://github.com/etkecc/synapse-admin#fork-differences) fork of [Awesome-Technologies/synapse-admin](https://github.com/Awesome-Technologies/synapse-admin), community room: [#synapse-admin:etke.cc](https://matrix.to/#/#synapse-admin:etke.cc)) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:5
|
||||
msgid ""
|
||||
"synapse-admin is a web UI tool you can use to **administrate users, "
|
||||
"rooms, media, etc. on your Matrix server**. It's designed to work with "
|
||||
"the Synapse homeserver implementation and WON'T work with Dendrite "
|
||||
"because [Dendrite Admin API](https://matrix-"
|
||||
"org.github.io/dendrite/administration/adminapi) differs from [Synapse "
|
||||
"Admin API](https://element-"
|
||||
"hq.github.io/synapse/latest/usage/administration/admin_api/)."
|
||||
msgid "synapse-admin is a web UI tool you can use to **administrate users, rooms, media, etc. on your Matrix server**. It's designed to work with the Synapse homeserver implementation and WON'T work with Dendrite because [Dendrite Admin API](https://matrix-org.github.io/dendrite/administration/adminapi) differs from [Synapse Admin API](https://element-hq.github.io/synapse/latest/usage/administration/admin_api/)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:7
|
||||
msgid ""
|
||||
"💡 **Note**: the latest version of synapse-admin is hosted by "
|
||||
"[etke.cc](https://etke.cc/) at [admin.etke.cc](https://admin.etke.cc/). "
|
||||
"If you only need this service occasionally and trust giving your admin "
|
||||
"credentials to a 3rd party Single Page Application, you can consider "
|
||||
"using it from there and avoiding the (small) overhead of self-hosting."
|
||||
msgid "💡 **Note**: the latest version of synapse-admin is hosted by [etke.cc](https://etke.cc/) at [admin.etke.cc](https://admin.etke.cc/). If you only need this service occasionally and trust giving your admin credentials to a 3rd party Single Page Application, you can consider using it from there and avoiding the (small) overhead of self-hosting."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:9
|
||||
@ -60,59 +42,27 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:11
|
||||
msgid ""
|
||||
"To enable Synapse Admin, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "To enable Synapse Admin, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:17
|
||||
msgid ""
|
||||
"**Note**: Synapse Admin requires Synapse's [Admin APIs](https://element-"
|
||||
"hq.github.io/synapse/latest/usage/administration/admin_api/index.html) to"
|
||||
" function. Access to them is restricted with a valid access token, so "
|
||||
"exposing them publicly should not be a real security concern. Still, for "
|
||||
"additional security, we normally leave them unexposed, following "
|
||||
"[official Synapse reverse-proxying recommendations](https://element-"
|
||||
"hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-"
|
||||
"endpoints). Because Synapse Admin needs these APIs to function, when "
|
||||
"installing Synapse Admin, the playbook **automatically** exposes the "
|
||||
"Synapse Admin API publicly for you. Depending on the homeserver "
|
||||
"implementation you're using (Synapse, Dendrite), this is equivalent to:"
|
||||
msgid "**Note**: Synapse Admin requires Synapse's [Admin APIs](https://element-hq.github.io/synapse/latest/usage/administration/admin_api/index.html) to function. Access to them is restricted with a valid access token, so exposing them publicly should not be a real security concern. Still, for additional security, we normally leave them unexposed, following [official Synapse reverse-proxying recommendations](https://element-hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-endpoints). Because Synapse Admin needs these APIs to function, when installing Synapse Admin, the playbook **automatically** exposes the Synapse Admin API publicly for you. Depending on the homeserver implementation you're using (Synapse, Dendrite), this is equivalent to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:19
|
||||
msgid ""
|
||||
"for [Synapse](./configuring-playbook-synapse.md) (our default homeserver "
|
||||
"implementation): "
|
||||
"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
|
||||
" true`"
|
||||
msgid "for [Synapse](./configuring-playbook-synapse.md) (our default homeserver implementation): `matrix_synapse_container_labels_public_client_synapse_admin_api_enabled: true`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:20
|
||||
msgid ""
|
||||
"for [Dendrite](./configuring-playbook-dendrite.md): "
|
||||
"`matrix_dendrite_container_labels_public_client_synapse_admin_api_enabled:"
|
||||
" true`"
|
||||
msgid "for [Dendrite](./configuring-playbook-dendrite.md): `matrix_dendrite_container_labels_public_client_synapse_admin_api_enabled: true`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:22
|
||||
msgid ""
|
||||
"By default, synapse-admin installation will be [restricted to only work "
|
||||
"with one homeserver](https://github.com/etkecc/synapse-"
|
||||
"admin/blob/e21e44362c879ac41f47c580b04210842b6ff3d7/README.md"
|
||||
"#restricting-available-homeserver) - the one managed by the playbook. To "
|
||||
"adjust these restrictions, tweak the "
|
||||
"`matrix_synapse_admin_config_restrictBaseUrl` variable."
|
||||
msgid "By default, synapse-admin installation will be [restricted to only work with one homeserver](https://github.com/etkecc/synapse-admin/blob/e21e44362c879ac41f47c580b04210842b6ff3d7/README.md#restricting-available-homeserver) - the one managed by the playbook. To adjust these restrictions, tweak the `matrix_synapse_admin_config_restrictBaseUrl` variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:24
|
||||
msgid ""
|
||||
"⚠️ **Warning**: If you're using [Matrix Authentication Service"
|
||||
"](./configuring-playbook-matrix-authentication-service.md) (MAS) for "
|
||||
"authentication, you will be able to [log into synapse-admin with an "
|
||||
"access token](https://github.com/etkecc/synapse-admin/pull/58), but "
|
||||
"certain synapse-admin features (especially those around user management) "
|
||||
"will be limited or not work at all."
|
||||
msgid "⚠️ **Warning**: If you're using [Matrix Authentication Service](./configuring-playbook-matrix-authentication-service.md) (MAS) for authentication, you will be able to [log into synapse-admin with an access token](https://github.com/etkecc/synapse-admin/pull/58), but certain synapse-admin features (especially those around user management) will be limited or not work at all."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:26
|
||||
@ -120,26 +70,15 @@ msgid "Adjusting the Synapse Admin URL"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:28
|
||||
msgid ""
|
||||
"By default, this playbook installs Synapse Admin on the `matrix.` "
|
||||
"subdomain, at the `/synapse-admin` path (https://matrix.example.com"
|
||||
"/synapse-admin). This makes it easy to install it, because it **doesn't "
|
||||
"require additional DNS records to be set up**. If that's okay, you can "
|
||||
"skip this section."
|
||||
msgid "By default, this playbook installs Synapse Admin on the `matrix.` subdomain, at the `/synapse-admin` path (https://matrix.example.com/synapse-admin). This makes it easy to install it, because it **doesn't require additional DNS records to be set up**. If that's okay, you can skip this section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:30
|
||||
msgid ""
|
||||
"By tweaking the `matrix_synapse_admin_hostname` and "
|
||||
"`matrix_synapse_admin_path_prefix` variables, you can easily make the "
|
||||
"service available at a **different hostname and/or path** than the "
|
||||
"default one."
|
||||
msgid "By tweaking the `matrix_synapse_admin_hostname` and `matrix_synapse_admin_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-synapse-admin.md:32
|
||||
msgid ""
|
||||
"Example additional configuration for your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:40
|
||||
@ -147,9 +86,7 @@ msgid "Adjusting DNS records"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:42
|
||||
msgid ""
|
||||
"If you've changed the default hostname, **you may need to adjust your "
|
||||
"DNS** records to point the Synapse Admin domain to the Matrix server."
|
||||
msgid "If you've changed the default hostname, **you may need to adjust your DNS** records to point the Synapse Admin domain to the Matrix server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:44
|
||||
@ -157,9 +94,7 @@ msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:46
|
||||
msgid ""
|
||||
"If you've decided to use the default hostname, you won't need to do any "
|
||||
"extra DNS configuration."
|
||||
msgid "If you've decided to use the default hostname, you won't need to do any extra DNS configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:48
|
||||
@ -167,26 +102,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:50
|
||||
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:"
|
||||
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-synapse-admin.md:57
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:59
|
||||
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."
|
||||
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-synapse-admin.md:61
|
||||
@ -194,14 +118,9 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:63
|
||||
msgid ""
|
||||
"After installation, Synapse Admin will be accessible at: "
|
||||
"`https://matrix.example.com/synapse-admin/`"
|
||||
msgid "After installation, Synapse Admin will be accessible at: `https://matrix.example.com/synapse-admin/`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-admin.md:65
|
||||
msgid ""
|
||||
"To use Synapse Admin, you need to have [registered at least one "
|
||||
"administrator account](registering-users.md) on your server."
|
||||
msgid "To use Synapse Admin, you need to have [registered at least one administrator account](registering-users.md) on your server."
|
||||
msgstr ""
|
||||
|
||||
|
||||
@ -26,35 +26,19 @@ msgid "Setting up Synapse Auto Invite Accept (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure [synapse-auto-invite-"
|
||||
"accept](https://github.com/matrix-org/synapse-auto-accept-invite) for "
|
||||
"you."
|
||||
msgid "The playbook can install and configure [synapse-auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-invite) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:5
|
||||
msgid ""
|
||||
"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."
|
||||
msgid "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."
|
||||
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 "
|
||||
"(see the [Native alternative](#native-alternative) section below). You'd "
|
||||
"better use the native feature, instead of the [synapse-auto-invite-"
|
||||
"accept](https://github.com/matrix-org/synapse-auto-accept-invite) 3rd "
|
||||
"party module."
|
||||
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 (see the [Native alternative](#native-alternative) section below). You'd better use the native feature, instead of the [synapse-auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-invite) 3rd party module."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:11
|
||||
@ -62,11 +46,7 @@ msgid "Configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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-"
|
||||
"invite module for you, add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
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-invite module for you, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:21
|
||||
@ -74,19 +54,11 @@ msgid "Synapse worker deployments"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:23
|
||||
msgid ""
|
||||
"In a [workerized Synapse deployment](https://github.com/spantaleev"
|
||||
"/matrix-docker-ansible-"
|
||||
"deploy/blob/c9a842147e09647c355799ca024d65a5de66b099/docs/configuring-"
|
||||
"playbook-synapse.md#load-balancing-with-workers) it is possible to run "
|
||||
"this module on a worker to reduce the load on the main process (Default "
|
||||
"is `null`). For example, add this to your configuration:"
|
||||
msgid "In a [workerized Synapse deployment](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/c9a842147e09647c355799ca024d65a5de66b099/docs/configuring-playbook-synapse.md#load-balancing-with-workers) it is possible to run this module on a worker to reduce the load on the main process (Default is `null`). For example, add this to your configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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)."
|
||||
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:31
|
||||
@ -94,27 +66,9 @@ msgid "Native alternative"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 "
|
||||
"[synapse-auto-invite-accept](https://github.com/matrix-org/synapse-auto-"
|
||||
"accept-invite) 3rd party module [has been made](https://github.com"
|
||||
"/element-hq/synapse/pull/17147) part of Synapse."
|
||||
msgid "Since Synapse [v1.109.0](https://github.com/element-hq/synapse/releases/tag/v1.109.0), the functionality provided by the [synapse-auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-invite) 3rd party module [has been made](https://github.com/element-hq/synapse/pull/17147) part of Synapse."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../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 ""
|
||||
|
||||
|
||||
@ -26,24 +26,15 @@ msgid "Setting up synapse-auto-compressor (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:3
|
||||
msgid ""
|
||||
"The playbook can install and configure "
|
||||
"[synapse_auto_compressor](https://github.com/matrix-org/rust-synapse-"
|
||||
"compress-state/#automated-tool-synapse_auto_compressor) for you."
|
||||
msgid "The playbook can install and configure [synapse_auto_compressor](https://github.com/matrix-org/rust-synapse-compress-state/#automated-tool-synapse_auto_compressor) for you."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:5
|
||||
msgid ""
|
||||
"It's a CLI tool that automatically compresses Synapse's `state_groups` "
|
||||
"database table in the background."
|
||||
msgid "It's a CLI tool that automatically compresses Synapse's `state_groups` database table in the background."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:7
|
||||
msgid ""
|
||||
"See the project's [documentation](https://github.com/matrix-org/rust-"
|
||||
"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."
|
||||
msgid "See the project's [documentation](https://github.com/matrix-org/rust-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
|
||||
@ -51,9 +42,7 @@ msgid "Adjusting the playbook configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:11
|
||||
msgid ""
|
||||
"Add the following configuration to your "
|
||||
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:17
|
||||
@ -61,25 +50,15 @@ msgid "Installing"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:19
|
||||
msgid ""
|
||||
"After configuring the playbook, run it with [playbook tags](playbook-"
|
||||
"tags.md) as below:"
|
||||
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:26
|
||||
msgid ""
|
||||
"The shortcut commands with the [`just` program](just.md) are also "
|
||||
"available: `just install-all` or `just setup-all`"
|
||||
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:28
|
||||
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."
|
||||
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-synapse-auto-compressor.md:30
|
||||
@ -87,10 +66,7 @@ msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:32
|
||||
msgid ""
|
||||
"After installation, `synapse_auto_compressor` will run automatically "
|
||||
"every day at `00:00:00` (as defined in "
|
||||
"`matrix_synapse_auto_compressor_calendar` by default)."
|
||||
msgid "After installation, `synapse_auto_compressor` will run automatically every day at `00:00:00` (as defined in `matrix_synapse_auto_compressor_calendar` by default)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:34
|
||||
@ -98,21 +74,5 @@ msgid "Manually start the tool"
|
||||
msgstr ""
|
||||
|
||||
#: ../../../docs/configuring-playbook-synapse-auto-compressor.md:36
|
||||
msgid ""
|
||||
"For testing your setup it can be helpful to not wait until 00:00. If you "
|
||||
"want to run the tool immediately, log onto the server and run `systemctl "
|
||||
"start matrix-synapse-auto-compressor`. Running this command will not "
|
||||
"return control to your terminal until the compression run is done, which "
|
||||
"may take a long time. Consider using "
|
||||
"[tmux](https://en.wikipedia.org/wiki/Tmux) if your SSH connection is "
|
||||
"unstable."
|
||||
msgid "For testing your setup it can be helpful to not wait until 00:00. If you want to run the tool immediately, log onto the server and run `systemctl start matrix-synapse-auto-compressor`. Running this command will not return control to your terminal until the compression run is done, which may take a long time. Consider using [tmux](https://en.wikipedia.org/wiki/Tmux) if your SSH connection is 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 ""
|
||||
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user