Skip to content

Commit

Permalink
Align the DE/book structure to the EN original (#1075)
Browse files Browse the repository at this point in the history
* Align the DE/book structure to the EN original

* Rename some german file names back to english to be consistant

* Bring commit b019eab to the DE translation and deleting the mathematik.md file

* Rename german file names in sidebar back to english

* Update de/book/advanced.md

Co-authored-by: Stefan Holderbach <[email protected]>

* Update de/book/advanced.md

Co-authored-by: Stefan Holderbach <[email protected]>

* Fix sidebar

Simple typo in the path order

---------

Co-authored-by: Stefan Holderbach <[email protected]>
  • Loading branch information
petrisch and sholderbach committed Sep 27, 2023
1 parent 9542030 commit 6defcc3
Show file tree
Hide file tree
Showing 16 changed files with 328 additions and 111 deletions.
94 changes: 65 additions & 29 deletions .vuepress/configs/sidebar/de.ts
Original file line number Diff line number Diff line change
@@ -1,40 +1,76 @@
import type { SidebarConfig } from '@vuepress/theme-default';
import type { commandCategories } from './command_categories';

export const sidebarDe: SidebarConfig = {
'/de/book/': [
{
text: 'Nu Handbuch (0.59+)',
text: 'Einleitung',
link: '/de/book/README.md',
collapsible: false,
},
{
text: 'Erste Schritte',
link: '/de/book/getting_started.md',
collapsible: false,
children: [
'/de/book/installation',
'/de/book/moving_around',
'/de/book/thinking_in_nushell',
],
},
{
text: 'Nu Grundlagen',
link: '/de/book/nu_fundamentals.md',
collapsible: false,
children: [
'/de/book/types_of_data',
'/de/book/loading_data',
'/de/book/pipeline.md',
'/de/book/working_with_strings',
'/de/book/working_with_lists',
'/de/book/working_with_tables',
],
},
{
text: 'Programmieren in Nu',
link: '/de/book/programming_in_nu.md',
collapsible: false,
children: [
'/de/book/custom_commands',
'/de/book/aliases',
'/de/book/operators',
'/de/book/variables_and_subexpressions.md',
'/de/book/scripts',
'/de/book/overlays',
'/de/book/command_signature',
],
},
{
text: 'Nu als Shell',
link: '/de/book/nu_as_a_shell.md',
collapsible: false,
children: [
'README.md',
'installation',
'thinking_in_nushell',
'moving_around',
'types_of_data',
'loading_data',
'working_with_strings',
'working_with_lists',
'working_with_tables',
'pipeline.md',
'konfiguration',
'environment',
'3rdpartyprompts',
'eigene_befehle',
'aliase',
'mathematik',
'variablen_und_unterausdruecke',
'scripts',
'escaping',
'plugins',
'von_bash_kommend',
'command_reference',
'custom_completions',
'coloring_and_theming',
'hooks',
'background_task.md',
'overlays',
'command_signature',
'/de/book/configuration',
'/de/book/environment',
'/de/book/escaping',
'/de/book/3rdpartyprompts',
'/de/book/custom_completions',
'/de/book/coloring_and_theming',
'/de/book/hooks',
'/de/book/background_task.md',
],
},
{
text: 'Wechsel zu Nu',
link: '/de/book/coming_to_nu.md',
collapsible: false,
children: ['/de/book/coming_from_bash', '/de/book/command_reference'],
},
{
text: '(Nicht nur für) Fortgeschrittene',
link: '/de/book/advanced.md',
collapsible: false,
children: ['/de/book/plugins'],
},
],
};
20 changes: 20 additions & 0 deletions de/book/advanced.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# (Nicht nur für) Fortgeschrittene

Der Titel "Fortgeschritten" mag abschrecken und zum Überspringen des Kapitels animieren, doch tatsächlich sind einige der interessantesten und mächtigsten Merkmale hier zu finden.

Abgesehen von den eingebauten Befehlen, besitzt Nushell eine [Standard Bibliothek](standard_library.md) aus in Nu geschriebenen Befehlen.

Nushell arbeitet mit _strukturierten Daten_.
Nushell ist eine "Daten orientierte" Shell und Programmiersprache.
Diese Daten zentrierte Sicht zeigt sich auch in [Polars](https://github.com/pola-rs/polars), dem eingebauten vollständigen Datenpaket Verarbeiter.
Im Kapitel [Dataframes documentation](dataframes.md) wird erklärt, wie grosse Datenmengen effizient in Nushell verarbeitet werden können.

Werte in Nusehll enthalten einige [Metadaten](metadata.md).
Diese können verwendet werden, um z.B. [eigene Fehlermeldungen](creating_errors.md) erstellen zu können.

Dank Nushells strikten Gültigkeitsregeln, ist es sehr einfach durch Sammlungen [parallel zu iterieren](parallelism.md), was mit wenig Aufwand lange laufende Skripte beschleunigen kann.

Mit dem [`explore`](/commands/docs/explore.md) Befehl können Daten [interaktiv erkundet](explore.md) werden.

Schliesslich kann Nushell mit [Plugins](plugins.md) erweitert werden.
Ein Plugin kann fast alles sein, solange es mit Nushell in einem Protokoll kommuniziert, welches diese versteht.
2 changes: 1 addition & 1 deletion de/book/aliase.md → de/book/aliases.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Die Lösung ist einen parameterlosen Befehl zu definieren, der das Systemprogram
def uuidgen [] { ^uuidgen | tr A-F a-f }
```

Mehr dazu im Kapitel [Eigene Befehle](eigene_befehle.md).
Mehr dazu im Kapitel [Eigene Befehle](custom_commands.md).

Oder ein etwas idiomatischeres Beispiel von nushell internen Befehlen

Expand Down
File renamed without changes.
10 changes: 10 additions & 0 deletions de/book/coming_to_nu.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Wechsel zu Nu

Sind andere Shells oder Programmiersprachen ein Begriff, so finden sich in diesem Kapitel einige Informationen um schneller Fuss zu fassen in Nu.

[Von Bash kommend](coming_from_bash.md) zeigt welche Vorgehenweisen, die typisch für Bash, oder POSIX Shells ganz allgemein sind, auf Nushell übertragen werden können.
Analog zeigt [Von CMD.exe kommend](coming_from_cmd.md) wie eingebaute Befehle der Windows Eingabeaufforderung auf Nushell übertragen werden können.

Ähnliche Vergleiche wurden erstellt für [andere Shells und specifische Sprachen](nushell_map.md), [Imperative Sprachen](nushell_map_imperative.md) und [funktionale Sprachen](nushell_map_functional.md).

Ein separater Vergleich existiert spezifisch für [Operatoren](nushell_operator_map.md).
File renamed without changes.
2 changes: 1 addition & 1 deletion de/book/eigene_befehle.md → de/book/custom_commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -282,4 +282,4 @@ Wenn dieser neue Befehl nun in einer Pipeline aufgerufen wird, sieht die Ausgabe

## Persistenz

Um Informationen darüber zu erhalten, wie eigene Befehle bei jedem Start von Nushell verfügbar bleiben, sei auf das [Konfigurationskapitel](konfiguration.md) verwiesen.
Um Informationen darüber zu erhalten, wie eigene Befehle bei jedem Start von Nushell verfügbar bleiben, sei auf das [Konfigurationskapitel](configuration.md) verwiesen.
7 changes: 7 additions & 0 deletions de/book/design_notes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Design Notes

This chapter intends to give more in-depth overview of certain aspects of Nushell's design. The topics are not necessary for a basic usage, but reading them will help you understand how Nushell works and why.

We intend to expand this chapter in the future. If there is some topic that you find confusing and hard to understand, let us know. It might be a good candidate for a page here.

[How Nushell Code Gets Run](how_nushell_code_gets_run.md) explains what happens when you run Nushell source code. It explains how Nushell is in many ways closer to classic compiled languages, like C or Rust, than to other shells and dynamic languages and hopefully clears some confusion that stems from that.
10 changes: 10 additions & 0 deletions de/book/getting_started.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Fangen wir an

Lasst uns anfangen! :elephant:

Um Nushell verwenden zu können muss sie zuerst [installiert werden](installation.md)

Der nächste Abschnitt gibt eine [kurze Tour durch Nushell anhand von Beispielen](quick_tour.md)(inklusive wie man Hilfe in Nushell bekommt), sowie wie im [Dateisystem navigiert werden kann](moving_around.md)

Schliesslich, Nushell hat einige Design Entscheidungen getroffen, die zu traditionellen Shells und dynamischen Skriptsprachen recht unterschiedlich sind.
Schauen wir uns deshalb auf jedenfall [Denken in Nu](thinking_in_nu.md) an, welches einige dieser Konzepte erklärt.
72 changes: 0 additions & 72 deletions de/book/mathematik.md

This file was deleted.

30 changes: 30 additions & 0 deletions de/book/nu_as_a_shell.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Nu als Shell

Die Kapitel [Nu Grundlagen](nu_fundamentals.md) und [Programmieren in Nu](programming_in_nu.md) fokusieren sich vor allem auf den Programmiersprach-Aspekt von Nushell.

Dieses Kapitel wirft ein Licht auf den Nushell Interpreter oder (den Nushell [REPL](https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop)).
Einige der Konzepte sind integraler Bestandteilt der Nushell Programmiersprache (so wie Umgebungsvariablen). Während andere ausschliesslich zur Verbesserung des interaktiven Verhaltens beitragen (so wie Hooks) und deshalb z.B. beim Ausführen von Skripten nicht zur Verfügung stehen.

Viele Parameter von Nushell können [konfiguriert](configuration.md) werden.
Die Konfiguration selber ist gespeichert als Umgebungsvariable.
Desweiteren werden in Nushell diverse Konfigurationsdateien beim Start ausgeführt, in denen eigene Befehle oder Aliase etc. definiert werden können.

Ein starkes Merkmal jeder Shell sind ihre [Umgebungsvariablen](environment.md).
In Nushell sind Umgebungsvariablen in Geltungsbereiche unterteilt und können jeden unterstützten Typ annehmen.
Dies bringt einige zusätzliche Design Überlegungen mit sich, welche in den verlinken Kapiteln erklärt werden.

Die anderen Kapitel erklären wie mit [stdout, stderr und exit codes](stdout_stderr_exit_codes.md) gearbeitet werden kann, oder wie ein [Befehl zu einem externer Befehl "escaped"](escaping.md) werden kann.
Sowie wie ein [Drittanbieter Prompt](3rdpartyprompts.md) zur Zusammenarbeit mit Nushell bewegt werden kann.

Ein interessantes Merkmal von Nushell ist [Shell in Shells](shells_in_shells.md) welches erlaubt in mehreren Verzeichnissen gleichzeitig zu arbeiten.

Nushell hat auch seinen eigenen Zeilen Editor [Reedline](line_editor.md).
In Nushells Konfiguration ist es möglich einige Merkmale von Reedline wie Prompt, Tastenkombinationen, History oder Menus einzustellen.

Es ist auch möglich, eigene [Signaturen für externe Befehle](externs.md) zu definieren, was es erlaubt [eigene Vervollständigungen](custom_completions.md) für diese zu erstellen (welche auch für die eigenen Befehle funktionieren).

[Farben und Themen in Nu](coloring_and_theming.md)) geht ins Detail zum Thema, wie Nushells Aussehen konfiguriert werden kann.

Sind einige Befehle geplant , die im Hintergrund ablaufen sollen, so kann darüber in [Hintergrund Tasks in Nu](background_task.md) nachgelesen werden.

Schliesslich erklärt [Hooks](hooks.md) wie Fragmente von Nushell Code beim Auftreten gewisser Ereignisse ausgeführt werden kann.
20 changes: 20 additions & 0 deletions de/book/nu_fundamentals.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Nu Grundlagen

In diesem Kapitel sind die Grundlagen der Nushell Programmiersprache erklärt.
Damit sollte es möglich sein, einfache Nushell Programme zu schreiben.

Nushell hat ein umfangreiches Typen System.
Es sind gebräuchliche Typen wie Text oder einfache Zahlen jedoch auch weniger geräuchliche wie Zellpfade zu finden.
Ausserdem ist eines der Hauptmerkmale von Nushell die Idee von _strukturierten Daten_, was bedeutet, dass Typen zusammengefasst werden können in: Listen, Records oder Tabellen.
Im Gegensatz zum traditionellen Unix Ansatz, in dem alle Befehle über Klartext kommunizieren, kommuniziert Nushell über diese Datentypen.
Dies ist alles erklärt in [Datentypen](types_of_data.md).

[Laden von Daten](loading_data.md) erklärt, wie gebräuchliche Datenformate in _strukturierte Daten_ gelesen werden, wie JSON. Dies beinhaltet auch das eigene Datenformat "NUON".

Wie bei Unix Shells, können in Nushell Befehle in [Pipelines](pipelines.md) zusammengeführt werden, um Daten in einem Strom zu modifizieren.

Einige Datentypen haben interessante Eigenschaften, die ein eigenes Kapitel verdienen: [Text](working_with_strings.md), [Listen](working_with_lists.md), and [Tabellen](working_with_tables.md).
Diese Kapitel zeigen ausserdem auch gängige Operationen wie Texte zusammensetzen oder ändern von Einträgen in einer Liste .

Schliesslich listet (Command Reference)(/commands/) alle eingebauten Befehle mit einer kurzen Beschreibung auf.
Eine Information, welche ebenso aus Nushell heraus erreicht werden kann mittels dem [`help`](/commands/docs/help.md) Befehl.
Loading

0 comments on commit 6defcc3

Please sign in to comment.