-
Notifications
You must be signed in to change notification settings - Fork 399
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Align the DE/book structure to the EN original (#1075)
* 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
1 parent
9542030
commit 6defcc3
Showing
16 changed files
with
328 additions
and
111 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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'], | ||
}, | ||
], | ||
}; |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
Oops, something went wrong.