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.
8817 Commits
13 Branches
36 MiB
 
 
Tree: 0afa372ca8
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '0afa372ca8'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge...

679 lines
21 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-20 09:53+0200\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-hookshot.md:1

  25. msgid "Setting up matrix-hookshot (optional)"

  26. msgstr ""

  27. 

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

  29. msgid ""

  30. "The playbook can install and configure [matrix-"

  31. "hookshot](https://github.com/matrix-org/matrix-hookshot) for you."

  32. msgstr ""

  33. 

  34. #: ../../../docs/configuring-playbook-bridge-hookshot.md:5

  35. msgid ""

  36. "Hookshot can bridge [Webhooks](https://en.wikipedia.org/wiki/Webhook) "

  37. "from software project management services such as GitHub, GitLab, Jira, "

  38. "and Figma, as well as generic webhooks."

  39. msgstr ""

  40. 

  41. #: ../../../docs/configuring-playbook-bridge-hookshot.md:7

  42. msgid ""

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

  44. "hookshot/latest/hookshot.html) to learn what it does and why it might be "

  45. "useful to you."

  46. msgstr ""

  47. 

  48. #: ../../../docs/configuring-playbook-bridge-hookshot.md:9

  49. msgid ""

  50. "**Note**: the playbook also supports [matrix-appservice-webhooks"

  51. "](configuring-playbook-bridge-appservice-webhooks.md), which however was "

  52. "deprecated by its author."

  53. msgstr ""

  54. 

  55. #: ../../../docs/configuring-playbook-bridge-hookshot.md:11

  56. msgid "Prerequisites"

  57. msgstr ""

  58. 

  59. #: ../../../docs/configuring-playbook-bridge-hookshot.md:13

  60. msgid "Download GitHub app private key (optional)"

  61. msgstr ""

  62. 

  63. #: ../../../docs/configuring-playbook-bridge-hookshot.md:15

  64. msgid ""

  65. "If you're setting up the GitHub bridge, you need to create your GitHub "

  66. "app, and generate a private key file of it."

  67. msgstr ""

  68. 

  69. #: ../../../docs/configuring-playbook-bridge-hookshot.md:17

  70. msgid ""

  71. "You need to download the private key file, if you will install the file "

  72. "manually or with the `aux` role. For details, see [the section below"

  73. "](#manage-github-private-key-with-aux-role)."

  74. msgstr ""

  75. 

  76. #: ../../../docs/configuring-playbook-bridge-hookshot.md:19

  77. msgid "Adjusting the playbook configuration"

  78. msgstr ""

  79. 

  80. #: ../../../docs/configuring-playbook-bridge-hookshot.md:21

  81. msgid ""

  82. "Add the following configuration to your "

  83. "`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "

  84. "replace `GITHUB_PRIVATE_KEY_HERE` with the one created [above](#download-"

  85. "github-app-private-key)."

  86. msgstr ""

  87. 

  88. #: ../../../docs/configuring-playbook-bridge-hookshot.md:35

  89. msgid ""

  90. "For each of the services (GitHub, GitLab, Jira, Figma, and generic "

  91. "webhooks) fill in the respective variables `matrix_hookshot_service_*` "

  92. "listed in [main.yml](../roles/custom/matrix-bridge-"

  93. "hookshot/defaults/main.yml) as required."

  94. msgstr ""

  95. 

  96. #: ../../../docs/configuring-playbook-bridge-hookshot.md:37

  97. msgid ""

  98. "Take special note of the `matrix_hookshot_*_enabled` variables. Services "

  99. "that need no further configuration are enabled by default (GitLab and "

  100. "generic webhooks), while you must first add the required configuration "

  101. "and enable the others (GitHub, Jira, and Figma)."

  102. msgstr ""

  103. 

  104. #: ../../../docs/configuring-playbook-bridge-hookshot.md:39

  105. msgid "Extending the configuration"

  106. msgstr ""

  107. 

  108. #: ../../../docs/configuring-playbook-bridge-hookshot.md:41

  109. msgid ""

  110. "You can configure additional options by adding the "

  111. "`matrix_hookshot_configuration_extension_yaml` and "

  112. "`matrix_hookshot_registration_extension_yaml` variables."

  113. msgstr ""

  114. 

  115. #: ../../../docs/configuring-playbook-bridge-hookshot.md:43

  116. msgid ""

  117. "Refer the [official instructions](https://matrix-org.github.io/matrix-"

  118. "hookshot/latest/setup.html) and the comments in "

  119. "[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml) to "

  120. "learn what the individual options do."

  121. msgstr ""

  122. 

  123. #: ../../../docs/configuring-playbook-bridge-hookshot.md:45

  124. msgid "Installing"

  125. msgstr ""

  126. 

  127. #: ../../../docs/configuring-playbook-bridge-hookshot.md:47

  128. msgid ""

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

  130. "tags.md) as below:"

  131. msgstr ""

  132. 

  133. #: ../../../docs/configuring-playbook-bridge-hookshot.md:54

  134. msgid ""

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

  136. "available: `just install-service hookshot` or `just setup-all`"

  137. msgstr ""

  138. 

  139. #: ../../../docs/configuring-playbook-bridge-hookshot.md:56

  140. msgid ""

  141. "`just install-service hookshot` is useful for maintaining your setup "

  142. "quickly when its components remain unchanged. If you adjust your "

  143. "`vars.yml` to remove other components, you'd need to run `just setup-"

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

  145. "all` runs the `ensure-matrix-users-created` tag too."

  146. msgstr ""

  147. 

  148. #: ../../../docs/configuring-playbook-bridge-hookshot.md:58

  149. msgid "Usage"

  150. msgstr ""

  151. 

  152. #: ../../../docs/configuring-playbook-bridge-hookshot.md:60

  153. msgid ""

  154. "To use the bridge, you need to create a room and invite the Hookshot bot "

  155. "(`@hookshot:example.com`) to it."

  156. msgstr ""

  157. 

  158. #: ../../../docs/configuring-playbook-bridge-hookshot.md:62

  159. msgid ""

  160. "Make sure the bot is able to send state events (usually the Moderator "

  161. "power level in clients)."

  162. msgstr ""

  163. 

  164. #: ../../../docs/configuring-playbook-bridge-hookshot.md:64

  165. msgid ""

  166. "Send `!hookshot help` to the room to see the bridge's help menu for "

  167. "additional commands."

  168. msgstr ""

  169. 

  170. #: ../../../docs/configuring-playbook-bridge-hookshot.md:66

  171. msgid ""

  172. "Refer to [Hookshot's documentation](https://matrix-org.github.io/matrix-"

  173. "hookshot/latest/usage.html) for more details about using the bridge's "

  174. "various features."

  175. msgstr ""

  176. 

  177. #: ../../../docs/configuring-playbook-bridge-hookshot.md:68

  178. msgid ""

  179. "💡 **Note**: the different listeners are bound to certain paths which "

  180. "might differ from those assumed by the hookshot documentation. See [URLs "

  181. "for bridges setup](#urls-for-bridges-setup) below."

  182. msgstr ""

  183. 

  184. #: ../../../docs/configuring-playbook-bridge-hookshot.md:70

  185. msgid "Reset crypto store"

  186. msgstr ""

  187. 

  188. #: ../../../docs/configuring-playbook-bridge-hookshot.md:72

  189. msgid ""

  190. "Should the crypto store be corrupted, you can reset it by executing this "

  191. "Ansible playbook with the tag `reset-hookshot-encryption` added:"

  192. msgstr ""

  193. 

  194. #: ../../../docs/configuring-playbook-bridge-hookshot.md:78

  195. msgid "More setup documentation"

  196. msgstr ""

  197. 

  198. #: ../../../docs/configuring-playbook-bridge-hookshot.md:80

  199. msgid "URLs for bridges setup"

  200. msgstr ""

  201. 

  202. #: ../../../docs/configuring-playbook-bridge-hookshot.md:82

  203. msgid ""

  204. "Unless indicated otherwise, the following endpoints are reachable on your"

  205. " `matrix.` subdomain (if the feature is enabled)."

  206. msgstr ""

  207. 

  208. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  209. msgid "Listener"

  210. msgstr ""

  211. 

  212. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  213. msgid "Default path"

  214. msgstr ""

  215. 

  216. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  217. msgid "Variable"

  218. msgstr ""

  219. 

  220. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  221. msgid "Used as"

  222. msgstr ""

  223. 

  224. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  225. msgid "-"

  226. msgstr ""

  227. 

  228. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  229. msgid "`/hookshot/webhooks/`"

  230. msgstr ""

  231. 

  232. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  233. msgid "`matrix_hookshot_webhook_endpoint`"

  234. msgstr ""

  235. 

  236. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  237. msgid "Webhook-prefix, which affects all webhook-related URLs below"

  238. msgstr ""

  239. 

  240. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  241. msgid "generic"

  242. msgstr ""

  243. 

  244. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  245. msgid "`/hookshot/webhooks/webhook`"

  246. msgstr ""

  247. 

  248. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  249. msgid "`matrix_hookshot_generic_endpoint`"

  250. msgstr ""

  251. 

  252. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  253. msgid "Generic webhooks"

  254. msgstr ""

  255. 

  256. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  257. msgid "github oauth"

  258. msgstr ""

  259. 

  260. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  261. msgid "`/hookshot/webhooks/oauth`"

  262. msgstr ""

  263. 

  264. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  265. msgid "`matrix_hookshot_github_oauth_endpoint`"

  266. msgstr ""

  267. 

  268. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  269. msgid "GitHub \"Callback URL\""

  270. msgstr ""

  271. 

  272. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  273. msgid "jira oauth"

  274. msgstr ""

  275. 

  276. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  277. msgid "`/hookshot/webhooks/jira/oauth`"

  278. msgstr ""

  279. 

  280. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  281. msgid "`matrix_hookshot_jira_oauth_endpoint`"

  282. msgstr ""

  283. 

  284. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  285. msgid "Jira OAuth"

  286. msgstr ""

  287. 

  288. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  289. msgid "figma endpoint"

  290. msgstr ""

  291. 

  292. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  293. msgid "`/hookshot/webhooks/figma/webhook`"

  294. msgstr ""

  295. 

  296. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  297. msgid "`matrix_hookshot_figma_endpoint`"

  298. msgstr ""

  299. 

  300. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  301. msgid "Figma"

  302. msgstr ""

  303. 

  304. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  305. msgid "provisioning"

  306. msgstr ""

  307. 

  308. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  309. msgid "`/hookshot/v1/`"

  310. msgstr ""

  311. 

  312. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  313. msgid "`matrix_hookshot_provisioning_endpoint`"

  314. msgstr ""

  315. 

  316. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  317. msgid "Dimension [provisioning](#provisioning-api)"

  318. msgstr ""

  319. 

  320. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  321. msgid "appservice"

  322. msgstr ""

  323. 

  324. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  325. msgid "`/hookshot/_matrix/app/`"

  326. msgstr ""

  327. 

  328. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  329. msgid "`matrix_hookshot_appservice_endpoint`"

  330. msgstr ""

  331. 

  332. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  333. msgid "Matrix server"

  334. msgstr ""

  335. 

  336. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  337. msgid "widgets"

  338. msgstr ""

  339. 

  340. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  341. msgid "`/hookshot/widgetapi/`"

  342. msgstr ""

  343. 

  344. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  345. msgid "`matrix_hookshot_widgets_endpoint`"

  346. msgstr ""

  347. 

  348. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  349. msgid "Widgets"

  350. msgstr ""

  351. 

  352. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  353. msgid "metrics"

  354. msgstr ""

  355. 

  356. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  357. msgid "`/metrics/hookshot`"

  358. msgstr ""

  359. 

  360. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  361. msgid ""

  362. "`matrix_hookshot_metrics_enabled` and exposure enabled via "

  363. "`matrix_hookshot_metrics_proxying_enabled` or "

  364. "`matrix_metrics_exposure_enabled`. Read more in the [Metrics "

  365. "section](#metrics) below."

  366. msgstr ""

  367. 

  368. #: ../../../docs/configuring-playbook-bridge-hookshot.md

  369. msgid "Prometheus"

  370. msgstr ""

  371. 

  372. #: ../../../docs/configuring-playbook-bridge-hookshot.md:96

  373. msgid ""

  374. "Also see the various `matrix_hookshot_container_labels_*` variables in "

  375. "[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml), "

  376. "which expose URLs publicly"

  377. msgstr ""

  378. 

  379. #: ../../../docs/configuring-playbook-bridge-hookshot.md:98

  380. msgid ""

  381. "The different listeners are also reachable *internally* in the docker-"

  382. "network via the container's name (configured by "

  383. "`matrix_hookshot_container_url`) and on different ports (e.g. "

  384. "`matrix_hookshot_appservice_port`). Read [main.yml](../roles/custom"

  385. "/matrix-bridge-hookshot/defaults/main.yml) in detail for more info."

  386. msgstr ""

  387. 

  388. #: ../../../docs/configuring-playbook-bridge-hookshot.md:100

  389. msgid "Manage GitHub Private Key with aux role"

  390. msgstr ""

  391. 

  392. #: ../../../docs/configuring-playbook-bridge-hookshot.md:102

  393. msgid ""

  394. "The GitHub bridge requires you to install a private key file. This can be"

  395. " done in multiple ways:"

  396. msgstr ""

  397. 

  398. #: ../../../docs/configuring-playbook-bridge-hookshot.md:104

  399. msgid ""

  400. "copy the *contents* of the downloaded file and set the variable "

  401. "`matrix_hookshot_github_private_key` to the contents (see example in "

  402. "[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml))."

  403. msgstr ""

  404. 

  405. #: ../../../docs/configuring-playbook-bridge-hookshot.md:105

  406. msgid ""

  407. "somehow copy the file to the path `{{ matrix_hookshot_base_path }}/{{ "

  408. "matrix_hookshot_github_private_key_file }}` (default: `/matrix/hookshot"

  409. "/private-key.pem`) on the server manually."

  410. msgstr ""

  411. 

  412. #: ../../../docs/configuring-playbook-bridge-hookshot.md:106

  413. msgid ""

  414. "use the [`aux` role](https://github.com/mother-of-all-self-hosting"

  415. "/ansible-role-aux) to copy the file from an arbitrary path on your "

  416. "ansible client to the correct path on the server."

  417. msgstr ""

  418. 

  419. #: ../../../docs/configuring-playbook-bridge-hookshot.md:108

  420. msgid ""

  421. "To use the `aux` role, make sure the `matrix_hookshot_github_private_key`"

  422. " variable is empty. Then add the following configuration to your "

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

  424. msgstr ""

  425. 

  426. #: ../../../docs/configuring-playbook-bridge-hookshot.md:119

  427. msgid ""

  428. "For more information, see the documentation in the [default configuration"

  429. " of the aux role](https://github.com/mother-of-all-self-hosting/ansible-"

  430. "role-aux/blob/main/defaults/main.yml)."

  431. msgstr ""

  432. 

  433. #: ../../../docs/configuring-playbook-bridge-hookshot.md:121

  434. msgid "Provisioning API"

  435. msgstr ""

  436. 

  437. #: ../../../docs/configuring-playbook-bridge-hookshot.md:123

  438. msgid ""

  439. "The provisioning API will be enabled automatically if you set "

  440. "`matrix_dimension_enabled: true` and provided a "

  441. "`matrix_hookshot_provisioning_secret`, unless you override it either way."

  442. " To use hookshot with dimension, you will need to enter as \"Provisioning"

  443. " URL\": `http://matrix-hookshot:9002`, which is made up of the variables "

  444. "`matrix_hookshot_container_url` and `matrix_hookshot_provisioning_port`."

  445. msgstr ""

  446. 

  447. #: ../../../docs/configuring-playbook-bridge-hookshot.md:125

  448. msgid "Metrics"

  449. msgstr ""

  450. 

  451. #: ../../../docs/configuring-playbook-bridge-hookshot.md:127

  452. msgid ""

  453. "Metrics are **only enabled by default** if the builtin [Prometheus"

  454. "](configuring-playbook-prometheus-grafana.md) is enabled (by default, "

  455. "Prometheus isn't enabled). If so, metrics will automatically be collected"

  456. " by Prometheus and made available in Grafana. You will, however, need to "

  457. "set up your own Dashboard for displaying them."

  458. msgstr ""

  459. 

  460. #: ../../../docs/configuring-playbook-bridge-hookshot.md:129

  461. msgid ""

  462. "To explicitly enable metrics, use `matrix_hookshot_metrics_enabled: "

  463. "true`. This only exposes metrics over the container network, however."

  464. msgstr ""

  465. 

  466. #: ../../../docs/configuring-playbook-bridge-hookshot.md:131

  467. msgid ""

  468. "**To collect metrics from an external Prometheus server**, besides "

  469. "enabling metrics as described above, you will also need to enable metrics"

  470. " exposure on `https://matrix.example.com/metrics/hookshot` by:"

  471. msgstr ""

  472. 

  473. #: ../../../docs/configuring-playbook-bridge-hookshot.md:133

  474. msgid ""

  475. "either enabling metrics exposure for Hookshot via "

  476. "`matrix_hookshot_metrics_proxying_enabled: true`"

  477. msgstr ""

  478. 

  479. #: ../../../docs/configuring-playbook-bridge-hookshot.md:134

  480. msgid ""

  481. "or enabling metrics exposure for all services via "

  482. "`matrix_metrics_exposure_enabled: true`"

  483. msgstr ""

  484. 

  485. #: ../../../docs/configuring-playbook-bridge-hookshot.md:136

  486. msgid ""

  487. "Whichever one you go with, by default metrics are exposed publicly "

  488. "**without** password-protection. See [the Prometheus and Grafana docs"

  489. "](configuring-playbook-prometheus-grafana.md) for details about password-"

  490. "protection for metrics."

  491. msgstr ""

  492. 

  493. #: ../../../docs/configuring-playbook-bridge-hookshot.md:138

  494. msgid "Collision with matrix-appservice-webhooks"

  495. msgstr ""

  496. 

  497. #: ../../../docs/configuring-playbook-bridge-hookshot.md:140

  498. msgid ""

  499. "If you are also running [matrix-appservice-webhooks](configuring-"

  500. "playbook-bridge-appservice-webhooks.md), it reserves its namespace by the"

  501. " default setting `matrix_appservice_webhooks_user_prefix: '_webhook_'`. "

  502. "You should take care if you modify its or hookshot's prefix that they do "

  503. "not collide with each other's namespace (default "

  504. "`matrix_hookshot_generic_userIdPrefix: '_webhooks_'`)."

  505. msgstr ""

  506. 

  507. #~ msgid ""

  508. #~ "Hookshot can bridge "

  509. #~ "[Webhooks](https://en.wikipedia.org/wiki/Webhook) from "

  510. #~ "software project management services such "

  511. #~ "as GitHub, GitLab, JIRA, and Figma, "

  512. #~ "as well as generic webhooks."

  513. #~ msgstr ""

  514. 

  515. #~ msgid ""

  516. #~ "See the project's [documentation](https://matrix-"

  517. #~ "org.github.io/matrix-hookshot/latest/hookshot.html) to "

  518. #~ "learn what it does in detail and"

  519. #~ " why it might be useful to you."

  520. #~ msgstr ""

  521. 

  522. #~ msgid "Setup Instructions"

  523. #~ msgstr ""

  524. 

  525. #~ msgid ""

  526. #~ "Refer to the [official instructions](https"

  527. #~ "://matrix-org.github.io/matrix-hookshot/latest/setup.html)"

  528. #~ " to learn what the individual options"

  529. #~ " do."

  530. #~ msgstr ""

  531. 

  532. #~ msgid ""

  533. #~ "Enable the bridge by adding "

  534. #~ "`matrix_hookshot_enabled: true` to your "

  535. #~ "`vars.yml` file"

  536. #~ msgstr ""

  537. 

  538. #~ msgid ""

  539. #~ "For each of the services (GitHub, "

  540. #~ "GitLab, Jira, Figma, generic webhooks) "

  541. #~ "fill in the respective variables "

  542. #~ "`matrix_hookshot_service_*` listed in "

  543. #~ "[main.yml](/roles/custom/matrix-bridge-"

  544. #~ "hookshot/defaults/main.yml) as required."

  545. #~ msgstr ""

  546. 

  547. #~ msgid ""

  548. #~ "Take special note of the "

  549. #~ "`matrix_hookshot_*_enabled` variables. Services that"

  550. #~ " need no further configuration are "

  551. #~ "enabled by default (GitLab, Generic), "

  552. #~ "while you must first add the "

  553. #~ "required configuration and enable the "

  554. #~ "others (GitHub, Jira, Figma)."

  555. #~ msgstr ""

  556. 

  557. #~ msgid ""

  558. #~ "If you're setting up the GitHub "

  559. #~ "bridge, you'll need to generate and "

  560. #~ "download a private key file after "

  561. #~ "you created your GitHub app. Copy "

  562. #~ "the contents of that file to the"

  563. #~ " variable `matrix_hookshot_github_private_key` so "

  564. #~ "the playbook can install it for "

  565. #~ "you, or use one of the [other "

  566. #~ "methods](#manage-github-private-key-with-"

  567. #~ "aux-role) explained below."

  568. #~ msgstr ""

  569. 

  570. #~ msgid ""

  571. #~ "If you've already installed Matrix "

  572. #~ "services using the playbook before, "

  573. #~ "you'll need to re-run it (`--tags"

  574. #~ "=setup-all,start`). If not, proceed with"

  575. #~ " [configuring other playbook services"

  576. #~ "](configuring-playbook.md) and then with "

  577. #~ "[Installing](installing.md). Get back to this"

  578. #~ " guide once ready. Hookshot can be"

  579. #~ " set up individually using the tag"

  580. #~ " `setup-hookshot`."

  581. #~ msgstr ""

  582. 

  583. #~ msgid ""

  584. #~ "Other configuration options are available "

  585. #~ "via the `matrix_hookshot_configuration_extension_yaml` "

  586. #~ "and `matrix_hookshot_registration_extension_yaml` "

  587. #~ "variables, see the comments in "

  588. #~ "[main.yml](/roles/custom/matrix-bridge-"

  589. #~ "hookshot/defaults/main.yml) for how to use "

  590. #~ "them."

  591. #~ msgstr ""

  592. 

  593. #~ msgid "Finally, run the playbook (see [installing](installing.md))."

  594. #~ msgstr ""

  595. 

  596. #~ msgid "End-to-bridge encryption"

  597. #~ msgstr ""

  598. 

  599. #~ msgid ""

  600. #~ "You can enable [encryption](https://matrix-"

  601. #~ "org.github.io/matrix-hookshot/latest/advanced/encryption.html)"

  602. #~ " for Hookshot by adding "

  603. #~ "`matrix_hookshot_encryption_enabled: true` to your"

  604. #~ " configuration (`vars.yml`) and [executing "

  605. #~ "the playbook](installing.md) again."

  606. #~ msgstr ""

  607. 

  608. #~ msgid ""

  609. #~ "Should the crypto store be corrupted,"

  610. #~ " you can reset it by executing "

  611. #~ "this Ansible playbook with the tag "

  612. #~ "`reset-hookshot-encryption` added, for "

  613. #~ "example `ansible-playbook -i inventory/hosts"

  614. #~ " setup.yml --tags=reset-hookshot-encryption`."

  615. #~ msgstr ""

  616. 

  617. #~ msgid "Send a `!hookshot help` message to see a list of help commands."

  618. #~ msgstr ""

  619. 

  620. #~ msgid ""

  621. #~ "**Important**: Note that the different "

  622. #~ "listeners are bound to certain paths "

  623. #~ "which might differ from those assumed"

  624. #~ " by the hookshot documentation, see "

  625. #~ "[URLs for bridges setup](#urls-for-"

  626. #~ "bridges-setup) below."

  627. #~ msgstr ""

  628. 

  629. #~ msgid "listener"

  630. #~ msgstr ""

  631. 

  632. #~ msgid "default path"

  633. #~ msgstr ""

  634. 

  635. #~ msgid "variable"

  636. #~ msgstr ""

  637. 

  638. #~ msgid "used as"

  639. #~ msgstr ""

  640. 

  641. #~ msgid "JIRA OAuth"

  642. #~ msgstr ""

  643. 

  644. #~ msgid ""

  645. #~ "Also see the various "

  646. #~ "`matrix_hookshot_container_labels_*` variables in "

  647. #~ "[main.yml](/roles/custom/matrix-bridge-"

  648. #~ "hookshot/defaults/main.yml), which expose URLs "

  649. #~ "publicly."

  650. #~ msgstr ""

  651. 

  652. #~ msgid ""

  653. #~ "The different listeners are also "

  654. #~ "reachable *internally* in the docker-"

  655. #~ "network via the container's name "

  656. #~ "(configured by `matrix_hookshot_container_url`) and"

  657. #~ " on different ports (e.g. "

  658. #~ "`matrix_hookshot_appservice_port`). Read "

  659. #~ "[main.yml](/roles/custom/matrix-bridge-"

  660. #~ "hookshot/defaults/main.yml) in detail for more"

  661. #~ " info."

  662. #~ msgstr ""

  663. 

  664. #~ msgid ""

  665. #~ "copy the *contents* of the downloaded"

  666. #~ " file and set the variable "

  667. #~ "`matrix_hookshot_github_private_key` to the contents"

  668. #~ " (see example in [main.yml](/roles/custom"

  669. #~ "/matrix-bridge-hookshot/defaults/main.yml))."

  670. #~ msgstr ""

  671. 

  672. #~ msgid ""

  673. #~ "To use the `aux` role, make sure"

  674. #~ " the `matrix_hookshot_github_private_key` variable "

  675. #~ "is empty. Then add the following "

  676. #~ "additional configuration:"

  677. #~ msgstr ""