typeset_audio_dirp - En ligne dans le Cloud

PROGRAMME:

Nom

typeset_audio_dir - produit une liste TeX des répertoires avec des fichiers audio.

SYNOPSIS

# Ex : le répertoire courant contient 1 sous-répertoire par interprète.
# A l'intérieur de chaque répertoire, la structure est
# Compositeur/single*.mp3 (sortie à grain fin : champ)
# et
# Composer/MultiPart/part*.mp3 (sortie à grain fin : champ)
# Émettre des informations sur l'année et la durée ; utiliser "Quartets" comme nom de base
typeset_audio_dir -y -T -B Quatuors *

# De même, mais cette structure de répertoire est par rapport au répertoire courant ;
# N'émet pas l'année et la durée, sortie vers STDOUT
typeset_audio_dir .
typeset_audio_dir

# Utilisez l'artiste comme titre de premier niveau, l'album comme 2ème niveau ; utiliser des numéros de piste ;
# le nom est basé sur le titre pour n'importe quelle profondeur dans la hiérarchie des répertoires ;
# de même pour la génération d'en-tête de 2ème niveau. Marquer les audios avec les paroles
typeset_audio_dir -ynTL -P long -B Tous

# De même, mais le nom est basé sur l'album ; ignorer les commentaires
typeset_audio_dir -yTn -P court -B All_short

# De même, mais produisez à la fois des listes longues et courtes. Le court sert
# comme table des matières pour la longue
typeset_audio_dir -ynTL -P court, long -B Tous

DESCRIPTION

Scanne le répertoire (ou les répertoires) donné sur la ligne de commande, en utilisant MP3::Tag pour obtenir
informations sur les fichiers audio (pour traiter les fichiers non MP3, des modules supplémentaires peuvent être nécessaires, voir
MP3::Tag, et -r FILENAME_FILTER l'option doit être donnée). Produit (un ou plusieurs, selon
on -B option) Texas fichiers avec des commandes pour composer des listes lisibles par l'homme. Non-répertoires
sur la ligne de commande sont ignorés. (Peut également être utilisé pour traiter des fichiers non audio, si
MP3::Tag peut en extraire les informations sur le titre/etc.)

Chez -B, le fichier *_list.tex contient toutes les données sur les fichiers audio (quand -P avec les deux
"short,long" est donné, un autre fichier similaire *_list_long.tex est également écrit); le fichier
*_titles.tex contient une 0ème approximation du "titre" possible de la collection (un
à base d' -N option et un bref résumé des répertoires de premier niveau). Le fichier *_common.tex
contient des macros communes aux fichiers suivants. Les fichiers restants définissent différents
environnements pour composer la liste (y compris deux fichiers TeX avec « contenu » selon les besoins) : un
listing "normal" (pour A4/Lettre, *_texte.tex), deux versions d'une liste « compressée » (pour
insertion de cas de bijou, *_cdbooklet.tex et *_cdcover.tex), et un insert arrière pour le bijou
Cas (*_backcover.tex).

L'intention est de prendre en charge de nombreuses dispositions différentes de répertoires avec des fichiers audio avec comme
peu de bricolage possible avec les options de ligne de commande ; ainsi "type_audio_dir" essaie de faire
autant que possible par des estimations. Simultanément, on devrait être capable de régler le script
pour gérer la mise en page qu'ils ont.

Le script émet des en-têtes pour plusieurs niveaux de "regroupement". L'en-tête de groupe "toplevel" est
émis une fois pour chaque répertoire "toplevel" (avec les fichiers audio), d'autres en-têtes sont émis
sur la base des changements dans les descripteurs des fichiers audio pendant l'analyse.

OPTIONS

-B donne le nom de base du fichier de sortie. Sans cette option, le script sortira vers
STDOUT. Avec cette option, le script sépare la mise en page du contenu et produit 6
Texas fichiers:

nom_base_texte.tex
nom_base_cdcover.tex
nom_base_cdbooklet.tex
nom_base_backcover.tex
basename_list.tex
nom_base_titres.tex
nom_base_commun.tex

Le dernier fichier contient les macros courantes nécessaires à la composition. Les deux précédents
fichiers contiennent les informations sur les fichiers audio rencontrés. Les autres fichiers contiennent
cadres pour composer ces informations.

Les quatre premiers fichiers sont censés être modifiables par l'homme ; ils ne seront pas écrasés
par une réexécution suivante avec le même nom de base donné au script. En éditant ces
fichiers, on peut choisir entre plusieurs encodages, langues, sortie multicolonne, police
taille, interligne, marges, taille de la page, etc.

Le fichier "*_titles.tex" est de nature mixte : il reflète le contenu des fichiers audio,
et est censé être modifiable par l'homme. Il sera écrasé à moins qu'il ne soit en lecture seule ;
donc si vous le modifiez à la main, rendez-le en lecture seule. Une logique d'écrasement similaire est appliquée à
Le fichier "*_common.tex" aussi.

-P "plan"
un raccourci pour définir des options velues ; actuellement, deux valeurs de « plan » sont prises en charge :

court => -1 "" -2 "" -t -1e100 -a -1e100 -c
long => -1 "" -2 "@l" -t 1e100 -a 1e100

pour la génération d'annonces courtes/longues. Dans la liste restreinte, les enregistrements correspondent à
les noms des albums. Dans la liste longue, les enregistrements correspondent à des fichiers individuels, et
les noms d'album servent de titres de deuxième niveau.

-y Émettre les informations sur l'année (ou la date) si elles sont présentes. Descripteurs de date très longue (par exemple, quand
plusieurs plages de dates sont présentes) sont compressées autant que possible.

-Y Émettre l'information de date entière si elle est présente.

-T Émettre des informations sur la durée.

-n Activer l'émission du numéro de piste. La variable d'environnement TYPESET_AUDIO_TRACK peut contenir le
format à interpoler pour la composition (par défaut, "%{mA}%{n1}"). Par exemple, définissez
TYPESET_AUDIO_TRACK à "%{n1}" pour utiliser le numéro de piste "pur" au lieu de la combinaison de
numéro de support/disque et numéro de piste.

-1 Format d'en-tête de niveau supérieur ; est interpoler()d by MP3::Tag basé sur le contenu du
premier fichier audio rencontré lors de l'analyse de ce répertoire de niveau supérieur. La valeur vide
est la valeur par défaut ; dans ce cas l'en-tête est basé sur le nom du répertoire (avec
une certaine normalisation : le trait de soulignement est converti en espace).

-2 Format d'en-tête de deuxième niveau ; est interpoler()d par MP3::Tag. Calculé sur la base du
contenu de chaque fichier audio. L'en-tête est émis lorsque la valeur interpolée change
(sous réserve d'option -a).

Une chaîne vide désactive la génération.

-a Ignorer les modifications apportées à l'en-tête de deuxième niveau pour les répertoires plus profonds que celui-ci à l'intérieur
répertoire de niveau supérieur. La valeur par défaut est 2. Par exemple, dans

Interprète/Compositeur/Collection/part1.mp3
Interprète/Compositeur/Collection/part2.mp3
Interprète/Compositeur/single1.mp3
Interprète/Compositeur/single2.mp3

si le répertoire de niveau supérieur est Performer, puis les modifications de l'en-tête de deuxième niveau dans
seul*.mp3 créerait un nouveau titre de deuxième niveau. Cependant, des changements similaires dans
partie*.mp3 ne créera pas de nouvelle rubrique.

NOTE: peut-être que ce défaut de 2 n'est pas très intuitif. Il est recommandé de préciser explicitement
définissez cette option sur la valeur que vous jugez appropriée (1e100 jouerait le rôle de l'infini -
donc tout changement générera un nouveau titre de deuxième niveau).

-t La profondeur de coupure du titre (par rapport au répertoire de niveau supérieur). La valeur par défaut est 2. Dans les fichiers audio
plus profond que cela, l'album %l est utilisé comme nom ; sinon le titre %t de l'audio
fichier est utilisé.

Défini sur "-1e100" pour toujours utiliser %l et sur 1e100 pour toujours utiliser %a.

-@ Remplacez tous les "@" par "%" dans les options. Très utile avec les coques DOSISH à inclure
"%"-échappements nécessaires pour MP3::Tag's interpoler().

-e ENCODAGES
Définit les encodages pour les fichiers de sortie, les noms de répertoire (lorsqu'il est utilisé pour générer des en-têtes) et
fichiers d'indices. ENCODAGES est une liste de directives séparées par des virgules ; chaque directive est
soit un nom d'encodage (à utiliser pour toutes les cibles), soit "TARGET_LETTERS:encoding".
Les lettres cibles sont "o", "d" et "h" pour la sortie, les noms de répertoires et de fichiers
.top_heading en conséquence. Utilisez 0 au lieu d'un encodage pour faire orienté octet
lire écrire.

-c Quoi utiliser comme "commentaire" pour un enregistrement (une partie qui est composée différemment). Si non
donné, le cadre ID3v2 "TXXX[add-to:file-by-person,l,t,n]" est utilisé.

Si le contenu de ce champ est contenu à la fin du titre, rien n'est ajouté, juste
cette partie est composée différemment.

-L Marquez les fichiers avec des paroles et des images intégrées (non) synchronisées. Mettez l'explication de
symboles utilisés à la fin de la liste.

-N COLLECTION_NAME
(par défaut "COLLECTION") le nom de la collection à insérer dans le fichier
*_titre.tex. L'interaction avec l'encodage peut être moins qu'intuitif ; vous voudrez peut-être
pour vérifier/éditer ce fichier pour les corrections.

-F FONT_ENCODING_SYMBOL
(par défaut "T2A") : le nom de l'encodage de la police "LaTeX". Si votre installation est
cassé et "T2A" n'est pas disponible, vous pouvez essayer "T1" ou "OT1". Voir « PROBLÈMES lorsque
TYPOGRAPHIE".

-r FILENAME_FILTER
définit l'expression régulière pour les noms de fichiers à rechercher (la valeur par défaut est "(?i:\.mp3$)".

Info lire de filet Système

Les fichiers suivants sont utilisés pour donner des conseils à typeset_audio_dir:

.content_commentaire
Le contenu de ce fichier est utilisé comme champ de commentaire dans la sortie pour tous les fichiers de ce
répertoire.

.top_heading
Si vide, indique que lorsque la profondeur des fichiers modifie la sortie, elle est calculée
par rapport aux sous-répertoires du répertoire de ce fichier (ouph !). Si contient un
nombre, il est ajouté à cette profondeur.

Exemple: supposons que votre en-tête de section soit basé sur des noms de répertoire. Supposons que le
l'arborescence des répertoires à traiter contient un répertoire Mixte/2009. Si vous voulez des noms de
sous-répertoires de ce répertoire pour devenir des en-têtes de section, make file
Mixte/2009/.top_heading qui contient 0. S'il en est de même pour les autres sous-répertoires
of Mixte, au lieu de créer un tel fichier dans tous les sous-répertoires de l'année, on peut faire
filet Mixte/.top_heading qui contient "-1".

Sinon, le contenu de ce fichier est utilisé comme en-tête de niveau supérieur pour ce répertoire.

TYPOGRAPHIE

L'exécution de ce script ne générera que les fichiers TeX nécessaires, mais ne les composera pas
(ils seront bien meilleurs si vous modifiez d'abord les fichiers en fonction de vos besoins). Rappelez-vous comment
pour composer des documents TeX (ici, nous supposons une cible PDF) :

latex document.tex && dvips document.dvi && ps2pdf document

(beaucoup de fichiers temporaires vont aussi être générés ; vous pouvez le diviser en plusieurs
commandes sur "&&"). Certains fichiers (par exemple, ..._cdcover.tex) correspond mieux au paysage
orientation; il faut

latex document.tex && dvips -t paysage document.dvi && ps2pdf document

Chez ..._cdbooklet.tex, pour un meilleur résultat, il vaut mieux réorganiser les pages pour le livret 2up
Impression 2 pages par face :

document latex.tex
&& dvips -t paysage -f < document.dvi | livre ps | pstops "2:0(0,-6cm)+1(0,6cm)" > document.ps
&& ps2pdf -dAutoRotatePages=/Aucun document

(le tout sur une seule ligne, ou donnez 3 commandes séparées, en interrompant sur "&&"; plus de détails sur l'exécution
dvips est placé au début du fichier TeX). Si vous pouvez facilement imprimer un .ps fichier, vous
peut omettre la dernière étape. (L'option "-dAutoRotatePages=/None" interfère avec la visualisation ;
on peut l'omettre à moins que on fait un "retournement supplémentaire des pages paires", comme ci-dessous.)

Notez que cela suppose que lorsque vous envoyez des fichiers à l'imprimante, vous demandez l'impression recto verso avec
"reliure sur le petit côté du papier". Si votre imprimante peut survivre à l'impression recto verso manuelle, procédez comme
habituel : imprimer d'abord les pages paires dans l'ordre inverse, recharger le papier, puis imprimer les pages impaires
(il faut savoir dans quel sens remettre le papier lors du rechargement ; il
sont 4 variantes, et une seule est correcte ;-). Pour les "vraies" imprimantes recto verso, voir ci-dessous.

PROBLÈMES quand TYPOGRAPHIE

installations incomplètes
! Police T2A/cmr/m/n/10.95=larm1095 à 10.95pt non chargeable :
Fichier métrique (TFM) introuvable.

Pour la meilleure couverture multilingue que j'ai pu trouver, par défaut, les fichiers LaTeX générés utilisent
Polices encodées "T2A" avec des caractères latins supplémentaires fournis par "textcomp". Apparemment,
certaines installations "TeX" omettent les tables de codage "T2A". Vous voudrez peut-être remplacer « T2A » par,
par exemple, "T1" en utilisant l'option "-F T1".

Dans un livret, la page 1 est à la fin, le reste est le bordel
L'option « paysage » du package « géométrie » doit faire pivoter la page de 90 degrés.
Selon la façon dont il est configuré, le sens de rotation varie. Si . Pdf filet
obtenu avec l'option "-dAutoRotatePages=/None" a le haut de la page sur la gauche, vous pouvez
besoin d'inverser le sens du décalage : au lieu de "2:0(0,-6cm)+1(0,6cm)" il faut
use "2:0(0,6cm)+1(0,-6cm)".

Recto verso avec "reliure sur le côté long du papier"
Par défaut, la plupart des imprimantes recto verso sont configurées pour « lier sur le côté long du papier » ;
donc pour éviter la configuration manuelle des options de reliure, vous pouvez retourner les pages paires dans le
fichier généré. Pour ce faire, ajoutez un supplément ps2ps étape à la fin du pipeline, par exemple :

... psbook | pstops "2:0(0,-6cm)+1(0,6cm)" | pstops "2:0,1U(1w,1h)" > document.ps

Papier au format A4 par rapport au papier au format Lettre
Certaines installations TeX/PS n'ont pas de fichiers de configuration de site correctement configurés.
ne sais pas quel est le format de papier habituel sur votre imprimante. Heureusement, toutes les étapes du
pipeline de composition permettent une reconfiguration manuelle. Malheureusement, les options de commande
car les reconfigurations requises sont subtilement différentes pour différentes étapes.

Par exemple, si vos TeX/PS-utils pensent que le format de votre papier est "lettre", alors que quoi
vous imprimez réellement vers "a4", vous devez faire ce qui suit (en fonction de
les fichiers de configuration sont cassés, vous pourrez peut-être omettre certaines modifications) :

1. Ajoutez "a4paper" aux options "\usepackage[...,...]{geometry}" (les
liste entre parenthèses) dans les fichiers TeX qui utilisent la "géométrie".

2. Ajoutez "-t a4" en tant qu'options "dvips".

3. Ajoutez "-pa4" comme option "pstops". (S'il interrompt la rotation, omettez-le, soupir !)

4. Ajoutez "-sPAPERSIZE=a4" comme option "ps2pdf".

Exemple de ligne de commande fonctionnant avec certaines complications

dvips -t paysage -f < All_cdbooklet-a4.dvi | livre ps | pstops -pa4 "2:0(0,-6cm)+1(0,6cm)" | pstops -pa4 "2:0,1U(1w,1h)" > Sortie-even_retourné-a4.ps
&& ps2pdf -sPAPERSIZE=a4 -dAutoRotatePages=/Aucune sortie-even_flipped-a4

De même, assez souvent, il faut ajouter "-pletter" aux lignes de commande "ps2ps" pour
impression sur papier de format lettre. Vous pouvez vérifier le fichier PDF obtenu dans une visionneuse : le
la ligne d'état doit afficher le format de papier correct (par exemple, 8.5 pouces x 11 pouces est « Lettre »), même
les pages doivent être retournées (pour la reliure "sur le côté long"), et les wireframes sur
différentes pages doivent être positionnées exactement aux mêmes positions (pour
vérification, choisissez la mise à l'échelle « à la page » et changez rapidement de page en
clavier ou par le bouton "Page suivante").

Avertissements de dvips
Notez également que si votre installation "TeX/dvips" est complètement correct, vous pouvez supprimer
"-t landscape" depuis votre ligne de commande "dvips" ; ne pas le supprimer produirait un avertissement
« à la fois le paysage et le format de papier spécifiés : en ignorant le paysage ».

Décalage recto verso systématique
Certaines imprimantes ne peuvent pas faire correspondre de manière fiable les positions du recto et du verso lors de l'impression ;
il n'y a pas grand chose à faire avec. Cependant, si votre imprimante ajoute des cohérent
mauvais placement des faces avant et arrière, on peut y remédier.

Par exemple, lors de la "reliure sur le côté court", l'erreur courante est que (en mode paysage
orientation) l'arrière est décalé horizontalement par rapport à l'avant. Par exemple, si le décalage
est de 3.4 mm vers la gauche, on peut décaler l'image sur la page de moitié, 0.17 cm à
the left: replace "2:0(0,-6cm)+1(0,6cm)" by "2:0(0,-6.17cm)+1(0,5.83cm)".

Avec la « reliure sur le côté long », l'erreur typique est le décalage vertical. Travailler
autour, il faut se déplacer verticalement (encore une fois, de la moitié du montant) après retournant même
pages. Pour décaler 0.17 cm vers le haut, ajoutez une étape supplémentaire "pstops " (0.17 cm, 0) "" au pipeline
après l'étape "2:0,1U(1w,1h)" (non testé).

ASTUCES

Les tailles de police par défaut et la densité de type sont choisies pour optimiser l'impression d'un DL-DVD
collection d'audio court de haute qualité (d'une durée semblable à une chanson : environ 100 sous-titres, et
2000 fichiers audio). Vous pouvez améliorer la qualité visuelle si vous adaptez la composition à votre
besoins particuliers.

Les paramètres les plus fréquemment modifiés se trouvent au-dessus des fichiers générés. Ce sont des polices et
degrés de compression verticale des paragraphes pour le titre principal, les titres des sections (1er
niveau) et des sous-sections (2e niveau), et des enregistrements réels émis pour chaque fichier audio, comme
ainsi que le nombre de colonnes. Un peu plus loin dans le fichier se trouvent les paramètres des écarts à gauche
autour des en-têtes de section et pour affiner la compression.

N'oubliez pas que si vous ne pouvez pas décrire une mise en page compliquée par des options de ligne de commande, vous
avez toujours la possibilité d'exécuter ce script plusieurs fois (une fois par répertoire avec "handable
mise en page", en utilisant -B et d'autres options adaptées à ce sous-répertoire). Ensuite, vous pouvez utiliser
Latex Directives "\input" pour inclure les basename_list.tex fichiers dans le
fichier "LaTeX" de niveau supérieur.

Vous pouvez aussi redéfinir "\preSection * \postSection" pour ne rien faire, et mettre le nécessaire
code pour générer les en-têtes dans le fichier de niveau supérieur.

Modifiez les macros de formatage en fonction de vos besoins. (Pour les trucs plus délicats, mentionnez
"\squeezeContunuationLines" et "\parskip", qui régulent la densité des lignes - sans
changer la police de ligne ; notez que le réglage "\parskip" fait partie de l'action de
"\squeezeContunuationLines". "\columnsep" règle la séparation horizontale des colonnes.
On peut aussi affiner la position verticale du début de la première page ; pour
couverture arrière, réglez également "\CDbackMargin" et "\CDbackTopMargin". La ou les définitions de
"\squeezeContunuationLines" sont commentés (par "%") en non-*_common.tex des dossiers; tu peux
décommentez-le et réglez-le séparément pour chaque fichier TeX.)

On peut combiner deux (ou plusieurs) listes (par exemple, une avec le style court et une avec le style long
style) dans un fichier de sortie ; les fichiers générés ..._cdbooklet.tex et ..._texte.tex
ont déjà un modèle nécessaire (désactivé) à la fin. (De plus, avec -P "court long",
cela se fait automatiquement.

Par exemple, avec deux listes créées dans "SYNOPSIS", All_list.tex et All_short_list.tex,
trouver "\iffalse" vers la fin de All_short_cdbooklet.tex et remplacez-le par "\iftrue" ; alors
changer le nom dans la directive

\input{autre_liste}

à Toutes_liste

Cela fera du cdbooklet "court" une sorte de "table des matières" pour le combiné
Livret "court+long". (Bien entendu, on peut changer les valeurs des macros "\SectionFont"
etc, "\COLUMNS", type de compression en fonction de vos besoins - le fait est qu'elles ne doivent pas être
nécessairement la même pour la deuxième liste.)

FLUX DE TRAVAIL

Le module est assez flexible ; voici l'un des workflows possibles (convient si tous vous
le besoin est -P et -P :

Mettez tous les répertoires "toplevel" comme sous-répertoires du répertoire courant (enfin, ce
n'est pas vraiment nécessaire !), et mettez le titre à utiliser pour chaque répertoire dans un fichier
.top_heading. Vous devrez peut-être spécifier l'encodage utilisé dans ce fichier dans les options (faites
similaire à "-eh:cp1252").

Utilisez typeset_audio_dirp en ligne à l'aide des services onworks.net