Merge pull request #399 from damoasda/master

Neue Übersetzungen und Korrekturen

Author: damoasda

.github/workflows/pages-update.yml

@@ -16,7 +16,7 @@ jobs:
           toolchain: stable
 
       - name: Install mdbook
-        run: cargo install mdbook --vers "^0.4.40" --no-default-features
+        run: cargo install mdbook --vers "^0.5.2" --no-default-features
 
       - name: Build Book
         run: mdbook build

README.md

@@ -14,7 +14,7 @@ Die deutsche Übersetzung gibt es auch als **Taschenbuch** und als **E-Book**:
 
 Schritte zum Bauen und Anschauen des Buchs:
 
-1. mdBook installieren: `cargo install mdbook --vers "^0.4.47"`
+1. mdBook installieren: `cargo install mdbook --vers "^0.5.2"`
 2. Live-Vorschau-Server starten: `mdbook serve`
 3. http://localhost:3000/ im Browser öffnen
 

src/SUMMARY.md

@@ -138,6 +138,6 @@
   - [B - Operatoren und Symbole](appendix-02-operators.md)
   - [C - Ableitbare Merkmale (traits)](appendix-03-derivable-traits.md)
   - [D - Nützliche Entwicklungswerkzeuge](appendix-04-useful-development-tools.md)
-  - [E - Ausgaben](appendix-05-editions.md)
+  - [E - Editionen](appendix-05-editions.md)
   - [F - Übersetzungen des Buchs](appendix-06-translation.md)
   - [G - Wie Rust erstellt wird und „nächtliches Rust“](appendix-07-nightly-rust.md)

src/appendix-01-keywords.md

@@ -3,13 +3,11 @@
 Die folgende Liste enthält Schlüsselwörter, die für die gegenwärtige oder
 zukünftige Verwendung durch die Sprache Rust reserviert sind. Als solche können
 sie nicht als Bezeichner verwendet werden (außer als Roh-Bezeichner, die wir im
-Abschnitt [„Roh-Bezeichner“][raw-identifiers] besprechen werden). Bezeichner
+Abschnitt [„Roh-Bezeichner“][raw-identifiers] besprechen). _Bezeichner_
 sind Namen von Funktionen, Variablen, Parametern, Strukturfeldern
 (struct fields), Modulen, Kisten (crates), Konstanten, Makros, statischen
 Werten, Attributen, Typen, Merkmalen (traits) und Lebensdauern (lifetimes).
 
-[raw-identifiers]: #roh-bezeichner
-
 ### Derzeit verwendete Schlüsselwörter
 
 Nachstehend findest du eine Liste der derzeit verwendeten Schlüsselwörter mit
@@ -143,12 +141,13 @@ uns mehr Freiheit bei der Wahl der Bezeichner und ermöglicht uns die
 Integration in Programme, die in einer Sprache geschrieben wurden, in der diese
 Wörter keine Schlüsselwörter sind. Darüber hinaus ermöglicht dir der
 Roh-Bezeichner das Verwenden von Bibliotheken, die in einer anderen
-Rust-Ausgabe, als deine Kiste verwendet, geschrieben wurden. Zum Beispiel ist
-`try` in Ausgabe 2015 kein Schlüsselwort, in den Ausgaben 2018, 2021 und 2024
-aber schon. Wenn du auf eine Bibliothek angewiesen bist, die mit Ausgabe 2015
+Rust-Edition, als deine Kiste verwendet, geschrieben wurden. Zum Beispiel ist
+`try` in Edition 2015 kein Schlüsselwort, in den Editionen 2018, 2021 und 2024
+aber schon. Wenn du auf eine Bibliothek angewiesen bist, die mit Edition 2015
 geschrieben wurde und eine Funktion `try` hat, musst du die
 Roh-Bezeichner-Syntax verwenden, in diesem Fall `r#try`, um diese Funktion von
-deinem Code in einer neueren Ausgabe aus aufzurufen. Siehe [Anhang
-E][appendix-e] für weitere Informationen zu Ausgaben.
+deinem Code in einer neueren Edition aus aufzurufen. Siehe [Anhang
+E][appendix-e] für weitere Informationen zu Editionen.
 
 [appendix-e]: appendix-05-editions.html
+[raw-identifiers]: #roh-bezeichner

src/appendix-02-operators.md

@@ -75,7 +75,7 @@ Merkmal (trait) aufgeführt, mit dem dieser Operator überladen werden kann.
 
 ### Nicht-Operator-Symbole
 
-Die folgende Liste enthält alle Symbole, die nicht als Operatoren fungieren,
+Die folgende Tabelle enthält alle Symbole, die nicht als Operatoren fungieren,
 d.h. sich nicht wie ein Funktions- oder Methodenaufruf verhalten.
 
 Tabelle B-2 zeigt Symbole, die für sich allein stehen und an verschiedenen
@@ -102,17 +102,17 @@ Modulhierarchie eines Elements vorkommen.
 
 <span class="caption">Tabelle B-3: Pfad-bezogene Syntax</span>
 
-| Symbol | Erklärung |
-|:-------|:-------------------|
-| `ident::ident` | Namensraum-Pfad |
-| `::path` | Pfad relativ zum externen Präludium, auf dem alle anderen Kisten basieren<br> (d.h. ein explizit absoluter Pfad inklusive Kistenname) |
-| `self::path` | Pfad relativ zum aktuellen Modul<br> (d.h. ein explizit relativer Pfad) |
-| `super::path` | Pfad relativ zum Elternmodul |
-| `type::ident`,<br> `<type as trait>::ident` | Zugehörige Konstanten, Funktionen<br> und Typen |
-| `<type>::...` | Zugehöriges Element für einen Typ,<br> der nicht direkt benannt werden kann<br> (z.B. `<&T>::...`, `<[T]>:::...` usw.) |
-| `trait::method(...)` | Methodenaufruf durch Angeben des<br> Merkmals eindeutig machen |
-| `type::method(...)` | Methodenaufruf durch Angeben des<br> Typs eindeutig machen |
-| `<type as trait>::method(...)` | Methodenaufruf durch Angeben des<br> Merkmals und Typs eindeutig machen |
+| Symbol | Erklärung                                                                                                                       |
+|:-------|:--------------------------------------------------------------------------------------------------------------------------------|
+| `ident::ident` | Namensraum-Pfad                                                                                                                 |
+| `::path` | Pfad relativ zur Kistenwurzel, auf dem alle anderen Kisten basieren<br> (d.h. ein explizit absoluter Pfad inklusive Kistenname) |
+| `self::path` | Pfad relativ zum aktuellen Modul<br> (d.h. ein explizit relativer Pfad)                                                         |
+| `super::path` | Pfad relativ zum Elternmodul                                                                                                    |
+| `type::ident`,<br> `<type as trait>::ident` | Zugehörige Konstanten, Funktionen<br> und Typen                                                                                 |
+| `<type>::...` | Zugehöriges Element für einen Typ,<br> der nicht direkt benannt werden kann<br> (z.B. `<&T>::...`, `<[T]>:::...` usw.)          |
+| `trait::method(...)` | Methodenaufruf durch Angeben des<br> Merkmals eindeutig machen                                                                  |
+| `type::method(...)` | Methodenaufruf durch Angeben des<br> Typs eindeutig machen                                                                      |
+| `<type as trait>::method(...)` | Methodenaufruf durch Angeben des<br> Merkmals und Typs eindeutig machen                                                         |
 
 Tabelle B-4 zeigt Symbole, die im Zusammenhang mit generischen Typparametern
 auftreten.

src/appendix-03-derivable-traits.md

@@ -39,7 +39,8 @@ Die Liste der ableitbaren Merkmale in diesem Anhang ist nicht vollständig:
 Bibliotheken können `derive` für ihre eigenen Merkmale implementieren, sodass
 die Liste der Merkmale, die du mit `derive` verwenden kannst, wahrlich
 unbegrenzt ist. Das Implementieren von `derive` verwendet ein prozedurales
-Makro, das im Abschnitt [„Makros“][macros] in Kapitel 20 behandelt wird.
+Makro, das im Abschnitt [„Wie man ein benutzerdefiniertes Makro mit `derive`
+schreibt“][custom-derive-macros] in Kapitel 20 behandelt wird.
 
 ### `Debug` für die Programmierer-Ausgabe
 
@@ -64,8 +65,8 @@ prüfen und ermöglicht das Verwenden der Operatoren `==` und `!=`.
 
 Das Ableiten von `PartialEq` implementiert die Methode `eq`. Wenn `PartialEq`
 für Strukturen abgeleitet wird, sind zwei Instanzen nur dann gleich, wenn
-_alle_ Felder gleich sind, und die Instanzen sind nicht gleich, wenn wenigstens
-ein Feld nicht gleich ist. Beim Ableiten für Aufzählungen ist jede Variante
+_alle_ Felder gleich sind, und die Instanzen sind nicht gleich, wenn _wenigstens
+ein_ Feld nicht gleich ist. Beim Ableiten für Aufzählungen ist jede Variante
 gleich sich selbst und nicht gleich den anderen Varianten.
 
 Das Merkmal `PartialEq` ist beispielsweise beim Verwenden des Makros
@@ -77,8 +78,8 @@ für jeden Wert des annotierten Typs der Wert gleich sich selbst ist. Das
 Merkmal `Eq` kann nur auf Typen angewandt werden, die auch `PartialEq`
 implementieren, obwohl nicht alle Typen, die `PartialEq` implementieren, `Eq`
 implementieren können. Ein Beispiel dafür sind Fließkomma-Zahlentypen: Die
-Implementierung von Fließkomma-Zahlen besagt, dass zwei Instanzen des
-Keine-Zahl-Wertes (`NaN`) nicht gleichwertig sind.
+Implementierung von Fließkomma-Zahlen besagt, dass zwei Instanzen des Wertes
+`NaN` nicht vergleichbar sind.
 
 Ein Beispiel dafür, wann `Eq` erforderlich ist, ist für Schlüssel in einer
 `HashMap<K, V>`, damit `HashMap<K, V>` erkennen kann, ob zwei Schlüssel gleich
@@ -157,7 +158,7 @@ implementieren. Du kannst das Merkmal `Copy` nur auf Typen anwenden, die auch
 Implementierung von `Clone` hat, das die gleiche Aufgabe wie `Copy` erfüllt.
 
 Das Merkmal `Copy` ist selten erforderlich; Typen, die `Copy` implementieren,
-verfügen über Optimierungen, d. h. du musst nicht `clone` aufrufen, was den
+verfügen über Optimierungen, d.h. du musst nicht `clone` aufrufen, was den
 Code prägnanter macht.
 
 Alles, was mit `Copy` möglich ist, kannst du auch mit `Clone` erreichen, aber
@@ -170,7 +171,7 @@ Das Merkmal `Hash` erlaubt es dir, eine Instanz eines Typs beliebiger Größe zu
 nehmen und diese Instanz mithilfe einer Hash-Funktion auf einen Wert fester
 Größe abzubilden. Das Ableiten von `Hash` implementiert die Methode `hash`. Die
 abgeleitete Implementierung der Methode `hash` kombiniert das Ergebnis des
-Aufrufs von `hash` für alle Teile des Typs, d. h. alle Felder oder Werte müssen
+Aufrufs von `hash` für alle Teile des Typs, d.h. alle Felder oder Werte müssen
 ebenfalls `Hash` implementieren, um `Hash` abzuleiten.
 
 Ein Beispiel dafür, wann `Hash` erforderlich ist, ist das Speichern von
@@ -181,24 +182,24 @@ Schlüsseln in einer `HashMap<K, V>`, um Daten effizient zu speichern.
 Das Merkmal `Default` erlaubt es dir, einen Standardwert für einen Typ zu
 definieren. Das Ableiten von `Default` implementiert die Funktion `default`.
 Die abgeleitete Implementierung der Funktion `default` ruft die Funktion
-`default` für jeden Teil des Typs auf, d. h. alle Felder oder Werte in dem Typ
+`default` für jeden Teil des Typs auf, d.h. alle Felder oder Werte in dem Typ
 müssen auch `Default` implementieren, um `Default` abzuleiten.
 
 Die Funktion `Default::default` wird häufig in Kombination mit der Syntax zur
 Aktualisierung von Strukturen verwendet, die im Abschnitt [„Instanzen aus
 anderen Instanzen erzeugen mit der
-Strukturaktualisierungssyntax“][creating-instances-from-other-instances-with-struct-update-syntax]
+Strukturaktualisierungssyntax“][struct-update-syntax]
 in Kapitel 5 besprochen wird. Du kannst einige Felder einer Struktur anpassen
 und dann einen Standardwert für den Rest der Felder festlegen und verwenden,
 indem du `...Default::default()` schreibst.
 
 Das Merkmal `Default` ist erforderlich, wenn du die Methode `unwrap_or_default`
-z. B. auf Instanzen von `Option<T>` verwendest. Wenn die `Option<T>` den Wert
+z.B. auf Instanzen von `Option<T>` verwendest. Wenn die `Option<T>` den Wert
 `None` hat, gibt die Methode `unwrap_or_default` das Ergebnis von
 `Default::default` für den Typ `T` zurück, der in `Option<T>` gespeichert ist.
 
-[creating-instances-from-other-instances-with-struct-update-syntax]: ch05-01-defining-structs.html#instanzen-aus-anderen-instanzen-erzeugen-mit-der-strukturaktualisierungssyntax
-[macros]: ch20-05-macros.html
+[custom-derive-macros]: ch20-05-macros.html#wie-man-ein-benutzerdefiniertes-makro-mit-derive-schreibt
 [stack-only-data-copy]: ch04-01-what-is-ownership.html#nur-stapelspeicher-daten-kopieren-copy
 [std-lib]: https://doc.rust-lang.org/std/index.html
+[struct-update-syntax]: ch05-01-defining-structs.html#instanzen-aus-anderen-instanzen-erzeugen-mit-der-strukturaktualisierungssyntax
 [ways-variables-and-data-interact-clone]: ch04-01-what-is-ownership.html#variablen-und-daten-im-zusammenspiel-mit-clone

src/appendix-04-useful-development-tools.md

@@ -95,7 +95,7 @@ Die Variable `x` ist jetzt unveränderlich, und die Warnung erscheint nicht
 mehr.
 
 Du kannst den Befehl `cargo fix` auch dazu verwenden, deinen Code zwischen
-verschiedenen Rust-Ausgaben zu konvertieren. Die Ausgaben sind in [Anhang
+verschiedenen Rust-Editionen zu konvertieren. Die Editionen sind in [Anhang
 E][appendix-e] aufgeführt.
 
 ### Mehr statische Codeanalyse mit Clippy

src/appendix-05-editions.md

@@ -1,6 +1,6 @@
-## Anhang E: Ausgaben
+## Anhang E: Editionen
 
-In Kapitel 1 hast du gesehen, dass `cargo new` Metadaten zur Ausgabe (edition)
+In Kapitel 1 hast du gesehen, dass `cargo new` Metadaten zur Edition
 in deiner Datei _Cargo.toml_ hinzufügt. Dieser Anhang erläutert, was das
 bedeutet!
 
@@ -13,57 +13,58 @@ Veröffentlichung zu Veröffentlichung kann es schwierig sein, zurückzublicken
 und zu sagen: "Wow, zwischen Rust 1.10 und Rust 1.31 hat sich Rust sehr
 verändert!
 
-Etwa alle drei Jahre gibt das Rust-Team eine neue _Rust-Ausgabe_ (edition)
-heraus. Jede Ausgabe fasst die neuen Funktionalitäten in einem übersichtlichen
+Etwa alle drei Jahre gibt das Rust-Team eine neue _Rust-Edition_
+heraus. Jede Edition fasst die neuen Funktionalitäten in einem übersichtlichen
 Paket mit vollständig aktualisierter Dokumentation und Werkzeugausstattung
-zusammen. Neue Ausgaben werden im Rahmen des üblichen sechswöchigen
+zusammen. Neue Editionen werden im Rahmen des üblichen sechswöchigen
 Freigabeprozesses ausgeliefert.
 
-Ausgaben dienen unterschiedlichen Zwecken für verschiedene Menschen:
+Editionen dienen unterschiedlichen Zwecken für verschiedene Menschen:
 
-- Für aktive Rust-Nutzer fasst eine neue Ausgabe inkrementelle Änderungen in
+- Für aktive Rust-Nutzer fasst eine neue Edition inkrementelle Änderungen in
   einem leicht verständlichen Paket zusammen.
-- Für Nicht-Nutzer signalisiert eine neue Ausgabe, dass einige wichtige
+- Für Nicht-Nutzer signalisiert eine neue Edition, dass einige wichtige
   Fortschritte hinzugekommen sind, sodass sich ein erneuter Blick auf Rust
   lohnen könnte.
-- Für diejenigen, die Rust entwickeln, stellt eine neue Ausgabe einen
+- Für diejenigen, die Rust entwickeln, stellt eine neue Edition einen
   Treffpunkt für das gesamte Projekt dar.
 
-Zum Verfassungszeitpunkt dieses Artikels sind vier Rust-Ausgaben verfügbar:
+Zum Verfassungszeitpunkt dieses Artikels sind vier Rust-Editionen verfügbar:
 Rust 2015, Rust 2018, Rust 2021 und Rust 2024. Dieses Buch wurde unter
-Verwendung der Rust-Ausgabe 2024 geschrieben.
+Verwendung der Rust-Edition 2024 geschrieben.
 
-Der Schlüssel `edition` in _Cargo.toml_ gibt an, welche Ausgabe der Compiler
+Der Schlüssel `edition` in _Cargo.toml_ gibt an, welche Edition der Compiler
 für deinen Code verwenden soll. Wenn der Schlüssel nicht existiert, verwendet
 Rust aus Gründen der Abwärtskompatibilität die Edition `2015`.
 
-Jedes Projekt kann sich für eine Ausgabe abweichend von der Standardausgabe
-2015 entscheiden. Ausgaben können inkompatible Änderungen enthalten, z.B. die
+Jedes Projekt kann sich für eine Edition abweichend von der Standard-Edition
+2015 entscheiden. Editionen können inkompatible Änderungen enthalten, z.B. die
 Aufnahme eines neuen Schlüsselworts, das mit Bezeichnern im Code in Konflikt
 steht. Selbst wenn du dich nicht für diese Änderungen entscheidest, wird dein
 Code weiterhin kompilieren, auch wenn du die verwendete
 Rust-Compiler-Version aktualisierst.
 
-Alle Rust-Compiler-Versionen unterstützen jede Ausgabe, die vor der
+Alle Rust-Compiler-Versionen unterstützen jede Edition, die vor der
 Veröffentlichung dieses Compilers existierte, und es können Kisten (crates)
-aller unterstützten Ausgaben miteinander verknüpft werden. Ausgabenänderungen
+aller unterstützten Editionen miteinander verknüpft werden. Editionsänderungen
 wirken sich nur auf die Art und Weise aus, wie der Compiler anfangs den Code
 analysiert. Wenn du also Rust 2015 verwendest und eine deiner Abhängigkeiten
 Rust 2018 verwendet, wird dein Projekt diese Abhängigkeit kompilieren und
 nutzen können. Die umgekehrte Situation, in der dein Projekt Rust 2018
 und eine Abhängigkeit Rust 2015 verwendet, funktioniert ebenfalls.
 
-Um es klar zu sagen: Die meisten Funktionen werden in allen Ausgaben verfügbar
-sein. Entwickler, die eine beliebige Rust-Ausgabe verwenden, werden auch
+Um es klar zu sagen: Die meisten Funktionen werden in allen Editionen verfügbar
+sein. Entwickler, die eine beliebige Rust-Edition verwenden, werden auch
 weiterhin Verbesserungen sehen, wenn neue stabile Versionen erstellt werden. In
 einigen Fällen, vor allem wenn neue Schlüsselwörter hinzugefügt werden, sind
-einige neue Funktionalitäten jedoch möglicherweise erst in späteren Ausgaben
-verfügbar. Du wirst die Ausgabe wechseln müssen, wenn du die Vorteile solcher
+einige neue Funktionalitäten jedoch möglicherweise erst in späteren Editionen
+verfügbar. Du wirst die Edition wechseln müssen, wenn du die Vorteile solcher
 Funktionalitäten nutzen möchtest.
 
-Für weitere Einzelheiten schaue in den [*Ausgabe-Leitfaden* (Edition
-Guide)][edition-guide], einem vollständigen Buch über die Rust-Ausgaben, das
-die Unterschiede zwischen den Ausgaben auflistet und erläutert, wie du deinen
-Code automatisch per `cargo fix` auf eine neue Ausgabe aktualisieren kannst.
+Für weitere Einzelheiten schaue in den [_Editions-Leitfaden (Edition
+Guide)_][edition-guide]. Das ist ein vollständiges Buch über die Rust-Editionen,
+das die Unterschiede zwischen den Editionen auflistet und erläutert und wie du
+deinen Code automatisch per `cargo fix` auf eine neue Edition aktualisieren
+kannst.
 
 [edition-guide]: https://doc.rust-lang.org/stable/edition-guide/

src/appendix-06-translation.md

@@ -4,8 +4,6 @@ Für Ressourcen in anderen Sprachen als Englisch. Die meisten sind noch in
 Arbeit; siehe das [Label `Translations`][label], um zu helfen oder uns über
 eine neue Übersetzung zu informieren!
 
-[label]: https://github.com/rust-lang/book/issues?q=is%3Aopen+is%3Aissue+label%3ATranslations
-
 - [Português (BR)](https://github.com/rust-br/rust-book-pt-br)
 - [Português (PT)](https://github.com/nunojesus/rust-book-pt-pt)
 - 简体中文: [KaiserY/trpl-zh-cn](https://github.com/KaiserY/trpl-zh-cn), [gnu4cn/rust-lang-Zh_CN](https://github.com/gnu4cn/rust-lang-Zh_CN)
@@ -27,3 +25,9 @@ eine neue Übersetzung zu informieren!
 - [हिंदी](https://github.com/venkatarun95/rust-book-hindi)
 - [ไทย](https://github.com/rust-lang-th/book-th)
 - [Danske](https://github.com/DanKHansen/book-dk)
+- [O'zbek](https://github.com/rust-lang-uz/book)
+- [Tiếng Việt](https://github.com/tuanemdev/rust-book-vn)
+- [Italiano](https://nixxo.github.io/rust-lang-book-it/)
+- [বাংলা](https://github.com/IsmailHosenIsmailJames/rust-book-bn)
+
+[label]: https://github.com/rust-lang/book/issues?q=is%3Aopen+is%3Aissue+label%3ATranslations