Commit 8785ed48 authored by Urs Fleisch's avatar Urs Fleisch
Browse files

Documentation for import from text and import from tags.

parent 1e24faeb
......@@ -539,8 +539,7 @@ den ausgewählten Dateien.</para></listitem>
<guimenuitem>Importieren...</guimenuitem>
</menuchoice></term>
<listitem><para>Der <action>Import Dialog</action> wird verwendet, um Daten
direkt von einem freedb.org Server, von der Web-Schnittstelle von <ulink
url="http://freedb.org">freedb.org</ulink>, von einem MusicBrainz Server,
direkt von einem freedb.org Server, von einem MusicBrainz Server,
von Discogs, Amazon oder anderen Quellen mit Albumtitellisten zu importieren.
</para>
<para id="import-freedb">
......@@ -555,10 +554,7 @@ Die Track Daten eines Albums
werden nach Auswahl geladen, der verwendete freedb.org Server kann
gewählt werden, ebenso der CGI Pfad. Die
importierten Daten werden in der Vorschau des Import Dialogfensters
dargestellt. Um wieder in jenem Fenster zu arbeiten, muss der gnudb.org
Dialog beendet werden - später kann er wieder mit <guibutton>Von
gnudb.org</guibutton> geöffnet werden, und sein Inhalt wird
wiederhergestellt. Wenn man mit den Daten in der Vorschau zufrieden ist,
dargestellt. Wenn man mit den Daten in der Vorschau zufrieden ist,
können sie mit <guibutton>OK</guibutton> importiert werden.
</para>
<para id="import-discogs">
......@@ -608,8 +604,10 @@ Dialog. Das Schließen des Dialogs kann eine Weile dauern, da noch die ganze
MusicBrainz-Maschinerie runtergefahren werden muss.
</para>
<para>
Zum Importieren von Albumdaten in Textform stehen mehrere vorkonfigurierte
<para id="import-text">
Zum Importieren von Albumdaten in Textform öffnet man einen Unterdialog
mit <guibutton>Von Datei/Clipboard</guibutton>.
Dort stehen mehrere vorkonfigurierte
Formate zur Verfügung. Die ersten zwei, "CSV unquoted" und "CSV quoted",
dienen dazu, Daten welche über die Export Funktion exportiert wurden, wieder
zu importieren. Diese Daten können natürlich von einer Tabellenkalkulation
......@@ -660,7 +658,7 @@ Felddaten zu extrahieren und werden von einem &kid3;-spezifischen Feldcode
eingeleitet. Die Codes sind dieselben wie beim Dateinamenformat:
</para>
<itemizedlist>
<itemizedlist id="format-codes">
<listitem><para>%s %{title} Titel (Song)</para></listitem>
<listitem><para>%a %{artist} Interpret (Artist)</para></listitem>
<listitem><para>%l %{album} Album</para></listitem>
......@@ -701,10 +699,69 @@ werden müssen, so kann ein Track nach Drücken der Steuerungs-Taste
und dann an die gewünschte Stelle gezogen werden.
</para>
<para>
Wenn der Import Dialog geöffnet wird, enthält die Tabelle die aktuell
vorhandenen Werte der Tags. Der Tag Typ (Tag 1, Tag 2, Tag 1 und Tag 2) kann
über das <guilabel>Ziel</guilabel> Auswahlfeld selektiert werden. Der Knopf
rechts von diesem Auswahlfeld dient dazu, die Tabelle auf die in den Tags
gespeicherten Werte zurückzusetzen. Über die Markierungsfelder in der ersten
Tabellenspalte können die Stücke gewählt werden, deren Tags importiert werden
sollen. Dies kann z.B. dann nützlich sein, wenn ein Verzeichnis alle Stücke
eines Doppelalbums enthält, aber bloss die Stücke der zweiten CD importiert
werden sollen.
</para>
<para>
Um die Dateien, welche importiert werden, zu identifizieren, können die
Dateinamen oder die vollständigen Pfade in der Tabelle dargestellt
werden. Diese Einstellung ist über das Kontextmenü, welches bei Rechtsklick
auf die Kopfzeile erscheint, möglich.
</para>
<para>
Wie in fast allen Dialogen dient der <guibutton>Einstellungen
speichern</guibutton> Knopf dazu, die dialogspezifischen Optionen und die
Fenstergröße persistent zu speichern.
</para>
<para id="import-tags">
<guibutton>Von Tags</guibutton> führt zu einem Unterdialog, mit welchem sich
Tag Frames mit dem Inhalt aus anderen Tag Frames füllen lassen. Dies kann
dazu benutzt werden, um einfach Informationen zwischen Tags zu kopieren
oder einen Teil des Inhaltes eines Tag Frames zu extrahieren und in einem
anderen Tag Frame einzufügen.
</para>
<para>
Wie beim <link linkend="import-text">Import von Datei/Clipboard</link>
stehen frei konfigurierbare Formate zur Verfügung, um verschiedene Operationen
durchzuführen. Vorkonfigurierte Formate erlauben es beispielsweise, den Wert
des Interpreten zum Album Interpreten, Komponisten oder Leiter zu kopieren,
bei Titeln, welche die Tracknummer enthalten, diese zu extrahieren und im
Tracknummer-Frame zu speichern. Ebenso lässt sich ein Untertitel aus dem
Titel extrahieren.
</para>
<para>
Das Erstellen eines eigenen Importformates wird im folgenden anhand eines
Beispieles erklärt. Die Information im Untertitel soll auch im Kommentar
gesetzt werden. Dazu wird das <guilabel>Format</guilabel> "Custom Format"
ausgewählt und ein neuer Name gesetzt, in diesem Beispiel also "Subtitle to
Comment". Das Format wird hinzugefügt, indem man
im <guilabel>Format</guilabel>-Editierfeld die Enter Taste drückt. Nun gibt
man unter <guilabel>Quelle</guilabel> "%{subtitle}" und
unter <guilabel>Ermittlung</guilabel> "%{comment}(.*)" ein und
klickt <guibutton>Einstellungen speichern</guibutton>.
</para>
<para>
Der Ausdruck in <guilabel>Quelle</guilabel> kann aus
<link linkend="format-codes">Format Codes</link> für beliebige Tag Frames
bestehen, wobei natürlich auch mehrere Codes verwendet werden können, um den
Inhalt verschiedener Frames zu kombinieren. Für jeden Track wird aus den Tags
und dem <guilabel>Quelle</guilabel> Format ein Text erzeugt, und auf diesen
wird dann der reguläre Ausdruck aus <guilabel>Ermittlung</guilabel>
angewendet, um neue Tag Werte zu setzen. Dieser reguläre Ausdruck enthält
Klammerkonstrukte "(..)", um Felddaten zu extrahieren, und die
Klammer-Konstrukte werden vom Format Code des Tag Frames eingeleitet. Es
funktioniert also gleich wie bei den Formaten
zum <link linkend="import-text">Import von Datei/Clipboard
</link>.
</para>
</listitem>
</varlistentry>
......
......@@ -509,8 +509,7 @@ reverted, else only the changes of the selected files are reverted.
<guimenuitem>Import...</guimenuitem>
</menuchoice></term>
<listitem><para>The <action>Import dialog</action> can be used to import data
directly from a freedb.org server, from the Web-interface of <ulink
url="http://freedb.org">freedb.org</ulink>, from a MusicBrainz server, from
directly from a freedb.org server, from a MusicBrainz server, from
Discogs, Amazon or other sources of album track lists in textual format.
</para>
<para id="import-freedb">
......@@ -523,12 +522,10 @@ the albums which match the
query will be displayed when <guibutton>Find</guibutton> is clicked and the
results from <ulink url="http://www.gnudb.org">www.gnudb.org</ulink> are
received. Importing the track data for an album is
done by selecting the album in the list. The freedb.org server to import from
can be selected as well as the CGI path. The
imported data is displayed in the preview table of the import dialog. To work
in that dialog again, the gnudb.org dialog has to be closed - it can be
reopened later by clicking <guibutton>gnudb.org</guibutton> again and
its contents will be restored. When satisfied with the displayed tracks, they
done by double-clicking the album in the list. The freedb.org server to import
from can be selected as well as the CGI path. The
imported data is displayed in the preview table of the import dialog.
When satisfied with the displayed tracks, they
can be imported by terminating the import dialog with
<guibutton>OK</guibutton>.
</para>
......@@ -572,8 +569,10 @@ of them has to be selected by the user.
data, <guibutton>Cancel</guibutton> closes the dialog. The closing can take a
while since the whole MusicBrainz machinery has to be shut down.
</para>
<para>
For the import of textual data, several preconfigured import formats are
<para id="import-text">
For the import of textual data, <guibutton>From File/Clipboard</guibutton>
opens a subdialog, where several preconfigured import formats are
available. The first two, "CSV unquoted" and "CSV quoted" can be used to
import data which was exported by the Export dialog. The CSV data can be
edited with a spreadsheet, and shall be written using tabs as
......@@ -620,7 +619,7 @@ codes to specify which field to capture. The codes are the same as used for
the filename format:
</para>
<itemizedlist>
<itemizedlist id="format-codes">
<listitem><para>%s %{title} Title (Song)</para></listitem>
<listitem><para>%a %{artist} Artist</para></listitem>
<listitem><para>%l %{album} Album</para></listitem>
......@@ -659,10 +658,58 @@ dragged with the left mouse button and the <keycap>Ctrl</keycap> key hold
down, and then dropped at the new location.
</para>
<para>
When the import dialog is opened, it contains the actual contents of the
tags. The tag type (Tag 1, Tag 2, Tag 1 and Tag 2) can be selected using the
<guilabel>Destination</guilabel> combo box. The button on the right of this
combo box can be used to revert the table to the current contents of the
tags. The checkboxes in the first table column can be used to select the
tracks which are imported. This can be useful if a folder contains the tracks
of both CDs of a double CD and only the tracks of the second CD have to be
imported.
</para>
<para>
To identify the tracks which are imported, it is possible to display the file
names or the full paths to the files using the context menu of the table header.
</para>
<para>
Almost all dialogs feature a <guibutton>Save Settings</guibutton> button,
which can be used to store the dialog specific settings and the window size
persistently.
</para>
<para id="import-tags">
<guibutton>From Tags</guibutton> leads to a subdialog to set tag frames from
the contents of other tag frames. This can be used to simply copy information
between tags or extract a part from one frame and insert it in another.
</para>
<para>
As in the <link linkend="import-text">import from file/clipboard</link>,
there are freely configurable formats to perform different operations. Already
preconfigured are formats to copy the Album value to Album Artist, Composer or
Conductor, and to extract the Track Number from Title fields which contain a
number. There is also a format to extract a Subtitle from a Title field.
</para>
<para>
The following example explains how to add a custom format, which sets the
information from the Subtitle field also in the Comment field. Select the
"Custom Format" in <guilabel>Format</guilabel> and set a new name, e.g.
"Subtitle to Comment". The new format is added by pressing the Enter key
inside the <guilabel>Format</guilabel> control. Then enter "%{subtitle}" in
<guilabel>Source</guilabel> and "%{comment}(.*)" for
<guilabel>Extraction</guilabel> and click <guibutton>Save
Settings</guibutton>.
</para>
<para>
The expression in <guilabel>Source</guilabel> can contain
<link linkend="format-codes">format codes</link> for arbitrary tag frames,
multiple codes can be used to combine the contents from different frames. For
each track, a text is generated from its tags using the <guilabel>Source
</guilabel> format, and the regular expression from
<guilabel>Extraction</guilabel> is applied to this text to set new values for
the tags. Format codes are used before the capturing parentheses to specify
the tag frame where the captured text shall be stored. It works in the same
way as for the <link linkend="import-text">import from file/clipboard</link>.
</para>
</listitem>
</varlistentry>
......
......@@ -171,5 +171,5 @@ void TagImportDialog::saveConfig()
*/
void TagImportDialog::showHelp()
{
Kid3App::displayHelp("import");
Kid3App::displayHelp("import-tags");
}
......@@ -232,5 +232,5 @@ void TextImportDialog::saveConfig()
*/
void TextImportDialog::showHelp()
{
Kid3App::displayHelp("import");
Kid3App::displayHelp("import-text");
}
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment