Detox: Unterschied zwischen den Versionen

Aus Foxwiki
Keine Bearbeitungszusammenfassung
Zeile 19: Zeile 19:


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


=== Optionen ===
=== Optionen ===

Version vom 3. Oktober 2023, 11:15 Uhr

detox - Dateinamen bereinigen

Beschreibung

detox benennt Dateien um, damit sie leichter zu handhaben sind
  • Entfernt Leerzeichen und andere störende Elemente
  • Übersetzt oder 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
Sequenzen

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.

Installation

# apt install detox

Syntax

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

Optionen

Unix GNU Beschreibung
-f configfile Use configfile instead of the default configuration files for loading translation sequences.
  • No other config file will be parsed.
-h --help Display helpful information
-L List the currently available sequences.
  • When paired with -v this option shows what filters are used in each sequence and any properties

applied to the filters.

-n --dry-run Doesn't actually change anything.
  • This implies the -v option.
-r Recurse into subdirectories
-s sequence Use sequence instead of default
--special Works on special files (including links).
  • Normally detox ignores these files.
-v Be verbose about which files are being renamed.
-V Show the current version of detox.

Parameter

Umgebungsvariablen

Exit-Status

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

Dateien

Option Beschreibung
detoxrc The system-wide detoxrc file
~/.detoxrc A user's personal detoxrc.
  • Normally it extends the system-wide detoxrc, unless -f has been specified, in which case, it is ignored.
iso8859_1.tbl The default ISO 8859-1 translation table
unicode.tbl The default Unicode (UTF-8) translation table


Anhang

Siehe auch

Dokumentation

RFC
Man-Pages
Info-Pages

Links

Projekt
Weblinks