typeset_audio_dirp - Online di Cloud

PROGRAM:

NAMA

typeset_audio_dir - menghasilkan daftar direktori TeX dengan file audio.

RINGKASAN

# Misalnya: direktori saat ini berisi 1 subdirektori-per-pemain.
# Di dalam setiap direktori strukturnya adalah
# Komposer/tunggal*.mp3 (output halus: bidang)
# dan
# Komposer/MultiPart/part*.mp3 (output halus: bidang)
# Keluarkan info tahun dan durasi; gunakan "Kuartet" sebagai nama dasar
typeset_audio_dir -y -T -B Kuartet *

# Demikian juga, tetapi struktur direktori ini adalah wrt direktori saat ini;
# Jangan memancarkan tahun dan durasi, output ke STDOUT
mengeset_audio_dir .
mengeset_audio_dir

# Gunakan artis sebagai judul tingkat atas, album sebagai tingkat ke-2; menggunakan nomor trek;
# nama didasarkan pada judul untuk kedalaman apa pun dalam hierarki direktori;
# juga untuk generasi heading level 2. Tandai audio dengan lirik
typeset_audio_dir -ynTL -P long -B Semua

# Demikian juga, tetapi namanya didasarkan pada album; abaikan komentar
typeset_audio_dir -yTn -P pendek -B All_short

# Demikian juga, tetapi menghasilkan daftar panjang dan pendek. Yang pendek melayani
# sebagai daftar isi untuk yang panjang
typeset_audio_dir -ynTL -P pendek,panjang -B Semua

DESKRIPSI

Memindai direktori (atau direktori) yang diberikan pada baris perintah, menggunakan MP3::Tag untuk mendapatkan
informasi tentang file audio (untuk memproses file non-MP3, modul tambahan mungkin diperlukan, lihat
MP3::Tag, dan -r NAMA FILE_FILTER pilihan harus diberikan). Menghasilkan (satu atau lebih, tergantung
on -B opsional) TeX file dengan perintah untuk mengeset daftar yang dapat dibaca manusia. Non-direktori
pada baris perintah diabaikan. (Dapat juga digunakan untuk memproses file non-audio, jika
MP3::Tag dapat mengekstrak informasi judul/dll dari mereka.)

Dengan -B, berkas *_list.tex berisi semua data tentang file audio (bila -P dengan keduanya
"pendek, panjang" diberikan, file serupa lainnya *_list_long.tex juga ditulis); berkas
*_titles.tex berisi perkiraan ke-0 untuk kemungkinan "judul" koleksi (satu
berdasarkan -N opsi dan ringkasan singkat direktori tingkat atas). Berkas *_common.tex
berisi makro umum untuk file berikut. File yang tersisa menentukan yang berbeda
lingkungan untuk mengeset daftar (termasuk dua file TeX dengan "konten" sesuai kebutuhan): a
daftar "normal" (untuk A4/Letter, *_text.tex), dua rasa dari daftar "terkompresi" (untuk
sisipan kotak permata, *_cdbooklet.tex dan *_cdcover.tex), dan sisipan belakang untuk permata
kasus (*_backcover.tex).

Tujuannya adalah untuk mendukung banyak tata letak direktori yang berbeda dengan file audio dengan as
sedikit mengutak-atik opsi baris perintah mungkin; jadi "type_audio_dir" mencoba melakukannya
sebanyak mungkin oleh tamu. Secara bersamaan, seseorang harus bisa menyetel naskahnya
untuk menangani tata letak yang mereka miliki.

Script memancarkan header untuk beberapa tingkat "pengelompokan". Header grup "tingkat atas" adalah
dipancarkan sekali untuk setiap direktori "tingkat atas" (dengan file audio), tajuk selanjutnya dipancarkan
berdasarkan perubahan deskriptor file audio selama pemindaian.

PILIHAN

-B memberikan nama dasar dari file output. Tanpa opsi ini, skrip akan menampilkan
STDOUT. Dengan opsi ini, skrip memisahkan tata letak dari konten, dan menghasilkan 6
TeX file:

namadasar_teks.tex
namadasar_cdcover.tex
namadasar_cdbooklet.tex
nama dasar_backcover.tex
nama_dasar_daftar.tex
nama_dasar_judul.tex
namadasar_umum.tex

File terakhir berisi makro umum yang diperlukan untuk pengaturan huruf. Dua sebelumnya
file berisi informasi tentang file audio yang ditemui. File lainnya berisi
kerangka kerja untuk mengeset informasi ini.

Empat file pertama seharusnya dapat diedit oleh manusia; mereka tidak akan ditimpa
dengan menjalankan ulang berikut dengan nama dasar yang sama yang diberikan pada skrip. Dengan mengedit ini
file, seseorang dapat memilih di antara beberapa penyandian, bahasa, keluaran multikolom, font
ukuran, jarak antar baris, margin, ukuran halaman, dll.

File "*_titles.tex" bersifat campuran: mencerminkan konten file audio,
dan seharusnya dapat diedit oleh manusia. Ini akan ditimpa kecuali Read-Only;
jadi jika Anda mengeditnya dengan tangan, jadikan Read-Only. Logika penimpaan serupa diterapkan pada
File "*_common.tex" juga.

-P "rencana"
jalan pintas untuk mengatur opsi berbulu; saat ini, dua nilai "rencana" didukung:

pendek => -1 "" -2 "" -t -1e100 -a -1e100 -c
panjang => -1 "" -2 "@l" -t 1e100 -a 1e100

untuk pembuatan daftar pendek/panjang. Dalam daftar pendek, catatan sesuai dengan
nama-nama album. Dalam daftar panjang, catatan sesuai dengan file individual, dan
nama album berfungsi sebagai judul tingkat kedua.

-y Keluarkan informasi tahun (atau tanggal) jika ada. Deskriptor tanggal yang sangat panjang (misalnya, kapan
beberapa rentang tanggal ada) dikompresi sebanyak mungkin.

-Y Keluarkan seluruh informasi tanggal jika ada.

-T Pancarkan informasi durasi.

-n Aktifkan memancarkan nomor trek. Variabel lingkungan TYPESET_AUDIO_TRACK mungkin berisi:
format yang akan diinterpolasi untuk pengaturan huruf (default ke "%{mA}%{n1}"). Misalnya, atur
TYPESET_AUDIO_TRACK ke "%{n1}" untuk menggunakan nomor trek "murni" alih-alih kombinasi
nomor media/disk dan nomor trek.

-1 Format tajuk tingkat atas; adalah menambah()d oleh MP3::Tag berdasarkan konten
file audio pertama yang ditemukan selama pemindaian direktori tingkat atas ini. Nilai kosong
adalah default; dalam hal ini header didasarkan pada nama direktori (dengan
beberapa normalisasi: garis bawah diubah menjadi spasi).

-2 Format heading tingkat kedua; adalah menambah()d oleh MP3::Tag. Dihitung berdasarkan
isi setiap file audio. Judul dipancarkan ketika nilai interpolasi berubah
(tergantung pilihan -a).

String kosong menonaktifkan pembuatan.

-a Abaikan perubahan pada heading level kedua untuk direktori yang lebih dalam dari ini
direktori tingkat atas. Default ke 2. Misalnya, di

Pemain/Komposer/Koleksi/part1.mp3
Pemain/Komposer/Koleksi/part2.mp3
Pemain/Komposer/single1.mp3
Pemain/Komposer/single2.mp3

jika direktori tingkat atas adalah Pemain, lalu perubahan header tingkat kedua di
tunggal*.mp3 akan membuat judul tingkat kedua yang baru. Namun, perubahan serupa dalam
bagian*.mp3 tidak akan membuat judul baru.

CATATAN: mungkin default 2 ini tidak terlalu intuitif. Disarankan untuk secara eksplisit
atur opsi ini ke nilai yang Anda rasa tepat (1e100 akan memainkan peran tak terhingga -
jadi setiap perubahan akan menghasilkan judul tingkat kedua yang baru).

-t Kedalaman batas judul (direktori tingkat atas wrt). Default ke 2. Dalam file audio
lebih dalam dari ini album %l digunakan sebagai nama; jika tidak, judul %t audio
berkas digunakan.

Setel ke "-1e100" untuk selalu menggunakan %l, dan ke 1e100 untuk selalu menggunakan %a.

-@ Ganti semua "@" dengan "%" di opsi. Sangat berguna dengan shell DOSIS untuk disertakan
"%"-escapes diperlukan untuk MP3::Tag's menambah().

-e pengkodean
Menetapkan pengkodean untuk file keluaran, nama direktori (bila digunakan untuk menghasilkan judul), dan
file petunjuk. pengkodean adalah daftar arahan yang dipisahkan koma; setiap direktif adalah
baik nama penyandian (untuk digunakan untuk semua target), atau "TARGET_LETTERS: penyandian".
Huruf target adalah "o", "d", dan "h" untuk output, nama direktori, dan file
.top_heading sesuai. Gunakan 0 alih-alih penyandian untuk melakukan berorientasi byte
Baca tulis.

-c Apa yang digunakan sebagai "komentar" untuk rekaman (bagian yang diketik berbeda). Jika tidak
diberikan, bingkai ID3v2 "TXXX[add-to:file-by-person,l,t,n]" digunakan.

Jika isi kolom ini terdapat di akhir judul, tidak ada yang ditambahkan, cukup
bagian ini diatur secara berbeda.

-L Tandai file dengan lirik dan gambar yang disematkan (tidak) disinkronkan. Beri penjelasan tentang
simbol yang digunakan di akhir daftar.

-N COLLECTION_NAME
(default ke "KOLEKSI") nama koleksi yang akan dimasukkan ke dalam file
*_title.tex. Interaksi dengan encoding mungkin kurang intuitif; Anda mungkin ingin
untuk memeriksa/mengedit file ini untuk koreksi.

-F FONT_ENCODING_SYMBOL
(default ke "T2A"): nama pengkodean font "LaTeX". Jika instalasi Anda adalah
rusak dan "T2A" tidak tersedia, Anda dapat mencoba "T1" atau "OT1". Lihat "MASALAH ketika
PENYUSUNAN HURUF".

-r NAMA FILE_FILTER
menyetel ekspresi reguler untuk mencari nama file (defaultnya adalah "(?i:\.mp3$)".

Info Baca baca dari fillet sistem

File-file berikut digunakan untuk memberikan petunjuk kepada mengeset_audio_dir:

.content_comment
Konten file ini digunakan sebagai kolom komentar di output untuk semua file di ini
direktori.

.top_heading
Jika kosong, menunjukkan bahwa ketika kedalaman file mengubah output, itu dihitung
wrt subdirektori dari direktori file ini (ouph!). Jika mengandung
nomor, itu ditambahkan ke kedalaman ini.

Example: misalkan judul bagian Anda didasarkan pada nama direktori. Misalkan
pohon direktori untuk diproses berisi direktori Campuran/2009. Jika Anda ingin nama
subdirektori dari direktori ini menjadi judul bagian, buat file
Campuran/2009/.top_heading yang berisi 0. Jika hal yang sama berlaku untuk subdirektori lain
of Campur, alih-alih membuat file seperti itu di semua subdirektori tahun, seseorang dapat membuat
fillet Campuran/.top_heading yang berisi "-1".

Jika tidak, konten file ini digunakan sebagai judul tingkat atas untuk direktori ini.

PENYUSUNAN HURUF

Menjalankan skrip ini hanya akan menghasilkan file TeX yang diperlukan, tetapi tidak akan mengesetnya
(mereka akan terlihat jauh lebih baik jika Anda mengedit file terlebih dahulu sesuai dengan kebutuhan Anda). Ingat bagaimana
untuk mengeset dokumen TeX (di sini kami mengasumsikan target PDF):

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

(banyak file sementara akan dibuat juga; Anda dapat memecahnya menjadi beberapa
perintah pada "&&"). Beberapa file (misalnya, ..._cdcover.tex) lebih cocok dengan lanskap
orientasi; satu kebutuhan

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

Dengan ..._cdbooklet.tex, untuk hasil terbaik, sebaiknya atur ulang halaman untuk buklet 2up
Pencetakan 2 halaman per sisi:

dokumen lateks.tex
&& dvips -t landscape -f < document.dvi | buku ps | pstops "2:0(0,-6cm)+1(0,6cm)" > document.ps
&& ps2pdf -dAutoRotatePages=/Tidak ada dokumen

(semua dalam satu baris, atau berikan 3 perintah terpisah, melanggar "&&"; detail lebih lanjut tentang menjalankan
dvips diletakkan di awal file TeX). Jika Anda dapat dengan mudah mencetak .ps mengajukan, Anda
dapat mengabaikan langkah terakhir. (Opsi "-dAutoRotatePages=/None" mengganggu tampilan;
seseorang dapat menghilangkannya kecuali kalau seseorang melakukan "membalik halaman genap ekstra", seperti di bawah ini.)

Perhatikan bahwa ini mengasumsikan bahwa ketika Anda mengirim file ke printer Anda meminta dupleks dengan
"menjilid di sisi pendek kertas". Jika printer Anda dapat bertahan dari dupleks manual, lakukan seperti
biasa: cetak dulu halaman genap dalam urutan yang berlawanan, muat ulang kertas, lalu cetak halaman ganjil
(Anda perlu memahami di mana orientasi Anda harus mengembalikan kertas saat memuat ulang; di sana
ada 4 varian, dan hanya satu yang benar ;-). Untuk printer dupleks "asli", lihat di bawah.

MASALAH ketika PENYUSUNAN HURUF

instalasi tidak lengkap
! Font T2A/cmr/m/n/10.95=larm1095 pada 10.95pt tidak dapat dimuat:
File metrik (TFM) tidak ditemukan.

Untuk cakupan multibahasa terbaik yang dapat saya temukan, secara default file LaTeX yang dihasilkan menggunakan
"T2A"-encoded-font dengan karakter Latin tambahan yang disediakan oleh "textcomp". Tampaknya,
beberapa instalasi "TeX" menghilangkan tabel penyandian "T2A". Anda mungkin ingin mengubah "T2A" menjadi,
misalnya, "T1" dengan menggunakan opsi "-F T1".

Dalam buklet, halaman 1 di akhir, sisanya berantakan
Opsi "lanskap" dari paket "geometri" harus memutar halaman 90 derajat.
Tergantung pada cara konfigurasinya, arah rotasi bervariasi. Jika .pdf fillet
diperoleh dengan opsi "-dAutoRotatePages=/None" memiliki bagian atas halaman di sebelah kiri, Anda dapat
perlu membalikkan arah pergeseran: alih-alih "2:0(0,-6cm)+1(0,6cm)" seseorang harus
use "2:0(0,6cm)+1(0,-6cm)".

Duplexing dengan "jilid pada sisi panjang kertas"
Secara default, sebagian besar printer dupleks dikonfigurasi untuk "mengikat pada sisi panjang kertas";
jadi untuk menghindari pengaturan manual opsi penjilidan, Anda mungkin ingin membalik halaman genap di
file yang dihasilkan. Untuk melakukan ini, tambahkan ekstra ps2ps langkah di ujung pipa, misalnya:

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

Kertas berukuran A4 vs. Kertas berukuran letter
Beberapa instalasi TeX/PS tidak memiliki file konfigurasi situs yang diatur dengan benar, demikian juga
tidak tahu apa ukuran kertas biasa pada printer Anda. Untungnya, semua langkah dari
pipa pengaturan huruf memungkinkan konfigurasi ulang manual. Sayangnya, opsi perintah
untuk konfigurasi ulang yang diperlukan agak berbeda untuk langkah yang berbeda.

Misalnya, jika utilitas TeX/PS Anda berpikir bahwa ukuran kertas Anda adalah "letter", sedangkan apa?
Anda benar-benar mencetak adalah "a4", Anda perlu melakukan hal berikut (tergantung pada
file konfigurasi rusak, Anda mungkin dapat menghilangkan beberapa modifikasi):

1. Tambahkan "a4paper" ke opsi "\usepackage[...,...]{geometry}" (yang dipisahkan koma
list dalam tanda kurung) dalam file TeX yang menggunakan "geometri".

2. Tambahkan "-t a4" sebagai opsi "dvips".

3. Tambahkan "-pa4" sebagai opsi "pstops". (Jika itu merusak rotasi, abaikan, menghela nafas!)

4. Tambahkan "-sPAPERSIZE=a4" sebagai opsi "ps2pdf".

Contoh commandline yang bekerja dengan beberapa komplikasi

dvips -t landscape -f < All_cdbooklet-a4.dvi | buku ps | 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=/None Output-even_flipped-a4

Demikian juga, cukup sering seseorang perlu menambahkan "-pletter" ke baris perintah "ps2ps" untuk memperbaikinya
mencetak ke kertas berukuran letter. Anda dapat memeriksa file PDF yang dihasilkan di penampil: the
baris status harus menunjukkan ukuran kertas yang benar (misalnya, 8.5 inci x 11 inci adalah "Surat"), genap
halaman harus dibalik (untuk mengikat "di sisi yang panjang"), dan gambar rangka pada
halaman yang berbeda harus diposisikan persis pada posisi yang sama (untuk visual
verifikasi, pilih penskalaan "sesuai dengan halaman", dan dengan cepat beralih halaman bolak-balik dengan
keyboard atau dengan tombol "Halaman berikutnya").

Peringatan dari dvips
Perhatikan juga bahwa jika instalasi "TeX/dvips" Anda adalah sama sekali benar, Anda dapat menghapus
"-t landscape" dari baris perintah "dvips" Anda; tidak menghapusnya akan menghasilkan peringatan
"baik lanskap dan ukuran kertas ditentukan: mengabaikan lanskap".

Offset dupleks sistematis
Beberapa printer tidak dapat dengan andal mencocokkan posisi di sisi depan dan belakang saat mencetak;
ada sedikit yang bisa dilakukan dengan itu. Namun, jika printer Anda menambahkan beberapa konsisten
salah penempatan sisi depan dan belakang, seseorang dapat memberikan solusi untuk itu.

Misalnya, ketika "mengikat di sisi pendek", kesalahan umum adalah bahwa (dalam lanskap
orientasi) bagian belakang diimbangi secara horizontal dengan bagian depan. Misalnya, jika offset
adalah 3.4mm ke kiri, seseorang dapat menggeser gambar pada halaman sebanyak setengahnya, 0.17cm ke
the left: replace "2:0(0,-6cm)+1(0,6cm)" by "2:0(0,-6.17cm)+1(0,5.83cm)".

Dengan "mengikat di sisi panjang", kesalahan tipikal adalah offset vertikal. Bekerja
sekitar, seseorang perlu bergeser secara vertikal (sekali lagi, dengan setengah jumlah) setelah membalik bahkan
halaman. Untuk menggeser 0.17cm ke atas, tambahkan langkah ekstra "pstops" (0.17cm,0)"" ke pipeline
setelah langkah "2:0,1U(1w,1h)" (belum diuji).

HINTS

Ukuran font default dan kepadatan jenis dipilih untuk mengoptimalkan pencetakan DL-DVD
kumpulan audio pendek berkualitas tinggi (dengan durasi seperti lagu: sekitar 100 subjudul, dan
2000 file audio). Anda dapat meningkatkan kualitas visual jika Anda menyetel pengaturan huruf ke
kebutuhan tertentu.

Pengaturan yang paling sering diubah ada di atas file yang dihasilkan. Ini adalah font dan
derajat pemerasan vertikal paragraf untuk judul utama, judul bagian (ke-1
level) dan subbagian (level 2), dan rekaman aktual yang dipancarkan untuk setiap file audio, seperti:
serta jumlah kolom. Sedikit lebih jauh dalam file adalah pengaturan untuk celah ke kiri
sekitar judul bagian, dan untuk fine-tuning meremas.

Jangan lupa bahwa jika Anda tidak dapat menjelaskan tata letak yang rumit dengan opsi baris perintah, Anda
masih memiliki kemungkinan untuk menjalankan skrip ini berkali-kali (sekali per direktori dengan "handable
tata letak", menggunakan -B dan opsi lain yang cocok untuk subdirektori ini). Kemudian Anda dapat menggunakan
Getah Direktif "\input" untuk memasukkan yang dihasilkan nama_dasar_daftar.tex file ke dalam
file "LaTeX" tingkat atas.

Anda juga dapat mendefinisikan ulang "\preSection * \postSection" untuk tidak melakukan apa-apa, dan meletakkan yang diperlukan
kode untuk menghasilkan header ke file tingkat atas.

Ubah makro pemformatan agar sesuai dengan kebutuhan Anda. (Untuk hal-hal yang lebih rumit, sebutkan
"\squeezeContunuationLines" dan "\parskip", yang mengatur kepadatan garis - tanpa
mengubah font garis; perhatikan bahwa pengaturan "\ parskip" adalah bagian dari tindakan
"\squeezeContunuationLines". "\columnsep" mengatur pemisahan horizontal kolom.
Seseorang juga dapat menyempurnakan posisi vertikal awal halaman pertama; untuk
backcover, juga tune up "\CDbackMargin" dan "\CDbackTopMargin". Definisi dari
"\squeezeContunuationLines" dikomentari (oleh "%") di non-*_common.tex file; kamu boleh
batalkan komentarnya, dan sesuaikan secara terpisah untuk setiap file TeX.)

Seseorang dapat menggabungkan dua (atau lebih) daftar (misalnya, satu dengan gaya pendek, dan satu dengan panjang
style) menjadi satu file output; file yang dihasilkan ..._cdbooklet.tex dan ..._teks.tex
sudah memiliki template yang diperlukan (dinonaktifkan) di bagian akhir. (Selain itu, dengan -P "pendek panjang",
ini dilakukan secara otomatis.

Misalnya, dengan dua daftar yang dibuat di "SINOPSIS", Semua_daftar.tex, dan Semua_short_list.tex,
temukan "\ifalse" di dekat akhir All_short_cdbooklet.tex dan ubah ke "\iftrue"; kemudian
ubah nama di arahan

\input{daftar_lain}

untuk Semua_daftar

Ini akan membuat cdbooklet "pendek" menjadi semacam "daftar isi" untuk gabungan
cdbooklet "pendek + panjang". (Tentu saja, seseorang dapat mengubah nilai makro "\SectionFont"
dll, "\COLUMNS", jenis pemerasan yang sesuai dengan kebutuhan Anda - intinya adalah tidak boleh
tentu sama untuk daftar kedua.)

ALIRAN KERJA

Modul ini cukup fleksibel; di sini adalah salah satu alur kerja yang mungkin (cocok jika Anda semua
kebutuhan adalah -P dan -P :

Letakkan semua direktori "tingkat atas" sebagai subdirektori dari direktori saat ini (yah, ini
tidak benar-benar diperlukan!), dan masukkan judul yang akan digunakan untuk setiap direktori ke dalam file
.top_heading. Anda mungkin perlu menentukan pengkodean yang digunakan dalam file ini ke dalam opsi (lakukan
mirip dengan "-eh:cp1252").

Gunakan typeset_audio_dirp online menggunakan layanan onworks.net