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.
 
 

422 lines
15 KiB

  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. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:1
  24. msgid "Setting up Draupnir for All/D4A (optional)"
  25. msgstr ""
  26. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:3
  27. msgid ""
  28. "The playbook can install and configure the [Draupnir](https://github.com"
  29. "/the-draupnir-project/Draupnir) moderation tool for you in appservice "
  30. "mode."
  31. msgstr ""
  32. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:5
  33. msgid ""
  34. "Appservice mode can be used together with the regular [Draupnir bot"
  35. "](configuring-playbook-bot-draupnir.md) or independently. Details about "
  36. "the differences between the 2 modes are described below."
  37. msgstr ""
  38. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:7
  39. msgid "Draupnir Appservice mode compared to Draupnir bot mode"
  40. msgstr ""
  41. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:9
  42. msgid ""
  43. "The administrative functions for managing the appservice are alpha "
  44. "quality and very limited. However, the experience of using an appservice-"
  45. "provisioned Draupnir is on par with the experience of using Draupnir from"
  46. " bot mode except in the case of avatar customisation as described later "
  47. "on in this document."
  48. msgstr ""
  49. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:11
  50. msgid ""
  51. "Draupnir for all is the way to go if you need more than 1 Draupnir "
  52. "instance, but you don't need access to Synapse Admin features as they are"
  53. " not accessible through Draupnir for All (Even though the commands do "
  54. "show up in help)."
  55. msgstr ""
  56. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:13
  57. msgid ""
  58. "Draupnir for all in the playbook is rate-limit-exempt automatically as "
  59. "its appservice configuration file does not specify any rate limits."
  60. msgstr ""
  61. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:15
  62. msgid ""
  63. "Normal Draupnir does come with the benefit of access to Synapse Admin "
  64. "features. You are also able to more easily customise your normal Draupnir"
  65. " than D4A as D4A even on the branch with the Avatar command (To be "
  66. "Upstreamed to Mainline Draupnir) that command is clunky as it requires "
  67. "the use of things like Element Web devtools. In normal Draupnir this is a"
  68. " quick operation where you login to Draupnir with a normal client and set"
  69. " Avatar and Display name normally."
  70. msgstr ""
  71. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:17
  72. msgid ""
  73. "Draupnir for all does not support external tooling like "
  74. "[MRU](https://mru.rory.gay) as it can't access Draupnir's user account."
  75. msgstr ""
  76. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:19
  77. msgid "Prerequisites"
  78. msgstr ""
  79. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:21
  80. msgid "Create a main management room"
  81. msgstr ""
  82. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:23
  83. msgid ""
  84. "The playbook does not create a management room for your Main Draupnir. "
  85. "You **need to create the room manually** before setting up the bot."
  86. msgstr ""
  87. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:25
  88. msgid "Note that the room must be unencrypted."
  89. msgstr ""
  90. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29
  91. msgid ""
  92. "The management room has to be given an alias and be public when you are "
  93. "setting up the bot for the first time as the bot does not differentiate "
  94. "between invites and invites to the management room."
  95. msgstr ""
  96. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:31
  97. msgid ""
  98. "This management room is used to control who has access to your D4A "
  99. "deployment. The room stores this data inside of the control room state so"
  100. " your bot must have sufficient powerlevel to send custom state events. "
  101. "This is default 50 or moderator as Element clients call this powerlevel."
  102. msgstr ""
  103. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:33
  104. msgid ""
  105. "As noted in the Draupnir install instructions the control room is "
  106. "sensitive. **Anyone in this room can control the bot so it is important "
  107. "that you only invite trusted users to this room.**"
  108. msgstr ""
  109. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:35
  110. msgid "Set an alias to the management room"
  111. msgstr ""
  112. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:37
  113. msgid "Next, set an alias to the management room."
  114. msgstr ""
  115. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:39
  116. msgid ""
  117. "This alias can be anything you want. However, for increased security "
  118. "during the setup phase, it is recommended to make this alias be a random "
  119. "string. When it has been locked down after setup phase, you can give your"
  120. " room a secondary human readable alias."
  121. msgstr ""
  122. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:41
  123. msgid "Adjusting the playbook configuration"
  124. msgstr ""
  125. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:43
  126. msgid ""
  127. "Add the following configuration to your "
  128. "`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
  129. "replace `MANAGEMENT_ROOM_ALIAS_HERE`."
  130. msgstr ""
  131. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:51
  132. msgid "Extending the configuration"
  133. msgstr ""
  134. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:53
  135. msgid ""
  136. "You can configure additional options by adding the "
  137. "`matrix_appservice_draupnir_for_all_extension_yaml` variable."
  138. msgstr ""
  139. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:55
  140. msgid ""
  141. "For example, to change Draupnir's `protectAllJoinedRooms` option to "
  142. "`true`, add the following configuration to your "
  143. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  144. msgstr ""
  145. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69
  146. msgid ""
  147. "You can refer to the upstream [documentation](https://github.com/the-"
  148. "draupnir-project/Draupnir) for more configuration documentation."
  149. msgstr ""
  150. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71
  151. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:86
  152. msgid "**Notes**:"
  153. msgstr ""
  154. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73
  155. msgid ""
  156. "The playbook ships a full copy of the example config that does transfer "
  157. "to provisioned Draupnirs in the production-bots.yaml.j2 file in the "
  158. "template directory of the role."
  159. msgstr ""
  160. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75
  161. msgid ""
  162. "Config extension does not affect the appservices config as this config is"
  163. " not extensible in current Draupnir anyway. It instead touches the config"
  164. " passed to the Draupnirs that your Appservice creates. So the example "
  165. "above (`protectAllJoinedRooms: true`) makes all provisioned Draupnirs "
  166. "protect all joined rooms."
  167. msgstr ""
  168. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77
  169. msgid "Installing"
  170. msgstr ""
  171. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79
  172. msgid ""
  173. "After configuring the playbook, run it with [playbook tags](playbook-"
  174. "tags.md) as below:"
  175. msgstr ""
  176. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:88
  177. msgid ""
  178. "The `ensure-matrix-users-created` playbook tag makes the playbook "
  179. "automatically create the bot's user account."
  180. msgstr ""
  181. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:90
  182. msgid ""
  183. "The shortcut commands with the [`just` program](just.md) are also "
  184. "available: `just install-all` or `just setup-all`"
  185. msgstr ""
  186. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:92
  187. msgid ""
  188. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
  189. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
  190. "runtime) than `just setup-all`) when its components remain unchanged. If "
  191. "you adjust your `vars.yml` to remove other components, you'd need to run "
  192. "`just setup-all`, or these components will still remain installed."
  193. msgstr ""
  194. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:94
  195. msgid "Usage"
  196. msgstr ""
  197. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:96
  198. msgid ""
  199. "If you made it through all the steps above and your main control room was"
  200. " joined by a user called `@draupnir-main:example.com` you have "
  201. "succesfully installed Draupnir for All and can now start using it."
  202. msgstr ""
  203. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:98
  204. msgid ""
  205. "The installation of Draupnir for all in this playbook is very much Alpha "
  206. "quality. Usage-wise, Draupnir for all is almost identical to Draupnir bot"
  207. " mode."
  208. msgstr ""
  209. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:100
  210. msgid "Granting Users the ability to use D4A"
  211. msgstr ""
  212. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:102
  213. msgid ""
  214. "Draupnir for all includes several security measures like that it only "
  215. "allows users that are on its allow list to ask for a bot. To add a user "
  216. "to this list we have 2 primary options. Using the chat to tell Draupnir "
  217. "to do this for us or if you want to automatically do it by sending "
  218. "`m.policy.rule.user` events that target the subject you want to allow "
  219. "provisioning for with the `org.matrix.mjolnir.allow` recomendation. Using"
  220. " the chat is recomended."
  221. msgstr ""
  222. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:104
  223. msgid ""
  224. "The bot requires a powerlevel of 50 in the management room to control who"
  225. " is allowed to use the bot. The bot does currently not say anything if "
  226. "this is true or false. (This is considered a bug and is documented in "
  227. "issue [#297](https://github.com/the-draupnir-"
  228. "project/Draupnir/issues/297))"
  229. msgstr ""
  230. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:106
  231. msgid ""
  232. "To allow users or whole homeservers you type /plain @draupnir-"
  233. "main:example.com allow `target` and target can be either a MXID or a "
  234. "wildcard like `@*:example.com` to allow all users on example.com to "
  235. "register. We use /plain to force the client to not attempt to mess with "
  236. "this command as it can break Wildcard commands especially."
  237. msgstr ""
  238. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:108
  239. msgid "How to provision a D4A once you are allowed to"
  240. msgstr ""
  241. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:110
  242. msgid ""
  243. "To provision a D4A, you need to start a chat with `@draupnir-"
  244. "main:example.com`. The bot will reject this invite and you will shortly "
  245. "get invited to the Draupnir control room for your newly provisioned "
  246. "Draupnir. From here its just a normal Draupnir experience."
  247. msgstr ""
  248. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:112
  249. msgid ""
  250. "Congratulations if you made it all the way here because you now have a "
  251. "fully working Draupnir for all deployment."
  252. msgstr ""
  253. #~ msgid "Installation"
  254. #~ msgstr ""
  255. #~ msgid "Create a main management room."
  256. #~ msgstr ""
  257. #~ msgid ""
  258. #~ "The playbook does not create a "
  259. #~ "management room for your Main Draupnir."
  260. #~ " This task you have to do on"
  261. #~ " your own."
  262. #~ msgstr ""
  263. #~ msgid ""
  264. #~ "As noted in the Draupnir install "
  265. #~ "instructions the control room is "
  266. #~ "sensitive. The following is said about"
  267. #~ " the control room in the Draupnir "
  268. #~ "install instructions."
  269. #~ msgstr ""
  270. #~ msgid ""
  271. #~ "Anyone in this room can control "
  272. #~ "the bot so it is important that"
  273. #~ " you only invite trusted users to "
  274. #~ "this room. The room must be "
  275. #~ "unencrypted since the playbook does not"
  276. #~ " support installing Pantalaimon yet."
  277. #~ msgstr ""
  278. #~ msgid "Give your main management room an alias."
  279. #~ msgstr ""
  280. #~ msgid ""
  281. #~ "Give the room from step 1 an "
  282. #~ "alias. This alias can be anything "
  283. #~ "you want and its recommended for "
  284. #~ "increased security during the setup "
  285. #~ "phase of the bot that you make "
  286. #~ "this alias be a random string. You"
  287. #~ " can give your room a secondary "
  288. #~ "human readable alias when it has "
  289. #~ "been locked down after setup phase."
  290. #~ msgstr ""
  291. #~ msgid "Adjusting the playbook configuration."
  292. #~ msgstr ""
  293. #~ msgid ""
  294. #~ "Add the following configuration to your"
  295. #~ " `inventory/host_vars/matrix.example.com/vars.yml` file "
  296. #~ "(adapt to your needs):"
  297. #~ msgstr ""
  298. #~ msgid ""
  299. #~ "You must replace `ALIAS_FROM_STEP_2_GOES_HERE` "
  300. #~ "with the alias you created in step"
  301. #~ " 2."
  302. #~ msgstr ""
  303. #~ msgid ""
  304. #~ "The installation of Draupnir for all "
  305. #~ "in this playbook is very much "
  306. #~ "Alpha quality. Usage-wise, Draupnir for"
  307. #~ " allis almost identical to Draupnir "
  308. #~ "bot mode."
  309. #~ msgstr ""
  310. #~ msgid "How to provision a D4A once you are allowed to."
  311. #~ msgstr ""
  312. #~ msgid ""
  313. #~ "Open a DM with @draupnir-"
  314. #~ "main:example.com and if using an Element"
  315. #~ " client send a message into this "
  316. #~ "DM to finalise creating it. The "
  317. #~ "bot will reject this invite and "
  318. #~ "you will shortly get invited to "
  319. #~ "the Draupnir control room for your "
  320. #~ "newly provisioned Draupnir. From here "
  321. #~ "its just a normal Draupnir experience."
  322. #~ msgstr ""
  323. #~ msgid "Configuration of D4A"
  324. #~ msgstr ""
  325. #~ msgid ""
  326. #~ "You can refer to the upstream "
  327. #~ "[documentation](https://github.com/the-draupnir-"
  328. #~ "project/Draupnir) for more configuration "
  329. #~ "documentation. Please note that the "
  330. #~ "playbook ships a full copy of the"
  331. #~ " example config that does transfer to"
  332. #~ " provisioned Draupnirs in the "
  333. #~ "production-bots.yaml.j2 file in the "
  334. #~ "template directory of the role."
  335. #~ msgstr ""
  336. #~ msgid ""
  337. #~ "Please note that Config extension does"
  338. #~ " not affect the appservices config as"
  339. #~ " this config is not extensible in "
  340. #~ "current Draupnir anyways. Config extension "
  341. #~ "instead touches the config passed to "
  342. #~ "the Draupnirs that your Appservice "
  343. #~ "creates. So for example below makes "
  344. #~ "all provisioned Draupnirs protect all "
  345. #~ "joined rooms."
  346. #~ msgstr ""
  347. #~ msgid ""
  348. #~ "You can configure additional options by"
  349. #~ " adding the "
  350. #~ "`matrix_appservice_draupnir_for_all_extension_yaml` variable "
  351. #~ "to your `inventory/host_vars/matrix.example.com/vars.yml`"
  352. #~ " file."
  353. #~ msgstr ""
  354. #~ msgid ""
  355. #~ "For example to change Draupnir's "
  356. #~ "`protectAllJoinedRooms` option to `true` you"
  357. #~ " would add the following to your "
  358. #~ "`vars.yml` file."
  359. #~ msgstr ""