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.
 
 

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