Detox: Unterschied zwischen den Versionen

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


'''topic''' kurze Beschreibung
== 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
 
** Latin-1-Zeichen (ISO 8859-1), die in 8-Bit-ASCII kodiert sind
$ '''detox -rv files'''
** Unicode-Zeichen, die in UTF-8 kodiert sind
** CGI-Escaped-Zeichen


== Installation ==
== Installation ==
== Anwendungen ==
# apt install detox
=== Fehlerbehebung ===
== Syntax ==
=== Optionen ===
=== Parameter ===
=== Umgebungsvariablen ===
=== Exit-Status ===
== Konfiguration ==
=== Dateien ===
== Sicherheit ==
== Dokumentation ==
=== RFC ===
=== Man-Pages ===
=== Info-Pages ===
== Siehe auch ==
== Links ==
=== Projekt-Homepage ===
=== Weblinks ===
=== Einzelnachweise ===
<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]]
== Aufruf ==
$ '''detox [-hnLrv] [-s sequence] [-f configfile] [--dry-run] [--special] file ...'''


= Manpage =
=== Optionen ===
DETOX(1)                                                        BSD General Commands Manual                                                        DETOX(1)
{| 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&#8209;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
|}


NAME
=== Parameter ===
detox — clean up filenames
=== Umgebung ===
=== Rückgabewert ===


SYNOPSIS
== Anwendungen ==
  detox [-hnLrv] [-s sequence] [-f configfile] [--dry-run] [--special] file ...
  $ '''detox -rv files'''


DESCRIPTION
=== Sequenzen ===
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
; Konfigurierbaren Reihe von Filtern
Latin-1 (ISO 8859-1) characters encoded in 8-bit ASCII, Unicode characters encoded in UTF-8, and CGI escaped characters.
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


Sequences
; Beispiele
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
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
  the -L option.  Some examples of default sequences are iso8859_1 and utf_8.
  $ '''detox -s iso8859_1 -r -v -n /tmp/new_files'''


Options
Auflistung der Sequenzen in my_detoxrc mit Angabe ihrer Filter und Optionen
  The main options:
  $ '''detox -f my_detoxrc -L -v'''


-f configfile
=== Problembehebung ===
Use configfile instead of the default configuration files for loading translation sequences.  No other config file will be parsed.
* 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


-h --help  Display helpful information.
== Konfiguration ==
=== Dateien ===
{| class="wikitable options"
|-
! 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)
|}
<noinclude>


-L          List the currently available sequences.  When paired with -v this option shows what filters are used in each sequence and any properties
== Anhang ==
applied to the filters.
=== Siehe auch ===
{{Special:PrefixIndex/{{BASEPAGENAME}}}}
==== Dokumentation ====
===== Man-Page =====
# detoxrc(5)


-n --dry-run
===== Info-Pages =====
Doesn't actually change anything.  This implies the -v option.
==== Links ====
===== Projekt =====
===== Weblinks =====


-r          Recurse into subdirectories.
[[Kategorie:Linux/Datei/Name]]
[[Kategorie:Linux/Datei/Verwaltung]]
[[Kategorie:Linux/Dateisystem/Bereinigen]]
[[Kategorie:Linux/Dateisystem/Befehl]]
[[Kategorie:Zeichenkodierung]]
[[Kategorie:Linux/Befehl]]


-s sequence
{{DEFAULTSORT:detox}}
Use sequence instead of default.
{{DISPLAYTITLE:detox}}


--special  Works on special files (including links).  Normally detox ignores these files.
</noinclude>
 
-v          Be verbose about which files are being renamed.
 
-V          Show the current version of detox.
 
Deprecated Options
Deprecated Options are options that were available in earlier versions of detox but have lost their meaning and are being phased out.
 
--remove-trailing
Removes _ and - after .'s in filenames.  This was first provided in the 0.9 series of detox.  After the introduction of sequences, it lost
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.
 
FILES
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.
 
EXAMPLES
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.
 
SEE ALSO
inline-detox(1), detoxrc(5), detox.tbl(5).
 
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.
 
AUTHORS
detox was written by Doug Harple.
 
BUGS
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.
 
BSD                                                                  February 11, 2021                                                                  BSD
[[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