# 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 , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-12-16 12:05+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" "Language-Team: jp \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-email2matrix.md:1 msgid "Setting up Email2Matrix (optional)" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:3 msgid "" "**Note**: email bridging can also happen via the [Postmoogle" "](configuring-playbook-bridge-postmoogle.md) bridge supported by the " "playbook. Postmoogle is much more powerful and easier to use, so we " "recommend that you use it, instead of Email2Matrix." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:5 msgid "" "The playbook can install and configure " "[email2matrix](https://github.com/devture/email2matrix) for you." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:7 msgid "" "See the project's " "[documentation](https://github.com/devture/email2matrix/blob/master/docs/README.md)" " to learn what it does and why it might be useful to you." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:9 msgid "Preparation" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:11 msgid "DNS configuration" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:13 msgid "" "It's not strictly necessary, but you may increase the chances that " "incoming emails reach your server by adding an `MX` record for " "`matrix.example.com`, as described in the [Configuring DNS](configuring-" "dns.md) documentation page." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:15 msgid "Port availability" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:17 msgid "" "Ensure that port 25 is available on your Matrix server and open in your " "firewall." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:19 msgid "" "If you have `postfix` or some other email server software installed, you " "may need to manually remove it first (unless you need it, of course)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:21 msgid "" "If you really need to run an email server on the Matrix machine for other" " purposes, it may be possible to run Email2Matrix on another port (with a" " configuration like `matrix_email2matrix_smtp_host_bind_port: " "\"127.0.0.01:2525\"`) and have your other email server relay messages " "there." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:23 msgid "" "For details about using Email2Matrix alongside " "[Postfix](http://www.postfix.org/), see " "[here](https://github.com/devture/email2matrix/blob/master/docs/setup_with_postfix.md)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:25 msgid "Creating a user" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:27 msgid "" "Before enabling Email2Matrix, you'd most likely wish to create a " "dedicated user (or more) that would be sending messages on the Matrix " "side. Take note of the user's ID as it needs to be specified as " "`MatrixUserId` on your `inventory/host_vars/matrix.example.com/vars.yml` " "file later." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:29 msgid "" "Refer to [Registering users](registering-users.md) for ways to create a " "user. A regular (non-admin) user works best." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:31 msgid "Creating a shared room" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:33 msgid "" "After creating the sender user, you should create one or more Matrix " "rooms that you share with that user. It doesn't matter who creates and " "owns the rooms and who joins later (you or the sender user)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:35 msgid "" "What matters is that both you and the sender user are part of the same " "room and that the sender user has enough privileges in the room to be " "able to send messages there." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:37 msgid "Inviting additional people to the room is okay too." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:39 msgid "" "Take note of each room's room ID (different clients show the room ID in a" " different place). You'll need the room ID when [configuring the playbook" "](#adjusting-the-playbook-configuration) below." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:41 msgid "Obtaining an access token for the sender user" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:43 msgid "" "In order for the sender user created above to be able to send messages to" " the room, we'll need to obtain an access token for it. Refer to the " "documentation on [how to obtain an access token](obtaining-access-" "tokens.md)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:45 msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:47 msgid "" "After doing the preparation steps above, add the following configuration " "to your `inventory/host_vars/matrix.example.com/vars.yml` file (adapt to " "your needs):" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:72 msgid "where:" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:74 msgid "" "MailboxName - local-part of the email address, through which emails are " "bridged to the room whose ID is defined with MatrixRoomId" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:75 msgid "" "MatrixRoomId - internal ID of the room, to which received emails are sent" " as Matrix message" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:76 msgid "" "MatrixHomeserverUrl - URL of your Matrix homeserver, through which to " "send Matrix messages. You can also set `MatrixHomeserverUrl` to the " "container URL where your homeserver's Client-Server API lives by using " "the `{{ matrix_addons_homeserver_client_api_url }}` variable" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:77 msgid "" "MatrixUserId - the full ID of the sender user which sends bridged " "messages to the room. On this configuration it is " "`@email2matrix1:example.com` and `@email2matrix2:example.com` (where " "`example.com` is your base domain, not the `matrix.` domain)" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:78 msgid "MatrixAccessToken - sender user's access token" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:79 msgid "IgnoreSubject - if set to \"true\", the subject is not bridged to Matrix" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:80 msgid "IgnoreBody - if set to \"true\", the message body is not bridged to Matrix" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:81 msgid "" "SkipMarkdown - if set to \"true\", emails are bridged as plain text " "Matrix message instead of Markdown (actually HTML)" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:83 msgid "" "Refer to the official documentation " "[here](https://github.com/devture/email2matrix/blob/master/docs/configuration.md)." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:85 msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:87 msgid "" "To enable Email2Matrix, run the playbook with [playbook tags](playbook-" "tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:93 msgid "**Notes**:" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:95 msgid "" "The shortcut commands with the [`just` program](just.md) are also " "available: `just run-tags setup-email2matrix,start` or `just setup-all`" msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:97 msgid "" "`just run-tags setup-email2matrix,start` is useful for maintaining your " "setup quickly 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. Note `just setup-" "all` runs the `ensure-matrix-users-created` tag too." msgstr "" #: ../../../docs/configuring-playbook-email2matrix.md:99 msgid "" "After installation, you may wish to send a test email to the email " "address assigned to `mailbox1` (default: `mailbox1@matrix.example.com`) " "to make sure that Email2Matrix works as expected." msgstr ""