doc: add German (de) documentation translations

doc/scan_po_issues.py

@@ -20,6 +20,10 @@
     "翻译如下",
     "以下は翻訳",
     "traducción solicitada",
+    "übersetzung:",
+    "german translation",
+    "deutsche übersetzung",
+    "hier ist die übersetzung",
 )
 
 

doc/source/locale/de/LC_MESSAGES/development/contributing_codebase.po

@@ -0,0 +1,248 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2023, Xorbits Inc.
+# This file is distributed under the same license as the Xinference package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Xinference\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2024-03-07 15:03+0800\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: de <LL@li.org>\n"
+"Language: de\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Generated-By: Babel 2.18.0\n"
+
+#: ../../source/development/contributing_codebase.rst:3
+msgid "Contributing to the code base"
+msgstr "Beitrag zur Codebase"
+
+#: ../../source/development/contributing_codebase.rst:6
+msgid "Table of contents:"
+msgstr "Inhaltsverzeichnis:"
+
+#: ../../source/development/contributing_codebase.rst:9
+msgid "Code standards"
+msgstr "Code-Konventionen"
+
+#: ../../source/development/contributing_codebase.rst:11
+msgid ""
+"Writing good code is not just about what you write. It is also about *how* "
+"you write it. During Continuous Integration testing, several tools will be "
+"run to check your code for stylistic errors. Good style is a requirement for"
+" submitting code to Xinference."
+msgstr ""
+"Guten Code zu schreiben bedeutet nicht nur, *was* Sie schreiben, sondern "
+"auch, *wie* Sie es schreiben. Während der Continuous-Integration-Tests "
+"überprüfen mehrere Tools Ihren Code auf Stilfehler. Ein guter "
+"Programmierstil ist eine Voraussetzung für das Einreichen von Code bei "
+"Xinference."
+
+#: ../../source/development/contributing_codebase.rst:15
+msgid ""
+"In addition, it is important that we do not make sudden changes to the code "
+"that could have the potential to break a lot of user code as a result. "
+"Therefore we need it to be as backwards compatible as possible to avoid mass"
+" breakages."
+msgstr ""
+"Zudem sollten Sie keine plötzlichen Änderungen am Code vornehmen, da dies "
+"bei vielen Benutzerprogrammen zu Problemen führen kann. Daher müssen wir die"
+" Abwärtskompatibilität so weit wie möglich wahren, um großflächige Ausfälle "
+"zu vermeiden."
+
+#: ../../source/development/contributing_codebase.rst:20
+msgid "Autofixing formatting errors"
+msgstr "Automatische Korrektur von Formatierungsfehlern"
+
+#: ../../source/development/contributing_codebase.rst:22
+msgid ""
+"Moreover, Continuous Integration will run code formatting checks like "
+"``black``, ``flake8``, ``isort``, and others using `pre-commit hooks "
+"<https://pre-commit.com/>`_ Any warnings generated by these checks will "
+"cause the Continuous Integration to fail. Therefore, it is advisable to run "
+"the check yourself before submitting code. This can be done by installing "
+"``pre-commit``::"
+msgstr ""
+"Darüber hinaus wird CI `pre-commit hooks <https://pre-commit.com/>`_ "
+"verwenden, um Code-Formatierungsprüfungen wie ``black``, ``flake8``, "
+"``isort`` auszuführen. Jegliche Warnungen, die von diesen Prüfungen erzeugt "
+"werden, führen zu einem CI-Fehler. Daher wird empfohlen, diese Prüfungen vor"
+" dem Einreichen von Code selbst durchzuführen. Dies kann durch die "
+"Installation von ``pre-commit`` im Stammverzeichnis des Xinference-"
+"Repositorys erfolgen::"
+
+#: ../../source/development/contributing_codebase.rst:30
+msgid "and then running::"
+msgstr "Dann führen Sie den Befehl aus::"
+
+#: ../../source/development/contributing_codebase.rst:34
+msgid ""
+"from the root of the Xinference repository. This setup ensures that all "
+"styling checks are automatically executed each time you commit changes "
+"without your needing to run each one manually. In addition, using ``pre-"
+"commit`` will also allow you to more easily remain up-to-date with our code "
+"checks as they change."
+msgstr ""
+"Nach der Installation wird sichergestellt, dass bei jedem Einreichen von "
+"Änderungen automatisch alle Stilprüfungen durchgeführt werden, ohne dass "
+"diese manuell einzeln ausgeführt werden müssen. Darüber hinaus erleichtert "
+"die Verwendung von ``pre-commit`` es, auf dem neuesten Stand unserer Code-"
+"Überprüfungen zu bleiben, wenn sich diese ändern."
+
+#: ../../source/development/contributing_codebase.rst:39
+msgid ""
+"Note that if needed, you can skip these checks with ``git commit --no-"
+"verify``."
+msgstr ""
+"Beachten Sie, dass Sie diese Prüfungen bei Bedarf mit dem Befehl ``git "
+"commit --no-verify`` überspringen können."
+
+#: ../../source/development/contributing_codebase.rst:41
+msgid ""
+"If you don't want to use ``pre-commit`` as part of your workflow, you can "
+"still use it to run its checks with::"
+msgstr ""
+"Wenn Sie ``pre-commit`` nicht als Teil Ihres Workflows nutzen möchten, "
+"können Sie es dennoch mit folgendem Befehl zur Überprüfung ausführen::"
+
+#: ../../source/development/contributing_codebase.rst:46
+#: ../../source/development/contributing_codebase.rst:52
+msgid "without needing to have done ``pre-commit install`` beforehand."
+msgstr "ohne vorher ``pre-commit install`` ausführen zu müssen."
+
+#: ../../source/development/contributing_codebase.rst:48
+msgid ""
+"If you want to run checks on all recently committed files on upstream/main "
+"you can use::"
+msgstr ""
+"Wenn Sie die Überprüfung für alle kürzlich auf upstream/main eingereichten "
+"Dateien durchführen möchten, können Sie den folgenden Befehl verwenden::"
+
+#: ../../source/development/contributing_codebase.rst:56
+msgid ""
+"You may consider periodically running ``pre-commit gc`` to clean up repos "
+"which are no longer used."
+msgstr ""
+"Sie können in Erwägung ziehen, den Befehl ``pre-commit gc`` regelmäßig "
+"auszuführen, um nicht mehr benötigte Repositorys zu bereinigen."
+
+#: ../../source/development/contributing_codebase.rst:61
+msgid ""
+"If you have conflicting installations of ``virtualenv``, if could lead to "
+"errors - refer to `here <https://github.com/pypa/virtualenv/issues/1875>`_."
+msgstr ""
+"Wenn Sie miteinander in Konflikt stehende Installationen von ``virtualenv`` "
+"haben, kann dies zu Fehlern führen – siehe `hier "
+"<https://github.com/pypa/virtualenv/issues/1875>`_."
+
+#: ../../source/development/contributing_codebase.rst:64
+msgid ""
+"Also, due to a `bug in virtualenv "
+"<https://github.com/pypa/virtualenv/issues/1986>`_, you may run into issues "
+"if you're using conda. To solve this, you can downgrade ``virtualenv`` to "
+"version ``20.0.33``."
+msgstr ""
+"Außerdem könnten Sie aufgrund eines `Fehlers "
+"<https://github.com/pypa/virtualenv/issues/1986>`_ in ``virtualenv`` auf "
+"Probleme stoßen, wenn Sie conda verwenden. Um dieses Problem zu beheben, "
+"können Sie ``virtualenv`` auf die Version ``20.0.33`` downgraden."
+
+#: ../../source/development/contributing_codebase.rst:69
+msgid "Backwards compatibility"
+msgstr "Rückwärtskompatibilität"
+
+#: ../../source/development/contributing_codebase.rst:71
+msgid ""
+"Please try to maintain backward compatibility. If you think breakage is "
+"necessary, clearly state why as part of the pull request. Also, be careful "
+"when changing method signatures and add deprecation warnings where needed. "
+"Also, add the deprecated sphinx directive to the deprecated functions or "
+"methods."
+msgstr ""
+"Bitte bemühen Sie sich um weitestgehende Abwärtskompatibilität. Wenn Sie der"
+" Meinung sind, dass eine Änderung unvermeidbar ist, erläutern Sie die Gründe"
+" bitte klar im Pull-Request. Gehen Sie zudem vorsichtig bei Änderungen von "
+"Methodensignaturen vor und fügen Sie bei Bedarf Deprecation-Warnungen hinzu."
+" Fügen Sie außerdem für veraltete Funktionen oder Methoden die entsprechende"
+" Sphinx-Direktive für Deprecation hinzu."
+
+#: ../../source/development/contributing_codebase.rst:76
+msgid "You'll also need to"
+msgstr "Außerdem müssen Sie:"
+
+#: ../../source/development/contributing_codebase.rst:78
+msgid ""
+"Write a new test that asserts a warning is issued when calling with the "
+"deprecated argument"
+msgstr ""
+"Schreiben Sie einen neuen Testfall, der eine Warnung ausgibt, wenn eine "
+"Methode mit einem veralteten Parameter aufgerufen wird."
+
+#: ../../source/development/contributing_codebase.rst:79
+msgid ""
+"Update all of Xinference existing tests and code to use the new argument"
+msgstr ""
+"Aktualisieren Sie alle vorhandenen Testfälle und den Code von Xinference, "
+"um die neuen Parameter zu verwenden."
+
+#: ../../source/development/contributing_codebase.rst:82
+msgid "Type hints"
+msgstr "Typ-Hinweise"
+
+#: ../../source/development/contributing_codebase.rst:84
+msgid ""
+"Xinference strongly encourages the use of :pep:`484` style type hints. New "
+"development should contain type hints and pull requests to annotate existing"
+" code are accepted as well!"
+msgstr ""
+"Xinference ermutigt ausdrücklich die Verwendung von Typannotationen im "
+":pep:`484`-Stil. Neue Entwicklungen sollten Typannotationen enthalten, und "
+"Pull-Requests, die bestehenden Code mit Annotationen versehen, sind "
+"ebenfalls willkommen!"
+
+#: ../../source/development/contributing_codebase.rst:88
+msgid "Test-driven development"
+msgstr "Testgetriebene Entwicklung"
+
+#: ../../source/development/contributing_codebase.rst:90
+msgid ""
+"Xinference is serious about testing and strongly encourages contributors to "
+"embrace `test-driven development (TDD) <https://en.wikipedia.org/wiki/Test-"
+"driven_development>`_. This development process \"relies on the repetition "
+"of a very short development cycle: first the developer writes an (initially "
+"failing) automated test case that defines a desired improvement or new "
+"function, then produces the minimum amount of code to pass that test.\" So, "
+"before actually writing any code, you should write your tests. Often the "
+"test can be taken from the original GitHub issue. However, it is always "
+"worth considering additional use cases and writing corresponding tests."
+msgstr ""
+"Xinference legt großen Wert auf Tests und ermutigt Mitwirkende "
+"nachdrücklich, die `Testgetriebene Entwicklung (TDD) "
+"<https://en.wikipedia.org/wiki/Test-driven_development>`_ zu übernehmen. "
+"Dieser Entwicklungsprozess „beruht auf der Wiederholung sehr kurzer "
+"Entwicklungszyklen: Zunächst schreibt der Entwickler einen automatisierten "
+"Testfall (der anfangs fehlschlägt), um die gewünschte Verbesserung oder neue "
+"Funktion zu definieren, und verwendet dann die minimale Code-Menge, um "
+"diesen Test zu bestehen.“ Daher sollten Sie Ihre Testfälle schreiben, bevor "
+"Sie tatsächlich Code schreiben. In der Regel können Testfälle aus dem "
+"ursprünglichen GitHub-Issue entnommen werden. Es ist jedoch lohnenswert, "
+"zusätzliche Fälle zu bedenken und entsprechende Testfälle zu schreiben."
+
+#: ../../source/development/contributing_codebase.rst:99
+msgid ""
+"Adding tests is frequently requested after code is pushed to Xinference. "
+"Thus, it is worth getting in the habit of writing tests ahead of time so "
+"this is never an issue."
+msgstr ""
+"Nach dem Pushen von Code an Xinference wird häufig das Hinzufügen von "
+"Testfällen verlangt. Daher ist es sehr wichtig, sich die Gewohnheit "
+"anzueignen, Testfälle im Voraus zu schreiben, damit keine Probleme "
+"auftreten."
+
+#~ msgid "Pre-commit"
+#~ msgstr "Pre-commit"