Initial work on translations / localization

Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841

Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul).
I've merely reorganized/polished the scripts and instructions in the `i18n/` directory.

While translations can happen even now, more work is necessary to

- make the translation flow better (integrating Weblate), etc.

- restore the Github Actions workflows that Suguru Hirahara had already developed to
  adapt them to our new workflow

i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-prometheus-nginxlog.po

@@ -0,0 +1,176 @@
+# 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: jp\n"
+"Language-Team: jp <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.16.0\n"
+
+#: ../../../docs/configuring-playbook-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 ""
+