finallycoffee/matrix-docker-ansible-deploy
5
1
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Initial work on translations / localization

Browse Source 
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
This commit is contained in:
Slavi Pantaleev
2024-12-20 09:37:38 +02:00
parent 33b493737d
commit d4f8d0918a
413 changed files with 119935 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
README.md
View File

@@ -198,6 +198,12 @@ When updating the playbook, refer to [the changelog](CHANGELOG.md) to catch up w
- GitHub issues: [spantaleev/matrix-docker-ansible-deploy/issues](https://github.com/spantaleev/matrix-docker-ansible-deploy/issues)
## 🌐 Translation
See the [i18n/README.md](i18n/README.md) file for more information about translation.
Translations are still work in progress.
## 🤝 Related
You may also be interested in [mash-playbook](https://github.com/mother-of-all-self-hosting/mash-playbook) - another Ansible playbook for self-hosting non-Matrix services (see its [List of supported services](https://github.com/mother-of-all-self-hosting/mash-playbook/blob/main/docs/supported-services.md)).

43
conf.py Normal file
View File

@@ -0,0 +1,43 @@
# Configuration file for the Sphinx documentation builder.
# Also see the `i18n/` directory.
#
# For the full list of built-in configuration values, see the documentation:
# https://www.sphinx-doc.org/en/master/usage/configuration.html
# -- Project information -----------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
project = 'matrix-docker-ansible-deploy'
copyright = '2018-%Y, Slavi Pantaleev, Aine Etke, MDAD community members'
author = 'Slavi Pantaleev, Aine Etke, MDAD community members'
# -- General configuration ---------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
needs_sphinx = '8.1' # For the copyright year placeholder (%Y). Specified with pyproject.toml as well.
extensions = [
'myst_parser',
'sphinx_markdown_builder'
]
myst_gfm_only = True
myst_heading_anchors = 4 # https://myst-parser.readthedocs.io/en/latest/syntax/optional.html#auto-generated-header-anchors
master_doc = 'README'
source_suffix = {'.md': 'markdown'}
# Though the default config file advocates exclude_patterns, it is straightforward for us to use include_patterns to select directories explicitly.
include_patterns = [
'docs/*',
'i18n/README.md',
'*.md',
]
locale_dirs = ['i18n/locales/']
gettext_compact = False
# -- Options for HTML output -------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
# html_theme = 'alabaster'
# html_static_path = ['_static']

4
docs/configuring-playbook-matrix-corporal.md
View File

@@ -1,10 +1,10 @@
# Setting up Matrix Corporal (optional, advanced)
-------------------------------------
<hr/>
**WARNING**: This is an advanced feature! It requires prior experience with Matrix and a specific need for using [Matrix Corporal](https://github.com/devture/matrix-corporal). If you're unsure whether you have such a need, you most likely don't.
-------------------------------------
<hr/>
The playbook can install and configure [matrix-corporal](https://github.com/devture/matrix-corporal) for you.

6
i18n/.gitignore vendored Normal file
View File

@@ -0,0 +1,6 @@
.venv/
doctrees
.doctrees/
.mo
/translated/*

0
i18n/PUBLISHED_LANGUAGES Normal file
View File

97
i18n/README.md Normal file
View File

@@ -0,0 +1,97 @@
# Internationalization
Translated documentation files are published and maintained in [`translated/`](translated/) directory.
Currently, we support translation of:
- Markdown files found at the top level project directory
- Markdown files found in the [`docs`](../docs/) directory (this is where the bulk of the documentation is)
- this current document in the `i18n` directory
💡 For readers' sake, we only [publish translations in a new language](#publish-translations-in-a-new-language) when the translation progresses beyond a certain threshold (requiring that at least the project README and core installation guides are translated).
Organization of this `i18n` directory is as follows:
- [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES): a list of languages that we publish translations for (in the [translated/](translated/) directory)
- [.gitignore](.gitignore): a list of files and directories to ignore in the `i18n` directory. We intentionaly ignore translated results (`translated/<language>` directories) for languages taht are still in progress. We only [publish translations in a new language](#publish-translations-in-a-new-language) when the translation progresses beyond a certain threshold.
- [justfile](justfile): a list of recipes for [just](https://github.com/casey/just) command runner
- [requirements.txt](requirements.txt): a list of Python packages required to work with translations
- [translation-templates/](translation-templates/): a list of English translation templates - strings extracted from Markdown files
- [locales/](locales/): localization files for languages
- [translated/](translated/): translated documents for published languages (see [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) and [publish translations in a new language](#publish-translations-in-a-new-language))
## Guide for translators
This project uses [Sphinx](https://www.sphinx-doc.org/) to generate translated documents.
For details about using Sphinx for translation, refer [this official document](https://www.sphinx-doc.org/en/master/usage/advanced/intl.html) as well.
For now, translations are handled manually by editing `.po` files in the `locales/<language>` directory. In the future, we plan on integrating with [Weblate](https://weblate.org/) to allow for translating from a web interface.
### (Recommended) Using the uv package manager and just command runner
If you have the [uv](https://docs.astral.sh/uv/) package manager and [just](https://github.com/casey/just) command runner installed, you can use our [justfile](justfile) recipes to easily manage translation files and build translated documents.
The recipes will use [uv](https://github.com/astral-sh/uv) to auto-create [a Python virtual environment](https://docs.astral.sh/uv/pip/environments/) in the `.venv` directory and install the required Python packages (as per [requirements.txt](requirements.txt)) to it.
#### Preparation
Make sure you have the [uv](https://docs.astral.sh/uv/) package manager and [just](https://github.com/casey/just) command runner installed.
#### Translation
Recommended flow when working on a new language (replace `<language>` with the language code, e.g. `bg`):
- Update the locale files for your language: `just sync-for-language <language>` (internally, this automatically runs `just extract-translation-templates` to make sure the translation templates are up-to-date)
- Use an editor to translate the files in the `locales/<language>` directory
- Build translated documents: `just build-for-language <language>`
- Preview the result in the `translated/<language>` directory
- Commit your changes done to the `locales/<language>` directory
- If you have progressed with the translation beyond a certain threshold, consider [Publishing translations in a new language](#publish-translations-in-a-new-language)
### Using any other package manager and manual scripts
If you cannot use [uv](https://docs.astral.sh/uv/) and/or [just](https://github.com/casey/just), you can:
- manage Python packages in another way ([pip](https://pip.pypa.io/en/stable/), [Poetry](https://python-poetry.org/), etc.)
- manage translation strings and build translated documents manually by invoking scripts from the [bin](bin/) directory
#### Preparation
##### virtualenv and pip
- Create a Python virtual environment in the `.venv` directory: `virtualenv .venv`
- Activate the virtual environment: `source .venv/bin/activate`
- Install the required Python packages using [pip](https://pip.pypa.io/en/stable/): `pip install -r requirements.txt`
#### Translation
Recommended flow when working on a new language (replace `<language>` with the language code, e.g. `bg`):
- Ensure the English translation templates ([translation-templates/](translation-templates/)) are extracted: `./bin/extract-translation-templates.sh`
- Update the locale files for your language: `./bin/sync-translation-templates-to-locales.sh <language>`
- Use an editor to translate the files in the `locales/<language>` directory
- Build translated documents: `./bin/build-translated-result.sh <language>`
- Preview the result in the `translated/<language>` directory
- Commit your changes done to the `locales/<language>` directory
- If you have progressed with the translation beyond a certain threshold, consider [Publishing translations in a new language](#publish-translations-in-a-new-language)
### Publish translations in a new language
To publish prebuilt documents translated in a new language to the `translated/<language>` directory:
- add its language code to the [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) file
- whitelist its `translated/<language>` directory by adding a `!translated/<language>` rule to the [.gitignore](.gitignore) file
💡 Leave a trailing new line at the end of the [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) file.

56
i18n/bin/build-translated-result.sh Executable file
View File

@@ -0,0 +1,56 @@
#!/bin/bash
# This script builds the translated result (translated project) for a given language in the `translated/<language>/` directory.
set -euxo pipefail
if [ $# -ne 1 ]; then
echo "Usage: $0 <language>"
exit 1
fi
LANGUAGE=$1
base_path="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
if [ ! -f ${base_path}/i18n/locales/${LANGUAGE}/LC_MESSAGES/README.po ]; then
echo "Locales for ${LANGUAGE} not found. Please run the `sync-translation-templates-to-locales.sh` script first."
exit 1
fi
# Prepare a clean build directory
if [ -d ${base_path}/i18n/translated-result-build-${LANGUAGE} ]; then
rm -rf ${base_path}/i18n/translated-result-build-${LANGUAGE}
fi
mkdir -p ${base_path}/i18n/translated-result-build-${LANGUAGE}
# Build the translated documentation
sphinx-build \
-b markdown \
-D language="${LANGUAGE}" \
${base_path}/ \
${base_path}/i18n/translated-result-build-${LANGUAGE}
# Clean up .mo files produced during the build.
# We don't commit them to the repository anyway, so they can be left alone,
# but we'd rather keep things clean anyway.
find ${base_path}/i18n/locales/${LANGUAGE} -type f -name '*.mo' -delete
# Clean up the build directory
rm -rf ${base_path}/i18n/translated-result-build-${LANGUAGE}/.doctrees
# Copy assets
cp -r ${base_path}/docs/assets ${base_path}/i18n/translated-result-build-${LANGUAGE}/docs/assets/
# Remove the old result directory for this language
if [ -d ${base_path}/i18n/translated/${LANGUAGE} ]; then
rm -rf ${base_path}/i18n/translated/${LANGUAGE}
fi
# Make sure the `translated/` directory exists
if [ ! -d ${base_path}/i18n/translated ]; then
mkdir -p ${base_path}/i18n/translated
fi
# Relocate the built result to translated/<language>
mv ${base_path}/i18n/translated-result-build-${LANGUAGE} ${base_path}/i18n/translated/${LANGUAGE}

34
i18n/bin/extract-translation-templates.sh Executable file
View File

@@ -0,0 +1,34 @@
#!/bin/bash
# This script extracts translation templates (original English strings) into the `translation-templates/` directory.
# These templates are later used to generate locale files for each language in the `locales/` directory.
#
# By default `sphinx-build` extracts the templates into a `build/gettext` directory, while we'd like to have them in the `translation-templates/` directory.
# To avoid the `POT-Creation-Date` information in templates being updated every time we extract them,
# we restore the `translation-templates/` directory to the `build/gettext` directory before running the script.
set -euxo pipefail
base_path="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
# Restore the `translation-templates/` directory to the `build/gettext` directory
if [ -d ${base_path}/i18n/build ]; then
rm -rf ${base_path}/i18n/build
fi
mkdir -p ${base_path}/i18n/build
cp -r ${base_path}/i18n/translation-templates ${base_path}/i18n/build/gettext
# Extract translation templates from the documentation into the `build/gettext` directory
sphinx-build -M gettext ${base_path} ${base_path}/i18n/build
# Clean up the build directory
rm -rf ${base_path}/i18n/build/gettext/.doctrees
# Update the `translation-templates/` directory with the new templates
if [ -d ${base_path}/i18n/translation-templates ]; then
rm -rf ${base_path}/i18n/translation-templates
fi
mv ${base_path}/i18n/build/gettext ${base_path}/i18n/translation-templates
# Get rid of the `build` directory
rmdir ${base_path}/i18n/build

30
i18n/bin/sync-translation-templates-to-locales.sh Executable file
View File

@@ -0,0 +1,30 @@
#!/bin/bash
# This script updates the translation files (locales/<language>/**/*.po) for a given language.
# It uses the translation templates (translation-templates/**/*.pot) to generate the translation files.
set -euxo pipefail
if [ $# -ne 1 ]; then
echo "Usage: $0 <language>"
exit 1
fi
LANGUAGE=$1
base_path="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
if [ ! -f ${base_path}/i18n/translation-templates/README.pot ]; then
echo "Translation templates not found. Please run the `extract-translation-templates.sh` script first."
exit 1
fi
# Create necessary directories to avoid race conditions caused by
# Sphinx potentially trying to concurrently create them from separate threads below.
mkdir -p ${base_path}/i18n/locales/${LANGUAGE}/LC_MESSAGES/docs
# Update the translation files
sphinx-intl update \
--pot-dir ${base_path}/i18n/translation-templates \
--locale-dir ${base_path}/i18n/locales \
--language ${LANGUAGE}

60
i18n/justfile Normal file
View File

@@ -0,0 +1,60 @@
# Shows help
default:
@just --list --justfile {{ justfile() }}
# Extracts original English strings (translation templates) into the `translation-templates/` directory
extract-translation-templates: _venv
@echo "Extracting translation templates..."
PATH={{ justfile_directory() }}/.venv/bin:$PATH {{ justfile_directory() }}/bin/extract-translation-templates.sh
# Syncs the translation templates (affects `translation-templates/`) and strings (affects `locales/*`) for all published languages (`PUBLISHED_LANGUAGES`)
sync-for-all-published-languages: _venv
#!/bin/sh
cat {{ justfile_directory() }}/PUBLISHED_LANGUAGES | while read language ; do
{{ just_executable() }} sync-for-language $language
done
# Syncs the translation templates (affects `translation-templates/`) and strings for all known languages (`KNOWN_LANGUAGES`)
sync-for-all-known-languages:
#!/bin/sh
find {{ justfile_directory() }}/locales -mindepth 1 -maxdepth 1 -type d | while read path ; do
language=$(basename "$path")
echo "Syncing for language $language.."
{{ just_executable() }} sync-for-language $language
done
# Updates the translation templates (affects `translation-templates/`) and syncs the translation strings for a given language (affects `locales/{{ language }}`)
sync-for-language language: extract-translation-templates (_sync-translation-templates-to-locales-for-language language)
# Updates `locales/{{ language }}` files based on the original template strings from `translation-templates/`
_sync-translation-templates-to-locales-for-language language: _venv
PATH={{ justfile_directory() }}/.venv/bin:$PATH {{ justfile_directory() }}/bin/sync-translation-templates-to-locales.sh {{ language }}
# Builds the translated result for a given language into the `translated/{{ language }}` directory
build-for-language language: _venv
PATH={{ justfile_directory() }}/.venv/bin:$PATH {{ justfile_directory() }}/bin/build-translated-result.sh {{ language }}
# Builds the translated result for all published languages into the `translated/` directory
build-for-all-published-languages:
#!/bin/sh
cat {{ justfile_directory() }}/PUBLISHED_LANGUAGES | while read language ; do
{{ just_executable() }} build-for-language $language
done
# Builds the translated result for all known languages into the `translated/` directory
build-for-all-known-languages:
#!/bin/sh
find {{ justfile_directory() }}/locales -mindepth 1 -maxdepth 1 -type d | while read path ; do
language=$(basename "$path")
echo "Building for language $language.."
{{ just_executable() }} build-for-language $language
done
# Creates the virtual environment and installs the required Python packages
_venv:
#!/bin/sh
if [ ! -f {{ justfile_directory() }}/.venv/bin/sphinx-build ]; then
echo "No sphinx-build found, creating virtual environment and installing requirements..."
uv venv {{ justfile_directory() }}/.venv
VIRTUAL_ENV={{ justfile_directory() }}/.venv uv pip install -r {{ justfile_directory() }}/requirements.txt
fi

11137
i18n/locales/bg/LC_MESSAGES/CHANGELOG.po Normal file
View File

File diff suppressed because it is too large Load Diff

1374
i18n/locales/bg/LC_MESSAGES/README.po Normal file
View File

File diff suppressed because it is too large Load Diff

679
i18n/locales/bg/LC_MESSAGES/YEAR-IN-REVIEW.po Normal file
View File

@@ -0,0 +1,679 @@
# Translations template for PROJECT.
# Copyright (C) 2024 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PROJECT VERSION\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\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-Team: LANGUAGE <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"
#: ../../../YEAR-IN-REVIEW.md:1
msgid "2023"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:3
msgid ""
"2023 was a year filled with many changes for matrix-docker-ansible-"
"deploy. In this post, we're looking backward at some of the major changes"
" that happened this year, as well as taking a glimpse of what's ahead in "
"2024."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:5
msgid ""
"2023 is probably [the year of AI](https://journal.everypixel.com/2023"
"-the-year-of-ai), with millions of people jumping aboard "
"[OpenAI](https://openai.com/)'s [ChatGPT](https://openai.com/chatgpt) "
"train. matrix-docker-ansible-deploy is no stranger to this and 2023 began"
" with a PR from [bertybuttface](https://github.com/bertybuttface) who "
"added support for [matrix-chatgpt-bot](https://github.com/matrixgpt"
"/matrix-chatgpt-bot) (see the [changelog "
"entry](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#chatgpt-support)). While OpenAI's chat GPT website was frequently "
"overloaded in the past, their API was up which made using this bot both "
"convenient and more reliable."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:7
msgid ""
"AI aside, with the playbook's focus being containers, we're **doubling "
"down on being \"container native\"** and becoming more interoperable for "
"people hosting other containers on the Matrix server. In "
"[2022](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/YEAR-IN-"
"REVIEW.md#2022), we've announced a few sibling Ansible playbooks, their "
"use of [Traefik](https://doc.traefik.io/traefik/) and the possiblity of "
"matrix-docker-ansible-deploy also switching to this reverse-proxy. This "
"prediction materialized quickly. The **largest change** in the playbook "
"in 2023 happened way back in February - matrix-docker-ansible-deploy "
"[starting the switch from nginx to Traefik](https://github.com/spantaleev"
"/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#backward-compatibility-reverse-proxy-configuration-changes-and-initial-"
"traefik-support) and then quickly [making Treafik the default reverse-"
"proxy](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#traefik-is-the-default-reverse-proxy-now). As noted in the changelog "
"entries, we envisioned a quick and complete elimination of `matrix-nginx-"
"proxy`, but at the end of 2023, it hasn't happened yet. The playbook is "
"already using Traefik as the front-most reverse-proxy, but nginx (via "
"`matrix-nginx-proxy`) is still around - it has taken a step back and is "
"only used internally for new setups. Work got to a stall due to:"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:9
msgid ""
"complexity: untangling the overly large and messy `matrix-nginx-proxy` "
"component is difficult"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:10
msgid ""
"the current setup became \"good enough\" because nginx has become an "
"internal implementation detail for those who have migrated to Traefik. "
"Traefik is already the default public reverse-proxy and gives better "
"possibilities to people wishing to run other web-exposed containers on "
"their Matrix server via [Docker "
"Compose](https://docs.docker.com/compose/), other Ansible playbooks like "
"[mash-playbook](https://github.com/mother-of-all-self-hosting/mash-"
"playbook) (more about this one, below) or any other way."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:12
msgid ""
"`matrix-nginx-proxy` is no longer in the way of us being interoperable, "
"but its ugly internal details are still there. It is one more proxy in "
"the long chain of reverse-proxies we have and we'd like to cut it out. "
"This would both make things simpler and also boost performance."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:14
msgid ""
"The delay in eliminating `matrix-nginx-proxy` has probably been welcome "
"by many existing users who decided to postpone the Traefik migration a "
"bit longer. In 2024, work on eliminating `matrix-nginx-proxy` will "
"continue with rapid pace. People who are still using `matrix-nginx-proxy`"
" as their front-most reverse-proxy will need to rework their setup. About"
" a year of putting it off has been long enough."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:16
msgid ""
"This large Traefik reverse-proxy change was also accompanied by another "
"internal change which began in 2022, but continued in 2023 - **moving "
"non-Matrix-related roles from being internal to the playbook to living "
"their own life outside of it**. Various roles were made more decoupled "
"and moved outside of the playbook, so that other projects (like the "
"[mash-playbook](https://github.com/mother-of-all-self-hosting/mash-"
"playbook) Ansible playbook or other Ansible playbooks) could benefit from"
" them. This led to the **death of a few sibling playbooks** ([gitea-"
"docker-ansible-deploy](https://github.com/spantaleev/gitea-docker-"
"ansible-deploy), [nextcloud-docker-ansible-"
"deploy](https://github.com/spantaleev/nextcloud-docker-ansible-deploy), "
"[peertube-docker-ansible-deploy](https://github.com/spantaleev/peertube-"
"docker-ansible-deploy), [vaultwarden-docker-ansible-"
"deploy](https://github.com/spantaleev/vaultwarden-docker-ansible-"
"deploy)), but brought life to something better, which supports all these "
"services and more."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:18
msgid ""
"[mash-playbook](https://github.com/mother-of-all-self-hosting/mash-"
"playbook) is a new Ansible playbook that a few of us (matrix-docker-"
"ansible-deploy contributors) have launched in 2023. It has quickly grown "
"to supports [60+ services](https://github.com/mother-of-all-self-hosting"
"/mash-playbook/blob/main/docs/supported-services.md) and aims to do the "
"same for [FOSS](https://en.wikipedia.org/wiki/Free_and_open-"
"source_software) service hosting, as matrix-docker-ansible-deploy has "
"done for Matrix - providing a clean and secure way to run a bunch of "
"services in containers on a regular server (that is to say, without "
"Kubernetes, etc.). Thanks to Traefik and Ansible role reuse, it's easy to"
" host both mash-playbook services and matrix-docker-ansible-deploy "
"services on the same server - see mash-playbook's "
"[interoperability](https://github.com/mother-of-all-self-hosting/mash-"
"playbook/blob/main/docs/interoperability.md) documentation page. If "
"you've been looking for a holiday project or your New Year's Resolutions "
"list contains \"self-hosting more services\", then you're welcome to give"
" this new playbook a try and join its Matrix room ([#mash-"
"playbook:devture.com](https://matrix.to/#/#mash-playbook:devture.com))."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:20
msgid ""
"Because many of the roles are now external to this playbook (defined in "
"the [requirements.yml](https://github.com/spantaleev/matrix-docker-"
"ansible-"
"deploy/blob/da27655ef34999fa924bc0a5e641dbd9ba06f133/requirements.yml) "
"file), running `make roles` (or better yet `just roles` via the [just "
"tool](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#support-for-running-commands-via-just)) becomes a necessity each time "
"one pulls playbook updates (`git pull`). Pulling external roles happens "
"via the [ansible-galaxy](https://docs.ansible.com/ansible/latest/cli"
"/ansible-galaxy.html) command-line tool, but if available, the playbook "
"would also use the much faster [agru](https://github.com/etkecc/agru) "
"tool (developed by [Aine](https://gitlab.com/etke.cc) from "
"[etke.cc](https://etke.cc/) this year)."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:22
msgid ""
"With the internal (but important) details out of the way, we can now talk"
" more about **new features that landed in matrix-docker-ansible-deploy in"
" 2023**."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:24
msgid "The following **new** **bridges** were added to the playbook in 2023:"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:26
msgid ""
"(2023-01-11) [mautrix-slack](https://mau.dev/mautrix/slack), thanks to a "
"PR by [Cody Neiman](https://github.com/xangelix) (see the [changelog "
"entry](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#mautrix-slack-support))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:27
msgid ""
"(2023-07-21) [mautrix-gmessages](https://github.com/mautrix/gmessages), "
"thanks to a PR by [Shreyas Ajjarapu](https://github.com/shreyasajj) (see "
"the [changelog entry](https://github.com/spantaleev/matrix-docker-"
"ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#mautrix-gmessages-support))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:28
msgid ""
"(2023-08-23) [mautrix-wsproxy](https://github.com/mautrix/wsproxy) for "
"Apple iMessage bridging (when combined with the [mautrix-"
"imessage](https://github.com/mautrix/imessage) bridge running on your Mac"
" or Android phone), thanks to a PR by [Johan "
"Swetzén](https://github.com/jswetzen)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:30
msgid ""
"This brings the total number of **[bridges that the playbook "
"supports](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/docs/configuring-"
"playbook.md#bridging-other-networks) up to 30**. There are alternative "
"bridge implementations for various networks and protocols, so the number "
"of \"unique bridged networks\" is surely much smaller."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:32
msgid "A few other **major components and changes** landed in 2023:"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:34
msgid ""
"(2023-02-10) The [Draupnir](https://github.com/the-draupnir-"
"project/Draupnir) moderation tool (successor to "
"[Mjolnir](https://github.com/matrix-org/mjolnir)), thanks to a PR by "
"[FSG-Cat](https://github.com/FSG-Cat) (see the [changelog "
"entry](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#draupnir-moderation-tool-bot-support))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:35
msgid ""
"(2023-02-10) [Matrix User Verification Service](https://github.com"
"/matrix-org/matrix-user-verification-service) to add Matrix "
"Authentication Support to our Jitsi setup, thanks to a PR by [Jakob "
"S.](https://github.com/jakicoll) from [zakk gGmbH](https://github.com"
"/zakk-it) (see the [changelog entry](https://github.com/spantaleev"
"/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#matrix-"
"authentication-support-for-jitsi))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:36
msgid ""
"(2023-02-25) The [rageshake](https://github.com/matrix-org/rageshake) bug"
" report server, thanks to a PR by [Benjamin "
"Kampmann](https://github.com/gnunicorn) (see the [changelog "
"entry](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#rageshake-support))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:37
msgid ""
"(2023-03-07) [Sliding Sync proxy](https://github.com/matrix-org/sliding-"
"sync) (currently a necessary component for [Element "
"X](https://element.io/labs/element-x) to work), thanks to: [Benjamin "
"Kampmann](https://github.com/gnunicorn) and [FSG-Cat](https://github.com"
"/FSG-Cat) (see the [changelog entry](https://github.com/spantaleev"
"/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#sliding-sync-proxy-element-x-support))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:38
msgid ""
"(2023-03-12) synapse-auto-compressor to periodically and automatically "
"run [rust-synapse-compress-state](https://github.com/matrix-org/rust-"
"synapse-compress-state), thanks to a PR by "
"[Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/) (see "
"the [changelog entry](https://github.com/spantaleev/matrix-docker-"
"ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#synapse-auto-compressor-support))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:39
msgid ""
"(2023-07-17) [matrix-media-repo](https://github.com/turt2live/matrix-"
"media-repo),  thanks to a PR by [Michael Hollister](https://github.com"
"/Michael-Hollister) from [FUTO](https://www.futo.org/), the creators of "
"the [Circles app](https://circu.li/) (see the [changelog "
"entry](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#matrix-"
"media-repo-support))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:40
msgid ""
"(2023-08-31) [SchildiChat Web](https://github.com/SchildiChat"
"/schildichat-desktop) client app (fork of [Element "
"Web)](https://github.com/element-hq/element-web), thanks to a PR by "
"[Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/) (see "
"the [changelog entry](https://github.com/spantaleev/matrix-docker-"
"ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#schildichat-support))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:41
msgid ""
"(2023-10-18) Postgres parameters auto-tuning, thanks to a PR by "
"[Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/) (see "
"the [changelog entry](https://github.com/spantaleev/matrix-docker-"
"ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#postgres-parameters-are-automatically-tuned-now))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:42
msgid ""
"(2023-10-23) Enabling federation of the room directory for Synapse (see "
"the [changelog entry](https://github.com/spantaleev/matrix-docker-"
"ansible-deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#enabling-allow_public_rooms_over_federation-by-default-for-synapse))"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:44
msgid ""
"The most recent change in the list above (Enabling federation of the room"
" directory for Synapse) has been somewhat **controversial** as it goes "
"against upstream defaults for Synapse. Nevertheless, we believe it "
"**promotes the well-being of the Matrix Federation by improving room "
"discovery**."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:46
msgid ""
"**Matrix Federation Stats** (containing the percentage of servers "
"publishing their room directory publicly) are posted to "
"[TWIM](https://matrix.org/category/this-week-in-matrix/) each week by "
"[Aine](https://gitlab.com/etke.cc) from [etke.cc](https://etke.cc/). The "
"number of servers which [currently published their room directory "
"publicly](https://matrix.org/blog/2023/12/2/this-week-in-"
"matrix-2023-12-22/#matrix-federation-stats) stands at `26.6%`, which is:"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:48
msgid ""
"**2.4% more** than when it was when [first published to "
"TWIM](https://matrix.org/blog/2023/11/03/this-week-in-matrix-2023-11-03"
"/#matrix-federation-stats) (1 month earlier, in November)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:49
msgid ""
"likely about **15+% more** than from before we flipped the switch (in "
"October)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:51
msgid ""
"Hopefully, Synapse defaults would also change the same way and we'd see "
"the number of servers publicly listing their room directory grow faster."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:53
msgid ""
"With this configuration change in place, projects like "
"[MatrixRooms.info](https://matrixrooms.info/) (made by "
"[etke.cc](https://etke.cc/)) and potentially others in the future, can "
"discover, index the metadata (room address, title, topic, number of "
"users, etc.) and make public rooms browsable & searchable across the "
"whole Matrix Federation. It'd be great if users joining Matrix could more"
" easily find interesting communities that match their interests!"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:55
msgid ""
"On the **media side of things**, besides Jitsi getting better Matrix "
"integration (via the aforementioned Matrix User Verification Service), "
"we've also had some [Coturn security "
"tightening](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md"
"#backward-compatibility-tightening-coturn-security-can-lead-to-"
"connectivity-issues) as well as [performance "
"optimizations](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md#coturn-"
"can-now-use-host-networking) for configurations exposing lots of network "
"ports."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:57
msgid ""
"[Element Call](https://github.com/element-hq/element-call) seems to have "
"become a nice and polished product lately (as proclaimed in [The Matrix "
"Holiday Update 2023](https://matrix.org/blog/2023/12/25/the-matrix-"
"holiday-update-2023/)), so 2024 is likely the year we'll see support for "
"it in the playbook. Element Call depends on the "
"[LiveKit](https://livekit.io/) streaming server (which is also useful to "
"developers even by itself), so the first step is likely to see LiveKit "
"support in mash-playbook via a reusable Ansible role. Such a LiveKit "
"Ansible role could later easily land in matrix-docker-ansible-deploy and "
"an Element Call static website could be hooked to it."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:59
msgid ""
"Besides these highlights, there were many other relatively large changes "
"announced in our [CHANGELOG](https://github.com/spantaleev/matrix-docker-"
"ansible-"
"deploy/blob/850078b7e37401ce91a0f9b686f60b945f6c3a96/CHANGELOG.md) and "
"hundreds of other more minor (but still important) playbook changes that "
"didn't get a mention."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:61
msgid ""
"We have **hundreds of contributors to thank for their hard work** on "
"making Matrix self-hosting better for all of us! It should be noted that "
"**support comes in many shapes**, not only in raw code commits and "
"financial help (via [donations](https://liberapay.com/s.pantaleev) or "
"using the [etke.cc managed Matrix hosting service](https://etke.cc/) "
"which is based on matrix-docker-ansible-deploy). It also comes in the "
"shape of code reviews, helping others with "
"[issues](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/issues), reporting new issues, participating in our support room "
"on Matrix ([#matrix-docker-ansible-deploy:devture.com](https://matrix.to"
"/#/#matrix-docker-ansible-deploy:devture.com)), etc. To everyone who has "
"been there to make matrix-docker-ansible-deploy better in 2023, thank "
"you! 🙇‍♂️"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:64
msgid "2022"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:66
msgid ""
"For [matrix-docker-ansible-deploy](https://github.com/spantaleev/matrix-"
"docker-ansible-deploy/), 2022 started with **breaking the** "
"[**Synapse**](https://github.com/element-hq/synapse) **monopoly** by "
"[adding support](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#dendrite-support) for the [Dendrite](https://github.com/matrix-"
"org/dendrite) Matrix homeserver in early January. This required various "
"internal changes so that the [Ansible](https://www.ansible.com/) playbook"
" would not be Synapse-centric anymore. This groundwork paved the way for "
"continuing in this direction and we [added "
"support](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#conduit-support) for [Conduit](https://conduit.rs/) in August."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:68
msgid ""
"When it comes to the `matrix-docker-ansible-deploy` Ansible playbook, "
"2022 was the year of the non-Synapse homeserver implementation. In "
"practice, none of these homeserver implementations seem ready for prime-"
"time yet and there is no migration path when coming from Synapse. Having "
"done our job of adding support for these alternative homeserver "
"implementations, we can say that we're not getting in the way of future "
"progress. It's time for the Dendrite developers to push harder "
"(development-wise) and for the Synapse developers to take a well-deserved"
" long (infinite) break, and we may get to see more people migrating away "
"from Synapse in the next year(s)."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:70
msgid "Support for the following new **bridges** was added:"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:72
msgid ""
"[Postmoogle](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#postmoogle-email-bridge-support) for bi-directional email bridging, "
"which supersedes my old and simplistic "
"[email2matrix](https://github.com/devture/email2matrix) one-way bridge-"
"bot"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:73
msgid ""
"[mautrix-discord](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#mautrix-discord-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:74
msgid ""
"[go-skype-bridge](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#go-"
"skype-bridge-bridging-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:75
msgid ""
"[matrix-appservice-kakaotalk](https://github.com/spantaleev/matrix-"
"docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix-"
"appservice-kakaotalk-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:77
msgid "Support for the following new **bots** was added:"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:79
msgid ""
"[buscarron bot](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#buscarron-bot-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:80
msgid ""
"[Honoroit bot](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#honoroit-bot-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:81
msgid ""
"[matrix-registration-bot](https://github.com/spantaleev/matrix-docker-"
"ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#matrix-registration-bot-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:82
msgid ""
"[matrix-hookshot](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix-"
"hookshot-bridging-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:83
msgid ""
"[maubot](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#maubot-"
"support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:85
msgid "Support for the following new **components and services** was added:"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:87
msgid ""
"[BorgBackup](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#borg-"
"backup-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:88
msgid ""
"[Cactus Comments](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#cactus-"
"comments-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:89
msgid ""
"[Cinny](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#cinny-"
"support) client support"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:90
msgid ""
"[ntfy](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#ntfy-"
"push-notifications-support) notifications"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:91
msgid ""
"[matrix-ldap-registration-proxy](https://github.com/spantaleev/matrix-"
"docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#matrix-"
"ldap-registration-proxy-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:92
msgid ""
"[matrix\\_encryption\\_disabler support](https://github.com/spantaleev"
"/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#matrix_encryption_disabler-support)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:93
msgid ""
"[synapse-s3-storage-provider](https://github.com/spantaleev/matrix-"
"docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#synapse-s3"
"-storage-provider-support) to stop the Synapse media store from being a "
"scalability problem. This brought along [another "
"feature](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#synapse-container-image-customization-support) - an easier way to "
"customize the Synapse container image without having to fork and self-"
"build all of it from scratch"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:95
msgid ""
"Besides these major user-visible changes, a lot of work also happened "
"**under the hood**:"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:97
msgid ""
"we made [major improvements to Synapse "
"workers](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#potential-backward-compatibility-break-major-improvements-to-synapse-"
"workers) - adding support for stream writers and for running multiple "
"workers of various kinds (federation senders, pushers, background task "
"processing workers, etc.)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:98
msgid ""
"we [improved the compatibility of (Synapse + workers) with the rest of "
"the playbook](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#backward-compatibility-break-changing-how-reverse-proxying-to-synapse-"
"works---now-via-a-matrix-synapse-reverse-proxy-companion-service) by "
"introducing a new `matrix-synapse-reverse-proxy-companion-service` "
"service"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:99
msgid ""
"we started [splitting various Ansible roles out of the Matrix playbook "
"and into independent roles](https://github.com/spantaleev/matrix-docker-"
"ansible-deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md"
"#the-playbook-now-uses-external-roles-for-some-things) (e.g. `matrix-"
"postgres` -> [ansible-role-postgres](https://github.com/mother-of-all-"
"self-hosting/ansible-role-postgres)), which could be included in other "
"Ansible playbooks. In fact, these roles already power a few **interesting"
" other sibling playbooks**:"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:100
msgid ""
"[gitea-docker-ansible-deploy](https://github.com/spantaleev/gitea-docker-"
"ansible-deploy), for deploying a [Gitea](https://gitea.io/) (self-hosted "
"[Git](https://git-scm.com/) service) server"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:101
msgid ""
"[nextcloud-docker-ansible-deploy](https://github.com/spantaleev"
"/nextcloud-docker-ansible-deploy), for deploying a "
"[Nextcloud](https://nextcloud.com/) groupware server"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:102
msgid ""
"[vaultwarden-docker-ansible-deploy](https://github.com/spantaleev"
"/vaultwarden-docker-ansible-deploy), for deploying a "
"[Vaultwarden](https://github.com/dani-garcia/vaultwarden) password "
"manager server (unofficial [Bitwarden](https://bitwarden.com/) compatible"
" server)"
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:104
msgid ""
"These sibling playbooks co-exist nicely with one another due to using "
"[Traefik](https://traefik.io/) for reverse-proxying, instead of trying to"
" overtake the whole server by running their own "
"[nginx](https://nginx.org/) reverse-proxy. Hopefully soon, the Matrix "
"playbook will follow suit and be powered by Traefik by default."
msgstr ""
#: ../../../YEAR-IN-REVIEW.md:106
msgid ""
"Last, but not least, to optimize our [etke.cc managed Matrix hosting "
"service](https://etke.cc/)'s performance (but also individual Ansible "
"playbook runs for people self-hosting by themselves using the playbook), "
"we've [improved playbook runtime 2-5x](https://github.com/spantaleev"
"/matrix-docker-ansible-"
"deploy/blob/ba09705f7fbaf0108652ecbe209793b1d935eba7/CHANGELOG.md#2x-5x-"
"performance-improvements-in-playbook-runtime) by employing various "
"Ansible tricks."
msgstr ""

212
i18n/locales/bg/LC_MESSAGES/docs/README.po Normal file
View File

@@ -0,0 +1,212 @@
# 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/README.md:1
msgid "Table of Contents"
msgstr ""
#: ../../../docs/README.md:3
msgid ""
"⬇️ Installaton guides <!-- NOTE: the 🚀 emoji is used by \"Getting "
"started\" on README.md -->"
msgstr ""
#: ../../../docs/README.md:5
msgid ""
"There are two installation guides available for beginners and advanced "
"users."
msgstr ""
#: ../../../docs/README.md:7
msgid ""
"⚡ **[Quick start](quick-start.md) (for beginners)**: this is recommended "
"for those who do not have an existing Matrix server and want to start "
"quickly with \"opinionated defaults\"."
msgstr ""
#: ../../../docs/README.md:9
msgid ""
"**Full installation guide (for advanced users)**: if you need to import "
"an existing Matrix server's data into the new server or want to learn "
"more while setting up the server, follow this guide."
msgstr ""
#: ../../../docs/README.md:11
msgid "[Prerequisites](prerequisites.md)"
msgstr ""
#: ../../../docs/README.md:13
msgid "[Configuring your DNS settings](configuring-dns.md)"
msgstr ""
#: ../../../docs/README.md:15
msgid "[Getting the playbook](getting-the-playbook.md)"
msgstr ""
#: ../../../docs/README.md:17
msgid "[Configuring the playbook](configuring-playbook.md)"
msgstr ""
#: ../../../docs/README.md:19
msgid "[Installing](installing.md)"
msgstr ""
#: ../../../docs/README.md:21
msgid "🛠️ Configuration options"
msgstr ""
#: ../../../docs/README.md:28
msgid ""
"You can check useful documentation for configuring components here: "
"[Configuring the playbook](configuring-playbook.md)"
msgstr ""
#: ../../../docs/README.md:30
msgid ""
"[Administration](configuring-playbook.md#administration) - services that "
"help you in administrating and monitoring your Matrix installation"
msgstr ""
#: ../../../docs/README.md:32
msgid ""
"[Authentication and user-related](configuring-playbook.md#authentication-"
"and-user-related) - extend and modify how users are authenticated on your"
" homeserver"
msgstr ""
#: ../../../docs/README.md:34
msgid ""
"[Bots](configuring-playbook.md#bots) - bots provide various additional "
"functionality to your installation"
msgstr ""
#: ../../../docs/README.md:36
msgid ""
"[Bridges](configuring-playbook.md#bridging-other-networks) - bridges can "
"be used to connect your Matrix installation with third-party "
"communication networks"
msgstr ""
#: ../../../docs/README.md:38
msgid ""
"[Clients](configuring-playbook.md#clients) - web clients for Matrix that "
"you can host on your own domains"
msgstr ""
#: ../../../docs/README.md:40
msgid ""
"[Core service adjustments](configuring-playbook.md#core-service-"
"adjustments) - backbone of your Matrix system"
msgstr ""
#: ../../../docs/README.md:42
msgid ""
"[File Storage](configuring-playbook.md#file-storage) - use alternative "
"file storage to the default `media_store` folder"
msgstr ""
#: ../../../docs/README.md:46
msgid ""
"[Other specialized services](configuring-playbook.md#other-specialized-"
"services) - various services that don't fit any other categories"
msgstr ""
#: ../../../docs/README.md:48
msgid "👨‍🔧 Maintenance"
msgstr ""
#: ../../../docs/README.md:50
msgid ""
"If your server and services experience issues, feel free to come to [our "
"support room](https://matrix.to/#/#matrix-docker-ansible-"
"deploy:devture.com) and ask for help."
msgstr ""
#: ../../../docs/README.md:54
msgid "[Checking if services work](maintenance-checking-services.md)"
msgstr ""
#: ../../../docs/README.md:56
msgid "[Maintenance and Troubleshooting](maintenance-and-troubleshooting.md)"
msgstr ""
#: ../../../docs/README.md:58
msgid "[PostgreSQL maintenance](maintenance-postgres.md)"
msgstr ""
#: ../../../docs/README.md:60
msgid "[Synapse maintenance](maintenance-synapse.md)"
msgstr ""
#: ../../../docs/README.md:62
msgid "[Upgrading services](maintenance-upgrading-services.md)"
msgstr ""
#: ../../../docs/README.md:64
msgid ""
"Other documentation pages <!-- NOTE: this header's title and the section "
"below need optimization -->"
msgstr ""
#: ../../../docs/README.md:66
msgid ""
"ℹ️ **[FAQ](faq.md)** - various Frequently Asked Questions about Matrix, "
"with a focus on this Ansible playbook"
msgstr ""
#: ../../../docs/README.md:70
msgid "[Alternative architectures](alternative-architectures.md)"
msgstr ""
#: ../../../docs/README.md:72
msgid "[Container images used by the playbook](container-images.md)"
msgstr ""
#: ../../../docs/README.md:74
msgid "[Obtaining an Access Token](obtaining-access-tokens.md)"
msgstr ""
#: ../../../docs/README.md:76
msgid "[Playbook tags](playbook-tags.md)"
msgstr ""
#: ../../../docs/README.md:78
msgid "[Registering users](registering-users.md)"
msgstr ""
#: ../../../docs/README.md:80
msgid "[Running `just` commands](just.md)"
msgstr ""
#: ../../../docs/README.md:82
msgid "[Self-building](self-building.md)"
msgstr ""
#: ../../../docs/README.md:84
msgid "[Uninstalling](uninstalling.md)"
msgstr ""
#: ../../../docs/README.md:86
msgid "[Updating users passwords](updating-users-passwords.md)"
msgstr ""

78
i18n/locales/bg/LC_MESSAGES/docs/alternative-architectures.po Normal file
View File

@@ -0,0 +1,78 @@
# 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/alternative-architectures.md:1
msgid "Alternative architectures"
msgstr "Алтернативни архитектури"
#: ../../../docs/alternative-architectures.md:3
msgid ""
"As stated in the [Prerequisites](prerequisites.md), currently only "
"`amd64` (`x86_64`) is fully supported."
msgstr "Както е посочено в [Предусловия](prerequisites.md), в момента само `amd64` (`x86_64`) е напълно поддържана архитектура."
#: ../../../docs/alternative-architectures.md:5
msgid ""
"The playbook automatically determines the target server's architecture "
"(the `matrix_architecture` variable) to be one of the following:"
msgstr ""
#: ../../../docs/alternative-architectures.md:7
msgid "`amd64` (`x86_64`)"
msgstr "`amd64` (`x86_64`)"
#: ../../../docs/alternative-architectures.md:8
msgid "`arm32`"
msgstr "`arm32`"
#: ../../../docs/alternative-architectures.md:9
msgid "`arm64`"
msgstr "`arm64`"
#: ../../../docs/alternative-architectures.md:11
msgid ""
"Some tools and container images can be built on the host or other "
"measures can be used to install on that architecture."
msgstr ""
#: ../../../docs/alternative-architectures.md:13
msgid "Implementation details"
msgstr ""
#: ../../../docs/alternative-architectures.md:15
msgid ""
"For `amd64`, prebuilt container images (see the [container images we use"
"](container-images.md)) are used for all components (except [Hydrogen"
"](configuring-playbook-client-hydrogen.md), which goes through self-"
"building)."
msgstr ""
#: ../../../docs/alternative-architectures.md:17
msgid ""
"For other architecture (`arm64`, `arm32`), components which have a "
"prebuilt image make use of it. If the component is not available for the "
"specific architecture, [self-building](self-building.md) will be used. "
"Not all components support self-building though, so your mileage may "
"vary."
msgstr ""

284
i18n/locales/bg/LC_MESSAGES/docs/ansible.po Normal file
View File

@@ -0,0 +1,284 @@
# 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/ansible.md:2
msgid "Running this playbook"
msgstr ""
#: ../../../docs/ansible.md:4
msgid ""
"This playbook is meant to be run using "
"[Ansible](https://www.ansible.com/)."
msgstr ""
#: ../../../docs/ansible.md:6
msgid ""
"Ansible typically runs on your local computer and carries out tasks on a "
"remote server. If your local computer cannot run Ansible, you can also "
"run Ansible on some server somewhere (including the server you wish to "
"install to)."
msgstr ""
#: ../../../docs/ansible.md:8
msgid "Supported Ansible versions"
msgstr ""
#: ../../../docs/ansible.md:10
msgid ""
"To manually check which version of Ansible you're on, run: `ansible "
"--version`."
msgstr ""
#: ../../../docs/ansible.md:12
msgid ""
"For the **best experience**, we recommend getting the **latest version of"
" Ansible available**."
msgstr ""
#: ../../../docs/ansible.md:14
msgid ""
"We're not sure what's the minimum version of Ansible that can run this "
"playbook successfully. The lowest version that we've confirmed (on "
"2022-11-26) to be working fine is: `ansible-core` (`2.11.7`) combined "
"with `ansible` (`4.10.0`)."
msgstr ""
#: ../../../docs/ansible.md:16
msgid ""
"If your distro ships with an Ansible version older than this, you may run"
" into issues. Consider [Upgrading Ansible](#upgrading-ansible) or [using "
"Ansible via Docker](#using-ansible-via-docker)."
msgstr ""
#: ../../../docs/ansible.md:18
msgid "Upgrading Ansible"
msgstr ""
#: ../../../docs/ansible.md:20
msgid ""
"Depending on your distribution, you may be able to upgrade Ansible in a "
"few different ways:"
msgstr ""
#: ../../../docs/ansible.md:22
msgid ""
"by using an additional repository (PPA, etc.), which provides newer "
"Ansible versions. See instructions for "
"[CentOS](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html"
"#installing-ansible-on-rhel-centos-or-fedora), "
"[Debian](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html"
"#installing-ansible-on-debian), or "
"[Ubuntu](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html"
"#installing-ansible-on-ubuntu) on the Ansible website."
msgstr ""
#: ../../../docs/ansible.md:24
msgid ""
"by removing the Ansible package (`yum remove ansible` or `apt-get remove "
"ansible`) and installing via "
"[pip](https://pip.pypa.io/en/stable/installation/) (`pip install "
"ansible`)."
msgstr ""
#: ../../../docs/ansible.md:26
msgid ""
"If using the `pip` method, do note that the `ansible-playbook` binary may"
" not be on the `$PATH` (https://linuxconfig.org/linux-path-environment-"
"variable), but in some more special location like `/usr/local/bin"
"/ansible-playbook`. You may need to invoke it using the full path."
msgstr ""
#: ../../../docs/ansible.md:28
msgid ""
"**Note**: Both of the above methods are a bad way to run system software "
"such as Ansible. If you find yourself needing to resort to such hacks, "
"please consider reporting a bug to your distribution and/or switching to "
"a sane distribution, which provides up-to-date software."
msgstr ""
#: ../../../docs/ansible.md:30
msgid "Using Ansible via Docker"
msgstr ""
#: ../../../docs/ansible.md:32
msgid ""
"Alternatively, you can run Ansible inside a Docker container (powered by "
"the [devture/ansible](https://hub.docker.com/r/devture/ansible/) Docker "
"image)."
msgstr ""
#: ../../../docs/ansible.md:34
msgid ""
"This ensures that you're using a very recent Ansible version, which is "
"less likely to be incompatible with the playbook."
msgstr ""
#: ../../../docs/ansible.md:36
msgid ""
"You can either [run Ansible in a container on the Matrix server itself"
"](#running-ansible-in-a-container-on-the-matrix-server-itself) or [run "
"Ansible in a container on another computer (not the Matrix server"
")](#running-ansible-in-a-container-on-another-computer-not-the-matrix-"
"server)."
msgstr ""
#: ../../../docs/ansible.md:38
msgid "Running Ansible in a container on the Matrix server itself"
msgstr ""
#: ../../../docs/ansible.md:40
msgid ""
"To run Ansible in a (Docker) container on the Matrix server itself, you "
"need to have a working Docker installation. Docker is normally installed "
"by the playbook, so this may be a bit of a chicken and egg problem. To "
"solve it:"
msgstr ""
#: ../../../docs/ansible.md:42
msgid ""
"you **either** need to install Docker manually first. Follow [the "
"upstream instructions](https://docs.docker.com/engine/install/) for your "
"distribution and consider setting "
"`matrix_playbook_docker_installation_enabled: false` in your `vars.yml` "
"file, to prevent the playbook from installing Docker"
msgstr ""
#: ../../../docs/ansible.md:43
msgid ""
"**or** you need to run the playbook in another way (e.g. [Running Ansible"
" in a container on another computer (not the Matrix server)](#running-"
"ansible-in-a-container-on-another-computer-not-the-matrix-server)) at "
"least the first time around"
msgstr ""
#: ../../../docs/ansible.md:45
msgid ""
"Once you have a working Docker installation on the server, **clone the "
"playbook** somewhere on the server and configure it as per usual "
"(`inventory/hosts`, `inventory/host_vars/..`, etc.), as described in "
"[configuring the playbook](configuring-playbook.md)."
msgstr ""
#: ../../../docs/ansible.md:47
msgid ""
"You would then need to add `ansible_connection=community.docker.nsenter` "
"to the host line in `inventory/hosts`. This tells Ansible to connect to "
"the \"remote\" machine by switching Linux namespaces with "
"[nsenter](https://man7.org/linux/man-pages/man1/nsenter.1.html), instead "
"of using SSH."
msgstr ""
#: ../../../docs/ansible.md:49
msgid ""
"Alternatively, you can leave your `inventory/hosts` as is and specify the"
" connection type in **each** `ansible-playbook` call you do later, like "
"this: `ansible-playbook --connection=community.docker.nsenter …`"
msgstr ""
#: ../../../docs/ansible.md:51 ../../../docs/ansible.md:71
msgid "Run this from the playbook's directory:"
msgstr ""
#: ../../../docs/ansible.md:63 ../../../docs/ansible.md:84
msgid ""
"Once you execute the above command, you'll be dropped into a `/work` "
"directory inside a Docker container. The `/work` directory contains the "
"playbook's code."
msgstr ""
#: ../../../docs/ansible.md:65 ../../../docs/ansible.md:86
msgid ""
"First, consider running `git config --global --add safe.directory /work` "
"to [resolve directory ownership issues](#resolve-directory-ownership-"
"issues)."
msgstr ""
#: ../../../docs/ansible.md:67
msgid ""
"Finally, you can execute `ansible-playbook …` (or `ansible-playbook "
"--connection=community.docker.nsenter …`) commands as per normal now."
msgstr ""
#: ../../../docs/ansible.md:69
msgid "Running Ansible in a container on another computer (not the Matrix server)"
msgstr ""
#: ../../../docs/ansible.md:82
msgid ""
"The above command tries to mount an SSH key (`$HOME/.ssh/id_rsa`) into "
"the container (at `/root/.ssh/id_rsa`). If your SSH key is at a different"
" path (not in `$HOME/.ssh/id_rsa`), adjust that part."
msgstr ""
#: ../../../docs/ansible.md:88
msgid "Finally, you execute `ansible-playbook …` commands as per normal now."
msgstr ""
#: ../../../docs/ansible.md:90
msgid "If you don't use SSH keys for authentication"
msgstr ""
#: ../../../docs/ansible.md:92
msgid ""
"If you don't use SSH keys for authentication, simply remove that whole "
"line (`-v $HOME/.ssh/id_rsa:/root/.ssh/id_rsa:ro`)."
msgstr ""
#: ../../../docs/ansible.md:94
msgid ""
"To authenticate at your server using a password, you need to add a "
"package. So, when you are in the shell of the ansible docker container "
"(the previously used `docker run -it …` command), run:"
msgstr ""
#: ../../../docs/ansible.md:100
msgid ""
"Then, to be asked for the password whenever running an `ansible-"
"playbook` command add `--ask-pass` to the arguments of the command."
msgstr ""
#: ../../../docs/ansible.md:102
msgid "Resolve directory ownership issues"
msgstr ""
#: ../../../docs/ansible.md:104
msgid ""
"Because you're `root` in the container running Ansible and this likely "
"differs fom the owner (your regular user account) of the playbook "
"directory outside of the container, certain playbook features which use "
"`git` locally may report warnings such as:"
msgstr ""
#: ../../../docs/ansible.md:106
msgid ""
"fatal: unsafe repository ('/work' is owned by someone else) To add an "
"exception for this directory, call: git config --global --add "
"safe.directory /work"
msgstr ""
#: ../../../docs/ansible.md:110
msgid ""
"These errors can be resolved by making `git` trust the playbook directory"
" by running `git config --global --add safe.directory /work`"
msgstr ""

93
i18n/locales/bg/LC_MESSAGES/docs/configuring-captcha.po Normal file
View File

@@ -0,0 +1,93 @@
# 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/configuring-captcha.md:1
msgid ""
"(Adapted from the [upstream project](https://github.com/element-"
"hq/synapse/blob/develop/docs/CAPTCHA_SETUP.md))"
msgstr ""
#: ../../../docs/configuring-captcha.md:3
msgid "Overview"
msgstr ""
#: ../../../docs/configuring-captcha.md:5
msgid ""
"Captcha can be enabled for this home server. This file explains how to do"
" that."
msgstr ""
#: ../../../docs/configuring-captcha.md:7
msgid ""
"The captcha mechanism used is Google's "
"[ReCaptcha](https://www.google.com/recaptcha/). This requires API keys "
"from Google. If your homeserver is Dendrite then "
"[hCapcha](https://www.hcaptcha.com) can be used instead."
msgstr ""
#: ../../../docs/configuring-captcha.md:9
msgid "ReCaptcha"
msgstr ""
#: ../../../docs/configuring-captcha.md:11
#: ../../../docs/configuring-captcha.md:37
msgid "Getting keys"
msgstr ""
#: ../../../docs/configuring-captcha.md:13
#: ../../../docs/configuring-captcha.md:39
msgid "Requires a site/secret key pair from:"
msgstr ""
#: ../../../docs/configuring-captcha.md:15
msgid "<http://www.google.com/recaptcha/admin>"
msgstr ""
#: ../../../docs/configuring-captcha.md:17
msgid ""
"Must be a reCAPTCHA **v2** key using the \"I'm not a robot\" Checkbox "
"option"
msgstr ""
#: ../../../docs/configuring-captcha.md:19
msgid "Setting ReCaptcha keys"
msgstr ""
#: ../../../docs/configuring-captcha.md:21
msgid ""
"Once registered as above, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-captcha.md:35
msgid "hCaptcha"
msgstr ""
#: ../../../docs/configuring-captcha.md:41
msgid "<https://dashboard.hcaptcha.com/sites/new>"
msgstr ""
#: ../../../docs/configuring-captcha.md:43
msgid "Setting hCaptcha keys"
msgstr ""

410
i18n/locales/bg/LC_MESSAGES/docs/configuring-dns.po Normal file
View File

@@ -0,0 +1,410 @@
# 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/configuring-dns.md:1
msgid "Configuring your DNS settings"
msgstr ""
#: ../../../docs/configuring-dns.md:3
msgid ""
"<sup>[Prerequisites](prerequisites.md) > Configuring your DNS settings > "
"[Getting the playbook](getting-the-playbook.md) > [Configuring the "
"playbook](configuring-playbook.md) > [Installing](installing.md)</sup>"
msgstr ""
#: ../../../docs/configuring-dns.md:5
msgid "To set up Matrix on your domain, you'd need to do some DNS configuration."
msgstr ""
#: ../../../docs/configuring-dns.md:7
msgid "DNS setting for server delegation (optional)"
msgstr ""
#: ../../../docs/configuring-dns.md:9
msgid ""
"In the sample `vars.yml` ([`examples/vars.yml`](../examples/vars.yml)), "
"we recommend to use a short user ID like `@alice:example.com` instead of "
"`@alice:matrix.example.com`."
msgstr ""
#: ../../../docs/configuring-dns.md:11
msgid ""
"To use such an ID, you don't need to install anything on the actual "
"`example.com` server. Instead, you need to instruct the Matrix network "
"that Matrix services for `example.com` are redirected over to "
"`matrix.example.com`. This redirection is also known as \"delegation\"."
msgstr ""
#: ../../../docs/configuring-dns.md:13
msgid ""
"As we discuss in [Server Delegation](howto-server-delegation.md), server "
"delegation can be configured in either of these ways:"
msgstr ""
#: ../../../docs/configuring-dns.md:15
msgid ""
"Setting up a `/.well-known/matrix/server` file on the base domain "
"(`example.com`)"
msgstr ""
#: ../../../docs/configuring-dns.md:16
msgid "Setting up a `_matrix._tcp` DNS SRV record"
msgstr ""
#: ../../../docs/configuring-dns.md:18
msgid ""
"For simplicity reasons, this playbook recommends you to set up server "
"delegation via a `/.well-known/matrix/server` file, instead of using a "
"DNS SRV record."
msgstr ""
#: ../../../docs/configuring-dns.md:20
msgid ""
"If you choose the recommended method (file-based delegation), you do not "
"need to configure the DNS record to enable server delegation. You will "
"need to add a necessary configuration later, when you [finalize the "
"installation](installing.md#finalize-the-installation) after installing "
"and starting Matrix services."
msgstr ""
#: ../../../docs/configuring-dns.md:22
msgid ""
"On the other hand, if you choose this method (setting up a DNS SRV "
"record), you need to configure the additional DNS record as well as "
"adjust SSL certificate handling. Take a look at this documentation for "
"more information: [Server Delegation via a DNS SRV record (advanced"
")](howto-server-delegation.md#server-delegation-via-a-dns-srv-record-"
"advanced)"
msgstr ""
#: ../../../docs/configuring-dns.md:24
msgid "DNS settings for services enabled by default"
msgstr ""
#: ../../../docs/configuring-dns.md:26
msgid ""
"To serve the base domain (`example.com`) and [Element Web](configuring-"
"playbook-client-element-web.md) with the default subdomain, adjust DNS "
"records as below."
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "Type"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "Host"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "Priority"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "Weight"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "Port"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "Target"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "A"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`matrix`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "-"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`matrix-server-IP`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "CNAME"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`element`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`matrix.example.com`"
msgstr ""
#: ../../../docs/configuring-dns.md:33
msgid ""
"As the table illustrates, you need to create 2 subdomains "
"(`matrix.example.com` and `element.example.com`) and point both of them "
"to your server's IP address (DNS `A` record or `CNAME` record is fine)."
msgstr ""
#: ../../../docs/configuring-dns.md:35
msgid ""
"The `element.example.com` subdomain is necessary, because this playbook "
"installs the [Element Web](https://github.com/element-hq/element-web) "
"client for you by default. If you'd rather instruct the playbook not to "
"install Element Web (`matrix_client_element_enabled: false` when "
"[Configuring the playbook](configuring-playbook.md) later), feel free to "
"skip the `element.example.com` DNS record."
msgstr ""
#: ../../../docs/configuring-dns.md:37
msgid "Be mindful as to how long it will take for the DNS records to propagate."
msgstr ""
#: ../../../docs/configuring-dns.md:39
msgid ""
"If you are using Cloudflare DNS, make sure to disable the proxy and set "
"all records to \"DNS only\". Otherwise, fetching certificates will fail."
msgstr ""
#: ../../../docs/configuring-dns.md:41
msgid "DNS settings for optional services/features"
msgstr ""
#: ../../../docs/configuring-dns.md:43
msgid ""
"For other services which may need subdomain settings, see the table below"
" and configure the DNS (`CNAME`) records accordingly."
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "Used by component"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[Dimension](configuring-playbook-dimension.md) integration server"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`dimension`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[Jitsi](configuring-playbook-jitsi.md) video-conferencing platform"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`jitsi`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid ""
"[Prometheus/Grafana](configuring-playbook-prometheus-grafana.md) "
"monitoring system"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`stats`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[Go-NEB](configuring-playbook-bot-go-neb.md) bot"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`goneb`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[Sygnal](configuring-playbook-sygnal.md) push notification gateway"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`sygnal`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[ntfy](configuring-playbook-ntfy.md) push notifications server"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`ntfy`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[Etherpad](configuring-playbook-etherpad.md) collaborative text editor"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`etherpad`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[Hydrogen](configuring-playbook-client-hydrogen.md) web client"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`hydrogen`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[Cinny](configuring-playbook-client-cinny.md) web client"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`cinny`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[SchildiChat Web](configuring-playbook-client-schildichat-web.md) client"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`schildichat`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[wsproxy](configuring-playbook-bridge-mautrix-wsproxy.md) sms bridge"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`wsproxy`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[Buscarron](configuring-playbook-bot-buscarron.md) helpdesk bot"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`buscarron`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[rageshake](configuring-playbook-rageshake.md) bug report server"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`rageshake`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[ma1sd](configuring-playbook-ma1sd.md) identity server"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "SRV"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`_matrix-identity._tcp`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "10"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "0"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "443"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid ""
"[Postmoogle](configuring-playbook-bridge-postmoogle.md)/[Email2Matrix"
"](configuring-playbook-email2matrix.md) email bridges"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "MX"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "[Postmoogle](configuring-playbook-bridge-postmoogle.md) email bridge"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "TXT"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`v=spf1 ip4:matrix-server-IP -all`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`_dmarc.matrix`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`v=DMARC1; p=quarantine;`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "`postmoogle._domainkey.matrix`"
msgstr ""
#: ../../../docs/configuring-dns.md
msgid "get it from `!pm dkim`"
msgstr ""
#: ../../../docs/configuring-dns.md:66
msgid "SRV record for ma1sd"
msgstr ""
#: ../../../docs/configuring-dns.md:68
msgid ""
"To make ma1sd enable its federation features, you need to set up a "
"`_matrix-identity._tcp` SRV record. Don't confuse this with the "
"`_matrix._tcp` SRV record for server delegation. See the table above and "
"[this section](configuring-playbook-ma1sd.md#adjusting-dns-records) for "
"values which need to be specified."
msgstr ""
#: ../../../docs/configuring-dns.md:70
msgid ""
"When setting up a SRV record, if you are asked for a service and protocol"
" instead of a hostname split the host value from the table where the "
"period is. For example use service as `_matrix-identity` and protocol as "
"`_tcp`."
msgstr ""
#: ../../../docs/configuring-dns.md:72
msgid "MX and TXT records for Postmoogle"
msgstr ""
#: ../../../docs/configuring-dns.md:74
msgid ""
"To make Postmoogle enable its email sending features, you need to "
"configure MX and TXT (SPF, DMARC, and DKIM) records. See the table above "
"for values which need to be specified."
msgstr ""
#: ../../../docs/configuring-dns.md:78
msgid ""
"[▶️](getting-the-playbook.md) When you're done with the DNS configuration"
" and ready to proceed, continue with [Getting the playbook](getting-the-"
"playbook.md)."
msgstr ""

252
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po Normal file
View File

@@ -0,0 +1,252 @@
# 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/configuring-playbook-alertmanager-receiver.md:1
msgid ""
"Setting up Prometheus Alertmanager integration via matrix-alertmanager-"
"receiver (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:3
msgid ""
"The playbook can install and configure the [matrix-alertmanager-"
"receiver](https://github.com/metio/matrix-alertmanager-receiver) service "
"for you. It's a "
"[client](https://prometheus.io/docs/alerting/latest/clients/) for "
"Prometheus' "
"[Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/),"
" allowing you to deliver alerts to Matrix rooms."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:5
msgid ""
"See the project's [documentation](https://github.com/metio/matrix-"
"alertmanager-receiver) to learn more about what this component does and "
"why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:7
msgid ""
"At the moment, **setting up this service's bot requires some manual "
"actions** as described below in [Account and room preparation](#account-"
"and-room-preparation)."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:9
msgid ""
"This service is meant to be used with an external "
"[Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/) "
"instance. It's **not** meant to be integrated with the [Prometheus & "
"Grafana stack](./configuring-playbook-prometheus-grafana.md) installed by"
" this playbook, because the Alertmanager component is not installed by "
"it."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:11
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:13
msgid ""
"To enable matrix-alertmanager-receiver, add the following configuration "
"to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:36
msgid ""
"See `roles/custom/matrix-alertmanager-receiver/defaults/main.yml` for "
"additional configuration variables."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:38
msgid "Adjusting the matrix-alertmanager-receiver URL"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:40
msgid ""
"By default, this playbook installs matrix-alertmanager-receiver on the "
"`matrix.` subdomain, at the `/matrix-alertmanager-receiver` path "
"(https://matrix.example.com/matrix-alertmanager-receiver). This makes it "
"easy to install it, because it **doesn't require additional DNS records "
"to be set up**. If that's okay, you can skip this section."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:42
msgid ""
"By tweaking the `matrix_alertmanager_receiver_hostname` and "
"`matrix_alertmanager_receiver_path_prefix` variables, you can easily make"
" the service available at a **different hostname and/or path** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:44
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:52
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:54
msgid ""
"If you've changed the default hostname, **you may need to adjust your "
"DNS** records to point the matrix-alertmanager-receiver domain to the "
"Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:56
msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:58
msgid ""
"If you've decided to use the default hostname, you won't need to do any "
"extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:60
msgid "Account and room preparation"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:62
msgid ""
"The playbook can automatically create users, but it cannot automatically "
"obtain access tokens, nor perform any of the other manual actions below."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:64
msgid ""
"`matrix-alertmanager-receiver` uses a bot (with a username specified in "
"`matrix_alertmanager_receiver_config_matrix_user_id_localpart` - see "
"above) for delivering messages. You need to **manually register this bot "
"acccount and obtain an access token for it**."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:66
msgid ""
"[Register a new user](registering-users.md): `ansible-playbook -i "
"inventory/hosts setup.yml --extra-"
"vars='username=bot.alertmanager.receiver password=PASSWORD_FOR_THE_BOT "
"admin=no' --tags=register-user`"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67
msgid ""
"[Obtain an access token](obtaining-access-tokens.md) for the bot's user "
"account"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:68
msgid "Invite the bot to a room where you'd like to alerts to be delivered"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69
msgid ""
"Log in as the bot using any Matrix client of your choosing, accept the "
"room invitation from the bot's account and log out"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:70
msgid ""
"(Optionally) Adjust "
"`matrix_alertmanager_receiver_config_matrix_room_mapping` to create a "
"mapping between the new room and its ID"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:72
msgid ""
"Steps 1 and 2 above only need to be done once, while preparing your "
"[configuration](#adjusting-the-playbook-configuration)."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:74
msgid ""
"Steps 3 and 4 need to be done for each new room you'd like the bot to "
"deliver alerts to. Step 5 is optional and provides cleaner `/alert/` "
"URLs."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:76
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:78
msgid ""
"Now that you've [prepared the bot account and room](#account-and-room-"
"preparation), [configured the playbook](#adjusting-the-playbook-"
"configuration), and potentially [adjusted your DNS records](#adjusting-"
"dns-records), you can run the playbook with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:85
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:89
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:91
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-alertmanager-receiver.md:93
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:95
msgid "Configure your Prometheus Alertmanager with configuration like this:"
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:114
msgid ""
".. where `URL_HERE` looks like `https://matrix.example.com/matrix-"
"alertmanager-receiver-RANDOM_VALUE_HERE/alert/some-room-name` or "
"`https://matrix.example.com/matrix-alertmanager-receiver-"
"RANDOM_VALUE_HERE/alert/!qporfwt:example.com`."
msgstr ""
#: ../../../docs/configuring-playbook-alertmanager-receiver.md:116
msgid ""
"This bot does **not** accept room invitations automatically (like many "
"other bots do). To deliver messages to rooms, **the bot must be joined to"
" all rooms manually** - see Step 4 of the [Account and room preparation"
"](#account-and-room-preparation) section."
msgstr ""

108
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-appservice-double-puppet.po Normal file
View File

@@ -0,0 +1,108 @@
# 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/configuring-playbook-appservice-double-puppet.md:1
msgid "Setting up Appservice Double Puppet (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:3
msgid ""
"Appservice Double Puppet is a homeserver appservice through which bridges"
" (and potentially other services) can impersonate any user on the "
"homeserver."
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:5
msgid ""
"This is useful for performing [double-"
"puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) via"
" the [appservice method](https://docs.mau.fi/bridges/general/double-"
"puppeting.html#appservice-method-new). The Appservice Double Puppet "
"service is an implementation of this approach."
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:7
msgid ""
"Previously, bridges supported performing [double-"
"puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"with the help of the [Shared Secret Auth password provider module"
"](./configuring-playbook-shared-secret-auth.md), but this old and hacky "
"solution has been superseded by this Appservice Double Puppet method."
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:9
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:11
msgid ""
"To enable the Appservice Double Puppet service, add the following "
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:17
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:19
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:26
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:28
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:30
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-double-puppet.md:32
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-double-puppet.md:34
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-double-puppet.md:36
msgid ""
"When enabled, double puppeting will automatically be enabled for all "
"bridges that support double puppeting via the appservice method."
msgstr ""

298
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po Normal file
View File

@@ -0,0 +1,298 @@
# 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/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 "Installation"
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. "
"This task you have to do on your own."
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:25
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:27
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:29
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 ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:30
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 ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:32
msgid "Give your main management room an alias."
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:34
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 ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:36
msgid "Adjusting the playbook configuration."
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:38
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:40
msgid ""
"You must replace `ALIAS_FROM_STEP_2_GOES_HERE` with the alias you created"
" in step 2."
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:48
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:50
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:57
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:59
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:61
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:63
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:65
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:67
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:69
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 ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71
msgid "Granting Users the ability to use D4A"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73
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:75
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:77
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:79
msgid "How to provision a D4A once you are allowed to."
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:81
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 ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:83
msgid ""
"Congratulations if you made it all the way here because you now have a "
"fully working Draupnir for all deployment."
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:85
msgid "Configuration of D4A"
msgstr ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:87
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 ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:89
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 ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:91
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 ""
#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:93
msgid ""
"For example to change Draupnir's `protectAllJoinedRooms` option to `true`"
" you would add the following to your `vars.yml` file."
msgstr ""

216
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-backup-borg.po Normal file
View File

@@ -0,0 +1,216 @@
# 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/configuring-playbook-backup-borg.md:1
msgid "Setting up BorgBackup (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:3
msgid ""
"The playbook can install and configure "
"[BorgBackup](https://www.borgbackup.org/) (short: Borg) with "
"[borgmatic](https://torsion.org/borgmatic/) for you."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:5
msgid ""
"BorgBackup is a deduplicating backup program with optional compression "
"and encryption. That means your daily incremental backups can be stored "
"in a fraction of the space and is safe whether you store it at home or on"
" a cloud service."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:7
msgid ""
"You will need a remote server where BorgBackup will store the backups. "
"There are hosted, BorgBackup compatible solutions available, such as "
"[BorgBase](https://www.borgbase.com)."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:9
msgid ""
"The backup will run based on `backup_borg_schedule` var (systemd timer "
"calendar), default: 4am every day."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:11
msgid ""
"By default, if you're using the integrated Postgres database server (as "
"opposed to [an external Postgres server](configuring-playbook-external-"
"postgres.md)), backups with BorgBackup will also include dumps of your "
"Postgres database. An alternative solution for backing up the Postgres "
"database is [postgres backup](configuring-playbook-postgres-backup.md). "
"If you decide to go with another solution, you can disable Postgres-"
"backup support for BorgBackup using the `backup_borg_postgresql_enabled` "
"variable."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:13
msgid ""
"**Note**: the component is not managed by this repository but its [own "
"repository](https://github.com/mother-of-all-self-hosting/ansible-role-"
"backup_borg)."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:15
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:17
msgid ""
"If you do not disable Postgres-backup support, make sure that the "
"Postgres version of your homeserver's database is compatible with "
"borgmatic."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:19
msgid "Create a new SSH key:"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:25
msgid ""
"This can be done on any machine and you don't need to place the key in "
"the `.ssh` folder. It will be added to the Ansible config later."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:27
msgid ""
"Add the **public** part of this SSH key (the `matrix-borg-backup.pub` "
"file) to your BorgBackup provider/server:"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:29
msgid ""
"If you plan to use a hosted solution, follow their instructions. If you "
"have your own server, copy the key over:"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:39
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:41
msgid ""
"Minimal working configuration "
"(`inventory/host_vars/matrix.example.com/vars.yml`) to enable BorgBackup:"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:58
msgid "where:"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:60
msgid "USER - SSH user of a provider/server"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:61
msgid "HOST - SSH host of a provider/server"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:62
msgid ""
"REPO - BorgBackup repository name, it will be initialized on backup "
"start, eg: `matrix`, regarding Syntax see [Remote "
"repositories](https://borgbackup.readthedocs.io/en/stable/usage/general.html"
"#repository-urls)"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:63
msgid ""
"PASSPHRASE - passphrase used for encrypting backups, you may generate it "
"with `pwgen -s 64 1` or use any password manager"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:64
msgid ""
"PRIVATE KEY - the content of the **private** part of the SSH key you "
"created before. The whole key (all of its belonging lines) under "
"`backup_borg_ssh_key_private` needs to be indented with 2 spaces"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:66
msgid ""
"To backup without encryption, add `backup_borg_encryption: 'none'` to "
"your vars. This will also enable the "
"`backup_borg_unknown_unencrypted_repo_access_is_ok` variable."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:68
msgid ""
"`backup_borg_location_source_directories` defines the list of directories"
" to back up: it's set to `{{ matrix_base_data_path }}` by default, which "
"is the base directory for every service's data, such as Synapse, Postgres"
" and the bridges. You might want to exclude certain directories or file "
"patterns from the backup using the "
"`backup_borg_location_exclude_patterns` variable."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:70
msgid ""
"Check the [backup_borg role](https://github.com/mother-of-all-self-"
"hosting/ansible-role-backup_borg)'s "
"[defaults/main.yml](https://github.com/mother-of-all-self-hosting"
"/ansible-role-backup_borg/blob/main/defaults/main.yml) file for the full "
"list of available options."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:72
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:74
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:81
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:83
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:85
msgid "Manually start a backup"
msgstr ""
#: ../../../docs/configuring-playbook-backup-borg.md:87
msgid ""
"For testing your setup it can be helpful to not wait until 4am. If you "
"want to run the backup immediately, log onto the server and run "
"`systemctl start matrix-backup-borg`. This will not return until the "
"backup is done, so possibly a long time. Consider using "
"[tmux](https://en.wikipedia.org/wiki/Tmux) if your SSH connection is "
"unstable."
msgstr ""

241
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-base-domain-serving.po Normal file
View File

@@ -0,0 +1,241 @@
# 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/configuring-playbook-base-domain-serving.md:1
msgid "Serving the base domain (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:3
msgid ""
"By default, this playbook sets up services on your Matrix server "
"(`matrix.example.com`), but has it configured so that it presents itself "
"as the base domain (`example.com`). To have this server officially be "
"responsible for Matrix services for the base domain (`example.com`), you "
"need to set up server delegation / redirection."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:5
msgid ""
"As we discuss in [Server Delegation](howto-server-delegation.md), server "
"delegation / redirection can be configured in either of these ways:"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:7
msgid ""
"Setting up a `/.well-known/matrix/server` file on the base domain "
"(`example.com`)"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:8
msgid "Setting up a `_matrix._tcp` DNS SRV record"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:10
msgid ""
"For simplicity reasons, this playbook recommends you to set up server "
"delegation via a `/.well-known/matrix/server` file."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:12
msgid ""
"However, those who don't have a separate server to dedicate to the base "
"domain have trouble arranging this."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:14
msgid "Usually, there are 2 options:"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:16
msgid ""
"either get a separate server for the base domain, just for serving the "
"files necessary for [Server Delegation via a well-known file](howto-"
"server-delegation.md#server-delegation-via-a-well-known-file)"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:18
msgid ""
"or, arrange for the Matrix server to serve the base domain. This either "
"involves you [using your own webserver](configuring-playbook-own-"
"webserver.md) or making the integrated webserver serve the base domain "
"for you."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:20
msgid ""
"This documentation page tells you how to do the latter. With some easy "
"changes, we make it possible to serve the base domain from the Matrix "
"server via the integrated webserver."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:22
msgid ""
"Just [**adjust your DNS records**](configuring-dns.md), so that your base"
" domain is pointed to the Matrix server's IP address (using a DNS `A` "
"record) **and then add the following configuration** to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:28
msgid "Doing this, the playbook will:"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:30
msgid ""
"obtain an SSL certificate for the base domain, just like it does for all "
"other domains (see [how we handle SSL certificates](configuring-playbook-"
"ssl-certificates.md))"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:32
msgid ""
"serve the `/.well-known/matrix/*` files which are necessary for "
"[Federation Server Discovery](configuring-well-known.md#federation-"
"server-discovery) (also see [Server Delegation](howto-server-"
"delegation.md)) and [Client-Server discovery](configuring-well-known.md"
"#client-server-discovery)"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:34
msgid ""
"serve a simple homepage at `https://example.com` with content `Hello from"
" example.com` (configurable via the "
"`matrix_static_files_file_index_html_template` variable). You can also "
"[serve a more complicated static website](#serving-a-static-website-at-"
"the-base-domain)."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:36
msgid "Serving a static website at the base domain"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:38
msgid ""
"By default, when \"serving the base domain\" is enabled, the playbook "
"hosts a simple `index.html` webpage at `/matrix/static-"
"files/public/index.html`. The content of this page is taken from the "
"`matrix_static_files_file_index_html_template` variable."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:40
msgid ""
"If you'd like to host your own static website (more than a single "
"`index.html` page) at the base domain, you can disable the creation of "
"this default `index.html` page like this:"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:54
msgid ""
"With this configuration, Ansible will no longer mess around with the "
"`/matrix/static-files/public/index.html` file."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:56
msgid ""
"You are then free to upload any static website files to `/matrix/static-"
"files/public` and they will get served at the base domain. You can do so "
"manually or by using the [ansible-role-aux](https://github.com/mother-of-"
"all-self-hosting/ansible-role-aux) Ansible role, which is part of this "
"playbook already."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:58
msgid "Serving a more complicated website at the base domain"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:60
msgid ""
"If you'd like to serve an even more complicated (dynamic) website from "
"the Matrix server, relying on the playbook to serve the base domain is "
"not the best choice."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:62
msgid "You have 2 options."
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:64
msgid "**One way is to host your base domain elsewhere**. This involves:"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:65
msgid ""
"you stopping to serve it from the Matrix server: remove "
"`matrix_static_files_container_labels_base_domain_enabled` from your "
"configuration"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:66
msgid ""
"[configuring Matrix Delegation via well-known](./configuring-well-"
"known.md)"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:68
msgid ""
"**Another way is to serve the base domain from another (your own) "
"container on the Matrix server**. This involves:"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:69
msgid ""
"telling the playbook to only serve `example.com/.well-known/matrix` files"
" by adjusting your `vars.yml` configuration like this:"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:70
msgid "keep `matrix_static_files_container_labels_base_domain_enabled: true`"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:71
msgid ""
"add an extra: "
"`matrix_static_files_container_labels_base_domain_traefik_path_prefix: "
"/.well-known/matrix`"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:72
msgid "building and running a new container on the Matrix server:"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:73
msgid ""
"it should be connected to the `traefik` network, so that Traefik can "
"reverse-proxy to it"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:74
msgid ""
"it should have appropriate [container "
"labels](https://docs.docker.com/config/labels-custom-metadata/), which "
"instruct Traefik to reverse-proxy to it"
msgstr ""
#: ../../../docs/configuring-playbook-base-domain-serving.md:76
msgid ""
"How you'll be managing building and running this container is up-to-you. "
"You may use of the primitives from [ansible-role-aux](https://github.com"
"/mother-of-all-self-hosting/ansible-role-aux) Ansible role to organize it"
" yourself, or you can set it up in another way."
msgstr ""

688
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-baibot.po Normal file
View File

@@ -0,0 +1,688 @@
# 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/configuring-playbook-bot-baibot.md:1
msgid "Setting up baibot (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:8
msgid ""
"🤖 [baibot](https://github.com/etkecc/baibot) (pronounced bye-bot) is a "
"[Matrix](https://matrix.org/) bot developed by "
"[etke.cc](https://etke.cc/) that exposes the power of "
"[AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large "
"Language Models](https://en.wikipedia.org/wiki/Large_language_model) to "
"you. 🤖"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:10
msgid ""
"It supports [OpenAI](https://openai.com/)'s "
"[ChatGPT](https://openai.com/blog/chatgpt/) models, as many well as other"
" [☁️ "
"providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:12
msgid ""
"It's designed as a more private and [✨ "
"featureful](https://github.com/etkecc/baibot/?tab=readme-ov-"
"file#-features) alternative to [matrix-chatgpt-bot](./configuring-"
"playbook-bot-chatgpt.md). See the "
"[baibot](https://github.com/etkecc/baibot) project and its documentation "
"for more information."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:14
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:16
msgid ""
"API access to one or more LLM [☁️ "
"providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:18
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:20
msgid ""
"There are **a lot of configuration options** (some required, some "
"possibly required, some optional), so they're **split into multiple "
"sections below**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:23
msgid "[Base configuration](#base-configuration)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:24
msgid "[👮‍♂️ Administrator configuration](#️-administrator-configuration)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:25
msgid "[👥 Initial users configuration](#-initial-users-configuration)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:26
msgid "[🤖 Configuring agents via Ansible](#-configuring-agents-via-ansible)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:27
msgid ""
"[🤝 Configuring initial default handlers](#-configuring-initial-default-"
"handlers)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:29
msgid ""
"Depending on your current `vars.yml` file and desired configuration, "
"**you may require more than just the [base configuration](#base-"
"configuration)**."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:31
msgid "Base configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:33
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:71
msgid ""
"As mentioned above, **this may not be enough**. Continue with the "
"configuration sections below."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:73
msgid "👮‍♂️ Administrator configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:75
#: ../../../docs/configuring-playbook-bot-baibot.md:99
msgid "This is an addition to the [base configuration](#base-configuration)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:77
msgid ""
"To specify who is considered a bot [👮‍♂️ "
"Administrator](https://github.com/etkecc/baibot/blob/main/docs/access.md#administrators),"
" you either need to specify "
"`matrix_bot_baibot_config_access_admin_patterns` or `matrix_admin`. The "
"latter is a single variable which affects all bridges and bots."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:79
msgid ""
"If `matrix_admin` is already configured in your `vars.yml` configuration,"
" you can skip this section."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:81
#: ../../../docs/configuring-playbook-bot-baibot.md:110
msgid ""
"**If necessary**, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:95
msgid "👥 Initial users configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:97
msgid ""
"By default, **all users on your homeserver are considered allowed "
"users**. If that's OK, you can skip this section."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:101
msgid ""
"To specify who is considered a bot [👥 "
"User](https://github.com/etkecc/baibot/blob/main/docs/access.md#user), "
"you may:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:103
msgid ""
"define an **initial** value for "
"`matrix_bot_baibot_config_initial_global_config_user_patterns` Ansible "
"variable, as shown below"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:104
msgid ""
"configure the list at runtime via the bot's `!bai access set-users "
"SPACE_SEPARATED_PATTERNS` command"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:106
msgid ""
"Configuring "
"`matrix_bot_baibot_config_initial_global_config_user_patterns` is "
"optional, but it can be useful to pre-configure the bot with a list of "
"users who should have access to the bot's features."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:108
msgid ""
"**Note**: Once initially configured, the allowed users list **cannot be "
"managed via Ansible anymore**. It can only be managed subsequently via "
"bot commands."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:122
msgid "🤖 Configuring agents via Ansible"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:124
msgid ""
"You are **not required** to define agents "
"[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"
"#static-configuration) via Ansible. **To get started quickly**, you can "
"**skip this section and define agents at runtime via chat commands** "
"(following the bot's guidance)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:126
msgid ""
"Privileged users (like the [👮‍♂️ Administrator](#️-administrator-"
"configuration), but potentially others too - see the upstream [🔒 "
"access](https://github.com/etkecc/baibot/blob/main/docs/access.md) "
"documentation) can **define agents dynamically at any time** via chat "
"commands."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:128
msgid ""
"The Ansible role includes preset variables for easily enabling some [🤖 "
"agents](https://github.com/etkecc/baibot/blob/main/docs/agents.md) on "
"various [☁️ "
"providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md) "
"(e.g. OpenAI, etc)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:130
msgid ""
"Besides the presets, the Ansible role also includes support for "
"configuring additional statically-defined agents via the "
"`matrix_bot_baibot_config_agents_static_definitions_custom` Ansible "
"variable."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:132
msgid ""
"Agents defined statically and those created dynamically (via chat) are "
"named differently, so **conflict cannot arise**."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:134
msgid ""
"Depending on your propensity for "
"[GitOps](https://en.wikipedia.org/wiki/DevOps#GitOps), you may prefer to "
"define agents statically via Ansible, or you may wish to do it "
"dynamically via chat."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:136
msgid ""
"Before proceeding, we recommend reading the upstream documentation on "
"[How to choose a "
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md"
"#how-to-choose-a-provider). In short, it's probably best to go with "
"[OpenAI](#openai)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:138
msgid "Anthropic"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:140
msgid ""
"You can statically-define a single [🤖 "
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "
"instance powered by the [Anthropic "
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#anthropic)"
" with the help of the playbook's preset variables."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:142
#: ../../../docs/configuring-playbook-bot-baibot.md:168
#: ../../../docs/configuring-playbook-bot-baibot.md:201
#: ../../../docs/configuring-playbook-bot-baibot.md:231
msgid "Here's an example **addition** to your `vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:160
#: ../../../docs/configuring-playbook-bot-baibot.md:193
#: ../../../docs/configuring-playbook-bot-baibot.md:221
#: ../../../docs/configuring-playbook-bot-baibot.md:251
msgid ""
"If you'd like to use more than one model, take a look at the [Configuring"
" additional agents (without a preset)](#configuring-additional-agents-"
"without-a-preset) section below."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:162
#: ../../../docs/configuring-playbook-bot-baibot.md:195
#: ../../../docs/configuring-playbook-bot-baibot.md:223
#: ../../../docs/configuring-playbook-bot-baibot.md:253
msgid ""
"💡 You may also wish to use this new agent for [🤝 Configuring initial "
"default handlers](#-configuring-initial-default-handlers)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:164
msgid "Groq"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:166
msgid ""
"You can statically-define a single [🤖 "
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "
"instance powered by the [Groq "
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#groq)"
" with the help of the playbook's preset variables."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:191
msgid ""
"Because this is a "
"[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"
"#static-configuration)-defined agent, it will be given a `static/` ID "
"prefix and will be named `static/groq`."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:197
msgid "Mistral"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:199
msgid ""
"You can statically-define a single [🤖 "
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "
"instance powered by the [🇫🇷 Mistral "
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#mistral)"
" with the help of the playbook's preset variables."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:219
msgid ""
"Because this is a "
"[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"
"#static-configuration)-defined agent, it will be given a `static/` ID "
"prefix and will be named `static/mistral`."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:225
msgid "OpenAI"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:227
msgid ""
"You can statically-define a single [🤖 "
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "
"instance powered by the [OpenAI "
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openai)"
" with the help of the playbook's preset variables."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:229
msgid ""
"The OpenAI provider is **only meant to be used with OpenAI's official "
"API** and compatibility with other services (which do not fully adhere to"
" the OpenAI API spec completely) is limited. **If you're targeting an "
"OpenAI-compatible service**, use the [OpenAI Compatible](#openai-"
"compatible) provider instead."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:249
msgid ""
"Because this is a "
"[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"
"#static-configuration)-defined agent, it will be given a `static/` ID "
"prefix and will be named `static/openai`."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:255
msgid "OpenAI Compatible"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:257
msgid ""
"You can statically-define a single [🤖 "
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "
"instance powered by the [OpenAI Compatible "
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md"
"#openai-compatible) with the help of the playbook's preset variables."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:259
msgid ""
"This provider allows you to use OpenAI-compatible API services like "
"[OpenRouter](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openrouter),"
" [Together "
"AI](https://github.com/etkecc/baibot/blob/main/docs/providers.md"
"#together-ai), etc."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:261
msgid ""
"Some of these popular services already have **shortcut** providers (see "
"[supported "
"providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md"
"#supported-providers) leading to this one behind the scenes - this make "
"it easier to get started."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:263
msgid ""
"As of this moment, the playbook does not include presets for any of these"
" services, so you'll need to [Configuring additional agents (without a "
"preset)](#configuring-additional-agents-without-a-preset)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:265
msgid "Configuring additional agents (without a preset)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:267
msgid ""
"The Ansible role may be lacking preset variables for some [☁️ "
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md), "
"or you may wish to statically-define an agent on the same provider twice "
"(or more) with different configuration."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:269
msgid ""
"It's possible to inject your own agent configuration using the "
"`matrix_bot_baibot_config_agents_static_definitions_custom` Ansible "
"variable."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:271
msgid ""
"You can also define providers at runtime, by chatting with the bot, so "
"using Ansible is not a requirement."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:273
msgid ""
"Below is an an **example** demonstrating **statically-defining agents via"
" Ansible without using presets**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:312
msgid ""
"Because these are "
"[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"
"#static-configuration)-defined agents, they will be given a `static/` ID "
"prefix and will be named `static/my-openai-gpt-3.5-turbo-agent` and "
"`static/my-ollama-agent`, respectively."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:314
msgid ""
"💡 To figure out what to put in the `config` section, refer to the [☁️ "
"provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md) "
"page, which contains **sample configuration YAML for each provider**."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:316
msgid ""
"As with any [🤖 "
"agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md), "
"defining them means they exist. To actually make use of them, they need "
"to be configured as handlers globally or in a specific room - see [Mixing"
" & matching "
"models](https://github.com/etkecc/baibot/blob/main/docs/features.md#mixing"
"--matching-models)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:318
msgid ""
"💡 You may also wish to use these new agents for [🤝 Configuring initial "
"default handlers](#-configuring-initial-default-handlers)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:320
msgid "🤝 Configuring initial default handlers"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:322
msgid ""
"This section is only useful if you're [🤖 Configuring agents via Ansible"
"](#-configuring-agents-via-ansible), as it lets you put these agents to "
"use as soon as the bot starts (by adjusting the bot's **initial global "
"configuration**)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:324
msgid "If you're not configuring agents via Ansible, you can skip this section."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:326
msgid ""
"This section is only useful the first time around. **Once initially "
"configured the global configuration cannot be managed Ansible**, but only"
" via bot commands."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:328
msgid ""
"baibot supports [various "
"purposes](https://github.com/etkecc/baibot/blob/main/docs/features.md):"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:330
msgid ""
"[💬 text-"
"generation](https://github.com/etkecc/baibot/blob/main/docs/features.md"
"#-text-generation): communicating with you via text"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:332
msgid ""
"[🦻 speech-to-"
"text](https://github.com/etkecc/baibot/blob/main/docs/features.md"
"#-speech-to-text): turning your voice messages into text"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:334
msgid ""
"[🗣️ text-to-"
"speech](https://github.com/etkecc/baibot/blob/main/docs/features.md"
"#-text-to-speech): turning bot or users text messages into voice messages"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:336
msgid ""
"[🖌️ image-"
"generation](https://github.com/etkecc/baibot/blob/main/docs/features.md"
"#-image-generation): generating images based on instructions"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:338
msgid ""
"❓ catch-all: special purposes, indicating use as a fallback (when no "
"specific handler is configured)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:340
msgid ""
"[Mixing & matching "
"models](https://github.com/etkecc/baibot/blob/main/docs/features.md#mixing"
"--matching-models) is made possible by the bot's ability to have "
"different [🤝 "
"handlers](https://github.com/etkecc/baibot/blob/main/docs/configuration/handlers.md)"
" configured for different purposes."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:342
msgid ""
"This configuration can be done as a global fallback, or per-room. Both of"
" these [🛠️ "
"configurations](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md)"
" are managed at runtime (viat chat), but **the global configuration can "
"have some initial defaults configured via Ansible**."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:344
msgid ""
"You can configure the **initial values** for these via Ansible, via the "
"`matrix_bot_baibot_config_initial_global_config_handler_*` variables."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:346
msgid "Example **additional** `vars.yml` configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:363
msgid ""
"**Note**: these are initial defaults for the bot's global configuration. "
"As such, changing any of these values subsequently has no effect on the "
"bot's behavior. **Once initially configured the global configuration "
"cannot be managed Ansible**, but only via bot commands."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:365
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:367
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:374
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:376
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:378
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:380
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-bot-baibot.md:382
msgid ""
"If you change the bot password (`matrix_bot_baibot_config_user_password` "
"in your `vars.yml` file) subsequently, the bot user's credentials on the "
"homeserver won't be updated automatically. If you'd like to change the "
"bot user's password, use a tool like [synapse-admin](configuring-"
"playbook-synapse-admin.md) to change it, and then update "
"`matrix_bot_baibot_config_user_password` to let the bot know its new "
"password."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:384
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:386
msgid "To use the bot, invite the `@baibot:example.com` bot user into a room."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:388
msgid ""
"If you're an allowed bot [👥 "
"user](https://github.com/etkecc/baibot/blob/main/docs/access.md#user) "
"(see [👥 Initial users configuration](#-initial-users-configuration)), the"
" bot will accept your invitation and join the room."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:390
msgid ""
"After joining, the bot will introduce itself and show information about "
"the [✨ "
"features](https://github.com/etkecc/baibot/blob/main/docs/features.md) "
"that are enabled for it."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:392
msgid ""
"If you've [🤖 configured one or more agents via Ansible](#-configuring-"
"agents-via-ansible) and have [🤝 configured initial default handlers"
"](#configuring-initial-default-handlers), the bot will immediately be "
"able to make use of these agents for this new room. Otherwise, you will "
"need to configure agents and/or handlers via chat commands."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:394
msgid ""
"Send `!bai help` to the room at any time to see the bot's help menu for "
"additional commands."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:396
msgid ""
"You can also refer to the upstream "
"[baibot](https://github.com/etkecc/baibot) project's documentation."
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:398
msgid "Debugging"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:400
msgid ""
"As with all other services, you can find service logs in [systemd-"
"journald](https://www.freedesktop.org/software/systemd/man/systemd-"
"journald.service.html) by running something like `journalctl -fu matrix-"
"bot-baibot`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:402
msgid ""
"The default logging level for this service is `info`, but you can "
"increase it to `debug` (or even `trace`) with the following additional "
"configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-baibot.md:416
msgid ""
"**Alternatively**, you can use a single variable to set the logging level"
" for all of the above (bot + all libraries):"
msgstr ""

188
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-buscarron.po Normal file
View File

@@ -0,0 +1,188 @@
# 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/configuring-playbook-bot-buscarron.md:1
msgid "Setting up Buscarron (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:3
msgid ""
"The playbook can install and configure "
"[Buscarron](https://github.com/etkecc/buscarron) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:5
msgid ""
"Buscarron is bot that receives HTTP POST submissions of web forms and "
"forwards them to a Matrix room."
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:9
msgid ""
"To enable Buscarron, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:32
msgid "Adjusting the Buscarron URL"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:34
msgid ""
"By default, this playbook installs Buscarron on the `buscarron.` "
"subdomain (`buscarron.example.com`) and requires you to [adjust your DNS "
"records](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:36
msgid ""
"By tweaking the `matrix_bot_buscarron_hostname` and "
"`matrix_bot_buscarron_path_prefix` variables, you can easily make the "
"service available at a **different hostname and/or path** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:38
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:49
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:51
msgid ""
"Once you've decided on the domain and path, **you may need to adjust your"
" DNS** records to point the Buscarron domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:53
msgid ""
"By default, you will need to create a CNAME record for `buscarron`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:55
msgid ""
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
" extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:57
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:59
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:66
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:68
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:70
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:72
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-bot-buscarron.md:74
msgid ""
"If you change the bot password (`matrix_bot_buscarron_password` in your "
"`vars.yml` file) subsequently, the bot user's credentials on the "
"homeserver won't be updated automatically. If you'd like to change the "
"bot user's password, use a tool like [synapse-admin](configuring-"
"playbook-synapse-admin.md) to change it, and then update "
"`matrix_bot_buscarron_password` to let the bot know its new password."
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:76
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:78
msgid ""
"To use the bot, invite the `@bot.buscarron:example.com` to the room you "
"specified in a config, after that any point your form to the form url, "
"example for the `contact` form:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:86
msgid ""
"**Note**: to fight against spam, Buscarron is **very aggressive when it "
"comes to banning** and will ban you if:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:88
msgid "if you hit the homepage (HTTP `GET` request to `/`)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:89
msgid ""
"if you submit a form to the wrong URL (`POST` request to `/non-existing-"
"form`)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:90
msgid ""
"if `hasemail` is enabled for the form (like in the example above) and you"
" don't submit an `email` field"
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:92
msgid ""
"If you get banned, you'd need to restart the process by running the "
"playbook with `--tags=start` or running `systemctl restart matrix-bot-"
"buscarron` on the server."
msgstr ""
#: ../../../docs/configuring-playbook-bot-buscarron.md:94
msgid ""
"You can also refer to the upstream "
"[documentation](https://github.com/etkecc/buscarron)."
msgstr ""

159
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-chatgpt.po Normal file
View File

@@ -0,0 +1,159 @@
# 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/configuring-playbook-bot-chatgpt.md:1
msgid "Setting up matrix-bot-chatgpt (optional, unmaintained)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:3
msgid ""
"**Note**: [matrix-chatgpt-bot](https://github.com/matrixgpt/matrix-"
"chatgpt-bot) is now an archived (**unmaintained**) project. Talking to "
"ChatGPT (and many other LLM providers) can happen via the much more "
"featureful [baibot](https://github.com/etkecc/baibot), which can be "
"installed using [this playbook](configuring-playbook-bot-baibot.md). "
"Consider using that bot instead of this one."
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:5
msgid ""
"The playbook can install and configure [matrix-chatgpt-"
"bot](https://github.com/matrixgpt/matrix-chatgpt-bot) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:7
msgid ""
"Talk to [ChatGPT](https://openai.com/blog/chatgpt/) via your favourite "
"Matrix client!"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:9
msgid "Register the bot account"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:11
msgid ""
"The playbook does not automatically create users for you. The bot "
"requires an access token to be able to connect to your homeserver."
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:13
msgid "You **need to register the bot user manually** before setting up the bot."
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:15
msgid ""
"Choose a strong password for the bot. You can generate a good password "
"with a command like this: `pwgen -s 64 1`."
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:17
msgid "You can use the playbook to [register a new user](registering-users.md):"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:23
msgid "Get an access token and create encryption keys"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:25
msgid ""
"Refer to the documentation on [how to obtain an access token](obtaining-"
"access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:27
msgid ""
"To make sure the bot can read encrypted messages, it will need an "
"encryption key, just like any other new user. While obtaining the access "
"token, follow the prompts to setup a backup key. More information can be "
"found in the [Element "
"documentation](https://element.io/help#encryption6)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:29
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:31
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:52
msgid "You will need to get tokens for ChatGPT."
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:54
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:56
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:63
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:65
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:67
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:69
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-bot-chatgpt.md:71
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:73
msgid ""
"To use the bot, invite the `@bot.chatgpt:example.com` to the room you "
"specified in a config, after that start speaking to it, use the prefix if"
" you configured one or mention the bot."
msgstr ""
#: ../../../docs/configuring-playbook-bot-chatgpt.md:75
msgid ""
"You can also refer to the upstream "
"[documentation](https://github.com/matrixgpt/matrix-chatgpt-bot)."
msgstr ""

553
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po Normal file
View File

@@ -0,0 +1,553 @@
# 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/configuring-playbook-bot-draupnir.md:1
msgid "Setting up Draupnir (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:3
msgid ""
"The playbook can install and configure the [Draupnir](https://github.com"
"/the-draupnir-project/Draupnir) moderation bot for you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:5
msgid ""
"See the project's [documentation](https://github.com/the-draupnir-"
"project/Draupnir) to learn what it does and why it might be useful to "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:7
msgid ""
"This documentation page is about installing Draupnir in bot mode. As an "
"alternative, you can run a multi-instance Draupnir deployment by "
"installing [Draupnir in appservice mode](./configuring-playbook-"
"appservice-draupnir-for-all.md) (called Draupnir-for-all) instead."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:9
msgid "If your migrating from Mjolnir skip to step 5b."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:11
msgid "Register the bot account"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:13
msgid ""
"The playbook does not automatically create users for you. The bot "
"requires an access token to be able to connect to your homeserver."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:15
msgid "You **need to register the bot user manually** before setting up the bot."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:17
msgid ""
"Choose a strong password for the bot. You can generate a good password "
"with a command like this: `pwgen -s 64 1`."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:19
msgid "You can use the playbook to [register a new user](registering-users.md):"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:25
msgid ""
"If you would like Draupnir to be able to deactivate users, move aliases, "
"shutdown rooms, show abuse reports ([see below](#abuse-reports)), etc "
"then it must be a server admin so you need to change `admin=no` to "
"`admin=yes` in the command above."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:27
msgid "Get an access token"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:29
msgid ""
"Refer to the documentation on [how to obtain an access token](obtaining-"
"access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:31
msgid "Make sure the account is free from rate limiting"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:33
msgid ""
"You will need to prevent Synapse from rate limiting the bot's account. "
"This is not an optional step. If you do not do this step Draupnir will "
"crash. This can be done using Synapse's [admin API](https://matrix-"
"org.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
"ratelimiting-for-users). Please ask for help if you are uncomfortable "
"with these steps or run into issues."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:35
msgid ""
"If your Synapse Admin API is exposed to the internet for some reason like"
" running the Synapse Admin Role [Link](configuring-playbook-synapse-"
"admin.md) or running "
"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
" true` in your playbook config. If your API is not externally exposed you"
" should still be able to on the local host for your synapse run these "
"commands."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:37
msgid ""
"The following command works on semi up to date Windows 10 installs and "
"All Windows 11 installations and other systems that ship curl. `curl "
"--header \"Authorization: Bearer <access_token>\" -X POST "
"https://matrix.example.com/_synapse/admin/v1/users/@bot.draupnir:example.com/override_ratelimit`"
" Replace `@bot.draupnir:example.com` with the MXID of your Draupnir and "
"example.com with your homeserver domain. You can easily obtain an access "
"token for a homeserver admin account the same way you can obtain an "
"access token for Draupnir itself. If you made Draupnir Admin you can just"
" use the Draupnir token."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:39
msgid "Create a management room"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:41
msgid ""
"Using your own account, create a new invite only room that you will use "
"to manage the bot. This is the room where you will see the status of the "
"bot and where you will send commands to the bot, such as the command to "
"ban a user from another room. 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-bot-draupnir.md:43
msgid ""
"If you make the management room encrypted (E2EE), then you MUST enable "
"and use Pantalaimon (see below)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:45
msgid ""
"Once you have created the room you need to copy the room ID so you can "
"tell the bot to use that room. In Element Web you can do this by going to"
" the room's settings, clicking Advanced, and then copying the internal "
"room ID. The room ID will look something like `!qporfwt:example.com`."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:47
msgid ""
"Finally invite the `@bot.draupnir:example.com` account you created "
"earlier into the room."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:49
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:51
msgid ""
"Decide whether you want Draupnir to be capable of operating in end-to-end"
" encrypted (E2EE) rooms. This includes the management room and the "
"moderated rooms. To support E2EE, Draupnir needs to [use Pantalaimon"
"](configuring-playbook-pantalaimon.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:53
msgid "a. Configuration with E2EE support"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:55
msgid ""
"When using Pantalaimon, Draupnir will log in to its bot account itself "
"through Pantalaimon, so configure its username and password."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:57
#: ../../../docs/configuring-playbook-bot-draupnir.md:92
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:76
msgid ""
"The playbook's `group_vars` will configure other required settings. If "
"using this role separately without the playbook, you also need to "
"configure the two URLs that Draupnir uses to reach the homeserver, one "
"through Pantalaimon and one \"raw\". This example is taken from the "
"playbook's `group_vars`:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:88
msgid "b. Configuration without E2EE support"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:90
msgid ""
"When NOT using Pantalaimon, Draupnir does not log in by itself and you "
"must give it an access token for its bot account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:94
msgid ""
"You must replace `ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
"`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own values."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:104
msgid "c. Migrating from Mjolnir (Only required if migrating.)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:106
msgid ""
"Replace your `matrix_bot_mjolnir` config with `matrix_bot_draupnir` "
"config. Also disable Mjolnir if you're doing migration."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:108
msgid ""
"That is all you need to do due to that Draupnir can complete migration on"
" its own."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:110
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:112
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:119
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:121
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:123
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:125
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-bot-draupnir.md:127
msgid ""
"If you change the Pantalaimon's password "
"(`matrix_bot_draupnir_pantalaimon_password` in your `vars.yml` file) "
"subsequently, its credentials on the homeserver won't be updated "
"automatically. If you'd like to change the password, use a tool like "
"[synapse-admin](configuring-playbook-synapse-admin.md) to change it, and "
"then update `matrix_bot_draupnir_pantalaimon_password` to let Pantalaimon"
" know its new password."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:129
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:131
msgid ""
"You can refer to the upstream [documentation](https://the-draupnir-"
"project.github.io/draupnir-documentation/) for additional ways to use and"
" configure Draupnir and for a more detailed usage guide."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:133
msgid "Below is a **non-exhaustive quick-start guide** for the impatient."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:135
msgid "Making Draupnir join and protect a room"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:137
msgid ""
"Draupnir can be told to self-join public rooms, but it's better to follow"
" this flow which works well for all kinds of rooms:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:139
msgid ""
"Invite the bot to the room manually ([inviting Draupnir to rooms](https"
"://the-draupnir-project.github.io/draupnir-documentation/moderator"
"/managing-protected-rooms#inviting-draupnir-to-rooms)). Before joining, "
"the bot *may* ask for confirmation in the Management Room"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:141
msgid ""
"[Give the bot permissions to do its job](#giving-draupnir-permissions-to-"
"do-its-job)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:143
msgid ""
"Tell it to protect the room (using the [rooms command](https://the-"
"draupnir-project.github.io/draupnir-documentation/moderator/managing-"
"protected-rooms#using-the-draupnir-rooms-command)) by sending the "
"following command to the Management Room: `!draupnir rooms add "
"!qporfwt:example.com`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:145
msgid ""
"To have Draupnir provide useful room protection, you need do to a bit "
"more work (at least the first time around). You may wish to [Subscribe to"
" a public policy list](#subscribing-to-a-public-policy-list), [Create "
"your own own policy and rules](#creating-your-own-policy-lists-and-rules)"
" and [Enabling built-in protections](#enabling-built-in-protections)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:147
msgid "Giving Draupnir permissions to do its job"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:149
msgid ""
"For Draupnir to do its job, you need to [give it permissions](https"
"://the-draupnir-project.github.io/draupnir-documentation/moderator"
"/managing-protected-rooms#giving-draupnir-permissions) in rooms it's "
"protecting. This involves **giving it an Administrator power level**."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:151
msgid ""
"**We recommend setting this power level as soon as the bot joins your "
"room** (and before you create new rules), so that it can apply rules as "
"soon as they are available. If the bot is under-privileged, it may fail "
"to apply protections and may not retry for a while (or until your restart"
" it)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:153
msgid "Subscribing to a public policy list"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:155
msgid ""
"We recommend **subscribing to a public [policy list](https://the-"
"draupnir-project.github.io/draupnir-documentation/concepts/policy-"
"lists)** using the [watch command](https://the-draupnir-project.github.io"
"/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-"
"watch-command-to-subscribe-to-policy-rooms)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:157
msgid ""
"Polcy lists are maintained in Matrix rooms. A popular policy list is "
"maintained in the public `#community-moderation-effort-bl:neko.dev` room."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:159
msgid ""
"You can tell Draupnir to subscribe to it by sending the following command"
" to the Management Room: `!draupnir watch #community-moderation-effort-"
"bl:neko.dev`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:161
msgid "Creating your own policy lists and rules"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:163
msgid ""
"We also recommend **creating your own policy lists** with the [list "
"create](https://the-draupnir-project.github.io/draupnir-"
"documentation/moderator/managing-policy-lists#using-draupnirs-list-"
"create-command-to-create-a-policy-room) command."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:165
msgid ""
"You can do so by sending the following command to the Management Room: "
"`!draupnir list create my-bans my-bans-bl`. This will create a policy "
"list having a name (shortcode) of `my-bans` and stored in a public `#my-"
"bans-bl:example.com` room on your server. As soon as you run this "
"command, the bot will invite you to the policy list room."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:167
msgid ""
"A policy list does nothing by itself, so the next step is **adding some "
"rules to your policy list**. Policies target a so-called `entity` (one "
"of: `user`, `room` or `server`). These entities are mentioned on the "
"[policy lists](https://the-draupnir-project.github.io/draupnir-"
"documentation/concepts/policy-lists) documentation page and in the Matrix"
" Spec [here](https://spec.matrix.org/v1.11/client-server-api/#mban-"
"recommendation)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:169
msgid ""
"The simplest and most useful entity to target is `user`. Below are a few "
"examples using the [ban command](https://the-draupnir-project.github.io"
"/draupnir-documentation/moderator/managing-users#the-ban-command) and "
"targeting users."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:171
msgid ""
"To create rules, you run commands in the Management Room (**not** in the "
"policy list room)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:173
msgid ""
"(ban a single user on a given homeserver): `!draupnir ban "
"@charles:example.com my-bans Rude to others`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:174
msgid ""
"(ban all users on a given homeserver by using a [wildcard](https://the-"
"draupnir-project.github.io/draupnir-documentation/moderator/managing-"
"users#wildcards)): `!draupnir ban @*:example.org my-bans Spam server - "
"all users are fake`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:176
msgid "As a result of running these commands, you may observe:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:178
msgid ""
"Draupnir creating `m.policy.rule.user` state events in the `#my-bans-"
"bl:example.com` room on your server"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:179
msgid ""
"applying these rules against all rooms that Draupnir is an Administrator "
"in"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:181
msgid ""
"You can undo bans with the [unban command](https://the-draupnir-"
"project.github.io/draupnir-documentation/moderator/managing-users#the-"
"unban-command)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:183
msgid "Enabling built-in protections"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:185
msgid ""
"You can also **turn on various built-in [protections](https://the-"
"draupnir-project.github.io/draupnir-documentation/protections)** like "
"`JoinWaveShortCircuit` (\"If X amount of users join in Y time, set the "
"room to invite-only\")."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:187
msgid ""
"To **see which protections are available and which are enabled**, send a "
"`!draupnir protections` command to the Management Room."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:189
msgid ""
"To **see the configuration options for a given protection**, send a "
"`!draupnir config get PROTECTION_NAME` (e.g. `!draupnir config get "
"JoinWaveShortCircuit`)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:191
msgid ""
"To **set a specific option for a given protection**, send a command like "
"this: `!draupnir config set PROTECTION_NAME.OPTION VALUE` (e.g. "
"`!draupnir config set JoinWaveShortCircuit.timescaleMinutes 30`)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:193
msgid ""
"To **enable a given protection**, send a command like this: `!draupnir "
"enable PROTECTION_NAME` (e.g. `!draupnir enable JoinWaveShortCircuit`)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:195
msgid ""
"To **disable a given protection**, send a command like this: `!draupnir "
"disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:197
msgid "Extending the configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:199
msgid ""
"You can configure additional options by adding the "
"`matrix_bot_draupnir_configuration_extension_yaml` variable to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:201
msgid ""
"For example to change Draupnir's `recordIgnoredInvites` option to `true` "
"you would add the following to your `vars.yml` file."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:215
msgid "Abuse Reports"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:217
msgid "Draupnir supports two methods to receive reports in the management room."
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:219
msgid ""
"The first method intercepts the report API endpoint of the client-server "
"API, which requires integration with the reverse proxy in front of the "
"homeserver. If you are using traefik, this playbook can set this up for "
"you:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-draupnir.md:225
msgid ""
"The other method polls an synapse admin API endpoint and is hence only "
"available when using synapse and when the Draupnir user is an admin user "
"(see step 1). To enable it, set `pollReports: true` in Draupnir's config:"
msgstr ""

206
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po Normal file
View File

@@ -0,0 +1,206 @@
# Translations template for PROJECT.
# Copyright (C) 2024 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PROJECT VERSION\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\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-Team: LANGUAGE <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-bot-go-neb.md:1
msgid "Setting up Go-NEB (optional, unmaintained)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:3
msgid ""
"**Note**: [Go-NEB](https://github.com/matrix-org/go-neb) is now an "
"archived (**unmaintained**) project. We recommend not bothering with "
"installing it. While not a 1:1 replacement, the bridge's author suggests "
"taking a look at [matrix-hookshot](https://github.com/matrix-org/matrix-"
"hookshot) as a replacement, which can also be installed using [this "
"playbook](configuring-playbook-bridge-hookshot.md). Consider using that "
"bot instead of this one."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:5
msgid ""
"The playbook can install and configure [Go-NEB](https://github.com"
"/matrix-org/go-neb) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:7
msgid ""
"Go-NEB is a Matrix bot written in Go. It is the successor to Matrix-NEB, "
"the original Matrix bot written in Python."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:9
msgid ""
"See the project's [documentation](https://github.com/matrix-org/go-neb) "
"to learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:11
msgid "Registering the bot account"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:13
msgid ""
"The playbook does not automatically create users for you. The bot "
"requires at least 1 access token to be able to connect to your "
"homeserver."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:15
msgid "You **need to register the bot user manually** before setting up the bot."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:17
msgid ""
"Choose a strong password for the bot. You can generate a good password "
"with a command like this: `pwgen -s 64 1`."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:19
msgid "You can use the playbook to [register a new user](registering-users.md):"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:25
msgid ""
"Once the user is created you can [obtain an access token](obtaining-"
"access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:27
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:29
msgid ""
"To enable Go-NEB, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:193
msgid "Adjusting the Go-NEB URL"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:195
msgid ""
"By default, this playbook installs Go-NEB on the `goneb.` subdomain "
"(`goneb.example.com`) and requires you to [adjust your DNS records"
"](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:197
msgid ""
"By tweaking the `matrix_bot_go_neb_hostname` and "
"`matrix_bot_go_neb_path_prefix` variables, you can easily make the "
"service available at a **different hostname and/or path** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:199
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:210
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:212
msgid ""
"Once you've decided on the domain and path, **you may need to adjust your"
" DNS** records to point the Go-NEB domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:214
msgid ""
"By default, you will need to create a CNAME record for `goneb`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:216
msgid ""
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
" extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:218
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:220
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:227
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:229
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:231
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:233
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-bot-go-neb.md:235
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:237
msgid ""
"To use the bot, invite it to any existing Matrix room (`/invite @bot.go-"
"neb:example.com` where `example.com` is your base domain, not the "
"`matrix.` domain). Make sure you are granted with the sufficient "
"permission if you are not the room owner."
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:239
msgid ""
"Basic usage is like this: `!echo hi` or `!imgur puppies` or `!giphy "
"matrix`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:241
msgid ""
"If you enabled the github_cmd service you can get the supported commands "
"via `!github help`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-go-neb.md:243
msgid ""
"You can also refer to the upstream [Documentation](https://github.com"
"/matrix-org/go-neb)."
msgstr ""

169
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po Normal file
View File

@@ -0,0 +1,169 @@
# 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/configuring-playbook-bot-honoroit.md:1
msgid "Setting up Honoroit (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:3
msgid ""
"The playbook can install and configure "
"[Honoroit](https://github.com/etkecc/honoroit) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:5
msgid "It's a bot you can use to setup **your own helpdesk on matrix**"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:7
msgid ""
"See the project's [documentation](https://github.com/etkecc/honoroit#how-"
"it-looks-like) to learn what it does with screenshots and why it might be"
" useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:9
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:11
msgid ""
"To enable Honoroit, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:26
msgid "Adjusting the Honoroit URL"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:28
msgid ""
"By default, this playbook installs Honoroit on the `matrix.` subdomain, "
"at the `/honoroit` path (https://matrix.example.com/honoroit). This makes"
" it easy to install it, because it **doesn't require additional DNS "
"records to be set up**. If that's okay, you can skip this section."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:30
msgid ""
"By tweaking the `matrix_bot_honoroit_hostname` and "
"`matrix_bot_honoroit_path_prefix` variables, you can easily make the "
"service available at a **different hostname and/or path** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:32
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:40
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:42
msgid ""
"If you've changed the default hostname, **you may need to adjust your "
"DNS** records to point the Honoroit domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:44
msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:46
msgid ""
"If you've decided to use the default hostname, you won't need to do any "
"extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:48
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:50
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:57
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:59
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:61
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:63
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-bot-honoroit.md:65
msgid ""
"If you change the bot password (`matrix_bot_honoroit_password` in your "
"`vars.yml` file) subsequently, the bot user's credentials on the "
"homeserver won't be updated automatically. If you'd like to change the "
"bot user's password, use a tool like [synapse-admin](configuring-"
"playbook-synapse-admin.md) to change it, and then update "
"`matrix_bot_honoroit_password` to let the bot know its new password."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:67
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:69
msgid ""
"To use the bot, invite the `@honoroit:example.com` to the room you "
"specified in config, after that any Matrix user can send a message to the"
" `@honoroit:example.com` to start a new thread in that room."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:71
msgid ""
"Send `!ho help` to the room to see the bot's help menu for additional "
"commands."
msgstr ""
#: ../../../docs/configuring-playbook-bot-honoroit.md:73
msgid ""
"You can also refer to the upstream "
"[documentation](https://github.com/etkecc/honoroit#features)."
msgstr ""

148
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po Normal file
View File

@@ -0,0 +1,148 @@
# 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/configuring-playbook-bot-matrix-registration-bot.md:1
msgid "Setting up matrix-registration-bot (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:3
msgid ""
"The playbook can install and configure [matrix-registration-"
"bot](https://github.com/moan0s/matrix-registration-bot) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:5
msgid ""
"The bot allows you to easily **create and manage registration tokens** "
"aka. invitation codes. It can be used for an invitation-based server, "
"where you invite someone by sending them a registration token (tokens "
"look like this: `rbalQ0zkaDSRQCOp`). They can register as per normal but "
"have to provide a valid registration token in the final step of the "
"registration process."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:7
msgid ""
"See the project's [documentation](https://github.com/moan0s/matrix-"
"registration-bot#supported-commands) to learn what it does and why it "
"might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:9
msgid "Configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:11
msgid ""
"To enable the bot, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:30
msgid "The bot account will be created automatically."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:32
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:34
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:41
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:43
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:45
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:47
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-bot-matrix-registration-bot.md:49
msgid ""
"If you change the bot password "
"(`matrix_bot_matrix_registration_bot_bot_password` in your `vars.yml` "
"file) subsequently, the bot user's credentials on the homeserver won't be"
" updated automatically. If you'd like to change the bot user's password, "
"use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to"
" change it, and then update "
"`matrix_bot_matrix_registration_bot_bot_password` to let the bot know its"
" new password."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:51
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:53
msgid ""
"To use the bot, start a chat with `@bot.matrix-registration-"
"bot:example.com` (where `example.com` is your base domain, not the "
"`matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:55
msgid "In this room send `help` and the bot will reply with all options."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:57
msgid ""
"You can also refer to the upstream [Usage "
"documentation](https://github.com/moan0s/matrix-registration-bot"
"#supported-commands)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:59
msgid ""
"If you have any questions, or if you need help setting it up, read the "
"[troublshooting guide](https://github.com/moan0s/matrix-registration-"
"bot/blob/main/docs/troubleshooting.md) or join [#matrix-registration-"
"bot:hyteck.de](https://matrix.to/#/#matrix-registration-bot:hyteck.de)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:61
msgid ""
"To clean the cache (session & encryption data) after you changed the "
"bot's username, changed the login method from access_token to password "
"etc… you can use:"
msgstr ""

136
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po Normal file
View File

@@ -0,0 +1,136 @@
# 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/configuring-playbook-bot-matrix-reminder-bot.md:1
msgid "Setting up matrix-reminder-bot (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:3
msgid ""
"The playbook can install and configure [matrix-reminder-"
"bot](https://github.com/anoadragon453/matrix-reminder-bot) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:5
msgid ""
"It's a bot you can use to **schedule one-off & recurring reminders and "
"alarms**."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:7
msgid ""
"See the project's [documentation](https://github.com/anoadragon453"
"/matrix-reminder-bot#usage) to learn what it does and why it might be "
"useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:9
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:11
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:26
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:28
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:35
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:37
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:39
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:41
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-bot-matrix-reminder-bot.md:43
msgid ""
"If you change the bot password "
"(`matrix_bot_matrix_reminder_bot_matrix_user_password` in your `vars.yml`"
" file) subsequently, the bot user's credentials on the homeserver won't "
"be updated automatically. If you'd like to change the bot user's "
"password, use a tool like [synapse-admin](configuring-playbook-synapse-"
"admin.md) to change it, and then update "
"`matrix_bot_matrix_reminder_bot_matrix_user_password` to let the bot know"
" its new password."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:45
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:47
msgid ""
"To use the bot, start a chat with `@bot.matrix-reminder-bot:example.com` "
"(where `example.com` is your base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:49
msgid ""
"You can also add the bot to any existing Matrix room (`/invite @bot"
".matrix-reminder-bot:example.com`)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:51
msgid "Basic usage is like this: `!remindme in 2 minutes; This is a test`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:53
msgid ""
"Send `!help reminders` to the room to see the bot's help menu for "
"additional commands."
msgstr ""
#: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:55
msgid ""
"You can also refer to the upstream [Usage "
"documentation](https://github.com/anoadragon453/matrix-reminder-"
"bot#usage)."
msgstr ""

214
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-maubot.po Normal file
View File

@@ -0,0 +1,214 @@
# 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/configuring-playbook-bot-maubot.md:1
msgid "Setting up maubot (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:3
msgid ""
"The playbook can install and configure "
"[maubot](https://github.com/maubot/maubot) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:5
msgid ""
"After setting up maubot, you can use the web management interface to make"
" it do things. The default location of the management interface is "
"`matrix.example.com/_matrix/maubot/`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:7
msgid ""
"See the project's "
"[documentation](https://docs.mau.fi/maubot/usage/basic.html) to learn "
"what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:9
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:11
msgid ""
"To enable maubot, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:26
msgid ""
"You can add multiple admins. The admin accounts are only used to access "
"the maubot administration interface."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:28
msgid "Adjusting the maubot URL"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:30
msgid ""
"By default, this playbook installs maubot on the `matrix.` subdomain, at "
"the `/_matrix/maubot/` path (https://matrix.example.com/_matrix/maubot/)."
" This makes it easy to install it, because it **doesn't require "
"additional DNS records to be set up**. If that's okay, you can skip this "
"section."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:32
msgid ""
"By tweaking the `matrix_bot_maubot_hostname` and "
"`matrix_bot_maubot_path_prefix` variables, you can easily make the "
"service available at a **different hostname and/or path** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:34
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:42
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:44
msgid ""
"If you've changed the default hostname, **you may need to adjust your "
"DNS** records to point the maubot domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:46
msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:48
msgid ""
"If you've decided to use the default hostname, you won't need to do any "
"extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:50
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:52
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:59
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:61
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:63
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:65
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-bot-maubot.md:67
msgid ""
"If you change the bot password (`matrix_bot_maubot_initial_password` in "
"your `vars.yml` file) subsequently, the bot user's credentials on the "
"homeserver won't be updated automatically. If you'd like to change the "
"bot user's password, use a tool like [synapse-admin](configuring-"
"playbook-synapse-admin.md) to change it, and then update "
"`matrix_bot_maubot_initial_password` to let the bot know its new "
"password."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:69
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:71
msgid ""
"By default, you can visit `matrix.example.com/_matrix/maubot/` to manage "
"your available plugins, clients and instances."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:73
msgid "You should start in the following order"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:74
msgid ""
"**Create one or more clients**: A client is a Matrix account which the "
"bot will use to message. By default, the playbook creates a `bot.maubot` "
"account (as per the configuration above). You only need to [obtain an "
"access token](#obtaining-an-access-token) for it"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:75
msgid ""
"**Upload some Plugins**: Plugins can be obtained from "
"[here](https://github.com/maubot/maubot#plugins) or any other source."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:76
msgid ""
"**Create an instance**: An instance is the actual bot. You have to "
"specify a client which the bot instance will use and the plugin (how the "
"bot will behave)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:78
msgid "Obtaining an access token"
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:80
msgid ""
"This can be done via `mbc login` then `mbc auth` (see the [maubot "
"documentation](https://docs.mau.fi/maubot/usage/cli/auth.html)). To run "
"these commands, you'll first need to `exec` into the maubot container "
"with `docker exec -it matrix-bot-maubot sh`."
msgstr ""
#: ../../../docs/configuring-playbook-bot-maubot.md:82
msgid ""
"Alternatively, you can follow our generic [obtain an access token"
"](obtaining-access-tokens.md) documentation. Be aware that you'd better "
"use the **Obtain an access token via curl** method (not **Obtain an "
"access token via Element Web**) as the latter will give your bot issues "
"in encrypted rooms. Read "
"[more](https://docs.mau.fi/maubot/usage/basic.html#creating-clients)."
msgstr ""

282
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po Normal file
View File

@@ -0,0 +1,282 @@
# 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/configuring-playbook-bot-mjolnir.md:1
msgid "Setting up Mjolnir (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:3
msgid ""
"The playbook can install and configure the [Mjolnir](https://github.com"
"/matrix-org/mjolnir) moderation bot for you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:5
msgid ""
"See the project's [documentation](https://github.com/matrix-org/mjolnir) "
"to learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:7
msgid "Register the bot account"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:9
msgid ""
"The playbook does not automatically create users for you. The bot "
"requires an access token to be able to connect to your homeserver."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:11
msgid "You **need to register the bot user manually** before setting up the bot."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:13
msgid ""
"Choose a strong password for the bot. You can generate a good password "
"with a command like this: `pwgen -s 64 1`."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:15
msgid "You can use the playbook to [register a new user](registering-users.md):"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:21
msgid ""
"If you would like Mjolnir to be able to deactivate users, move aliases, "
"shutdown rooms, etc then it must be a server admin so you need to change "
"`admin=no` to `admin=yes` in the command above."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:23
msgid "Get an access token"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:25
msgid ""
"Refer to the documentation on [how to obtain an access token](obtaining-"
"access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:27
msgid "Make sure the account is free from rate limiting"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:29
msgid ""
"You will need to prevent Synapse from rate limiting the bot's account. "
"This is not an optional step. If you do not do this step Mjolnir will "
"crash. This can be done using Synapse's [admin API](https://matrix-"
"org.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
"ratelimiting-for-users). Please ask for help if you are uncomfortable "
"with these steps or run into issues."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:31
msgid ""
"If your Synapse Admin API is exposed to the internet for some reason like"
" running the Synapse Admin Role [Link](configuring-playbook-synapse-"
"admin.md) or running "
"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
" true` in your playbook config. If your API is not externally exposed you"
" should still be able to on the local host for your synapse run these "
"commands."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:33
msgid ""
"The following command works on semi up to date Windows 10 installs and "
"All Windows 11 installations and other systems that ship curl. `curl "
"--header \"Authorization: Bearer <access_token>\" -X POST "
"https://matrix.example.com/_synapse/admin/v1/users/@bot.mjolnir:example.com/override_ratelimit`"
" Replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir and "
"example.com with your homeserver domain. You can easily obtain an access "
"token for a homeserver admin account the same way you can obtain an "
"access token for Mjolnir itself. If you made Mjolnir Admin you can just "
"use the Mjolnir token."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:35
msgid "Create a management room"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:37
msgid ""
"Using your own account, create a new invite only room that you will use "
"to manage the bot. This is the room where you will see the status of the "
"bot and where you will send commands to the bot, such as the command to "
"ban a user from another room. 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-bot-mjolnir.md:39
msgid ""
"If you make the management room encrypted (E2EE), then you MUST enable "
"and use Pantalaimon (see below)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:41
msgid ""
"Once you have created the room you need to copy the room ID so you can "
"tell the bot to use that room. In Element Web you can do this by going to"
" the room's settings, clicking Advanced, and then copying the internal "
"room ID. The room ID will look something like `!qporfwt:example.com`."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:43
msgid ""
"Finally invite the `@bot.mjolnir:example.com` account you created earlier"
" into the room."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:45
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:47
msgid ""
"Decide whether you want Mjolnir to be capable of operating in end-to-end "
"encrypted (E2EE) rooms. This includes the management room and the "
"moderated rooms. To support E2EE, Mjolnir needs to [use Pantalaimon"
"](configuring-playbook-pantalaimon.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:49
msgid "a. Configuration with E2EE support"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:51
msgid ""
"When using Pantalaimon, Mjolnir will log in to its bot account itself "
"through Pantalaimon, so configure its username and password."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:53
#: ../../../docs/configuring-playbook-bot-mjolnir.md:88
#: ../../../docs/configuring-playbook-bot-mjolnir.md:102
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:72
msgid ""
"The playbook's `group_vars` will configure other required settings. If "
"using this role separately without the playbook, you also need to "
"configure the two URLs that Mjolnir uses to reach the homeserver, one "
"through Pantalaimon and one \"raw\". This example is taken from the "
"playbook's `group_vars`:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:84
msgid "b. Configuration without E2EE support"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:86
msgid ""
"When NOT using Pantalaimon, Mjolnir does not log in by itself and you "
"must give it an access token for its bot account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:90
msgid ""
"You must replace `ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
"`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own values."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:100
msgid "Adding Mjolnir synapse antispam module (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:112
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:114
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:121
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:123
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:125
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:127
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-bot-mjolnir.md:129
msgid ""
"If you change the Pantalaimon's password "
"(`matrix_bot_mjolnir_pantalaimon_password` in your `vars.yml` file) "
"subsequently, its credentials on the homeserver won't be updated "
"automatically. If you'd like to change the password, use a tool like "
"[synapse-admin](configuring-playbook-synapse-admin.md) to change it, and "
"then update `matrix_bot_mjolnir_pantalaimon_password` to let Pantalaimon "
"know its new password."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:131
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:133
msgid ""
"You can refer to the upstream [documentation](https://github.com/matrix-"
"org/mjolnir) for additional ways to use and configure Mjolnir. Check out "
"their [quickstart guide](https://github.com/matrix-org/mjolnir"
"#quickstart-guide) for some basic commands you can give to the bot."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:135
msgid ""
"You can configure additional options by adding the "
"`matrix_bot_mjolnir_configuration_extension_yaml` variable to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file."
msgstr ""
#: ../../../docs/configuring-playbook-bot-mjolnir.md:137
msgid ""
"For example to change Mjolnir's `recordIgnoredInvites` option to `true` "
"you would add the following to your `vars.yml` file."
msgstr ""

247
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-discord.po Normal file
View File

@@ -0,0 +1,247 @@
# 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/configuring-playbook-bridge-appservice-discord.md:1
msgid "Setting up Appservice Discord bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:3
msgid ""
"**Note**: bridging to [Discord](https://discordapp.com/) can also happen "
"via the [mx-puppet-discord](configuring-playbook-bridge-mx-puppet-"
"discord.md) and [mautrix-discord](configuring-playbook-bridge-mautrix-"
"discord.md) bridges supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:4
msgid ""
"For using as a Bot we are recommend the Appservice Discord bridge (the "
"one being discussed here), because it supports plumbing."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:5
msgid ""
"For personal use we recommend the [mautrix-discord](configuring-playbook-"
"bridge-mautrix-discord.md) bridge, because it is the most fully-featured "
"and stable of the 3 Discord bridges supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:7
msgid ""
"The playbook can install and configure [matrix-appservice-"
"discord](https://github.com/matrix-org/matrix-appservice-discord) for "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:9
msgid ""
"See the project's [documentation](https://github.com/matrix-org/matrix-"
"appservice-discord/blob/master/README.md) to learn what it does and why "
"it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:11
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:13
msgid ""
"Create a Discord Application "
"[here](https://discordapp.com/developers/applications). Then retrieve "
"Client ID, and create a bot from the Bot tab and retrieve the Bot token."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:15
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:17
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:31
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:33
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:40
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:42
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:44
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:46
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-bridge-appservice-discord.md:48
msgid "Self-Service Bridging (Manual)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:50
msgid ""
"Self-service bridging allows you to bridge specific and existing Matrix "
"rooms to specific Discord rooms. To enable it, add the following "
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:56
msgid ""
"**Note**: If self-service bridging is not enabled, `!discord help` "
"commands will return no results."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:58
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:82
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:60
msgid ""
"Once self-service is enabled, start a chat with "
"`@_discord_bot:example.com` and say `!discord help bridge`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:62
msgid "Then, follow the instructions in the help output message."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:64
msgid ""
"If the bot is not already in the Discord server, follow the provided "
"invite link. This may require you to be a administrator of the Discord "
"server."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:66
msgid ""
"On the Discord side, you can say `!matrix help` to get a list of "
"available commands to manage the bridge and Matrix users."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:68
msgid "**Note**: Encrypted Matrix rooms are not supported as of writing."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:70
msgid "Portal Bridging (Automatic)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:72
msgid ""
"Through portal bridging, Matrix rooms will automatically be created by "
"the bot and bridged to the relevant Discord room. This is done by simply "
"joining a room with a specific name pattern "
"(`#_discord_<guildID>_<channelID>`)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:74
msgid ""
"All Matrix rooms created this way are **listed publicly** by default, and"
" you will not have admin permissions to change this. To get more control,"
" [make yourself a room Administrator](#getting-administrator-access-in-a"
"-portal-bridged-room). You can then unlist the room from the directory "
"and change the join rules."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:76
msgid ""
"To disable portal bridging, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:84
msgid "To get started with Portal Bridging:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:86
msgid ""
"To invite the bot to Discord, retrieve the invite link from the `{{ "
"matrix_appservice_discord_config_path }}/invite_link` file on the server "
"(this defaults to `/matrix/appservice-discord/config/invite_link`). You "
"need to peek at the file on the server via SSH, etc., because it's not "
"available via HTTP(S)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:87
msgid ""
"Room addresses follow this syntax: `#_discord_<guildID>_<channelID>`. You"
" can easily find the guild and channel IDs by logging into Discord in a "
"browser and opening the desired channel. The URL will have this format: "
"`discord.com/channels/<guildID>/<channelID>`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:88
msgid ""
"Once you have figured out the appropriate room address, you can join by "
"doing `/join #_discord_<guildID>_<channelID>` in your Matrix client."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:90
msgid "Getting Administrator access in a portal bridged room"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:92
msgid ""
"By default, you won't have Administrator access in rooms created by the "
"bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:94
msgid ""
"To adjust room access privileges or do various other things (change the "
"room name subsequently, etc.), you'd wish to become an Administrator."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-discord.md:96
msgid ""
"There's the Discord bridge's guide for [setting privileges on bridge "
"managed rooms](https://github.com/matrix-org/matrix-appservice-"
"discord/blob/master/docs/howto.md#set-privileges-on-bridge-managed-"
"rooms). To do the same with our container setup, run the following "
"command on the server:"
msgstr ""

103
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-irc.po Normal file
View File

@@ -0,0 +1,103 @@
# 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/configuring-playbook-bridge-appservice-irc.md:1
msgid "Setting up Appservice IRC bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:3
msgid ""
"**Note**: bridging to "
"[IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) can also happen "
"via the [Heisenbridge](configuring-playbook-bridge-heisenbridge.md) "
"bridge supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:5
msgid ""
"The playbook can install and configure the [matrix-appservice-"
"irc](https://github.com/matrix-org/matrix-appservice-irc) bridge for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:7
msgid ""
"See the project's [documentation](https://github.com/matrix-org/matrix-"
"appservice-irc/blob/master/HOWTO.md) to learn what it does and why it "
"might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:9
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:11
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:63
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:65
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:72
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:74
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:76
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:78
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-bridge-appservice-irc.md:80
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-irc.md:82
msgid ""
"To use the bridge, you need to start a chat with `@irc_bot:example.com` "
"(where `example.com` is your base domain, not the `matrix.` domain)."
msgstr ""

230
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po Normal file
View File

@@ -0,0 +1,230 @@
# 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/configuring-playbook-bridge-appservice-kakaotalk.md:1
msgid "Setting up Appservice Kakaotalk bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:3
msgid ""
"The playbook can install and configure [matrix-appservice-"
"kakaotalk](https://src.miscworks.net/fair/matrix-appservice-kakaotalk) "
"for you. `matrix-appservice-kakaotalk` is a bridge to "
"[Kakaotalk](https://www.kakaocorp.com/page/service/service/KakaoTalk?lang=ENG)"
" based on [node-kakao](https://github.com/storycraft/node-kakao) (now "
"unmaintained) and some [mautrix-"
"facebook](https://github.com/mautrix/facebook) code."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:5
msgid ""
"⚠️ **Warning**: there have been recent reports (~2022-09-16) that **using"
" this bridge may get your account banned**."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:7
msgid ""
"See the project's [documentation](https://src.miscworks.net/fair/matrix-"
"appservice-kakaotalk) to learn what it does and why it might be useful to"
" you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:9
msgid "Prerequisite (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:11
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Shared Secret Auth](configuring-playbook-shared-secret-"
"auth.md) for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:13
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:15
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:17
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:23
msgid ""
"You may optionally wish to add some [Additional configuration"
"](#additional-configuration), or to [prepare for double-puppeting](#set-"
"up-double-puppeting) before the initial installation."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:25
msgid "Additional configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:27
msgid ""
"There are some additional things you may wish to configure about the "
"bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:29
msgid "Take a look at:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:31
msgid ""
"`roles/custom/matrix-bridge-appservice-kakaotalk/defaults/main.yml` for "
"some variables that you can customize via your `vars.yml` file"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:32
msgid ""
"`roles/custom/matrix-bridge-appservice-"
"kakaotalk/templates/config.yaml.j2` for the bridge's default "
"configuration. You can override settings (even those that don't have "
"dedicated playbook variables) using the "
"`matrix_appservice_kakaotalk_configuration_extension_yaml` variable"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:34
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:36
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:43
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:45
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:47
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:49
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-bridge-appservice-kakaotalk.md:51
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:53
msgid ""
"To use the bridge, you need to start a chat with "
"`@kakaotalkbot:example.com` (where `example.com` is your base domain, not"
" the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:55
msgid ""
"Send `login --save EMAIL_OR_PHONE_NUMBER` to the bridge bot to enable "
"bridging for your Kakaotalk account. The `--save` flag may be omitted, if"
" you'd rather not save your password."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:57
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:59
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:61
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:63
msgid "Method 1: automatically, by enabling Shared Secret Auth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:65
msgid ""
"The bridge automatically performs Double Puppeting if [Shared Secret Auth"
"](configuring-playbook-shared-secret-auth.md) service is configured and "
"enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:67
msgid ""
"This is the recommended way of setting up Double Puppeting, as it's "
"easier to accomplish, works for all your users automatically, and has "
"less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:69
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:71
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:73
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:75
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:77
msgid ""
"make sure you don't log out the `Appservice-Kakaotalk` device some time "
"in the future, as that would break the Double Puppeting feature"
msgstr ""

326
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-slack.po Normal file
View File

@@ -0,0 +1,326 @@
# 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/configuring-playbook-bridge-appservice-slack.md:1
msgid "Setting up Appservice Slack bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:3
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:75
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:4
msgid ""
"Bridging to [Slack](https://slack.com) can also happen via the [mx-"
"puppet-slack](configuring-playbook-bridge-mx-puppet-slack.md) and "
"[mautrix-slack](configuring-playbook-bridge-mautrix-slack.md) bridges "
"supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:5
msgid ""
"Currently (as of November, 2024) **this component is not available for "
"new installation unless you have already created a classic Slack "
"application** (which the bridge makes use of in order to enable bridging "
"between Slack and Matrix), because the creation of classic Slack "
"applications has been discontinued since June 4 2024. The author of the "
"bridge claims [here](https://github.com/matrix-org/matrix-appservice-"
"slack/issues/789#issuecomment-2172947787) that he plans to support the "
"modern Slack application and until then \"the best (and only) option for "
"new installations is to use the webhook bridging\"."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:7
msgid ""
"The playbook can install and configure [matrix-appservice-"
"slack](https://github.com/matrix-org/matrix-appservice-slack) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:9
msgid ""
"See the project's [documentation](https://github.com/matrix-org/matrix-"
"appservice-slack/blob/master/README.md) to learn what it does and why it "
"might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:11
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:13
msgid "Create a Classic Slack App"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:15
msgid ""
"First, you need to create a Classic Slack App "
"[here](https://api.slack.com/apps?new_classic_app=1)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:17
msgid ""
"Name the app \"matrixbot\" (or anything else you'll remember). Select the"
" team/workspace this app will belong to. Click on bot users and add a new"
" bot user. We will use this account to bridge the the rooms."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:19
msgid ""
"Then, click on Event Subscriptions and enable them and use the request "
"url: `https://matrix.example.com/appservice-slack`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:21
msgid "Add the following events as `Bot User Events` and save:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:23
msgid "team_domain_change"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:24
msgid "message.channels"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:25
msgid "message.groups (if you want to bridge private channels)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:26
msgid "reaction_added"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:27
msgid "reaction_removed"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:29
msgid "Next, click on \"OAuth & Permissions\" and add the following scopes:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:31
msgid "chat:write:bot"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:32
msgid "users:read"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:33
msgid "reactions:write"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:34
msgid "files:write:user (if you want to bridge files)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:36
msgid ""
"**Note**: In order to make Slack files visible to Matrix users, this "
"bridge will make Slack files visible to anyone with the url (including "
"files in private channels). This is different than the current behavior "
"in Slack, which only allows authenticated access to media posted in "
"private channels. See MSC701 for details."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:38
msgid ""
"Click on \"Install App\" and \"Install App to Workspace\". Note the "
"access tokens shown. You will need the Bot User OAuth Access Token and if"
" you want to bridge files, the OAuth Access Token whenever you link a "
"room."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:40
msgid "Create an administration control room on Matrix"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:42
msgid "Create a new Matrix room to act as the administration control room."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:44
msgid ""
"Note its internal room ID. This can be done in Element Web by sending a "
"message, opening the options for that message and choosing \"view "
"source\". The room ID will be displayed near the top."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:46
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:48
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:64
msgid ""
"Other configuration options are available via the "
"`matrix_appservice_slack_configuration_extension_yaml` variable."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:66
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:68
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:77
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:79
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:81
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-bridge-appservice-slack.md:83
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:85
msgid ""
"To use the bridge, you need to send `/invite @slackbot:example.com` to "
"invite the bridge bot user into the admin room."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:87
msgid ""
"If Team Sync is not enabled, for each channel you would like to bridge, "
"perform the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:89
msgid ""
"Create a Matrix room in the usual manner for your client. Take a note of "
"its Matrix room ID - it will look something like `!qporfwt:example.com`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:90
msgid ""
"Invite the bot user to both the Slack and Matrix channels you would like "
"to bridge using `/invite @matrixbot` for Slack and `/invite "
"@slackbot:example.com` for Matrix."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:91
msgid ""
"Determine the \"channel ID\" that Slack uses to identify the channel. You"
" can see it when you open a given Slack channel in a browser. The URL "
"reads like this: `https://app.slack.com/client/XXX/<the channel "
"ID>/details/`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:92
msgid ""
"Issue a link command in the administration control room with these "
"collected values as arguments:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:94
msgid "with file bridging:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:100
msgid "without file bridging:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:106
msgid "These arguments can be shortened to single-letter forms:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:112
msgid "Unlinking"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:114
msgid "Channels can be unlinked again by sending this:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:120
msgid ""
"Unlinking doesn't only disconnect the bridge, but also makes the slackbot"
" leave the bridged Matrix room. So in case you want to re-link later, "
"don't forget to re-invite the slackbot into this room again."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:122
msgid "Troubleshooting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:124
msgid "As always, check the logs: `journalctl -fu matrix-appservice-slack`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:126
msgid "Linking: \"Room is now pending-name\""
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:128
msgid ""
"This typically means that you haven't used the correct Slack channel ID. "
"Unlink the room and recheck 'Determine the \"channel ID\"' from above."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:130
msgid "Messages work from Matrix to Slack, but not the other way around"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:132
msgid "Check you logs, if they say something like"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:134
#, python-format
msgid ""
"`WARN SlackEventHandler Ignoring message from unrecognised Slack channel "
"ID : %s (%s) <the channel ID> <some other ID>`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-slack.md:136
msgid ""
"then unlink your room, reinvite the bot and re-link it again. This may "
"particularly hit you, if you tried to unsuccessfully link your room "
"multiple times without unlinking it after each failed attempt."
msgstr ""

157
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-webhooks.po Normal file
View File

@@ -0,0 +1,157 @@
# 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/configuring-playbook-bridge-appservice-webhooks.md:1
msgid "Setting up Appservice Webhooks bridging (optional, deprecated)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:3
msgid ""
"**Note**: This bridge has been deprecated. We recommend not bothering "
"with installing it. While not a 1:1 replacement, the bridge's author "
"suggests taking a look at [matrix-hookshot](https://github.com/matrix-org"
"/matrix-hookshot) as a replacement, which can also be installed using "
"[this playbook](configuring-playbook-bridge-hookshot.md). Consider using "
"that bridge instead of this one."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:5
msgid ""
"The playbook can install and configure [matrix-appservice-"
"webhooks](https://github.com/turt2live/matrix-appservice-webhooks) for "
"you. This bridge provides support for Slack-compatible webhooks."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:7
msgid ""
"See the project's [documentation](https://github.com/turt2live/matrix-"
"appservice-webhooks/blob/master/README.md) to learn what it does and why "
"it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:9
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:11
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:27
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:29
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:36
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:38
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:40
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:42
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-bridge-appservice-webhooks.md:44
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:46
msgid ""
"To use the bridge, you need to invite the bridge bot user to your room in"
" either way."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:48
msgid ""
"Send `/invite @_webhook:example.com` (**Note**: Make sure you have "
"administration permissions in your room)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:49
msgid ""
"Add the bridge bot to a private channel (personal channels imply you "
"being an administrator)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:51
msgid ""
"You then need to send a message to the bridge bot in order to receive a "
"private message including the webhook link:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:57
msgid "The JSON body for posting messages will have to look like this:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:68
msgid "You can test this via curl like so:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:81
msgid "Setting Webhooks with Dimension integration manager"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:83
msgid ""
"If you're using the [Dimension integration manager](configuring-playbook-"
"dimension.md), you can configure the Webhooks bridge with it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:85
msgid ""
"To configure it, open the Dimension integration manager, and go to "
"\"Settings\" and \"Bridges\", then select edit action for \"Webhook "
"Bridge\"."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-appservice-webhooks.md:87
msgid ""
"On the UI, press \"Add self-hosted Bridge\" button and populate "
"\"Provisioning URL\" and \"Shared Secret\" values from `/matrix"
"/appservice-webhooks/config/config.yaml` file's homeserver URL value and "
"provisioning secret value, respectively."
msgstr ""

188
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-beeper-linkedin.po Normal file
View File

@@ -0,0 +1,188 @@
# 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/configuring-playbook-bridge-beeper-linkedin.md:1
msgid "Setting up Beeper Linkedin bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:3
msgid ""
"The playbook can install and configure [beeper-"
"linkedin](https://github.com/beeper/linkedin) for you, for bridging to "
"[LinkedIn](https://www.linkedin.com/) Messaging. This bridge is based on "
"the mautrix-python framework and can be configured in a similar way to "
"the other mautrix bridges"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:5
msgid ""
"See the project's "
"[documentation](https://github.com/beeper/linkedin/blob/master/README.md)"
" to learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:9
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:15
msgid ""
"There are some additional things you may wish to configure about the "
"bridge before you continue."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:17
msgid ""
"Encryption support is off by default. If you would like to enable "
"encryption, add the following to your `vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:24
msgid ""
"If you would like to be able to administrate the bridge from your account"
" it can be configured like this:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:33
msgid ""
"You may wish to look at `roles/custom/matrix-bridge-beeper-"
"linkedin/templates/config.yaml.j2` to find other things you would like to"
" configure."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:35
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:37
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:44
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:46
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:48
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:50
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-bridge-beeper-linkedin.md:52
msgid ""
"Set up Double Puppeting by enabling Appservice Double Puppet or Shared "
"Secret Auth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:54
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) or [Shared "
"Secret Auth](configuring-playbook-shared-secret-auth.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:56
msgid ""
"Enabling [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) is the recommended way of setting up Double Puppeting, "
"as it's easier to accomplish, works for all your users automatically, and"
" has less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:58
msgid ""
"Enabling double puppeting by enabling the [Shared Secret Auth"
"](configuring-playbook-shared-secret-auth.md) service works at the time "
"of writing, but is deprecated and will stop working in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:60
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:62
msgid ""
"To use the bridge, you need to start a chat with "
"`@linkedinbot:example.com` (where `example.com` is your base domain, not "
"the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:64
msgid ""
"Send `login YOUR_LINKEDIN_EMAIL_ADDRESS` to the bridge bot to enable "
"bridging for your LinkedIn account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:66
msgid ""
"If you run into trouble, check the [Troubleshooting](#troubleshooting) "
"section below."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:68
msgid ""
"After successfully enabling bridging, you may wish to [set up Double "
"Puppeting](#set-up-double-puppeting-by-enabling-appservice-double-puppet-"
"or-shared-secret-auth), if you haven't already done so."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:70
msgid "Troubleshooting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:72
msgid "Bridge asking for 2FA even if you don't have 2FA enabled"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-beeper-linkedin.md:74
msgid ""
"If you don't have 2FA enabled and are logging in from a strange IP for "
"the first time, LinkedIn will send an email with a one-time code. You can"
" use this code to authorize the bridge session. In my experience, once "
"the IP is authorized, you will not be asked again."
msgstr ""

100
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po Normal file
View File

@@ -0,0 +1,100 @@
# 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/configuring-playbook-bridge-go-skype-bridge.md:1
msgid "Setting up Go Skype Bridge bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:3
msgid ""
"The playbook can install and configure [go-skype-"
"bridge](https://github.com/kelaresg/go-skype-bridge) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:5
msgid ""
"See the project page to learn what it does and why it might be useful to "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:9
msgid ""
"To enable the [Skype](https://www.skype.com/) bridge, add the following "
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:15
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:17
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:24
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:26
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:28
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:30
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-bridge-go-skype-bridge.md:32
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:34
msgid ""
"To use the bridge, you need to start a chat with `Skype bridge bot` with "
"the handle `@skypebridgebot:example.com` (where `example.com` is your "
"base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:36
msgid "Send `help` to the bot to see the commands available."
msgstr ""

185
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po Normal file
View File

@@ -0,0 +1,185 @@
# 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/configuring-playbook-bridge-heisenbridge.md:1
msgid "Setting up Heisenbridge bouncer-style IRC bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:3
msgid ""
"**Note**: bridging to "
"[IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) can also happen "
"via the [matrix-appservice-irc](configuring-playbook-bridge-appservice-"
"irc.md) bridge supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:5
msgid ""
"The playbook can install and configure "
"[Heisenbridge](https://github.com/hifi/heisenbridge) - the bouncer-style "
"[IRC](https://en.wikipedia.org/wiki/Internet_Relay_Chat) bridge for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:7
msgid ""
"See the project's "
"[README](https://github.com/hifi/heisenbridge/blob/master/README.md) to "
"learn what it does and why it might be useful to you. You can also take a"
" look at [this demonstration "
"video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:9
msgid "Configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:11
msgid ""
"To enable Heisenbridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:24
msgid ""
"For a more complete list of variables that you could override, see the "
"[`defaults/main.yml` file](../roles/custom/matrix-bridge-"
"heisenbridge/defaults/main.yml) of the Heisenbridge Ansible role."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:26
msgid "Adjusting the Heisenbridge URL"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:28
msgid ""
"By default, this playbook installs Heisenbridge on the `matrix.` "
"subdomain, at the `/heisenbridge` path "
"(https://matrix.example.com/heisenbridge). It would handle media requests"
" there (see the [release notes for Heisenbridge "
"v1.15.0](https://github.com/hifi/heisenbridge/releases/tag/v1.15.0))."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:30
msgid ""
"This makes it easy to install it, because it **doesn't require additional"
" DNS records to be set up**. If that's okay, you can skip this section."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:32
msgid ""
"By tweaking the `matrix_heisenbridge_hostname` and "
"`matrix_heisenbridge_path_prefix` variables, you can easily make the "
"service available at a **different hostname and/or path** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:34
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:42
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:44
msgid ""
"If you've changed the default hostname, **you may need to adjust your "
"DNS** records to point the Heisenbridge domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:46
msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:48
msgid ""
"If you've decided to use the default hostname, you won't need to do any "
"extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:50
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:52
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:59
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:61
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:63
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:65
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-bridge-heisenbridge.md:67
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:69
msgid ""
"To use the bridge, you need to start a chat with "
"`@heisenbridge:example.com` (where `example.com` is your base domain, not"
" the `matrix.` domain). If the bridge ignores you and a DM is not "
"accepted then the owner setting may be wrong."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:71
msgid "Help is available for all commands with the `-h` switch."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:73
msgid ""
"You can also learn the basics by watching [this demonstration "
"video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-heisenbridge.md:75
msgid ""
"If you encounter issues or feel lost you can join the project room at "
"[#heisenbridge:vi.fi](https://matrix.to/#/#heisenbridge:vi.fi) for help."
msgstr ""

485
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po Normal file
View File

@@ -0,0 +1,485 @@
# 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/configuring-playbook-bridge-hookshot.md:1
msgid "Setting up matrix-hookshot (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:3
msgid ""
"The playbook can install and configure [matrix-"
"hookshot](https://github.com/matrix-org/matrix-hookshot) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:5
msgid ""
"Hookshot can bridge [Webhooks](https://en.wikipedia.org/wiki/Webhook) "
"from software project management services such as GitHub, GitLab, JIRA, "
"and Figma, as well as generic webhooks."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:7
msgid ""
"See the project's [documentation](https://matrix-org.github.io/matrix-"
"hookshot/latest/hookshot.html) to learn what it does in detail and why it"
" might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:9
msgid ""
"**Note**: the playbook also supports [matrix-appservice-webhooks"
"](configuring-playbook-bridge-appservice-webhooks.md), which however was "
"deprecated by its author."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:11
msgid "Setup Instructions"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:13
msgid ""
"Refer to the [official instructions](https://matrix-org.github.io/matrix-"
"hookshot/latest/setup.html) to learn what the individual options do."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:15
msgid ""
"Enable the bridge by adding `matrix_hookshot_enabled: true` to your "
"`vars.yml` file"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:16
msgid ""
"For each of the services (GitHub, GitLab, Jira, Figma, generic webhooks) "
"fill in the respective variables `matrix_hookshot_service_*` listed in "
"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml) as "
"required."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:17
msgid ""
"Take special note of the `matrix_hookshot_*_enabled` variables. Services "
"that need no further configuration are enabled by default (GitLab, "
"Generic), while you must first add the required configuration and enable "
"the others (GitHub, Jira, Figma)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:18
msgid ""
"If you're setting up the GitHub bridge, you'll need to generate and "
"download a private key file after you created your GitHub app. Copy the "
"contents of that file to the variable "
"`matrix_hookshot_github_private_key` so the playbook can install it for "
"you, or use one of the [other methods](#manage-github-private-key-with-"
"aux-role) explained below."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:19
msgid ""
"If you've already installed Matrix services using the playbook before, "
"you'll need to re-run it (`--tags=setup-all,start`). If not, proceed with"
" [configuring other playbook services](configuring-playbook.md) and then "
"with [Installing](installing.md). Get back to this guide once ready. "
"Hookshot can be set up individually using the tag `setup-hookshot`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:21
msgid ""
"Other configuration options are available via the "
"`matrix_hookshot_configuration_extension_yaml` and "
"`matrix_hookshot_registration_extension_yaml` variables, see the comments"
" in [main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml) "
"for how to use them."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:23
msgid "Finally, run the playbook (see [installing](installing.md))."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:25
msgid "End-to-bridge encryption"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:27
msgid ""
"You can enable [encryption](https://matrix-org.github.io/matrix-"
"hookshot/latest/advanced/encryption.html) for Hookshot by adding "
"`matrix_hookshot_encryption_enabled: true` to your configuration "
"(`vars.yml`) and [executing the playbook](installing.md) again."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:29
msgid ""
"Should the crypto store be corrupted, you can reset it by executing this "
"Ansible playbook with the tag `reset-hookshot-encryption` added, for "
"example `ansible-playbook -i inventory/hosts setup.yml --tags=reset-"
"hookshot-encryption`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:31
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:33
msgid ""
"To use the bridge, you need to create a room and invite the Hookshot bot "
"(`@hookshot:example.com`) to it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:35
msgid ""
"Make sure the bot is able to send state events (usually the Moderator "
"power level in clients)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:37
msgid "Send a `!hookshot help` message to see a list of help commands."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:39
msgid ""
"Refer to [Hookshot's documentation](https://matrix-org.github.io/matrix-"
"hookshot/latest/usage.html) for more details about using the bridge's "
"various features."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:41
msgid ""
"**Important**: Note that the different listeners are bound to certain "
"paths which might differ from those assumed by the hookshot "
"documentation, see [URLs for bridges setup](#urls-for-bridges-setup) "
"below."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:43
msgid "More setup documentation"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:45
msgid "URLs for bridges setup"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:47
msgid ""
"Unless indicated otherwise, the following endpoints are reachable on your"
" `matrix.` subdomain (if the feature is enabled)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "listener"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "default path"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "variable"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "used as"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "-"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`/hookshot/webhooks/`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`matrix_hookshot_webhook_endpoint`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "Webhook-prefix, which affects all webhook-related URLs below"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "generic"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`/hookshot/webhooks/webhook`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`matrix_hookshot_generic_endpoint`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "Generic webhooks"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "github oauth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`/hookshot/webhooks/oauth`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`matrix_hookshot_github_oauth_endpoint`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "GitHub \"Callback URL\""
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "jira oauth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`/hookshot/webhooks/jira/oauth`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`matrix_hookshot_jira_oauth_endpoint`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "JIRA OAuth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "figma endpoint"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`/hookshot/webhooks/figma/webhook`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`matrix_hookshot_figma_endpoint`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "Figma"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "provisioning"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`/hookshot/v1/`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`matrix_hookshot_provisioning_endpoint`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "Dimension [provisioning](#provisioning-api)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "appservice"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`/hookshot/_matrix/app/`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`matrix_hookshot_appservice_endpoint`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "Matrix server"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "widgets"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`/hookshot/widgetapi/`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`matrix_hookshot_widgets_endpoint`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "Widgets"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "metrics"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "`/metrics/hookshot`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid ""
"`matrix_hookshot_metrics_enabled` and exposure enabled via "
"`matrix_hookshot_metrics_proxying_enabled` or "
"`matrix_metrics_exposure_enabled`. Read more in the [Metrics "
"section](#metrics) below."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md
msgid "Prometheus"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:61
msgid ""
"Also see the various `matrix_hookshot_container_labels_*` variables in "
"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml), which"
" expose URLs publicly."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:63
msgid ""
"The different listeners are also reachable *internally* in the docker-"
"network via the container's name (configured by "
"`matrix_hookshot_container_url`) and on different ports (e.g. "
"`matrix_hookshot_appservice_port`). Read [main.yml](/roles/custom/matrix-"
"bridge-hookshot/defaults/main.yml) in detail for more info."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:65
msgid "Manage GitHub Private Key with aux role"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:67
msgid ""
"The GitHub bridge requires you to install a private key file. This can be"
" done in multiple ways:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:68
msgid ""
"copy the *contents* of the downloaded file and set the variable "
"`matrix_hookshot_github_private_key` to the contents (see example in "
"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml))."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:69
msgid ""
"somehow copy the file to the path `{{ matrix_hookshot_base_path }}/{{ "
"matrix_hookshot_github_private_key_file }}` (default: `/matrix/hookshot"
"/private-key.pem`) on the server manually."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:70
msgid ""
"use the [`aux` role](https://github.com/mother-of-all-self-hosting"
"/ansible-role-aux) to copy the file from an arbitrary path on your "
"ansible client to the correct path on the server."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:72
msgid ""
"To use the `aux` role, make sure the `matrix_hookshot_github_private_key`"
" variable is empty. Then add the following additional configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:83
msgid ""
"For more information, see the documentation in the [default configuration"
" of the aux role](https://github.com/mother-of-all-self-hosting/ansible-"
"role-aux/blob/main/defaults/main.yml)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:85
msgid "Provisioning API"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:87
msgid ""
"The provisioning API will be enabled automatically if you set "
"`matrix_dimension_enabled: true` and provided a "
"`matrix_hookshot_provisioning_secret`, unless you override it either way."
" To use hookshot with dimension, you will need to enter as \"Provisioning"
" URL\": `http://matrix-hookshot:9002`, which is made up of the variables "
"`matrix_hookshot_container_url` and `matrix_hookshot_provisioning_port`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:89
msgid "Metrics"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:91
msgid ""
"Metrics are **only enabled by default** if the builtin [Prometheus"
"](configuring-playbook-prometheus-grafana.md) is enabled (by default, "
"Prometheus isn't enabled). If so, metrics will automatically be collected"
" by Prometheus and made available in Grafana. You will, however, need to "
"set up your own Dashboard for displaying them."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:93
msgid ""
"To explicitly enable metrics, use `matrix_hookshot_metrics_enabled: "
"true`. This only exposes metrics over the container network, however."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:95
msgid ""
"**To collect metrics from an external Prometheus server**, besides "
"enabling metrics as described above, you will also need to enable metrics"
" exposure on `https://matrix.example.com/metrics/hookshot` by:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:97
msgid ""
"either enabling metrics exposure for Hookshot via "
"`matrix_hookshot_metrics_proxying_enabled: true`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:98
msgid ""
"or enabling metrics exposure for all services via "
"`matrix_metrics_exposure_enabled: true`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:100
msgid ""
"Whichever one you go with, by default metrics are exposed publicly "
"**without** password-protection. See [the Prometheus and Grafana docs"
"](configuring-playbook-prometheus-grafana.md) for details about password-"
"protection for metrics."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:102
msgid "Collision with matrix-appservice-webhooks"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-hookshot.md:104
msgid ""
"If you are also running [matrix-appservice-webhooks](configuring-"
"playbook-bridge-appservice-webhooks.md), it reserves its namespace by the"
" default setting `matrix_appservice_webhooks_user_prefix: '_webhook_'`. "
"You should take care if you modify its or hookshot's prefix that they do "
"not collide with each other's namespace (default "
"`matrix_hookshot_generic_userIdPrefix: '_webhooks_'`)."
msgstr ""

101
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po Normal file
View File

@@ -0,0 +1,101 @@
# 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/configuring-playbook-bridge-matrix-bridge-sms.md:1
msgid "Setting up Matrix SMS bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:3
msgid ""
"The playbook can install and configure [matrix-sms-"
"bridge](https://github.com/benkuly/matrix-sms-bridge) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:5
msgid ""
"See the project page to learn what it does and why it might be useful to "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:7
msgid ""
"**The bridge uses [android-sms-gateway-"
"server](https://github.com/RebekkaMa/android-sms-gateway-server). You "
"need to configure it first.**"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:9
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:11
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:34
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:36
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:43
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:45
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:47
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:49
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-bridge-matrix-bridge-sms.md:51
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:53
msgid ""
"Read the [user guide](https://github.com/benkuly/matrix-sms-"
"bridge/blob/master/README.md#user-guide) to see how this bridge works."
msgstr ""

353
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-discord.po Normal file
View File

@@ -0,0 +1,353 @@
# 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/configuring-playbook-bridge-mautrix-discord.md:1
msgid "Setting up Mautrix Discord bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:3
msgid ""
"**Note**: bridging to [Discord](https://discordapp.com/) can also happen "
"via the [mx-puppet-discord](configuring-playbook-bridge-mx-puppet-"
"discord.md) and [matrix-appservice-discord](configuring-playbook-bridge-"
"appservice-discord.md) bridges supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:4
msgid ""
"For using as a Bot we recommend the [Appservice Discord](configuring-"
"playbook-bridge-appservice-discord.md), because it supports plumbing."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:5
msgid ""
"For personal use with a discord account we recommend the `mautrix-"
"discord` bridge (the one being discussed here), because it is the most "
"fully-featured and stable of the 3 Discord bridges supported by the "
"playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:7
msgid ""
"The playbook can install and configure [mautrix-"
"discord](https://github.com/mautrix/discord) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:9
msgid ""
"See the project's "
"[documentation](https://docs.mau.fi/bridges/go/discord/index.html) to "
"learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:11
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:13
msgid ""
"There are 2 ways to login to discord using this bridge, either by "
"[scanning a QR code](#method-1-login-using-qr-code-recommended) using the"
" Discord mobile app **or** by using a [Discord token](#method-2-login-"
"using-discord-token-not-recommended)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:15
msgid ""
"If this is a dealbreaker for you, consider using one of the other Discord"
" bridges supported by the playbook: [mx-puppet-discord](configuring-"
"playbook-bridge-mx-puppet-discord.md) or [matrix-appservice-discord"
"](configuring-playbook-bridge-appservice-discord.md). These come with "
"their own complexity and limitations, however, so we recommend that you "
"proceed with this one if possible."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:17
msgid "Enable Appservice Double Puppet or Shared Secret Auth (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:19
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) or [Shared Secret Auth](configuring-playbook-shared-"
"secret-auth.md) service for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:21
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:23
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:25
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:31
msgid ""
"You may optionally wish to add some [Additional configuration"
"](#additional-configuration), or to [prepare for double-puppeting](#set-"
"up-double-puppeting) before the initial installation."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:33
msgid "Additional configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:35
msgid ""
"There are some additional things you may wish to configure about the "
"bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:37
msgid "Take a look at:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:39
msgid ""
"`roles/custom/matrix-bridge-mautrix-discord/defaults/main.yml` for some "
"variables that you can customize via your `vars.yml` file"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:40
msgid ""
"`roles/custom/matrix-bridge-mautrix-discord/templates/config.yaml.j2` for"
" the bridge's default configuration. You can override settings (even "
"those that don't have dedicated playbook variables) using the "
"`matrix_mautrix_discord_configuration_extension_yaml` variable"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:42
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:44
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:51
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:53
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:55
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:57
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-bridge-mautrix-discord.md:59
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:61
msgid "Logging in"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:63
msgid "Method 1: Login using QR code (recommended)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:65
msgid ""
"For using this bridge, you would need to authenticate by **scanning a QR "
"code** with the Discord app on your phone."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:67
msgid "You can delete the Discord app after the authentication process."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:69
msgid "Method 2: Login using Discord token (not recommended)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:71
msgid ""
"To acquire the token, open Discord in a private browser window. Then open"
" the developer settings (keyboard shortcut might be \"ctrl+shift+i\" or "
"by pressing \"F12\"). Navigate to the \"Network\" tab then reload the "
"page. In the URL filter or search bar type \"/api\" and find the response"
" with the file name of \"library\". Under the request headers you should "
"find a variable called \"Authorization\", this is the token to your "
"Discord account. After copying the token, you can close the browser "
"window."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:73
msgid "Bridging"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:75
msgid ""
"Start a chat with `@discordbot:example.com` (where `example.com` is your "
"base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:76
msgid ""
"If you would like to login to Discord using a token, send `login-token` "
"command, otherwise, send `login-qr` command."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:77
msgid ""
"You'll see a QR code which you need to scan with the Discord app on your "
"phone. You can scan it with the camera app too, which will open Discord, "
"which will then instruct you to scan it a 2nd time in the Discord app."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:78
msgid ""
"After confirming (in the Discord app) that you'd like to allow this "
"login, the bot should respond with \"Succcessfully authenticated as …\""
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:79
msgid ""
"Now that you're logged in, you can send a `help` command to the bot "
"again, to see additional commands you have access to"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:80
msgid "Some Direct Messages from Discord should start syncing automatically"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:81
msgid "If you'd like to bridge guilds:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:82
msgid "send `guilds status` to see the list of guilds"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:83
msgid ""
"for each guild that you'd like bridged, send `guilds bridge GUILD_ID "
"--entire`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:84
msgid ""
"You may wish to uninstall the Discord app from your phone now. It's not "
"needed for the bridge to function."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:86
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:88
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:90
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:92
msgid ""
"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
"Secret Auth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:94
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) or [Shared "
"Secret Auth](configuring-playbook-shared-secret-auth.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:96
msgid ""
"Enabling [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) is the recommended way of setting up Double Puppeting, "
"as it's easier to accomplish, works for all your users automatically, and"
" has less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:98
msgid ""
"Enabling double puppeting by enabling the [Shared Secret Auth"
"](configuring-playbook-shared-secret-auth.md) service works at the time "
"of writing, but is deprecated and will stop working in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:100
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:102
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:104
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:106
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-discord.md:108
msgid ""
"make sure you don't log out the `Mautrix-Discord` device some time in the"
" future, as that would break the Double Puppeting feature"
msgstr ""

287
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-facebook.po Normal file
View File

@@ -0,0 +1,287 @@
# 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/configuring-playbook-bridge-mautrix-facebook.md:1
msgid "Setting up Mautrix Facebook bridging (optional, deprecated)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:3
msgid ""
"**Note**: This bridge has been deprecated in favor of the [mautrix-"
"meta](https://github.com/mautrix/meta) Messenger/Instagram bridge, which "
"can be installed using [this playbook](configuring-playbook-bridge-"
"mautrix-meta-messenger.md). Consider using that bridge instead of this "
"one."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:5
msgid ""
"The playbook can install and configure [mautrix-"
"facebook](https://github.com/mautrix/facebook) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:7
msgid ""
"See the project's "
"[documentation](https://github.com/mautrix/facebook/blob/master/ROADMAP.md)"
" to learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:9
msgid "Prerequisite (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:11
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Shared Secret Auth](configuring-playbook-shared-secret-"
"auth.md) for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:13
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:15
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:17
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:23
msgid ""
"There are some additional things you may wish to configure about the "
"bridge before you continue."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:25
msgid ""
"Encryption support is off by default. If you would like to enable "
"encryption, add the following to your `vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:35
msgid ""
"If you would like to be able to administrate the bridge from your account"
" it can be configured like this:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:44
msgid "Using both would look like"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:56
msgid ""
"You may wish to look at `roles/custom/matrix-bridge-mautrix-"
"facebook/templates/config.yaml.j2` and `roles/custom/matrix-bridge-"
"mautrix-facebook/defaults/main.yml` to find other things you would like "
"to configure."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:58
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:60
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:67
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:69
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:71
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:73
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-bridge-mautrix-facebook.md:75
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:77
msgid ""
"To use the bridge, you need to start a chat with "
"`@facebookbot:example.com` (where `example.com` is your base domain, not "
"the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:79
msgid ""
"Send `login YOUR_FACEBOOK_EMAIL_ADDRESS` to the bridge bot to enable "
"bridging for your Facebook Messenger account. You can learn more here "
"about authentication from the bridge's [official documentation on "
"Authentication](https://docs.mau.fi/bridges/python/facebook/authentication.html)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:81
msgid ""
"If you run into trouble, check the [Troubleshooting](#troubleshooting) "
"section below."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:83
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:85
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:87
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:89
msgid "Method 1: automatically, by enabling Shared Secret Auth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:91
msgid ""
"The bridge automatically performs Double Puppeting if [Shared Secret Auth"
"](configuring-playbook-shared-secret-auth.md) service is configured and "
"enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:93
msgid ""
"This is the recommended way of setting up Double Puppeting, as it's "
"easier to accomplish, works for all your users automatically, and has "
"less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:95
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:97
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:99
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:101
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:103
msgid ""
"make sure you don't log out the `Mautrix-Facebook` device some time in "
"the future, as that would break the Double Puppeting feature"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:105
msgid "Troubleshooting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:107
msgid "Facebook rejecting login attempts and forcing you to change password"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:109
msgid ""
"If your Matrix server is in a wildly different location than where you "
"usually use your Facebook account from, the bridge's login attempts may "
"be outright rejected by Facebook. Along with that, Facebook may even "
"force you to change the account's password."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:111
msgid ""
"If you happen to run into this problem while [setting up "
"bridging](#usage), try to first get a successful session up by logging in"
" to Facebook through the Matrix server's IP address."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:113
msgid ""
"The easiest way to do this may be to use "
"[sshuttle](https://sshuttle.readthedocs.io/) to proxy your traffic "
"through the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:115
msgid "Example command for proxying your traffic through the Matrix server:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:121
msgid ""
"Once connected, you should be able to verify that you're browsing the web"
" through the Matrix server's IP by checking "
"[icanhazip](https://icanhazip.com/)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:123
msgid "Then proceed to log in to [Facebook/Messenger](https://www.facebook.com/)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:125
msgid "Once logged in, proceed to [set up bridging](#usage)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-facebook.md:127
msgid ""
"If that doesn't work, enable 2FA (see: [Facebook help page on enabling "
"2FA](https://www.facebook.com/help/148233965247823)) and try to login "
"again with a new password, and entering the 2FA code when prompted, it "
"may take more then one try, in between attempts, check facebook.com to "
"see if they are requiring another password change"
msgstr ""

177
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-gmessages.po Normal file
View File

@@ -0,0 +1,177 @@
# 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/configuring-playbook-bridge-mautrix-gmessages.md:1
msgid "Setting up Mautrix Google Messages bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:3
msgid ""
"The playbook can install and configure [mautrix-"
"gmessages](https://github.com/mautrix/gmessages) for you, for bridging to"
" [Google Messages](https://messages.google.com/)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:5
msgid ""
"See the project's "
"[documentation](https://docs.mau.fi/bridges/go/gmessages/index.html) to "
"learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:7
msgid "Prerequisite (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:9
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:11
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:13
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:15
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:21
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:23
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:30
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:32
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:34
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:36
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-bridge-mautrix-gmessages.md:38
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:40
msgid ""
"To use the bridge, you need to start a chat with "
"`@gmessagesbot:example.com` (where `example.com` is your base domain, not"
" the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:42
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:44
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:46
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:48
msgid "Method 1: automatically, by enabling Appservice Double Puppet"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:50
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:52
msgid ""
"This is the recommended way of setting up Double Puppeting, as it's "
"easier to accomplish, works for all your users automatically, and has "
"less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:54
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:56
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:58
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:60
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-gmessages.md:62
msgid ""
"make sure you don't log out the `Mautrix-gmessages` device some time in "
"the future, as that would break the Double Puppeting feature"
msgstr ""

217
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-googlechat.po Normal file
View File

@@ -0,0 +1,217 @@
# 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/configuring-playbook-bridge-mautrix-googlechat.md:1
msgid "Setting up Mautrix Google Chat bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:3
msgid ""
"The playbook can install and configure [mautrix-"
"googlechat](https://github.com/mautrix/googlechat) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:5
msgid ""
"See the project's "
"[documentation](https://docs.mau.fi/bridges/python/googlechat/index.html)"
" to learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:7
msgid "Prerequisite (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:9
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) or [Shared Secret Auth](configuring-playbook-shared-"
"secret-auth.md) service for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:11
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:13
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:15
msgid ""
"To enable the [Google Chat](https://chat.google.com/) bridge, add the "
"following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:21
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:23
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:30
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:32
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:34
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:36
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-bridge-mautrix-googlechat.md:38
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:40
msgid ""
"To use the bridge, you need to start a chat with `googlechat bridge bot` "
"with handle `@googlechatbot:example.com` (where `example.com` is your "
"base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:42
msgid ""
"Send `login` to the bridge bot to receive a link to the portal from which"
" you can enable the bridging. Open the link sent by the bot and follow "
"the instructions."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:44
msgid ""
"Automatic login may not work. If it does not, reload the page and select "
"the \"Manual login\" checkbox before starting. Manual login involves "
"logging into your Google account normally and then manually getting the "
"OAuth token from browser cookies with developer tools."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:46
msgid ""
"Once logged in, recent chats should show up as new conversations "
"automatically. Other chats will get portals as you receive messages."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:48
msgid ""
"You can learn more about authentication from the bridge's [official "
"documentation on "
"Authentication](https://docs.mau.fi/bridges/python/googlechat/authentication.html)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:50
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:52
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:54
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:56
msgid ""
"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
"Secret Auth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:58
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) or [Shared "
"Secret Auth](configuring-playbook-shared-secret-auth.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:60
msgid ""
"Enabling [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) is the recommended way of setting up Double Puppeting, "
"as it's easier to accomplish, works for all your users automatically, and"
" has less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:62
msgid ""
"Enabling double puppeting by enabling the [Shared Secret Auth"
"](configuring-playbook-shared-secret-auth.md) service works at the time "
"of writing, but is deprecated and will stop working in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:64
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:66
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:68
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:70
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-googlechat.md:72
msgid ""
"make sure you don't log out the `Mautrix-googlechat` device some time in "
"the future, as that would break the Double Puppeting feature"
msgstr ""

214
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-hangouts.po Normal file
View File

@@ -0,0 +1,214 @@
# 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/configuring-playbook-bridge-mautrix-hangouts.md:1
msgid "Setting up Mautrix Hangouts bridging (optional, deprecated)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:3
msgid ""
"💡 **Note**: This bridge has been deprecated in favor of [Google Chat "
"bridge](https://github.com/mautrix/googlechat), which can be installed "
"using [this playbook](configuring-playbook-bridge-mautrix-googlechat.md)."
" Installing the mautrix-hangouts bridge is **no longer possible**. For "
"now, this documentation page remains here for historical purposes."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:5
msgid ""
"The playbook can install and configure [mautrix-"
"hangouts](https://github.com/mautrix/hangouts) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:7
msgid ""
"See the project's "
"[documentation](https://docs.mau.fi/bridges/python/hangouts/index.html) "
"to learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:9
msgid "Prerequisite (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:11
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Shared Secret Auth](configuring-playbook-shared-secret-"
"auth.md) for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:13
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:15
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:17
msgid ""
"To enable the [Google Hangouts](https://hangouts.google.com/) bridge, add"
" the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:23
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:25
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:32
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:34
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:36
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:38
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-bridge-mautrix-hangouts.md:40
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:42
msgid ""
"To use the bridge, you need to start a chat with `Hangouts bridge bot` "
"with handle `@hangoutsbot:example.com` (where `example.com` is your base "
"domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:44
msgid ""
"Send `login` to the bridge bot to receive a link to the portal from which"
" you can enable the bridging. Open the link sent by the bot and follow "
"the instructions."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:46
msgid ""
"Automatic login may not work. If it does not, reload the page and select "
"the \"Manual login\" checkbox before starting. Manual login involves "
"logging into your Google account normally and then manually getting the "
"OAuth token from browser cookies with developer tools."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:48
msgid ""
"Once logged in, recent chats should show up as new conversations "
"automatically. Other chats will get portals as you receive messages."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:50
msgid ""
"You can learn more about authentication from the bridge's [official "
"documentation on "
"Authentication](https://docs.mau.fi/bridges/python/hangouts/authentication.html)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:52
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:54
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:56
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:58
msgid "Method 1: automatically, by enabling Shared Secret Auth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:60
msgid ""
"The bridge automatically performs Double Puppeting if [Shared Secret Auth"
"](configuring-playbook-shared-secret-auth.md) service is configured and "
"enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:62
msgid ""
"This is the recommended way of setting up Double Puppeting, as it's "
"easier to accomplish, works for all your users automatically, and has "
"less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:64
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:66
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:68
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:70
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-hangouts.md:72
msgid ""
"make sure you don't log out the `Mautrix-Hangouts` device some time in "
"the future, as that would break the Double Puppeting feature"
msgstr ""

144
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-instagram.po Normal file
View File

@@ -0,0 +1,144 @@
# 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/configuring-playbook-bridge-mautrix-instagram.md:1
msgid "Setting up Mautrix Instagram bridging (optional, deprecated)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:3
msgid ""
"**Note**: This bridge has been deprecated in favor of the [mautrix-"
"meta](https://github.com/mautrix/meta) Messenger/Instagram bridge, which "
"can be installed using [this playbook](configuring-playbook-bridge-"
"mautrix-meta-instagram.md). Consider using that bridge instead of this "
"one."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:5
msgid ""
"The playbook can install and configure [mautrix-"
"instagram](https://github.com/mautrix/instagram) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:7
msgid ""
"See the project's "
"[documentation](https://docs.mau.fi/bridges/python/instagram/index.html) "
"to learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:9
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:11
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:17
msgid ""
"There are some additional things you may wish to configure about the "
"bridge before you continue."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:19
msgid ""
"Encryption support is off by default. If you would like to enable "
"encryption, add the following to your `vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:29
msgid ""
"If you would like to be able to administrate the bridge from your account"
" it can be configured like this:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:43
msgid ""
"You may wish to look at `roles/custom/matrix-bridge-mautrix-"
"instagram/templates/config.yaml.j2` and `roles/custom/matrix-bridge-"
"mautrix-instagram/defaults/main.yml` to find other things you would like "
"to configure."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:45
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:47
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:54
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:56
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:58
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:60
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-bridge-mautrix-instagram.md:62
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:64
msgid ""
"To use the bridge, you need to start a chat with "
"`@instagrambot:example.com` (where `example.com` is your base domain, not"
" the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:66
msgid ""
"Send `login YOUR_INSTAGRAM_EMAIL_ADDRESS YOUR_INSTAGRAM_PASSWORD` to the "
"bridge bot to enable bridging for your instagram/Messenger account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-instagram.md:68
msgid ""
"You can learn more here about authentication from the bridge's [official "
"documentation on "
"Authentication](https://docs.mau.fi/bridges/python/instagram/authentication.html)."
msgstr ""

296
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-instagram.po Normal file
View File

@@ -0,0 +1,296 @@
# 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/configuring-playbook-bridge-mautrix-meta-instagram.md:1
msgid "Setting up Instagram bridging via Mautrix Meta (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:3
msgid ""
"The playbook can install and configure the [mautrix-"
"meta](https://github.com/mautrix/meta) Messenger/Instagram bridge for "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:5
msgid ""
"Since this bridge component can bridge to both "
"[Messenger](https://messenger.com/) and "
"[Instagram](https://instagram.com/) and you may wish to do both at the "
"same time, the playbook makes it available via 2 different Ansible roles "
"(`matrix-bridge-mautrix-meta-messenger` and `matrix-bridge-mautrix-meta-"
"instagram`). The latter is a reconfigured copy of the first one (created "
"by `just rebuild-mautrix-meta-instagram` and `bin/rebuild-mautrix-meta-"
"instagram.sh`)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:7
msgid ""
"This documentation page only deals with the bridge's ability to bridge to"
" Instagram. For bridging to Facebook/Messenger, see [Setting up Messenger"
" bridging via Mautrix Meta](configuring-playbook-bridge-mautrix-meta-"
"messenger.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:9
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:11
msgid "Migrating from the old mautrix-instagram bridge"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:13
msgid ""
"If you've been using the [mautrix-instagram](./configuring-playbook-"
"bridge-mautrix-instagram.md) bridge, **you'd better get rid of it first**"
" or the 2 bridges will be in conflict:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:15
msgid ""
"both trying to use `@instagrambot:example.com` as their username. This "
"conflict may be resolved by adjusting "
"`matrix_mautrix_instagram_appservice_bot_username` or "
"`matrix_mautrix_meta_instagram_appservice_username`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:16
msgid "both trying to bridge the same DMs"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:18
msgid ""
"To do so, send a `clean-rooms` command to the management room with the "
"old bridge bot (`@instagrambot:example.com`). It gives you a list of "
"portals and groups of portals you may purge. Proceed with sending "
"commands like `clean recommended`, etc."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:20
msgid ""
"Then, consider disabling the old bridge in your configuration, so it "
"won't recreate the portals when you receive new messages."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:22
msgid "Enable Appservice Double Puppet (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:24
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) service for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:26
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:28
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:30
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:36
msgid ""
"Before proceeding to [re-running the playbook](./installing.md), you may "
"wish to adjust the configuration further. See below."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:38
msgid "Bridge permissions"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:40
msgid "By default, any user on your homeserver will be able to use the bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:42
msgid "Different levels of permission can be granted to users:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:44
msgid "`relay` - Allowed to be relayed through the bridge, no access to commands"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:45
msgid "`user` - Use the bridge with puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:46
msgid "`admin` - Use and administer the bridge"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:48
msgid ""
"The permissions are following the sequence: nothing < `relay` < `user` < "
"`admin`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:50
msgid ""
"The default permissions are set via "
"`matrix_mautrix_meta_instagram_bridge_permissions_default` and are "
"somewhat like this:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:59
msgid ""
"If you don't define the `matrix_admin` in your configuration (e.g. "
"`matrix_admin: @alice:example.com`), then there's no admin by default."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:61
msgid ""
"You may redefine "
"`matrix_mautrix_meta_instagram_bridge_permissions_default` any way you "
"see fit, or add extra permissions using "
"`matrix_mautrix_meta_instagram_bridge_permissions_custom` like this:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:68
msgid ""
"You may wish to look at `roles/custom/matrix-bridge-mautrix-meta-"
"instagram/templates/config.yaml.j2` to find more information on the "
"permissions settings and other options you would like to configure."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:70
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:72
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:79
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:81
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:83
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:85
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-bridge-mautrix-meta-instagram.md:87
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:89
msgid ""
"To use the bridge, you need to start a chat with "
"`@instagrambot:example.com` (where `example.com` is your base domain, not"
" the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:91
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:93
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:95
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:97
msgid "Method 1: automatically, by enabling Appservice Double Puppet"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:99
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:101
msgid ""
"This is the recommended way of setting up Double Puppeting, as it's "
"easier to accomplish, works for all your users automatically, and has "
"less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:103
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:105
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:107
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:109
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-instagram.md:111
msgid ""
"make sure you don't log out the session for which you obtained an access "
"token some time in the future, as that would break the Double Puppeting "
"feature"
msgstr ""

361
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-meta-messenger.po Normal file
View File

@@ -0,0 +1,361 @@
# 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/configuring-playbook-bridge-mautrix-meta-messenger.md:1
msgid "Setting up Messenger bridging via Mautrix Meta (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:3
msgid ""
"The playbook can install and configure the [mautrix-"
"meta](https://github.com/mautrix/meta) Messenger/Instagram bridge for "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:5
msgid ""
"Since this bridge component can bridge to both "
"[Messenger](https://messenger.com/) and "
"[Instagram](https://instagram.com/) and you may wish to do both at the "
"same time, the playbook makes it available via 2 different Ansible roles "
"(`matrix-bridge-mautrix-meta-messenger` and `matrix-bridge-mautrix-meta-"
"instagram`). The latter is a reconfigured copy of the first one (created "
"by `just rebuild-mautrix-meta-instagram` and `bin/rebuild-mautrix-meta-"
"instagram.sh`)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:7
msgid ""
"This documentation page only deals with the bridge's ability to bridge to"
" Facebook Messenger. For bridging to Instagram, see [Setting up Instagram"
" bridging via Mautrix Meta](configuring-playbook-bridge-mautrix-meta-"
"instagram.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:9
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:11
msgid "Migrating from the old mautrix-facebook bridge"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:13
msgid ""
"If you've been using the [mautrix-facebook](./configuring-playbook-"
"bridge-mautrix-facebook.md) bridge, it's possible to migrate the database"
" using [instructions from the bridge "
"documentation](https://docs.mau.fi/bridges/go/meta/facebook-"
"migration.html) (advanced)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:15
msgid ""
"Then you may wish to get rid of the Facebook bridge. To do so, send a "
"`clean-rooms` command to the management room with the old bridge bot "
"(`@facebookbot:example.com`). It gives you a list of portals and groups "
"of portals you may purge. Proceed with sending commands like `clean "
"recommended`, etc."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:17
msgid ""
"Then, consider disabling the old bridge in your configuration, so it "
"won't recreate the portals when you receive new messages."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:19
msgid ""
"**Note**: the user ID of the new bridge bot is "
"`@messengerbot:example.com`, not `@facebookbot:example.com`. After "
"disabling the old bridge, its bot user will stop responding to a command."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:21
msgid "Enable Appservice Double Puppet (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:23
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) service for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:25
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:27
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:29
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:35
msgid ""
"Before proceeding to [re-running the playbook](./installing.md), you may "
"wish to adjust the configuration further. See below."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:37
msgid "Bridge mode"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:39
msgid ""
"As mentioned above, the [mautrix-meta](https://github.com/mautrix/meta) "
"bridge supports multiple modes of operation."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:41
msgid "The bridge can pull your Messenger messages via 3 different methods:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:43
msgid "(`facebook`) Facebook via `facebook.com`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:44
msgid ""
"(`facebook-tor`) Facebook via "
"`facebookwkhpilnemxj7asaniu7vnjjbiltxjqhye3mhbshg7kx5tfyd.onion` "
"([Tor](https://www.torproject.org/)) - does not currently proxy media "
"downloads"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:45
msgid ""
"(default) (`messenger`) Messenger via `messenger.com` - usable even "
"without a Facebook account"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:47
msgid ""
"You may switch the mode via the `matrix_mautrix_meta_messenger_meta_mode`"
" variable. The playbook defaults to the `messenger` mode, because it's "
"most universal (every Facebook user has a Messenger account, but the "
"opposite is not true)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:49
msgid ""
"Note that switching the mode (especially between `facebook*` and "
"`messenger`) will intentionally make the bridge use another database "
"(`matrix_mautrix_meta_facebook` or `matrix_mautrix_meta_messenger`) to "
"isolate the 2 instances. Switching between Tor and non-Tor may be "
"possible without dataloss, but your mileage may vary. Before switching to"
" a new mode, you may wish to de-configure the old one (send `help` to the"
" bridge bot and unbridge your portals, etc.)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:51
msgid "Bridge permissions"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:53
msgid "By default, any user on your homeserver will be able to use the bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:55
msgid "Different levels of permission can be granted to users:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:57
msgid "`relay` - Allowed to be relayed through the bridge, no access to commands"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:58
msgid "`user` - Use the bridge with puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:59
msgid "`admin` - Use and administer the bridge"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:61
msgid ""
"The permissions are following the sequence: nothing < `relay` < `user` < "
"`admin`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:63
msgid ""
"The default permissions are set via "
"`matrix_mautrix_meta_messenger_bridge_permissions_default` and are "
"somewhat like this:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:72
msgid ""
"If you don't define the `matrix_admin` in your configuration (e.g. "
"`matrix_admin: @alice:example.com`), then there's no admin by default."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:74
msgid ""
"You may redefine "
"`matrix_mautrix_meta_messenger_bridge_permissions_default` any way you "
"see fit, or add extra permissions using "
"`matrix_mautrix_meta_messenger_bridge_permissions_custom` like this:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:81
msgid ""
"You may wish to look at `roles/custom/matrix-bridge-mautrix-meta-"
"messenger/templates/config.yaml.j2` to find more information on the "
"permissions settings and other options you would like to configure."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:83
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:85
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:92
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:94
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:96
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:98
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-bridge-mautrix-meta-messenger.md:100
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:102
msgid ""
"To use the bridge, you need to start a chat with "
"`@messengerbot:example.com` (where `example.com` is your base domain, not"
" the `matrix.` domain). Note that the user ID of the bridge's bot is not "
"`@facebookbot:example.com`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:104
msgid ""
"You then need to send a `login` command and follow the bridge bot's "
"instructions."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:106
msgid ""
"Given that the bot is configured in `messenger` [bridge mode](#bridge-"
"mode) by default, you will need to log in to "
"[messenger.com](https://messenger.com/) (not `facebook.com`!) and obtain "
"the cookies from there as per [the bridge's authentication "
"instructions](https://docs.mau.fi/bridges/go/meta/authentication.html)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:108
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:110
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:112
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:114
msgid "Method 1: automatically, by enabling Appservice Double Puppet"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:116
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:118
msgid ""
"This is the recommended way of setting up Double Puppeting, as it's "
"easier to accomplish, works for all your users automatically, and has "
"less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:120
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:122
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:124
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:126
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-meta-messenger.md:128
msgid ""
"make sure you don't log out the session for which you obtained an access "
"token some time in the future, as that would break the Double Puppeting "
"feature"
msgstr ""

267
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-signal.po Normal file
View File

@@ -0,0 +1,267 @@
# 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/configuring-playbook-bridge-mautrix-signal.md:1
msgid "Setting up Mautrix Signal bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:3
msgid ""
"The playbook can install and configure [mautrix-"
"signal](https://github.com/mautrix/signal) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:5
msgid ""
"See the project's "
"[documentation](https://docs.mau.fi/bridges/python/signal/index.html) to "
"learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:7
msgid ""
"**Note**: This revamped version of the [mautrix-signal (legacy"
")](configuring-playbook-bridge-mautrix-signal.md) may increase the CPU "
"usage of your homeserver."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:9
msgid "Prerequisites (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:11
msgid "Prepare Postgres database on external Postgres server"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:13
msgid ""
"If you're running with the Postgres database server integrated by the "
"playbook (which is the default), you don't need to do anything special "
"and can easily proceed with installing."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:15
msgid ""
"However, if you're [using an external Postgres server](configuring-"
"playbook-external-postgres.md), you'd need to manually prepare a Postgres"
" database for this bridge and adjust the variables related to that "
"(`matrix_mautrix_signal_database_*`)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:17
msgid "Enable Appservice Double Puppet"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:19
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) service for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:21
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:23
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:25
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:31
msgid ""
"There are some additional things you may wish to configure about the "
"bridge before you continue."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:33
msgid "By default, any user on your homeserver will be able to use the bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:35
msgid "Different levels of permission can be granted to users:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:37
msgid "relay - Allowed to be relayed through the bridge, no access to commands;"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:38
msgid "user - Use the bridge with puppeting;"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:39
msgid "admin - Use and administer the bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:41
msgid ""
"The permissions are following the sequence: nothing < relay < user < "
"admin."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:43
msgid "The default permissions are set as follows:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:51
msgid ""
"If you want to augment the preset permissions, you might want to set the "
"additional permissions with the following settings in your `vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:60
msgid ""
"This will add the admin permission to the specific user, while keeping "
"the default permissions."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:62
msgid ""
"In case you want to replace the default permissions settings "
"**completely**, populate the following item within your `vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:70
msgid ""
"You may wish to look at `roles/custom/matrix-bridge-mautrix-"
"signal/templates/config.yaml.j2` to find more information on the "
"permissions settings and other options you would like to configure."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:72
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:74
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:81
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:83
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:85
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:87
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-bridge-mautrix-signal.md:89
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:91
msgid ""
"To use the bridge, you need to start a chat with `@signalbot:example.com`"
" (where `example.com` is your base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:93
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:95
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:97
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:99
msgid "Method 1: automatically, by enabling Appservice Double Puppet"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:101
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:103
msgid ""
"This is the recommended way of setting up Double Puppeting, as it's "
"easier to accomplish, works for all your users automatically, and has "
"less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:105
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:107
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:109
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:111
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-signal.md:113
msgid ""
"make sure you don't log out the `Mautrix-Signal` device some time in the "
"future, as that would break the Double Puppeting feature"
msgstr ""

289
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-slack.po Normal file
View File

@@ -0,0 +1,289 @@
# 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/configuring-playbook-bridge-mautrix-slack.md:1
msgid "Setting up Mautrix Slack bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:3
msgid ""
"**Note**: bridging to [Slack](https://slack.com/) can also happen via the"
" [mx-puppet-slack](configuring-playbook-bridge-mx-puppet-slack.md) and "
"[matrix-appservice-slack](configuring-playbook-bridge-appservice-"
"slack.md) bridges supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:4
msgid ""
"For using as a Bot we recommend the [Appservice Slack](configuring-"
"playbook-bridge-appservice-slack.md), because it supports plumbing. Note "
"that it is not available for new installation unless you have already "
"created a classic Slack application, because the creation of classic "
"Slack applications, which this bridge makes use of, has been "
"discontinued."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:5
msgid ""
"For personal use with a slack account we recommend the `mautrix-slack` "
"bridge (the one being discussed here), because it is the most fully-"
"featured and stable of the 3 Slack bridges supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:7
msgid ""
"The playbook can install and configure [mautrix-"
"slack](https://github.com/mautrix/slack) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:9
msgid ""
"See the project's "
"[documentation](https://docs.mau.fi/bridges/go/slack/index.html) to learn"
" what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:11
msgid ""
"See the [features and "
"roadmap](https://github.com/mautrix/slack/blob/main/ROADMAP.md) for more "
"information."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:13
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:15
msgid ""
"For using this bridge, you would need to authenticate by **providing your"
" username and password** (legacy) or by using a **token login**. See more"
" information in the "
"[docs](https://docs.mau.fi/bridges/go/slack/authentication.html)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:17
msgid ""
"Note that neither of these methods are officially supported by Slack. "
"[matrix-appservice-slack](configuring-playbook-bridge-appservice-"
"slack.md) uses a Slack bot account which is the only officially supported"
" method for bridging a Slack channel."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:19
msgid "Enable Appservice Double Puppet (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:21
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) service for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:23
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:25
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:27
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:33
msgid ""
"You may optionally wish to add some [Additional configuration"
"](#additional-configuration), or to [prepare for double-puppeting](#set-"
"up-double-puppeting) before the initial installation."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:35
msgid "Additional configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:37
msgid ""
"There are some additional options you may wish to configure with the "
"bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:39
msgid "Take a look at:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:41
msgid ""
"`roles/custom/matrix-bridge-mautrix-slack/defaults/main.yml` for some "
"variables that you can customize via your `vars.yml` file"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:42
msgid ""
"`roles/custom/matrix-bridge-mautrix-slack/templates/config.yaml.j2` for "
"the bridge's default configuration. You can override settings (even those"
" that don't have dedicated playbook variables) using the "
"`matrix_mautrix_slack_configuration_extension_yaml` variable"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:44
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:46
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:53
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:55
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:57
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:59
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-bridge-mautrix-slack.md:61
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:63
msgid ""
"Start a chat with `@slackbot:example.com` (where `example.com` is your "
"base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:64
msgid ""
"If you would like to login to Slack using a token, send the `login-token`"
" command, otherwise, send the `login-password` command. Read "
"[here](https://docs.mau.fi/bridges/go/slack/authentication.html) on how "
"to retrieve your token and cookie token."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:65
msgid ""
"The bot should respond with \"Successfully logged into <email> for team "
"<workspace>\""
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:66
msgid ""
"Now that you're logged in, you can send a `help` command to the bot "
"again, to see additional commands you have access to."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:67
msgid ""
"Slack channels should automatically begin bridging if you authenticated "
"using a token. Otherwise, you must wait to receive a message in the "
"channel if you used password authentication."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:69
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:71
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:73
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:75
msgid "Method 1: automatically, by enabling Appservice Double Puppet"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:77
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:79
msgid ""
"This is the recommended way of setting up Double Puppeting, as it's "
"easier to accomplish, works for all your users automatically, and has "
"less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:81
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:83
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:85
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:87
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-slack.md:89
msgid ""
"make sure you don't log out the `Mautrix-Slack` device some time in the "
"future, as that would break the Double Puppeting feature"
msgstr ""

223
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-telegram.po Normal file
View File

@@ -0,0 +1,223 @@
# 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/configuring-playbook-bridge-mautrix-telegram.md:1
msgid "Setting up Mautrix Telegram bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:3
msgid ""
"The playbook can install and configure [mautrix-"
"telegram](https://github.com/mautrix/telegram) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:5
msgid ""
"See the project's "
"[documentation](https://docs.mau.fi/bridges/python/telegram/index.html) "
"to learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:7
msgid "Prerequisite (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:9
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) or [Shared Secret Auth](configuring-playbook-shared-"
"secret-auth.md) service for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:11
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:13
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:15
msgid ""
"You'll need to obtain API keys from "
"[https://my.telegram.org/apps](https://my.telegram.org/apps) and then add"
" the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:23
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:25
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:32
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:34
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:36
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:38
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-bridge-mautrix-telegram.md:40
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:42
msgid ""
"To use the bridge, you need to start a chat with "
"`@telegrambot:example.com` (where `example.com` is your base domain, not "
"the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:44
msgid ""
"If you want to use the relay-bot feature ([relay bot "
"documentation](https://docs.mau.fi/bridges/python/telegram/relay-"
"bot.html)), which allows anonymous user to chat with telegram users, add "
"the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:54
msgid "You might also want to give permissions to administrate the bot:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:63
msgid ""
"More details about permissions in this example: "
"https://github.com/mautrix/telegram/blob/master/mautrix_telegram/example-"
"config.yaml#L410"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:65
msgid ""
"If you like to exclude all groups from syncing and use the Telgeram-"
"Bridge only for direct chats, you can add the following additional "
"playbook configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:71
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:73
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:75
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:77
msgid ""
"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
"Secret Auth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:79
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) or [Shared "
"Secret Auth](configuring-playbook-shared-secret-auth.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:81
msgid ""
"Enabling [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) is the recommended way of setting up Double Puppeting, "
"as it's easier to accomplish, works for all your users automatically, and"
" has less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:83
msgid ""
"Enabling double puppeting by enabling the [Shared Secret Auth"
"](configuring-playbook-shared-secret-auth.md) service works at the time "
"of writing, but is deprecated and will stop working in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:85
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:87
msgid ""
"**Note**: This method for enabling Double Puppeting can be configured "
"only after you've already set up bridging."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:89
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:91
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:93
msgid ""
"send `login-matrix` to the bot and follow instructions about how to send "
"the access token to it"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-telegram.md:95
msgid ""
"make sure you don't log out the `Mautrix-Telegram` device some time in "
"the future, as that would break the Double Puppeting feature"
msgstr ""

190
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po Normal file
View File

@@ -0,0 +1,190 @@
# 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/configuring-playbook-bridge-mautrix-twitter.md:1
msgid "Setting up Mautrix Twitter bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:3
msgid ""
"**Note**: bridging to [Twitter](https://twitter.com/) can also happen via"
" the [mx-puppet-twitter](configuring-playbook-bridge-mx-puppet-"
"twitter.md) bridge supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:5
msgid ""
"The playbook can install and configure [mautrix-"
"twitter](https://github.com/mautrix/twitter) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:7
msgid ""
"See the project's [documentation](https://github.com/mautrix/twitter) to "
"learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:9
msgid "Prerequisite (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:11
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) or [Shared Secret Auth](configuring-playbook-shared-"
"secret-auth.md) service for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:13
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:15
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:17
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:23
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:25
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:32
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:34
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:36
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:38
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-bridge-mautrix-twitter.md:40
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:42
msgid ""
"You then need to start a chat with `@twitterbot:example.com` (where "
"`example.com` is your base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:43
msgid ""
"Send login-cookie to start the login. The bot should respond with "
"instructions on how to proceed."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:45
msgid ""
"You can learn more here about authentication from the bridge's [official "
"documentation on "
"Authentication](https://docs.mau.fi/bridges/python/twitter/authentication.html)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:47
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:49
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:51
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:53
msgid ""
"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
"Secret Auth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:55
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) or [Shared "
"Secret Auth](configuring-playbook-shared-secret-auth.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:57
msgid ""
"Enabling [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) is the recommended way of setting up Double Puppeting, "
"as it's easier to accomplish, works for all your users automatically, and"
" has less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:59
msgid ""
"Enabling double puppeting by enabling the [Shared Secret Auth"
"](configuring-playbook-shared-secret-auth.md) service works at the time "
"of writing, but is deprecated and will stop working in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:61
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:63
msgid ""
"This method is currently not available for the Mautrix-Twitter bridge, "
"but is on the "
"[roadmap](https://github.com/mautrix/twitter/blob/master/ROADMAP.md) "
"under Misc/Manual login with `login-matrix`"
msgstr ""

213
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-whatsapp.po Normal file
View File

@@ -0,0 +1,213 @@
# 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/configuring-playbook-bridge-mautrix-whatsapp.md:1
msgid "Setting up Mautrix Whatsapp bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:3
msgid ""
"The playbook can install and configure [mautrix-"
"whatsapp](https://github.com/mautrix/whatsapp) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:5
msgid ""
"See the project's "
"[documentation](https://docs.mau.fi/bridges/go/whatsapp/index.html) to "
"learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:7
msgid "Prerequisite (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:9
msgid ""
"If you want to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do) for this bridge automatically, you need to "
"have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) or [Shared Secret Auth](configuring-playbook-shared-"
"secret-auth.md) service for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:11
msgid ""
"For details about configuring Double Puppeting for this bridge, see the "
"section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:13
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:15
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:21
msgid ""
"Whatsapp multidevice beta is required, now it is enough if Whatsapp is "
"connected to the Internet every 2 weeks."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:23
msgid ""
"The relay bot functionality is off by default. If you would like to "
"enable the relay bot, add the following to your `vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:29
msgid ""
"By default, only admins are allowed to set themselves as relay users. To "
"allow anyone on your homeserver to set themselves as relay users add this"
" to your `vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:35
msgid ""
"If you want to activate the relay bot in a room, send `!wa set-relay`. To"
" deactivate, send `!wa unset-relay`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:37
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:39
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:46
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:48
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:50
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:52
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-bridge-mautrix-whatsapp.md:54
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:56
msgid ""
"To use the bridge, you need to start a chat with "
"`@whatsappbot:example.com` (where `example.com` is your base domain, not "
"the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:58
msgid "💡 Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:60
msgid ""
"After successfully enabling bridging, you may wish to set up [Double "
"Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
"(hint: you most likely do)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:62
msgid "To set it up, you have 2 ways of going about it."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:64
msgid ""
"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
"Secret Auth"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:66
msgid ""
"The bridge automatically performs Double Puppeting if [Appservice Double "
"Puppet](configuring-playbook-appservice-double-puppet.md) or [Shared "
"Secret Auth](configuring-playbook-shared-secret-auth.md) service is "
"configured and enabled on the server for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:68
msgid ""
"Enabling [Appservice Double Puppet](configuring-playbook-appservice-"
"double-puppet.md) is the recommended way of setting up Double Puppeting, "
"as it's easier to accomplish, works for all your users automatically, and"
" has less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:70
msgid ""
"Enabling double puppeting by enabling the [Shared Secret Auth"
"](configuring-playbook-shared-secret-auth.md) service works at the time "
"of writing, but is deprecated and will stop working in the future."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:72
msgid "Method 2: manually, by asking each user to provide a working access token"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:74
msgid ""
"When using this method, **each user** that wishes to enable Double "
"Puppeting needs to follow the following steps:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:76
msgid ""
"retrieve a Matrix access token for yourself. Refer to the documentation "
"on [how to do that](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:78
msgid ""
"send the access token to the bot. Example: `login-matrix "
"MATRIX_ACCESS_TOKEN_HERE`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-whatsapp.md:80
msgid ""
"make sure you don't log out the `Mautrix-Whatsapp` device some time in "
"the future, as that would break the Double Puppeting feature"
msgstr ""

146
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po Normal file
View File

@@ -0,0 +1,146 @@
# 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/configuring-playbook-bridge-mautrix-wsproxy.md:1
msgid ""
"Setting up Mautrix wsproxy for bridging Android SMS or Apple iMessage "
"(optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:3
msgid ""
"The playbook can install and configure [mautrix-"
"wsproxy](https://github.com/mautrix/wsproxy) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:5
msgid ""
"See the project's "
"[documentation](https://github.com/mautrix/wsproxy#readme) to learn what "
"it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:9
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:21
msgid ""
"Note that the tokens must match what is compiled into the [mautrix-"
"imessage](https://github.com/mautrix/imessage) bridge running on your Mac"
" or Android device."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:23
msgid "Adjusting the wsproxy URL"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:25
msgid ""
"By default, this playbook installs wsproxy on the `wsproxy.` subdomain "
"(`wsproxy.example.com`) and requires you to [adjust your DNS records"
"](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:27
msgid ""
"By tweaking the `matrix_mautrix_wsproxy_hostname` variable, you can "
"easily make the service available at a **different hostname** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:29
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:36
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:38
msgid ""
"Once you've decided on the domain, **you may need to adjust your DNS** "
"records to point the wsproxy domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:40
msgid ""
"By default, you will need to create a CNAME record for `wsproxy`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:42
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:44
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:51
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:53
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:55
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:57
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-bridge-mautrix-wsproxy.md:59
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:61
msgid ""
"Follow the [matrix-imessage "
"documenation](https://docs.mau.fi/bridges/go/imessage/index.html) for "
"running `android-sms` and/or `matrix-imessage` on your device(s)."
msgstr ""

140
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po Normal file
View File

@@ -0,0 +1,140 @@
# 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/configuring-playbook-bridge-mx-puppet-discord.md:1
msgid "Setting up MX Puppet Discord bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:3
msgid ""
"**Note**: bridging to [Discord](https://discordapp.com/) can also happen "
"via the [matrix-appservice-discord](configuring-playbook-bridge-"
"appservice-discord.md)and [mautrix-discord](configuring-playbook-bridge-"
"mautrix-discord.md) bridges supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:4
msgid ""
"For using as a Bot we recommend the [Appservice Discord](configuring-"
"playbook-bridge-appservice-discord.md), because it supports plumbing."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:5
msgid ""
"For personal use with a discord account we recommend the [mautrix-discord"
"](configuring-playbook-bridge-mautrix-discord.md) bridge, because it is "
"the most fully-featured and stable of the 3 Discord bridges supported by "
"the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:7
msgid ""
"The playbook can install and configure [mx-puppet-"
"discord](https://gitlab.com/mx-puppet/discord/mx-puppet-discord) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:9
msgid ""
"See the project page to learn what it does and why it might be useful to "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:11
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:13
msgid ""
"To enable the [Discord](https://discordapp.com/) bridge, add the "
"following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:19
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:21
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:28
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:30
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:32
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:34
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-bridge-mx-puppet-discord.md:36
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:38
msgid ""
"To use the bridge, you need to start a chat with `Discord Puppet Bridge` "
"with the handle `@_discordpuppet_bot:example.com` (where `example.com` is"
" your base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:40
msgid ""
"Three authentication methods are available, Legacy Token, OAuth and xoxc "
"token. See mx-puppet-discord [documentation](https://gitlab.com/mx-"
"puppet/discord/mx-puppet-discord) for more information about how to "
"configure the bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:42
msgid "Once logged in, send `list` to the bot user to list the available rooms."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:44
msgid ""
"Clicking rooms in the list will result in you receiving an invitation to "
"the bridged room."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:46
msgid "Also send `help` to the bot to see the commands available."
msgstr ""

124
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po Normal file
View File

@@ -0,0 +1,124 @@
# 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/configuring-playbook-bridge-mx-puppet-groupme.md:1
msgid "Setting up MX Puppet GroupMe bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:3
msgid ""
"The playbook can install and configure [mx-puppet-"
"groupme](https://gitlab.com/xangelix-pub/matrix/mx-puppet-groupme) for "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:5
msgid ""
"See the project page to learn what it does and why it might be useful to "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:9
msgid ""
"To enable the [GroupMe](https://groupme.com/) bridge, add the following "
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:15
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:17
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:24
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:26
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:28
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:30
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-bridge-mx-puppet-groupme.md:32
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:34
msgid ""
"To use the bridge, you need to start a chat with `GroupMe Puppet Bridge` "
"with the handle `@_groupmepuppet_bot:example.com` (where `example.com` is"
" your base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:36
msgid "One authentication method is available."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:38
msgid ""
"To link your GroupMe account, go to "
"[dev.groupme.com](https://dev.groupme.com/), sign in, and select \"Access"
" Token\" from the top menu. Copy the token and message the bridge with:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:44
msgid ""
"Once logged in, send `listrooms` to the bot user to list the available "
"rooms."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:46
msgid ""
"Clicking rooms in the list will result in you receiving an invitation to "
"the bridged room."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:48
msgid "Also send `help` to the bot to see the commands available."
msgstr ""

138
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-instagram.po Normal file
View File

@@ -0,0 +1,138 @@
# 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/configuring-playbook-bridge-mx-puppet-instagram.md:1
msgid "Setting up MX Puppet Instagram bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:3
msgid ""
"The playbook can install and configure [mx-puppet-"
"instagram](https://github.com/Sorunome/mx-puppet-instagram) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:5
msgid "This allows you to bridge Instagram DirectMessages into Matrix."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:9
msgid ""
"To enable the [Instagram](https://www.instagram.com/) bridge, add the "
"following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:15
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:17
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:24
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:26
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:28
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:30
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-bridge-mx-puppet-instagram.md:32
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:34
msgid ""
"To use the bridge, you need to start a chat with `Instagram Puppet "
"Bridge` with the handle `@_instagrampuppet_bot:example.com` (where "
"`example.com` is your base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:36
msgid ""
"Send `link <username> <password>` to the bridge bot to link your "
"instagram account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:38
msgid ""
"The `list` commands shows which accounts are linked and which `puppetId` "
"is associated."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:40
msgid "For double-puppeting, you probably want to issue these commands:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:42
msgid ""
"`settype $puppetId puppet` to enable puppeting for the link (instead of "
"relaying)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:43
msgid "`setautoinvite $puppetId 1` to automatically invite you to chats"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:44
msgid ""
"`setmatrixtoken $accessToken` to set the access token to enable puppeting"
" from the other side (the \"double\" in double puppeting)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:46
msgid ""
"If you are linking only one Instagram account, your `$puppetId` is "
"probably 1, but use the `list` command find out."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-instagram.md:48
msgid ""
"The `help` command shows which commands are available, though at the time"
" of writing, not every command is fully implemented."
msgstr ""

42
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-skype.po Normal file
View File

@@ -0,0 +1,42 @@
# 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/configuring-playbook-bridge-mx-puppet-skype.md:1
msgid "Setting up MX Puppet Skype bridging (optional, removed)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-skype.md:3
msgid ""
"The playbook used to be able to install and configure [mx-puppet-"
"skype](https://github.com/Sorunome/mx-puppet-skype), but no longer "
"includes this component, because it has been broken and unmaintained for "
"a long time."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-skype.md:5
msgid ""
"Bridging to [Skype](https://www.skype.com/) can also happen via the [go-"
"skype-bridge](configuring-playbook-bridge-go-skype-bridge.md) bridge "
"supported by the playbook."
msgstr ""

137
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po Normal file
View File

@@ -0,0 +1,137 @@
# Translations template for PROJECT.
# Copyright (C) 2024 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PROJECT VERSION\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\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-Team: LANGUAGE <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-bridge-mx-puppet-slack.md:1
msgid "Setting up MX Puppet Slack bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:3
msgid ""
"**Note**: bridging to [Slack](https://slack.com) can also happen via the "
"[matrix-appservice-slack](configuring-playbook-bridge-appservice-"
"slack.md) and [mautrix-slack](configuring-playbook-bridge-mautrix-"
"slack.md) bridges supported by the playbook. Note that `matrix-"
"appservice-slack` is not available for new installation unless you have "
"already created a classic Slack application, because the creation of "
"classic Slack applications, which this bridge makes use of, has been "
"discontinued."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:5
msgid ""
"The playbook can install and configure [mx-puppet-"
"slack](https://gitlab.com/mx-puppet/slack/mx-puppet-slack) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:7
msgid ""
"See the project page to learn what it does and why it might be useful to "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:9
msgid "Prerequisite"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:11
msgid ""
"Follow the [OAuth credentials](https://gitlab.com/mx-puppet/slack/mx-"
"puppet-slack#option-2-oauth) instructions to create a new Slack app, "
"setting the redirect URL to `https://matrix.example.com/slack/oauth`."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:13
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:15
msgid ""
"To enable the [Slack](https://slack.com/) bridge, add the following "
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:24
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:26
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:33
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:35
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:37
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:39
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-bridge-mx-puppet-slack.md:41
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:43
msgid ""
"To use the bridge, you need to start a chat with `Slack Puppet Bridge` "
"with the handle `@_slackpuppet_bot:example.com` (where `example.com` is "
"your base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:45
msgid ""
"Three authentication methods are available, Legacy Token, OAuth and xoxc "
"token. See mx-puppet-slack [documentation](https://gitlab.com/mx-"
"puppet/slack/mx-puppet-slack) for more information about how to configure"
" the bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:47
msgid "Once logged in, send `list` to the bot user to list the available rooms."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:49
msgid ""
"Clicking rooms in the list will result in you receiving an invitation to "
"the bridged room."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:51
msgid "Also send `help` to the bot to see the commands available."
msgstr ""

117
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po Normal file
View File

@@ -0,0 +1,117 @@
# 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/configuring-playbook-bridge-mx-puppet-steam.md:1
msgid "Setting up MX Puppet Steam bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:3
msgid ""
"The playbook can install and configure [mx-puppet-"
"steam](https://github.com/icewind1991/mx-puppet-steam) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:5
msgid ""
"See the project page to learn what it does and why it might be useful to "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:9
msgid ""
"To enable the [Steam](https://steampowered.com/) bridge, add the "
"following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:15
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:17
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:24
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:26
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:28
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:30
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-bridge-mx-puppet-steam.md:32
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:34
msgid ""
"To use the bridge, you need to start a chat with `Steam Puppet Bridge` "
"with the handle `@_steampuppet_bot:example.com` (where `example.com` is "
"your base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:36
msgid ""
"Three authentication methods are available, Legacy Token, OAuth and xoxc "
"token. See mx-puppet-steam [documentation](https://github.com/icewind1991"
"/mx-puppet-steam) for more information about how to configure the bridge."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:38
msgid "Once logged in, send `list` to the bot user to list the available rooms."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:40
msgid ""
"Clicking rooms in the list will result in you receiving an invitation to "
"the bridged room."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:42
msgid "Also send `help` to the bot to see the commands available."
msgstr ""

131
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po Normal file
View File

@@ -0,0 +1,131 @@
# 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/configuring-playbook-bridge-mx-puppet-twitter.md:1
msgid "Setting up MX Puppet Twitter bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:3
msgid ""
"**Note**: bridging to [Twitter](https://twitter.com/) can also happen via"
" the [mautrix-twitter](configuring-playbook-bridge-mautrix-twitter.md) "
"bridge supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:5
msgid ""
"The playbook can install and configure [mx-puppet-"
"twitter](https://github.com/Sorunome/mx-puppet-twitter) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:7
msgid ""
"See the project page to learn what it does and why it might be useful to "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:9
msgid "Prerequisite"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:11
msgid ""
"Make an app on "
"[developer.twitter.com](https://developer.twitter.com/en/apps)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:13
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:15
msgid ""
"To enable the [Twitter](https://twitter.com) bridge, add the following "
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:26
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:28
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:35
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:37
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:39
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:41
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-bridge-mx-puppet-twitter.md:43
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:45
msgid ""
"To use the bridge, you need to start a chat with `Twitter Puppet Bridge` "
"with the handle `@_twitterpuppet_bot:example.com` (where `example.com` is"
" your base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:47
msgid "To log in, use `link` and click the link."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:49
msgid "Once logged in, send `list` to the bot user to list the available rooms."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:51
msgid ""
"Clicking rooms in the list will result in you receiving an invitation to "
"the bridged room."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:53
msgid "Also send `help` to the bot to see the commands available."
msgstr ""

194
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po Normal file
View File

@@ -0,0 +1,194 @@
# Translations template for PROJECT.
# Copyright (C) 2024 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PROJECT VERSION\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\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-Team: LANGUAGE <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-bridge-postmoogle.md:1
msgid "Setting up Postmoogle email bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:3
msgid ""
"**Note**: email bridging can also happen via the [email2matrix"
"](configuring-playbook-email2matrix.md) bridge supported by the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:5
msgid ""
"The playbook can install and configure "
"[Postmoogle](https://github.com/etkecc/postmoogle) for you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:7
msgid ""
"Postmoogle is a bridge you can use to have its bot user forward emails to"
" Matrix rooms. It runs an SMTP email server and allows you to assign "
"mailbox addresses to the rooms."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:9
msgid ""
"See the project's [documentation](https://github.com/etkecc/postmoogle) "
"to learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:11
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:13
msgid ""
"Open the following ports on your server to be able to receive incoming "
"emails:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:15
msgid "`25/tcp`: SMTP"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:16
msgid "`587/tcp`: Submission (TLS-encrypted SMTP)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:18
msgid ""
"If you don't open these ports, you will still be able to send emails, but"
" not receive any."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:20
msgid ""
"These port numbers are configurable via the "
"`matrix_postmoogle_smtp_host_bind_port` and "
"`matrix_postmoogle_submission_host_bind_port` variables, but other email "
"servers will try to deliver on these default (standard) ports, so "
"changing them is of little use."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:22
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:24
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:45
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:47
msgid ""
"You will also need to add several DNS records so that Postmoogle can send"
" emails. See [Configuring DNS](configuring-dns.md) for details about DNS "
"changes."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:49
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:51
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:58
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:60
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create a user account of the bridge's bot."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:62
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:64
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-bridge-postmoogle.md:66
msgid ""
"If you change the bridge's bot password (`matrix_postmoogle_password` in "
"your `vars.yml` file) subsequently, the bot user's credentials on the "
"homeserver won't be updated automatically. If you'd like to change the "
"bot user's password, use a tool like [synapse-admin](configuring-"
"playbook-synapse-admin.md) to change it, and then update "
"`matrix_postmoogle_password` to let the bot know its new password."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:68
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:70
msgid ""
"To use the bridge, invite the `@postmoogle:example.com` bot user into a "
"room you want to use as a mailbox."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:72
msgid ""
"Then send `!pm mailbox NAME` to expose this Matrix room as an inbox with "
"the email address `NAME@matrix.example.com`. Emails sent to that email "
"address will be forwarded to the room."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:74
msgid ""
"Send `!pm help` to the room to see the bridge's help menu for additional "
"commands."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:76
msgid ""
"You can also refer to the upstream "
"[documentation](https://github.com/etkecc/postmoogle)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:78
msgid "Debug/Logs"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:80
msgid ""
"As with all other services, you can find their logs in [systemd-"
"journald](https://www.freedesktop.org/software/systemd/man/systemd-"
"journald.service.html) by running something like `journalctl -fu matrix-"
"postmoogle`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:82
msgid ""
"The default logging level for this bridge is `INFO`, but you can increase"
" it to `DEBUG` with the following additional configuration:"
msgstr ""

99
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po Normal file
View File

@@ -0,0 +1,99 @@
# 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/configuring-playbook-bridge-wechat.md:1
msgid "Setting up WeChat bridging (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:3
msgid ""
"The playbook can install and configure the [matrix-"
"wechat](https://github.com/duo/matrix-wechat) bridge for you (for "
"bridging to the [WeChat](https://www.wechat.com/) network)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:5
msgid ""
"See the project page to learn what it does and why it might be useful to "
"you."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:9
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:15
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:17
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:24
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:26
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:28
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:30
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-bridge-wechat.md:32
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:34
msgid ""
"Once the bridge is installed, start a chat with `@wechatbot:example.com` "
"(where `example.com` is your base domain, not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-bridge-wechat.md:36
msgid "Send `help` to the bot to see the available commands."
msgstr ""

238
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-cactus-comments.po Normal file
View File

@@ -0,0 +1,238 @@
# 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/configuring-playbook-cactus-comments.md:1
msgid "Setting up Cactus Comments (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:3
msgid ""
"The playbook can install and configure the [Cactus "
"Comments](https://cactus.chat) system for you."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:5
msgid ""
"Cactus Comments is a **federated comment system** built on Matrix. It "
"respects your privacy, and puts you in control."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:7
msgid ""
"See the project's [documentation](https://cactus.chat/docs/getting-"
"started/introduction/) to learn what it does and why it might be useful "
"to you."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:9
msgid ""
"The playbook contains 2 roles for configuring different pieces of the "
"Cactus Comments system:"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:11
msgid ""
"`matrix-cactus-comments` - the backend appservice integrating with the "
"Matrix homeserver"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:13
msgid ""
"`matrix-cactus-comments-client` - a static website server serving the "
"[cactus-client](https://cactus.chat/docs/client/introduction/) static "
"assets (`cactus.js` and `styles.css`)"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:15
msgid "You can enable whichever component you need (typically both)."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:17
msgid "Configuration"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:19
msgid ""
"To enable Cactus Comments, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:41
msgid "Adjusting the Cactus Comments' client URL"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:43
msgid ""
"By default, this playbook installs Cactus Comments' client on the "
"`matrix.` subdomain, at the `/cactus-comments` path "
"(https://matrix.example.com/cactus-comments). This makes it easy to "
"install it, because it **doesn't require additional DNS records to be set"
" up**. If that's okay, you can skip this section."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:45
msgid ""
"By tweaking the `matrix_cactus_comments_client_hostname` and "
"`matrix_cactus_comments_client_path_prefix` variables, you can easily "
"make the service available at a **different hostname and/or path** than "
"the default one."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:47
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:56
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:58
msgid ""
"If you've changed the default hostname, **you may need to adjust your "
"DNS** records to point the Cactus Comments' client domain to the Matrix "
"server."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:60
msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:62
msgid ""
"If you've decided to use the default hostname, you won't need to do any "
"extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:64
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:66
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:73
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:75
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:77
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:79
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-cactus-comments.md:81
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:83
msgid ""
"Upon starting Cactus Comments, a `bot.cactusbot` user account is created "
"automatically."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:85
msgid ""
"To get started, send a `help` message to the `@bot.cactusbot:example.com`"
" bot to confirm it's working."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:87
msgid ""
"Then, register a site by sending `register <YourSiteName>` (where "
"`<YourSiteName>` is a unique identifier you choose. It does not have to "
"match your domain). You will then be invited into a moderation room."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:89
msgid "Now you are good to go and can embed the comment section on your website!"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:91
msgid "Embed Cactus Comments"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:93
msgid ""
"The official [documentation](https://cactus.chat/docs/getting-started"
"/quick-start/) provides a useful guide to embed Cactus Comments on your "
"website."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:95
msgid ""
"After including the JavaScript and CSS asset files, insert a `<div>` "
"where you'd like to display the comment section:"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:101
msgid ""
"Then, you need to initialize the comment section. Make sure to replace "
"`example.com` with your base domain and `<YourSiteName>` with the one "
"that has been registered above:"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:115
msgid "Adjust the domain name for self-hosting"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:117
msgid ""
"To have the assets served from your homeserver (not from `cactus.chat`), "
"you need to adjust the domain name on the official documentation."
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:119
msgid ""
"Make sure to replace `example.com` with your base domain before you "
"include the following lines, instead of the one provided by the official "
"documentation:"
msgstr ""
#: ../../../docs/configuring-playbook-cactus-comments.md:126
msgid ""
"**Note**: if the `matrix_cactus_comments_client_hostname` and "
"`matrix_cactus_comments_client_path_prefix` variables are tweaked, you "
"would need to adjust the URLs of the assets accordingly."
msgstr ""

146
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-client-cinny.po Normal file
View File

@@ -0,0 +1,146 @@
# 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/configuring-playbook-client-cinny.md:1
msgid "Setting up Cinny (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:3
msgid ""
"This playbook can install the [Cinny](https://github.com/ajbura/cinny) "
"Matrix web client for you."
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:5
msgid ""
"Cinny is a web client focusing primarily on simple, elegant and secure "
"interface. It can be installed alongside or instead of [Element Web"
"](./configuring-playbook-client-element-web.md)."
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:7
msgid ""
"💡 **Note**: the latest version of Cinny is also available on the web, "
"hosted by 3rd parties. If you trust giving your credentials to the "
"following 3rd party Single Page Applications, you can consider using it "
"from there and avoiding the (small) overhead of self-hosting:"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:9
msgid ""
"[app.cinny.in](https://app.cinny.in), hosted by the "
"[Cinny](https://cinny.in/) developers"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:11
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:13
msgid ""
"To enable Cinny, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:19
msgid "Adjusting the Cinny URL"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:21
msgid ""
"By default, this playbook installs Cinny on the `cinny.` subdomain "
"(`cinny.example.com`) and requires you to [adjust your DNS records"
"](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:23
msgid ""
"By tweaking the `matrix_client_cinny_hostname` variable, you can easily "
"make the service available at a **different hostname** than the default "
"one."
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:25
msgid ""
"While a `matrix_client_cinny_path_prefix` variable exists for tweaking "
"the path-prefix, it's [not supported "
"anymore](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/issues/3701), because Cinny requires an application rebuild (with "
"a tweaked build config) to be functional under a custom path."
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:27
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:34
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:36
msgid ""
"Once you've decided on the domain, **you may need to adjust your DNS** "
"records to point the Cinny domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:38
msgid ""
"By default, you will need to create a CNAME record for `cinny`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:40
msgid ""
"If you've adjusted `matrix_client_cinny_hostname`, you will need to "
"adjust your DNS configuration accordingly."
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:42
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:44
msgid ""
"After configuring the playbook and [adjusting your DNS records"
"](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:51
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-client-cinny.md:53
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

236
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-client-element-web.po Normal file
View File

@@ -0,0 +1,236 @@
# 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/configuring-playbook-client-element-web.md:1
msgid "Configuring Element Web (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:3
msgid ""
"By default, this playbook installs the [Element Web](https://github.com"
"/element-hq/element-web) Matrix client for you. If that's okay, you can "
"skip this document."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:5
msgid ""
"💡 **Note**: the latest version of Element Web is also available on the "
"web, hosted by 3rd parties. If you trust giving your credentials to the "
"following 3rd party Single Page Applications, you can consider using it "
"from there and avoiding the (small) overhead of self-hosting (by "
"[disabling Element Web](#disabling-element-web)):"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:7
msgid ""
"[app.element.io](https://app.element.io/), hosted by "
"[Element](https://element.io/)"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:8
msgid "[app.etke.cc](https://app.etke.cc/), hosted by [etke.cc](https://etke.cc/)"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:10
msgid "Disabling Element Web"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:12
msgid ""
"If you'd like for the playbook to not install Element Web (or to "
"uninstall it if it was previously installed), add the following "
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:18
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:20
msgid ""
"The playbook provides some customization variables you could use to "
"change Element Web's settings."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:22
msgid ""
"Their defaults are defined in [`roles/custom/matrix-client-"
"element/defaults/main.yml`](../roles/custom/matrix-client-"
"element/defaults/main.yml) and they ultimately end up in the generated "
"`/matrix/element/config.json` file (on the server). This file is "
"generated from the [`roles/custom/matrix-client-"
"element/templates/config.json.j2`](../roles/custom/matrix-client-"
"element/templates/config.json.j2) template."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:24
msgid ""
"**If there's an existing variable** which controls a setting you wish to "
"change, you can simply define that variable in your configuration file "
"(`inventory/host_vars/matrix.example.com/vars.yml`) and [re-run the "
"playbook](installing.md) to apply the changes."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:26
msgid ""
"Alternatively, **if there is no pre-defined variable** for an Element Web"
" setting you wish to change:"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:28
msgid ""
"you can either **request a variable to be created** (or you can submit "
"such a contribution yourself). Keep in mind that it's **probably not a "
"good idea** to create variables for each one of Element Web's various "
"settings that rarely get used."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:30
msgid ""
"or, you can **extend and override the default configuration** "
"([`config.json.j2`](../roles/custom/matrix-client-"
"element/templates/config.json.j2)) by making use of the "
"`matrix_client_element_configuration_extension_json_` variable. You can "
"find information about this in [`roles/custom/matrix-client-"
"element/defaults/main.yml`](../roles/custom/matrix-client-"
"element/defaults/main.yml)."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:32
msgid ""
"or, if extending the configuration is still not powerful enough for your "
"needs, you can **override the configuration completely** using "
"`matrix_client_element_configuration_default` (or "
"`matrix_client_element_configuration`). You can find information about "
"this in [`roles/custom/matrix-client-"
"element/defaults/main.yml`](../roles/custom/matrix-client-"
"element/defaults/main.yml)."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:34
msgid "Themes"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:36
msgid ""
"To change the look of Element Web, you can define your own themes "
"manually by using the "
"`matrix_client_element_setting_defaults_custom_themes` setting."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:38
msgid ""
"Or better yet, you can automatically pull it all themes provided by the "
"[aaronraimist/element-themes](https://github.com/aaronraimist/element-"
"themes) project by simply flipping a flag "
"(`matrix_client_element_themes_enabled: true`)."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:40
msgid ""
"If you make your own theme, we encourage you to submit it to the "
"**aaronraimist/element-themes** project, so that the whole community "
"could easily enjoy it."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:42
msgid ""
"Note that for a custom theme to work well, all Element Web instances that"
" you use must have the same theme installed."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:44
msgid "Adjusting the Element Web URL"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:46
msgid ""
"By default, this playbook installs Element Web on the `element.` "
"subdomain (`element.example.com`) and requires you to [adjust your DNS "
"records](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:48
msgid ""
"By tweaking the `matrix_client_element_hostname` and "
"`matrix_client_element_path_prefix` variables, you can easily make the "
"service available at a **different hostname and/or path** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:50
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:61
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:63
msgid ""
"Once you've decided on the domain and path, **you may need to adjust your"
" DNS** records to point the Element Web domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:65
msgid ""
"By default, you will need to create a CNAME record for `element`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:67
msgid ""
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
" extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:69
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:71
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:78
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-client-element-web.md:80
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

123
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-client-hydrogen.po Normal file
View File

@@ -0,0 +1,123 @@
# 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/configuring-playbook-client-hydrogen.md:1
msgid "Setting up Hydrogen (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:3
msgid ""
"This playbook can install the [Hydrogen](https://github.com/element-hq"
"/hydrogen-web) Matrix web client for you."
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:5
msgid ""
"Hydrogen is a lightweight web client that supports mobile and legacy web "
"browsers. It can be installed alongside or instead of Element Web."
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:9
msgid ""
"To enable Hydrogen, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:15
msgid "Adjusting the Hydrogen URL"
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:17
msgid ""
"By default, this playbook installs Hydrogen on the `hydrogen.` subdomain "
"(`hydrogen.example.com`) and requires you to [adjust your DNS records"
"](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:19
msgid ""
"By tweaking the `matrix_client_hydrogen_hostname` and "
"`matrix_client_hydrogen_path_prefix` variables, you can easily make the "
"service available at a **different hostname and/or path** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:21
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:32
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:34
msgid ""
"Once you've decided on the domain and path, **you may need to adjust your"
" DNS** records to point the Hydrogen domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:36
msgid ""
"By default, you will need to create a CNAME record for `hydrogen`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:38
msgid ""
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
" extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:40
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:42
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:49
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-client-hydrogen.md:51
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

232
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-client-schildichat-web.po Normal file
View File

@@ -0,0 +1,232 @@
# 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/configuring-playbook-client-schildichat-web.md:1
msgid "Setting up SchildiChat Web (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:3
msgid ""
"This playbook can install the [SchildiChat "
"Web](https://github.com/SchildiChat/schildichat-desktop) Matrix client "
"for you."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:5
msgid ""
"SchildiChat Web is a feature-rich messenger for Matrix based on Element "
"Web with some extras and tweaks. It can be installed alongside or instead"
" of Element Web."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:7
msgid ""
"💡 **Note**: the latest version of SchildiChat Web is also available on "
"the web, hosted by 3rd parties. If you trust giving your credentials to "
"the following 3rd party Single Page Application, you can consider using "
"it from there:"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:9
msgid ""
"[app.schildi.chat](https://app.schildi.chat/), hosted by the "
"[SchildiChat](https://schildi.chat/) developers"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:11
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:13
msgid ""
"To enable SchildiChat Web, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:19
msgid ""
"The playbook provides some customization variables you could use to "
"change SchildiChat Web's settings."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:21
msgid ""
"Their defaults are defined in [`roles/custom/matrix-client-"
"schildichat/defaults/main.yml`](../roles/custom/matrix-client-"
"schildichat/defaults/main.yml) and they ultimately end up in the "
"generated `/matrix/schildichat/config.json` file (on the server). This "
"file is generated from the [`roles/custom/matrix-client-"
"schildichat/templates/config.json.j2`](../roles/custom/matrix-client-"
"schildichat/templates/config.json.j2) template."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:23
msgid ""
"**If there's an existing variable** which controls a setting you wish to "
"change, you can simply define that variable in your configuration file "
"(`inventory/host_vars/matrix.example.com/vars.yml`) and [re-run the "
"playbook](installing.md) to apply the changes."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:25
msgid ""
"Alternatively, **if there is no pre-defined variable** for a SchildiChat "
"Web setting you wish to change:"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:27
msgid ""
"you can either **request a variable to be created** (or you can submit "
"such a contribution yourself). Keep in mind that it's **probably not a "
"good idea** to create variables for each one of SchildiChat Web's various"
" settings that rarely get used."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:29
msgid ""
"or, you can **extend and override the default configuration** "
"([`config.json.j2`](../roles/custom/matrix-client-"
"schildichat/templates/config.json.j2)) by making use of the "
"`matrix_client_schildichat_configuration_extension_json_` variable. You "
"can find information about this in [`roles/custom/matrix-client-"
"schildichat/defaults/main.yml`](../roles/custom/matrix-client-"
"schildichat/defaults/main.yml)."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:31
msgid ""
"or, if extending the configuration is still not powerful enough for your "
"needs, you can **override the configuration completely** using "
"`matrix_client_schildichat_configuration_default` (or "
"`matrix_client_schildichat_configuration`). You can find information "
"about this in [`roles/custom/matrix-client-"
"schildichat/defaults/main.yml`](../roles/custom/matrix-client-"
"schildichat/defaults/main.yml)."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:33
msgid "Themes"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:35
msgid ""
"To change the look of SchildiChat Web, you can define your own themes "
"manually by using the "
"`matrix_client_schildichat_setting_defaults_custom_themes` setting."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:37
msgid ""
"Or better yet, you can automatically pull it all themes provided by the "
"[aaronraimist/element-themes](https://github.com/aaronraimist/element-"
"themes) project by simply flipping a flag "
"(`matrix_client_schildichat_themes_enabled: true`)."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:39
msgid ""
"If you make your own theme, we encourage you to submit it to the "
"**aaronraimist/element-themes** project, so that the whole community "
"could easily enjoy it."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:41
msgid ""
"Note that for a custom theme to work well, all SchildiChat Web instances "
"that you use must have the same theme installed."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:43
msgid "Adjusting the SchildiChat Web URL"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:45
msgid ""
"By default, this playbook installs SchildiChat Web on the `schildichat.` "
"subdomain (`schildichat.example.com`) and requires you to [adjust your "
"DNS records](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:47
msgid ""
"By tweaking the `matrix_client_schildichat_hostname` and "
"`matrix_client_schildichat_path_prefix` variables, you can easily make "
"the service available at a **different hostname and/or path** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:49
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:60
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:62
msgid ""
"Once you've decided on the domain and path, **you may need to adjust your"
" DNS** records to point the SchildiChat Web domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:64
msgid ""
"By default, you will need to create a CNAME record for `schildichat`. See"
" [Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:66
msgid ""
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
" extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:68
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:70
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:77
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-client-schildichat-web.md:79
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

138
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-conduit.po Normal file
View File

@@ -0,0 +1,138 @@
# 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/configuring-playbook-conduit.md:1
msgid "Configuring Conduit (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:3
msgid ""
"By default, this playbook configures the [Synapse](https://github.com"
"/element-hq/synapse) Matrix server, but you can also use "
"[Conduit](https://conduit.rs)."
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:5
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:7
msgid ""
"**You can't switch an existing Matrix server's implementation** (e.g. "
"Synapse -> Conduit). Proceed below only if you're OK with losing data or "
"you're dealing with a server on a new domain name, which hasn't "
"participated in the Matrix federation yet."
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:9
msgid ""
"**homeserver implementations other than Synapse may not be fully "
"functional**. The playbook may also not assist you in an optimal way "
"(like it does with Synapse). Make yourself familiar with the downsides "
"before proceeding"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:11
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:13
msgid ""
"To use Conduit, you **generally** need to add the following configuration"
" to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:19
msgid "Creating the first user account"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:21
msgid ""
"Since it is difficult to create the first user account on Conduit (see "
"[famedly/conduit#276](https://gitlab.com/famedly/conduit/-/issues/276) "
"and "
"[famedly/conduit#354](https://gitlab.com/famedly/conduit/-/merge_requests/354))"
" and it does not support [registering users](registering-users.md) (via "
"the command line or via the playbook) like Synapse and Dendrite do, we "
"recommend the following procedure:"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:23
msgid ""
"Add `matrix_conduit_allow_registration: true` to your `vars.yml` the "
"first time around, temporarily"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:24
msgid ""
"Run the playbook (`ansible-playbook -i inventory/hosts setup.yml --tags"
"=setup-all,start` - see [Installing](installing.md))"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:25
msgid ""
"Create your first user via Element Web or any other client which supports"
" creating users"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:26
msgid "Get rid of `matrix_conduit_allow_registration: true` from your `vars.yml`"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:27
msgid ""
"Run the playbook again (`ansible-playbook -i inventory/hosts setup.yml "
"--tags=setup-conduit,start` would be enough this time)"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:28
msgid ""
"You can now use your server safely. Additional users can be created by "
"messaging the internal Conduit bot"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:30
msgid "Configuring bridges / appservices"
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:32
msgid ""
"Automatic appservice setup is currently unsupported when using Conduit. "
"After setting up the service as usual you may notice that it is unable to"
" start."
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:34
msgid ""
"You will have to manually register appservices using the the [register-"
"appservice](https://gitlab.com/famedly/conduit/-/blob/next/APPSERVICES.md)"
" command."
msgstr ""
#: ../../../docs/configuring-playbook-conduit.md:36
msgid ""
"Find the `registration.yaml` in the `/matrix` directory, for example "
"`/matrix/mautrix-signal/bridge/registration.yaml`, then pass the content "
"to Conduit:"
msgstr ""

152
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-dendrite.po Normal file
View File

@@ -0,0 +1,152 @@
# 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/configuring-playbook-dendrite.md:1
msgid "Configuring Dendrite (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:3
msgid ""
"By default, this playbook configures the [Synapse](https://github.com"
"/element-hq/synapse) Matrix server, but you can also use "
"[Dendrite](https://github.com/matrix-org/dendrite)."
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:5
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:7
msgid ""
"**You can't switch an existing Matrix server's implementation** (e.g. "
"Synapse -> Dendrite). Proceed below only if you're OK with losing data or"
" you're dealing with a server on a new domain name, which hasn't "
"participated in the Matrix federation yet."
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:9
msgid ""
"**homeserver implementations other than Synapse may not be fully "
"functional**. The playbook may also not assist you in an optimal way "
"(like it does with Synapse). Make yourself familiar with the downsides "
"before proceeding"
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:11
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:13
msgid ""
"To use Dendrite, you **generally** need to add the following "
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:19
msgid ""
"The playbook provides lots of customization variables you could use to "
"change Dendrite's settings."
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:21
msgid ""
"Their defaults are defined in [`roles/custom/matrix-"
"dendrite/defaults/main.yml`](../roles/custom/matrix-"
"dendrite/defaults/main.yml) and they ultimately end up in the generated "
"`/matrix/dendrite/config/dendrite.yaml` file (on the server). This file "
"is generated from the [`roles/custom/matrix-"
"dendrite/templates/dendrite/dendrite.yaml.j2`](../roles/custom/matrix-"
"dendrite/templates/dendrite/dendrite.yaml.j2) template."
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:23
msgid ""
"**If there's an existing variable** which controls a setting you wish to "
"change, you can simply define that variable in your configuration file "
"(`inventory/host_vars/matrix.example.com/vars.yml`) and [re-run the "
"playbook](installing.md) to apply the changes."
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:25
msgid ""
"Alternatively, **if there is no pre-defined variable** for a Dendrite "
"setting you wish to change:"
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:27
msgid ""
"you can either **request a variable to be created** (or you can submit "
"such a contribution yourself). Keep in mind that it's **probably not a "
"good idea** to create variables for each one of Dendrite's various "
"settings that rarely get used."
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:29
msgid ""
"or, you can **extend and override the default configuration** "
"([`dendrite.yaml.j2`](../roles/custom/matrix-"
"dendrite/templates/dendrite/dendrite.yaml.j2)) by making use of the "
"`matrix_dendrite_configuration_extension_yaml` variable. You can find "
"information about this in [`roles/custom/matrix-"
"dendrite/defaults/main.yml`](../roles/custom/matrix-"
"dendrite/defaults/main.yml)."
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:31
msgid ""
"or, if extending the configuration is still not powerful enough for your "
"needs, you can **override the configuration completely** using "
"`matrix_dendrite_configuration` (or "
"`matrix_dendrite_configuration_yaml`). You can find information about "
"this in [`roles/custom/matrix-"
"dendrite/defaults/main.yml`](../roles/custom/matrix-"
"dendrite/defaults/main.yml)."
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:33
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:35
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:42
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-dendrite.md:44
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

259
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-dimension.po Normal file
View File

@@ -0,0 +1,259 @@
# 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/configuring-playbook-dimension.md:1
msgid "Setting up Dimension integration manager (optional, unmaintained)"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:3
msgid ""
"**[Dimension](https://dimension.t2bot.io) can only be installed after "
"Matrix services are installed and running.** If you're just installing "
"Matrix services for the first time, please continue with the "
"[Configuration](configuring-playbook.md) / [Installation](installing.md) "
"flow and come back here later."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:5
msgid ""
"**Note**: Dimension is **[officially "
"unmaintained](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/issues/2806#issuecomment-1673559299)**. We recommend not bothering"
" with installing it."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:7
msgid ""
"**Note**: This playbook now supports running "
"[Dimension](https://dimension.t2bot.io) in both a federated and "
"[unfederated](https://github.com/turt2live/matrix-"
"dimension/blob/master/docs/unfederated.md) environments. This is handled "
"automatically based on the value of "
"`matrix_homeserver_federation_enabled`. Enabling Dimension, means that "
"the `openid` API endpoints will be exposed on the Matrix Federation port "
"(usually `8448`), even if [federation](configuring-playbook-"
"federation.md) is disabled. It's something to be aware of, especially in "
"terms of firewall whitelisting (make sure port `8448` is accessible)."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:9
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:11
msgid ""
"To enable Dimension, add this to your configuration file "
"(`inventory/host_vars/matrix.example.com/vars.yml`):"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:17
msgid "Define admin users"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:19
msgid ""
"These users can modify the integrations this Dimension supports. Add this"
" to your configuration file "
"(`inventory/host_vars/matrix.example.com/vars.yml`):"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:27
msgid ""
"The admin interface is accessible within Element Web by accessing it in "
"any room and clicking the cog wheel/settings icon in the top right. "
"Currently, Dimension can be opened in Element Web by the \"Add widgets, "
"bridges, & bots\" link in the room information."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:29
msgid "Access token"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:31
msgid ""
"We recommend that you create a dedicated Matrix user for Dimension "
"(`dimension` is a good username). Follow our [Registering users"
"](registering-users.md) guide to learn how to register **a regular (non-"
"admin) user**."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:33
msgid ""
"You are required to specify an access token (belonging to this new user) "
"for Dimension to work. To get an access token for the Dimension user, you"
" can follow the documentation on [how to do obtain an access token"
"](obtaining-access-tokens.md)."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:35
msgid ""
"**Access tokens are sensitive information. Do not include them in any bug"
" reports, messages, or logs. Do not share the access token with anyone.**"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:37
msgid ""
"Add access token to your configuration file "
"(`inventory/host_vars/matrix.example.com/vars.yml`):"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:43
msgid ""
"For more information on how to acquire an access token, visit "
"[https://t2bot.io/docs/access_tokens](https://t2bot.io/docs/access_tokens)."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:45
msgid "Adjusting the Dimension URL"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:47
msgid ""
"By default, this playbook installs Dimension on the `dimension.` "
"subdomain (`dimension.example.com`) and requires you to [adjust your DNS "
"records](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:49
msgid ""
"By tweaking the `matrix_dimension_hostname` and "
"`matrix_dimension_path_prefix` variables, you can easily make the service"
" available at a **different hostname and/or path** than the default one."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:51
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:62
msgid ""
"**Note**: While there is a `matrix_dimension_path_prefix` variable for "
"changing the path where Dimension is served, overriding it is not "
"possible due to [this Dimension issue](https://github.com/turt2live"
"/matrix-dimension/issues/510). You must serve Dimension at a dedicated "
"subdomain."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:64
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:66
msgid ""
"Once you've decided on the domain and path, **you may need to adjust your"
" DNS** records to point the Dimension domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:68
msgid ""
"By default, you will need to create a CNAME record for `dimension`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:70
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:72
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:79
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:81
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:83
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:85
msgid ""
"After Dimension has been installed you may need to log out and log back "
"in for it to pick up the new integration manager. Then you can access "
"integrations in Element Web by opening a room, clicking the Room info "
"button (`i`) button in the top right corner of the screen, and then "
"clicking Add widgets, bridges & bots."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:87
msgid "Jitsi domain"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:89
msgid ""
"By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as "
"the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video "
"conference widgets. For users running [a self-hosted Jitsi instance"
"](./configuring-playbook-jitsi.md), you will likely want the widget to "
"use your own Jitsi instance. Currently there is no way to configure this "
"via the playbook, see [this issue](https://github.com/turt2live/matrix-"
"dimension/issues/345) for details."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:91
msgid ""
"In the interim until the above limitation is resolved, an admin user "
"needs to configure the domain via the admin ui once dimension is running."
" In Element Web, go to *Manage Integrations* &rightarrow; *Settings* "
"&rightarrow; *Widgets* &rightarrow; *Jitsi Conference Settings* and set "
"*Jitsi Domain* and *Jitsi Script URL* appropriately."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:93
msgid "Additional features"
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:95
msgid ""
"To use a more custom configuration, you can define a "
"`matrix_dimension_configuration_extension_yaml` string variable and put "
"your configuration in it. To learn more about how to do this, refer to "
"the information about `matrix_dimension_configuration_extension_yaml` in "
"the [default variables file](../roles/custom/matrix-"
"dimension/defaults/main.yml) of the Dimension component."
msgstr ""
#: ../../../docs/configuring-playbook-dimension.md:97
msgid ""
"You can find all configuration options on [GitHub page of Dimension "
"project](https://github.com/turt2live/matrix-"
"dimension/blob/master/config/default.yaml)."
msgstr ""

100
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-dynamic-dns.po Normal file
View File

@@ -0,0 +1,100 @@
# 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/configuring-playbook-dynamic-dns.md:1
msgid "Setting up Dynamic DNS (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:3
msgid ""
"The playbook can configure Dynamic DNS with "
"[ddclient⁠](https://github.com/ddclient/ddclient) for you. It is a Perl "
"client used to update dynamic DNS entries for accounts on Dynamic DNS "
"Network Service Provider."
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:5
msgid ""
"Most cloud providers / ISPs will charge you extra for a static IP "
"address. If you're not hosting a highly reliable homeserver you can "
"workaround this via dynamic DNS."
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:7
msgid "Prerequisite"
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:9
msgid ""
"You'll need to get a username and password from your DNS provider. Please"
" consult with the provider about how to retrieve them."
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:11
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:13
msgid ""
"To enable dynamic DNS, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:26
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:28
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:35
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:37
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:39
msgid "Additional Reading"
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:41
msgid "Additional resources:"
msgstr ""
#: ../../../docs/configuring-playbook-dynamic-dns.md:43
msgid "https://matrix.org/docs/guides/free-small-matrix-server"
msgstr ""

128
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email.po Normal file
View File

@@ -0,0 +1,128 @@
# 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/configuring-playbook-email.md:1
msgid "Adjusting email-sending settings (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-email.md:3
msgid ""
"By default, this playbook sets up an [Exim](https://www.exim.org/) email "
"server through which all Matrix services send emails."
msgstr ""
#: ../../../docs/configuring-playbook-email.md:5
msgid ""
"The email server would attempt to deliver emails directly to their final "
"destination. This may or may not work, depending on your domain "
"configuration (SPF settings, etc.)"
msgstr ""
#: ../../../docs/configuring-playbook-email.md:7
msgid ""
"By default, emails are sent from `matrix@matrix.example.com`, as "
"specified by the `exim_relay_sender_address` playbook variable."
msgstr ""
#: ../../../docs/configuring-playbook-email.md:9
msgid ""
"⚠️ **Warning**: On some cloud providers (Google Cloud, etc.), [port 25 is"
" always blocked](https://cloud.google.com/compute/docs/tutorials/sending-"
"mail/), so sending email directly from your server is not possible. You "
"will need to [relay email through another SMTP server](#relaying-email-"
"through-another-smtp-server)."
msgstr ""
#: ../../../docs/configuring-playbook-email.md:11
msgid ""
"💡 To improve deliverability, we recommend [relaying email through another"
" SMTP server](#relaying-email-through-another-smtp-server) anyway."
msgstr ""
#: ../../../docs/configuring-playbook-email.md:13
msgid "Firewall settings"
msgstr ""
#: ../../../docs/configuring-playbook-email.md:15
msgid ""
"No matter whether you send email directly (the default) or you relay "
"email through another host (see how below), you'll probably need to allow"
" outgoing traffic for TCP ports 25/587 (depending on configuration)."
msgstr ""
#: ../../../docs/configuring-playbook-email.md:17
msgid "Relaying email through another SMTP server"
msgstr ""
#: ../../../docs/configuring-playbook-email.md:19
msgid ""
"If you'd like to relay email through another SMTP server, add the "
"following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-email.md:31
msgid ""
"**Note**: only the secure submission protocol (using `STARTTLS`, usually "
"on port `587`) is supported. **SMTPS** (encrypted SMTP, usually on port "
"`465`) **is not supported**."
msgstr ""
#: ../../../docs/configuring-playbook-email.md:33
msgid "Configuations for sending emails using Sendgrid"
msgstr ""
#: ../../../docs/configuring-playbook-email.md:35
msgid ""
"An easy and free SMTP service to set up is "
"[Sendgrid](https://sendgrid.com/), the free tier allows for up to 100 "
"emails per day to be sent. In the settings below you can provide any "
"email for `exim_relay_sender_address`."
msgstr ""
#: ../../../docs/configuring-playbook-email.md:37
msgid ""
"The only other thing you need to change is the "
"`exim_relay_relay_auth_password`, which you can generate at "
"https://app.sendgrid.com/settings/api_keys. The API key password looks "
"something like `SG.955oW1mLSfwds7i9Yd6IA5Q.q8GTaB8q9kGDzasegdG6u95fQ-"
"6zkdwrPP8bOeuI`."
msgstr ""
#: ../../../docs/configuring-playbook-email.md:39
msgid ""
"Note that the `exim_relay_relay_auth_username` is literally the string "
"`apikey`, it's always the same for Sendgrid."
msgstr ""
#: ../../../docs/configuring-playbook-email.md:51
msgid "Troubleshooting"
msgstr ""
#: ../../../docs/configuring-playbook-email.md:53
msgid ""
"If you're having trouble with email not being delivered, it may be useful"
" to inspect the mailer logs: `journalctl -f -u matrix-exim-relay`."
msgstr ""

259
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po Normal file
View File

@@ -0,0 +1,259 @@
# 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/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 ""

251
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-etherpad.po Normal file
View File

@@ -0,0 +1,251 @@
# 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/configuring-playbook-etherpad.md:1
msgid "Setting up Etherpad (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:3
msgid ""
"[Etherpad](https://etherpad.org) is an open source collaborative text "
"editor that can be embedded in a Matrix chat room using the [Dimension "
"integration manager](https://dimension.t2bot.io) or used as standalone "
"web app."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:5
msgid ""
"When enabled together with the Jitsi audio/video conferencing system (see"
" [our docs on Jitsi](configuring-playbook-jitsi.md)), it will be made "
"available as an option during the conferences."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:9
msgid ""
"To enable Etherpad, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:19
msgid "Adjusting the Etherpad URL"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:21
msgid ""
"By default, this playbook installs Etherpad on the `etherpad.` subdomain "
"(`etherpad.example.com`) and requires you to [adjust your DNS records"
"](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:23
msgid ""
"By tweaking the `etherpad_hostname` and `etherpad_path_prefix` variables,"
" you can easily make the service available at a **different hostname "
"and/or path** than the default one."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:25
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:36
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:38
msgid ""
"Once you've decided on the domain and path, **you may need to adjust your"
" DNS** records to point the Etherpad domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:40
msgid ""
"By default, you will need to create a CNAME record for `etherpad`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:42
msgid ""
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
" extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:44
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:46
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:53
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:55
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the Etherpad admin user (`etherpad_admin_username`)."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:57
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:59
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-etherpad.md:61
msgid ""
"If you change the Etherpad admin user's password "
"(`etherpad_admin_password` in your `vars.yml` file) subsequently, the "
"admin user's credentials on the homeserver won't be updated "
"automatically. If you'd like to change the admin user's password, use a "
"tool like [synapse-admin](configuring-playbook-synapse-admin.md) to "
"change it, and then update `etherpad_admin_password` to let the admin "
"user know its new password."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:63
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:65
msgid ""
"The Etherpad UI should be available at `https://etherpad.example.com`, "
"while the admin UI (if enabled) should then be available at "
"`https://etherpad.example.com/admin`."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:67
msgid ""
"If you've [decided on another hostname or path-prefix](#adjusting-the-"
"etherpad-url) (e.g. `https://matrix.example.com/etherpad`), adjust these "
"URLs accordingly before usage."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:69
msgid "Managing / Deleting old pads"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:71
msgid ""
"If you want to manage and remove old unused pads from Etherpad, you will "
"first need to able Admin access as described above."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:73
msgid ""
"Then from the plugin manager page "
"(`https://etherpad.example.com/admin/plugins`, install the `adminpads2` "
"plugin. Once installed, you should have a \"Manage pads\" section in the "
"Admin web-UI."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:75
msgid ""
"How to use Etherpad widgets without an integration manager (like "
"Dimension)"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:77
msgid ""
"This is how it works in Element Web, it might work quite similar with "
"other clients:"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:79
msgid ""
"To integrate a standalone Etherpad in a room, create your pad by visiting"
" `https://etherpad.example.com`. When the pad opens, copy the URL and "
"send a command like this to the room: `/addwidget URL`. You will then "
"find your integrated Etherpad within the right sidebar in the `Widgets` "
"section."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:81
msgid "Set Dimension default to the self-hosted Etherpad (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:83
msgid ""
"If you decided to install [Dimension integration manager](configuring-"
"playbook-dimension.md) alongside Etherpad, the Dimension administrator "
"users can configure the default URL template."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:85
msgid ""
"The Dimension configuration menu can be accessed with the sprocket icon "
"as you begin to add a widget to a room in Element Web. There you will "
"find the Etherpad Widget Configuration action beneath the _Widgets_ tab."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:87
msgid "Removing the integrated Etherpad chat"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:89
msgid ""
"If you wish to disable the Etherpad chat button, you can do it by "
"appending `?showChat=false` to the end of the pad URL, or the template."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:91
msgid "Example: `https://etherpad.example.com/p/$roomId_$padName?showChat=false`"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:93
msgid "Known issues"
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:95
msgid ""
"If your Etherpad widget fails to load, this might be due to Dimension "
"generating a Pad name so long, the Etherpad app rejects it."
msgstr ""
#: ../../../docs/configuring-playbook-etherpad.md:97
msgid ""
"`$roomId_$padName` can end up being longer than 50 characters. You can "
"avoid having this problem by altering the template so it only contains "
"the three word random identifier `$padName`."
msgstr ""

77
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-external-postgres.po Normal file
View File

@@ -0,0 +1,77 @@
# Translations template for PROJECT.
# Copyright (C) 2024 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PROJECT VERSION\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\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-Team: LANGUAGE <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-external-postgres.md:1
msgid "Using an external PostgreSQL server (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-external-postgres.md:3
msgid ""
"By default, this playbook would set up a PostgreSQL database server on "
"your machine, running in a Docker container. If that's okay, you can skip"
" this document."
msgstr ""
#: ../../../docs/configuring-playbook-external-postgres.md:5
msgid ""
"**Note**: using **an external Postgres server is currently [not very "
"seamless](https://github.com/spantaleev/matrix-docker-ansible-"
"deploy/issues/1682#issuecomment-1061461683) when it comes to enabling "
"various other playbook services** - you will need to create a new "
"database/credentials for each service and to point each service to its "
"corresponding database using custom `vars.yml` configuration. **For the "
"best experience with the playbook, stick to using the integrated Postgres"
" server**."
msgstr ""
#: ../../../docs/configuring-playbook-external-postgres.md:7
msgid ""
"If you'd like to use an external Postgres server that you manage, add the"
" following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-external-postgres.md:23
msgid ""
"The database (as specified in `matrix_synapse_database_database`) must "
"exist and be accessible with the given credentials. It must be empty or "
"contain a valid Synapse database. If empty, Synapse would populate it the"
" first time it runs."
msgstr ""
#: ../../../docs/configuring-playbook-external-postgres.md:25
msgid ""
"**Note**: the external server that you specify in "
"`matrix_synapse_database_host` must be accessible from within the "
"`matrix-synapse` Docker container (and possibly other containers too). "
"This means that it either needs to be a publicly accessible hostname or "
"that it's a hostname on the same Docker network where all containers "
"installed by this playbook run (a network called `matrix` by default). "
"Using a local PostgreSQL instance on the host (running on the same "
"machine, but not in a container) is not possible."
msgstr ""
#: ../../../docs/configuring-playbook-external-postgres.md:27
msgid ""
"The connection to your external Postgres server **will not be SSL "
"encrypted**, as [we don't support that yet](https://github.com/spantaleev"
"/matrix-docker-ansible-deploy/issues/89)."
msgstr ""

139
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-federation.po Normal file
View File

@@ -0,0 +1,139 @@
# 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/configuring-playbook-federation.md:1
msgid "Controlling Matrix federation (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:3
msgid ""
"By default, your server federates with the whole Matrix network. That is,"
" people on your server can communicate with people on any other Matrix "
"server."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:5
msgid ""
"**Note**: in the sample `vars.yml` "
"([`examples/vars.yml`](../examples/vars.yml)), we recommend to use a "
"short user ID like `@alice:example.com` instead of "
"`@alice:matrix.example.com` and set up [server delegation](howto-server-"
"delegation.md) / redirection. Without a proper configuration, your server"
" will effectively not be part of the Matrix network. If you find your "
"server is not federated, make sure to [check whether services work"
"](maintenance-checking-services.md) and your server is properly "
"delegated."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:7
msgid "Federating only with select servers"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:9
msgid ""
"To make your server only federate with servers of your choosing, add the "
"following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:17
msgid ""
"If you wish to disable federation, you can do that with an empty list "
"(`[]`), or better yet by completely disabling federation (see below)."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:19
msgid "Exposing the room directory over federation"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:21
msgid ""
"By default, your server's public rooms directory is not exposed to other "
"servers via federation."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:23
msgid ""
"If you wish to expose it, add this to your configuration file "
"(`inventory/host_vars/matrix.example.com/vars.yml`):"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:29
msgid "Disabling federation"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:31
msgid ""
"To completely disable federation, isolating your server from the rest of "
"the Matrix network, add this to your configuration file "
"(`inventory/host_vars/matrix.example.com/vars.yml`):"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:37
msgid ""
"With that, your server's users will only be able to talk among "
"themselves, but not to anyone who is on another server."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:39
msgid ""
"**Disabling federation does not necessarily disable the federation port**"
" (`8448`). Services like [Dimension](configuring-playbook-dimension.md) "
"and [ma1sd](configuring-playbook-ma1sd.md) normally rely on `openid` APIs"
" exposed on that port. Even if you disable federation and only if "
"necessary, we may still be exposing the federation port and serving the "
"`openid` APIs there. To override this and completely disable Synapse's "
"federation port use:"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:51
msgid ""
"Changing the federation port from 8448 to a different port to use a CDN "
"that only accepts 443/80 ports"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:53
msgid ""
"Why? This change could be useful for people running small Synapse "
"instances on small severs/VPSes to avoid being impacted by a simple "
"DOS/DDOS when bandwidth, RAM, an CPU resources are limited and if your "
"hosting provider does not provide a DOS/DDOS protection."
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:55
msgid ""
"The following changes in the configuration file "
"(`inventory/host_vars/matrix.example.com/vars.yml`) will allow this and "
"make it possible to proxy the federation through a CDN such as CloudFlare"
" or any other:"
msgstr ""
#: ../../../docs/configuring-playbook-federation.md:66
msgid ""
"**Use this at you own risk as all the possible side-effects of doing this"
" are not fully known. However, it has been tested and works fine and "
"passes all the tests on <https://federationtester.matrix.org/> without "
"issues.**"
msgstr ""

557
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-jitsi.po Normal file
View File

@@ -0,0 +1,557 @@
# 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/configuring-playbook-jitsi.md:1
msgid "Setting up the Jitsi video-conferencing platform (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:3
msgid ""
"The playbook can install the [Jitsi](https://jitsi.org/) video-"
"conferencing platform and integrate it with Element clients ([Element Web"
"](configuring-playbook-client-element-web.md)/Desktop, Android and iOS)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:5
msgid ""
"Jitsi installation is **not enabled by default**, because it's not a core"
" component of Matrix services."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:7
msgid ""
"The setup done by the playbook is very similar to [docker-jitsi-"
"meet](https://github.com/jitsi/docker-jitsi-meet). You can refer to the "
"documentation there for many of the options here."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:9
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:11
msgid "You may need to open the following ports to your server:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:13
msgid "`4443/tcp` - RTP media fallback over TCP"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:14
msgid ""
"`10000/udp` - RTP media over UDP. Depending on your firewall/NAT setup, "
"incoming RTP packets on port `10000` may have the external IP of your "
"firewall as destination address, due to the usage of STUN in JVB (see "
"[`jitsi_jvb_stun_servers`](https://github.com/mother-of-all-self-hosting"
"/ansible-role-jitsi/blob/main/defaults/main.yml))."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:16
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:18
msgid ""
"To enable Jitsi, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:24
msgid "Adjusting the Jitsi URL"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:26
msgid ""
"By default, this playbook installs Jitsi on the `jitsi.` subdomain "
"(`jitsi.example.com`) and requires you to [adjust your DNS records"
"](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:28
msgid ""
"By tweaking the `jitsi_hostname` variable, you can easily make the "
"service available at a **different hostname** than the default one."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:30
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:37
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:39
msgid ""
"Once you've decided on the domain and path, **you may need to adjust your"
" DNS** records to point the Jitsi domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:41
msgid ""
"By default, you will need to create a CNAME record for `jitsi`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:43
msgid "(Optional) Configure Jitsi authentication and guests mode"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:45
msgid ""
"By default the Jitsi Meet instance does not require any kind of login and"
" is open to use for anyone without registration."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:47
msgid ""
"If you're fine with such an open Jitsi instance, please skip to "
"[Installing](#installing)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:49
msgid ""
"If you would like to control who is allowed to open meetings on your new "
"Jitsi instance, then please follow the following steps to enable Jitsi's "
"authentication and optionally guests mode."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:51
msgid ""
"Currently, there are three supported authentication modes: 'internal' "
"(default), 'matrix' and 'ldap'."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:53
msgid ""
"**Note**: Authentication is not tested via the playbook's self-checks. We"
" therefore recommend that you manually verify if authentication is "
"required by jitsi. For this, try to manually create a conference on "
"jitsi.example.com in your browser."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:55
msgid "Authenticate using Jitsi accounts (Auth-Type 'internal')"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:57
msgid ""
"The default authentication mechanism is 'internal' auth, which requires "
"jitsi-accounts to be setup and is the recommended setup, as it also works"
" in federated rooms. With authentication enabled, all meeting rooms have "
"to be opened by a registered user, after which guests are free to join. "
"If a registered host is not yet present, guests are put on hold in "
"individual waiting rooms."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:59
msgid ""
"Add these lines to your `inventory/host_vars/matrix.example.com/vars.yml`"
" configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:71
msgid ""
"**Caution**: Accounts added here and subsequently removed will not be "
"automatically removed from the Prosody server until user account cleaning"
" is integrated into the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:73
msgid ""
"**If you get an error** like this: \"Error: Account creation/modification"
" not supported.\", it's likely that you had previously installed Jitsi "
"without auth/guest support. In such a case, you should look into "
"[Rebuilding your Jitsi installation](#rebuilding-your-jitsi-"
"installation)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:75
msgid "Authenticate using Matrix OpenID (Auth-Type 'matrix')"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:77
msgid ""
"**Attention: Probably breaks Jitsi in federated rooms and does not allow "
"sharing conference links with guests.**"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:79
msgid ""
"Using this authentication type require a [Matrix User Verification "
"Service](https://github.com/matrix-org/matrix-user-verification-service)."
" By default, this playbook creates and configures a user-verification-"
"service to run locally, see [configuring-user-verification-service"
"](configuring-playbook-user-verification-service.md)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:81
msgid "To enable set this configuration at host level:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:89
msgid ""
"For more information see also [https://github.com/matrix-org/prosody-mod-"
"auth-matrix-user-verification](https://github.com/matrix-org/prosody-mod-"
"auth-matrix-user-verification)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:91
msgid "Authenticate using LDAP (Auth-Type 'ldap')"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:93
msgid "An example LDAP configuration could be:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:113
msgid ""
"For more information refer to the [docker-jitsi-"
"meet](https://github.com/jitsi/docker-jitsi-meet#authentication-using-"
"ldap) and the [saslauthd `LDAP_SASLAUTHD`](https://github.com/winlibs"
"/cyrus-sasl/blob/master/saslauthd/LDAP_SASLAUTHD) documentation."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:115
msgid "(Optional) Making your Jitsi server work on a LAN"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:117
msgid ""
"By default the Jitsi Meet instance does not work with a client in LAN "
"(Local Area Network), even if others are connected from WAN. There are no"
" video and audio. In the case of WAN to WAN everything is ok."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:119
msgid ""
"The reason is the Jitsi VideoBridge git to LAN client the IP address of "
"the docker image instead of the host. The "
"[documentation](https://jitsi.github.io/handbook/docs/devops-guide"
"/devops-guide-docker/#running-behind-nat-or-on-a-lan-environment) of "
"Jitsi in docker suggest to add `JVB_ADVERTISE_IPS` in enviornment "
"variable to make it work."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:121
msgid "Here is how to do it in the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:123
msgid ""
"Add these two lines to your "
"`inventory/host_vars/matrix.example.com/vars.yml` configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:130
msgid "(Optional) Fine tune Jitsi"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:132
msgid ""
"Sample **additional** `inventory/host_vars/matrix.example.com/vars.yml` "
"configuration to save up resources (explained below):"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:147
msgid ""
"You may want to **suspend unused video layers** until they are requested "
"again, to save up resources on both server and clients. Read more on this"
" feature [here](https://jitsi.org/blog/new-off-stage-layer-suppression-"
"feature/)"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:149
msgid ""
"You may wish to **disable audio levels** to avoid excessive refresh of "
"the client-side page and decrease the CPU consumption involved."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:151
msgid ""
"You may want to **limit the number of video feeds forwarded to each "
"client**, to save up resources on both server and clients. As clients’ "
"bandwidth and CPU may not bear the load, use this setting to avoid lag "
"and crashes. This feature is found by default in other webconference "
"applications such as Office 365 Teams (limit is set to 4). Read how it "
"works [here](https://github.com/jitsi/jitsi-"
"videobridge/blob/master/doc/last-n.md) and performance evaluation on this"
" [study](https://jitsi.org/wp-"
"content/uploads/2016/12/nossdav2015lastn.pdf)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:153
msgid ""
"You may want to **limit the maximum video resolution**, to save up "
"resources on both server and clients."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:155
msgid "(Optional) Specify a Max number of participants on a Jitsi conference"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:157
msgid ""
"The playbook allows a user to set a max number of participants allowed to"
" join a Jitsi conference. By default there is no limit."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:159
msgid ""
"In order to set the max number of participants use the following "
"**additional** configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:165
msgid "(Optional) Additional JVBs"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:167
msgid ""
"By default, a single JVB ([Jitsi VideoBridge](https://github.com/jitsi"
"/jitsi-videobridge)) is deployed on the same host as the Matrix server. "
"To allow more video-conferences to happen at the same time, you may need "
"to provision additional JVB services on other hosts."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:169
msgid ""
"There is an ansible playbook that can be run with the following tag: "
"`ansible-playbook -i inventory/hosts --limit jitsi_jvb_servers "
"jitsi_jvb.yml --tags=common,setup-additional-jitsi-jvb,start`"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:171
msgid ""
"For this role to work you will need an additional section in the ansible "
"hosts file with the details of the JVB hosts, for example:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:178
msgid ""
"Each JVB will require a server ID to be set so that it can be uniquely "
"identified and this allows Jitsi to keep track of which conferences are "
"on which JVB. The server ID is set with the variable "
"`jitsi_jvb_server_id` which ends up as the JVB_WS_SERVER_ID environment "
"variables in the JVB docker container. This variable can be set via the "
"host file, a parameter to the ansible command or in the `vars.yaml` for "
"the host which will have the additional JVB. For example:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:190
msgid ""
"Note that the server ID `jvb-1` is reserved for the JVB instance running "
"on the Matrix host and therefore should not be used as the ID of an "
"additional jvb host."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:192
msgid ""
"The additional JVB will also need to expose the colibri web socket port "
"and this can be done with the following variable:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:198
msgid ""
"The JVB will also need to know where the prosody xmpp server is located, "
"similar to the server ID this can be set in the vars for the JVB by using"
" the variable `jitsi_xmpp_server`. The Jitsi prosody container is "
"deployed on the Matrix server by default so the value can be set to the "
"Matrix domain. For example:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:204
msgid ""
"However, it can also be set the ip address of the Matrix server. This can"
" be useful if you wish to use a private ip. For example:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:210
msgid ""
"For the JVB to be able to contact the XMPP server, the latter must expose"
" the XMPP port (5222). By default, the Matrix server does not expose the "
"port; only the XMPP container exposes it internally inside the host, "
"which means that the first JVB (which runs on the Matrix server) can "
"reach it but the additional JVB cannot. The port is exposed by setting "
"`jitsi_prosody_container_jvb_host_bind_port` like this:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:216
msgid "(The default is empty; if it's set then docker forwards the port.)"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:218
msgid ""
"Applied together this will allow you to provision extra JVB instances "
"which will register themselves with the prosody service and be available "
"for jicofo to route conferences too."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:220
msgid ""
"To make Traefik reverse-proxy to these additional JVBs (living on other "
"hosts), **you would need to add the following Traefik configuration "
"extension**:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:256
msgid "(Optional) Enable Gravatar"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:258
msgid ""
"In the default Jisti Meet configuration, gravatar.com is enabled as an "
"avatar service. This results in third party request leaking data to "
"gravatar. Since Element clients already send the url of configured Matrix"
" avatars to Jitsi, we disabled gravatar."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:260
msgid "To enable Gravatar set:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:266
msgid ""
"**Beware**: This leaks information to a third party, namely the Gravatar-"
"Service (unless configured otherwise: gravatar.com). Besides metadata, "
"this includes the Matrix user_id and possibly the room identifier (via "
"`referrer` header)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:268
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:270
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:277
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:279
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:281
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:283
msgid "You can use the self-hosted Jitsi server in multiple ways:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:285
msgid ""
"**by adding a widget to a room via Element Web** (the one configured by "
"the playbook at `https://element.example.com`). Just start a voice or a "
"video call in a room containing more than 2 members and that would create"
" a Jitsi widget which utilizes your self-hosted Jitsi server."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:287
msgid ""
"**by adding a widget to a room via the Dimension integration manager**. "
"You'll have to point the widget to your own Jitsi server manually. See "
"our [Dimension integration manager](./configuring-playbook-dimension.md) "
"documentation page for more details. Naturally, Dimension would need to "
"be installed first (the playbook doesn't install it by default)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:289
msgid ""
"**directly (without any Matrix integration)**. Just go to "
"`https://jitsi.example.com`"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:291
msgid ""
"**Note**: Element apps on mobile devices currently [don't support joining"
" meetings on a self-hosted Jitsi server](https://github.com/element-hq"
"/riot-web/blob/601816862f7d84ac47547891bd53effa73d32957/docs/jitsi.md"
"#mobile-app-support)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:293
msgid "Troubleshooting"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:295
msgid "Rebuilding your Jitsi installation"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:297
msgid ""
"**If you ever run into any trouble** or **if you change configuration "
"(`jitsi_*` variables) too much**, we urge you to rebuild your Jitsi "
"setup."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:299
msgid ""
"We normally don't require such manual intervention for other services, "
"but Jitsi services generate a lot of configuration files on their own."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:301
msgid ""
"These files are not all managed by Ansible (at least not yet), so you may"
" sometimes need to delete them all and start fresh."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:303
msgid "To rebuild your Jitsi configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:305
msgid ""
"ask Ansible to stop all Jitsi services: `just run-tags stop-group "
"--extra-vars=group=jitsi`"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:306
msgid ""
"SSH into the server and do this and remove all Jitsi configuration & data"
" (`rm -rf /matrix/jitsi`)"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:307
msgid ""
"ask Ansible to set up Jitsi anew and restart services (`just install-"
"service jitsi`)"
msgstr ""

84
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po Normal file
View File

@@ -0,0 +1,84 @@
# 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/configuring-playbook-ldap-auth.md:1
msgid ""
"Setting up the LDAP authentication password provider module (optional, "
"advanced)"
msgstr ""
#: ../../../docs/configuring-playbook-ldap-auth.md:3
msgid ""
"The playbook can install and configure the [matrix-synapse-"
"ldap3](https://github.com/matrix-org/matrix-synapse-ldap3) LDAP Auth "
"password provider for you."
msgstr ""
#: ../../../docs/configuring-playbook-ldap-auth.md:5
msgid ""
"See that project's documentation to learn what it does and why it might "
"be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-ldap-auth.md:7
msgid ""
"If you decide that you'd like to let this playbook install it for you, "
"add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-ldap-auth.md:24
msgid "Authenticating only using a password provider"
msgstr ""
#: ../../../docs/configuring-playbook-ldap-auth.md:26
msgid ""
"If you wish for users to **authenticate only against configured password "
"providers** (like this one), **without consulting Synapse's local "
"database**, feel free to disable it:"
msgstr ""
#: ../../../docs/configuring-playbook-ldap-auth.md:32
msgid "Using ma1sd Identity Server for authentication"
msgstr ""
#: ../../../docs/configuring-playbook-ldap-auth.md:34
msgid ""
"If you wish to use the ma1sd Identity Server for LDAP authentication "
"instead of [matrix-synapse-ldap3](https://github.com/matrix-org/matrix-"
"synapse-ldap3) consult [Adjusting ma1sd Identity Server configuration"
"](configuring-playbook-ma1sd.md#authentication)."
msgstr ""
#: ../../../docs/configuring-playbook-ldap-auth.md:36
msgid "Handling user registration"
msgstr ""
#: ../../../docs/configuring-playbook-ldap-auth.md:38
msgid ""
"If you wish for users to also be able to make new registrations against "
"LDAP, you may **also** wish to [set up the ldap-registration-proxy"
"](configuring-playbook-matrix-ldap-registration-proxy.md)."
msgstr ""

335
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ma1sd.po Normal file
View File

@@ -0,0 +1,335 @@
# 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/configuring-playbook-ma1sd.md:1
msgid "Setting up ma1sd Identity Server (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:3
msgid ""
"**⚠️Note**: ma1sd itself has also been unmaintained for years (the latest"
" commit and release being from 2021). The role of identity servers in the"
" Matrix specification also has an uncertain future. **We recommend not "
"bothering with installing it unless it's the only way you can do what you"
" need to do**. For example, certain things like LDAP integration can also"
" be implemented via [the LDAP provider module for Synapse](./configuring-"
"playbook-ldap-auth.md)."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:5
msgid ""
"The playbook can configure the [ma1sd](https://github.com/ma1uta/ma1sd) "
"Identity Server for you. It is a fork of [mxisd](https://github.com"
"/kamax-io/mxisd) which was pronounced end of life 2019-06-21."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:7
msgid ""
"ma1sd is used for 3PIDs (3rd party identifiers like E-mail and phone "
"numbers) and some [enhanced "
"features](https://github.com/ma1uta/ma1sd/#features). It is private by "
"default, potentially at the expense of user discoverability."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:9
msgid ""
"See the project's [documentation](https://github.com/ma1uta/ma1sd) to "
"learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:11
msgid ""
"**Note**: enabling ma1sd, means that the `openid` API endpoints will be "
"exposed on the Matrix Federation port (usually `8448`), even if "
"[federation](configuring-playbook-federation.md) is disabled. It's "
"something to be aware of, especially in terms of firewall whitelisting "
"(make sure port `8448` is accessible)."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:13
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:15
msgid ""
"To make the ma1sd Identity Server enable its federation features, set up "
"a SRV record that looks like this:"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:17
msgid "Name: `_matrix-identity._tcp` (use this text as-is)"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:18
msgid ""
"Content: `10 0 443 matrix.example.com` (replace `example.com` with your "
"own)"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:20
msgid ""
"See [ma1sd's documentation](https://github.com/ma1uta/ma1sd/wiki/mxisd-"
"and-your-privacy#choices-are-never-easy) for information on the privacy "
"implications of setting up this SRV record."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:22
msgid ""
"**Note**: This `_matrix-identity._tcp` SRV record for the identity server"
" is different from the `_matrix._tcp` that can be used for Synapse "
"delegation. See [howto-server-delegation.md](howto-server-delegation.md) "
"for more information about delegation."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:24
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:26
msgid ""
"To enable ma1sd, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:32
msgid "Matrix.org lookup forwarding"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:34
msgid ""
"To ensure maximum discovery, you can make your identity server also "
"forward lookups to the central matrix.org Identity server (at the cost of"
" potentially leaking all your contacts information)."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:36
msgid ""
"Enabling this is discouraged and you'd better [learn "
"more](https://github.com/ma1uta/ma1sd/blob/master/docs/features/identity.md#lookups)"
" before proceeding."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:38
msgid ""
"To enable matrix.org forwarding, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:44
msgid "Additional features"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:46
msgid ""
"What this playbook configures for your is some bare minimum Identity "
"Server functionality, so that you won't need to rely on external 3rd "
"party services."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:48
msgid ""
"A few variables can be toggled in this playbook to alter the ma1sd "
"configuration that gets generated."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:50
msgid ""
"Still, ma1sd can do much more. You can refer to the [ma1sd "
"website](https://github.com/ma1uta/ma1sd) for more details and "
"configuration options."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:52
msgid ""
"To use a more custom configuration, you can define a "
"`matrix_ma1sd_configuration_extension_yaml` string variable and put your "
"configuration in it. To learn more about how to do this, refer to the "
"information about `matrix_ma1sd_configuration_extension_yaml` in the "
"[default variables file](../roles/custom/matrix-ma1sd/defaults/main.yml) "
"of the ma1sd component."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:54
msgid "Customizing email templates"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:56
msgid ""
"If you'd like to change the default email templates used by ma1sd, take a"
" look at the `matrix_ma1sd_threepid_medium_email_custom_` variables (in "
"the `roles/custom/matrix-ma1sd/defaults/main.yml` file."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:58
msgid "ma1sd-controlled Registration"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:60
msgid ""
"To use the "
"[Registration](https://github.com/ma1uta/ma1sd/blob/master/docs/features/registration.md)"
" feature of ma1sd, you can make use of the following variables:"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:62
msgid ""
"`matrix_synapse_enable_registration` - to enable user-initiated "
"registration in Synapse"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:64
msgid ""
"`matrix_synapse_enable_registration_captcha` - to validate registering "
"users using reCAPTCHA, as described in the [enabling reCAPTCHA"
"](configuring-captcha.md) documentation."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:66
msgid ""
"`matrix_synapse_registrations_require_3pid` - a list of 3pid types (among"
" `'email'`, `'msisdn'`) required by the Synapse server for registering"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:68
msgid ""
"variables prefixed with `matrix_ma1sd_container_labels_` (e.g. "
"`matrix_ma1sd_container_labels_matrix_client_3pid_registration_enabled`) "
"- to configure the Traefik reverse-proxy to capture and send registration"
" requests to ma1sd (instead of Synapse), so it can apply its additional "
"functionality"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:70
msgid ""
"`matrix_ma1sd_configuration_extension_yaml` - to configure ma1sd as "
"required. See the [Registration feature's "
"docs](https://github.com/ma1uta/ma1sd/blob/master/docs/features/registration.md)"
" for inspiration. Also see the [Additional features](#additional-"
"features) section below to learn more about how to use "
"`matrix_ma1sd_configuration_extension_yaml`."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:72
msgid ""
"**Note**: For this to work, either the homeserver needs to [federate"
"](configuring-playbook-federation.md) or the `openid` APIs need to "
"exposed on the federation port. When federation is disabled and ma1sd is "
"enabled, we automatically expose the `openid` APIs (only!) on the "
"federation port. Make sure the federation port (usually "
"`https://matrix.example.com:8448`) is whitelisted in your firewall (even "
"if you don't actually use/need federation)."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:74
msgid "Authentication"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:76
msgid ""
"[Authentication](https://github.com/ma1uta/ma1sd/blob/master/docs/features/authentication.md)"
" provides the possibility to use your own [Identity "
"Stores](https://github.com/ma1uta/ma1sd/blob/master/docs/stores/README.md)"
" (for example LDAP) to authenticate users on your Homeserver."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:78
msgid ""
"To enable authentication against an LDAP server, add the following "
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:98
msgid "Example: SMS verification"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:100
msgid ""
"If your use case requires mobile verification, it is quite simple to "
"integrate ma1sd with [Twilio](https://www.twilio.com/), an online "
"telephony services gateway. Their prices are reasonable for low-volume "
"projects and integration can be done with the following configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:114
msgid "Example: Open Registration for every Domain"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:116
msgid ""
"If you want to open registration for any domain, you have to setup the "
"allowed domains with ma1sd's `blacklist` and `whitelist`. The default "
"behavior when neither the `blacklist`, nor the `whitelist` match, is to "
"allow registration. Beware: you can't block toplevel domains (aka `.xy`) "
"because the internal architecture of ma1sd doesn't allow that."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:130
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:132
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:139
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:141
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:143
msgid "Troubleshooting"
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:145
msgid ""
"If email address validation emails sent by ma1sd are not reaching you, "
"you should look into [Adjusting email-sending settings](configuring-"
"playbook-email.md)."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:147
msgid ""
"If you'd like additional logging information, temporarily enable verbose "
"logging for ma1sd."
msgstr ""
#: ../../../docs/configuring-playbook-ma1sd.md:149
msgid ""
"To enable it, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""

1045
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-authentication-service.po Normal file
View File

File diff suppressed because it is too large Load Diff

185
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po Normal file
View File

@@ -0,0 +1,185 @@
# 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/configuring-playbook-matrix-corporal.md:1
msgid "Setting up Matrix Corporal (optional, advanced)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:5
msgid ""
"**WARNING**: This is an advanced feature! It requires prior experience "
"with Matrix and a specific need for using [Matrix "
"Corporal](https://github.com/devture/matrix-corporal). If you're unsure "
"whether you have such a need, you most likely don't."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:9
msgid ""
"The playbook can install and configure [matrix-"
"corporal](https://github.com/devture/matrix-corporal) for you."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:11
msgid ""
"In short, it's a sort of automation and firewalling service, which is "
"helpful if you're instaling Matrix services in a controlled corporate "
"environment. See that project's documentation to learn what it does and "
"why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:13
msgid ""
"If you decide that you'd like to let this playbook install it for you, "
"you'd need to also:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:14
msgid ""
"(required) [set up the Shared Secret Auth password provider module"
"](configuring-playbook-shared-secret-auth.md)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:15
msgid ""
"(optional, but encouraged) [set up the REST authentication password "
"provider module](configuring-playbook-rest-auth.md)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:17
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:19
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:72
msgid ""
"Matrix Corporal operates with a specific Matrix user on your server. By "
"default, it's `matrix-corporal` (controllable by the "
"`matrix_corporal_reconciliation_user_id_local_part` setting, see above)."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:74
msgid ""
"No matter what Matrix user ID you configure to run it with, make sure "
"that:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:76
msgid ""
"the Matrix Corporal user is created by [registering it](registering-"
"users.md) **with administrator privileges**. Use a password you remember,"
" as you'll need to log in from time to time to create or join rooms"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:78
msgid ""
"the Matrix Corporal user is joined and has Admin/Moderator-level access "
"to any rooms you want it to manage"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:80
msgid "Using a locally-stored static policy"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:82
msgid ""
"If you'd like to use a [static policy file](https://github.com/devture"
"/matrix-corporal/blob/master/docs/policy-providers.md#static-file-pull-"
"style-policy-provider), you can use a configuration like this:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:114
msgid ""
"To learn more about what the policy configuration, see the matrix-"
"corporal documentation on [policy](https://github.com/devture/matrix-"
"corporal/blob/master/docs/policy.md)."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:116
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:118
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:125
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just run-tags setup-aux-files,setup-corporal,start` or `just "
"setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:127
msgid ""
"`just run-tags setup-aux-files,setup-corporal,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-matrix-corporal.md:129
msgid "Matrix Corporal files"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:131
msgid ""
"The following local filesystem paths are mounted in the `matrix-corporal`"
" container and can be used in your configuration (or policy):"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:133
msgid "`/matrix/corporal/config` is mounted at `/etc/matrix-corporal` (read-only)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:135
msgid ""
"`/matrix/corporal/var` is mounted at `/var/matrix-corporal` (read and "
"write)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:137
msgid ""
"`/matrix/corporal/cache` is mounted at `/var/cache/matrix-corporal` (read"
" and write)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-corporal.md:139
msgid ""
"As an example: you can create your own configuration files in "
"`/matrix/corporal/config` and they will appear in `/etc/matrix-corporal` "
"in the Docker container. Your configuration (stuff in "
"`matrix_corporal_policy_provider_config`) needs to refer to these files "
"via the local container paths - `/etc/matrix-corporal` (read-only), `/var"
"/matrix-corporal` (read and write), `/var/cache/matrix-corporal` (read "
"and write)."
msgstr ""

90
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-ldap-registration-proxy.po Normal file
View File

@@ -0,0 +1,90 @@
# 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/configuring-playbook-matrix-ldap-registration-proxy.md:1
msgid "Setting up matrix-ldap-registration-proxy (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:3
msgid ""
"The playbook can install and configure [matrix-ldap-registration-"
"proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy)"
" for you."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:5
msgid "This proxy handles Matrix registration requests and forwards them to LDAP."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:7
msgid ""
"**Note**: This does support the full Matrix specification for "
"registrations. It only provide a very coarse implementation of a basic "
"password registration."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:9
msgid "Quickstart"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:11
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:22
msgid ""
"If you already use the [synapse external password provider via LDAP"
"](configuring-playbook-ldap-auth.md) (that is, you have "
"`matrix_synapse_ext_password_provider_ldap_enabled: true` and other "
"options in your configuration) you can use the following values as "
"configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:35
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:37
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:44
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-ldap-registration-proxy.md:46
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

257
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-media-repo.po Normal file
View File

@@ -0,0 +1,257 @@
# 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/configuring-playbook-matrix-media-repo.md:1
msgid "Storing Matrix media files using matrix-media-repo (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:3
msgid ""
"[matrix-media-repo](https://docs.t2bot.io/matrix-media-repo/) (often "
"abbreviated \"MMR\") is a highly customizable multi-domain media "
"repository for Matrix. Intended for medium to large environments "
"consisting of several homeservers, this media repo de-duplicates media "
"(including remote media) while being fully compliant with the "
"specification."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:5
msgid ""
"Smaller/individual homeservers can still make use of this project's "
"features, though it may be difficult to set up or have higher than "
"expected resource consumption. Please do your research before deploying "
"this as this project may not be useful for your environment."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:7
msgid ""
"For a simpler alternative (which allows you to offload your media "
"repository storage to S3, etc.), you can [configure S3 storage"
"](configuring-playbook-s3.md) instead of setting up matrix-media-repo."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md
msgid "**Table of Contents**"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md
msgid "[Quickstart](#quickstart)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md
msgid "[Additional configuration options](#configuring-the-media-repo)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md
msgid ""
"[Importing data from an existing media store](#importing-data-from-an-"
"existing-media-store)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:15
msgid "Quickstart"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:17
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file and [re-run the "
"installation process](./installing.md) for the playbook:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:26
msgid ""
"The repo is pre-configured for integrating with the Postgres database, "
"Traefik proxy and [Prometheus/Grafana](configuring-playbook-prometheus-"
"grafana.md) (if metrics enabled) from this playbook for all the available"
" homeserver roles. When the media repo is enabled, other media store "
"roles should be disabled (if using Synapse with other media store roles)."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:28
msgid ""
"By default, the media-repo will use the local filesystem for data "
"storage. You can alternatively use a `s3` cloud backend as well. Access "
"token caching is also enabled by default since the logout endpoints are "
"proxied through the media repo."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:30
msgid "Configuring the media-repo"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:32
msgid "Additional common configuration options:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:91
msgid ""
"Full list of configuration options with documentation can be found in "
"[`roles/custom/matrix-media-"
"repo/defaults/main.yml`](https://github.com/spantaleev/matrix-docker-"
"ansible-deploy/blob/master/roles/custom/matrix-media-"
"repo/defaults/main.yml)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:93
msgid "Signing Keys"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:95
msgid ""
"Authenticated media endpoints ([MSC3916](https://github.com/matrix-org"
"/matrix-spec-proposals/pull/3916)) requires MMR to have a configured "
"signing key to authorize outbound federation requests. Additionally, the "
"signing key must be merged with your homeserver's signing key file."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:97
msgid ""
"The playbook default is to generate a MMR signing key when invoking the "
"setup role and merge it with your homeserver if you are using Synapse or "
"Dendrite. This can be disabled if desired by setting the option in your "
"inventory:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:103
msgid ""
"If you wish to manually generate the signing key and merge it with your "
"homeserver's signing key file, see https://docs.t2bot.io/matrix-media-"
"repo/v1.3.5/installation/signing-key/ for more details."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:105
msgid ""
"**Note that if you uninstall MMR from the playbook, it will not remove "
"the old MMR signing key from your homeserver's signing key file. You will"
" have to remove it manually.**"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:107
msgid "Key backup and revoking"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:109
msgid ""
"Since your homeserver signing key file is modified by the playbook, a "
"backup will be created in "
"`HOMESERVER_DIR/config/example.com.signing.key.backup`. If you need to "
"remove/revoke old keys, you can restore from this backup or remove the "
"MMR key ID from your `example.com.signing.key` file."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:111
msgid ""
"Additionally, its recommended after revoking a signing key to update your"
" homeserver config file (`old_signing_keys` field for Synapse and "
"`old_private_keys` for Dendrite). See your homeserver config file for "
"further documentation on how to populate the field."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:113
msgid "Importing data from an existing media store"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:115
msgid ""
"If you want to add this repo to an existing homeserver managed by the "
"playbook, you will need to import existing media into MMR's database or "
"you will lose access to older media while it is active. MMR versions up "
"to `v1.3.3` only support importing from Synapse, but newer versions (at "
"time of writing: only `latest`) also support importing from Dendrite."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:117
msgid ""
"**Before importing**: ensure you have an initial matrix-media-repo "
"deployment by following the [quickstart](#quickstart) guide above"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:119
msgid ""
"Depending on the homeserver implementation yu're using (Synapse, "
"Dendrite), you'll need to use a different import tool (part of matrix-"
"media-repo) and point it to the homeserver's database."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:121
msgid "Importing data from the Synapse media store"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:123
msgid ""
"To import the Synapse media store, you're supposed to invoke the "
"`import_synapse` tool which is part of the matrix-media-repo container "
"image. Your Synapse database is called `synapse` by default, unless "
"you've changed it by modifying `matrix_synapse_database_database`."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:125
msgid ""
"This guide here is adapted from the [upstream documentation about the "
"import_synapse script](https://github.com/turt2live/matrix-media-repo"
"#importing-media-from-synapse)."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:127
#: ../../../docs/configuring-playbook-matrix-media-repo.md:149
msgid ""
"Run the following command on the server (after replacing "
"`postgres_connection_password` in it with the value found in your "
"`vars.yml` file):"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:139
#: ../../../docs/configuring-playbook-matrix-media-repo.md:161
msgid ""
"Enter `1` for the Machine ID when prompted (you are not doing any "
"horizontal scaling) unless you know what you're doing."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:141
#: ../../../docs/configuring-playbook-matrix-media-repo.md:163
msgid ""
"This should output a `msg=\"Import completed\"` when finished "
"successfully!"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:143
msgid "Importing data from the Dendrite media store"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:145
msgid ""
"If you're using the [Dendrite](configuring-playbook-dendrite.md) "
"homeserver instead of the default for this playbook (Synapse), follow "
"this importing guide here."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-media-repo.md:147
msgid ""
"To import the Dendrite media store, you're supposed to invoke the "
"`import_dendrite` tool which is part of the matrix-media-repo container "
"image. Your Dendrite database is called `dendrite_mediaapi` by default, "
"unless you've changed it by modifying "
"`matrix_dendrite_media_api_database`."
msgstr ""

219
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-registration.po Normal file
View File

@@ -0,0 +1,219 @@
# 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/configuring-playbook-matrix-registration.md:1
msgid "Setting up matrix-registration (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:3
msgid ""
"The playbook can install and configure [matrix-"
"registration](https://github.com/ZerataX/matrix-registration) for you."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:5
msgid ""
"**WARNING**: this is a poorly maintained and buggy project. It's better "
"to avoid using it."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:7
msgid ""
"**WARNING**: this is not related to [matrix-registration-bot"
"](configuring-playbook-bot-matrix-registration-bot.md)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:9
msgid ""
"matrix-registration is a simple python application to have a token based "
"Matrix registration."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:11
msgid ""
"Use matrix-registration to **create unique registration links**, which "
"people can use to register on your Matrix server. It allows you to **keep"
" your server's registration closed (private)**, but still allow certain "
"people (these having a special link) to register a user account."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:13
msgid "**matrix-registration** provides 2 things:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:15
msgid ""
"**an API for creating registration tokens** (unique registration links). "
"This API can be used via `curl` or via the playbook (see [Usage](#usage) "
"below)"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:17
msgid ""
"**a user registration page**, where people can use these registration "
"tokens. By default, exposed at `https://matrix.example.com/matrix-"
"registration`"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:19
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:21
msgid ""
"To enable matrix-registration, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:30
msgid "Adjusting the matrix-registration URL"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:32
msgid ""
"By default, this playbook installs the matrix-registration on the "
"`matrix.` subdomain, at the `/matrix-registration` path "
"(https://matrix.example.com/matrix-registration). This makes it easy to "
"install it, because it **doesn't require additional DNS records to be set"
" up**. If that's okay, you can skip this section."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:34
msgid ""
"By tweaking the `matrix_registration_hostname` and "
"`matrix_registration_path_prefix` variables, you can easily make the "
"service available at a **different hostname and/or path** than the "
"default one."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:36
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:44
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:46
msgid ""
"If you've changed the default hostname, **you may need to adjust your "
"DNS** records to point the matrix-registration domain to the Matrix "
"server."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:48
msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:50
msgid ""
"If you've decided to use the default hostname, you won't need to do any "
"extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:52
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:54
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:61
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:63
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:65
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:67
msgid ""
"**matrix-registration** gets exposed at `https://matrix.example.com"
"/matrix-registration`"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:69
msgid ""
"It provides various [APIs](https://github.com/ZerataX/matrix-"
"registration/wiki/api) - for creating registration tokens, listing "
"tokens, disabling tokens, etc. To make use of all of its capabilities, "
"consider using `curl`."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:71
msgid "We make the most common APIs easy to use via the playbook (see below)."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:73
msgid "Creating registration tokens"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:75
msgid "To **create a new user registration token (link)**, use this command:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:83
msgid ""
"The above command creates and returns a **one-time use** token, which "
"**expires** on the 31st of December 2021. Adjust the `one_time` and "
"`ex_date` variables as you see fit."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:85
msgid ""
"Share the unique registration link (generated by the command above) with "
"users to let them register on your Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:87
msgid "Listing registration tokens"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:89
msgid "To **list the existing user registration tokens**, use this command:"
msgstr ""
#: ../../../docs/configuring-playbook-matrix-registration.md:96
msgid ""
"The shortcut command with `just` program is also available: `just run-"
"tags list-matrix-registration-tokens`"
msgstr ""

260
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-mautrix-bridges.po Normal file
View File

@@ -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/configuring-playbook-mautrix-bridges.md:1
msgid "Setting up a Generic Mautrix Bridge (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:3
msgid ""
"The playbook can install and configure various "
"[mautrix](https://github.com/mautrix) bridges (twitter, facebook, "
"instagram, signal, hangouts, googlechat, etc.), as well as many other "
"(non-mautrix) bridges. This is a common guide for configuring mautrix "
"bridges."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:5
msgid ""
"You can see each bridge's features at in the `ROADMAP.md` file in its "
"corresponding [mautrix](https://github.com/mautrix) repository."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:9
msgid ""
"To enable the bridge, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:16
msgid ""
"There are some additional things you may wish to configure about the "
"bridge before you continue. Each bridge may have additional requirements "
"besides `_enabled: true`. For example, the mautrix-telegram bridge (our "
"documentation page about it is [here](configuring-playbook-bridge-"
"mautrix-telegram.md)) requires the `matrix_mautrix_telegram_api_id` and "
"`matrix_mautrix_telegram_api_hash` variables to be defined. Refer to each"
" bridge's individual documentation page for details about enabling "
"bridges."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:18
msgid ""
"To **configure a user as an administrator for all bridges**, add the "
"following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:24
msgid ""
"**Alternatively** (more verbose, but allows multiple admins to be "
"configured), you can do the same on a per-bridge basis with:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:33
msgid "encryption"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:35
msgid ""
"Encryption support is off by default. If you would like to enable "
"encryption, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:37
msgid "**for all bridges with encryption support**:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:44
#: ../../../docs/configuring-playbook-mautrix-bridges.md:61
msgid "**Alternatively**, for a specific bridge:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:51
msgid "relay mode"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:53
msgid ""
"Relay mode is off by default. If you would like to enable relay mode, add"
" the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:55
msgid "**for all bridges with relay mode support**:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:70
msgid ""
"You can only have one "
"`matrix_mautrix_SERVICENAME_configuration_extension_yaml` definition in "
"`vars.yml` per bridge, so if you need multiple pieces of configuration "
"there, just merge them like this:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:82
msgid "Setting the bot's username"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:88
msgid "Can be used to set the username for the bridge."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:90
msgid "Discovering additional configuration options"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:92
msgid ""
"You may wish to look at `roles/custom/matrix-bridge-mautrix-"
"SERVICENAME/templates/config.yaml.j2` and `roles/custom/matrix-bridge-"
"mautrix-SERVICENAME/defaults/main.yml` to find other things you would "
"like to configure."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:94
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:96
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:103
msgid "**Notes**:"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:105
msgid ""
"The `ensure-matrix-users-created` playbook tag makes the playbook "
"automatically create the bot's user account."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:107
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:109
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-mautrix-bridges.md:111
msgid "Set up Double Puppeting"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:113
msgid ""
"To set up [Double Puppeting](https://docs.mau.fi/bridges/general/double-"
"puppeting.html) enable the [Appservice Double Puppet](configuring-"
"playbook-appservice-double-puppet.md) service for this playbook."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:115
msgid ""
"The bridge automatically performs Double Puppeting if [Shared Secret Auth"
"](configuring-playbook-shared-secret-auth.md) is configured and enabled "
"on the server for this playbook by adding"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:121
msgid ""
"This is the recommended way of setting up Double Puppeting, as it's "
"easier to accomplish, works for all your users automatically, and has "
"less of a chance of breaking in the future."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:123
msgid "Controlling the logging level"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:129
msgid ""
"to `vars.yml` to control the logging level, where you may replace WARN "
"with one of the following to control the verbosity of the logs generated:"
" TRACE, DEBUG, INFO, WARN, ERROR, or FATAL."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:131
msgid ""
"If you have issues with a service, and are requesting support, the higher"
" levels of logging will generally be more helpful."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:133
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:135
msgid ""
"To use the bridge, you need to start a chat with "
"`@SERVICENAMEbot:example.com` (where `example.com` is your base domain, "
"not the `matrix.` domain)."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:137
msgid ""
"Send `login` to the bridge bot to get started. You can learn more here "
"about authentication from the bridge's official documentation on "
"Authentication: "
"https://docs.mau.fi/bridges/python/SERVICENAME/authentication.html"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:139
msgid ""
"If you run into trouble, check the [Troubleshooting](#troubleshooting) "
"section below."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:141
msgid "Troubleshooting"
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:143
msgid ""
"For troubleshooting information with a specific bridge, please see the "
"playbook documentation about it (some other document in in `docs/`) and "
"the upstream ([mautrix](https://github.com/mautrix)) bridge documentation"
" for that specific bridge."
msgstr ""
#: ../../../docs/configuring-playbook-mautrix-bridges.md:145
msgid ""
"Reporting bridge bugs should happen upstream, in the corresponding "
"mautrix repository, not to us."
msgstr ""

31
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-nginx.po Normal file
View File

@@ -0,0 +1,31 @@
# 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/configuring-playbook-nginx.md:1
msgid "Configure Nginx (optional, advanced)"
msgstr ""
#: ../../../docs/configuring-playbook-nginx.md:3
msgid "Since 2024-01, this playbook no longer uses nginx as its reverse-proxy."
msgstr ""

355
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ntfy.po Normal file
View File

@@ -0,0 +1,355 @@
# 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/configuring-playbook-ntfy.md:1
msgid "Setting up the ntfy push notifications server (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:3
msgid ""
"The playbook can install and configure the [ntfy](https://ntfy.sh/) push "
"notifications server for you."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:5
msgid ""
"Using the [UnifiedPush](https://unifiedpush.org) standard, ntfy enables "
"self-hosted (Google-free) push notifications from Matrix (and other) "
"servers to UnifiedPush-compatible Matrix compatible client apps running "
"on Android and other devices."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:7
msgid ""
"This role is intended to support UnifiedPush notifications for use with "
"the Matrix and Matrix-related services that this playbook installs. This "
"role is not intended to support all of ntfy's other features."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:9
msgid ""
"**Note**: In contrast to push notifications using Google's FCM or Apple's"
" APNs, the use of UnifiedPush allows each end-user to choose the push "
"notification server that they prefer. As a consequence, deploying this "
"ntfy server does not by itself ensure any particular user or device or "
"client app will use it."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:11
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:13
msgid ""
"To enable ntfy, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:27
msgid ""
"For a more complete list of variables that you could override, see the "
"[`defaults/main.yml` file](https://github.com/mother-of-all-self-hosting"
"/ansible-role-ntfy/blob/main/defaults/main.yml) of the ntfy Ansible role."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:29
msgid ""
"For a complete list of ntfy config options that you could put in "
"`ntfy_configuration_extension_yaml`, see the [ntfy config "
"documentation](https://ntfy.sh/docs/config/#config-options)."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:31
msgid "Adjusting the ntfy URL"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:33
msgid ""
"By default, this playbook installs ntfy on the `ntfy.` subdomain "
"(`ntfy.example.com`) and requires you to [adjust your DNS records"
"](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:35
msgid ""
"By tweaking the `ntfy_hostname` variable, you can easily make the service"
" available at a **different hostname** than the default one."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:37
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:44
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:46
msgid ""
"Once you've decided on the domain, **you may need to adjust your DNS** "
"records to point the ntfy domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:48
msgid ""
"By default, you will need to create a CNAME record for `ntfy`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:50
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:52
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:59
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:61
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:63
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:65
msgid ""
"To make use of your ntfy installation, on Android for example, you need "
"two things:"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:67
msgid "the `ntfy` app"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:68
msgid "a UnifiedPush-compatible Matrix app"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:70
msgid ""
"You need to install the `ntfy` app on each device on which you want to "
"receive push notifications through your ntfy server. The `ntfy` app will "
"provide UnifiedPush notifications to any number of UnifiedPush-compatible"
" messaging apps installed on the same device."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:72
msgid "Setting up the `ntfy` Android app"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:74
msgid ""
"Install the [ntfy Android app](https://ntfy.sh/docs/subscribe/phone/) "
"from F-droid or Google Play."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:75
msgid ""
"In its Settings -> `General: Default server`, enter your ntfy server URL,"
" such as `https://ntfy.example.com`."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:76
msgid "In its Settings -> `Advanced: Connection protocol`, choose `WebSockets`."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:78
msgid ""
"That is all you need to do in the ntfy app. It has many other features, "
"but for our purposes you can ignore them. In particular you do not need "
"to follow any instructions about subscribing to a notification topic as "
"UnifiedPush will do that automatically."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:80
msgid "Setting up a UnifiedPush-compatible Matrix app"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:82
msgid ""
"Install any UnifiedPush-enabled Matrix app on that same device. The "
"Matrix app will learn from the `ntfy` app that you have configured "
"UnifiedPush on this device, and then it will tell your Matrix server to "
"use it."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:84
msgid "Steps needed for specific Matrix apps:"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:86
msgid "FluffyChat-android:"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:87
msgid "Should auto-detect and use it. No manual settings."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:89
msgid "SchildiChat-android:"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:90
msgid ""
"enable `Settings` -> `Notifications` -> `UnifiedPush: Force custom push "
"gateway`."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:91
msgid ""
"choose `Settings` -> `Notifications` -> `UnifiedPush: Re-register push "
"distributor`. *(For info, a more complex alternative to achieve the same "
"is: delete the relevant unifiedpush registration in `ntfy` app, force-"
"close SchildiChat, re-open it.)*"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:92
msgid ""
"verify `Settings` -> `Notifications` -> `UnifiedPush: Notification "
"targets` as described below in the \"Troubleshooting\" section."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:94
msgid "Element-android v1.4.26+:"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:95
msgid "choose `Settings` -> `Notifications` -> `Notification method` -> `ntfy`"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:96
msgid ""
"verify `Settings` -> `Troubleshoot` -> `Troubleshoot notification "
"settings`"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:98
msgid ""
"If the Matrix app asks, \"Choose a distributor: FCM Fallback or ntfy\", "
"then choose \"ntfy\"."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:100
msgid ""
"If the Matrix app doesn't seem to pick it up, try restarting it and try "
"the Troubleshooting section below."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:102
msgid "Web App"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:104
msgid ""
"ntfy also has a web app to subscribe to and push to topics from the "
"browser. This may be helpful to further troubleshoot UnifiedPush problems"
" or to use ntfy for other purposes. The web app only runs in the browser "
"locally (after downloading the JavaScript)."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:106
msgid ""
"The web app is disabled in this playbook by default as the expectation is"
" that most users won't use it. You can either use the [official hosted "
"one](https://ntfy.sh/app) (it supports using other public reachable ntfy "
"instances) or host it yourself by setting `ntfy_web_root: \"app\"` and "
"re-running Ansible."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:108
msgid "Troubleshooting"
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:110
msgid ""
"First check that the Matrix client app you are using supports "
"UnifiedPush. There may well be different variants of the app."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:112
msgid ""
"Set the ntfy server's log level to 'DEBUG', as shown in the example "
"settings above, and watch the server's logs with `sudo journalctl -fu "
"matrix-ntfy`."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:114
msgid ""
"To check if UnifiedPush is correctly configured on the client device, "
"look at \"Settings -> Notifications -> Notification Targets\" in Element "
"Android or SchildiChat Android, or \"Settings -> Notifications -> "
"Devices\" in FluffyChat. There should be one entry for each Matrix client"
" app that has enabled push notifications, and when that client is using "
"UnifiedPush you should see a URL that begins with your ntfy server's URL."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:116
msgid ""
"In the \"Notification Targets\" screen in Element Android or SchildiChat "
"Android, two relevant URLs are shown, \"push\\_key\" and \"Url\", and "
"both should begin with your ntfy server's URL. If \"push\\_key\" shows "
"your server but \"Url\" shows an external server such as "
"`up.schildi.chat` then push notifications will still work but are being "
"routed through that external server before they reach your ntfy server. "
"To rectify that, in SchildiChat (at least around version 1.4.20.sc55) you"
" must enable the `Force custom push gateway` setting as described in the "
"\"Usage\" section above."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:118
msgid ""
"If it is not working, useful tools are \"Settings -> Notifications -> Re-"
"register push distributor\" and \"Settings -> Notifications -> "
"Troubleshoot Notifications\" in SchildiChat Android (possibly also "
"Element Android). In particular the \"Endpoint/FCM\" step of that "
"troubleshooter should display your ntfy server's URL that it has "
"discovered from the ntfy client app."
msgstr ""
#: ../../../docs/configuring-playbook-ntfy.md:120
msgid ""
"The simple [UnifiedPush "
"troubleshooting](https://unifiedpush.org/users/troubleshooting/) app [UP-"
"Example](https://f-droid.org/en/packages/org.unifiedpush.example/) can be"
" used to manually test UnifiedPush registration and operation on an "
"Android device."
msgstr ""

292
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-own-webserver.po Normal file
View File

@@ -0,0 +1,292 @@
# 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/configuring-playbook-own-webserver.md:1
msgid ""
"Using your own webserver, instead of this playbook's Traefik reverse-"
"proxy (optional, advanced)"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:3
msgid ""
"By default, this playbook installs its own [Traefik](https://traefik.io/)"
" reverse-proxy server (in a Docker container) which listens on ports 80 "
"and 443. If that's okay, you can skip this document."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:5
msgid "Traefik"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:7
msgid ""
"[Traefik](https://traefik.io/) is the default reverse-proxy for the "
"playbook since [2023-02-26](../CHANGELOG.md/#2023-02-26) and serves **2 "
"purposes**:"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:9
msgid ""
"serving public traffic and providing SSL-termination with certificates "
"obtained from [Let's Encrypt](https://letsencrypt.org/). See [Adjusting "
"SSL certificate retrieval](./configuring-playbook-ssl-certificates.md)."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:11
msgid ""
"assists internal communication between addon services (briges, bots, "
"etc.) and the homeserver via an internal entrypoint (`matrix-internal-"
"matrix-client-api`)."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:13
msgid "There are 2 ways to use Traefik with this playbook, as described below."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:15
msgid "Traefik managed by the playbook"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:17
msgid ""
"To have the playbook install and use Traefik, add the following "
"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
"file:"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:25
msgid "Traefik will manage SSL certificates for all services seamlessly."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:27
msgid "Traefik managed by you"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:53
msgid ""
"In this mode all roles will still have Traefik labels attached. You will,"
" however, need to configure your Traefik instance and its entrypoints."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:55
msgid ""
"By default, the playbook configured a `default` certificate resolver and "
"multiple entrypoints."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:57
msgid "You need to configure 4 entrypoints for your Traefik server:"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:59
msgid "`web` (TCP port `80`) - used for redirecting to HTTPS (`web-secure`)"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:60
msgid ""
"`web-secure` (TCP port `443`) - used for exposing the Matrix Client-"
"Server API and all other services"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:61
msgid ""
"`matrix-federation` (TCP port `8448`) - used for exposing the Matrix "
"Federation API"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:62
msgid ""
"`matrix-internal-matrix-client-api` (TCP port `8008`) - used internally "
"for addon services (bridges, bots) to communicate with the homserver"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:64
msgid ""
"Below is some configuration for running Traefik yourself, although we "
"recommend using [Traefik managed by the playbook](#traefik-managed-by-"
"the-playbook)."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:66
msgid ""
"Note that this configuration on its own does **not** redirect traffic on "
"port 80 (plain HTTP) to port 443 for HTTPS. If you are not already doing "
"this in Traefik, it can be added to Traefik in a [file "
"provider](https://docs.traefik.io/v2.0/providers/file/) as follows:"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:86
msgid ""
"You can use the following `docker-compose.yml` as example to launch "
"Traefik."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:122
msgid "Another webserver"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:124
msgid "If you don't wish to use Traefik, you can also use your own webserver."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:126
msgid "Doing this is possible, but requires manual work."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:128
msgid "There are 2 ways to go about it:"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:130
msgid ""
"(recommended) [Fronting the integrated reverse-proxy webserver with "
"another reverse-proxy](#fronting-the-integrated-reverse-proxy-webserver-"
"with-another-reverse-proxy) - using the playbook-managed reverse-proxy "
"(Traefik), but disabling SSL termination for it, exposing this reverse-"
"proxy on a few local ports (e.g. `127.0.0.1:81`, etc.) and forwarding "
"traffic from your own webserver to those few ports"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:132
msgid ""
"(difficult) [Using no reverse-proxy on the Matrix side at all](#using-no-"
"reverse-proxy-on-the-matrix-side-at-all) disabling the playbook-managed "
"reverse-proxy (Traefik), exposing services one by one using "
"`_host_bind_port` variables and forwarding traffic from your own "
"webserver to those ports"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:134
msgid "Fronting the integrated reverse-proxy webserver with another reverse-proxy"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:136
msgid ""
"This method is about leaving the integrated reverse-proxy webserver be, "
"but making it not get in the way (using up important ports, trying to "
"retrieve SSL certificates, etc.)."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:138
msgid ""
"If you wish to use another webserver, the integrated reverse-proxy "
"webserver usually gets in the way because it attempts to fetch SSL "
"certificates and binds to ports 80, 443 and 8448 (if Matrix Federation is"
" enabled)."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:140
msgid ""
"You can disable such behavior and make the integrated reverse-proxy "
"webserver only serve traffic locally on the host itself (or over a local "
"network)."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:142
msgid ""
"This is the recommended way for using another reverse-proxy, because the "
"integrated one would act as a black box and wire all Matrix services "
"correctly. You would then only need to reverse-proxy a few individual "
"domains and ports over to it."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:144
msgid ""
"To front Traefik with another reverse-proxy, you would need some "
"configuration like this:"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:194
msgid ""
"Such a configuration would expose all services on a local port `81` and "
"Matrix Federation on a local port `8449`. Your reverse-proxy "
"configuration needs to send traffic to these ports. [`examples/reverse-"
"proxies`](../examples/reverse-proxies/) contains examples for various "
"webservers such as Apache2, Caddy, HAproxy, nginx and Nginx Proxy "
"Manager."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:196
msgid ""
"It's important that these webservers proxy-pass requests to the correct "
"`ip:port` and also set the `Host` HTTP header appropriately. If you don't"
" pass the `Host` header correctly, Traefik will return a `404 - not "
"found` error."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:198
msgid "To put it another way:"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:199
msgid "`curl http://127.0.0.1:81` will result in a `404 - not found` error"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:200
msgid "but `curl -H 'Host: matrix.example.com' http://127.0.0.1:81` should work."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:202
msgid "Using no reverse-proxy on the Matrix side at all"
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:204
msgid ""
"Instead of [Fronting the integrated reverse-proxy webserver with another "
"reverse-proxy](#fronting-the-integrated-reverse-proxy-webserver-with-"
"another-reverse-proxy), you can also go another way -- completely "
"disabling the playbook-managed Traefik reverse-proxy. You would then need"
" to reverse-proxy from your own webserver directly to each individual "
"Matrix service."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:206
msgid ""
"This is more difficult, as you would need to handle the configuration for"
" each service manually. Enabling additional services would come with "
"extra manual work you need to do."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:208
msgid ""
"Also, the Traefik reverse-proxy, besides fronting everything is also "
"serving a 2nd purpose of allowing addons services to communicate with the"
" Matrix homeserver thanks to its `matrix-internal-matrix-client-api` "
"entrypoint (read more about it above). Disabling Traefik completely means"
" the playbook would wire services to directly talk to the homeserver. "
"This can work for basic setups, but not for more complex setups involving"
" [matrix-media-repo](./configuring-playbook-matrix-media-repo.md), "
"[matrix-corporal](./configuring-playbook-matrix-corporal.md) or other "
"such services that need to \"steal routes\" from the homeserver."
msgstr ""
#: ../../../docs/configuring-playbook-own-webserver.md:210
msgid ""
"If your webserver is on the same machine, ensure your web server user "
"(something like `http`, `apache`, `www-data`, `nginx`) is part of the "
"`matrix` group. You should run something like this: `usermod -a -G matrix"
" nginx`. This allows your webserver user to access files owned by the "
"`matrix` group, so that it can serve static files from `/matrix/static-"
"files`."
msgstr ""

93
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po Normal file
View File

@@ -0,0 +1,93 @@
# 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/configuring-playbook-pantalaimon.md:1
msgid "Setting up Pantalaimon (E2EE aware proxy daemon) (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-pantalaimon.md:3
msgid ""
"The playbook can install and configure the "
"[pantalaimon](https://github.com/matrix-org/pantalaimon) E2EE aware proxy"
" daemon for you."
msgstr ""
#: ../../../docs/configuring-playbook-pantalaimon.md:5
msgid ""
"See the project's [documentation](https://github.com/matrix-"
"org/pantalaimon) to learn what it does and why it might be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-pantalaimon.md:7
msgid ""
"This role exposes Pantalaimon's API only within the container network, so"
" bots and clients installed on the same machine can use it. In particular"
" the [Draupnir](configuring-playbook-bot-draupnir.md) and [Mjolnir"
"](configuring-playbook-bot-mjolnir.md) roles (and possibly others) can "
"use it."
msgstr ""
#: ../../../docs/configuring-playbook-pantalaimon.md:9
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-pantalaimon.md:11
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-pantalaimon.md:17
msgid ""
"The default configuration should suffice. For advanced configuration, you"
" can override the variables documented in the role's "
"[defaults](../roles/custom/matrix-pantalaimon/defaults/main.yml)."
msgstr ""
#: ../../../docs/configuring-playbook-pantalaimon.md:19
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-pantalaimon.md:21
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-pantalaimon.md:28
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-pantalaimon.md:30
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

183
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-postgres-backup.po Normal file
View File

@@ -0,0 +1,183 @@
# 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/configuring-playbook-postgres-backup.md:1
msgid "Setting up postgres backup (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md:3
msgid ""
"The playbook can install and configure [docker-postgres-backup-"
"local](https://github.com/prodrigestivill/docker-postgres-backup-local) "
"for you via the [ansible-role-postgres-backup](https://github.com/mother-"
"of-all-self-hosting/ansible-role-postgres-backup) Ansible role."
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md:5
msgid ""
"For a more complete backup solution (one that includes not only Postgres,"
" but also other configuration/data files), you may wish to look into "
"[BorgBackup](configuring-playbook-backup-borg.md) instead."
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md:9
msgid ""
"To enable Postgres backup, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md:15
msgid ""
"Refer to the table below for additional configuration variables and their"
" default values."
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "Name"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "Default value"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "Description"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`postgres_backup_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`false`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid ""
"Set to true to use [docker-postgres-backup-"
"local](https://github.com/prodrigestivill/docker-postgres-backup-local) "
"to create automatic database backups"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`postgres_backup_schedule`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`'@daily'`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "Cron-schedule specifying the interval between postgres backups."
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`postgres_backup_keep_days`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`7`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "Number of daily backups to keep"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`postgres_backup_keep_weeks`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`4`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "Number of weekly backups to keep"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`postgres_backup_keep_months`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`12`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "Number of monthly backups to keep"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`postgres_backup_base_path`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`\"{{ matrix_base_data_path }}/postgres-backup\"`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "Base path for postgres-backup. Also see `postgres_backup_data_path`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`postgres_backup_data_path`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "`\"{{ postgres_backup_base_path }}/data\"`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md
msgid "Storage path for postgres-backup database backups"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md:27
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md:29
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md:36
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-postgres-backup.md:38
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

513
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-prometheus-grafana.po Normal file
View File

@@ -0,0 +1,513 @@
# 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/configuring-playbook-prometheus-grafana.md:1
msgid ""
"Enabling metrics and graphs (Prometheus, Grafana) for your Matrix server "
"(optional)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:3
msgid ""
"The playbook can install [Grafana](https://grafana.com/) with "
"[Prometheus](https://prometheus.io/) and configure performance metrics of"
" your homeserver with graphs for you."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:5
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:7
msgid ""
"To enable Grafana and/or Prometheus, add the following configuration to "
"your `inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:33
msgid ""
"The retention policy of Prometheus metrics is [15 days by "
"default](https://prometheus.io/docs/prometheus/latest/storage"
"/#operational-aspects). Older data gets deleted automatically."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:35
msgid "Adjusting the Grafana URL"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:37
msgid ""
"By default, this playbook installs Grafana web user-interface on the "
"`stats.` subdomain (`stats.example.com`) and requires you to [adjust your"
" DNS records](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:39
msgid ""
"By tweaking the `grafana_hostname` variable, you can easily make the "
"service available at a **different hostname** than the default one."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:41
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:48
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:50
msgid ""
"Once you've decided on the domain, **you may need to adjust your DNS** "
"records to point the Grafana domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:52
msgid ""
"By default, you will need to create a CNAME record for `stats`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:54
msgid ""
"**Note**: It is possible to install Prometheus without installing "
"Grafana. This case it is not required to create the CNAME record."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:56
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:58
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:65
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:67
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:69
msgid "What does it do?"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "Name"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "Description"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`prometheus_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"[Prometheus](https://prometheus.io) is a time series database. It holds "
"all the data we're going to talk about."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`prometheus_node_exporter_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"[Node Exporter](https://prometheus.io/docs/guides/node-exporter/) is an "
"addon of sorts to Prometheus that collects generic system information "
"such as CPU, memory, filesystem, and even system temperatures"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`prometheus_postgres_exporter_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"[Postgres Exporter](configuring-playbook-prometheus-postgres.md) is an "
"addon of sorts to expose Postgres database metrics to Prometheus."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_prometheus_nginxlog_exporter_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"[NGINX Log Exporter](configuring-playbook-prometheus-nginxlog.md) is an "
"addon of sorts to expose NGINX logs to Prometheus."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`grafana_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"[Grafana](https://grafana.com/) is the visual component. It shows (on the"
" `stats.example.com` subdomain) the dashboards with the graphs that we're"
" interested in"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`grafana_anonymous_access`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"By default you need to log in to see graphs. If you want to publicly "
"share your graphs (e.g. when asking for help in "
"[`#synapse:matrix.org`](https://matrix.to/#/#synapse:matrix.org?via=matrix.org&via=privacytools.io&via=mozilla.org))"
" you'll want to enable this option."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`grafana_default_admin_user`<br>`grafana_default_admin_password`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"By default Grafana creates a user with `admin` as the username and "
"password. If you feel this is insecure and you want to change it "
"beforehand, you can do that here"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:81
msgid "Security and privacy"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:83
msgid ""
"Metrics and resulting graphs can contain a lot of information. This "
"includes system specs but also usage patterns. This applies especially to"
" small personal/family scale homeservers. Someone might be able to figure"
" out when you wake up and go to sleep by looking at the graphs over time."
" Think about this before enabling anonymous access. And you should really"
" not forget to change your Grafana password."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:85
msgid ""
"Most of our docker containers run with limited system access, but the "
"`prometheus-node-exporter` has access to the host network stack and "
"(readonly) root filesystem. This is required to report on them. If you "
"don't like that, you can set `prometheus_node_exporter_enabled: false` "
"(which is actually the default). You will still get Synapse metrics with "
"this container disabled. Both of the dashboards will always be enabled, "
"so you can still look at historical data after disabling either source."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:87
msgid "Collecting metrics to an external Prometheus server"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:89
msgid ""
"**If the integrated Prometheus server is enabled** (`prometheus_enabled: "
"true`), metrics are collected by it from each service via communication "
"that happens over the container network. Each service does not need to "
"expose its metrics \"publicly\"."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:91
msgid ""
"When you'd like **to collect metrics from an external Prometheus "
"server**, you need to expose service metrics outside of the container "
"network."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:93
msgid ""
"The playbook provides a single endpoint "
"(`https://matrix.example.com/metrics/*`), under which various services "
"may expose their metrics (e.g. `/metrics/node-exporter`, `/metrics"
"/postgres-exporter`, `/metrics/hookshot`, etc). To expose all services on"
" this `/metrics/*` feature, use `matrix_metrics_exposure_enabled`. To "
"protect access using [Basic "
"Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication),"
" see `matrix_metrics_exposure_http_basic_auth_enabled` and "
"`matrix_metrics_exposure_http_basic_auth_users` below."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:95
msgid ""
"When using `matrix_metrics_exposure_enabled`, you don't need to expose "
"metrics for individual services one by one."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:97
msgid "The following variables may be of interest:"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_metrics_exposure_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to **enable metrics exposure for all services** on "
"`https://matrix.example.com/metrics/*`. If you think this is too much, "
"refer to the helpful (but nonexhaustive) list of individual "
"`matrix_SERVICE_metrics_proxying_enabled` (or similar) variables below "
"for exposing metrics on a per-service basis."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_metrics_exposure_http_basic_auth_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to protect all `https://matrix.example.com/metrics/*` "
"endpoints with [Basic "
"Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)"
" (see the other variables below for supplying the actual credentials). "
"When enabled, all endpoints beneath `/metrics` will be protected with the"
" same credentials"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_metrics_exposure_http_basic_auth_users`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to the Basic Authentication credentials (raw `htpasswd` file "
"content) used to protect `/metrics/*`. This htpasswd-file needs to be "
"generated with the `htpasswd` tool and can include multiple "
"username/password pairs."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_synapse_metrics_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to make Synapse expose metrics (locally, on the "
"container network)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_synapse_metrics_proxying_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to expose Synapse's metrics on "
"`https://matrix.example.com/metrics/synapse/main-process` and "
"`https://matrix.example.com/metrics/synapse/worker/TYPE-ID`. Read [below"
"](#collecting-synapse-worker-metrics-to-an-external-prometheus-server) if"
" you're running a Synapse worker setup (`matrix_synapse_workers_enabled: "
"true`). To password-protect the metrics, see "
"`matrix_metrics_exposure_http_basic_auth_users` above."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to enable the node (general system stats) exporter "
"(locally, on the container network)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`prometheus_node_exporter_container_labels_traefik_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to expose the node (general system stats) metrics on "
"`https://matrix.example.com/metrics/node-exporter`. To password-protect "
"the metrics, see `matrix_metrics_exposure_http_basic_auth_users` above."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to enable the [Postgres exporter](configuring-"
"playbook-prometheus-postgres.md) (locally, on the container network)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`prometheus_postgres_exporter_container_labels_traefik_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to expose the [Postgres exporter](configuring-"
"playbook-prometheus-postgres.md) metrics on "
"`https://matrix.example.com/metrics/postgres-exporter`. To password-"
"protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` "
"above."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to enable the [NGINX Log exporter](configuring-"
"playbook-prometheus-nginxlog.md) (locally, on the container network)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_sliding_sync_metrics_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to make [Sliding Sync](configuring-playbook-sliding-"
"sync-proxy.md) expose metrics (locally, on the container network)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_sliding_sync_metrics_proxying_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to expose the [Sliding Sync](configuring-playbook-"
"sliding-sync-proxy.md) metrics on `https://matrix.example.com/metrics"
"/sliding-sync`. To password-protect the metrics, see "
"`matrix_metrics_exposure_http_basic_auth_users` above."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_bridge_hookshot_metrics_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to make [Hookshot](configuring-playbook-bridge-"
"hookshot.md) expose metrics (locally, on the container network)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_bridge_hookshot_metrics_proxying_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to expose the [Hookshot](configuring-playbook-bridge-"
"hookshot.md) metrics on `https://matrix.example.com/metrics/hookshot`. To"
" password-protect the metrics, see "
"`matrix_metrics_exposure_http_basic_auth_users` above."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_SERVICE_metrics_proxying_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Various other services/roles may provide similar `_metrics_enabled` and "
"`_metrics_proxying_enabled` variables for exposing their metrics. Refer "
"to each role for details. To password-protect the metrics, see "
"`matrix_metrics_exposure_http_basic_auth_users` above or "
"`matrix_SERVICE_container_labels_metrics_middleware_basic_auth_enabled`/`matrix_SERVICE_container_labels_metrics_middleware_basic_auth_users`"
" variables provided by each role."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid "`matrix_media_repo_metrics_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md
msgid ""
"Set this to `true` to make media-repo expose metrics (locally, on the "
"container network)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:118
msgid "Collecting Synapse worker metrics to an external Prometheus server"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:120
msgid ""
"If you are using workers (`matrix_synapse_workers_enabled: true`) and "
"have enabled `matrix_synapse_metrics_proxying_enabled` as described "
"above, the playbook will also automatically expose all Synapse worker "
"threads' metrics to "
"`https://matrix.example.com/metrics/synapse/worker/ID`, where `ID` "
"corresponds to the worker `id` as exemplified in "
"`matrix_synapse_workers_enabled_list`."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:122
msgid ""
"The playbook also generates an exemplary config file "
"(`/matrix/synapse/external_prometheus.yml.template`) with all the correct"
" paths which you can copy to your Prometheus server and adapt to your "
"needs. Make sure to edit the specified `password_file` path and contents "
"and path to your `synapse-v2.rules`. It will look a bit like this:"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:150
msgid "More information"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:152
msgid ""
"[Enabling synapse-usage-exporter for Synapse usage statistics"
"](configuring-playbook-synapse-usage-exporter.md)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:153
msgid ""
"[Understanding Synapse Performance Issues Through Grafana Graphs](https"
"://element-"
"hq.github.io/synapse/latest/usage/administration/understanding_synapse_through_grafana_graphs.html)"
" at the Synapse Github Wiki"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:154
msgid ""
"[The Prometheus scraping rules](https://github.com/element-"
"hq/synapse/tree/master/contrib/prometheus) (we use v2)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:155
msgid ""
"[The Synapse Grafana dashboard](https://github.com/element-"
"hq/synapse/tree/master/contrib/grafana)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-grafana.md:156
msgid ""
"[The Node Exporter dashboard](https://github.com/rfrail3/grafana-"
"dashboards) (for generic non-synapse performance graphs)"
msgstr ""

177
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-prometheus-nginxlog.po Normal file
View File

@@ -0,0 +1,177 @@
# 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/configuring-playbook-prometheus-nginxlog.md:1
msgid "Enabling metrics and graphs for NginX logs (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:3
msgid ""
"It can be useful to have some (visual) insight into "
"[nginx](https://nginx.org/) logs."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:5
msgid ""
"This adds [prometheus-nginxlog-exporter](https://github.com/martin-"
"helmich/prometheus-nginxlog-exporter/) to your Matrix deployment."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:7
msgid ""
"It will collect access logs from various nginx reverse-proxies which may "
"be used internally (e.g. `matrix-synapse-reverse-proxy-companion`, if "
"Synapse workers are enabled) and will make them available at a "
"Prometheus-compatible `/metrics` endpoint."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:9
msgid ""
"**Note**: nginx is only used internally by this Ansible playbook. With "
"Traefik being our default reverse-proxy, collecting nginx metrics is less"
" relevant."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:11
msgid ""
"To make use of this, you need to install [Prometheus](./configuring-"
"playbook-prometheus-grafana.md) either via the playbook or externally. "
"When using an external Prometheus, configuration adjustments are "
"necessary - see [Save metrics on an external Prometheus server](#save-"
"metrics-on-an-external-prometheus-server)."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:13
msgid ""
"If your setup includes [Grafana](./configuring-playbook-prometheus-"
"grafana.md), a dedicated `NGINX PROXY` Grafana dashboard will be created."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:15
msgid "Configuration"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:17
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:23
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:25
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:32
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:34
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:36
msgid "Docker Image Compatibility"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:38
msgid ""
"At the moment of writing only images for `amd64` and `arm64` "
"architectures are available. The playbook currently does not support "
"[self-building](./self-building.md) a container image on other "
"architectures. You can however use a custom-build image by setting:"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:45
msgid "Security and privacy"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:47
msgid ""
"Metrics and resulting graphs can contain a lot of information. NginX logs"
" contain information like IP address, URLs, UserAgents and more. This "
"information can reveal usage patterns and could be considered Personally "
"Identifiable Information (PII). Think about this before enabling "
"(anonymous) access. Please make sure you change the default Grafana "
"password."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:49
msgid "Save metrics on an external Prometheus server"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:51
msgid ""
"The playbook will automatically integrate the metrics into the "
"[Prometheus](./configuring-playbook-prometheus-grafana.md) server "
"provided with this playbook (if enabled). In such cases, the metrics "
"endpoint is not exposed publicly - it's only available on the container "
"network."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:53
msgid ""
"When using an external Prometheus server, you'll need to expose metrics "
"publicly. See [Collecting metrics to an external Prometheus server"
"](./configuring-playbook-prometheus-grafana.md#collecting-metrics-to-an-"
"external-prometheus-server)."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:55
msgid ""
"You can either use "
"`matrix_prometheus_nginxlog_exporter_metrics_proxying_enabled: true` to "
"expose just this one service, or `matrix_metrics_exposure_enabled: true` "
"to expose all services."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:57
msgid ""
"Whichever way you go with, this service will expose its metrics endpoint "
"**without password-protection** at "
"`https://matrix.example.com/metrics/nginxlog` by default."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:59
msgid ""
"For password-protection, use "
"(`matrix_metrics_exposure_http_basic_auth_enabled` and "
"`matrix_metrics_exposure_http_basic_auth_users`) or "
"(`matrix_prometheus_nginxlog_exporter_container_labels_metrics_middleware_basic_auth_enabled`"
" and "
"`matrix_prometheus_nginxlog_exporter_container_labels_metrics_middleware_basic_auth_users`)."
msgstr ""

140
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-prometheus-postgres.po Normal file
View File

@@ -0,0 +1,140 @@
# 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/configuring-playbook-prometheus-postgres.md:1
msgid "Enabling metrics and graphs for Postgres (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md:3
msgid ""
"Expanding on the metrics exposed by the [synapse exporter and the node "
"exporter](configuring-playbook-prometheus-grafana.md), the playbook "
"enables the [postgres exporter](https://github.com/prometheus-"
"community/postgres_exporter) that exposes more detailed information about"
" what's happening on your postgres database."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md:5
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md:7
msgid ""
"To enable the postgres exporter, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md:13
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md:15
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md:22
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md:24
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md:26
msgid "What does it do?"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md
msgid "Name"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md
msgid "Description"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md
msgid "`prometheus_postgres_exporter_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md
msgid ""
"Enable the postgres prometheus exporter. This sets up the docker "
"container, connects it to the database and adds a 'job' to the prometheus"
" config which tells prometheus about this new exporter. The default is "
"'false'"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md
msgid "`prometheus_postgres_exporter_database_username`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md
msgid ""
"The 'username' for the user that the exporter uses to connect to the "
"database. The default is 'matrix_prometheus_postgres_exporter'"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md
msgid "`prometheus_postgres_exporter_database_password`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md
msgid ""
"The 'password' for the user that the exporter uses to connect to the "
"database. By default, this is auto-generated by the playbook"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md
msgid "`prometheus_postgres_exporter_container_labels_traefik_enabled`"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md
msgid ""
"If set to `true`, exposes the Postgres exporter metrics on "
"`https://matrix.example.com/metrics/postgres-exporter` for usage with an "
"[external Prometheus server](configuring-playbook-prometheus-grafana.md"
"#collecting-metrics-to-an-external-prometheus-server). To password-"
"protect the metrics, see `matrix_metrics_exposure_http_basic_auth_users` "
"on that other documentation page."
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md:35
msgid "More information"
msgstr ""
#: ../../../docs/configuring-playbook-prometheus-postgres.md:37
msgid ""
"[The PostgresSQL dashboard](https://grafana.com/grafana/dashboards/9628) "
"(generic postgres dashboard)"
msgstr ""

146
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-rageshake.po Normal file
View File

@@ -0,0 +1,146 @@
# 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/configuring-playbook-rageshake.md:1
msgid "Setting up the rageshake bug report server (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:3
msgid ""
"The playbook can install and configure the [rageshake](https://github.com"
"/matrix-org/rageshake) bug report server for you."
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:5
msgid ""
"This is useful if you're developing your own applications and would like "
"to collect bug reports for them."
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:9
msgid ""
"To enable rageshake, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:15
msgid ""
"rageshake has various options which don't have dedicated Ansible "
"variables. You can see the full list of options in the "
"[`rageshake.sample.yaml` file](https://github.com/matrix-"
"org/rageshake/blob/master/rageshake.sample.yaml)."
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:17
msgid ""
"To set these, you can make use of the "
"`matrix_rageshake_configuration_extension_yaml` variable like this:"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:27
msgid "Adjusting the rageshake URL"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:29
msgid ""
"By default, this playbook installs rageshake on the `rageshake.` "
"subdomain (`rageshake.example.com`) and requires you to [adjust your DNS "
"records](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:31
msgid ""
"By tweaking the `matrix_rageshake_hostname` and "
"`matrix_rageshake_path_prefix` variables, you can easily make the service"
" available at a **different hostname and/or path** than the default one."
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:33
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:44
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:46
msgid ""
"Once you've decided on the domain and path, **you may need to adjust your"
" DNS** records to point the rageshake domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:48
msgid ""
"By default, you will need to create a CNAME record for `rageshake`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:50
msgid ""
"If you've decided to reuse the `matrix.` domain, you won't need to do any"
" extra DNS configuration."
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:52
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:54
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:61
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:63
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:65
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-rageshake.md:67
msgid ""
"Refer to the [rageshake documentation](https://github.com/matrix-"
"org/rageshake) for available APIs, etc."
msgstr ""

86
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-rest-auth.po Normal file
View File

@@ -0,0 +1,86 @@
# Translations template for PROJECT.
# Copyright (C) 2024 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PROJECT VERSION\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\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-Team: LANGUAGE <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-rest-auth.md:1
msgid ""
"Setting up the REST authentication password provider module (optional, "
"advanced)"
msgstr ""
#: ../../../docs/configuring-playbook-rest-auth.md:3
msgid ""
"The playbook can install and configure [matrix-synapse-rest-"
"auth](https://github.com/ma1uta/matrix-synapse-rest-password-provider) "
"for you."
msgstr ""
#: ../../../docs/configuring-playbook-rest-auth.md:5
msgid ""
"See that project's documentation to learn what it does and why it might "
"be useful to you."
msgstr ""
#: ../../../docs/configuring-playbook-rest-auth.md:7
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-rest-auth.md:9
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
"needs):"
msgstr ""
#: ../../../docs/configuring-playbook-rest-auth.md:19
msgid "Authenticating only using a password provider"
msgstr ""
#: ../../../docs/configuring-playbook-rest-auth.md:21
msgid ""
"If you wish for users to **authenticate only against configured password "
"providers** (like this one), **without consulting Synapse's local "
"database**, feel free to disable it:"
msgstr ""
#: ../../../docs/configuring-playbook-rest-auth.md:27
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-rest-auth.md:29
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-rest-auth.md:36
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-rest-auth.md:38
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

130
i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-riot-web.po Normal file
View File

@@ -0,0 +1,130 @@
# 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/configuring-playbook-riot-web.md:1
msgid "Configuring Riot-web (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:3
msgid ""
"By default, this playbook **used to install** the [Riot-"
"web](https://github.com/element-hq/riot-web) Matrix client web "
"application."
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:5
msgid ""
"Riot has since been [renamed to Element](https://element.io/blog/welcome-"
"to-element/)."
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:7
msgid ""
"to learn more about Element Web and its configuration, see our dedicated "
"[Configuring Element Web](configuring-playbook-client-element-web.md) "
"documentation page"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:8
msgid ""
"to learn how to migrate from Riot to Element Web, see [Migrating to "
"Element Web](#migrating-to-element-web) below"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:10
msgid "Migrating to Element Web"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:12
msgid "Migrating your custom settings"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:14
msgid ""
"If you have custom `matrix_riot_web_` variables in your "
"`inventory/host_vars/matrix.example.com/vars.yml` file, you'll need to "
"rename them (`matrix_riot_web_` -> `matrix_client_element_`)."
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:16
msgid ""
"Some other playbook variables (but not all) with `riot` in their name are"
" also renamed. The playbook checks and warns if you are using the old "
"name for some commonly used ones."
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:18
msgid "Domain migration"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:20
msgid ""
"We used to set up Riot at the `riot.example.com` domain. The playbook now"
" sets up Element Web at `element.example.com` by default."
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:22
msgid "There are a few options for handling this:"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:24
msgid ""
"(**avoiding changes** - using the old `riot.example.com` domain and "
"avoiding DNS changes) -- to keep using `riot.example.com` instead of "
"`element.example.com`, override the domain at which the playbook serves "
"Element Web: `matrix_server_fqn_element: \"riot.{{ matrix_domain }}\"`"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:26
msgid ""
"(**embracing changes** - using only `element.example.com`) - set up the "
"`element.example.com` DNS record (see [Configuring DNS](configuring-"
"dns.md)). You can drop the `riot.example.com` in this case."
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:28
msgid "Re-running the playbook"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:30
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:37
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-riot-web.md:39
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. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

Some files were not shown because too many files have changed in this diff Show More