Detox: Unterschied zwischen den Versionen

Aus Foxwiki
K Textersetzung - „== Syntax ==“ durch „== Aufruf ==“
 
(43 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{DISPLAYTITLE:detox}}
{{DISPLAYTITLE:detox}}
'''detox''' bereinigt Dateinamen
'''detox''' - Dateinamen bereinigen
 
== Beschreibung ==
== Beschreibung ==
; Dateinamen bereinigen
''detox'' benennt Dateien um, damit sie leichter zu handhaben sind
'''detox''' benennt Dateien um, damit sie leichter zu handhaben sind
* Entfernt Leerzeichen und andere störende Elemente
* Entfernt Leerzeichen und andere störende Elemente
* Übersetzt oder bereinigt
* Übersetzt und bereinigt
** Latin-1-Zeichen (ISO 8859-1), die in 8-Bit-ASCII kodiert sind
** Latin-1-Zeichen (ISO 8859-1), die in 8-Bit-ASCII kodiert sind
** Unicode-Zeichen, die in UTF-8 kodiert sind
** Unicode-Zeichen, die in UTF-8 kodiert sind
** CGI-Escaped-Zeichen
** CGI-Escaped-Zeichen


; Sequenzen
== Installation ==
detox wird von einer konfigurierbaren Reihe von Filtern gesteuert, die als Sequenz bezeichnet werden.
# apt install detox
* Sequenzen werden in detoxrc(5) detaillierter behandelt und können mit der Option -L ermittelt werden.
* Einige Beispiele für Standardsequenzen sind iso8859_1 und utf_8.


== Installation ==
== Aufruf ==
== Syntax ==
  $ '''detox [-hnLrv] [-s sequence] [-f configfile] [--dry-run] [--special] file ...'''
  $ detox [-hnLrv] [-s sequence] [-f configfile] [--dry-run] [--special] file ...


=== Optionen ===
=== Optionen ===
Zeile 24: Zeile 21:
! Unix !! GNU !! Beschreibung
! Unix !! GNU !! Beschreibung
|-
|-
| -f ''configfile'' || || Use configfile instead of the default configuration files for loading translation sequences.
| -f ''configfile'' || || Nur ''configfile'' als Konfigurationsdateien laden
* No other config file will be parsed.
|-
|-
| -h || --help || Display helpful information
| -h || --help || Anzeige hilfreicher Informationen
|-
|-
| -L || || List the currently available sequences.
| -L || || Sequenzen auflisten
* When paired with -v this option shows what filters are used in each sequence and any properties
* mit -v: Welche Filter je Sequenz verwendet und welche Eigenschaften auf die Filter angewendet werden
applied to the filters.
|-
|-
| -n || --dry-run || Doesn't actually change anything.
| -n || --dry‑run || Ändert nicht wirklich etwas, impliziert die Option -v
* This implies the -v option.
|-
|-
| -r || || Recurse into subdirectories
| -r || || Unterverzeichnisse bearbeiten
|-
|-
| -s ''sequence'' || || Use sequence instead of default
| -s ''sequence'' || || ''sequence'' anstelle der Standardeinstellung verwenden
|-
|-
|| || --special || Works on special files (including links).
|| || --special || [[Speziellen Dateien]] und [[Links]] bearbeiten (Normalerweise werden diese Dateien ignoriert)
* Normally detox ignores these files.
|-
|-
| -v || || Be verbose about which files are being renamed.
| -v || || Auflisten welche Dateien umbenannt werden
|-
|-
| -V || || Show the current version of detox.
| -V || || Version anzueigen
|}
|}


=== Parameter ===
=== Parameter ===
=== Umgebungsvariablen ===
=== Umgebung ===
=== Exit-Status ===
=== Rückgabewert ===
 
== Anwendungen ==
$ '''detox -rv files'''
 
=== Sequenzen ===
; Konfigurierbaren Reihe von Filtern
detox wird von einer konfigurierbaren Reihe von Filtern gesteuert, die als Sequenz bezeichnet werden
* Sequenzen werden in [[detoxrc]](5) detaillierter behandelt und können mit der Option -L ermittelt werden
* Einige Beispiele für Standardsequenzen sind iso8859_1 und utf_8
 
; Beispiele
Führen Sie die Sequenz iso8859_1 rekursiv aus und listen Sie alle Änderungen auf, ohne etwas an den Dateien in /tmp/new_files zu ändern
$ '''detox -s iso8859_1 -r -v -n /tmp/new_files'''
 
Auflistung der Sequenzen in my_detoxrc mit Angabe ihrer Filter und Optionen
$ '''detox -f my_detoxrc -L -v'''
 
=== Problembehebung ===
* Wenn nach der Übersetzung eines Dateinamens bereits eine Datei mit demselben Namen existiert, wird Detox die Datei nicht umbenennen
* Dies könnte ein Problem mit dem max_length-Filter verursachen, wenn die Dateien unbedingt auf eine bestimmte Länge gekürzt werden müssen
* Lange Optionen funktionieren nicht unter Solaris oder Darwin
* Ein Fehler in der Konfigurationsdatei führt zu einem Segfault, da das betreffende Wort in der Konfigurationsdatei ausgegeben wird


== Anwendung ==
=== Fehlerbehebung ===
== Konfiguration ==
== Konfiguration ==
=== Dateien ===
=== Dateien ===
{| class="wikitable sortable options"
{| class="wikitable options"
|-
|-
! Option !! Beschreibung
! Datei !! Beschreibung
|-
|-
| detoxrc || The system-wide detoxrc file
| /etc/detoxrc || Systemweite Konfigurationsdatei
|-
|-
| ~/.detoxrc || A user's personal detoxrc.
| ~/.detoxrc || Persönliche Konfigurationsdatei eines Benutzers
* Normally it extends the system-wide detoxrc, unless -f has been specified, in which case, it is ignored.
* Normalerweise erweitert er den systemweiten detoxrc, es sei denn, es wurde -f angegeben, in diesem Fall wird er ignoriert
|-
|-
| iso8859_1.tbl || The default ISO 8859-1 translation table
| /usr/share/detox/iso8859_1.tbl || Standard-ISO-8859-1-Übersetzungstabelle
|-
|-
| unicode.tbl || The default Unicode (UTF-8) translation table
| /usr/share/detox/unicode.tbl || Standard-Unicode-Übersetzungstabelle (UTF-8)
|}
|}
<noinclude>
<noinclude>
Zeile 74: Zeile 87:
=== Siehe auch ===
=== Siehe auch ===
{{Special:PrefixIndex/{{BASEPAGENAME}}}}
{{Special:PrefixIndex/{{BASEPAGENAME}}}}
==== Sicherheit ====
==== Dokumentation ====
==== Dokumentation ====
===== RFC =====
===== Man-Page =====
===== Man-Pages =====
# detoxrc(5)
 
===== Info-Pages =====
===== Info-Pages =====
==== Links ====
==== Links ====
Zeile 83: Zeile 96:
===== Weblinks =====
===== Weblinks =====


[[Kategorie:Linux/Datei/Name]]
[[Kategorie:Linux/Datei/Verwaltung]]
[[Kategorie:Linux/Dateisystem/Bereinigen]]
[[Kategorie:Linux/Dateisystem/Befehl]]
[[Kategorie:Zeichenkodierung]]
[[Kategorie:Linux/Befehl]]


{{DEFAULTSORT:detox}}
{{DISPLAYTITLE:detox}}


= TMP =
== Installation ==
# apt install detox
== Anwendungen ==
$ '''detox -rv files'''
=== Beispiele ===
Run the sequence iso8859_1 recursively, listing any changes, without changing anything, on the files of /tmp/new_files.
$ '''detox -s iso8859_1 -r -v -n /tmp/new_files'''
List the sequences within my_detoxrc, showing their filters and options.
$ '''detox -f my_detoxrc -L -v'''
=== Fehlerbehebung ===
* Wenn nach der Übersetzung eines Dateinamens bereits eine Datei mit demselben Namen existiert, wird Detox die Datei nicht umbenennen.
* Dies könnte ein Problem mit dem max_length-Filter verursachen, wenn die Dateien unbedingt auf eine bestimmte Länge gekürzt werden müssen.
* Lange Optionen funktionieren nicht unter Solaris oder Darwin.
* Ein Fehler in der Konfigurationsdatei führt zu einem Segfault, da das betreffende Wort in der Konfigurationsdatei ausgegeben wird.
== Konfiguration ==
[[Kategorie:Linux/Dateisystem]]
[[Kategorie:Linux/Befehl]]
[[Kategorie:Linux/Datei/Dateinamen]]
[[Kategorie:Zeichenkodierung]]
[[Linux/Datei]]
{{DEFAULTSORT:detox}}
</noinclude>
</noinclude>

Aktuelle Version vom 12. November 2024, 18:49 Uhr

detox - Dateinamen bereinigen

Beschreibung

detox benennt Dateien um, damit sie leichter zu handhaben sind

  • Entfernt Leerzeichen und andere störende Elemente
  • Übersetzt und bereinigt
    • Latin-1-Zeichen (ISO 8859-1), die in 8-Bit-ASCII kodiert sind
    • Unicode-Zeichen, die in UTF-8 kodiert sind
    • CGI-Escaped-Zeichen

Installation

# apt install detox

Aufruf

$ detox [-hnLrv] [-s sequence] [-f configfile] [--dry-run] [--special] file ...

Optionen

Unix GNU Beschreibung
-f configfile Nur configfile als Konfigurationsdateien laden
-h --help Anzeige hilfreicher Informationen
-L Sequenzen auflisten
  • mit -v: Welche Filter je Sequenz verwendet und welche Eigenschaften auf die Filter angewendet werden
-n --dry‑run Ändert nicht wirklich etwas, impliziert die Option -v
-r Unterverzeichnisse bearbeiten
-s sequence sequence anstelle der Standardeinstellung verwenden
--special Speziellen Dateien und Links bearbeiten (Normalerweise werden diese Dateien ignoriert)
-v Auflisten welche Dateien umbenannt werden
-V Version anzueigen

Parameter

Umgebung

Rückgabewert

Anwendungen

$ detox -rv files

Sequenzen

Konfigurierbaren Reihe von Filtern

detox wird von einer konfigurierbaren Reihe von Filtern gesteuert, die als Sequenz bezeichnet werden

  • Sequenzen werden in detoxrc(5) detaillierter behandelt und können mit der Option -L ermittelt werden
  • Einige Beispiele für Standardsequenzen sind iso8859_1 und utf_8
Beispiele

Führen Sie die Sequenz iso8859_1 rekursiv aus und listen Sie alle Änderungen auf, ohne etwas an den Dateien in /tmp/new_files zu ändern

$ detox -s iso8859_1 -r -v -n /tmp/new_files

Auflistung der Sequenzen in my_detoxrc mit Angabe ihrer Filter und Optionen

$ detox -f my_detoxrc -L -v

Problembehebung

  • Wenn nach der Übersetzung eines Dateinamens bereits eine Datei mit demselben Namen existiert, wird Detox die Datei nicht umbenennen
  • Dies könnte ein Problem mit dem max_length-Filter verursachen, wenn die Dateien unbedingt auf eine bestimmte Länge gekürzt werden müssen
  • Lange Optionen funktionieren nicht unter Solaris oder Darwin
  • Ein Fehler in der Konfigurationsdatei führt zu einem Segfault, da das betreffende Wort in der Konfigurationsdatei ausgegeben wird

Konfiguration

Dateien

Datei Beschreibung
/etc/detoxrc Systemweite Konfigurationsdatei
~/.detoxrc Persönliche Konfigurationsdatei eines Benutzers
  • Normalerweise erweitert er den systemweiten detoxrc, es sei denn, es wurde -f angegeben, in diesem Fall wird er ignoriert
/usr/share/detox/iso8859_1.tbl Standard-ISO-8859-1-Übersetzungstabelle
/usr/share/detox/unicode.tbl Standard-Unicode-Übersetzungstabelle (UTF-8)


Anhang

Siehe auch

Dokumentation

Man-Page
  1. detoxrc(5)
Info-Pages

Links

Projekt
Weblinks