mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-23 13:05:47 +00: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
326 lines
11 KiB
Plaintext
326 lines
11 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
|
|
# members
|
|
# This file is distributed under the same license as the
|
|
# matrix-docker-ansible-deploy package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2024-12-16 12:05+0900\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language: jp\n"
|
|
"Language-Team: jp <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=utf-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Generated-By: Babel 2.16.0\n"
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:1
|
|
msgid "Setting up Appservice Slack bridging (optional)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:3
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:75
|
|
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."
|
|
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\"."
|
|
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."
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:11
|
|
msgid "Prerequisites"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:13
|
|
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)."
|
|
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."
|
|
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`."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:21
|
|
msgid "Add the following events as `Bot User Events` and save:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:23
|
|
msgid "team_domain_change"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:24
|
|
msgid "message.channels"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:25
|
|
msgid "message.groups (if you want to bridge private channels)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:26
|
|
msgid "reaction_added"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:27
|
|
msgid "reaction_removed"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:29
|
|
msgid "Next, click on \"OAuth & Permissions\" and add the following scopes:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:31
|
|
msgid "chat:write:bot"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:32
|
|
msgid "users:read"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:33
|
|
msgid "reactions:write"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:34
|
|
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."
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:40
|
|
msgid "Create an administration control room on Matrix"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:42
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:46
|
|
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:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:64
|
|
msgid ""
|
|
"Other configuration options are available via the "
|
|
"`matrix_appservice_slack_configuration_extension_yaml` variable."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:66
|
|
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:"
|
|
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."
|
|
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`"
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:83
|
|
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."
|
|
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:"
|
|
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`."
|
|
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."
|
|
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/`."
|
|
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:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:94
|
|
msgid "with file bridging:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:100
|
|
msgid "without file bridging:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:106
|
|
msgid "These arguments can be shortened to single-letter forms:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:112
|
|
msgid "Unlinking"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:114
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:122
|
|
msgid "Troubleshooting"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:124
|
|
msgid "As always, check the logs: `journalctl -fu matrix-appservice-slack`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:126
|
|
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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:130
|
|
msgid "Messages work from Matrix to Slack, but not the other way around"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:132
|
|
msgid "Check you logs, if they say something like"
|
|
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>`"
|
|
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."
|
|
msgstr ""
|
|
|