deploy versions

Author: BookWyrm Bot

locale/de_DE/content/contributing/documentation.md

@@ -1,77 +1,77 @@
 ---
-Title: Documentation
+Title: Dokumentation
 Date: 2025-04-09
 Order: 4
 ---
 
-The documentation you are reading right now is maintained by the BookWyrm community. Anyone can contribute to the docs.
+Die Dokumentation, die du gerade liest, wird von der BookWyrm-Community gepflegt. Jede Person kann zur Dokumentation beitragen.
 
-## Suggesting an improvement
+## Eine Verbesserung vorschlagen
 
-You can report an **error**, suggest an **improvement** or request an **addition** to the documentation by [creating an issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue) in [the documentation repository](https://github.com/bookwyrm-social/documentation).
+Du kannst einen **Fehler** (engl. error) melden, eine **Verbesserung** (engl. improvement) vorschlagen oder eine **Ergänzung** (engl. addition) zur Dokumentation anfragen, indem du [einen Issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue) im [Dokumentations-Repository](https://github.com/bookwyrm-social/documentation) anlegst.
 
-## How the docs are made
+## Wie die Dokumentation erstellt wird
 
-The Documentation [has its own GitHub repository](https://github.com/bookwyrm-social/documentation). Documentation is written in Markdown and we use [Jinja](https://jinja.palletsprojects.com/en/stable) and a Python script to convert that into HTML. A Jinja plugin is used with Crowdin to create translations. All documentation source files should be written in English (US).
+Die Dokumentation [hat ihr eigenes GitHub-Repository](https://github.com/bookwyrm-social/documentation). Sie wird in Markdown verfasst und wir nutzen [Jinja](https://jinja.palletsprojects.com/en/stable) und ein Python-Skript, um sie in HTML umzuwandeln. Ein Jinja-Plugin wird gemeinsam mit Crowdin genutzt, um Übersetzungen zu erstellen. Alle Quelldateien der Dokumentation sollen in US-Englisch verfasst werden.
 
-All source files are saved in the `content` directory. Each section has a directory within that, with each page being represented by a single markdown file.
+Alle Quelldatein werden im `content`-Verzeichnis abgelegt. Jeder Abschnitt hat darin ein Verzeichnis, wobei jede Seite durch eine einzelne Markdown-Datei abgebildet wird.
 
-## Editing or creating a documentation page
+## Dokumentationsseiten bearbeiten oder anlegen
 
-To edit or create a new page you will need to:
+Um eine neue Seite anzulegen, ist Folgendes notwendig:
 
-1. clone [the GitHub repository](https://github.com/bookwyrm-social/documentation)
-2. work in the `content` directory to make your changes - either editing an existing markdown page or creating a new one
-3. create a new Pull Request
-4. respond to any reviews with further edits
-5. enjoy seeing your updates instantly published when your pull request is approved and merged
+1. klone [das GitHub-Repository](https://github.com/bookwyrm-social/documentation)
+2. arbeite im `content`-Verzeichnis, um deine Änderungen vorzunehmen – indem du entweder eine bestehende Markdown-Seite anpasst oder eine neue erstellst
+3. erstelle eine neue Pull Request
+4. nimm weitere Änderungen vor, wenn du Rückmeldungen erhältst
+5. genieße, wie deine Änderungen sofort veröffentlicht werden, sobald deine Pull Request angenommen und gemerget wurde
 
-If you have never used git or GitHub before, that may sound daunting, but let's break it down:
+Wenn du noch nie Git oder GitHub verwendet hast, mag das alles beängstigend klingen, aber lass es uns herunterbrechen:
 
-### Clone the repository
+### Klone das Repository
 
-1. Make sure you have [a GitHub account](https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github).
-2. Create a "clone" or "fork" of the Documentation repository:
+1. Stelle sicher, dass du [einen GitHub-Account](https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github) hast.
+2. Erstelle einen "Klon" oder "Fork" des Dokumentations-Repositorys:
 
-   - From the **web interface**, click "Fork" at the top of [this page](https://github.com/bookwyrm-social/documentation)
-   - If you are using **GitHub Desktop**, follow [these instructions](https://docs.github.com/en/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)
-   - If you are using the command line, run:
+   - Auf der **Web-Oberfläche** klicke "Fork" am oberen Rand [dieser Seite](https://github.com/bookwyrm-social/documentation)
+   - Wenn du **GitHub Desktop** verwendest, folge [diesen Anweisungen](https://docs.github.com/en/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)
+   - Wenn du die Kommandozeile nutzt, führe aus:
 
    `git clone https://github.com/bookwyrm-social/documentation.git`
 
-### Create a new branch and make your edits
+### Einen neuen Branch erstellen und Änderungen vornehmen
 
-To make changes:
+Um Änderungen vorzunehmen:
 
-1. [Create a new branch](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-a-branch-for-an-issue) in your fork
-2. Make your edits in the `content` directory and **commit** your changes:
-   - [GitHub web interface](https://docs.github.com/en/repositories/working-with-files/managing-files/editing-files)
+1. [Erstelle einen neuen Branch](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-a-branch-for-an-issue) in deinem Fork
+2. Nimm deine Änderungen am `content`-Verzeichnis vor und **commite** sie:
+   - [GitHub-Web-Oberfläche](https://docs.github.com/en/repositories/working-with-files/managing-files/editing-files)
    - [GitHub Desktop](https://docs.github.com/en/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)
-   - On the command line save your changes to the files and run `git commit`
+   - In der Kommandozeile, speichere deine Änderungen an den Dateien und führe `git commit` aus
 
-At this point you might want to see what your changes will look like when published. See [Building docs locally](#building-docs-locally) below for instruction on how to preview your changes.
+An dieser Stelle wirst du vielleicht sehen wollen, wie deine Änderungen aussehen, wenn sie veröffentlicht werden. Schau dir [Dokumentation lokal bauen](#building-docs-locally) weiter unten an, um zu erfahren, wie du eine Vorschau deiner Änderungen ansehen kannst.
 
-### Create a pull request
+### Eine Pull Request erstellen
 
-Once you have completed your changes, [make a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) to the docs repository.
+Wenn deine Änderungen abgeschlossen sind, [erstelle eine Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) an das Dokumentations-Repository.
 
-Your pull request will be reviewed and one of three things will happen:
+Deine Pull Request wird überprüft werden und eines der drei folgenden Szenarien wird eintreten:
 
-1. It will be **merged** with no changes
-2. You will be asked to make **changes**
-3. It will be **rejected** and closed
+1. Sie wird ohne Änderungen **übernommen** (engl. merged)
+2. Du wirst gebeten, **Änderungen** vorzunehmen
+3. Sie wird **abgelehnt** und geschlossen
 
-### Respond to reviews
+### Auf Überprüfungen reagieren
 
-If you are asked to make changes, you can make them locally and `push` your local changes to your fork/clone on GitHub. This will automatically flow through to your pull request. Let the reviewer know when you have completed your updates so they can do another review and hopefully "pull" your changes.
+Wenn du gebeten wirst, Änderungen vorzunehmen, kannst du dies lokal erledigen und deine lokalen Änderungen an deinen Fork/Klon auf Github senden (engl. `push`). Sie werden dann automatisch in deine Pull Request übernommen. Lass den\*die Reviewer\*in wissen, wenn du mit deinen Anpassungen fertig bist, damit die Person eine weitere Überprüfung starten und dann hoffentlich deine Änderungen zu sich holen (engl. `pull`) kann.
 
-We welcome all contributions. It would be unusual for a contribution to the docs to be rejected immediately. This would only happen if your pull request introduces information that is wrong or misleading with no chance of being improved, or if it has been declared out of scope.
+Wir heißen alle Beiträge willkommen. Es wäre ungewöhnlich, wenn ein Beitrag zur Dokumentation direkt abgelehnt würde. Das würde nur dann geschehen, wenn deine Pull Request Informationen einfügt, die falsch oder irreführend ohne Aussicht auf Besserung sind oder wenn festgestellt wird, dass sie aus dem Rahmen fällt.
 
-### Your changes are published
+### Deine Änderungen werden veröffentlicht
 
-When your pull request is merged, [the documentation](https://docs.joinbookwyrm.com/) is automatically updated. You may need to refresh your browser or use "incognito mode" to see the changes in your browser.
+Wenn deine Pull Request übernommen wird, wird [die Dokumentation](https://docs.joinbookwyrm.com/) automatisch aktualisiert. Es kann sein, dass du deinen Browser neu starten oder den "Inkognito-Modus" nutzen musst, um die Änderungen in deinem Browser zu sehen.
 
-## New pages
+## Neue Seiten
 
 If you are adding a new page, you will need to add some metadata and may need to adjust other pages.
 

locale/de_DE/content/contributing/install-dev.md

@@ -4,51 +4,53 @@ Title: Entwicklungsumgebung Date: 2025-05-12 Order: 5
 
 ## Voraussetzungen
 
-Diese Anleitung geht davon aus, dass du BookWyrm mit Docker entwickelst. Du musst [Docker](https://docs.docker.com/engine/install/) und [docker-compose](https://docs.docker.com/compose/install/) installieren, bevor Du loslegst.
+Diese Anleitung geht davon aus, dass du BookWyrm mit Docker entwickelst. Du musst [Docker](https://docs.docker.com/engine/install/) und [docker-compose](https://docs.docker.com/compose/install/) installieren, bevor du loslegst.
+
+_Wenn du zu BookWyrm beiträgst, ohne Docker zu verwenden, würden wir uns freuen, wenn du uns helfen würdest, [diese Anleitung zu aktualisieren](/documentation.html), damit sie auch eine Hilfestellung enthält, wie eine Entwicklungsumgebung ohne Docker aufgesetzt werden kann_.
 
 ## Entwicklungsumgebung einrichten
 
-### Den Quellcode erhalten
+### Quellcode erhalten
 
 1. Kopiere den [BookWyrm-Quellcode von GitHub](https://github.com/bookwyrm-social/bookwyrm). Du kannst [einen Fork](https://docs.github.com/en/get-started/quickstart/fork-a-repo) des Projekts erstellen und [dann `git clone` ausführen, um den Quellcode](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github/cloning-a-repository) auf deinen Computer herunterzuladen.
-2. Gehe in das Verzeichnis, das den Quellcodeode auf Ihrem Computer enthält. Von jetzt an arbeitest Du aus diesem Verzeichnis heraus.
+2. Gehe in das Verzeichnis auf deinem Computer, das den Quellcode enthält. Von jetzt an arbeitest du in diesem Verzeichnis.
 3. Die Entwicklung wird auf dem `main`-Branch durchgeführt. Stelle also sicher, dass du diesen Branch ausgecheckt hast: `git checkout main`
-4. Erstelle eine Datei für Umgebungsvariablen für die Entwicklung durch Kopieren der Beispieldatei für Umgebungsvariablen (`.env.example`) in eine neue Datei namens `.env` ein. Falls Du die Kommandozeile nutzt, kannst du das wie folgt tun:
+4. Erstelle eine Datei mit Umgebungsvariablen für die Entwicklung, indem du die Beispieldatei (`.env.example`) kopierst und als neue Datei namens `.env` einfügst. In der Kommandozeile kannst du das wie folgt tun:
 ``` { .sh }
 cp .env.example .env
 ```
 
-### Configure your environment settings
+### Umgebung konfigurieren
 
-In `.env`:
+In der Datei `.env`:
 
-4. change `DEBUG` to `true`
-5. If you use a tunneling/proxy service like [ngrok](https://ngrok.com), set `DOMAIN` to to the domain name you are using (e.g. `abcd-1234.ngrok-free.app`). Otherwise, set `DOMAIN` to `localhost`
-6. change `NGINX_SETUP` to `reverse_proxy` (this prevents BookWyrm trying to set up https certificates on your development machine)
-7. If you need to use a particular port (e.g. if you are tunneling via ngrok), uncomment `PORT` and set it (e.g. `PORT=1333`). If using `localhost` this is optional.
+4. Ändere `DEBUG` zu `true`
+5. Wenn du einen Tunneling-Dienst oder Proxy wie [ngrok](https://ngrok.com) verwendest, ändere die `DOMAIN` zu der Domain, die du verwendest (z. B. `abcd-1234.ngrok-free.app`). Andernfalls, ändere `DOMAIN` zu `localhost`
+6. Ändere `NGINX_SETUP` zu `reverse_proxy` (dies verhindert, dass BookWyrm versucht, HTTPS-Zertifikate auf deinem Entwicklungsgerät zu erstellen)
+7. Wenn du einen bestimmten Port verwenden möchtest (z. B. wenn du Anfragen durch ngrok tunnelst), entferne den Kommentar vor `PORT` und gib den Port an (z. B. `PORT=1333`). Wenn du `localhost` nutzt, ist dieser Schritt optional.
 
-Check that you have [all the required settings configured](/environment.html#required-environment-settings) before proceeding.
+Prüfe, ob du [alle notwendigen Einstellungen getroffen hast](/environment.html#required-environment-settings), bevor du fortfährst.
 
-If you try to register your admin account and see a message that `CSRF verification failed` you may have set your domain or port incorrectly.
+Wenn du versuchst, deinen Administrations-Account anzulegen, und eine Nachricht siehst, die `CSRF verification failed` lautet, kann es sein, dass du die Domain oder den Port falsch angegeben hast.
 
-### Email (optional)
+### E-Mail (optional)
 
-If you want to test sending emails, you will need to [set up appropriate real values](/environment.html#email-configuration) in the "Email config" section. You do not need to change anything for [the separate `EMAIL` setting](/environment.html#email).
+Wenn du ausprobieren möchtest, E-Mails zu versenden, wirst du [passende, echte Werte](/environment.html#email-configuration) im Bereich "E-Mail-Konfiguration" angeben müssen. Du musst nichts an der [separaten Einstellung `EMAIL`](/environment.html#email) ändern.
 
-### Build and run
+### Bauen und ausführen
 
 8. Führe Folgendes über die Kommandozeile aus:
 
 ``` { .sh }
-./bw-dev build            # Build the docker images
-./bw-dev setup            # Initialize the database and run migrations. Note the ADMIN key at the end of this output. You'll need it to register the first admin user.
-./bw-dev up               # Start the docker containers
+./bw-dev build            # Docker-Images bauen
+./bw-dev setup            # Datenbank initialisieren und Migrationen ausführen. Notiere dir den Administrations-Schlüssel am Ende der Ausgabe. Du wirst ihn brauchen, um einen Administrations-Account anzulegen.
+./bw-dev up               # Docker-Container starten
 ```
 
-9. Once the build is complete, you can access the instance at `http://localhost`, your ngrok domain, or `http://localhost:{PORT}`, depending on you domain and port configuration.
-10. You can now enter your admin key and create an admin user. From here everything is the same as described in "Running BookWyrm".
+9. Sobald der Build abgeschlossen ist, kannst du die Instanz unter `http://localhost`, unter deiner ngrok-Domain oder unter `http://localhost:{PORT}` erreichen, abhängig von deiner Domain- und Port-Einstellung.
+10. Du kannst nun deinen Administrations-Schlüssel eingeben und einen Administrations-Account anlegen. Ab hier funktioniert alles so, wie es in "BookWyrm betreiben" beschrieben ist.
 
-Wenn du neugierig bist: das `./bw-dev` Kommando ist ein simples Shell-Script, das verschiedene Tools ansteuert: darüber hinaus könntest du es überspringen und direk `docker-compose build` oder `docker-compose up` laufen lassen, wenn du magst. `./bw-dev` sammelt sie einfach an einem gemeinsamen Ort zur Bequemlichkeit. Run it without arguments to get a list of available commands, read the [documentation page](/cli.html) for it, or open it up and look around to see exactly what each command is doing!
+Wenn du neugierig bist: Das `./bw-dev`-Kommando ist ein simples Shell-Script, das verschiedene andere Tools ansteuert. Du könntest es überspringen und direkt `docker-compose build` oder `docker-compose up` laufen lassen, wenn du möchtest. `./bw-dev` kombiniert diese Aufrufe der Einfachheit halber an einem gemeinsamen Ort. Führe das Skript ohne Argumente aus, um eine Liste der verfügbaren Kommandos zu erhalten, lies die [zugehörige Seite in der Dokumentation](/cli.html) oder öffne das Skript und sieh genau, was jedes Kommando tut!
 
 ## Modelle editieren oder erstellen
 
@@ -65,4 +67,4 @@ Jedes Mal, wenn du CSS oder JavaScript bearbeitest, musst du Djangos `collectsta
 ./bw-dev collectstatic
 ```
 
-Wenn du [yarn installierstt](https://yarnpkg.com/getting-started/install) haben, kannst du `yarn watch:static` ausführen, um das vorherige Skript bei jeder Änderung automatisch im Verzeichnis `bookwyrm/static` auszuführen.
+Wenn du [yarn installiert](https://yarnpkg.com/getting-started/install) hast, kannst du `yarn watch:static` ausführen, um das vorherige Skript bei jeder Änderung automatisch im Verzeichnis `bookwyrm/static` ausführen zu lassen.

locale/de_DE/content/running_bookwyrm/install-prod-dockerless.md

@@ -59,7 +59,7 @@ chown www-data:www-data /var/cache/nginx
      - Lade Nginx neu: `systemctl reload nginx`
 - Einrichtung der virtuellen Python-Umgebung
     - Make the python venv directory in your install dir: `python3 -m venv ./venv`
-    - Installiere die Python-Abhängigkeiten für Bookwyrm via pip mit folgendem Befehl: `./venv/bin/pip3 install -r requirements.txt`
+    - Install bookwyrm python dependencies with pip: `./venv/bin/pip3 install --upgrade "pip>=25.1.0"` `./venv/bin/pip3 install --group main`
 - Erstelle die Bookwyrm PostgreSQL-Datenbank. Make sure to change the password to what you set in the `.env` config: `sudo -i -u postgres psql`
 
 ``` { .sql }

locale/de_DE/content/running_bookwyrm/updating-dockerless.md

@@ -0,0 +1,21 @@
+---
+Title: Updating Without Docker
+Date: 2023-01-29
+Order: 4
+---
+
+Follow this guide if you have a BookWyrm installation without Docker and
+there are changes available in the production branch.
+
+This guide assumes that your setup followed the latest [Installation without Docker](/install-prod-dockerless.html) guide.
+
+Run all the following commands, except otherwise noted, as the `bookwyrm` user:
+
+1. Pull in the latest changes on the `production` branch with `git pull`
+2. Install potential new Python dependencies:
+   - `./venv/bin/pip3 install --upgrade "pip>=25.1.0"`
+   - `./venv/bin/pip3 install --group main`
+3. Compile the themes with `venv/bin/python3 manage.py compile_themes`
+4. Collecting all the static files with `venv/bin/python3 manage.py collectstatic --no-input` – this also uploads them to [external storage](/external-storage.html) if you have this configured
+5. Migrate the database (it's advisable to create a backup before) with `venv/bin/python3 manage.py migrate`
+6. Restart the `systemd` services with `sudo systemctl restart bookwyrm bookwyrm-worker bookwyrm-scheduler`

locale/en_Oulipo/content/contributing/install-dev.md

@@ -6,6 +6,8 @@ Title: Developer Environment Date: 2025-05-26 Order: 5
 
 These instructions assume you are developing BookWyrm using Docker. You'll need to [install Docker](https://docs.docker.com/engine/install/) and [docker-compose](https://docs.docker.com/compose/install/) to get started.
 
+_If you are contributing to BookWyrm in a dockerless development environment we would love for you to [help us update this guide](/documentation.html) to include instructions for setting up a dockerless development environment_.
+
 ## Setting up the developer environment
 
 ### Get the code

locale/en_Oulipo/content/running_bookwyrm/install-prod-dockerless.md

@@ -59,7 +59,7 @@ chown www-data:www-data /var/cache/nginx
      - Reload nginx: `systemctl reload nginx`
 - Setup the python virtual enviroment
     - Make the python venv directory in your install dir: `python3 -m venv ./venv`
-    - Install bookwyrm python dependencies with pip: `./venv/bin/pip3 install -r requirements.txt`
+    - Install bookwyrm python dependencies with pip: `./venv/bin/pip3 install --upgrade "pip>=25.1.0"` `./venv/bin/pip3 install --group main`
 - Make the bookwyrm postgresql database. Make sure to change the password to what you set in the `.env` config: `sudo -i -u postgres psql`
 
 ``` { .sql }