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.
8820 Commits
5 Branches
451 MiB
 
 
 
Tree: c51e771d1a
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'c51e771d1a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge...

678 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: jp\n"

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

  18. "MIME-Version: 1.0\n"

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

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

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

  22. 

  23. #: ../../../docs/configuring-playbook-bridge-hookshot.md:1

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

  25. msgstr ""

  26. 

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

  28. msgid ""

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

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

  31. msgstr ""

  32. 

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

  34. msgid ""

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

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

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

  38. msgstr ""

  39. 

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

  41. msgid ""

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

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

  44. "useful to you."

  45. msgstr ""

  46. 

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

  48. msgid ""

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

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

  51. "deprecated by its author."

  52. msgstr ""

  53. 

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

  55. msgid "Prerequisites"

  56. msgstr ""

  57. 

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

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

  60. msgstr ""

  61. 

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

  63. msgid ""

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

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

  66. msgstr ""

  67. 

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

  69. msgid ""

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

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

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

  73. msgstr ""

  74. 

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

  76. msgid "Adjusting the playbook configuration"

  77. msgstr ""

  78. 

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

  80. msgid ""

  81. "Add the following configuration to your "

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

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

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

  85. msgstr ""

  86. 

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

  88. msgid ""

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

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

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

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

  93. msgstr ""

  94. 

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

  96. msgid ""

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

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

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

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

  101. msgstr ""

  102. 

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

  104. msgid "Extending the configuration"

  105. msgstr ""

  106. 

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

  108. msgid ""

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

  110. "`matrix_hookshot_configuration_extension_yaml` and "

  111. "`matrix_hookshot_registration_extension_yaml` variables."

  112. msgstr ""

  113. 

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

  115. msgid ""

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

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

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

  119. "learn what the individual options do."

  120. msgstr ""

  121. 

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

  123. msgid "Installing"

  124. msgstr ""

  125. 

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

  127. msgid ""

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

  129. "tags.md) as below:"

  130. msgstr ""

  131. 

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

  133. msgid ""

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

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

  136. msgstr ""

  137. 

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

  139. msgid ""

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

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

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

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

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

  145. msgstr ""

  146. 

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

  148. msgid "Usage"

  149. msgstr ""

  150. 

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

  152. msgid ""

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

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

  155. msgstr ""

  156. 

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

  158. msgid ""

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

  160. "power level in clients)."

  161. msgstr ""

  162. 

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

  164. msgid ""

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

  166. "additional commands."

  167. msgstr ""

  168. 

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

  170. msgid ""

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

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

  173. "various features."

  174. msgstr ""

  175. 

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

  177. msgid ""

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

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

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

  181. msgstr ""

  182. 

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

  184. msgid "Reset crypto store"

  185. msgstr ""

  186. 

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

  188. msgid ""

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

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

  191. msgstr ""

  192. 

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

  194. msgid "More setup documentation"

  195. msgstr ""

  196. 

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

  198. msgid "URLs for bridges setup"

  199. msgstr ""

  200. 

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

  202. msgid ""

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

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

  205. msgstr ""

  206. 

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

  208. msgid "Listener"

  209. msgstr ""

  210. 

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

  212. msgid "Default path"

  213. msgstr ""

  214. 

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

  216. msgid "Variable"

  217. msgstr ""

  218. 

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

  220. msgid "Used as"

  221. msgstr ""

  222. 

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

  224. msgid "-"

  225. msgstr ""

  226. 

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

  228. msgid "`/hookshot/webhooks/`"

  229. msgstr ""

  230. 

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

  232. msgid "`matrix_hookshot_webhook_endpoint`"

  233. msgstr ""

  234. 

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

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

  237. msgstr ""

  238. 

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

  240. msgid "generic"

  241. msgstr ""

  242. 

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

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

  245. msgstr ""

  246. 

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

  248. msgid "`matrix_hookshot_generic_endpoint`"

  249. msgstr ""

  250. 

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

  252. msgid "Generic webhooks"

  253. msgstr ""

  254. 

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

  256. msgid "github oauth"

  257. msgstr ""

  258. 

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

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

  261. msgstr ""

  262. 

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

  264. msgid "`matrix_hookshot_github_oauth_endpoint`"

  265. msgstr ""

  266. 

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

  268. msgid "GitHub \"Callback URL\""

  269. msgstr ""

  270. 

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

  272. msgid "jira oauth"

  273. msgstr ""

  274. 

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

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

  277. msgstr ""

  278. 

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

  280. msgid "`matrix_hookshot_jira_oauth_endpoint`"

  281. msgstr ""

  282. 

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

  284. msgid "Jira OAuth"

  285. msgstr ""

  286. 

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

  288. msgid "figma endpoint"

  289. msgstr ""

  290. 

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

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

  293. msgstr ""

  294. 

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

  296. msgid "`matrix_hookshot_figma_endpoint`"

  297. msgstr ""

  298. 

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

  300. msgid "Figma"

  301. msgstr ""

  302. 

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

  304. msgid "provisioning"

  305. msgstr ""

  306. 

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

  308. msgid "`/hookshot/v1/`"

  309. msgstr ""

  310. 

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

  312. msgid "`matrix_hookshot_provisioning_endpoint`"

  313. msgstr ""

  314. 

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

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

  317. msgstr ""

  318. 

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

  320. msgid "appservice"

  321. msgstr ""

  322. 

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

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

  325. msgstr ""

  326. 

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

  328. msgid "`matrix_hookshot_appservice_endpoint`"

  329. msgstr ""

  330. 

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

  332. msgid "Matrix server"

  333. msgstr ""

  334. 

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

  336. msgid "widgets"

  337. msgstr ""

  338. 

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

  340. msgid "`/hookshot/widgetapi/`"

  341. msgstr ""

  342. 

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

  344. msgid "`matrix_hookshot_widgets_endpoint`"

  345. msgstr ""

  346. 

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

  348. msgid "Widgets"

  349. msgstr ""

  350. 

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

  352. msgid "metrics"

  353. msgstr ""

  354. 

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

  356. msgid "`/metrics/hookshot`"

  357. msgstr ""

  358. 

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

  360. msgid ""

  361. "`matrix_hookshot_metrics_enabled` and exposure enabled via "

  362. "`matrix_hookshot_metrics_proxying_enabled` or "

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

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

  365. msgstr ""

  366. 

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

  368. msgid "Prometheus"

  369. msgstr ""

  370. 

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

  372. msgid ""

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

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

  375. "which expose URLs publicly"

  376. msgstr ""

  377. 

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

  379. msgid ""

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

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

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

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

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

  385. msgstr ""

  386. 

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

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

  389. msgstr ""

  390. 

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

  392. msgid ""

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

  394. " done in multiple ways:"

  395. msgstr ""

  396. 

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

  398. msgid ""

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

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

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

  402. msgstr ""

  403. 

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

  405. msgid ""

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

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

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

  409. msgstr ""

  410. 

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

  412. msgid ""

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

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

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

  416. msgstr ""

  417. 

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

  419. msgid ""

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

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

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

  423. msgstr ""

  424. 

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

  426. msgid ""

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

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

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

  430. msgstr ""

  431. 

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

  433. msgid "Provisioning API"

  434. msgstr ""

  435. 

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

  437. msgid ""

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

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

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

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

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

  443. "`matrix_hookshot_container_url` and `matrix_hookshot_provisioning_port`."

  444. msgstr ""

  445. 

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

  447. msgid "Metrics"

  448. msgstr ""

  449. 

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

  451. msgid ""

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

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

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

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

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

  457. msgstr ""

  458. 

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

  460. msgid ""

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

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

  463. msgstr ""

  464. 

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

  466. msgid ""

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

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

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

  470. msgstr ""

  471. 

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

  473. msgid ""

  474. "either enabling metrics exposure for Hookshot via "

  475. "`matrix_hookshot_metrics_proxying_enabled: true`"

  476. msgstr ""

  477. 

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

  479. msgid ""

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

  481. "`matrix_metrics_exposure_enabled: true`"

  482. msgstr ""

  483. 

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

  485. msgid ""

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

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

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

  489. "protection for metrics."

  490. msgstr ""

  491. 

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

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

  494. msgstr ""

  495. 

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

  497. msgid ""

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

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

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

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

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

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

  504. msgstr ""

  505. 

  506. #~ msgid ""

  507. #~ "Hookshot can bridge "

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

  509. #~ "software project management services such "

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

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

  512. #~ msgstr ""

  513. 

  514. #~ msgid ""

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

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

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

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

  519. #~ msgstr ""

  520. 

  521. #~ msgid "Setup Instructions"

  522. #~ msgstr ""

  523. 

  524. #~ msgid ""

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

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

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

  528. #~ " do."

  529. #~ msgstr ""

  530. 

  531. #~ msgid ""

  532. #~ "Enable the bridge by adding "

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

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

  535. #~ msgstr ""

  536. 

  537. #~ msgid ""

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

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

  540. #~ "fill in the respective variables "

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

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

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

  544. #~ msgstr ""

  545. 

  546. #~ msgid ""

  547. #~ "Take special note of the "

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

  549. #~ " need no further configuration are "

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

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

  552. #~ "required configuration and enable the "

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

  554. #~ msgstr ""

  555. 

  556. #~ msgid ""

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

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

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

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

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

  562. #~ " variable `matrix_hookshot_github_private_key` so "

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

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

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

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

  567. #~ msgstr ""

  568. 

  569. #~ msgid ""

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

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

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

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

  574. #~ " [configuring other playbook services"

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

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

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

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

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

  580. #~ msgstr ""

  581. 

  582. #~ msgid ""

  583. #~ "Other configuration options are available "

  584. #~ "via the `matrix_hookshot_configuration_extension_yaml` "

  585. #~ "and `matrix_hookshot_registration_extension_yaml` "

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

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

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

  589. #~ "them."

  590. #~ msgstr ""

  591. 

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

  593. #~ msgstr ""

  594. 

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

  596. #~ msgstr ""

  597. 

  598. #~ msgid ""

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

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

  601. #~ " for Hookshot by adding "

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

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

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

  605. #~ msgstr ""

  606. 

  607. #~ msgid ""

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

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

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

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

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

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

  614. #~ msgstr ""

  615. 

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

  617. #~ msgstr ""

  618. 

  619. #~ msgid ""

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

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

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

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

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

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

  626. #~ msgstr ""

  627. 

  628. #~ msgid "listener"

  629. #~ msgstr ""

  630. 

  631. #~ msgid "default path"

  632. #~ msgstr ""

  633. 

  634. #~ msgid "variable"

  635. #~ msgstr ""

  636. 

  637. #~ msgid "used as"

  638. #~ msgstr ""

  639. 

  640. #~ msgid "JIRA OAuth"

  641. #~ msgstr ""

  642. 

  643. #~ msgid ""

  644. #~ "Also see the various "

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

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

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

  648. #~ "publicly."

  649. #~ msgstr ""

  650. 

  651. #~ msgid ""

  652. #~ "The different listeners are also "

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

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

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

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

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

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

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

  660. #~ " info."

  661. #~ msgstr ""

  662. 

  663. #~ msgid ""

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

  665. #~ " file and set the variable "

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

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

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

  669. #~ msgstr ""

  670. 

  671. #~ msgid ""

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

  673. #~ " the `matrix_hookshot_github_private_key` variable "

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

  675. #~ "additional configuration:"

  676. #~ msgstr ""