typeset_audio_dirp - Online nel cloud

PROGRAMMA:

NOME

typeset_audio_dir - produce un elenco TeX di directory con file audio.

SINOSSI

# Es: la directory corrente contiene 1 sottodirectory-per-esecutore.
# All'interno di ogni directory la struttura è
# Composer/single*.mp3 (output a grana fine: campo)
# e
# Composer/MultiPart/part*.mp3 (output a grana fine: campo)
# Emetti informazioni su anno e durata; usa "Quartetti" come nome di base
typeset_audio_dir -y -T -B Quartetti *

# Allo stesso modo, ma questa struttura di directory è rispetto alla directory corrente;
# Non emettere anno e durata, output su STDOUT
typeset_audio_dir .
typeset_audio_dir

# Usa artista come titolo di primo livello, album come secondo livello; utilizzare i numeri di traccia;
# il nome è basato sul titolo per qualsiasi profondità nella gerarchia di directory;
# analogamente per la generazione dell'intestazione di 2° livello. Contrassegna gli audio con i testi
typeset_audio_dir -ynTL -P lungo -B Tutto

# Allo stesso modo, ma il nome è basato sull'album; ignora i commenti
typeset_audio_dir -yTn -P breve -B All_short

# Allo stesso modo, ma produce elenchi sia lunghi che brevi. Quello corto serve
# come sommario per quello lungo
typeset_audio_dir -ynTL -P breve, lungo -B Tutto

DESCRIZIONE

Esegue la scansione della directory (o delle directory) fornite sulla riga di comando, utilizzando MP3::Tag per ottenere
informazioni sui file audio (per elaborare file non MP3, potrebbero essere necessari moduli aggiuntivi, vedere
MP3::Tag, e -r NOMEFILE_FILTER l'opzione deve essere data). Produce (uno o più, a seconda
on -B opzione) TeX file con comandi per comporre elenchi leggibili dall'uomo. Non-directory
sulla riga di comando vengono ignorati. (Può essere utilizzato anche per elaborare file non audio, se
MP3::Tag può estrarre da loro le informazioni sul titolo/ecc.)

Con -B, il file *_lista.tex contiene tutti i dati sui file audio (quando -P con entrambi
viene dato "corto, lungo", un altro file simile *_list_long.tex è anche scritto); il file
*_titoli.tex contiene un'approssimazione 0 al possibile "titolo" della raccolta (uno
su un totale di -N opzione e un breve riassunto delle directory di primo livello). Il file *_comune.tex
contiene macro comuni per i seguenti file. I file rimanenti definiscono diversi
ambienti per comporre l'elenco (inclusi due file TeX con "contenuto" secondo necessità): a
elenco "normale" (per A4/Lettera, *_testo.tex), due versioni di un elenco "compresso" (per
inserto portagioielli, *_cdbooklet.tex e *_cdcover.tex), e un inserto posteriore per il gioiello
Astuccio (*_backcover.tex).

L'intento è quello di supportare molti diversi layout di directory con file audio con as
poco armeggiare possibile con le opzioni della riga di comando; quindi "type_audio_dir" prova a fare
quanto più possibile dagli ospiti. Allo stesso tempo, si dovrebbe essere in grado di mettere a punto la sceneggiatura
per gestire il layout che hanno.

Lo script emette intestazioni per diversi livelli di "raggruppamento". L'intestazione del gruppo "livello superiore" è
emesso una volta per ogni directory "di livello superiore" (con file audio), vengono emesse ulteriori intestazioni
in base alle modifiche dei descrittori dei file audio durante la scansione.

VERSIONI

-B fornisce il nome di base del file di output. Senza questa opzione lo script verrà restituito a
STDOUT. Con questa opzione, lo script separa il layout dal contenuto e produce 6
TeX File:

nomebase_testo.tex
nomebase_cdcover.tex
nomebase_cdbooklet.tex
nomebase_backcover.tex
basename_list.tex
nomebase_titoli.tex
nomebase_comune.tex

L'ultimo file contiene le macro comuni necessarie per la composizione. I due precedenti
file contengono le informazioni sui file audio incontrati. Gli altri file contengono
framework per comporre queste informazioni.

I primi quattro file dovrebbero essere modificabili dall'uomo; non verranno sovrascritti
da una successiva ripetizione con lo stesso nome di base dato allo script. Modificando questi
file, si può scegliere tra diverse codifiche, lingue, output multicolonna, font
dimensione, interlinea, margini, dimensione della pagina, ecc.

Il file "*_titles.tex" è di natura mista: riflette il contenuto dei file audio,
e dovrebbe essere modificabile dall'uomo. Verrà sovrascritto a meno che non sia di sola lettura;
quindi se lo modifichi manualmente, rendilo di sola lettura. Una logica di sovrascrittura simile viene applicata a
Anche il file "*_common.tex".

-P "Piano"
una scorciatoia per impostare opzioni pelose; attualmente, sono supportati due valori di "plan":

breve => -1 "" -2 "" -t -1e100 -a -1e100 -c
lungo => -1 "" -2 "@l" -t 1e100 -a 1e100

per la generazione di elenchi brevi/lunghi. Nell'elenco abbreviato, i record corrispondono a
i nomi degli album. Nell'elenco lungo, i record corrispondono a singoli file e
i nomi degli album fungono da titoli di secondo livello.

-y Emetti le informazioni sull'anno (o sulla data) se presenti. Descrittori di data molto lunghi (ad esempio, quando
sono presenti più intervalli di date) sono compressi il più possibile.

-Y Emetti tutte le informazioni sulla data, se presenti.

-T Emetti informazioni sulla durata.

-n Abilita emetti numero di traccia. La variabile d'ambiente TYPESET_AUDIO_TRACK può contenere il
formato da interpolare per la composizione (il valore predefinito è "%{mA}%{n1}"). Ad esempio, imposta
TYPESET_AUDIO_TRACK su "%{n1}" per utilizzare il numero di traccia "puro" invece della combinazione di
numero di supporto/disco e numero di traccia.

-1 Formato dell'intestazione di primo livello; è interpolare()d da MP3::Tag in base al contenuto del
primo file audio incontrato durante la scansione di questa directory di primo livello. Il valore vuoto
è l'impostazione predefinita; in questo caso l'intestazione è basata sul nome della directory (con
qualche normalizzazione: il carattere di sottolineatura viene convertito in spazio).

-2 Formato intestazione di secondo livello; è interpolare()d da MP3::Tag. Calcolato in base al
contenuto di ogni file audio. L'intestazione viene emessa quando cambia il valore interpolato
(soggetto a opzione -a).

La stringa vuota disabilita la generazione.

-a Ignora le modifiche all'intestazione di secondo livello per le directory più profonde di questa all'interno
directory di primo livello. Il valore predefinito è 2. Ad esempio, in

Interprete/Compositore/Collezione/parte1.mp3
Interprete/Compositore/Collezione/parte2.mp3
Interprete/Compositore/singolo1.mp3
Interprete/Compositore/singolo2.mp3

se la directory di primo livello è Esecutore, quindi modifiche dell'intestazione di secondo livello in
singolo*.mp3 creerebbe una nuova intestazione di secondo livello. Tuttavia, cambiamenti simili in
parte*.mp3 non creerà una nuova intestazione.

NOTA: forse questo valore predefinito di 2 non è molto intuitivo. Si raccomanda di esplicitamente
imposta questa opzione sul valore che ritieni appropriato (1e100 giocherebbe il ruolo di infinito -
quindi qualsiasi modifica genererà una nuova intestazione di secondo livello).

-t La profondità di taglio del titolo (rispetto alla directory di primo livello). Il valore predefinito è 2. Nei file audio
più profondo di questo l'album %l è usato come nome; altrimenti il ​​titolo %t dell'audio
viene utilizzato il file.

Imposta su "-1e100" per usare sempre %l e su 1e100 per usare sempre %a.

-@ Sostituisci tutto "@" con "%" nelle opzioni. Molto utile con le shell DOSISH da includere
"%"-escape necessari per MP3::Tag's interpolare().

-e CODICI
Imposta le codifiche per i file di output, i nomi delle directory (quando viene utilizzato per generare le intestazioni) e
file di suggerimento. CODICI è un elenco di direttive separate da virgole; ogni direttiva è
un nome di codifica (da utilizzare per tutti i target) o "TARGET_LETTERS:encoding".
Le lettere di destinazione sono "o", "d" e "h" per output, nomi di directory e file
.intestazione_superiore corrispondentemente. Usa 0 invece di una codifica per fare l'orientamento ai byte
leggere scrivere.

-c Cosa usare come "commento" per un record (una parte che è composta in modo diverso). Altrimenti
dato, viene utilizzato il frame ID3v2 "TXXX[add-to:file-by-person,l,t,n]".

Se il contenuto di questo campo è contenuto alla fine del titolo, non viene aggiunto nulla, solo
questa parte è composta in modo diverso.

-L Contrassegna i file con testi e immagini incorporati (non) sincronizzati. Metti la spiegazione di
simboli utilizzati alla fine dell'elenco.

-N COLLEZIONE_NOME
(il valore predefinito è "COLLECTION") il nome della raccolta da inserire nel file
*_titolo.tex. L'interazione con la codifica può essere tutt'altro che intuitiva; potresti volere
per controllare/modificare questo file per le correzioni.

-F FONT_ENCODING_SYMBOL
(predefinito su "T2A"): il nome della codifica dei caratteri "LaTeX". Se la tua installazione è
rotto e "T2A" non è disponibile, puoi provare "T1" o "OT1". Vedere "PROBLEMI quando
COMPOSIZIONE".

-r NOMEFILE_FILTER
imposta l'espressione regolare per i nomi dei file da cercare (il valore predefinito è "(?i:\.mp3$)".

Info read da filetto sistema

I seguenti file sono usati per dare suggerimenti a typeset_audio_dir:

.commento_contenuto
Il contenuto di questo file viene utilizzato come campo di commento nell'output per tutti i file in questo
directory.

.intestazione_superiore
Se vuoto, indica che quando la profondità dei file modifica l'output, viene calcolato
wrt le sottodirectory della directory di questo file (ouph!). Se contiene a
numero, viene aggiunto a questa profondità.

Esempio: supponiamo che l'intestazione della tua sezione sia basata sui nomi delle directory. Supponiamo che il
l'albero delle directory da elaborare contiene una directory Misto/2009. Se vuoi i nomi di
sottodirectory di questa directory per diventare intestazioni di sezione, make file
Misto/2009/.top_heading che contiene 0. Se lo stesso vale per altre sottodirectory
of Misto, invece di creare tale file in tutte le sottodirectory dell'anno, si può fare
filetto Misto/.top_heading che contiene "-1".

In caso contrario, il contenuto di questo file viene utilizzato come intestazione di livello superiore per questa directory.

COMPOSIZIONE

L'esecuzione di questo script genererà solo i file TeX necessari, ma non li caratterizzerà
(saranno molto meglio se prima modifichi i file in base alle tue esigenze). Ricorda come
per comporre documenti TeX (qui assumiamo destinazione PDF):

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

(verranno generati anche molti file temporanei; puoi suddividerli in più file
comandi su "&&"). Alcuni dei file (ad es. ..._cdcover.tex) si adatta meglio al paesaggio
orientamento; uno ha bisogno

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

Con ..._cdbooklet.tex, per il miglior risultato, è meglio riorganizzare le pagine per il libretto 2up
Stampa di 2 pagine per lato:

documento in lattice.tex
&& dvips -t landscape -f < document.dvi | psbook | pstops "2:0(0,-6cm)+1(0,6cm)" > document.ps
&& ps2pdf -dAutoRotatePages=/Nessuno documento

(tutto su una riga, o dare 3 comandi separati, interrompendo su "&&"; maggiori dettagli sull'esecuzione
dvips viene messo all'inizio del file TeX). Se riesci a stampare facilmente un .ps file, tu
può omettere l'ultimo passaggio. (L'opzione "-dAutoRotatePages=/None" interferisce con la visualizzazione;
si può ometterlo salvo che si fa "lancio extra di pagine pari", come di seguito.)

Si noti che ciò presuppone che quando si inviano file alla stampante si richieda la stampa fronte/retro con
"rilegatura sul lato corto della carta". Se la tua stampante può sopravvivere alla stampa fronte/retro manuale, fai come
al solito: stampa prima le pagine pari in ordine inverso, ricarica la carta, quindi stampa le pagine dispari
(bisogna capire in quale orientamento si deve rimettere la carta quando si ricarica; lì
sono 4 varianti, e solo una è corretta ;-) . Per le stampanti duplex "reali", vedere di seguito.

PROBLEMI quando COMPOSIZIONE

installazioni incomplete
! Carattere T2A/cmr/m/n/10.95=larm1095 a 10.95pt non caricabile:
File di metrica (TFM) non trovato.

Per la migliore copertura multilingue che ho potuto trovare, per impostazione predefinita vengono utilizzati i file LaTeX generati
Caratteri codificati "T2A" con caratteri latini extra forniti da "textcomp". Apparentemente,
alcune installazioni "TeX" omettono le tabelle di codifica "T2A". Potresti voler cambiare "T2A" in,
ad esempio, "T1" utilizzando l'opzione "-F T1".

In un libretto, la pagina 1 è alla fine, il resto è un casino
L'opzione "paesaggio" del pacchetto "geometria" dovrebbe ruotare la pagina di 90 gradi.
A seconda del modo in cui è configurato, il senso di rotazione varia. Se .pdf filetto
ottenuto con l'opzione "-dAutoRotatePages=/None" ha la parte superiore della pagina a sinistra, potresti
necessario invertire la direzione di spostamento: invece di "2:0(0,-6cm)+1(0,6cm)" si dovrebbe
use "2:0(0,6cm)+1(0,-6cm)".

Duplex con "rilegatura sul lato lungo della carta"
Per impostazione predefinita, la maggior parte delle stampanti fronte/retro è configurata per "rilegare sul lato lungo della carta";
quindi, per evitare l'impostazione manuale delle opzioni di rilegatura, potresti voler capovolgere le pagine pari nel
file generato. Per fare questo, aggiungi un extra ps2ps passo alla fine della pipeline, ad esempio:

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

Carta in formato A4 rispetto a carta in formato Letter
Alcune installazioni di TeX/PS non hanno file di configurazione del sito impostati correttamente, quindi sì
non so qual è il formato carta normale sulla stampante. Fortunatamente, tutti i passaggi del
la pipeline di composizione consente una riconfigurazione manuale. Sfortunatamente, opzioni di comando
per le riconfigurazioni richieste sono leggermente diverse per i diversi passaggi.

Ad esempio, se i tuoi programmi di utilità TeX/PS pensano che il formato della tua carta sia "lettera", mentre cosa
effettivamente stampi su è "a4", devi fare quanto segue (a seconda di quale
i file di configurazione sono danneggiati, potresti essere in grado di omettere alcune modifiche):

1. Aggiungi "a4paper" alle opzioni "\usepackage[...,...]{geometry}" (il
elenco tra parentesi) nei file TeX che utilizzano "geometry".

2. Aggiungi "-t a4" come opzioni "dvips".

3. Aggiungi "-pa4" come opzione "pstops". (Se interrompe la rotazione, omettilo, sigh!)

4. Aggiungi "-sPAPERSIZE=a4" come opzione "ps2pdf".

Esempio di riga di comando che lavora con alcune complicazioni

dvips -t landscape -f < All_cdbooklet-a4.dvi | psbook | pstops -pa4 "2:0(0,-6cm)+1(0,6cm)" | pstops -pa4 "2:0,1U(1w,1h)" > Output-even_flipped-a4.ps
&& ps2pdf -sPAPERSIZE=a4 -dAutoRotatePages=/Nessuno Output-even_flipped-a4

Allo stesso modo, molto spesso è necessario aggiungere "-pletter" alle righe di comando "ps2ps" per correggere
stampa su carta formato Letter. Puoi controllare il file PDF risultante in un visualizzatore: il
la riga di stato dovrebbe mostrare il formato carta corretto (ad esempio, 8.5 pollici x 11 pollici è "Lettera"), anche
le pagine devono essere capovolte (per la rilegatura "sul lato lungo") e i wireframe inseriti
pagine diverse dovrebbero essere posizionate esattamente nelle stesse posizioni (per visuale
verifica, scegli il ridimensionamento "adatta alla pagina" e cambia rapidamente le pagine avanti e indietro per
tastiera o dal pulsante "Pagina successiva").

Avvisi da dvips
Nota anche che se la tua installazione "TeX/dvips" è completamente correggere, puoi rimuovere
"-t landscape" dalla riga di comando "dvips"; non rimuoverlo produrrebbe un avvertimento
"specificato sia il formato orizzontale che il formato carta: ignorando il paesaggio".

Offset duplex sistematico
Alcune stampanti non possono far corrispondere in modo affidabile le posizioni sul lato anteriore e posteriore durante la stampa;
c'è poco che si può fare con esso. Tuttavia, se la stampante ne aggiunge un po' coerente
posizionamento errato dei lati anteriore e posteriore, si possono trovare soluzioni alternative.

Ad esempio, quando si "rilega sul lato corto", l'errore comune è che (in orizzontale
orientamento) la parte posteriore è sfalsata orizzontalmente rispetto alla parte anteriore. Ad esempio, se offset
è di 3.4 mm a sinistra, è possibile spostare l'immagine sulla pagina della metà, 0.17 cm a
the left: replace "2:0(0,-6cm)+1(0,6cm)" by "2:0(0,-6.17cm)+1(0,5.83cm)".

Con "rilegatura sul lato lungo", l'errore tipico è l'offset verticale. Lavorare
intorno, bisogna spostarsi verticalmente (di nuovo, della metà della quantità) dopo capovolgendo anche
pagine. Per aumentare di 0.17 cm, aggiungi un ulteriore passaggio "pstops "(0.17 cm, 0)"" alla pipeline
dopo il passaggio "2:0,1U(1w,1h)" (non testato).

CONSIGLI

Le dimensioni dei caratteri predefinite e la densità del tipo vengono scelte per ottimizzare la stampa di un DL-DVD
raccolta di brevi audio di alta qualità (della durata di una canzone: circa 100 sottotitoli, e
2000 file audio). Puoi migliorare la qualità visiva se adatti la composizione alla tua
esigenze particolari.

Le impostazioni più comunemente modificate si trovano sopra i file generati. Questi sono caratteri e
gradi di compressione verticale dei paragrafi per il titolo principale, titoli delle sezioni (1st
livello) e sottosezioni (2° livello), e delle registrazioni effettive emesse per ogni file audio, come
così come il numero di colonne. Un po' più avanti nel file ci sono le impostazioni per gli spazi a sinistra
intorno alle intestazioni delle sezioni e per la messa a punto della compressione.

Non dimenticare che se non puoi descrivere un layout complicato con le opzioni della riga di comando,
hanno ancora la possibilità di eseguire questo script molte volte (una volta per directory con "handable
layout", utilizzando -B e altre opzioni adatte a questa sottodirectory). Allora puoi usare
LaTeX Direttive "\input" per includere il generato basename_list.tex file nel
file "LaTeX" di livello superiore.

Puoi anche ridefinire "\preSection * \postSection" per non fare nulla e inserire il necessario
codice per generare le intestazioni nel file di primo livello.

Modifica le macro di formattazione in base alle tue esigenze. (Di cose più complicate, menziona
"\squeezeContunuationLines" e "\parskip", che regolano la densità delle linee - senza
cambiare il carattere della linea; nota che l'impostazione di "\parskip" fa parte dell'azione di
"\squeezeContunuationLines". "\columnsep" regola la separazione orizzontale delle colonne.
Si può anche mettere a punto la posizione verticale dell'inizio della prima pagina; per
backcover, sintonizzare anche "\CDbackMargin" e "\CDbackTopMargin". La(e) definizione(i) di
"\squeezeContunuationLines" sono commentati (da "%") in non-*_comune.tex File; potresti
decommentarlo e perfezionarlo separatamente per ciascun file TeX.)

Si possono combinare due (o più) elenchi (ad esempio, uno con lo stile corto e uno con lo stile lungo
style) in un file di output; i file generati ..._cdbooklet.tex e ..._testo.tex
hanno già un modello necessario (disabilitato) alla fine. (Inoltre, con -P "corto lungo",
questo viene fatto automaticamente.

Ad esempio, con due elenchi creati in "SYNOPSIS", Tutti_lista.texe All_short_list.tex,
trova "\iffalse" vicino alla fine di All_short_cdbooklet.tex e cambialo in "\iftrue"; poi
cambia il nome nella direttiva

\input{un'altra_lista}

a Tutti_lista

Questo farà sì che il cdbooklet "corto" diventi una sorta di "indice" per il combinato
cdbooklet "corto+lungo". (Naturalmente, si possono cambiare i valori delle macro "\SectionFont"
ecc, "\ COLONNE", tipo di compressione per soddisfare le tue esigenze - il punto è che non dovrebbero essere
necessariamente lo stesso per il secondo elenco.)

FLUSSO DI LAVORO

Il modulo è abbastanza flessibile; ecco uno dei possibili flussi di lavoro (adatto se tutti voi
bisogno è -P e -P :

Metti tutte le directory "di livello superiore" come sottodirectory della directory corrente (beh, questo
non è realmente necessario!), e metti l'intestazione da usare per ogni directory in un file
.intestazione_superiore. Potrebbe essere necessario specificare la codifica utilizzata in questo file nelle opzioni (fare
simile a "-eh:cp1252").

Usa typeset_audio_dirp online usando i servizi onworks.net