|
- # SOME DESCRIPTIVE TITLE.
- # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
- # members
- # This file is distributed under the same license as the
- # matrix-docker-ansible-deploy package.
- # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
- #
- #, fuzzy
- msgid ""
- msgstr ""
- "Project-Id-Version: matrix-docker-ansible-deploy \n"
- "Report-Msgid-Bugs-To: \n"
- "POT-Creation-Date: 2024-12-20 09:53+0200\n"
- "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
- "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
- "Language: bg\n"
- "Language-Team: bg <LL@li.org>\n"
- "Plural-Forms: nplurals=2; plural=(n != 1);\n"
- "MIME-Version: 1.0\n"
- "Content-Type: text/plain; charset=utf-8\n"
- "Content-Transfer-Encoding: 8bit\n"
- "Generated-By: Babel 2.16.0\n"
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:1
- msgid "Setting up Draupnir for All/D4A (optional)"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:3
- msgid ""
- "The playbook can install and configure the [Draupnir](https://github.com"
- "/the-draupnir-project/Draupnir) moderation tool for you in appservice "
- "mode."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:5
- msgid ""
- "Appservice mode can be used together with the regular [Draupnir bot"
- "](configuring-playbook-bot-draupnir.md) or independently. Details about "
- "the differences between the 2 modes are described below."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:7
- msgid "Draupnir Appservice mode compared to Draupnir bot mode"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:9
- msgid ""
- "The administrative functions for managing the appservice are alpha "
- "quality and very limited. However, the experience of using an appservice-"
- "provisioned Draupnir is on par with the experience of using Draupnir from"
- " bot mode except in the case of avatar customisation as described later "
- "on in this document."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:11
- msgid ""
- "Draupnir for all is the way to go if you need more than 1 Draupnir "
- "instance, but you don't need access to Synapse Admin features as they are"
- " not accessible through Draupnir for All (Even though the commands do "
- "show up in help)."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:13
- msgid ""
- "Draupnir for all in the playbook is rate-limit-exempt automatically as "
- "its appservice configuration file does not specify any rate limits."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:15
- msgid ""
- "Normal Draupnir does come with the benefit of access to Synapse Admin "
- "features. You are also able to more easily customise your normal Draupnir"
- " than D4A as D4A even on the branch with the Avatar command (To be "
- "Upstreamed to Mainline Draupnir) that command is clunky as it requires "
- "the use of things like Element Web devtools. In normal Draupnir this is a"
- " quick operation where you login to Draupnir with a normal client and set"
- " Avatar and Display name normally."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:17
- msgid ""
- "Draupnir for all does not support external tooling like "
- "[MRU](https://mru.rory.gay) as it can't access Draupnir's user account."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:19
- msgid "Prerequisites"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:21
- msgid "Create a main management room"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:23
- msgid ""
- "The playbook does not create a management room for your Main Draupnir. "
- "You **need to create the room manually** before setting up the bot."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:25
- msgid "Note that the room must be unencrypted."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29
- msgid ""
- "The management room has to be given an alias and be public when you are "
- "setting up the bot for the first time as the bot does not differentiate "
- "between invites and invites to the management room."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:31
- msgid ""
- "This management room is used to control who has access to your D4A "
- "deployment. The room stores this data inside of the control room state so"
- " your bot must have sufficient powerlevel to send custom state events. "
- "This is default 50 or moderator as Element clients call this powerlevel."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:33
- msgid ""
- "As noted in the Draupnir install instructions the control room is "
- "sensitive. **Anyone in this room can control the bot so it is important "
- "that you only invite trusted users to this room.**"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:35
- msgid "Set an alias to the management room"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:37
- msgid "Next, set an alias to the management room."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:39
- msgid ""
- "This alias can be anything you want. However, for increased security "
- "during the setup phase, it is recommended to make this alias be a random "
- "string. When it has been locked down after setup phase, you can give your"
- " room a secondary human readable alias."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:41
- msgid "Adjusting the playbook configuration"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:43
- msgid ""
- "Add the following configuration to your "
- "`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
- "replace `MANAGEMENT_ROOM_ALIAS_HERE`."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:51
- msgid "Extending the configuration"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:53
- msgid ""
- "You can configure additional options by adding the "
- "`matrix_appservice_draupnir_for_all_extension_yaml` variable."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:55
- msgid ""
- "For example, to change Draupnir's `protectAllJoinedRooms` option to "
- "`true`, add the following configuration to your "
- "`inventory/host_vars/matrix.example.com/vars.yml` file:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69
- msgid ""
- "You can refer to the upstream [documentation](https://github.com/the-"
- "draupnir-project/Draupnir) for more configuration documentation."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:86
- msgid "**Notes**:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73
- msgid ""
- "The playbook ships a full copy of the example config that does transfer "
- "to provisioned Draupnirs in the production-bots.yaml.j2 file in the "
- "template directory of the role."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75
- msgid ""
- "Config extension does not affect the appservices config as this config is"
- " not extensible in current Draupnir anyway. It instead touches the config"
- " passed to the Draupnirs that your Appservice creates. So the example "
- "above (`protectAllJoinedRooms: true`) makes all provisioned Draupnirs "
- "protect all joined rooms."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77
- msgid "Installing"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79
- msgid ""
- "After configuring the playbook, run it with [playbook tags](playbook-"
- "tags.md) as below:"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:88
- msgid ""
- "The `ensure-matrix-users-created` playbook tag makes the playbook "
- "automatically create the bot's user account."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:90
- msgid ""
- "The shortcut commands with the [`just` program](just.md) are also "
- "available: `just install-all` or `just setup-all`"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:92
- msgid ""
- "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
- "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
- "runtime) than `just setup-all`) when its components remain unchanged. If "
- "you adjust your `vars.yml` to remove other components, you'd need to run "
- "`just setup-all`, or these components will still remain installed."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:94
- msgid "Usage"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:96
- msgid ""
- "If you made it through all the steps above and your main control room was"
- " joined by a user called `@draupnir-main:example.com` you have "
- "succesfully installed Draupnir for All and can now start using it."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:98
- msgid ""
- "The installation of Draupnir for all in this playbook is very much Alpha "
- "quality. Usage-wise, Draupnir for all is almost identical to Draupnir bot"
- " mode."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:100
- msgid "Granting Users the ability to use D4A"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:102
- msgid ""
- "Draupnir for all includes several security measures like that it only "
- "allows users that are on its allow list to ask for a bot. To add a user "
- "to this list we have 2 primary options. Using the chat to tell Draupnir "
- "to do this for us or if you want to automatically do it by sending "
- "`m.policy.rule.user` events that target the subject you want to allow "
- "provisioning for with the `org.matrix.mjolnir.allow` recomendation. Using"
- " the chat is recomended."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:104
- msgid ""
- "The bot requires a powerlevel of 50 in the management room to control who"
- " is allowed to use the bot. The bot does currently not say anything if "
- "this is true or false. (This is considered a bug and is documented in "
- "issue [#297](https://github.com/the-draupnir-"
- "project/Draupnir/issues/297))"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:106
- msgid ""
- "To allow users or whole homeservers you type /plain @draupnir-"
- "main:example.com allow `target` and target can be either a MXID or a "
- "wildcard like `@*:example.com` to allow all users on example.com to "
- "register. We use /plain to force the client to not attempt to mess with "
- "this command as it can break Wildcard commands especially."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:108
- msgid "How to provision a D4A once you are allowed to"
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:110
- msgid ""
- "To provision a D4A, you need to start a chat with `@draupnir-"
- "main:example.com`. The bot will reject this invite and you will shortly "
- "get invited to the Draupnir control room for your newly provisioned "
- "Draupnir. From here its just a normal Draupnir experience."
- msgstr ""
-
- #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:112
- msgid ""
- "Congratulations if you made it all the way here because you now have a "
- "fully working Draupnir for all deployment."
- msgstr ""
-
- #~ msgid "Installation"
- #~ msgstr ""
-
- #~ msgid "Create a main management room."
- #~ msgstr ""
-
- #~ msgid ""
- #~ "The playbook does not create a "
- #~ "management room for your Main Draupnir."
- #~ " This task you have to do on"
- #~ " your own."
- #~ msgstr ""
-
- #~ msgid ""
- #~ "As noted in the Draupnir install "
- #~ "instructions the control room is "
- #~ "sensitive. The following is said about"
- #~ " the control room in the Draupnir "
- #~ "install instructions."
- #~ msgstr ""
-
- #~ msgid ""
- #~ "Anyone in this room can control "
- #~ "the bot so it is important that"
- #~ " you only invite trusted users to "
- #~ "this room. The room must be "
- #~ "unencrypted since the playbook does not"
- #~ " support installing Pantalaimon yet."
- #~ msgstr ""
-
- #~ msgid "Give your main management room an alias."
- #~ msgstr ""
-
- #~ msgid ""
- #~ "Give the room from step 1 an "
- #~ "alias. This alias can be anything "
- #~ "you want and its recommended for "
- #~ "increased security during the setup "
- #~ "phase of the bot that you make "
- #~ "this alias be a random string. You"
- #~ " can give your room a secondary "
- #~ "human readable alias when it has "
- #~ "been locked down after setup phase."
- #~ msgstr ""
-
- #~ msgid "Adjusting the playbook configuration."
- #~ msgstr ""
-
- #~ msgid ""
- #~ "Add the following configuration to your"
- #~ " `inventory/host_vars/matrix.example.com/vars.yml` file "
- #~ "(adapt to your needs):"
- #~ msgstr ""
-
- #~ msgid ""
- #~ "You must replace `ALIAS_FROM_STEP_2_GOES_HERE` "
- #~ "with the alias you created in step"
- #~ " 2."
- #~ msgstr ""
-
- #~ msgid ""
- #~ "The installation of Draupnir for all "
- #~ "in this playbook is very much "
- #~ "Alpha quality. Usage-wise, Draupnir for"
- #~ " allis almost identical to Draupnir "
- #~ "bot mode."
- #~ msgstr ""
-
- #~ msgid "How to provision a D4A once you are allowed to."
- #~ msgstr ""
-
- #~ msgid ""
- #~ "Open a DM with @draupnir-"
- #~ "main:example.com and if using an Element"
- #~ " client send a message into this "
- #~ "DM to finalise creating it. The "
- #~ "bot will reject this invite and "
- #~ "you will shortly get invited to "
- #~ "the Draupnir control room for your "
- #~ "newly provisioned Draupnir. From here "
- #~ "its just a normal Draupnir experience."
- #~ msgstr ""
-
- #~ msgid "Configuration of D4A"
- #~ msgstr ""
-
- #~ msgid ""
- #~ "You can refer to the upstream "
- #~ "[documentation](https://github.com/the-draupnir-"
- #~ "project/Draupnir) for more configuration "
- #~ "documentation. Please note that the "
- #~ "playbook ships a full copy of the"
- #~ " example config that does transfer to"
- #~ " provisioned Draupnirs in the "
- #~ "production-bots.yaml.j2 file in the "
- #~ "template directory of the role."
- #~ msgstr ""
-
- #~ msgid ""
- #~ "Please note that Config extension does"
- #~ " not affect the appservices config as"
- #~ " this config is not extensible in "
- #~ "current Draupnir anyways. Config extension "
- #~ "instead touches the config passed to "
- #~ "the Draupnirs that your Appservice "
- #~ "creates. So for example below makes "
- #~ "all provisioned Draupnirs protect all "
- #~ "joined rooms."
- #~ msgstr ""
-
- #~ msgid ""
- #~ "You can configure additional options by"
- #~ " adding the "
- #~ "`matrix_appservice_draupnir_for_all_extension_yaml` variable "
- #~ "to your `inventory/host_vars/matrix.example.com/vars.yml`"
- #~ " file."
- #~ msgstr ""
-
- #~ msgid ""
- #~ "For example to change Draupnir's "
- #~ "`protectAllJoinedRooms` option to `true` you"
- #~ " would add the following to your "
- #~ "`vars.yml` file."
- #~ msgstr ""
|