Initial work on translations / localization

Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
2025-10-31 07:17:57 +01:00 · 2024-12-20 09:37:38 +02:00
parent 33b493737d
commit d4f8d0918a
413 changed files with 119935 additions and 2 deletions
--- a/i18n/locales/bg/LC_MESSAGES/docs/prerequisites.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/prerequisites.po
@@ -0,0 +1,260 @@
+# 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-16 12:05+0900\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/prerequisites.md:1
+msgid "Prerequisites"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:3
+msgid ""
+"<sup>Prerequisites > [Configuring your DNS settings](configuring-dns.md) "
+"> [Getting the playbook](getting-the-playbook.md) > [Configuring the "
+"playbook](configuring-playbook.md) > [Installing](installing.md)</sup>"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:5
+msgid ""
+"To install Matrix services using this Ansible playbook, you need to "
+"prepare several requirements both on your local computer (where you will "
+"run the playbook to configure the server) and the server (where the "
+"playbook will install the Matrix services for you). **These requirements "
+"need to be set up manually** before proceeding to the next step."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:7
+msgid ""
+"We will be using `example.com` as the domain in the following "
+"instruction. Please remember to replace it with your own domain before "
+"running any commands."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:9
+msgid ""
+"**Note**: if you do not have an existing Matrix server and want to start "
+"quickly with \"opinionated defaults\", we suggest you to follow ⚡ "
+"**[Quick start](quick-start.md)** installation guide."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:11
+msgid "Your local computer"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:13
+msgid ""
+"[Ansible](http://ansible.com/) program. It's used to run this playbook "
+"and configures your server for you. Take a look at [our guide about "
+"Ansible](ansible.md) for more information, as well as [version "
+"requirements](ansible.md#supported-ansible-versions) and alternative ways"
+" to run Ansible."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:15
+msgid ""
+"[passlib](https://passlib.readthedocs.io/en/stable/index.html) Python "
+"library. See [this official "
+"documentation](https://passlib.readthedocs.io/en/stable/install.html"
+"#installation-instructions) for an instruction to install it. On most "
+"distros, you need to install some `python-passlib` or `py3-passlib` "
+"package, etc."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:17
+msgid ""
+"[`git`](https://git-scm.com/) as the recommended way to download the "
+"playbook. `git` may also be required on the server if you will be [self-"
+"building](self-building.md) components."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:19
+msgid ""
+"[`just`](https://github.com/casey/just) for running `just roles`, `just "
+"update`, etc. (see [`justfile`](../justfile)), although you can also run "
+"these commands manually. Take at look at this documentation for more "
+"information: [Running `just` commands](just.md)."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:21
+msgid ""
+"Strong password (random strings) generator. The playbook often requires "
+"you to create a strong password and use it for settings on `vars.yml`, "
+"components, etc. As any tools should be fine, this playbook has adopted "
+"[`pwgen`](https://linux.die.net/man/1/pwgen) (running `pwgen -s 64 1`). "
+"[Password Tech](https://pwgen-win.sourceforge.io/), formerly known as "
+"\"PWGen for Windows\", is available as free and open source password "
+"generator for Windows. Generally, using a random generator available on "
+"the internet is not recommended."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:23
+msgid "Server"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:25
+msgid ""
+"(Recommended) An **x86** server ([What kind of server specs do I "
+"need?](faq.md#what-kind-of-server-specs-do-i-need)) running one of these "
+"operating systems that make use of [systemd](https://systemd.io/):"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:26
+msgid "**Archlinux**"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:27
+msgid ""
+"**CentOS**, **Rocky Linux**, **AlmaLinux**, or possibly other RHEL "
+"alternatives (although your mileage may vary)"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:28
+msgid "**Debian** (10/Buster or newer)"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:29
+msgid ""
+"**Ubuntu** (18.04 or newer, although [20.04 may be "
+"problematic](ansible.md#supported-ansible-versions) if you run the "
+"Ansible playbook on it)"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:31
+msgid ""
+"Generally, newer is better. We only strive to support released stable "
+"versions of distributions, not betas or pre-releases. This playbook can "
+"take over your whole server or co-exist with other services that you have"
+" there."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:33
+msgid ""
+"This playbook somewhat supports running on non-`amd64` architectures like"
+" ARM. See [Alternative Architectures](alternative-architectures.md)."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:35
+msgid ""
+"If your distro runs within an [LXC "
+"container](https://linuxcontainers.org/), you may hit [this "
+"issue](https://github.com/spantaleev/matrix-docker-ansible-"
+"deploy/issues/703). It can be worked around, if absolutely necessary, but"
+" we suggest that you avoid running from within an LXC container."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:37
+msgid ""
+"`root` access to your server (or a user capable of elevating to `root` "
+"via `sudo`)."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:39
+msgid ""
+"[Python](https://www.python.org/). Most distributions install Python by "
+"default, but some don't (e.g. Ubuntu 18.04) and require manual "
+"installation (something like `apt-get install python3`). On some distros,"
+" Ansible may incorrectly [detect the Python "
+"version](https://docs.ansible.com/ansible/latest/reference_appendices/interpreter_discovery.html)"
+" (2 vs 3) and you may need to explicitly specify the interpreter path in "
+"`inventory/hosts` during installation (e.g. "
+"`ansible_python_interpreter=/usr/bin/python3`)"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:41
+msgid ""
+"[sudo](https://www.sudo.ws/), even when you've configured Ansible to log "
+"in as `root`. Some distributions, like a minimal Debian net install, do "
+"not include the `sudo` package by default."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:43
+msgid ""
+"An HTTPS-capable web server at the base domain name (`example.com`) which"
+" is capable of serving static files. Unless you decide to [Serve the base"
+" domain from the Matrix server](configuring-playbook-base-domain-"
+"serving.md) or alternatively, to use DNS SRV records for [Server "
+"Delegation](howto-server-delegation.md)."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:45
+msgid ""
+"Properly configured DNS records for `example.com` (details in "
+"[Configuring DNS](configuring-dns.md))."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:47
+msgid ""
+"Some TCP/UDP ports open. This playbook (actually [Docker "
+"itself](https://docs.docker.com/network/iptables/)) configures the "
+"server's internal firewall for you. In most cases, you don't need to do "
+"anything special. But **if your server is running behind another "
+"firewall**, you'd need to open these ports:"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:49
+msgid "`80/tcp`: HTTP webserver"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:50
+msgid "`443/tcp` and `443/udp`: HTTPS webserver"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:51
+msgid "`3478/tcp`: TURN over TCP (used by Coturn)"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:52
+msgid "`3478/udp`: TURN over UDP (used by Coturn)"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:53
+msgid "`5349/tcp`: TURN over TCP (used by Coturn)"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:54
+msgid "`5349/udp`: TURN over UDP (used by Coturn)"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:55
+msgid ""
+"`8448/tcp` and `8448/udp`: Matrix Federation API HTTPS webserver. In some"
+" cases, this **may necessary even with federation disabled**. Integration"
+" Servers (like Dimension) and Identity Servers (like ma1sd) may need to "
+"access `openid` APIs on the federation port."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:56
+msgid "the range `49152-49172/udp`: TURN over UDP"
+msgstr ""
+
+#: ../../../docs/prerequisites.md:57
+msgid ""
+"potentially some other ports, depending on the additional (non-default) "
+"services that you enable in the **configuring the playbook** step (later "
+"on). Consult each service's documentation page in `docs/` for that."
+msgstr ""
+
+#: ../../../docs/prerequisites.md:61
+msgid ""
+"[▶️](configuring-dns.md) When ready to proceed, continue with "
+"[Configuring DNS](configuring-dns.md)."
+msgstr ""
+