Detox: Unterschied zwischen den Versionen

Aus Foxwiki
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 4: Zeile 4:
== 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 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


$ '''detox -rv files'''
'''detox''' benennt Dateien um, damit sie leichter zu handhaben sind
 
* Entfernt Leerzeichen und andere störende Elemente
== Beschreibung ==
* Übersetzt oder bereinigt
'''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
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.
Latin-1 (ISO 8859-1) characters encoded in 8-bit ASCII, Unicode characters encoded in UTF-8, and CGI escaped characters.


=== HISTORY ===
=== 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
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
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.
Linux, and cause problems when you go to access them. I created detox to clean up these files.


=== Sequences ===
=== 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.
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 ==
== Anwendungen ==
  $ '''detox -rv files'''
  $ '''detox -rv files'''


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


detox -f my_detoxrc -L -v
Will list the sequences within my_detoxrc, showing their filters and options.


=== Fehlerbehebung ===
=== 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.
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.
Long options don't work under Solaris or Darwin.
Zeile 50: Zeile 50:


=== Optionen ===
=== Optionen ===
 
{| class="wikitable sortable options"
-f configfile
|-
Use configfile instead of the default configuration files for loading translation sequences. No other config file will be parsed.
! Unix !! GNU !! Beschreibung
 
|-
-h --help   Display helpful information.
| -f configfile || || Use configfile instead of the default configuration files for loading translation sequences. No other config file will be parsed.
 
|-
-L         List the currently available sequences. When paired with -v this option shows what filters are used in each sequence and any properties
| -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.
applied to the filters.
 
|-
-n --dry-run
| -n || --dry-run || Doesn't actually change anything. This implies the -v option.
Doesn't actually change anything. This implies the -v option.
|-
 
| -r || || Recurse into subdirectories
-r         Recurse into subdirectories.
|-
 
| -s sequence || || Use sequence instead of default
-s sequence
|-
Use sequence instead of default.
|| || --special || Works on special files (including links). Normally detox ignores these files.
 
|-
--special   Works on special files (including links). Normally detox ignores these files.
| -v || || Be verbose about which files are being renamed.
 
|-
-v         Be verbose about which files are being renamed.
| -V || || Show the current version of detox.
 
|}
-V         Show the current version of detox.


==== Deprecated Options ====
==== Deprecated Options ====
Zeile 77: Zeile 78:


--remove-trailing
--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
: 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.
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 ===
=== Parameter ===
Zeile 87: Zeile 86:
== Konfiguration ==
== Konfiguration ==
=== Dateien ===
=== Dateien ===
detoxrc       The system-wide detoxrc file.
{| class="wikitable sortable 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.
! Option !! Beschreibung
unicode.tbl   The default Unicode (UTF-8) translation table.
|-
| 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
|}


[[Kategorie:Linux/Dateisystem]]
[[Kategorie:Linux/Dateisystem]]

Version vom 3. Oktober 2023, 10:34 Uhr

detox bereinigt Dateinamen

Beschreibung

detox benennt Dateien um, damit sie leichter zu handhaben sind

  • Entfernt Leerzeichen und andere störende Elemente
  • Ü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

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

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

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

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

$ 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.

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.

Parameter

Umgebungsvariablen

Exit-Status

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

Linux/Datei