overmind
/
matrix-docker-ansible-deploy
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Code Issues 0 Releases 0 Wiki Activity
Matrix Docker Ansible eploy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8814 Commits
13 Branches
36 MiB
 
 
Tree: d4f8d0918a
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'd4f8d0918a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge...

327 lines
11 KiB
Raw Blame History 

  1. # SOME DESCRIPTIVE TITLE.

  2. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community

  3. # members

  4. # This file is distributed under the same license as the

  5. # matrix-docker-ansible-deploy package.

  6. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.

  7. #

  8. #, fuzzy

  9. msgid ""

  10. msgstr ""

  11. "Project-Id-Version: matrix-docker-ansible-deploy \n"

  12. "Report-Msgid-Bugs-To: \n"

  13. "POT-Creation-Date: 2024-12-16 12:05+0900\n"

  14. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"

  15. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"

  16. "Language: bg\n"

  17. "Language-Team: bg <LL@li.org>\n"

  18. "Plural-Forms: nplurals=2; plural=(n != 1);\n"

  19. "MIME-Version: 1.0\n"

  20. "Content-Type: text/plain; charset=utf-8\n"

  21. "Content-Transfer-Encoding: 8bit\n"

  22. "Generated-By: Babel 2.16.0\n"

  23. 

  24. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:1

  25. msgid "Setting up Appservice Slack bridging (optional)"

  26. msgstr ""

  27. 

  28. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:3

  29. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:75

  30. msgid "**Notes**:"

  31. msgstr ""

  32. 

  33. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:4

  34. msgid ""

  35. "Bridging to [Slack](https://slack.com) can also happen via the [mx-"

  36. "puppet-slack](configuring-playbook-bridge-mx-puppet-slack.md) and "

  37. "[mautrix-slack](configuring-playbook-bridge-mautrix-slack.md) bridges "

  38. "supported by the playbook."

  39. msgstr ""

  40. 

  41. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:5

  42. msgid ""

  43. "Currently (as of November, 2024) **this component is not available for "

  44. "new installation unless you have already created a classic Slack "

  45. "application** (which the bridge makes use of in order to enable bridging "

  46. "between Slack and Matrix), because the creation of classic Slack "

  47. "applications has been discontinued since June 4 2024. The author of the "

  48. "bridge claims [here](https://github.com/matrix-org/matrix-appservice-"

  49. "slack/issues/789#issuecomment-2172947787) that he plans to support the "

  50. "modern Slack application and until then \"the best (and only) option for "

  51. "new installations is to use the webhook bridging\"."

  52. msgstr ""

  53. 

  54. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:7

  55. msgid ""

  56. "The playbook can install and configure [matrix-appservice-"

  57. "slack](https://github.com/matrix-org/matrix-appservice-slack) for you."

  58. msgstr ""

  59. 

  60. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:9

  61. msgid ""

  62. "See the project's [documentation](https://github.com/matrix-org/matrix-"

  63. "appservice-slack/blob/master/README.md) to learn what it does and why it "

  64. "might be useful to you."

  65. msgstr ""

  66. 

  67. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:11

  68. msgid "Prerequisites"

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:13

  72. msgid "Create a Classic Slack App"

  73. msgstr ""

  74. 

  75. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:15

  76. msgid ""

  77. "First, you need to create a Classic Slack App "

  78. "[here](https://api.slack.com/apps?new_classic_app=1)."

  79. msgstr ""

  80. 

  81. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:17

  82. msgid ""

  83. "Name the app \"matrixbot\" (or anything else you'll remember). Select the"

  84. " team/workspace this app will belong to. Click on bot users and add a new"

  85. " bot user. We will use this account to bridge the the rooms."

  86. msgstr ""

  87. 

  88. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:19

  89. msgid ""

  90. "Then, click on Event Subscriptions and enable them and use the request "

  91. "url: `https://matrix.example.com/appservice-slack`."

  92. msgstr ""

  93. 

  94. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:21

  95. msgid "Add the following events as `Bot User Events` and save:"

  96. msgstr ""

  97. 

  98. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:23

  99. msgid "team_domain_change"

  100. msgstr ""

  101. 

  102. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:24

  103. msgid "message.channels"

  104. msgstr ""

  105. 

  106. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:25

  107. msgid "message.groups (if you want to bridge private channels)"

  108. msgstr ""

  109. 

  110. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:26

  111. msgid "reaction_added"

  112. msgstr ""

  113. 

  114. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:27

  115. msgid "reaction_removed"

  116. msgstr ""

  117. 

  118. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:29

  119. msgid "Next, click on \"OAuth & Permissions\" and add the following scopes:"

  120. msgstr ""

  121. 

  122. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:31

  123. msgid "chat:write:bot"

  124. msgstr ""

  125. 

  126. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:32

  127. msgid "users:read"

  128. msgstr ""

  129. 

  130. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:33

  131. msgid "reactions:write"

  132. msgstr ""

  133. 

  134. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:34

  135. msgid "files:write:user (if you want to bridge files)"

  136. msgstr ""

  137. 

  138. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:36

  139. msgid ""

  140. "**Note**: In order to make Slack files visible to Matrix users, this "

  141. "bridge will make Slack files visible to anyone with the url (including "

  142. "files in private channels). This is different than the current behavior "

  143. "in Slack, which only allows authenticated access to media posted in "

  144. "private channels. See MSC701 for details."

  145. msgstr ""

  146. 

  147. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:38

  148. msgid ""

  149. "Click on \"Install App\" and \"Install App to Workspace\". Note the "

  150. "access tokens shown. You will need the Bot User OAuth Access Token and if"

  151. " you want to bridge files, the OAuth Access Token whenever you link a "

  152. "room."

  153. msgstr ""

  154. 

  155. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:40

  156. msgid "Create an administration control room on Matrix"

  157. msgstr ""

  158. 

  159. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:42

  160. msgid "Create a new Matrix room to act as the administration control room."

  161. msgstr ""

  162. 

  163. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:44

  164. msgid ""

  165. "Note its internal room ID. This can be done in Element Web by sending a "

  166. "message, opening the options for that message and choosing \"view "

  167. "source\". The room ID will be displayed near the top."

  168. msgstr ""

  169. 

  170. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:46

  171. msgid "Adjusting the playbook configuration"

  172. msgstr ""

  173. 

  174. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:48

  175. msgid ""

  176. "To enable the bridge, add the following configuration to your "

  177. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  178. msgstr ""

  179. 

  180. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:64

  181. msgid ""

  182. "Other configuration options are available via the "

  183. "`matrix_appservice_slack_configuration_extension_yaml` variable."

  184. msgstr ""

  185. 

  186. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:66

  187. msgid "Installing"

  188. msgstr ""

  189. 

  190. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:68

  191. msgid ""

  192. "After configuring the playbook, run it with [playbook tags](playbook-"

  193. "tags.md) as below:"

  194. msgstr ""

  195. 

  196. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:77

  197. msgid ""

  198. "The `ensure-matrix-users-created` playbook tag makes the playbook "

  199. "automatically create the bot's user account."

  200. msgstr ""

  201. 

  202. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:79

  203. msgid ""

  204. "The shortcut commands with the [`just` program](just.md) are also "

  205. "available: `just install-all` or `just setup-all`"

  206. msgstr ""

  207. 

  208. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:81

  209. msgid ""

  210. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "

  211. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"

  212. "runtime) than `just setup-all`) when its components remain unchanged. If "

  213. "you adjust your `vars.yml` to remove other components, you'd need to run "

  214. "`just setup-all`, or these components will still remain installed."

  215. msgstr ""

  216. 

  217. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:83

  218. msgid "Usage"

  219. msgstr ""

  220. 

  221. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:85

  222. msgid ""

  223. "To use the bridge, you need to send `/invite @slackbot:example.com` to "

  224. "invite the bridge bot user into the admin room."

  225. msgstr ""

  226. 

  227. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:87

  228. msgid ""

  229. "If Team Sync is not enabled, for each channel you would like to bridge, "

  230. "perform the following steps:"

  231. msgstr ""

  232. 

  233. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:89

  234. msgid ""

  235. "Create a Matrix room in the usual manner for your client. Take a note of "

  236. "its Matrix room ID - it will look something like `!qporfwt:example.com`."

  237. msgstr ""

  238. 

  239. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:90

  240. msgid ""

  241. "Invite the bot user to both the Slack and Matrix channels you would like "

  242. "to bridge using `/invite @matrixbot` for Slack and `/invite "

  243. "@slackbot:example.com` for Matrix."

  244. msgstr ""

  245. 

  246. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:91

  247. msgid ""

  248. "Determine the \"channel ID\" that Slack uses to identify the channel. You"

  249. " can see it when you open a given Slack channel in a browser. The URL "

  250. "reads like this: `https://app.slack.com/client/XXX/<the channel "

  251. "ID>/details/`."

  252. msgstr ""

  253. 

  254. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:92

  255. msgid ""

  256. "Issue a link command in the administration control room with these "

  257. "collected values as arguments:"

  258. msgstr ""

  259. 

  260. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:94

  261. msgid "with file bridging:"

  262. msgstr ""

  263. 

  264. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:100

  265. msgid "without file bridging:"

  266. msgstr ""

  267. 

  268. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:106

  269. msgid "These arguments can be shortened to single-letter forms:"

  270. msgstr ""

  271. 

  272. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:112

  273. msgid "Unlinking"

  274. msgstr ""

  275. 

  276. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:114

  277. msgid "Channels can be unlinked again by sending this:"

  278. msgstr ""

  279. 

  280. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:120

  281. msgid ""

  282. "Unlinking doesn't only disconnect the bridge, but also makes the slackbot"

  283. " leave the bridged Matrix room. So in case you want to re-link later, "

  284. "don't forget to re-invite the slackbot into this room again."

  285. msgstr ""

  286. 

  287. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:122

  288. msgid "Troubleshooting"

  289. msgstr ""

  290. 

  291. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:124

  292. msgid "As always, check the logs: `journalctl -fu matrix-appservice-slack`"

  293. msgstr ""

  294. 

  295. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:126

  296. msgid "Linking: \"Room is now pending-name\""

  297. msgstr ""

  298. 

  299. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:128

  300. msgid ""

  301. "This typically means that you haven't used the correct Slack channel ID. "

  302. "Unlink the room and recheck 'Determine the \"channel ID\"' from above."

  303. msgstr ""

  304. 

  305. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:130

  306. msgid "Messages work from Matrix to Slack, but not the other way around"

  307. msgstr ""

  308. 

  309. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:132

  310. msgid "Check you logs, if they say something like"

  311. msgstr ""

  312. 

  313. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:134

  314. #, python-format

  315. msgid ""

  316. "`WARN SlackEventHandler Ignoring message from unrecognised Slack channel "

  317. "ID : %s (%s) <the channel ID> <some other ID>`"

  318. msgstr ""

  319. 

  320. #: ../../../docs/configuring-playbook-bridge-appservice-slack.md:136

  321. msgid ""

  322. "then unlink your room, reinvite the bot and re-link it again. This may "

  323. "particularly hit you, if you tried to unsuccessfully link your room "

  324. "multiple times without unlinking it after each failed attempt."

  325. msgstr ""