Skip to content

Commit

Permalink
Merge pull request #41 from LyubomirT/main
Browse files Browse the repository at this point in the history
Localize the documentation (German / Ukrainian)

Ref: #19 


Reviewed-by: AlexNg <contact@ngjx.org>
  • Loading branch information
caffeine-addictt committed Apr 17, 2024
2 parents b122a30 + 42ff016 commit c07f670
Show file tree
Hide file tree
Showing 21 changed files with 981 additions and 0 deletions.
69 changes: 69 additions & 0 deletions docs/de/commands/cache.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
<!-- markdownlint-disable MD013 -->

# Cache-Befehle

Die folgenden Befehle werden verwendet, um Caches zu verwalten.

## Inhaltsverzeichnis

<!--toc:start-->
- [Cache-Befehle](#cache-befehle)
- [Inhaltsverzeichnis](#inhaltsverzeichnis)
- [Befehle](#befehle)
- [list|ls <Muster?>](#listls-muster)
- [remove|rm <Muster>](#removerm-muster)
- [clear|clr|wipe](#clearclrwipe)
- [Optionen](#optionen)
- [Siehe auch](#siehe-auch)
<!--toc:end-->

## Befehle

### list|ls <Muster?>

Listet alle Cache-Einträge oder solche, die mit dem angegebenen Muster übereinstimmen.

Jeder Cache-Eintrag wird von seinem Protokoll (`https://`, `http://`, `www.`) befreit, bevor er abgeglichen wird.
Beispielsweise wird `https://video-site.com` auf `video-site.com` gekürzt und `http://www.other-site.com` auf `other-site.com`.

Muster werden in dieser Reihenfolge abgeglichen:

- Überprüfen, ob die Zeile mit dem Muster beginnt
- RegExp-Abgleich gegen die Zeile

```sh
video-manager cache list
video-manager cache ls myVideoTitle
```

### remove|rm <Muster>

Entfernt alle Cache-Einträge, die mit dem angegebenen Muster übereinstimmen.

> [!NOTE]
> Das Protokoll (`https://`, `http://`, `www.`) wird vor dem Abgleichen nicht entfernt.
Muster werden in dieser Reihenfolge abgeglichen:

- Überprüfen, ob die Zeile mit dem Muster beginnt
- RegExp-Abgleich gegen die Zeile

```sh
video-manager cache remove https
```

### clear|clr|wipe

Löscht den gesamten Cache.

```sh
video-manager cache clear
```

## Optionen

Es werden nur [persistente Optionen](./index,md/persistent-options) unterstützt.

## Siehe auch

- [Befehl "get"](./get.md)
39 changes: 39 additions & 0 deletions docs/de/commands/delete.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Der Befehl "delete"

Dieser Befehl löscht Dateien aus dem konfigurierten Verzeichnis.

## Inhaltsverzeichnis

<!--toc:start-->
- [Der Befehl "delete"](#der-befehl-delete)
- [Inhaltsverzeichnis](#inhaltsverzeichnis)
- [Grundlegende Verwendung](#grundlegende-verwendung)
- [Optionen](#optionen)
- [-y, --yes](#y-yes)
- [Vererbt](#vererbt)
- [Siehe auch](#siehe-auch)
<!--toc:end-->

## Grundlegende Verwendung

```sh
# Spezifische Datei
video-manager delete <Dateiname>

# RegExp (alle mp4 löschen)
video-manager delete -r '[a-z]+\.mp4'
```

## Optionen

### -y, --yes

Bestätigungsaufforderung überspringen.

### Vererbt

Alle unterstützten vererbten Optionen finden Sie unter [persistente Optionen](./index.md#persistente-optionen).

## Siehe auch

- [list](./list.md)
91 changes: 91 additions & 0 deletions docs/de/commands/get.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
# Der Befehl "get"

Dieser Befehl lädt Dateien von URL(s) in Ihren konfigurierten Download-Ort herunter.

## Inhaltsverzeichnis

<!--toc:start-->
- [Grundlegende Verwendung](#grundlegende-verwendung)
- [Dateiname](#dateiname)
- [Optionen](#optionen)
- [-f, --file](#f-file)
- [-s, --strategy [synchronous|concurrent]](#s-strategy-synchronousconcurrent)
- [-m, --max-concurrency [0 = unbegrenzt]](#m-max-concurrency-0-unbegrenzt)
- [Vererbt](#vererbt)
- [Siehe auch](#siehe-auch)
<!--toc:end-->

## Grundlegende Verwendung

```sh
# Um ein Video herunterzuladen
video-manager get https://video-site.com/video.mp4

# Oder mehrere Videos
video-manager get https://video-site.com/video.mp4 https://my.other/video.mp4
```

## Dateiname

Dateinamen werden aus dem letzten Teil der URL generiert.

Beispielweise wird bei der URL `https://video-site.com/video.mp4` der Dateiname `video.mp4` sein.

> [!IMPORTANT]
> Das bedeutet auch, dass der Dateiname `video` ist, wenn die URL `https://video-site.com/video` lautet!
## Optionen

### -f, --file <Pfad>

Sie können eine Datei mit einer Liste von URLs zum Herunterladen übergeben.

Dies kann allein oder mit dem Angeben von URLs aus Argumenten verwendet werden, was bedeutet, dass die folgenden Befehle gültig sind:

- `video-manager get -f urls.txt`
- `video-manager get https://video-site.com/video.mp4 -f urls.txt`

Zum Beispiel,

```text
# urls.txt
# Muss nicht eine `.txt` sein
# Kann nur 1 URL pro Zeile haben
https://video-site.com/video.mp4
https://my.other/video.mp4
```

```sh
video-manager get -f urls.txt
```

### -s, --strategy <synchronous|concurrent>

Sie können die Download-Strategie angeben. Standardmäßig ist sie `concurrent`.

- `synchronous`: Lädt alle Videos sequenziell herunter
- `concurrent`: Lädt Videos gleichzeitig herunter

```sh
video-manager get -s synchronous https://video-site.com/video.mp4 https://my.other/video.mp4
```

### -m, --max-concurrency [0 = unbegrenzt] <Ganzzahl>

Sie können die maximale Anzahl gleichzeitiger Downloads angeben. Standardmäßig ist es `10`, und bei `0` ist es unbegrenzt.

> [!NOTE]
> Nur verfügbar, wenn die `concurrent`-Strategie verwendet wird.
```sh
video-manager get -s concurrent -m 10 https://video-site.com/video.mp4 https://my.other/video.mp4
```

### Vererbt

Alle unterstützten vererbten Optionen finden Sie unter [persistente Optionen](./index.md#persistente-optionen).

## Siehe auch

Vollständige Liste der [Befehle](./index.md).
46 changes: 46 additions & 0 deletions docs/de/commands/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
<!-- markdownlint-disable MD033 -->

# Befehlsdokumentation

Hier ist die vollständige Liste der Befehle und persistenter Optionen, die von Video Manager unterstützt werden.

## Persistente Optionen

### -w, --dir <Pfad>

Verwendet das angegebene Arbeitsverzeichnis. Standardmäßig ist es `~/Videos`.

### -h, --help

Gibt die Hilfemeldung aus

### -v, --verbose

Gibt ausführliche Ausgaben aus

### -d, --debug

Gibt Debug-Ausgaben aus

### -c, --config <Pfad>

Verwendet die angegebene Konfigurationsdatei.

Wenn nicht angegeben, wird die `.video-manager`-Datei in folgender Reihenfolge gesucht:

- Das aktuelle Arbeitsverzeichnis (`./.video-manager`)
- Das Benutzerverzeichnis (`~/.video-manager`)

### -C, --cache <Pfad>

Verwendet die angegebene Cache-Datei.

Wenn nicht angegeben, wird die `~/.video-manager_history`-Datei verwendet oder anderweitig in der [Konfigurationsdatei](../configuration.md) definiert.

## Befehle

- [cache clear|list|remove](./cache.md)
- [delete](./delete.md)
- [get](./get.md)
- [list](./list.md)
- [version](./version.md)
80 changes: 80 additions & 0 deletions docs/de/commands/list.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
<!-- markdownlint-disable MD013 -->

# Der Befehl "list"

Dieser Befehl listet alle Videos in Ihrem konfigurierten Download-Ort auf.

## Inhaltsverzeichnis

<!--toc:start-->
- [Inhaltsverzeichnis](#inhaltsverzeichnis)
- [Grundlegende Verwendung](#grundlegende-verwendung)
- [Optionen](#optionen)
- [-q, --query (Standardwert "")](#q-query-standardwert)
- [-n, --count [0 = unbegrenzt]](#n-count-0-unbegrenzt)
- [-a, --allow (Standardwert [])](#a-allow-standardwert)
- [-e, --exclude (Standardwert [])](#e-exclude-standardwert)
- [Vererbte](#vererbte)
- [Siehe auch](#siehe-auch)
<!--toc:end-->

## Grundlegende Verwendung

```sh
video-manager list
```

## Optionen

### -q, --query (Standardwert "")

Abfrage zum Suchen von Videos.

> [!NOTE]
> RegExp wird unterstützt.
```sh
video-manager list -q "Abfrage" # Überprüft, ob "Abfrage" im Dateinamen enthalten ist
video-manager list -q ".*" # Passt zu jedem Zeichen
video-manager list -q "*" # Überprüft, ob "*" im Dateinamen enthalten ist
```

### -n, --count [0 = unbegrenzt]

Sie können die maximale Anzahl der aufzulisten Videos angeben. Standardmäßig ist es `00`, und wenn es auf `0` gesetzt ist, ist es unbegrenzt.

### -a, --allow (Standardwert [])

Sie können die Liste der erlaubten Erweiterungen angeben, wobei das `.` weggelassen wird, und standardmäßig `[]` ist.

Folgendes ist gültig:

```sh
video-manager list -a mp4,mkv
video-manager list -a mp4 -a mkv
```

> [!NOTE]
> Dies kann nicht mit `--exclude` verwendet werden.
### -e, --exclude (Standardwert [])

Sie können die Liste der unerwünschten Erweiterungen angeben, wobei das `.` weggelassen wird, und standardmäßig `[]` ist.

Folgendes ist gültig:

```sh
video-manager list -e mp4,mkv
video-manager list -e mp4 -e mkv
```

> [!NOTE]
> Dies kann nicht mit `--allow` verwendet werden.
### Vererbte

Siehe [persistente Optionen](./index.md#persistente-optionen) für alle unterstützten vererbten Optionen.

## Siehe auch

Vollständige Liste der [Befehle](./index.md).
22 changes: 22 additions & 0 deletions docs/de/commands/version.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Der Befehl "version"

Dieser Befehl gibt die aktuelle Version von video-manager aus.

## Inhaltsverzeichnis

<!--toc:start-->
- [Grundlegende Verwendung](#grundlegende-verwendung)
- [Siehe auch](#siehe-auch)
<!--toc:end-->

## Grundlegende Verwendung

Dieser Befehl erwartet keine Argumente und unterstützt nur [persistente Optionen](./index.md#persistente-optionen).

```sh
video-manager version
```

### Siehe auch

Die vollständige Liste der [Befehle](./index.md)
36 changes: 36 additions & 0 deletions docs/de/configuration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
<!-- markdownlint-disable MD033 MD013 -->

# Konfiguration

## Inhaltsverzeichnis

<!--toc:start-->
* [Inhaltsverzeichnis](#inhaltsverzeichnis)
* [Übersicht](#übersicht)
* [Standardkonfiguration](#standardkonfiguration)
* [Siehe auch](#siehe-auch)
<!--toc:end-->

## Übersicht

Konfigurationsdateien werden in folgender Reihenfolge gesucht:

* Arbeitsverzeichnis `(./)`
* Benutzerverzeichnis `($HOME)`

Sie können auch das `-w` oder `--dir` Flag übergeben, um einen Pfad zu einer Konfigurationsdatei anzugeben.
Wenn `-w` nicht bereitgestellt wird, sollten Konfigurationsdateien den Namen `.video-manager` haben und der [YAML](https://yaml.org/) Syntax folgen.

## Standardkonfiguration

```yaml
# Hier werden alle Videodateien gespeichert
dir: ~/.Videos

# Hier werden die Download-URLs zwischengespeichert
cache: ~/.video-manager_history
```

## Siehe auch

* [Befehle](./commands/index.md)
Loading

0 comments on commit c07f670

Please sign in to comment.