Detox: Unterschied zwischen den Versionen

Aus Foxwiki
K Textersetzung - „== Syntax ==“ durch „== Aufruf ==“
 
(84 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
* 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


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
== Installation ==
Latin-1 (ISO 8859-1) characters encoded in 8-bit ASCII, Unicode characters encoded in UTF-8, and CGI escaped characters.
# apt install detox
 
== Aufruf ==
  $ '''detox [-hnLrv] [-s sequence] [-f configfile] [--dry-run] [--special] file ...'''


=== Sequences ===
=== Optionen ===
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.
{| 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
|}
 
=== Parameter ===
=== Umgebung ===
=== Rückgabewert ===


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


=== EXAMPLES ===
=== Sequenzen ===
detox -s iso8859_1 -r -v -n /tmp/new_files
; Konfigurierbaren Reihe von Filtern
Will run the sequence iso8859_1 recursively, listing any changes, without changing anything, on the files of /tmp/new_files.
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
detox -f my_detoxrc -L -v
* Einige Beispiele für Standardsequenzen sind iso8859_1 und utf_8
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.
; 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'''


== Syntax ==
Auflistung der Sequenzen in my_detoxrc mit Angabe ihrer Filter und Optionen
  $ detox [-hnLrv] [-s sequence] [-f configfile] [--dry-run] [--special] file ...
  $ '''detox -f my_detoxrc -L -v'''


=== Optionen ===
=== Problembehebung ===
=== Parameter ===
* Wenn nach der Übersetzung eines Dateinamens bereits eine Datei mit demselben Namen existiert, wird Detox die Datei nicht umbenennen
=== Umgebungsvariablen ===
* 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
=== Exit-Status ===
* 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-Homepage ===
==== 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:Entwurf]]
[[Kategorie:Linux/Datei/Name]]
[[Kategorie:Linux/Datei/Verwaltung]]
[[Kategorie:Linux/Dateisystem/Bereinigen]]
[[Kategorie:Linux/Dateisystem/Befehl]]
[[Kategorie:Zeichenkodierung]]
[[Kategorie:Linux/Befehl]]


= Manpage =
{{DEFAULTSORT:detox}}
{{DISPLAYTITLE:detox}}


== HISTORY ==
</noinclude>
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.
 
[[Kategorie:Linux:Befehl]]
[[Kategorie:Linux:Dateien]]
{{DEFAULTSORT:detox}}

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