mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-23 13:05:47 +00:00
285 lines
9.4 KiB
Plaintext
285 lines
9.4 KiB
Plaintext
# 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: jp\n"
|
|
"Language-Team: jp <LL@li.org>\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 ""
|
|
"After configuring the playbook, run it with [playbook tags](playbook-"
|
|
"tags.md) as below:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-email2matrix.md:94
|
|
msgid "**Notes**:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-email2matrix.md:96
|
|
msgid ""
|
|
"The shortcut commands with the [`just` program](just.md) are also "
|
|
"available: `just install-service email2matrix` or `just setup-all`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-email2matrix.md:98
|
|
msgid ""
|
|
"`just install-service email2matrix` 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:100
|
|
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 ""
|
|
|
|
#~ msgid ""
|
|
#~ "To enable Email2Matrix, run the playbook"
|
|
#~ " with [playbook tags](playbook-tags.md) as"
|
|
#~ " below:"
|
|
#~ msgstr ""
|
|
|
|
#~ msgid ""
|
|
#~ "The shortcut commands with the [`just`"
|
|
#~ " program](just.md) are also available: "
|
|
#~ "`just run-tags setup-email2matrix,start` "
|
|
#~ "or `just setup-all`"
|
|
#~ msgstr ""
|
|
|
|
#~ 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 ""
|
|
|