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
106 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...

361 lines
13 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: 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-mautrix-meta-messenger.md:1

  24. msgid "Setting up Messenger bridging via Mautrix Meta (optional)"

  25. msgstr ""

  26. 

  27. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:3

  28. msgid ""

  29. "The playbook can install and configure the [mautrix-"

  30. "meta](https://github.com/mautrix/meta) Messenger/Instagram bridge for "

  31. "you."

  32. msgstr ""

  33. 

  34. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:5

  35. msgid ""

  36. "Since this bridge component can bridge to both "

  37. "[Messenger](https://messenger.com/) and "

  38. "[Instagram](https://instagram.com/) and you may wish to do both at the "

  39. "same time, the playbook makes it available via 2 different Ansible roles "

  40. "(`matrix-bridge-mautrix-meta-messenger` and `matrix-bridge-mautrix-meta-"

  41. "instagram`). The latter is a reconfigured copy of the first one (created "

  42. "by `just rebuild-mautrix-meta-instagram` and `bin/rebuild-mautrix-meta-"

  43. "instagram.sh`)."

  44. msgstr ""

  45. 

  46. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:7

  47. msgid ""

  48. "This documentation page only deals with the bridge's ability to bridge to"

  49. " Facebook Messenger. For bridging to Instagram, see [Setting up Instagram"

  50. " bridging via Mautrix Meta](configuring-playbook-bridge-mautrix-meta-"

  51. "instagram.md)."

  52. msgstr ""

  53. 

  54. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:9

  55. msgid "Prerequisites"

  56. msgstr ""

  57. 

  58. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:11

  59. msgid "Migrating from the old mautrix-facebook bridge"

  60. msgstr ""

  61. 

  62. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:13

  63. msgid ""

  64. "If you've been using the [mautrix-facebook](./configuring-playbook-"

  65. "bridge-mautrix-facebook.md) bridge, it's possible to migrate the database"

  66. " using [instructions from the bridge "

  67. "documentation](https://docs.mau.fi/bridges/go/meta/facebook-"

  68. "migration.html) (advanced)."

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:15

  72. msgid ""

  73. "Then you may wish to get rid of the Facebook bridge. To do so, send a "

  74. "`clean-rooms` command to the management room with the old bridge bot "

  75. "(`@facebookbot:example.com`). It gives you a list of portals and groups "

  76. "of portals you may purge. Proceed with sending commands like `clean "

  77. "recommended`, etc."

  78. msgstr ""

  79. 

  80. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:17

  81. msgid ""

  82. "Then, consider disabling the old bridge in your configuration, so it "

  83. "won't recreate the portals when you receive new messages."

  84. msgstr ""

  85. 

  86. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:19

  87. msgid ""

  88. "**Note**: the user ID of the new bridge bot is "

  89. "`@messengerbot:example.com`, not `@facebookbot:example.com`. After "

  90. "disabling the old bridge, its bot user will stop responding to a command."

  91. msgstr ""

  92. 

  93. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:21

  94. msgid "Enable Appservice Double Puppet (optional)"

  95. msgstr ""

  96. 

  97. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:23

  98. msgid ""

  99. "If you want to set up [Double "

  100. "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "

  101. "(hint: you most likely do) for this bridge automatically, you need to "

  102. "have enabled [Appservice Double Puppet](configuring-playbook-appservice-"

  103. "double-puppet.md) service for this playbook."

  104. msgstr ""

  105. 

  106. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:25

  107. msgid ""

  108. "For details about configuring Double Puppeting for this bridge, see the "

  109. "section below: [Set up Double Puppeting](#-set-up-double-puppeting)"

  110. msgstr ""

  111. 

  112. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:27

  113. msgid "Adjusting the playbook configuration"

  114. msgstr ""

  115. 

  116. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:29

  117. msgid ""

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

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

  120. msgstr ""

  121. 

  122. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:35

  123. msgid ""

  124. "Before proceeding to [re-running the playbook](./installing.md), you may "

  125. "wish to adjust the configuration further. See below."

  126. msgstr ""

  127. 

  128. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:37

  129. msgid "Bridge mode"

  130. msgstr ""

  131. 

  132. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:39

  133. msgid ""

  134. "As mentioned above, the [mautrix-meta](https://github.com/mautrix/meta) "

  135. "bridge supports multiple modes of operation."

  136. msgstr ""

  137. 

  138. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:41

  139. msgid "The bridge can pull your Messenger messages via 3 different methods:"

  140. msgstr ""

  141. 

  142. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:43

  143. msgid "(`facebook`) Facebook via `facebook.com`"

  144. msgstr ""

  145. 

  146. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:44

  147. msgid ""

  148. "(`facebook-tor`) Facebook via "

  149. "`facebookwkhpilnemxj7asaniu7vnjjbiltxjqhye3mhbshg7kx5tfyd.onion` "

  150. "([Tor](https://www.torproject.org/)) - does not currently proxy media "

  151. "downloads"

  152. msgstr ""

  153. 

  154. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:45

  155. msgid ""

  156. "(default) (`messenger`) Messenger via `messenger.com` - usable even "

  157. "without a Facebook account"

  158. msgstr ""

  159. 

  160. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:47

  161. msgid ""

  162. "You may switch the mode via the `matrix_mautrix_meta_messenger_meta_mode`"

  163. " variable. The playbook defaults to the `messenger` mode, because it's "

  164. "most universal (every Facebook user has a Messenger account, but the "

  165. "opposite is not true)."

  166. msgstr ""

  167. 

  168. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:49

  169. msgid ""

  170. "Note that switching the mode (especially between `facebook*` and "

  171. "`messenger`) will intentionally make the bridge use another database "

  172. "(`matrix_mautrix_meta_facebook` or `matrix_mautrix_meta_messenger`) to "

  173. "isolate the 2 instances. Switching between Tor and non-Tor may be "

  174. "possible without dataloss, but your mileage may vary. Before switching to"

  175. " a new mode, you may wish to de-configure the old one (send `help` to the"

  176. " bridge bot and unbridge your portals, etc.)."

  177. msgstr ""

  178. 

  179. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:51

  180. msgid "Bridge permissions"

  181. msgstr ""

  182. 

  183. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:53

  184. msgid "By default, any user on your homeserver will be able to use the bridge."

  185. msgstr ""

  186. 

  187. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:55

  188. msgid "Different levels of permission can be granted to users:"

  189. msgstr ""

  190. 

  191. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:57

  192. msgid "`relay` - Allowed to be relayed through the bridge, no access to commands"

  193. msgstr ""

  194. 

  195. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:58

  196. msgid "`user` - Use the bridge with puppeting"

  197. msgstr ""

  198. 

  199. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:59

  200. msgid "`admin` - Use and administer the bridge"

  201. msgstr ""

  202. 

  203. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:61

  204. msgid ""

  205. "The permissions are following the sequence: nothing < `relay` < `user` < "

  206. "`admin`."

  207. msgstr ""

  208. 

  209. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:63

  210. msgid ""

  211. "The default permissions are set via "

  212. "`matrix_mautrix_meta_messenger_bridge_permissions_default` and are "

  213. "somewhat like this:"

  214. msgstr ""

  215. 

  216. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:72

  217. msgid ""

  218. "If you don't define the `matrix_admin` in your configuration (e.g. "

  219. "`matrix_admin: @alice:example.com`), then there's no admin by default."

  220. msgstr ""

  221. 

  222. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:74

  223. msgid ""

  224. "You may redefine "

  225. "`matrix_mautrix_meta_messenger_bridge_permissions_default` any way you "

  226. "see fit, or add extra permissions using "

  227. "`matrix_mautrix_meta_messenger_bridge_permissions_custom` like this:"

  228. msgstr ""

  229. 

  230. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:81

  231. msgid ""

  232. "You may wish to look at `roles/custom/matrix-bridge-mautrix-meta-"

  233. "messenger/templates/config.yaml.j2` to find more information on the "

  234. "permissions settings and other options you would like to configure."

  235. msgstr ""

  236. 

  237. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:83

  238. msgid "Installing"

  239. msgstr ""

  240. 

  241. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:85

  242. msgid ""

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

  244. "tags.md) as below:"

  245. msgstr ""

  246. 

  247. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:92

  248. msgid "**Notes**:"

  249. msgstr ""

  250. 

  251. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:94

  252. msgid ""

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

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

  255. msgstr ""

  256. 

  257. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:96

  258. msgid ""

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

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

  261. msgstr ""

  262. 

  263. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:98

  264. msgid ""

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

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

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

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

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

  270. msgstr ""

  271. 

  272. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:100

  273. msgid "Usage"

  274. msgstr ""

  275. 

  276. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:102

  277. msgid ""

  278. "To use the bridge, you need to start a chat with "

  279. "`@messengerbot:example.com` (where `example.com` is your base domain, not"

  280. " the `matrix.` domain). Note that the user ID of the bridge's bot is not "

  281. "`@facebookbot:example.com`."

  282. msgstr ""

  283. 

  284. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:104

  285. msgid ""

  286. "You then need to send a `login` command and follow the bridge bot's "

  287. "instructions."

  288. msgstr ""

  289. 

  290. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:106

  291. msgid ""

  292. "Given that the bot is configured in `messenger` [bridge mode](#bridge-"

  293. "mode) by default, you will need to log in to "

  294. "[messenger.com](https://messenger.com/) (not `facebook.com`!) and obtain "

  295. "the cookies from there as per [the bridge's authentication "

  296. "instructions](https://docs.mau.fi/bridges/go/meta/authentication.html)."

  297. msgstr ""

  298. 

  299. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:108

  300. msgid "💡 Set up Double Puppeting"

  301. msgstr ""

  302. 

  303. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:110

  304. msgid ""

  305. "After successfully enabling bridging, you may wish to set up [Double "

  306. "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "

  307. "(hint: you most likely do)."

  308. msgstr ""

  309. 

  310. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:112

  311. msgid "To set it up, you have 2 ways of going about it."

  312. msgstr ""

  313. 

  314. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:114

  315. msgid "Method 1: automatically, by enabling Appservice Double Puppet"

  316. msgstr ""

  317. 

  318. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:116

  319. msgid ""

  320. "The bridge automatically performs Double Puppeting if [Appservice Double "

  321. "Puppet](configuring-playbook-appservice-double-puppet.md) service is "

  322. "configured and enabled on the server for this playbook."

  323. msgstr ""

  324. 

  325. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:118

  326. msgid ""

  327. "This is the recommended way of setting up Double Puppeting, as it's "

  328. "easier to accomplish, works for all your users automatically, and has "

  329. "less of a chance of breaking in the future."

  330. msgstr ""

  331. 

  332. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:120

  333. msgid "Method 2: manually, by asking each user to provide a working access token"

  334. msgstr ""

  335. 

  336. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:122

  337. msgid ""

  338. "When using this method, **each user** that wishes to enable Double "

  339. "Puppeting needs to follow the following steps:"

  340. msgstr ""

  341. 

  342. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:124

  343. msgid ""

  344. "retrieve a Matrix access token for yourself. Refer to the documentation "

  345. "on [how to do that](obtaining-access-tokens.md)."

  346. msgstr ""

  347. 

  348. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:126

  349. msgid ""

  350. "send the access token to the bot. Example: `login-matrix "

  351. "MATRIX_ACCESS_TOKEN_HERE`"

  352. msgstr ""

  353. 

  354. #: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:128

  355. msgid ""

  356. "make sure you don't log out the session for which you obtained an access "

  357. "token some time in the future, as that would break the Double Puppeting "

  358. "feature"

  359. msgstr ""