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

288 lines
10 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-mautrix-facebook.md:1

  25. msgid "Setting up Mautrix Facebook bridging (optional, deprecated)"

  26. msgstr ""

  27. 

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

  29. msgid ""

  30. "**Note**: This bridge has been deprecated in favor of the [mautrix-"

  31. "meta](https://github.com/mautrix/meta) Messenger/Instagram bridge, which "

  32. "can be installed using [this playbook](configuring-playbook-bridge-"

  33. "mautrix-meta-messenger.md). Consider using that bridge instead of this "

  34. "one."

  35. msgstr ""

  36. 

  37. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:5

  38. msgid ""

  39. "The playbook can install and configure [mautrix-"

  40. "facebook](https://github.com/mautrix/facebook) for you."

  41. msgstr ""

  42. 

  43. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:7

  44. msgid ""

  45. "See the project's "

  46. "[documentation](https://github.com/mautrix/facebook/blob/master/ROADMAP.md)"

  47. " to learn what it does and why it might be useful to you."

  48. msgstr ""

  49. 

  50. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:9

  51. msgid "Prerequisite (optional)"

  52. msgstr ""

  53. 

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

  55. msgid ""

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

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

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

  59. "have enabled [Shared Secret Auth](configuring-playbook-shared-secret-"

  60. "auth.md) for this playbook."

  61. msgstr ""

  62. 

  63. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:13

  64. msgid ""

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

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

  67. msgstr ""

  68. 

  69. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:15

  70. msgid "Adjusting the playbook configuration"

  71. msgstr ""

  72. 

  73. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:17

  74. msgid ""

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

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

  77. msgstr ""

  78. 

  79. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:23

  80. msgid ""

  81. "There are some additional things you may wish to configure about the "

  82. "bridge before you continue."

  83. msgstr ""

  84. 

  85. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:25

  86. msgid ""

  87. "Encryption support is off by default. If you would like to enable "

  88. "encryption, add the following to your `vars.yml` file:"

  89. msgstr ""

  90. 

  91. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:35

  92. msgid ""

  93. "If you would like to be able to administrate the bridge from your account"

  94. " it can be configured like this:"

  95. msgstr ""

  96. 

  97. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:44

  98. msgid "Using both would look like"

  99. msgstr ""

  100. 

  101. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:56

  102. msgid ""

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

  104. "facebook/templates/config.yaml.j2` and `roles/custom/matrix-bridge-"

  105. "mautrix-facebook/defaults/main.yml` to find other things you would like "

  106. "to configure."

  107. msgstr ""

  108. 

  109. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:58

  110. msgid "Installing"

  111. msgstr ""

  112. 

  113. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:60

  114. msgid ""

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

  116. "tags.md) as below:"

  117. msgstr ""

  118. 

  119. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:67

  120. msgid "**Notes**:"

  121. msgstr ""

  122. 

  123. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:69

  124. msgid ""

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

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

  127. msgstr ""

  128. 

  129. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:71

  130. msgid ""

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

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

  133. msgstr ""

  134. 

  135. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:73

  136. msgid ""

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

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

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

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

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

  142. msgstr ""

  143. 

  144. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:75

  145. msgid "Usage"

  146. msgstr ""

  147. 

  148. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:77

  149. msgid ""

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

  151. "`@facebookbot:example.com` (where `example.com` is your base domain, not "

  152. "the `matrix.` domain)."

  153. msgstr ""

  154. 

  155. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:79

  156. msgid ""

  157. "Send `login YOUR_FACEBOOK_EMAIL_ADDRESS` to the bridge bot to enable "

  158. "bridging for your Facebook Messenger account. You can learn more here "

  159. "about authentication from the bridge's [official documentation on "

  160. "Authentication](https://docs.mau.fi/bridges/python/facebook/authentication.html)."

  161. msgstr ""

  162. 

  163. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:81

  164. msgid ""

  165. "If you run into trouble, check the [Troubleshooting](#troubleshooting) "

  166. "section below."

  167. msgstr ""

  168. 

  169. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:83

  170. msgid "💡 Set up Double Puppeting"

  171. msgstr ""

  172. 

  173. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:85

  174. msgid ""

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

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

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

  178. msgstr ""

  179. 

  180. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:87

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

  182. msgstr ""

  183. 

  184. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:89

  185. msgid "Method 1: automatically, by enabling Shared Secret Auth"

  186. msgstr ""

  187. 

  188. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:91

  189. msgid ""

  190. "The bridge automatically performs Double Puppeting if [Shared Secret Auth"

  191. "](configuring-playbook-shared-secret-auth.md) service is configured and "

  192. "enabled on the server for this playbook."

  193. msgstr ""

  194. 

  195. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:93

  196. msgid ""

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

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

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

  200. msgstr ""

  201. 

  202. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:95

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

  204. msgstr ""

  205. 

  206. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:97

  207. msgid ""

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

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

  210. msgstr ""

  211. 

  212. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:99

  213. msgid ""

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

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

  216. msgstr ""

  217. 

  218. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:101

  219. msgid ""

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

  221. "MATRIX_ACCESS_TOKEN_HERE`"

  222. msgstr ""

  223. 

  224. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:103

  225. msgid ""

  226. "make sure you don't log out the `Mautrix-Facebook` device some time in "

  227. "the future, as that would break the Double Puppeting feature"

  228. msgstr ""

  229. 

  230. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:105

  231. msgid "Troubleshooting"

  232. msgstr ""

  233. 

  234. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:107

  235. msgid "Facebook rejecting login attempts and forcing you to change password"

  236. msgstr ""

  237. 

  238. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:109

  239. msgid ""

  240. "If your Matrix server is in a wildly different location than where you "

  241. "usually use your Facebook account from, the bridge's login attempts may "

  242. "be outright rejected by Facebook. Along with that, Facebook may even "

  243. "force you to change the account's password."

  244. msgstr ""

  245. 

  246. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:111

  247. msgid ""

  248. "If you happen to run into this problem while [setting up "

  249. "bridging](#usage), try to first get a successful session up by logging in"

  250. " to Facebook through the Matrix server's IP address."

  251. msgstr ""

  252. 

  253. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:113

  254. msgid ""

  255. "The easiest way to do this may be to use "

  256. "[sshuttle](https://sshuttle.readthedocs.io/) to proxy your traffic "

  257. "through the Matrix server."

  258. msgstr ""

  259. 

  260. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:115

  261. msgid "Example command for proxying your traffic through the Matrix server:"

  262. msgstr ""

  263. 

  264. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:121

  265. msgid ""

  266. "Once connected, you should be able to verify that you're browsing the web"

  267. " through the Matrix server's IP by checking "

  268. "[icanhazip](https://icanhazip.com/)."

  269. msgstr ""

  270. 

  271. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:123

  272. msgid "Then proceed to log in to [Facebook/Messenger](https://www.facebook.com/)."

  273. msgstr ""

  274. 

  275. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:125

  276. msgid "Once logged in, proceed to [set up bridging](#usage)."

  277. msgstr ""

  278. 

  279. #: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:127

  280. msgid ""

  281. "If that doesn't work, enable 2FA (see: [Facebook help page on enabling "

  282. "2FA](https://www.facebook.com/help/148233965247823)) and try to login "

  283. "again with a new password, and entering the 2FA code when prompted, it "

  284. "may take more then one try, in between attempts, check facebook.com to "

  285. "see if they are requiring another password change"

  286. msgstr ""