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.
 
 

299 lines
11 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-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. #: ../../../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 "Installation"
  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. "This task you have to do on your own."
  86. msgstr ""
  87. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:25
  88. msgid ""
  89. "The management room has to be given an alias and be public when you are "
  90. "setting up the bot for the first time as the bot does not differentiate "
  91. "between invites and invites to the management room."
  92. msgstr ""
  93. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:27
  94. msgid ""
  95. "This management room is used to control who has access to your D4A "
  96. "deployment. The room stores this data inside of the control room state so"
  97. " your bot must have sufficient powerlevel to send custom state events. "
  98. "This is default 50 or moderator as Element clients call this powerlevel."
  99. msgstr ""
  100. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29
  101. msgid ""
  102. "As noted in the Draupnir install instructions the control room is "
  103. "sensitive. The following is said about the control room in the Draupnir "
  104. "install instructions."
  105. msgstr ""
  106. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:30
  107. msgid ""
  108. "Anyone in this room can control the bot so it is important that you only "
  109. "invite trusted users to this room. The room must be unencrypted since the"
  110. " playbook does not support installing Pantalaimon yet."
  111. msgstr ""
  112. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:32
  113. msgid "Give your main management room an alias."
  114. msgstr ""
  115. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:34
  116. msgid ""
  117. "Give the room from step 1 an alias. This alias can be anything you want "
  118. "and its recommended for increased security during the setup phase of the "
  119. "bot that you make this alias be a random string. You can give your room a"
  120. " secondary human readable alias when it has been locked down after setup "
  121. "phase."
  122. msgstr ""
  123. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:36
  124. msgid "Adjusting the playbook configuration."
  125. msgstr ""
  126. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:38
  127. msgid ""
  128. "Add the following configuration to your "
  129. "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
  130. "needs):"
  131. msgstr ""
  132. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:40
  133. msgid ""
  134. "You must replace `ALIAS_FROM_STEP_2_GOES_HERE` with the alias you created"
  135. " in step 2."
  136. msgstr ""
  137. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:48
  138. msgid "Installing"
  139. msgstr ""
  140. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:50
  141. msgid ""
  142. "After configuring the playbook, run it with [playbook tags](playbook-"
  143. "tags.md) as below:"
  144. msgstr ""
  145. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:57
  146. msgid "**Notes**:"
  147. msgstr ""
  148. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:59
  149. msgid ""
  150. "The `ensure-matrix-users-created` playbook tag makes the playbook "
  151. "automatically create the bot's user account."
  152. msgstr ""
  153. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:61
  154. msgid ""
  155. "The shortcut commands with the [`just` program](just.md) are also "
  156. "available: `just install-all` or `just setup-all`"
  157. msgstr ""
  158. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:63
  159. msgid ""
  160. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
  161. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
  162. "runtime) than `just setup-all`) when its components remain unchanged. If "
  163. "you adjust your `vars.yml` to remove other components, you'd need to run "
  164. "`just setup-all`, or these components will still remain installed."
  165. msgstr ""
  166. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:65
  167. msgid "Usage"
  168. msgstr ""
  169. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:67
  170. msgid ""
  171. "If you made it through all the steps above and your main control room was"
  172. " joined by a user called `@draupnir-main:example.com` you have "
  173. "succesfully installed Draupnir for All and can now start using it."
  174. msgstr ""
  175. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69
  176. msgid ""
  177. "The installation of Draupnir for all in this playbook is very much Alpha "
  178. "quality. Usage-wise, Draupnir for allis almost identical to Draupnir bot "
  179. "mode."
  180. msgstr ""
  181. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71
  182. msgid "Granting Users the ability to use D4A"
  183. msgstr ""
  184. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73
  185. msgid ""
  186. "Draupnir for all includes several security measures like that it only "
  187. "allows users that are on its allow list to ask for a bot. To add a user "
  188. "to this list we have 2 primary options. Using the chat to tell Draupnir "
  189. "to do this for us or if you want to automatically do it by sending "
  190. "`m.policy.rule.user` events that target the subject you want to allow "
  191. "provisioning for with the `org.matrix.mjolnir.allow` recomendation. Using"
  192. " the chat is recomended."
  193. msgstr ""
  194. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75
  195. msgid ""
  196. "The bot requires a powerlevel of 50 in the management room to control who"
  197. " is allowed to use the bot. The bot does currently not say anything if "
  198. "this is true or false. (This is considered a bug and is documented in "
  199. "issue [#297](https://github.com/the-draupnir-"
  200. "project/Draupnir/issues/297))"
  201. msgstr ""
  202. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77
  203. msgid ""
  204. "To allow users or whole homeservers you type /plain @draupnir-"
  205. "main:example.com allow `target` and target can be either a MXID or a "
  206. "wildcard like `@*:example.com` to allow all users on example.com to "
  207. "register. We use /plain to force the client to not attempt to mess with "
  208. "this command as it can break Wildcard commands especially."
  209. msgstr ""
  210. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79
  211. msgid "How to provision a D4A once you are allowed to."
  212. msgstr ""
  213. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:81
  214. msgid ""
  215. "Open a DM with @draupnir-main:example.com and if using an Element client "
  216. "send a message into this DM to finalise creating it. The bot will reject "
  217. "this invite and you will shortly get invited to the Draupnir control room"
  218. " for your newly provisioned Draupnir. From here its just a normal "
  219. "Draupnir experience."
  220. msgstr ""
  221. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:83
  222. msgid ""
  223. "Congratulations if you made it all the way here because you now have a "
  224. "fully working Draupnir for all deployment."
  225. msgstr ""
  226. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:85
  227. msgid "Configuration of D4A"
  228. msgstr ""
  229. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:87
  230. msgid ""
  231. "You can refer to the upstream [documentation](https://github.com/the-"
  232. "draupnir-project/Draupnir) for more configuration documentation. Please "
  233. "note that the playbook ships a full copy of the example config that does "
  234. "transfer to provisioned Draupnirs in the production-bots.yaml.j2 file in "
  235. "the template directory of the role."
  236. msgstr ""
  237. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:89
  238. msgid ""
  239. "Please note that Config extension does not affect the appservices config "
  240. "as this config is not extensible in current Draupnir anyways. Config "
  241. "extension instead touches the config passed to the Draupnirs that your "
  242. "Appservice creates. So for example below makes all provisioned Draupnirs "
  243. "protect all joined rooms."
  244. msgstr ""
  245. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:91
  246. msgid ""
  247. "You can configure additional options by adding the "
  248. "`matrix_appservice_draupnir_for_all_extension_yaml` variable to your "
  249. "`inventory/host_vars/matrix.example.com/vars.yml` file."
  250. msgstr ""
  251. #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:93
  252. msgid ""
  253. "For example to change Draupnir's `protectAllJoinedRooms` option to `true`"
  254. " you would add the following to your `vars.yml` file."
  255. msgstr ""