Detox: Unterschied zwischen den Versionen

Aus Foxwiki
Keine Bearbeitungszusammenfassung
K Textersetzung - „== Syntax ==“ durch „== Aufruf ==“
 
(68 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{DISPLAYTITLE:detox}}
{{DISPLAYTITLE:detox}}
'''detox''' bereinigt Dateinamen
'''detox''' - Dateinamen bereinigen


== Beschreibung ==
== Beschreibung ==
'''detox''' benennt Dateien um, damit sie leichter zu handhaben sind
''detox'' benennt Dateien um, damit sie leichter zu handhaben sind
* Es entfernt Leerzeichen und andere störende Elemente.
* Entfernt Leerzeichen und andere störende Elemente
* Es übersetzt oder bereinigt auch Latin-1-Zeichen (ISO 8859-1), die in 8-Bit-ASCII kodiert sind, Unicode-Zeichen, die in UTF-8 kodiert sind, und CGI-Escaped-Zeichen
* Übersetzt und bereinigt
 
$ '''detox -rv files'''
 
== 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
** 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
The detox utility renames files to make them easier to work with.  It removes spaces and other such annoyances.  It'll also translate or cleanup
Latin-1 (ISO 8859-1) characters encoded in 8-bit ASCII, Unicode characters encoded in UTF-8, and CGI escaped characters.
=== HISTORY ===
detox was originally designed to clean up files that I had received from friends which had been created using other operating systems.  It's trivial to
create a filename with spaces, parenthesis, brackets, and ampersands under some operating systems.  These have special meaning within FreeBSD and
Linux, and cause problems when you go to access them.  I created detox to clean up these files.
=== Sequences ===
detox is driven by a configurable series of filters, called a sequence.  Sequences are covered in more detail in detoxrc(5) and are discoverable with the -L option.  Some examples of default sequences are iso8859_1 and utf_8.


== Installation ==
== Installation ==
== Anwendungen ==
  # apt install detox
  $ '''detox -rv files'''
 
=== Beispiele ===
detox -s iso8859_1 -r -v -n /tmp/new_files
Will run the sequence iso8859_1 recursively, listing any changes, without changing anything, on the files of /tmp/new_files.
 
detox -f my_detoxrc -L -v
Will list the sequences within my_detoxrc, showing their filters and options.
 
=== Fehlerbehebung ===
If, after the translation of a filename is finished, a file already exists with that same name, detox will not rename the file.  This could cause a problem with the max_length filter, if it was imperative that the files be cut down to a certain length.
 
Long options don't work under Solaris or Darwin.
 
An error in the config file will cause a segfault as it's going to print the offending word within the config file.


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


=== Optionen ===
=== Optionen ===
{| class="wikitable sortable options"
|-
! 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
|}


-f configfile
=== Parameter ===
Use configfile instead of the default configuration files for loading translation sequences.  No other config file will be parsed.
=== Umgebung ===
=== Rückgabewert ===


-h --help  Display helpful information.
== Anwendungen ==
 
  $ '''detox -rv files'''
-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.
=== 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


==== Deprecated Options ====
; Beispiele
Deprecated Options are options that were available in earlier versions of detox but have lost their meaning and are being phased out.
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'''


--remove-trailing
Auflistung der Sequenzen in my_detoxrc mit Angabe ihrer Filter und Optionen
Removes _ and - after .'s in filenames.  This was first provided in the 0.9 series of detox.  After the introduction of sequences, it lost
$ '''detox -f my_detoxrc -L -v'''
its meaning, as you could now determine the properties of wipeup through a particular sequence's configuration.  It presently forces all
instances of the wipeup filter to use remove trailing, regardless of what's actually in the config files.


=== Parameter ===
=== Problembehebung ===
=== Umgebungsvariablen ===
* Wenn nach der Übersetzung eines Dateinamens bereits eine Datei mit demselben Namen existiert, wird Detox die Datei nicht umbenennen
=== Exit-Status ===
* 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 ==
== Konfiguration ==
=== Dateien ===
=== Dateien ===
detoxrc       The system-wide detoxrc file.
{| class="wikitable options"
~/.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.
! Datei !! Beschreibung
unicode.tbl   The default Unicode (UTF-8) translation table.
|-
| /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)
|}
<noinclude>


== Sicherheit ==
== Anhang ==
== Dokumentation ==
=== Siehe auch ===
=== RFC ===
{{Special:PrefixIndex/{{BASEPAGENAME}}}}
=== Man-Pages ===
==== Dokumentation ====
=== Info-Pages ===
===== Man-Page =====
== Siehe auch ==
# inline-detox(1)
# detoxrc(5)
# detoxrc(5)
# detox.tbl(5)


== Links ==
===== Info-Pages =====
=== Projekt ===
==== Links ====
=== Weblinks ===
===== Projekt =====
=== Einzelnachweise ===
===== Weblinks =====
<references />
== Testfragen ==
<div class="toccolours mw-collapsible mw-collapsed">
''Testfrage 1''
<div class="mw-collapsible-content">'''Antwort1'''</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed">
''Testfrage 2''
<div class="mw-collapsible-content">'''Antwort2'''</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed">
''Testfrage 3''
<div class="mw-collapsible-content">'''Antwort3'''</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed">
''Testfrage 4''
<div class="mw-collapsible-content">'''Antwort4'''</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed">
''Testfrage 5''
<div class="mw-collapsible-content">'''Antwort5'''</div>
</div>


[[Kategorie:Linux/Dateisystem]]
[[Kategorie:Linux/Datei/Name]]
[[Kategorie:Linux/Datei/Verwaltung]]
[[Kategorie:Linux/Dateisystem/Bereinigen]]
[[Kategorie:Linux/Dateisystem/Befehl]]
[[Kategorie:Zeichenkodierung]]
[[Kategorie:Linux/Befehl]]
[[Kategorie:Linux/Befehl]]
[[Kategorie:Linux/Datei/Dateinamen]]
 
[[Kategorie:Zeichenkodierung]]
Linux/Datei]]
{{DEFAULTSORT:detox}}
{{DEFAULTSORT:detox}}
{{DISPLAYTITLE:detox}}
</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