mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-31 21:37:14 +01:00
d4f8d0918a
Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
486 lines
16 KiB
Plaintext
486 lines
16 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
|
|
# members
|
|
# This file is distributed under the same license as the
|
|
# matrix-docker-ansible-deploy package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2024-12-16 12:05+0900\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language: bg\n"
|
|
"Language-Team: bg <LL@li.org>\n"
|
|
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=utf-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Generated-By: Babel 2.16.0\n"
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:1
|
|
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."
|
|
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."
|
|
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 in detail 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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:11
|
|
msgid "Setup Instructions"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:13
|
|
msgid ""
|
|
"Refer to the [official instructions](https://matrix-org.github.io/matrix-"
|
|
"hookshot/latest/setup.html) to learn what the individual options do."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:15
|
|
msgid ""
|
|
"Enable the bridge by adding `matrix_hookshot_enabled: true` to your "
|
|
"`vars.yml` file"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:16
|
|
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 ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:17
|
|
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 ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:18
|
|
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 ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:19
|
|
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 ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:21
|
|
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 ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:23
|
|
msgid "Finally, run the playbook (see [installing](installing.md))."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:25
|
|
msgid "End-to-bridge encryption"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:27
|
|
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 ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:29
|
|
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 ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:31
|
|
msgid "Usage"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:33
|
|
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:35
|
|
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:37
|
|
msgid "Send a `!hookshot help` message to see a list of help commands."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:39
|
|
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:41
|
|
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 ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:43
|
|
msgid "More setup documentation"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:45
|
|
msgid "URLs for bridges setup"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:47
|
|
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
|
|
msgid "listener"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "default path"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "variable"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "used as"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "-"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`/hookshot/webhooks/`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`matrix_hookshot_webhook_endpoint`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "Webhook-prefix, which affects all webhook-related URLs below"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "generic"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`/hookshot/webhooks/webhook`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`matrix_hookshot_generic_endpoint`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "Generic webhooks"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "github oauth"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`/hookshot/webhooks/oauth`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`matrix_hookshot_github_oauth_endpoint`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "GitHub \"Callback URL\""
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "jira oauth"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`/hookshot/webhooks/jira/oauth`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`matrix_hookshot_jira_oauth_endpoint`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "JIRA OAuth"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "figma endpoint"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`/hookshot/webhooks/figma/webhook`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`matrix_hookshot_figma_endpoint`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "Figma"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "provisioning"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`/hookshot/v1/`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`matrix_hookshot_provisioning_endpoint`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "Dimension [provisioning](#provisioning-api)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "appservice"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`/hookshot/_matrix/app/`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`matrix_hookshot_appservice_endpoint`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "Matrix server"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "widgets"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`/hookshot/widgetapi/`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "`matrix_hookshot_widgets_endpoint`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "Widgets"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "metrics"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md
|
|
msgid "Prometheus"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:61
|
|
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:63
|
|
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:65
|
|
msgid "Manage GitHub Private Key with aux role"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:67
|
|
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:68
|
|
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:69
|
|
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:70
|
|
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:72
|
|
msgid ""
|
|
"To use the `aux` role, make sure the `matrix_hookshot_github_private_key`"
|
|
" variable is empty. Then add the following additional configuration:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:83
|
|
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:85
|
|
msgid "Provisioning API"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:87
|
|
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:89
|
|
msgid "Metrics"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:91
|
|
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:93
|
|
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:95
|
|
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:97
|
|
msgid ""
|
|
"either enabling metrics exposure for Hookshot via "
|
|
"`matrix_hookshot_metrics_proxying_enabled: true`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:98
|
|
msgid ""
|
|
"or enabling metrics exposure for all services via "
|
|
"`matrix_metrics_exposure_enabled: true`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:100
|
|
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:102
|
|
msgid "Collision with matrix-appservice-webhooks"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-hookshot.md:104
|
|
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 ""
|
|
|