bundledoc - Online di Cloud

PROGRAM:

NAMA

bundledoc - bundel semua file yang dibutuhkan oleh dokumen LaTeX

RINGKASAN

bundel dokumen [--Versi: kapan] [--membantu] [--[tidak]bertele-tele] [--teksfile=fillet] [--direktori=direktori]
[--[tidak]lokal saja] [--mengecualikan=tali] [--termasuk=spesifikasi file] [--tampak=fillet]
[--daftardeps=[ya|tidak|hanya|rel]...] [--[tidak]penjaga] [--konfigurasi=fillet] .dep fillet

DESKRIPSI

bundledoc adalah pasca-prosesor untuk foto paket yang menyatukan semua
kelas, paket, dan file yang diperlukan untuk membuat dokumen LaTeX tertentu. Itu membaca .dep
mengajukan itu foto menghasilkan, menemukan setiap file yang disebutkan di dalamnya, dan mengemasnya
ke dalam satu file arsip (misalnya, a .tar.gz file), cocok untuk berpindah lintas sistem,
mengirimkan ke rekan, dll.

Sebagai contoh paling sederhana, pertimbangkan file LaTeX bernama, katakanlah, halo.tex:

\RequirePackage{snapshot} % Dibutuhkan oleh bundledoc
\documentclass[11pt]{artikel}

\begin{dokumen}
Halo dunia!
\end{dokumen}

"\RequirePackage{snapshot}" menyebabkan halo.dep berkas yang akan diproduksi. Kapan bundledoc is
kemudian diberi "hello.dep" sebagai argumen, ia menempatkan file dependen -- snapshot.sty,
artikel.cls, dan ukuran11.clo -- dan menggabungkannya ke dalam satu file arsip, bersama dengan
halo.tex dan NYATA file (dijelaskan dalam "OPSI", di bawah).

PILIHAN

Dalam uraian berikut, beberapa file mengacu pada nama dokumen LaTeX utama Anda (tidak
perpanjangan).

bundledoc membutuhkan nama file dependensi yang dihasilkan oleh foto (biasanya
somefile.dep). Opsi berikut juga dapat diberikan:

--Versi: kapan
Keluarkan bundledoc nomor versi skrip. Ini menimpa semua yang tersisa
Pilihan.

--membantu
Berikan pesan penggunaan singkat. Ini mengesampingkan semua opsi yang tersisa.

--[tidak]bertele-tele (default: "noverbose")
bundledoc biasanya tidak menampilkan apa pun kecuali pesan kesalahan. Dengan "--verbose",
itu menampilkan pesan status yang berlebihan.

--teksfile=utama .tex fillet (bawaan: somefile.tex)
fotofile dependensi tidak mencantumkan file LaTeX utama (yang akan diteruskan
untuk getah). Agar bundledoc untuk menemukan dan menggabungkan file itu, bundledoc mengasumsikan itu
memiliki nama yang sama dengan foto file dependensi tetapi dengan a .tex perpanjangan. Jika ini
tidak demikian, maka gunakan "--texfile" untuk menentukan nama file yang benar.

--direktori=arsip direktori (bawaan: beberapa file)
Ketika bundledoc membuat arsip (misalnya, a .ter or Zip. file) yang berisi
file dokumen, itu menempatkan semuanya dalam direktori untuk menghindari kekacauan saat ini
direktori dengan file. Jika file dependensi yang diberikan disebut somefile.dep maka
arsip yang dihasilkan akan, secara default, menyimpan semua file dependen dalam a beberapa file
direktori. Untuk mengubah nama direktori gunakan opsi "--directory".

--[tidak]lokal saja (default: "nolocalonly")
Meskipun bundledoc biasanya mengarsipkan semua file yang disebutkan dalam .dep file, file
Opsi "--localonly" memberi tahu bundledoc untuk mengecualikan semua file yang terletak di direktori lain
dari .tex direktori file atau salah satu subdirektorinya.

--mengecualikan=tali (bawaan: tak satupun)
Sementara "--localonly" menyebabkan file di luar .tex pohon direktori file menjadi
dihilangkan dari arsip, "--exclude" memberikan kontrol yang lebih halus atas file untuk
hilangkan dari arsip. Opsi "--exclude", yang dapat ditentukan berulang kali pada
baris perintah, menyebabkan semua file yang namanya mengandung tali untuk dihilangkan dari
arsip

--termasuk=spesifikasi file (bawaan: tak satupun)
Opsi "--include", yang dapat ditentukan berulang kali pada baris perintah,
menginstruksikan bundledoc untuk memasukkan dalam arsip semua file yang cocok spesifikasi file, Bahkan
jika mereka tidak dirujuk dalam .dep file.

--tampak=nyata fillet (bawaan: NYATA)
Selain file dependen, bundledoc termasuk dalam file arsip satu tambahan
file yang dipanggil, secara default, ``NYATA''. NYATA adalah file teks yang mencantumkan
nama file asli dari semua dependensi. Untuk mengubah nama file dari ``NYATA''
untuk sesuatu yang lain, gunakan opsi "--manifest". Sebagai kasus khusus, "--manifest="""
mengatakan bundledoc untuk tidak menyertakan file manifes sama sekali.

--daftardeps=[ya|tidak|hanya|rel]...] (default: "tidak")
"--listdeps" menerima satu atau lebih dari "ya", "tidak", "hanya", atau "rel" sebagai dipisahkan koma
Daftar. Selama "tidak" tidak muncul dalam daftar ini, bundledoc mengeluarkan semua yang utama
Ketergantungan file LaTeX. Jika daftar berisi "rel", maka bundledoc menghasilkan
daftar dependensi dengan nama path relatif. Jika daftar berisi "hanya", maka
bundledoc keluar setelah menampilkan daftar, tanpa menghasilkan arsip.

--[tidak]penjaga (default: "nokeepdirs")
Biasanya, file arsip yang bundledoc menghasilkan berisi satu direktori -- dan
subdirektori, jika dokumen merujuk secara eksplisit kepada mereka -- di mana semua
file tergantung berbohong. Jika "--keepdirs" ditentukan, semua file dependen disimpan
dengan nama path asli mereka. Misalnya, jika somefile.tex tergantung pada
angka/somefigure.eps, artikel.cls, dan snapshot.sty, lalu beberapa file arsip akan
biasanya berisi file-file berikut:

· somefile/somefile.tex

· somefile/angka/somefigure.eps

· somefile/artikel.cls

· somefile/snapshot.sty

· beberapa file/MANIFEST

Namun, "--keepdirs" akan menyebabkan beberapa file arsip berisi jenis berikut:
dari nama file sebagai gantinya:

· rumah/saya/mydocs/somefile.tex

· rumah/saya/mydocs/figures/somefigure.eps

· usr/share/texmf/tex/latex/base/article.cls

· usr/share/texmf/tex/lateks/snapshot/snapshot.sty

"--directory" tidak digunakan saat "--keepdirs" berlaku. Selain itu, tidak ada manifes
file ditulis ke file arsip karena berisi informasi yang berlebihan.

--konfigurasi=konfigurasi fillet (bawaan: )
Opsi "--config" digunakan untuk menunjuk bundledoc ke konfigurasi yang sesuai
(.cfg) untuk distribusi TeX dan sistem operasi Anda. bundledoc datang dengan a
beberapa file konfigurasi dan mudah untuk menulis lebih banyak. Lihat "FILE KONFIGURASI"
(di bawah) untuk deskripsi format file konfigurasi.

KONFIGURASI FILE

dibentuk
File konfigurasi mengikuti format yang cukup sederhana. Baris yang dimulai dengan "#" adalah komentar.
Garis kosong diabaikan. Semua baris lainnya berbentuk:

variabel: nilai

Versi saat ini dari bundledoc mengenali variabel berikut:

bundel
Perintah yang digunakan untuk menggabungkan satu set file ke dalam satu file arsip

wastafel
Affix pada perintah untuk membuang outputnya

menemukan
Perintah untuk menemukan file di dalam pohon TeX.

Nilai yang terlalu panjang untuk satu baris dapat dibagi menjadi beberapa baris dengan menggunakan "\" as
simbol garis-kelanjutan.

Ada dua variabel lingkungan yang bundledoc tersedia untuk digunakan oleh
perintah file konfigurasi: "BDBASE", yang diatur ke beberapa file (seperti dalam "OPSI"), dan
"BDINPUTS", yang diatur ke daftar file yang dipisahkan oleh spasi yang akan dioperasikan oleh perintah
pada. Artinya, ketika perintah yang terkait dengan "bundel" sedang berjalan, "BDINPUTS" berisi
daftar semua file yang akan diarsipkan. Sebaliknya, ketika perintah
terkait dengan "find" sedang berjalan, "BDINPUTS" berisi nama file yang akan dicari.

contoh
File konfigurasi berikut paralel bundledocnilai default dari berbagai
variabel file konfigurasi, yang mewakili distribusi TeX berbasis kpathsea yang sedang berjalan
pada sistem Unix generik, yang belum tentu memiliki alat GNU apa pun, seperti
gzip atau GNU ter:

# File konfigurasi "Default"
# Oleh Scott Pakin[email dilindungi]>

bundel: (tar -cvf - $BDINPUTS | kompres > $BDBASE.tar.Z)
wastafel: > /dev/null 2>&1
temukan: kpsewhich -progname=lateks $BDINPUTS

Tanda kurung di baris "bundel:" memberi tahu shell Unix untuk menjalankan perintah dalam a
subkulit. Ini untuk membuat imbuhan "sink:" berfungsi dengan baik (yaitu, jadi tidak ada dua
">" dalam perintah yang sama).

Perhatikan bagaimana perintah memperlakukan "BDBASE" dan "BDINPUTS" seperti variabel lingkungan lainnya
di shell Unix, menggunakan "$" untuk mengambil nilainya. Sistem operasi lain menggunakan yang berbeda
konvensi untuk merujuk ke variabel lingkungan. Misalnya, file konfigurasi
untuk distribusi TeX berbasis Windows akan menggunakan "%BDBASE%" dan "%BDINPUTS%" sebagai gantinya.

Nilai untuk "sink:" khusus untuk sistem operasi. Nilai untuk "temukan:" adalah
khusus untuk distribusi TeX. "bundel:" adalah tempat yang paling banyak kesempatan untuk kustomisasi
berbohong. Anda dapat menggunakan "bundel:" untuk menentukan format arsip favorit Anda. Misalnya, Anda
dapat menghasilkan file shar di Unix dengan sesuatu seperti:

bundel: (shar --archive-name="$BDBASE" $BDINPUTS > $BDBASE.sh)

atau file CAB di Microsoft Windows dengan sesuatu seperti:

bundel: cabarc -r -p N %BDBASE%.cab %BDINPUTS%

CONTOH

Asumsikan bahwa file saya.dep dihasilkan dari file saya.tex dengan mengikuti petunjuk di
Bagian deskripsi. Perintah berikut menghasilkan a Zip. file dengan MikTeX TeX
distribusi yang berjalan di Microsoft Windows:

bundledoc --config=miktex.cfg file saya.dep

(Dalam praktiknya, mungkin perlu untuk menentukan ke "--config" jalur lengkap ke
bundledoc's miktex.cfg berkas konfigurasi.)

Berikut ini membangun .tar.gz arsip dengan distribusi TeX Live yang berjalan di Unix-
seperti sistem operasi. bundledoc akan menghasilkan keluaran verbose yang menjelaskan operasinya.
Semua file tidak berada di pohon direktori yang sama dengan file saya.tex dan semua file yang berisi ".fd" atau
".sty" dalam nama mereka dihilangkan. Namun, semua .bib file dalam direktori saat ini akan
dimasukkan dalam arsip meskipun tidak ada yang dirujuk oleh file saya.dep.
Akhirnya, tidak NYATA file yang akan dihasilkan.

bundledoc --config=texlive-unix.cfg --verbose --localonly \
--exclude=.fd --exclude=.cfg --include="*.bib" --manifest="" \
file saya.dep

Gunakan bundledoc online menggunakan layanan onworks.net