Detox: Unterschied zwischen den Versionen

Aus Foxwiki
K Textersetzung - „== Syntax ==“ durch „== Aufruf ==“
 
(30 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 3: Zeile 3:


== Beschreibung ==
== Beschreibung ==
; '''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
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 ==
== Installation ==
  # apt install detox
  # apt install detox


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


Zeile 26: Zeile 21:
! Unix !! GNU !! Beschreibung
! Unix !! GNU !! Beschreibung
|-
|-
| -f ''configfile'' || || Verwenden Sie configfile anstelle der Standardkonfigurationsdateien für das Laden von Übersetzungssequenzen, keine andere Konfigurationsdatei wird geparst.
| -f ''configfile'' || || Nur ''configfile'' als Konfigurationsdateien laden
|-
|-
| -h || --help || Anzeige hilfreicher Informationen
| -h || --help || Anzeige hilfreicher Informationen
|-
|-
| -L || || Auflisten der aktuell verfügbaren Sequenzen
| -L || || Sequenzen auflisten
* In Kombination mit -v zeigt diese Option an, welche Filter in jeder Sequenz verwendet werden und welche Eigenschaften auf die Filter angewendet werden.
* mit -v: Welche Filter je Sequenz verwendet und welche Eigenschaften auf die Filter angewendet werden
|-
|-
| -n || --dry-run || Ändert nicht wirklich etwas.
| -n || --dry‑run || Ändert nicht wirklich etwas, impliziert die Option -v
* Dies impliziert die Option -v.
|-
|-
| -r || || Rückwärtssuche in Unterverzeichnisse
| -r || || Unterverzeichnisse bearbeiten
|-
|-
| -s ''sequence'' || || Sequenz anstelle der Standardeinstellung verwenden
| -s ''sequence'' || || ''sequence'' anstelle der Standardeinstellung verwenden
|-
|-
|| || --special || Arbeitet mit speziellen Dateien (einschließlich Links). Normalerweise ignoriert detox diese Dateien.
|| || --special || [[Speziellen Dateien]] und [[Links]] bearbeiten (Normalerweise werden diese Dateien ignoriert)
|-
|-
| -v || || Ausführlich darüber sein, welche Dateien umbenannt werden.
| -v || || Auflisten welche Dateien umbenannt werden
|-
|-
| -V || Zeigt die aktuelle Version von detox.
| -V || || Version anzueigen
|}
|}


=== Parameter ===
=== Parameter ===
=== Umgebungsvariablen ===
=== Umgebung ===
=== Exit-Status ===
=== Rückgabewert ===


== Anwendungen ==
== Anwendungen ==
  $ '''detox -rv files'''
  $ '''detox -rv files'''


=== Beispiele ===
=== Sequenzen ===
Run the sequence iso8859_1 recursively, listing any changes, without changing anything, on the files of /tmp/new_files.
; 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'''
  $ '''detox -s iso8859_1 -r -v -n /tmp/new_files'''


List the sequences within my_detoxrc, showing their filters and options.
Auflistung der Sequenzen in my_detoxrc mit Angabe ihrer Filter und Optionen
  $ '''detox -f my_detoxrc -L -v'''
  $ '''detox -f my_detoxrc -L -v'''


=== Fehlerbehebung ===
=== Problembehebung ===
* Wenn nach der Übersetzung eines Dateinamens bereits eine Datei mit demselben Namen existiert, wird Detox die Datei nicht umbenennen.
* 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.
* 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.
* 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.
* Ein Fehler in der Konfigurationsdatei führt zu einem Segfault, da das betreffende Wort in der Konfigurationsdatei ausgegeben wird


== 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 88: Zeile 88:
{{Special:PrefixIndex/{{BASEPAGENAME}}}}
{{Special:PrefixIndex/{{BASEPAGENAME}}}}
==== Dokumentation ====
==== Dokumentation ====
===== RFC =====
===== Man-Page =====
===== Man-Pages =====
# detoxrc(5)
 
===== Info-Pages =====
===== Info-Pages =====
==== Links ====
==== Links ====
Zeile 95: Zeile 96:
===== Weblinks =====
===== Weblinks =====


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


{{DEFAULTSORT:detox}}
{{DEFAULTSORT:detox}}
{{DISPLAYTITLE: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