latexmkL - Dalam Talian di Awan

JADUAL:

NAMA

latexmk - menjana dokumen LaTeX

SINOPSIS

lateksmk [pilihan] [fail ...]

DESCRIPTION

Latexmk mengautomasikan sepenuhnya proses penyusunan dokumen LaTeX. Pada asasnya, ia
adalah seperti saudara khusus jeneral membuat utiliti, tetapi satu yang menentukan
kebergantungan secara automatik dan mempunyai beberapa ciri lain yang sangat berguna. Dalam mod asasnya
operasi lateksmk diberi nama fail sumber utama untuk dokumen, dan ia
mengeluarkan urutan perintah yang sesuai untuk menjana .dvi, .ps, .pdf dan/atau salinan keras
versi dokumen.

Secara lalai lateksmk akan menjalankan arahan yang diperlukan untuk menjana fail .dvi.

Latexmk juga boleh ditetapkan untuk berjalan secara berterusan dengan pratonton yang sesuai. Dalam kes itu
getah program (atau salah seorang saudaranya), dsb, dijalankan semula apabila salah satu fail sumber
diubah suai, dan pratonton secara automatik mengemas kini paparan pada skrin yang disusun
dokumen.

Latexmk menentukan yang mana merupakan fail sumber dengan memeriksa fail log. (Secara pilihan, ia
juga meneliti senarai fail input dan output yang dihasilkan oleh -perakam pilihan untuk
versi moden getah (Dan pdflatex, xelatex, lualatex, dan lain-lain). Lihat dokumentasi
bagi -perakam pilihan untuk lateksmk di bawah.) Bila lateksmk dijalankan, ia memeriksa sifat
daripada fail sumber, dan jika ada yang telah diubah sejak penjanaan dokumen terakhir,
lateksmk akan menjalankan pelbagai program pemprosesan LaTeX mengikut keperluan. Khususnya, ia
akan mengulangi larian getah (atau program berkaitan)) selalunya cukup untuk menyelesaikan semua silang
rujukan; bergantung pada pakej makro yang digunakan. Dengan beberapa pakej makro dan dokumen
kelas, empat, atau lebih, larian mungkin diperlukan. Jika perlu, lateksmk juga akan berjalan
bibtex, lada, Dan / atau makeindex. Sebagai tambahan, lateksmk boleh dikonfigurasikan untuk menjana lain
fail yang diperlukan. Sebagai contoh, daripada fail angka yang dikemas kini ia boleh menjana a
fail dalam postskrip berkapsul atau format lain yang sesuai untuk dibaca oleh LaTeX.

Latexmk mempunyai dua pilihan pratonton yang berbeza. Dalam yang mudah -pv pilihan, dvi, postscript
atau pratonton pdf dijalankan secara automatik selepas menjana versi dvi, postscript atau pdf
daripada dokumen tersebut. Jenis fail untuk dilihat dipilih mengikut tetapan konfigurasi
dan pilihan baris arahan.

Pilihan pratonton kedua adalah yang berkuasa -pvc pilihan (mnemonik: "pratonton
secara berterusan"). Dalam kes ini, lateksmk berjalan secara berterusan, sentiasa memantau semua
fail sumber untuk melihat sama ada ada yang telah berubah. Setiap kali perubahan dikesan, lateksmk berjalan
semua program yang diperlukan untuk menjana versi baharu dokumen. Seorang pratonton yang baik
(seperti gv) kemudian akan mengemas kini paparannya secara automatik. Oleh itu pengguna hanya boleh mengedit a
fail dan, apabila perubahan ditulis pada cakera, lateksmk mengautomasikan sepenuhnya kitaran
mengemas kini fail .dvi (dan mungkin .ps dan .pdf) dan menyegarkan semula fail pratonton
paparan. Ia tidak begitu WYSIWYG, tetapi sangat berguna.

Untuk pratonton lain, pengguna mungkin perlu membuat pratonton mengemas kini paparannya secara manual,
yang boleh (beberapa versi xdvi and gsview) semudah memaksa lukis semula
paparan.

Latexmk mempunyai keupayaan untuk mencetak sepanduk dalam warna kelabu menyerong pada setiap halaman semasa membuat
fail postskrip. Ia juga boleh, jika perlu, memanggil program luaran untuk melakukan yang lain
pasca pemprosesan pada fail dvi dan postscript yang dihasilkan. (Lihat pilihan -dF and -pF, dan
dokumentasi untuk $dvi_filter and $ps_filter pembolehubah konfigurasi.) Ini
keupayaan adalah sisa daripada versi lama lateksmk. Lebih fleksibiliti boleh
diperoleh dalam versi semasa, kerana rentetan arahan untuk menjalankan lateks, pdflatex, dll
kini boleh dikonfigurasikan untuk menjalankan berbilang arahan. Ini juga memanjangkan kemungkinan
pasca pemprosesan fail yang dijana kepada fail pdf. fail.

Latexmk sangat boleh dikonfigurasikan, baik dari baris arahan dan dalam fail konfigurasi, jadi
bahawa ia boleh menampung pelbagai keperluan pengguna dan konfigurasi sistem. Lalai
nilai ditetapkan mengikut sistem pengendalian, jadi lateksmk selalunya berfungsi tanpa istimewa
konfigurasi pada MS-Windows, cygwin, Linux, OS-X dan sistem UNIX lain (terutamanya
Solaris).

Komplikasi yang sangat menjengkelkan dikendalikan dengan sangat boleh dipercayai oleh lateksmk, ialah LaTeX ialah berbilang
sistem lulus. Pada setiap larian, LaTeX membaca dalam maklumat yang dijana pada larian sebelumnya, untuk
perkara seperti rujukan silang dan pengindeksan. Dalam kes paling mudah, larian kedua LaTeX
sudah memadai, dan selalunya fail log mengandungi mesej tentang keperluan untuk pas lain.
Walau bagaimanapun, terdapat pelbagai jenis pakej makro tambahan kepada LaTeX, dengan pelbagai
tingkah laku. Hasilnya adalah untuk memecahkan penentuan yang berfikiran mudah tentang berapa banyak larian
diperlukan dan program yang mana. Dalam versi baharunya, lateksmk mempunyai sangat umum dan
penyelesaian yang cekap kepada isu-isu ini. Penyelesaiannya melibatkan pengekalan antara larian
maklumat mengenai fail sumber, dan gejalanya ialah lateksmk menghasilkan fail tambahan
(dengan sambungan .fdb_latexmk, secara lalai) yang mengandungi maklumat fail sumber.

LATEXMK PILIHAN DAN HUJAH ON COMMAND LINE

Secara umum baris arahan untuk memanggil lateksmk mempunyai bentuk

lateksmk [pilihan] [fail]

Semua pilihan boleh diperkenalkan dengan aksara "-" tunggal atau berganda, cth., "latexmk -help" atau
"latexmk --help".

Nota 1: Sebagai tambahan kepada pilihan dalam senarai di bawah, lateksmk mengenali hampir semua
pilihan yang diiktiraf oleh getah, pdflatex program (dan saudara mereka) dalam semasa mereka
Pelaksanaan TeXLive dan MiKTeX. Beberapa pilihan untuk program ini juga dicetuskan
tindakan atau tingkah laku khas oleh lateksmk, dalam hal ini mereka mempunyai penjelasan khusus dalam
dokumen ini. Jika tidak, mereka hanya dihantar melalui panggilan getah or pdflatex
program. Lari lateksmk dengan -tunjukkanextraoptions untuk mendapatkan senarai pilihan yang lateksmk
menerima dan itu hanya diteruskan ke getah or pdflatex (dan lain-lain). Lihat juga
penjelasan mengenai -tunjukkanextraoptions pilihan untuk maklumat lanjut.

Nota 2: Dalam dokumentasi ini, program pdflatex sering dirujuk. Pengguna bagi
program seperti lualatex and xelatex patut tahu dari lateksmkpandangan, ini
program lain berkelakuan seperti pdflatex, iaitu, mereka membuat fail pdf daripada fail tex, dsb. Jadi
apabila pdflatex disebut tanpa menyebut program-program lain, penyataan tersebut terpakai
sama-sama kepada lualatex, xelatex, dan sebarang program lain yang serupa. Latexmk boleh dengan mudah
dikonfigurasikan untuk menggunakan mana-mana program ini yang diperlukan. Lihat dokumentasi untuk
pilihan berikut: -pdflatex="COMMAND", -lualatex, dan -xelatex, dan juga lihat
dokumentasi untuk $pdflatex pembolehubah konfigurasi. Pada masa ini lateksmk tidak boleh buat
pengesanan automatik program mana yang akan digunakan.

Definisi of pilihan and hujah

fail Satu atau lebih fail boleh ditentukan. Jika tiada fail dinyatakan, lateksmk akan, oleh
lalai, jalankan pada semua fail dalam direktori kerja semasa dengan sambungan ".tex".
Tingkah laku ini boleh diubah: lihat penerangan mengenai @default_files
pembolehubah dalam bahagian "Senarai pembolehubah konfigurasi yang boleh digunakan dalam permulaan
fail".

Jika fail ditentukan tanpa sambungan, maka sambungan ".tex" adalah secara automatik
ditambah, seperti yang dilakukan oleh LaTeX. Oleh itu, jika anda nyatakan:

lateksmk foo

kemudian lateksmk akan beroperasi pada fail "foo.tex".

-auxdir=FOO or -aux-directory=FOO

Menetapkan direktori untuk fail output tambahan (pdf) lateks (.aux, .log dll). ini
mencapai kesannya oleh -aux-direktori pilihan (pdf)lateks, yang pada masa ini
hanya dilaksanakan pada versi MiKTeX (pdf) lateks.

Lihat juga -luar/-output-direktori pilihan, dan $aux_dir, $out_dir, dan
$search_path_separator pembolehubah konfigurasi daripada lateksmk. Khususnya, lihat
dokumentasi dari $out_dir untuk beberapa komplikasi mengenai nama direktori
sesuai.

-bibtex
Apabila fail sumber menggunakan fail bbl untuk bibliografi, jalankan bibtex atau biber mengikut keperluan
untuk menjana semula fail bbl.

Sifat ini juga boleh dikonfigurasikan dengan menetapkan $bibtex_use berubah menjadi 2 dalam a
fail konfigurasi

-bibtex-
Jangan sekali-kali menjalankan bibtex atau biber.

Penggunaan biasa untuk pilihan ini ialah apabila dokumen datang daripada sumber luaran,
lengkap dengan fail bblnya, dan pengguna tidak mempunyai bib yang sepadan
fail tersedia. Dalam situasi ini penggunaan -bibtex- pilihan akan menghalang lateksmk
daripada cuba berlari bibtex or lada, yang akan mengakibatkan penulisan ganti bbl
fail.

-bibtex-cond
Apabila fail sumber menggunakan fail bbl untuk bibliografi, jalankan bibtex or lada as
diperlukan untuk menjana semula fail bbl, tetapi hanya jika fail bib yang berkaitan wujud.
Oleh itu apabila fail bib tidak tersedia, bibtex or lada tidak dijalankan, dengan itu
mengelak daripada menulis ganti fail bbl. Ini ialah tetapan lalai.

(Perhatikan bahawa ia mungkin untuk lateksmk untuk memutuskan bahawa fail bib tidak wujud,
walaupun fail bib memang wujud dan bibtex or lada menjumpainya. Masalahnya ialah
bahawa fail bib mungkin tidak berada dalam direktori semasa tetapi dalam beberapa laluan carian; yang
tempat lateksmk and bibtex or lada sebab yang hendak dicari tidak semestinya sama. hidup
pemasangan moden TeX dan program berkaitan masalah ini tidak sepatutnya timbul,
sejak lateksmk menggunakan kpsewhich program untuk melakukan carian, dan kpsewhich harus digunakan
laluan carian yang sama seperti bibtex and lada. Jika masalah ini timbul, gunakan -bibtex
pilihan semasa menyeru lateksmk.)

-bm
Mesej sepanduk untuk dicetak secara menyerong pada setiap halaman semasa menukar fail dvi
kepada postscript. Mesej mestilah satu hujah pada baris arahan jadi
berhati-hati dengan memetik ruang dan sebagainya.

Perhatikan bahawa jika -bm pilihan ditentukan, iaitu -ps pilihan diandaikan.

-bi
Betapa gelapnya untuk mencetak mesej sepanduk. Nombor perpuluhan antara 0 dan 1. 0 ialah
hitam dan 1 adalah putih. Nilai lalai ialah 0.95, iaitu OK melainkan kartrij toner anda
semakin rendah.

-bs
Nombor perpuluhan yang menentukan berapa besar mesej sepanduk akan dicetak.
Percubaan adalah perlu untuk mendapatkan skala yang sesuai untuk mesej anda, sebagai peraturan
ibu jari skala hendaklah kira-kira sama dengan 1100 dibahagikan dengan bilangan aksara
dalam mesej. Lalai ialah 220.0 yang sesuai untuk 5 mesej aksara.

-perintah
Senaraikan arahan yang digunakan oleh lateksmk untuk memproses fail, dan kemudian keluar.

-c Bersihkan (buang) semua fail yang boleh dijana semula yang dijana oleh getah and bibtex or lada
kecuali dvi, postscript dan pdf. Fail ini adalah gabungan fail log, aux
fail, lateksmkfail pangkalan data maklumat fail sumber, dan yang mempunyai
sambungan yang dinyatakan dalam @generated_exts pembolehubah konfigurasi. Sebagai tambahan,
fail yang ditentukan oleh $clean_ext pembolehubah konfigurasi dialih keluar.

Pembersihan ini bukannya buatan biasa. Lihat -gg pilihan jika anda ingin melakukan a
pembersihan kemudian buat.

If $bibtex_use ditetapkan kepada 0 atau 1, fail bbl dikira sebagai tidak boleh dijana semula.

If $cleanup_includes_cusdep_generated adalah bukan sifar, fail boleh dijana semula adalah
dianggap sebagai termasuk yang dijana oleh kebergantungan tersuai dan juga
dipadamkan. Jika tidak, fail ini tidak dipadamkan.

-C Bersihkan (buang) semua fail yang boleh dijana semula yang dijana oleh getah and bibtex or lada.
Ini adalah sama dengan -c pilihan dengan tambahan dvi, postscript dan pdf
fail, dan yang dinyatakan dalam $clean_full_ext pembolehubah konfigurasi.

Pembersihan ini bukannya buatan biasa. Lihat -gg pilihan jika anda ingin melakukan a
pembersihan daripada membuat.

If $bibtex_use ditetapkan kepada 0 atau 1, fail bbl dikira sebagai tidak boleh dijana semula.

If $cleanup_includes_cusdep_generated adalah bukan sifar, fail boleh dijana semula adalah
dianggap sebagai termasuk yang dijana oleh kebergantungan tersuai dan juga
dipadamkan. Jika tidak, fail ini tidak dipadamkan.

-CA (Usang). Kini bersamaan dengan -C pilihan. Lihat pilihan itu untuk butiran.

-cd Tukar kepada direktori yang mengandungi fail sumber utama sebelum memprosesnya. Kemudian
semua fail yang dijana (aux, log, dvi, pdf, dll) akan berkaitan dengan sumber
fail.

Pilihan ini amat berguna apabila lateksmk dipanggil daripada GUI yang dikonfigurasikan kepada
sembah lateksmk dengan nama laluan penuh untuk fail sumber.

-cd- JANGAN tukar ke direktori yang mengandungi fail sumber utama sebelum diproses
ia. Kemudian semua fail yang dijana (aux, log, dvi, pdf, dll) akan menjadi relatif kepada fail
direktori semasa dan bukannya fail sumber.

Ini ialah tingkah laku lalai dan sepadan dengan tingkah laku getah and
pdflatex program. Walau bagaimanapun, adalah tidak wajar tingkah laku apabila lateksmk dipanggil
oleh GUI yang dikonfigurasikan untuk memanggil lateksmk dengan nama laluan penuh untuk fail sumber.
Melihat -cd pilihan.

-CF Alih keluar fail yang mengandungi pangkalan data maklumat fail sumber, sebelum melakukannya
tindakan lain yang diminta.

-d Tetapkan mod draf. Ini mencetak mesej sepanduk "DRAF" merentasi halaman anda apabila
menukar fail dvi kepada postscript. Saiz dan keamatan boleh diubah suai dengan
-bs and -bi pilihan. The -bm pilihan akan mengatasi pilihan ini kerana ini sebenarnya
hanya cara singkat untuk menentukan:

lateksmk -bm DRAF

Perhatikan bahawa jika -d pilihan ditentukan, iaitu -ps pilihan diandaikan.

-deps Tunjukkan senarai fail bergantung selepas diproses. Ini dalam bentuk a
senarai pergantungan borang yang digunakan oleh membuat program, dan oleh itu sesuai
untuk digunakan dalam Makefile. Ia memberikan pandangan keseluruhan fail tanpa penyenaraian
fail perantaraan, serta lateksmk boleh menentukan mereka.

Secara lalai senarai fail bergantung dihantar ke stdout (iaitu, biasanya ke
skrin melainkan anda telah mengubah hala lateksmkkeluaran). Tetapi anda boleh menetapkan nama fail
di mana senarai itu dihantar oleh -deps-out= pilihan.

Lihat bahagian " MENGGUNAKAN lateksmk DENGAN membuat" untuk contoh cara menggunakan kebergantungan
senaraikan dengan membuat.

Pengguna yang biasa dengan GNU automatik and gcc akan mendapati bahawa -deps pilihan sangat
sama dalam tujuan dan hasilnya kepada -M pilihan untuk gcc. (Malah, lateksmk Juga
mempunyai pilihan -M, -MF, dan -MP pilihan yang berkelakuan seperti yang gcc.)

- tanggungan
Bersamaan dengan -deps.

-deps- Jangan tunjukkan senarai fail bergantung selepas diproses. (Ini adalah lalai.)

-tanggungan-
Bersamaan dengan -deps-.

-deps-out=FILENAME
Tetapkan nama fail yang mana senarai fail bergantung ditulis. Jika FILENAME
argumen ditinggalkan atau ditetapkan kepada "-", kemudian output dihantar ke stdout.

Penggunaan pilihan ini juga menghidupkan output senarai fail bergantung selepas
pemprosesan.

-dF Penapisan fail Dvi. Hujah untuk pilihan ini ialah penapis yang akan menghasilkan a
fail dvi yang ditapis dengan sambungan ".dviF". Semua pemprosesan tambahan (cth.
penukaran kepada postskrip, pratonton, percetakan) kemudiannya akan dilakukan pada ini
fail dvi yang ditapis.

Contoh penggunaan: Untuk menggunakan dviselect untuk memilih hanya halaman genap fail dvi:

latexmk -dF "dviselect even" foo.tex

-diagnostik
Cetak diagnostik terperinci semasa larian. Ini boleh membantu untuk masalah nyahpepijat atau
untuk memahami lateksmktingkah laku dalam situasi yang sukar.

-dvi Hasilkan versi dvi dokumen.

-dvi- Matikan penjanaan versi dvi dokumen. (Ini mungkin akan diganti, jika ada
fail lain dibuat (cth., fail .ps) yang dijana daripada fail dvi, atau jika tiada
fail yang dihasilkan sama sekali diminta.)

-e
Laksanakan kod permulaan yang ditentukan sebelum diproses. Kodnya ialah Perl kod
dalam bentuk yang sama seperti yang digunakan dalam lateksmkfail permulaan -- untuk butiran lanjut,
lihat maklumat pada -r pilihan, dan bahagian tentang
"Fail konfigurasi/inisialisasi (RC)". Kod itu lazimnya merupakan urutan daripada
penyataan tugasan dipisahkan dengan titik bertitik.

Kod tersebut dilaksanakan apabila -e pilihan ditemui semasa lateksmk's parsing of
baris arahannya. Lihat -r pilihan untuk cara melaksanakan kod permulaan
daripada fail. Ralat mengakibatkan lateksmk berhenti. Berbilang contoh -r
and -e pilihan boleh digunakan, dan ia dilaksanakan mengikut susunan yang dipaparkan pada
baris perintah.

Beberapa penjagaan diperlukan untuk menangani petikan aksara khas dalam kod yang betul
pada baris arahan. Sebagai contoh, katakan anda ingin menetapkan arahan lateks untuk digunakan
pilihan -shell-escape, kemudian di bawah UNIX/LINUX anda boleh menggunakan baris tersebut

lateksmk -e '$latex=q/latex %O -shell-escape %S/' file.tex

Ambil perhatian bahawa petikan tunggal menyekat cengkerang perintah UNIX/LINUX biasa daripada merawat
watak-watak di dalam petikan sebagai istimewa. (Dalam contoh ini, q/.../
membina ialah a Perl simpulan bahasa yang setara dengan menggunakan petikan tunggal. Ini mengelakkan
komplikasi mendapatkan watak petikan dalam rentetan yang telah dipetik dengan cara
yang bebas daripada kedua-dua shell dan sistem pengendalian.)

Baris arahan di atas TIDAK akan berfungsi di bawah MS-Windows dengan cmd.exe atau command.com
atau 4nt.exe. Untuk MS-Windows dengan cengkerang arahan ini boleh anda gunakan

lateksmk -e "$latex=q/latex %O -shell-escape %S/" file.tex

or

lateksmk -e "$latex='lateks %O -shell-escape %S'" file.tex

Dua contoh terakhir TIDAK akan berfungsi dengan cengkerang arahan UNIX/LINUX.

-f Memaksa lateksmk untuk meneruskan pemprosesan dokumen walaupun terdapat ralat. Biasalah, bila
lateksmk mengesan bahawa LaTeX atau program lain telah menemui ralat yang tidak akan berlaku
diselesaikan dengan pemprosesan selanjutnya, tiada pemprosesan lanjut dijalankan.

Nota: "Pemprosesan lanjut" bermaksud menjalankan program lain atau menjalankan semula
getah (dll) yang akan dilakukan jika tiada ralat berlaku. Jika sebaliknya, atau
tambahan, anda mahukan getah (dll) atur cara untuk tidak berhenti seketika untuk input pengguna selepas an
ralat, anda harus mengatur ini dengan pilihan yang dihantar kepada program, mis., oleh
lateksmkpilihan -interaksi=mod tanpa henti.

-f- Matikan pemprosesan paksa-ralat lampau seperti yang ditetapkan oleh -f pilihan. Ini
boleh digunakan untuk mengatasi tetapan dalam fail konfigurasi.

-g Memaksa lateksmk untuk memproses dokumen sepenuhnya, walaupun dalam situasi di mana lateksmk akan
biasanya memutuskan bahawa tiada perubahan dalam fail sumber telah berlaku sejak
larian sebelumnya. Pilihan ini berguna, sebagai contoh, jika anda menukar beberapa pilihan dan
ingin memproses semula fail.

-g- Matikan -g.

-gg "Mod super go" atau "clean make": bersihkan fail yang dijana seolah-olah -C telah diberikan,
dan kemudian lakukan pembuatan biasa.

-h, -membantu
Cetak maklumat bantuan.

-nama kerja=STRING
Tetapkan nama asas fail output kepada STRING, bukannya nama lalai, iaitu
nama asas fail TeX yang ditentukan.

Ini adalah seperti pilihan yang sama untuk pelaksanaan semasa getah, pdflatex,
dll, dan pemindahan pilihan ini kepada program ini adalah sebahagian daripada lateksmk's
pelaksanaan -nama kerja.

-l Jalankan dalam mod landskap, menggunakan mod landskap untuk pratonton dan dvi ke
penukar postskrip. Pilihan ini biasanya tidak diperlukan pada masa kini, sejak semasa
pratonton biasanya menentukan maklumat ini secara automatik.

-l- Matikan -l.

-latex="COMMAND"
Ini menetapkan rentetan yang menentukan arahan untuk menjalankan lateks, dan biasanya digunakan untuk
tambah pilihan yang diingini. Oleh kerana rentetan biasanya mengandungi ruang, ia sepatutnya
dipetik, cth.,

latexmk -latex="latex --shell-escape %O %S" foo.tex

Spesifikasi kandungan rentetan adalah sama seperti untuk $lateks
pembolehubah konfigurasi. Bergantung pada sistem pengendalian anda dan baris arahan
shell yang anda gunakan, anda mungkin perlu menukar petikan tunggal kepada petikan berganda (atau
sesuatu yang lain).

Untuk menetapkan arahan untuk menjalankan pdflatex (bukannya arahan untuk lateks) lihat
-pdflatex pilihan.

Ambil perhatian bahawa kesan pilihan ini juga boleh dicapai dengan menggunakan -e pilihan
dengan baris kod Perl yang sesuai untuk menetapkan $lateks pembolehubah. Lihat penjelasannya
daripada -e pilihan.

-lualatex
Gunakan lualatex. Iaitu, gunakan lualatex untuk memproses fail sumber kepada pdf (di tempat
daripada pdflatex). Pilihan ini betul-betul sama dengan menentukan yang berikut
urutan pilihan:
-pdflatex="lualatex %O %S" -pdf -dvi- -ps-
-M Tunjukkan senarai fail bergantung selepas diproses. Ini bersamaan dengan -deps
pilihan.

-MF fail
Jika senarai tanggungan dibuat, -MF menentukan fail untuk menulisnya.

-MP Jika senarai tanggungan dibuat, masukkan sasaran palsu untuk setiap fail sumber. Jika
anda menggunakan senarai tanggungan dalam Makefile, peraturan dummy mengatasi ralat yang dibuat
memberi jika anda mengalih keluar fail pengepala tanpa mengemas kini Makefile untuk dipadankan.

-penonton baru
Apabila dalam mod pratonton berterusan, sentiasa mulakan pemapar baharu untuk melihat yang dijana
fail. Secara lalai, lateksmk akan, dalam mod pratonton berterusan, menguji untuk sebelumnya
menjalankan pratonton untuk fail yang sama dan tidak memulakan yang baharu jika pratonton sebelumnya
adalah berlari. Walau bagaimanapun, ujiannya kadangkala gagal (terutamanya jika terdapat ujian yang sudah-
menjalankan pratonton yang melihat fail dengan nama yang sama seperti fail semasa, tetapi
dalam direktori yang berbeza). Pilihan ini mematikan tingkah laku lalai.

-penonton-baru-
Songsang daripada -penonton baru pilihan. Ia meletakkan lateksmk dalam tingkah laku biasa itu
dalam mod pratonton-berterusan ia menyemak pratonton yang sudah berjalan.

-nobibtex
Jangan sekali-kali menjalankan bibtex atau biber.

Penggunaan biasa untuk pilihan ini ialah apabila dokumen datang daripada sumber luaran,
lengkap dengan fail bblnya, dan pengguna tidak mempunyai bib yang sepadan
fail tersedia. Dalam situasi ini penggunaan -nobibtex pilihan akan menghalang
lateksmk daripada cuba berlari bibtex or lada, yang akan mengakibatkan penggantian
fail bbl.

-norc Matikan pembacaan automatik fail permulaan (rc).

N.B. Biasanya fail permulaan dibaca dan dipatuhi, dan kemudian baris arahan
pilihan dipatuhi mengikut susunan yang ditemui. Tetapi -norc adalah pengecualian kepada
peraturan ini: ia bertindak terlebih dahulu, tidak kira di mana ia berlaku pada baris arahan.

-outdir=FOO or -output-directory=FOO

Menetapkan direktori untuk fail output (pdf) lateks. Ini mencapai kesannya dengan
yang -output-direktori pilihan (pdf) lateks, yang pada masa ini (Dis. 2011 dan kemudian)
dilaksanakan pada versi biasa (pdf) lateks, iaitu, MiKTeX dan TeXLive. Ia
mungkin tidak terdapat dalam versi lain.

Lihat juga -auxdir/-aux-direktori pilihan, dan $aux_dir, $out_dir, dan
$search_path_separator pembolehubah konfigurasi daripada lateksmk. Khususnya, lihat
dokumentasi dari $out_dir untuk beberapa komplikasi mengenai nama direktori
sesuai.

-p Cetak dokumen. Secara lalai, fail yang akan dicetak adalah yang pertama dalam senarai
postscript, pdf, dvi yang sedang dibuat. Tetapi anda boleh menggunakan -cetak=... pilihan untuk
tukar jenis fail yang akan dicetak dan anda boleh mengkonfigurasi ini dalam permulaan
fail (dengan menetapkan $print_type pembolehubah).

Walau bagaimanapun, pencetakan didayakan secara lalai hanya di bawah sistem UNIX/LINUX, di mana
lalai adalah menggunakan arahan lpr dan hanya pada fail postskrip. Secara amnya,
tingkah laku yang betul untuk mencetak sangat bergantung pada perisian sistem anda. Dalam
khususnya, di bawah MS-Windows anda mesti mempunyai program yang sesuai tersedia, dan anda
mesti telah mengkonfigurasi arahan cetak yang digunakan oleh lateksmk. Ini boleh jadi bukan remeh.
Lihat dokumentasi pada $lpr, $lpr_dvi, dan $lpr_pdf pembolehubah konfigurasi
untuk melihat cara menetapkan arahan untuk mencetak.

Pilihan ini tidak serasi dengan -pv and -pvc pilihan, jadi ia mematikannya.

-pdf Hasilkan versi pdf dokumen menggunakan pdflatex. (Jika anda ingin menggunakan lualatex or
xelatex, anda boleh menggunakan mana-mana pilihan -lualatex or -xelatex terpakai.) Kepada
mengkonfigurasi lateksmk untuk mempunyai tingkah laku sedemikian secara lalai, lihat bahagian pada
"Fail konfigurasi/inisialisasi (rc)".

-pdfdvi
Hasilkan versi pdf dokumen daripada fail dvi, secara lalai menggunakan dvipdf.

-pdfps Hasilkan versi pdf dokumen daripada fail ps, secara lalai menggunakan ps2pdf.

-pdf- Matikan penjanaan versi pdf dokumen. (Ini boleh digunakan untuk mengatasi a
tetapan dalam fail konfigurasi. Ia mungkin akan dibatalkan jika ada pilihan lain
memerlukan penjanaan fail pdf.)

-pdflatex="COMMAND"
Ini menetapkan rentetan yang menentukan arahan untuk menjalankan pdflatex, dan biasanya digunakan
untuk menambah pilihan yang dikehendaki. Oleh kerana rentetan biasanya mengandungi ruang, ia sepatutnya
dipetik, cth.,

latexmk -pdf -pdflatex="pdflatex --shell-escape %O %S" foo.tex

Spesifikasi kandungan rentetan adalah sama seperti untuk $pdflatex
pembolehubah konfigurasi. Bergantung pada sistem pengendalian anda dan baris arahan
shell yang anda gunakan, anda mungkin perlu menukar petikan tunggal kepada petikan berganda (atau
sesuatu yang lain).

Pilihan ini juga boleh digunakan untuk menetapkan program yang akan digunakan dan bukannya standard
pdflatex program, cth,

latexmk -pdf -pdflatex="lualatex %O %S" foo.tex

untuk digunakan lualatex or

latexmk -pdf -pdflatex="xelatex %O %S" foo.tex

untuk digunakan xelatex.

Untuk menetapkan arahan untuk berjalan getah (bukannya perintah untuk pdflatex) lihat
-lateks pilihan.

Ambil perhatian bahawa kesan pilihan ini juga boleh dicapai dengan menggunakan -e pilihan
dengan baris kod Perl yang sesuai untuk menetapkan $pdflatex pembolehubah. Lihat
penjelasan mengenai -e pilihan.

-print=dvi, -cetak=ps, -cetak=pdf, -print=auto,
Tentukan jenis fail yang dicetak. Pilihan ini juga memastikan bahawa yang diperlukan
fail dibuat, dan menghidupkan pencetakan.

Kes (lalai). -cetak=auto menentukan jenis fail cetakan secara automatik daripada
set fail yang sedang dibuat. Yang pertama dalam senarai postscript, pdf, dvi
itu antara fail yang akan dibuat ialah yang digunakan untuk print out.

-ps Hasilkan versi posskrip dokumen.

-ps- Matikan penjanaan versi posskrip dokumen. Ini boleh digunakan untuk
mengatasi tetapan dalam fail konfigurasi. (Ia mungkin ditindih oleh orang lain
pilihan yang memerlukan fail posskrip, contohnya permintaan untuk mencetak.)

-pF Penapisan fail pascaskrip. Hujah untuk pilihan ini ialah penapis yang akan
jana fail posskrip yang ditapis dengan sambungan ".psF". Semua tambahan
pemprosesan (cth. pratonton, pencetakan) kemudiannya akan dilakukan pada yang ditapis ini
fail posskrip.

Contoh penggunaan: Gunakan psnup untuk mencetak dua halaman pada satu halaman:

latexmk -ps -pF 'psnup -2' foo.tex

or

latexmk -ps -pF "psnup -2" foo.tex

Sama ada untuk menggunakan petikan tunggal atau dua kali bulatan "psnup -2" bergantung pada anda
jurubahasa arahan, seperti yang digunakan oleh versi tertentu perl dan operasi
sistem pada komputer anda.

-pv Jalankan pratonton fail. Sekiranya -pandangan pilihan digunakan, ini akan memilih jenis fail
untuk dipratonton (dvi, ps atau pdf). Jika tidak, penonton melihat jenis "tertinggi".
fail dipilih, oleh -dvi, -ps, -pdf, -pdfps pilihan, dalam susunan dvi, ps, pdf
(rendah ke tinggi). Jika tiada jenis fail telah dipilih, pratonton dvi akan digunakan.
Pilihan ini tidak serasi dengan -p and -pvc pilihan, jadi ia mematikannya.

-pv- Matikan -pv.

-pvc Jalankan pratonton fail dan kemas kini fail .dvi, .ps dan/atau .pdf secara berterusan
apabila perubahan dibuat pada fail sumber (lihat Penerangan di atas). Yang mana satu
fail ini dijana dan yang dilihat dikawal oleh pilihan lain, dan
adalah sama seperti untuk -pv pilihan. Pilihan pratonton-berterusan -pvc hanya boleh
bekerja dengan satu fail. Jadi dalam kes ini anda biasanya hanya akan menentukan satu nama fail pada
baris arahan. Ia juga tidak serasi dengan -p and -pv pilihan, jadi ia bertukar
pilihan ini dimatikan.

. -pvc pilihan juga mematikan mod daya (-f), seperti yang biasanya terbaik untuk berterusan
mod pratonton. Jika anda benar-benar mahukan mod paksa, gunakan pilihan dalam susunan -pvc -f.

Dengan pratonton yang baik paparan akan dikemas kini secara automatik. (Di bawah beberapa tetapi
tidak semua versi UNIX/Linux "gv -watch" melakukan ini untuk fail postscript; ini boleh
ditetapkan oleh pembolehubah konfigurasi. Ini juga akan berfungsi untuk fail pdf kecuali untuk
pepijat jelas dalam gv yang menyebabkan ralat apabila fail pdf yang baru dikemas kini adalah
baca.) Banyak pratonton lain memerlukan kemas kini manual.

penting ambil perhatian: program acroread pada MS-Windows mengunci fail pdf, dan menghalang
versi baharu sedang ditulis, jadi adalah idea yang tidak baik untuk menggunakan acroread untuk melihat fail pdf
dalam mod pratonton-berterusan. Adalah lebih baik untuk menggunakan pemapar yang berbeza: SumatraPDF dan
gsview adalah kemungkinan yang baik.

Terdapat beberapa kaedah lain untuk mengatur kemas kini, terutamanya berguna untuk ramai orang
versi xdvi dan xpdf. Ini adalah yang terbaik ditetapkan lateksmkkonfigurasi; lihat
di bawah.

Perhatikan bahawa jika lateksmk mati atau dihentikan oleh pengguna, pratonton "bercabang" akan
terus berlari. Doa berturut-turut dengan -pvc pilihan tidak akan bercabang baru
pratonton, tetapi lateksmk biasanya akan menggunakan pratonton sedia ada. (Sekurang-kurangnya ini
akan berlaku apabila lateksmk sedang berjalan di bawah sistem pengendalian di mana ia tahu bagaimana untuk
tentukan sama ada pratonton sedia ada sedang berjalan.)

-pvc- Matikan -pvc.

-senyap Sama seperti -senyap

-r
Baca fail permulaan yang ditentukan ("Fail RC") sebelum memproses.

Berhati-hati tentang susunan: (1) Fail permulaan standard -- lihat bahagian
di bawah pada "Fail konfigurasi/inisialisasi (RC)" -- dibaca dahulu. (2) Kemudian
pilihan pada baris arahan bertindak mengikut susunan yang diberikan. Oleh itu jika
fail permulaan ditentukan oleh -r pilihan, ia dibaca semasa detik ini
langkah. Oleh itu, fail permulaan ditentukan dengan -r pilihan boleh mengatasi kedua-duanya
fail permulaan standard dan sebelum ini pilihan yang ditentukan. Tetapi semua
ini boleh ditindih oleh kemudian pilihan.

Kandungan fail RC hanya terdiri daripada sekeping kod dalam Perl pengaturcaraan
bahasa (biasanya urutan pernyataan tugasan); mereka dilaksanakan apabila
yang -r pilihan ditemui semasa lateksmk's menghuraikan baris arahannya. Lihat
-e pilihan untuk cara memberikan kod permulaan secara terus lateksmkarahan
barisan. Ralat mengakibatkan lateksmk berhenti. Berbilang contoh -r and -e
pilihan boleh digunakan, dan ia dilaksanakan mengikut susunan yang dipaparkan pada arahan
line.

-perakam
Gunakan pilihan -recorder dengan getah and pdflatex. Dalam (kebanyakan) versi moden
program ini, ini menghasilkan fail sambungan .fls yang mengandungi senarai
fail yang telah dibaca dan ditulis oleh program ini. Latexmk kemudian akan menggunakan fail ini
untuk meningkatkan pengesanan fail sumber dan fail yang dijana selepas dijalankan getah
or pdflatex.

Untuk maklumat lanjut, lihat dokumentasi untuk $perakam konfigurasi
berubah-ubah.

-perakam-
Jangan gunakan pilihan -recorder dengan getah and pdflatex.

-peraturan Tunjukkan senarai latemkperaturan dan kebergantungan selepas pemprosesan.

-peraturan-
Jangan tunjukkan senarai lateksmkperaturan dan kebergantungan selepas pemprosesan. (Ini adalah
lalai.)

-tunjukkanextraoptions
Tunjukkan senarai tambahan getah and pdflatex pilihan yang lateksmk mengenali. Ini
adalah pilihan untuk getah and pdflatex Bahawa lateksmk mengenali, tetapi hanya lulus
melalui program ini apabila ia dijalankan. Pilihan ini adalah (pada masa ini) a
gabungan yang dibenarkan oleh pelaksanaan TeXLive dan MiKTeX. (Sekiranya
pilihan tertentu diberikan kepada lateksmk tetapi tidak dikendalikan oleh pihak tertentu
pelaksanaan getah or pdflatex yang sedang digunakan, program itu mungkin akan
berikan mesej ralat.) Pilihan ini sangat banyak, tetapi tidak disenaraikan dalam
dokumentasi ini kerana ia tidak mempunyai kesan ke atas lateksmktindakannya.

Terdapat beberapa pilihan (-includedirectory=dir, -memulakan, -ini) yang bukan
diiktiraf, sama ada kerana ia tidak sesuai dengannya lateksmkoperasi yang dimaksudkan, atau
kerana mereka memerlukan pemprosesan khas oleh lateksmk yang tidak dilaksanakan (sekurang-kurangnya,
belum lagi).

Terdapat juga pilihan yang diterima oleh getah dll, tetapi sebaliknya mencetuskan tindakan
by lateksmk: -membantu, -turun.

Akhirnya, terdapat pilihan tertentu untuk getah and pdflatex (contohnya, -perakam) itu
mencetuskan tindakan atau tingkah laku khas oleh lateksmk sendiri serta dilalui
beberapa bentuk kepada yang dipanggil getah and pdflatex program, atau yang menjejaskan program lain
juga. Pilihan ini mempunyai entri dalam dokumentasi ini. Pilihan ini ialah:
-nama kerja=STRING, -aux-directory=dir, -output-directory=DIR, -senyap, dan -perakam.

-senarai amaran fail log
-amaran fail log Selepas menjalankan (pdf) lateks, berikan senarai amaran tentang undefined
petikan dan rujukan (melainkan mod senyap dihidupkan).

Lihat juga pembolehubah konfigurasi $silence_logfile_warnings.

-senarai amaran fail log-
-amaran fail log- Selepas menjalankan (pdf) lateks, jangan berikan senarai amaran tentang
petikan dan rujukan yang tidak ditentukan. (Lalai)

Lihat juga pembolehubah konfigurasi $silence_logfile_warnings.

-senyap
Jalankan arahan secara senyap, iaitu, dengan pilihan yang mengurangkan jumlah diagnostik
dihasilkan. Sebagai contoh, dengan tetapan lalai, arahan "latex
-interaction=batchmode" digunakan untuk lateks.

Lihat juga -senarai amaran fail log and -senarai amaran fail log- pilihan.

Juga kurangkan bilangan mesej maklumat yang lateksmk menjana.

Untuk menukar pilihan yang digunakan untuk membuat arahan berjalan secara senyap, anda perlu mengkonfigurasi
lateksmk dengan nilai berubah bagi pembolehubah konfigurasinya, yang berkaitan ialah
$bibtex_silent_switch, $biber_silent_switch, $dvipdf_silent_switch,
$dvips_silent_switch, $latex_silent_switch, $makeindex_silent_switch, dan
$pdflatex_silent_switch.

-guna-buat
Apabila selepas larian getah or pdflatex, terdapat amaran tentang kehilangan fail
(cth., seperti yang diminta oleh LaTeX \input, \include, dan \includgraphics), lateksmk
cuba menjadikannya mengikut pergantungan tersuai. Jika tiada pergantungan tersuai yang berkaitan dengan an
fail sumber yang sesuai ditemui, dan jika pilihan -use-make ditetapkan, maka lateksmk
akan cuba sebagai pilihan menggunakan program make untuk cuba membuat fail yang hilang.

Ambil perhatian bahawa nama fail mungkin ditentukan tanpa sambungan, cth., oleh
\includegraphics{drawing} dalam fail LaTeX. Kalau macam itu, lateksmk akan cuba buat
drawing.ext dengan ext set pula kepada sambungan yang mungkin yang berkaitan untuk
getah (atau mengikut kesesuaian pdflatex).

Lihat juga dokumentasi untuk $use_make_for_missing_files konfigurasi
berubah-ubah.

-guna-buat-
Jangan gunakan program buat untuk cuba membuat fail yang hilang. (Lalai.)

-v, -turun
Cetak nombor versi bagi lateksmk.

-berkata-kata
Bertentangan dengan -senyap. Ini adalah tetapan lalai.

-view=default, -view=dvi, -pandangan=ps, -view=pdf
Tetapkan jenis fail yang digunakan semasa pratonton diminta (cth., oleh -pv or -pvc
suis). Lalai adalah untuk melihat jenis fail yang diminta "tertinggi" (dalam fail
pesanan dvi, ps, pdf).

-xelatex
Gunakan xelatex. Iaitu, gunakan xelatex untuk memproses fail sumber kepada pdf (di tempat
daripada pdflatex). Pilihan ini betul-betul sama dengan menentukan yang berikut
urutan pilihan:
-pdflatex="xelatex %O %S" -pdf -dvi- -ps-
Keserasian antara pilihan

Pilihan pratonton-berterusan -pvc hanya boleh berfungsi dengan satu fail. Jadi dalam kes ini anda akan
biasanya hanya menentukan satu nama fail pada baris arahan.

Pilihan -p, -pv and -pvc adalah saling eksklusif. Jadi setiap pilihan ini bertukar
yang lain dimatikan.

CONTOH

% lateksmk tesis # menjalankan getah cukup kali kepada menyelesaikan
rujukan silang

% lateksmk -pvc -ps tesis# menjalankan getah cukup kali kepada menyelesaikan
rujukan silang, membuat a kata-kata tambahan
fail, permulaan a pratonton. Kemudian
menonton khususnya perubahan in yang sumber
fail tesis.tex and mana-mana fail it
kegunaan. selepas mana-mana perubahan jalankan semula getah
yang sesuai nombor of kali and
pembuatan semula yang kata-kata tambahan fail. If getah
pertemuan an kesilapan, lateksmk akan
menyimpan berjalan, menonton khususnya
sumber fail perubahan.

% lateksmk -c # mengeluarkan .aux, .log, .bbl, .blg, .dvi,
.pdf, .ps & .bbl fail

BAGAIMANA KEPADA UBAH THE WAY LATEXMK BERKELAKUAN, BERURUSAN DENGAN MASALAH, DSB

Beberapa kemungkinan:

a. Jika anda mendapat ralat pelik, lihat dengan teliti pada output yang terdapat pada skrin dan
dalam fail log. Walaupun terdapat banyak perkara yang terkenal dalam keluaran getah (Dan
yang ditambah oleh lateksmk), verbositi ada atas sebab: untuk membolehkan pengguna
mendiagnosis masalah. Latexmk mengulangi beberapa mesej pada akhir larian yang difikirkannya
sebaliknya akan mudah terlepas di tengah-tengah keluaran lain.

b. Jika lateksmk tidak melakukan perkara seperti yang anda mahu, langkah pertama untuk mengetahui apa
yang perlu dilakukan ialah melihat dalam dokumentasi ini pada senarai pilihan baris arahan dan kemudian pada
bahagian pada fail konfigurasi/inisialisasi. Banyak lateksmkkelakuannya ialah
boleh dikonfigurasikan untuk menangani situasi tertentu. (Tetapi terdapat banyak bacaan.)

c. Helah lanjut boleh melibatkan menggantikan arahan standard itu lateksmk oleh yang lain
arahan atau skrip.

d. Untuk contoh kod yang mungkin untuk digunakan dalam fail RC, lihat direktori example_rcfiles
dalam pengagihan lateksmk (cth., di http://www.ctan.org/tex-
arkib/sokongan/latexmk/example_rcfiles). Walaupun contoh ini tidak melakukan apa yang anda mahu,
mereka mungkin memberikan inspirasi yang sesuai.

e. Terdapat helah berguna yang boleh digunakan apabila anda berada lualatex bukan pdflatex (Dan
dalam beberapa situasi yang berkaitan). Masalahnya ialah lateksmk tidak akan melihat kebergantungan pada a
fail, bar.baz katakan, yang dimasukkan oleh kod lua dalam dokumen anda dan bukannya oleh LaTeX
bahagian. (Jadi jika anda menukar bar.baz dan jalankan semula lateksmk, Maka lateksmk akan berfikir tiada fail
telah berubah dan tidak ditayangkan semula lualatex, manakala jika anda mempunyai '\input{bar.baz}' dalam LaTeX
sebahagian daripada dokumen, lateksmk akan perasan perubahan.) Satu penyelesaian adalah hanya untuk meletakkan
mengikuti suatu tempat di bahagian LaTeX dokumen:

\typeout{(bar.baz)}

Ini meletakkan baris dalam fail log yang lateksmk akan menganggap sebagai membayangkan bahawa bar fail.baz
telah dibaca. (Pada masa ini saya tidak tahu cara melakukan ini secara automatik.) Sudah tentu, jika
fail mempunyai nama yang berbeza, tukar bar.baz kepada nama fail anda.

f. Lihat pada tex.stackexchange, iaitu, di
http://tex.stackexchange.com/questions/tagged/latexmk Seseorang mungkin telah menyelesaikannya
masalah awak.

g. Tanya soalan di tex.stackexchange.com.

h. Atau tanya saya (pengarang lateksmk). E-mel saya ada di penghujung dokumentasi ini.

KONFIGURASI/PERMULAAN (CR) FILES

Latexmk boleh disesuaikan menggunakan fail permulaan, yang dibaca semasa permulaan dalam
perintah berikut:

1) Fail RC sistem, jika wujud.
Pada sistem UNIX, lateksmk mencari tempat berikut untuk fail RC sistemnya, dalam
urutan berikut, dan membaca yang pertama ia dapati:
"/opt/local/share/latexmk/LatexMk",
"/usr/local/share/latexmk/LatexMk",
"/usr/local/lib/latexmk/LatexMk".
Pada sistem MS-WINDOWS ia mencari "C:\latexmk\LatexMk".
Pada sistem cygwin (iaitu, sistem MS-Windows di mana Perl ialah cygwin), lateksmk
membaca untuk yang pertama ia dapati
"/cygdrive/c/latexmk/LatexMk",
"/opt/local/share/latexmk/LatexMk",
"/usr/local/share/latexmk/LatexMk",
"/usr/local/lib/latexmk/LatexMk".
Di samping itu, ia kemudian mencuba set lokasi yang sama, tetapi dengan nama fail diganti
"LatexMk" digantikan dengan "latexmkrc".

2) Fail RC pengguna, "$HOME/.latexmkrc", jika ia wujud. Di sini $HOME ialah rumah pengguna
direktori. [Latexmk menentukan direktori rumah pengguna seperti berikut: Ia adalah nilai bagi
pembolehubah persekitaran HOME, jika pembolehubah ini wujud, yang biasanya berlaku pada
Sistem seperti UNIX (termasuk LINUX dan OS-X). Jika tidak, pembolehubah persekitaran
USERPROFILE digunakan, jika wujud, yang biasanya berlaku pada sistem MS-Windows.
Jika tidak, rentetan kosong digunakan dan bukannya $HOME.]

3) Fail RC dalam direktori kerja semasa. Fail ini boleh dinamakan sama ada
"latexmkrc" atau ".latexmkrc", dan yang pertama daripada ini ditemui digunakan, jika ada.

4) Mana-mana fail RC yang dinyatakan pada baris arahan dengan -r pilihan.

Setiap fail RC ialah urutan Perl arahan. Sememangnya, pengguna boleh menggunakannya secara kreatif
cara. Tetapi untuk kebanyakan tujuan, seseorang hanya menggunakan urutan pernyataan tugasan itu
mengatasi beberapa tetapan terbina dalam Latexmk. Kes mudah boleh dikendalikan
tanpa pengetahuan tentang Perl bahasa dengan menggunakan contoh dalam dokumen ini sebagai
templat. Baris ulasan diperkenalkan oleh aksara "#".

Ambil perhatian bahawa pilihan baris arahan dipatuhi dalam susunan ia ditulis; oleh itu mana-mana
Fail RC yang ditentukan pada baris arahan dengan -r pilihan boleh mengatasi pilihan sebelumnya tetapi
boleh ditindih sendiri oleh pilihan kemudian pada baris arahan. Terdapat juga -e
pilihan, yang membenarkan kod permulaan ditentukan dalam lateksmkbaris arahan.

Untuk mungkin contoh of kod khususnya in an RC fail, lihat yang direktori example_rcfiles in yang
pengedaran of lateksmk (contohnya, at http://www.ctan.org/tex-
arkib/sokongan/latexmk/example_rcfiles).

BAGAIMANA KEPADA SET PELBAGAI IN INISIISASI FILES

Pembolehubah penting yang boleh dikonfigurasikan diterangkan dalam bahagian "Senarai
pembolehubah konfigurasi boleh digunakan dalam fail permulaan". Sintaks untuk menetapkan ini
pembolehubah adalah dalam bentuk berikut:

$bibtex = 'bibtex %O %B';

untuk tetapan pembolehubah rentetan,

$preview_mode = 1;

untuk tetapan pembolehubah berangka, dan

@default_files = ('kertas', 'kertas1');

untuk penetapan tatasusunan rentetan. Adalah mungkin untuk menambahkan item pada tatasusunan
pembolehubah seperti berikut:

tolak @default_files, 'paper2';

Ambil perhatian bahawa pembolehubah "skalar" mudah mempunyai nama yang bermula dengan aksara $ dan tatasusunan
pembolehubah mempunyai nama yang bermula dengan aksara @. Setiap pernyataan berakhir dengan koma bertitik.

Rentetan hendaklah disertakan dalam petikan tunggal. (Anda boleh menggunakan petikan berganda, seperti dalam banyak lagi
bahasa pengaturcaraan. Tetapi kemudiannya Perl bahasa pengaturcaraan memainkan beberapa
peraturan khas untuk menginterpolasi pembolehubah ke dalam rentetan. Orang tidak fasih Perl akan
mahu mengelakkan komplikasi ini.)

Anda boleh melakukan perkara yang lebih rumit, tetapi untuk ini anda perlu merujuk manual
bagi Perl bahasa pengaturcaraan.

FORMAT OF COMMAND SPESIFIKASI

Beberapa pembolehubah menetapkan arahan itu lateksmk kegunaan untuk menjalankan kerjanya, untuk
contoh untuk menjana fail dvi daripada fail tex atau untuk melihat fail postscript. Bahagian ini
menerangkan beberapa ciri penting tentang cara arahan ditentukan.

Pemegang tempat: Sepatutnya awak mahu lateksmk untuk menggunakan perintah elatex sebagai ganti
arahan lateks biasa, dan andaikan lebih-lebih lagi anda ingin memberikannya pilihan
"--cangkang-melarikan diri". Anda boleh melakukan ini dengan tetapan berikut:

$lateks = 'elatex --shell-escape %O %S';

Kedua-dua item yang bermula dengan % aksara ialah pemegang tempat. Ini digantikan oleh
nilai yang sesuai sebelum arahan dijalankan. Oleh itu %S akan digantikan dengan fail sumber
elatex itu akan digunakan dan %O akan digantikan dengan mana-mana pilihan yang lateksmk mempunyai
memutuskan untuk digunakan untuk arahan ini. (Contohnya, jika anda menggunakan pilihan -silent ia akan menggantikan
%O oleh "-interaction=batchmode".)

Ruang letak yang tersedia ialah:

%B asas nama fail untuk arahan semasa. Cth., jika dokumen fail postskrip.ps adalah
dibuat daripada fail dvi document.dvi, maka nama asasnya ialah dokumen.

%D fail destinasi (cth., nama fail postskrip semasa menukar fail dvi
kepada postscript).

%O pilihan

%R nama fail root. Ini ialah nama asas untuk fail teks utama.

%S fail sumber (cth., nama fail dvi semasa menukar fail dvi kepada ps).

%T Nama fail teks utama.

%Y Nama direktori untuk fail output tambahan (lihat pembolehubah konfigurasi
$aux_dir). Aksara pemisahan direktori ('/') dilampirkan jika $aux_dir bukan-
kosong dan tidak berakhir dengan watak yang sesuai, dengan watak yang sesuai adalah
yang sesuai dengan UNIX dan MS-Windows, iaitu, ':', '/' dan '\'.

%Z Nama direktori untuk fail output (lihat pembolehubah konfigurasi $out_dir). Yang
aksara pemisahan direktori ('/') dilampirkan jika $out_dir tidak kosong dan tidak
tidak berakhir dengan watak yang sesuai, dengan watak yang sesuai adalah yang sesuai
kepada UNIX dan MS-Windows, iaitu, ':', '/' dan '\'.

Jika atas sebab tertentu anda memerlukan aksara % literal dalam rentetan anda tidak tertakluk kepada perkara di atas
peraturan, gunakan sepasang aksara ini. Oleh itu dengan spesifikasi arahan $ps_previewer
= 'lateks -ad=%%Sfile.ad %S', %%S akan menjadi %S apabila arahan itu dilaksanakan, tetapi
%S akan digantikan dengan nama fail sumber, yang dalam kes ini akan menjadi nama a
fail postskrip untuk dilihat.

Petikan yang sesuai akan digunakan pada penggantian nama fail, jadi anda tidak boleh membekalkannya
mereka sendiri walaupun nama fail anda mempunyai ruang di dalamnya. (Tetapi jika TeX anda
nama fail mempunyai ruang di dalamnya, berhati-hati bahawa banyak versi program TeX tidak boleh
mengendalikan nama fail yang mengandungi ruang dengan betul.) Sekiranya petikan latexmk tidak berfungsi
dengan betul pada sistem anda, anda boleh mematikannya -- lihat dokumentasi untuk pembolehubah
$quote_filenames.

Perbezaan antara %B dan %R memerlukan sedikit penjagaan, kerana ia selalunya sama, tetapi
tidak selalu. Contohnya pada dokumen ringkas, nama asas bagi larian bibtex adalah sama seperti
untuk texfile. Tetapi dalam dokumen dengan beberapa bibliografi, fail bibliografi
akan mempunyai pelbagai nama. Oleh kerana bibtex digunakan dengan nama asas bagi
fail bibliografi, maka tetapan untuk arahan bibtex hendaklah

$bibtex = 'bibtex %O %B';

Secara amnya, anda harus menggunakan %B dan bukannya %R. Begitu juga untuk kebanyakan tujuan, nama %T of
texfile utama bukan pemegang tempat yang berguna.

Lihat nilai lalai dalam bahagian "Senarai pembolehubah konfigurasi yang boleh digunakan dalam
fail permulaan" untuk penggunaan yang biasanya paling sesuai.

Jika anda meninggalkan untuk membekalkan mana-mana ruang letak apa sahaja dalam spesifikasi arahan, lateksmk
akan membekalkan apa yang penulis fikirkan sebagai lalai yang sesuai. Ini memberikan keserasian
dengan fail konfigurasi untuk versi sebelumnya lateksmk, yang tidak menggunakan ruang letak.

"Melepaskan" a arahan: Biasanya bila lateksmk menjalankan arahan, ia menunggu arahan untuk
berlari hingga selesai. Ini sesuai untuk arahan seperti lateks, sudah tentu. Tetapi untuk
pratonton, arahan itu biasanya dijalankan secara berasingan, supaya lateksmk mendapat pratonton
berjalan dan kemudian kembali ke tugas seterusnya (atau keluar jika tiada apa-apa lagi yang perlu dilakukan). Kepada
mencapai kesan mencabut arahan ini, anda perlu mendahului nama arahan dengan
"mula", seperti dalam

$dvi_previewer = 'mulakan xdvi %O %S';

Ini akan diterjemahkan kepada apa sahaja yang sesuai untuk sistem pengendalian anda.

Nota: (1) Dalam beberapa keadaan, getah akan sentiasa menjalankan arahan terpisah. Ini adalah
kes untuk pratonton dalam mod berterusan pratonton, kerana sebaliknya pratonton secara berterusan
tidak masuk akal. (2) Ini menghalang kemungkinan menjalankan arahan bernama permulaan. (3)
Jika perkataan mula berlaku lebih daripada sekali pada permulaan rentetan arahan, iaitu
setara dengan hanya mempunyai satu. (4) Di bawah cygwin, beberapa komplikasi berlaku, sejak cygwin
adalah penggabungan rumit UNIX dan MS-Windows. Lihat kod sumber untuk mengetahui cara saya
menangani masalah tersebut.

Perintah nama yang mengandungi ruang: Di bawah MS-Windows adalah perkara biasa bahawa nama arahan
termasuk ruang, kerana perisian sering dipasang dalam subdirektori "C:\Program
Fail". Nama arahan sedemikian hendaklah disertakan dalam petikan berganda, seperti dalam

$lpr_pdf = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p %S';
$pdf_previewer = 'mulakan "c:/Program Files/SumatraPDF/SumatraPDF.exe" %O %S';
$pdf_previewer = 'mulakan "c:/Program Files/SumatraPDF (x86)/SumatraPDF.exe" %O %S';

(Nota tentang contoh di atas: Garis miring ke hadapan adalah bersamaan dengan garis miring ke belakang dalam nama fail
di bawah MS-Windows, dengan syarat nama fail berada di dalam petikan berganda. Ia lebih mudah digunakan
garis miring ke hadapan dalam contoh seperti di atas, sejak itu seseorang tidak perlu risau
tentang peraturan untuk menangani garis miring ke hadapan dalam rentetan dalam bahasa Perl.)

Perintah nama di bawah Cygwin: Jika lateksmk dilaksanakan oleh Perl Cygwin, be terutamanya
tertentu Bahawa nama laluan in arahan mempunyai ke hadapan slashes bukan garis miring ke belakang yang biasa untuk
pemisah komponen nama laluan. Lihat contoh di atas. Garis miring ke belakang sering berlaku
disalahtafsirkan oleh cangkerang Unix yang digunakan oleh Perl Cygwin untuk melaksanakan arahan luaran.
Garis miring ke hadapan tidak mengalami masalah ini, dan (apabila dipetik, seperti di atas) adalah sama
boleh diterima oleh MS-Windows.

Menggunakan MS-Windows fail persatuan: Helah berguna di bawah versi moden MS-Windows
(cth., WinXP) adalah menggunakan hanya arahan 'mula' dengan sendirinya:

$dvi_previewer = 'mulakan %S';

Di bawah versi terkini MS-Windows, ini akan menyebabkan untuk menjalankan apa jua program sistem
telah dikaitkan dengan fail dvi. (Perkara yang sama berlaku untuk pemapar postskrip dan pdf
viewer.) Tetapi ambil perhatian bahawa helah ini tidak selalunya sesuai untuk previwer pdf, jika anda
sistem mempunyai acroread untuk pemapar pdf lalai. Seperti yang dijelaskan di tempat lain, acroread di bawah
MS-Windows tidak berfungsi dengan baik getah and lateksmk, kerana acroread mengunci fail pdf.

tidak menggunakan a tertentu arahan: Jika arahan tidak akan dijalankan, nama arahan NONE digunakan,
seperti dalam

$lpr = 'TIADA lpr';

Ini biasanya digunakan apabila arahan yang sesuai tidak wujud pada sistem anda. The
rentetan selepas "TIADA" adalah ulasan yang berkesan.

Pilihan kepada arahan: Menetapkan nama arahan boleh digunakan bukan sahaja untuk menukar
nama arahan yang dipanggil, tetapi juga untuk menambah pilihan kepada arahan. Katakan anda mahu lateksmk
untuk menggunakan lateks dengan sumber istimewa didayakan. Kemudian anda boleh menggunakan baris berikut dalam a
fail permulaan:

$lateks = 'lateks --src-specials %O %S';

Berlari a subrutin sebaliknya of an luar arahan: Gunakan spesifikasi bermula dengan
"dalaman", seperti dalam

$lateks = 'mylatex dalaman %O %S';
sub mylatex {
my @args = @_;
# Kemungkinan prapemprosesan di sini
sistem pulangan 'lateks', @args;
}

Maju muslihat: Biasanya seseorang menentukan satu arahan untuk arahan yang digunakan oleh
lateksmk. Sememangnya, jika terdapat beberapa pemprosesan tambahan yang rumit yang perlu anda lakukan
situasi istimewa anda, anda boleh menulis skrip (atau fail kelompok) untuk melakukan pemprosesan, dan
kemudian konfigurasikan lateksmk untuk menggunakan skrip anda sebagai ganti program standard.

Ia juga mungkin untuk mengkonfigurasi lateksmk untuk menjalankan berbilang arahan. Contohnya, jika bila
menjalankan pdflatex untuk menjana fail pdf daripada fail tex yang anda perlukan untuk menjalankan program lain
selepas pdflatex untuk melakukan beberapa pemprosesan tambahan, anda boleh melakukan sesuatu seperti:

$pdflatex = 'pdflatex --shell-escape %O %S; pst2pdf_for_latexmk %B';

Takrifan ini menganggap anda menggunakan sistem seperti UNIX (yang termasuk Linux dan OS-X),
supaya kedua-dua arahan yang akan dijalankan dipisahkan oleh koma bertitik di tengah-tengah
tali.

Jika anda menggunakan MS-Windows, anda akan menggantikan baris di atas dengan

$pdflatex = 'cmd /c pdflatex --shell-escape %O %S'
. '&& pst2pdf_for_latexmk %B';

Di sini, pemisah arahan UNIX ; digantikan dengan &&. Di samping itu, terdapat masalah
bahawa beberapa versi Perl pada MS-Windows jangan patuhi pemisah arahan; masalah ini
diatasi dengan menggunakan pemproses baris arahan MS-Windows secara eksplisit cmd.exe.

SENARAI OF CONFIGURATION PELBAGAI DIGUNAKAN IN INISIISASI FILES

Nilai lalai ditunjukkan dalam kurungan.

$always_view_file_via_temporary [0]
Sama ada fail ps dan pdf pada mulanya akan dibuat dalam direktori sementara dan kemudian
berpindah ke lokasi akhir. (Ini terpakai kepada dvips, dvipdf dan ps2pdf
operasi, dan operator penapisan pada fail dvi dan ps. Ia tidak terpakai kepada
pdflatex, malangnya.)

Penggunaan fail sementara ini menyelesaikan masalah yang boleh dilakukan oleh pembuatan fail ini
menempati masa yang banyak. Jika penonton melihat bahawa fail telah berubah, ia berbunyi
fail baharu, dan ini boleh menyebabkan malapetaka jika program menulis fail itu belum lagi
selesai kerjanya.

Melihat $pvc_view_file_via_temporary pembolehubah untuk tetapan yang digunakan hanya jika
mod pratonton-berterusan (pilihan-pvc) digunakan. Lihat $tmpdir untuk penetapan
direktori tempat fail sementara dibuat.

$auto_rc_use [1]
Sama ada untuk membaca fail pemula standard (rc) secara automatik, iaitu
fail RC sistem, fail RC pengguna dan fail RC dalam direktori semasa. The
pilihan baris arahan -norc boleh digunakan untuk mematikan tetapan ini. Setiap fail RC boleh
juga matikan tetapan ini, iaitu, ia boleh ditetapkan $auto_rc_use kepada sifar untuk mengelakkan
pembacaan automatik fail RC kemudiannya.

Pembolehubah ini tidak menjejaskan bacaan fail RC yang dinyatakan pada baris arahan
oleh -r pilihan.

$aux_dir [""]
Direktori di mana fail tambahan (aux, log, dll) akan ditulis oleh run
daripada (pdf) lateks. Jika pembolehubah ini tidak ditetapkan, tetapi $out_dir ditetapkan, maka $aux_dir is
bersedia untuk $out_dir, yang merupakan direktori tempat fail keluaran am akan berada
bertulis.

penting ambil perhatian: Kesan daripada $aux_dir, jika berbeza daripada $out_dir, dicapai oleh
memberi (pdf)lateks yang -aux-direktori. Pada masa ini (Dis. 2011 dan kemudian) ini sahaja
berfungsi pada versi MiKTeX (pdf) lateks.

Lihat juga dokumentasi bagi $out_dir untuk beberapa komplikasi pada direktori apa
nama sesuai.

$banner [0]
Jika bukan sifar, mesej sepanduk dicetak pada setiap halaman semasa menukar dvi
fail ke postscript. Tanpa mengubah suai pembolehubah $banner_message, Ini adalah
bersamaan dengan menyatakan -d pilihan.

Perhatikan bahawa jika $banner adalah bukan sifar, iaitu $postscript_mode diandaikan dan postskrip
fail sentiasa dijana, walaupun ia lebih baharu daripada fail dvi.

$intensiti_banner [0.95]
Setaraf dengan -bi pilihan, ini ialah nombor perpuluhan antara 0 dan 1 itu
menentukan betapa gelapnya untuk mencetak mesej sepanduk. 0 adalah hitam, 1 adalah putih. The
lalai adalah tepat jika kartrij toner anda tidak terlalu rendah.

$banner_message ["DRAF"]
Mesej sepanduk untuk dicetak merentasi setiap halaman semasa menukar fail dvi kepada
postscript. Ini bersamaan dengan -bm pilihan.

$banner_scale [220.0]
Nombor perpuluhan yang menentukan berapa besar mesej sepanduk akan dicetak.
Percubaan adalah perlu untuk mendapatkan skala yang sesuai untuk mesej anda, sebagai peraturan
ibu jari skala hendaklah kira-kira sama dengan 1100 dibahagikan dengan bilangan aksara
dalam mesej. Lalai adalah tepat untuk mesej 5 aksara. Ini adalah
bersamaan dengan -bs pilihan.

@BIBINPUTS
Ini ialah pembolehubah tatasusunan, kini kebanyakannya usang, yang menentukan direktori di mana
lateksmk harus mencari fail .bib. Secara lalai ia ditetapkan daripada BIBINPUTS
pembolehubah persekitaran sistem pengendalian. Jika pembolehubah persekitaran itu tidak
set, senarai elemen tunggal yang terdiri daripada direktori semasa ditetapkan. Formatnya
nama direktori bergantung pada sistem pengendalian anda, sudah tentu. Contoh untuk
menetapkan pembolehubah ini ialah:

@BIBINPUTS = ( ".", "C:\bibfiles" );
@BIBINPUTS = ( ".", "\\server\bibfiles" );
@BIBINPUTS = ( ".", "C:/bibfiles" );
@BIBINPUTS = ( ".", "//server/bibfiles" );
@BIBINPUTS = ( ".", "/usr/local/texmf/bibtex/bib" );

Ambil perhatian bahawa di bawah MS Windows, sama ada garis miring ke hadapan "/" atau garis miring ke belakang "\" boleh
digunakan untuk memisahkan komponen nama laluan, jadi dua yang pertama dan dua yang kedua
contoh adalah setara. Setiap tebasan ke belakang hendaklah digandakan untuk mengelakkan berlari
bertentangan dengan Perlperaturan untuk menulis rentetan.

penting catatan: Pembolehubah ini kini kebanyakannya usang dalam versi semasa
lateksmk, kerana ia mempunyai kaedah yang lebih baik untuk mencari fail menggunakan kpsewhich
perintah. Walau bagaimanapun, jika sistem anda adalah yang luar biasa tanpa arahan kpsewhich,
anda mungkin perlu menetapkan pembolehubah @BIBINPUTS.

$biber ["biber %O %S"]
Program pemprosesan biber.

$biber_silent_switch ["--onlylog"]
suis untuk program pemprosesan biber apabila mod senyap dihidupkan.

$bibtex ["bibtex %O %S"]
Program pemprosesan BibTeX.

$bibtex_silent_switch ["-terse"]
suis untuk program pemprosesan BibTeX apabila mod senyap dihidupkan.

$bibtex_use [1]
Dalam keadaan apa untuk menjalankan BibTeX atau biber. Bila lateksmk menemui daripada log
fail bahawa satu (atau lebih) bibliografi BibTeX/biber-generasi digunakan, ia boleh dijalankan
BibTeX atau biber apabila nampaknya perlu untuk menjana semula fail bbl daripada
fail pangkalan data bib sumber mereka.

Tetapi kadangkala, fail bib tidak tersedia (mis., untuk dokumen yang diperolehi
daripada arkib luaran), tetapi fail bbl disediakan. Dalam kes itu penggunaan
BibTeX atau biber akan mengakibatkan salah tulis ganti fail bbl berharga.
Pemboleh ubah $bibtex_use mengawal sama ada ini berlaku. Nilai yang mungkin adalah:
0: jangan sekali-kali menggunakan BibTeX atau biber. 1: hanya gunakan BibTeX atau biber jika fail bib wujud.
2: jalankan BibTeX atau biber apabila nampaknya perlu untuk mengemas kini fail bbl,
tanpa menguji kewujudan fail bib.

$cleanup_includes_cusdep_generated [0]
Jika bukan sifar, tentukan bahawa pembersihan juga memadamkan fail yang dijana oleh tersuai
kebergantungan. (Apabila melakukan pembersihan, mis., dengan menggunakan -C pilihan, adat
dependencies adalah yang disenaraikan dalam .fdb_latexmk fail dari larian sebelumnya.)

$cleanup_includes_generated [0]
Jika bukan sifar, tentukan bahawa pembersihan juga memadamkan fail yang dikesan dalam fail log
seperti yang dijana (lihat baris \openout dalam fail log). Ia juga akan termasuk
fail yang dibuat daripada fail generasi pertama ini.

$cleanup_mode [0]
Jika bukan sifar, tentukan mod pembersihan: 1 untuk pembersihan penuh, 2 untuk pembersihan kecuali untuk
fail dvi, ps dan pdf, 3 untuk pembersihan kecuali fail dep dan aux. (Terdapat juga
pembersihan tambahan seperti yang ditentukan oleh $clean_ext, $clean_full_ext and @generated_exts
pembolehubah.)

Pembolehubah ini bersamaan dengan menentukan salah satu daripada -c or -C pilihan. Tetapi di sana
sepatutnya tidak perlu menetapkan pembolehubah ini daripada fail RC.

$clean_ext [""]
Sambungan tambahan fail untuk lateksmk untuk mengalih keluar apabila mana-mana pilihan pembersihan
(-c or -C) dipilih. Nilai pembolehubah ini ialah rentetan yang mengandungi
sambungan dipisahkan oleh ruang.

Ia juga mungkin untuk menentukan corak fail yang lebih umum untuk dipadamkan, oleh
menggunakan pemegang tempat %R, seperti dalam arahan, dan ia juga boleh digunakan
kad bebas. Oleh itu penetapan

$clean_ext = "keluar %R-blx.bib %R-angka*.log";

dalam fail permulaan akan membayangkan bahawa apabila operasi pembersihan ditentukan,
bukan sahaja set fail standard dipadamkan, tetapi juga fail dalam bentuk FOO.out,
FOO-blx.bib, dan %R-figures*.log, dengan FOO bermaksud nama asas fail
sedang diproses (seperti dalam FOO.tex).

$clean_full_ext [""]
Sambungan tambahan fail untuk lateksmk untuk mengeluarkan apabila -C pilihan dipilih,
iaitu sambungan fail untuk dialih keluar apabila fail .dvi, dsb hendak dibersihkan.

Corak yang lebih umum dibenarkan, seperti untuk $clean_ext.

$compiling_cmd [tidak ditentukan], $failure_cmd [tidak ditentukan], $success_cmd [tidak ditentukan]

Pembolehubah ini menentukan arahan yang dilaksanakan pada titik tertentu
kompilasi semasa mod pratonton-berterusan. Satu motivasi untuk kewujudan mereka ialah
untuk membenarkan petunjuk visual yang mudah bagi status kompilasi walaupun semasa tetingkap
menerima output skrin kompilasi disembunyikan.

Arahan dilaksanakan pada titik berikut: $compiling_cmd pada permulaan
kompilasi, $success_cmd pada penghujung kompilasi yang berjaya, dan $failure_cmd
pada penghujung kompilasi yang tidak berjaya. Jika mana-mana pembolehubah di atas tidak ditentukan
(situasi lalai) atau kosong, maka arahan yang sepadan tidak dilaksanakan.

Contoh tetapan tipikal pembolehubah ini adalah seperti berikut

$compiling_cmd = "xdotool search --name \"%D\" set_window --name \"%D
menyusun\"";
$success_cmd = "xdotool search --name \"%D\" set_window --name \"%D OK\"";
$failure_cmd = "xdotool search --name \"%D\" set_window --name \"%D
GAGAL\"";

Mereka ini menganggap bahawa program xdotool dipasang, bahawa pratonton menggunakan a
Sistem X-Window untuk paparan, dan tajuk tetingkap itu mengandungi nama
fail yang dipaparkan, seperti biasa. Apabila arahan dilaksanakan, the
rentetan pemegang tempat %D digantikan dengan nama fail destinasi, iaitu
fail yang dipratonton. Perintah di atas menyebabkan rentetan yang sesuai dilampirkan
kepada nama fail dalam tajuk tetingkap: " compiling", " OK", atau " FAILURE".

Pemegang tempat lain yang boleh digunakan ialah %S, %T dan %R, dengan %S dan %T biasanya
menjadi identik. Ini boleh berguna untuk arahan menukar tajuk suntingan
tingkap. Petunjuk visual dalam tajuk tetingkap boleh berguna, kerana pengguna tidak
perlu terus mengalihkan perhatian kepada tetingkap kompilasi (mungkin tersembunyi) untuk mengetahui
status kompilasi.

@cus_dep_list [()]
Senarai pergantungan tersuai -- lihat bahagian pada "Ketergantungan Tersuai".

@default_files [("*.tex")]
Senarai lalai fail untuk diproses.

Biasanya, jika tiada nama fail dinyatakan pada baris arahan, lateksmk memproses semua
fail tex yang dinyatakan dalam @default_files pembolehubah, yang secara lalai ditetapkan kepada semua
tex fail ("*.tex") dalam direktori semasa. Ini adalah kemudahan: jalankan sahaja
lateksmk dan ia akan memproses set fail yang sesuai. Tetapi kadang-kadang anda mahu
hanya sebahagian daripada fail ini untuk diproses. Dalam kes ini anda menetapkan @default_files
dalam fail permulaan (cth, fail "latexmkrc" dalam direktori semasa).
Kemudian jika tiada fail dinyatakan pada baris arahan maka fail yang anda tentukan oleh
menetapkan @default_files diproses.

Tiga contoh:

@default_files = ("paper_current");

@default_files = ("paper1", "paper2.tex");

@default_files = ("*.tex", "*.dtx");

Ambil perhatian bahawa lebih daripada fail mungkin diberikan dan sambungan lalai ialah ".tex".
Kad liar dibenarkan. Tanda kurung adalah kerana @default_files ialah tatasusunan
pembolehubah, iaitu, jujukan spesifikasi nama fail adalah mungkin.

$dependents_phony [0]
Jika senarai kebergantungan adalah output, pembolehubah ini menentukan sama ada untuk memasukkan a
sasaran palsu untuk setiap fail sumber. Jika anda menggunakan senarai tanggungan dalam Makefile,
peraturan dummy mengatasi ralat yang dibuat memberi jika anda mengalih keluar fail pengepala tanpa
mengemas kini Makefile untuk dipadankan.

$dependents_list [0]
Sama ada mahu memaparkan senarai kebergantungan pada penghujung larian.

$deps_file ["-"]
Nama fail untuk menerima senarai tanggungan pada penghujung larian, untuk digunakan jika
$dependesnt_list ditetapkan. Jika nama fail ialah "-", maka senarai kebergantungan ditetapkan
untuk stdout (iaitu, biasanya skrin).

$do_cd [0]
Sama ada hendak menukar direktori kerja kepada direktori yang ditentukan untuk sumber utama
fail sebelum memprosesnya. Tingkah laku lalai adalah untuk tidak melakukan ini, iaitu
sama seperti tingkah laku getah and pdflatex program. Pembolehubah ini ditetapkan oleh
-cd and -cd- pilihan pada lateksmkbaris arahan.

$dvi_filter [kosong]
Penapis fail dvi untuk dijalankan pada fail dvi yang baru dihasilkan sebelum yang lain
pemprosesan. Bersamaan dengan menyatakan -dF pilihan.

$dvi_mode [Lihat di bawah khususnya lalai]
Jika bukan sifar, hasilkan versi dvi dokumen. Setaraf dengan -dvi pilihan.

Pembolehubah $dvi_mode lalai kepada 0, tetapi jika tiada permintaan eksplisit dibuat untuk
jenis fail lain (postskrip, pdf), maka $dvi_mode akan ditetapkan kepada 1. Dalam
Selain itu, jika permintaan untuk fail yang mana fail .dvi adalah prasyarat, maka
$dvi_mode akan ditetapkan kepada 1.

$dvi_previewer ["mula xdvi %O %S" di bawah UNIX]
Perintah untuk memanggil dvi-previewer. [Lalai ialah "mula" di bawah MS-WINDOWS; bawah
versi Windows yang lebih terkini, ini akan menyebabkan apa-apa arahan dijalankan
sistem telah dikaitkan dengan fail .dvi.]

penting ambil perhatian: Biasanya anda akan mahu menjalankan pratonton dipisahkan, supaya
lateksmk tidak menunggu pratonton ditamatkan sebelum meneruskan kerjanya. Jadi
biasanya anda harus awalan arahan dengan "mula", yang menandakan lateksmk bahawa ia
harus melakukan pengasingan pratonton itu sendiri (dengan apa-apa kaedah yang sesuai
kepada sistem pengendalian). Tetapi kadang-kadang membiarkan lateksmk melakukan detaching tidak
sesuai (untuk pelbagai sebab yang tidak remeh), jadi anda harus meletakkan "mula"
sedikit dalam diri anda, bila-bila masa ia diperlukan.

$dvi_previewer_landscape ["mula xdvi %O %S"]
Perintah untuk memanggil dvi-previewer dalam mod landskap. [Lalai ialah "mula" di bawah
MS-WINDOWS; di bawah versi Windows yang lebih terkini, ini akan menyebabkan untuk dijalankan
apa sahaja arahan yang dikaitkan sistem dengan fail .dvi.]

$dvipdf ["dvipdf %O %S %D"]
Perintah untuk menukar dvi kepada fail pdf. Konfigurasi semula biasa ialah menggunakan dvipdfm
perintah, yang memerlukan hujahnya dalam susunan yang berbeza:

$dvipdf = "dvipdfm %O -o %D %S";

AMARAN: Skrip dvipdf lalai menjana fail pdf dengan fon bitmap, yang
tidak kelihatan baik apabila dilihat oleh acroread. Skrip itu harus diubah suai untuk memberi
dvips pilihan "-P pdf" untuk memastikan fon jenis 1 digunakan dalam fail pdf.

$dvipdf_silent_switch ["-q"]
Tukar(es) untuk program dvipdf apabila mod senyap dihidupkan.

NB Program dvipdf standard berjalan secara senyap, jadi menambah suis senyap mempunyai no
kesan, tetapi sebenarnya tidak berbahaya. Tetapi jika program alternatif digunakan, contohnya,
dvipdfmx, maka suis senyap mempunyai kesan. Tetapan lalai adalah betul untuk
dvipdfm dan dvipdfmx.

$dvips ["dvips %O -o %D %S"]
Program untuk digunakan sebagai penapis untuk menukar fail .dvi kepada fail .ps. Jika pdf adalah
akan dijana daripada pdf, kemudian nilai $dvips_pdf_switch -- lihat
di bawah -- akan disertakan dalam pilihan yang digantikan dengan "%O".

$dvips_landscape ["dvips -tlandskap %O -o %D %S"]
Program untuk digunakan sebagai penapis untuk menukar fail .dvi kepada fail .ps dalam landskap
mod.

$dvips_pdf_switch ["-P pdf"]
Tukar (es) untuk program dvips apabila fail pdf akan dijana daripada fail ps.

$dvips_silent_switch ["-q"]
Suis untuk program dvips apabila mod senyap dihidupkan.

$dvi_update_command [""]
Apabila pratonton dvi ditetapkan untuk dikemas kini dengan menjalankan arahan, ini ialah
perintah yang dijalankan. Lihat maklumat untuk pembolehubah $dvi_update_method khususnya
maklumat lanjut, dan lihat maklumat tentang pembolehubah $pdf_update_method untuk sebuah
contoh untuk kes analog pratonton pdf.

$dvi_update_method [2 di bawah UNIX, 1 di bawah MS-Windows]
Cara pemapar dvi mengemas kini paparannya apabila fail dvi telah berubah. Nilai-nilai
di sini memohon sama rata kepada $pdf_update_method dan kepada $ps_update_method
pembolehubah.
0 => kemas kini adalah automatik,
1=> kemas kini manual oleh pengguna, yang mungkin hanya bermakna klik tetikus pada penonton
tingkap atau mungkin bermaksud tindakan yang lebih serius.
2 => Hantar isyarat, yang nombornya dalam pembolehubah $dvi_update_signal. Yang
nilai lalai di bawah UNIX sesuai untuk xdvi.
3 => Viewer tidak boleh melakukan kemas kini, kerana ia mengunci fail. (Seperti acroread
di bawah MS-Windows.)
4 => jalankan arahan untuk melakukan kemas kini. Perintah ditentukan oleh pembolehubah
$dvi_update_command.

Lihat maklumat tentang pembolehubah $pdf_update_method untuk contoh pengemaskinian oleh
perintah.

$dvi_update_signal [Di bawah UNIX: SIGUSR1, yang is a bergantung kepada sistem nilai]
Nombor isyarat yang dihantar kepada pemapar dvi apabila ia dikemas kini oleh
menghantar isyarat -- lihat maklumat pada pembolehubah $dvi_update_method. Yang
nilai lalai ialah nilai yang sesuai untuk xdvi pada sistem UNIX.

$failure_cmd [tidak ditentukan]
Lihat dokumentasi untuk $compiling_cmd.

$fdb_ext ["fdb_latexmk"]
Sambungan fail yang lateksmk menjana untuk mengandungi pangkalan data
maklumat mengenai fail sumber. Anda biasanya tidak perlu menukar ini.

$force_mode [0]
Jika bukan sifar, teruskan pemprosesan lepas minor getah kesilapan termasuk tidak dikenali
rujukan silang. Bersamaan dengan menyatakan -f pilihan.

@generated_exts [( kepada , bbl , idx , ind , luff , banyak , keluar , palsu , $fdb_ext )]
Ini mengandungi senarai sambungan untuk fail yang dijana semasa LaTeX dijalankan
dan yang dibaca oleh LaTeX dalam larian kemudian, sama ada secara langsung atau tidak langsung.

Senarai ini mempunyai dua kegunaan: (a) untuk menetapkan jenis fail yang akan dipadamkan dalam pembersihan
operasi (dengan -c, -C, -CA, -g and -gg pilihan), dan (b) dalam penentuan
sama ada tayangan semula (pdf)LaTeX diperlukan selepas larian yang memberikan ralat.

(Biasanya, pertukaran fail sumber semasa larian harus mencetuskan tayangan semula. Ini
termasuk fail yang dijana oleh LaTeX, cth, fail aux, yang dibaca dalam
larian seterusnya. Tetapi selepas larian yang mengakibatkan ralat, larian baharu sepatutnya berlaku
sehingga pengguna telah membuat perubahan dalam fail. Tetapi pengguna mungkin telah membetulkan a
ralat dalam fail .tex sumber semasa dijalankan. Jadi lateksmk perlu membezakan pengguna-
fail yang dijana dan dijana secara automatik; ia menentukan secara automatik
menjana fail seperti yang mempunyai sambungan dalam senarai dalam @generated_exts.)

Cara mudah untuk menambah sambungan tambahan pada senarai, tanpa kehilangan yang sudah
yang ditakrifkan ialah menggunakan arahan tolak dalam baris dalam fail RC. Cth,

tolak @generated_exts, "end";

menambah sambungan "tamat" pada senarai sambungan yang dijana dipratentukan. (Ini
sambungan digunakan oleh pakej RevTeX, sebagai contoh.)

$go_mode [0]
Jika bukan sifar, proses fail tanpa mengira cap masa, dan kemudiannya bersamaan dengan
-g pilihan.

%hash_calc_ignore_pattern
!!!Ini berubah-ubah is khususnya pakar-pakar sahaja!!!

Peraturan am lateksmk digunakan untuk menentukan bila larian tambahan bagi beberapa program
yang diperlukan ialah salah satu fail sumber telah berubah. Tetapi pertimbangkan sebagai contoh a
pakej lateks yang menyebabkan fail posskrip terkapsul (fail "eps") menjadi
dibuat itu untuk dibaca pada larian seterusnya. Fail mengandungi baris ulasan
memberikan tarikh dan masa penciptaannya. Pada larian seterusnya masa berubah, getah Jangka
bahawa fail eps telah berubah, dan oleh itu menjalankan semula lateks. Ini menyebabkan tidak terhingga
gelung, itu hanya ditamatkan kerana lateksmk mempunyai had bilangan larian ke
berjaga-jaga terhadap situasi patologi.

Tetapi garis yang berubah tidak mempunyai kesan sebenar, kerana ia adalah ulasan. Anda boleh memberi arahan
getah untuk mengabaikan baris yang menyinggung seperti berikut:

$hash_calc_ignore_pattern{'eps'} = '^%%CreationDate: ';

Ini mencipta peraturan untuk fail dengan sambungan .eps tentang baris untuk diabaikan. kiri-
sebelah tangan ialah a Perl simpulan bahasa untuk menetapkan item dalam cincang. Perhatikan bahawa fail
lanjutan ditentukan tanpa tempoh. Nilai, di sebelah kanan, ialah a
rentetan yang mengandungi ungkapan biasa. (Lihat dokumentasi pada Perl untuk bagaimana mereka
adalah untuk dinyatakan secara umum.) Ungkapan biasa khusus ini menyatakan bahawa
baris yang bermula dengan "%%CreationDate: " hendaklah diabaikan dalam menentukan sama ada a
fail sambungan yang diberikan .eps telah berubah.

Terdapat hanya satu ungkapan biasa yang tersedia untuk setiap sambungan. Jika kamu perlu
lebih satu corak untuk menentukan garisan untuk diabaikan, maka anda perlu menggabungkan corak
menjadi satu ungkapan biasa. Kaedah yang paling mudah adalah memisahkan yang berbeza
corak ringkas oleh aksara bar menegak (menunjukkan "bergantian" dalam jargon
ungkapan biasa). Sebagai contoh,

$hash_calc_ignore_pattern{'eps'} = '^%%Tarikh Cipta: |^%%Tajuk: ';

menyebabkan baris yang bermula dengan sama ada "^%%CreationDate: " atau "^%%Title: " menjadi
diabaikan.

Ia mungkin berlaku bahawa corak yang akan diabaikan dinyatakan dalam, sebagai contoh, dalam a
sistem atau fail permulaan pengguna, dan anda ingin mengalih keluar ini dalam fail yang dibaca
nanti. Untuk melakukan ini, anda menggunakan fungsi padam Perl, cth,

padamkan $hash_calc_ignore_pattern{'eps'};

$kpsewhich ["kpsewhich %S"]
Program dipanggil untuk mencari fail sumber apabila nama sahaja tidak mencukupi.
Kebanyakan nama fail yang digunakan oleh lateksmk mempunyai maklumat laluan yang mencukupi untuk ditemui
secara langsung. Tetapi kadangkala, terutamanya apabila fail .bib ditemui daripada fail log a
bibtex atau biber run, nama fail, tetapi laluannya tidak diketahui. Program yang
ditentukan oleh $kpseyang digunakan untuk mencarinya.

Lihat juga @BIBINPUTS pembolehubah untuk cara lain itu lateksmk juga digunakan untuk mencuba
cari fail; ia terpakai hanya dalam kes fail .bib.

$landskap_mod [0]
Jika bukan sifar, jalankan dalam mod landskap, menggunakan pratonton mod landskap dan dvi to
penukar postskrip. Setaraf dengan -l pilihan. Biasanya tidak diperlukan dengan
pratonton semasa.

$lateks ["lateks %O %S"]
Program pemprosesan LaTeX. Ambil perhatian bahawa seperti program lain, anda boleh menggunakan ini
pembolehubah bukan sahaja untuk menukar nama program yang digunakan, tetapi juga menentukan pilihan
kepada program tersebut. Cth,

$lateks = "lateks --src-specials";

%lateks_input_extensions
Pembolehubah ini menentukan sambungan yang dicuba oleh latexmk apabila ia mendapati bahawa LaTeX
run mengakibatkan ralat bahawa fail tidak ditemui, dan fail diberikan
tanpa sambungan. Ini biasanya berlaku apabila LaTeX mengarahkan borang
\input{file} atau \includegraphics{figure}, apabila fail sumber yang berkaitan tidak
wujud.

Dalam keadaan ini, latexmk mencari kebergantungan tersuai untuk membuat yang hilang
fail(s), tetapi mengehadkannya kepada sambungan yang ditentukan oleh pembolehubah
%lateks_input_extensions. Sambungan lalai ialah 'tex' dan 'eps'.

(Untuk pakar Perl: %latex_input_extensions ialah cincangan yang kuncinya ialah sambungan.
Nilai adalah tidak relevan.) Dua subrutin disediakan untuk memanipulasi ini dan
pembolehubah yang berkaitan %pdflatex_input_extensions, add_input_ext dan
remove_input_ext. Mereka digunakan seperti dalam contoh berikut adalah baris yang mungkin masuk
fail permulaan:

remove_input_ext( 'lateks', 'tex' );

mengalih keluar sambungan 'tex' daripada lateks_input_extensions

add_input_ext( 'lateks', 'asdf' );

tambah sambungan 'asdf ke latex_input_extensions. (Sememangnya dengan seperti itu
sambungan, anda sepatutnya membuat pergantungan tersuai yang sesuai untuk lateksmk, dan
sepatutnya juga telah melakukan pengaturcaraan yang sesuai dalam fail sumber LaTeX untuk
membolehkan fail dibaca. Sambungan standard dikendalikan oleh LaTeX dan sambungannya
pakej grafik/graphicx.

$latex_silent_switch ["-interaction=batchmode"]
Suis(es) untuk program pemprosesan LaTeX apabila mod senyap dihidupkan.

Jika anda menggunakan MikTeX, anda mungkin lebih suka keputusan jika anda mengkonfigurasi pilihan untuk
sertakan -c-style-errors, cth, dengan baris berikut dalam fail permulaan

$latex_silent_switch = "-interaction=batchmode -c-style-errors";

$lpr ["lpr %O %S" di bawah UNIX/LINUX, "TIADA lpr" di bawah MS-WINDOWS]
Perintah untuk mencetak fail posskrip.

Di bawah MS-Windows (tidak seperti UNIX/LINUX), tiada program standard untuk mencetak
fail. Tetapi ada cara anda boleh melakukannya. Sebagai contoh, jika anda mempunyai gsview
dipasang, anda boleh menggunakannya dengan pilihan "/p":

$lpr = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p';

Jika gsview dipasang dalam direktori lain, anda perlu membuat
perubahan yang sesuai. Perhatikan gabungan petikan tunggal dan berganda di sekeliling
nama. Petikan tunggal menyatakan bahawa ini adalah rentetan yang akan diberikan kepada
pembolehubah konfigurasi $lpr. Petikan berganda adalah sebahagian daripada rentetan yang dihantar ke
sistem pengendalian untuk mendapatkan arahan yang dipatuhi; ini perlu kerana satu bahagian
daripada nama arahan ("Fail Program") mengandungi ruang yang sebaliknya
disalah tafsir.

$lpr_dvi ["TIADA lpr_dvi"]
Program percetakan untuk mencetak fail dvi.

$lpr_pdf ["TIADA lpr_pdf"]
Program percetakan untuk mencetak fail pdf.

Di bawah MS-Windows anda boleh menetapkan ini untuk menggunakan gsview, jika ia dipasang, cth,

$lpr = '"c:/Program Files/Ghostgum/gsview/gsview32.exe" /p';

Jika gsview dipasang dalam direktori lain, anda perlu membuat
perubahan yang sesuai. Perhatikan petikan berganda di sekeliling nama: ini perlu
kerana satu bahagian nama arahan ("Fail Program") mengandungi ruang yang akan
sebaliknya disalah tafsir.

$buat ["buat"]
Program pemprosesan buat.

$makeindex ["makeindex %O -o %D %S"]
Program pemprosesan indeks.

$makeindex_silent_switch ["-q"]
suis untuk program pemprosesan indeks apabila mod senyap dihidupkan.

$max_repeat [5]
Bilangan maksimum kali lateksmk akan menjalankan lateks/pdflatex sebelum memutuskannya
mungkin terdapat gelung tak terhingga dan ia perlu diselamatkan, bukannya dijalankan semula
lateks/pdflatex sekali lagi untuk menyelesaikan rujukan silang, dsb. Nilai lalai meliputi
semua kes biasa.

(Perhatikan bahawa "dll" merangkumi banyak kes di mana satu larian lateks/pdflatex
menjana fail untuk dibaca pada masa yang akan datang.)

$MSWin_back_slash [1]
Pembolehubah konfigurasi ini hanya mempunyai kesan apabila lateksmk sedang berjalan di bawah MS-
Windows. Ia menentukan sama ada, apabila arahan dilaksanakan di bawah MS-Windows, di sana
hendaklah digantikan dengan "\" untuk aksara pemisah antara komponen a
nama direktori. Secara dalaman, lateksmk menggunakan "/" untuk pemisah direktori
watak, iaitu watak yang digunakan oleh sistem seperti Unix.

Untuk kebanyakan program di bawah MS-Windows, kedua-dua "\" dan "/" boleh diterima sebagai
watak pemisah direktori. Tetapi sesetengah program hanya menerima "\". Jadi untuk keselamatan
lateksmk membuat terjemahan, secara lalai. Ia boleh difikirkan bahawa di bawah tertentu
situasi ini tidak diingini, jadi konfigurasi boleh diubah. (A mungkin
contohnya mungkin apabila sesetengah perisian dilaksanakan menggunakan Cygwin, yang
menyediakan persekitaran seperti Unix di dalam MS-Windows.)

$new_viewer_always [0]
Pembolehubah ini digunakan untuk lateksmk hanyalah dalam mod pratonton berterusan. Jika
$new_viewer_always adalah 0, lateksmk akan menyemak pratonton yang dijalankan sebelum ini
fail yang sama, dan jika satu sedang berjalan tidak akan memulakan yang baru. Jika
$new_viewer_always bukan sifar, semakan ini akan dilangkau, dan lateksmk akan berkelakuan
seolah-olah tiada penonton yang sedang berjalan.

$out_dir [""]
Direktori di mana fail output akan ditulis dengan larian lateks (pdf). Lihat
juga pembolehubah $aux_dir.

Kesan pembolehubah ini (apabila tidak kosong) dicapai dengan menggunakan -pengeluaran-
direktori pilihan (pdf) lateks. Ini wujud dalam arus biasa (Dis. 2011 dan
kemudian) pelaksanaan TeX, iaitu, MiKTeX dan TeXLive. Tetapi ia mungkin tidak hadir
dalam versi lain.

Lazimnya, direktori yang ditentukan untuk fail output ialah subdirektori semasa
direktori kerja. Walau bagaimanapun, jika anda menentukan beberapa direktori lain, cth., "/tmp/foo"
atau "../output", maklum bahawa ini boleh menyebabkan masalah, mis., dengan makeindex or
bibtex. Ini kerana versi moden program ini, secara lalai, akan menolak
untuk bekerja apabila mereka mendapati bahawa mereka diminta untuk menulis ke fail dalam direktori yang
nampaknya bukan direktori kerja semasa atau salah satu subdirektorinya. ini
adalah sebahagian daripada langkah keselamatan oleh keseluruhan sistem TeX yang cuba menghalang hasad
atau dokumen TeX yang sesat daripada mengacaukan fail pengguna secara salah. Jika untuk
$out_dir or $aux_dir anda benar-benar perlu menentukan nama laluan mutlak (cth,
"/tmp/foo") atau laluan (cth, "../output") yang merangkumi direktori peringkat lebih tinggi,
maka anda perlu melumpuhkan langkah keselamatan (dan menanggung sebarang risiko). Ini boleh jadi
dilakukan dengan menetapkan sementara pembolehubah persekitaran sistem pengendalian openout_any
kepada "a" (seperti dalam "semua"), untuk mengatasi tetapan "paranoid" lalai.

$pdf_mode [0]
Jika sifar, JANGAN jana versi pdf dokumen. Jika sama dengan 1, hasilkan a
versi pdf dokumen menggunakan pdflatex. Jika sama dengan 2, hasilkan versi pdf
dokumen daripada fail ps, dengan menggunakan arahan yang ditentukan oleh $ps2pdf
pembolehubah. Jika sama dengan 3, hasilkan versi pdf dokumen daripada fail dvi,
dengan menggunakan arahan yang ditentukan oleh $dvipdf berubah-ubah.

Setaraf dengan -pdf-, -pdf, -pdfdvi, -pdfps pilihan.

$pdflatex ["pdflatex %O %S"]
Program pemprosesan LaTeX dalam versi yang membuat fail pdf dan bukannya dvi
fail.

Contoh penggunaan pembolehubah ini adalah untuk mengatur lualatex, xelatex atau beberapa
program yang serupa untuk digunakan bukannya pdflatex. Perhatikan bahawa lualatex and xelatex
hanya menghasilkan fail .pdf (dan bukan .dvi), jadi untuk menggunakannya anda juga perlu menghidupkan
pada pengeluaran fail .pdf dan untuk mematikan pengeluaran .dvi (dan .ps)
fail, sama ada dengan pilihan baris arahan atau dengan tetapan yang sesuai dalam konfigurasi
fail. Oleh itu untuk digunakan lualatex, tetapan berikut adalah sesuai:

$pdflatex = "lualatex %O %S";
$pdf_mode = 1; $postscript_mode = $dvi_mode = 0;

Untuk menggunakan xelatex, tetapan yang sepadan ialah:

$pdflatex = "xelatex %O %S";
$pdf_mode = 1; $postscript_mode = $dvi_mode = 0;

Satu lagi penggunaan pembolehubah yang sama adalah untuk menambah pilihan tertentu pada baris arahan untuk
program, cth.,

$pdflatex = "pdflatex --shell-escape %O %S";

%pdflatex_input_extensions
Pembolehubah ini menentukan sambungan yang dicuba oleh lateksmk apabila ia mendapati bahawa a
pdflatex run mengakibatkan ralat bahawa fail tidak ditemui, dan fail itu
diberikan tanpa lanjutan. Ini biasanya berlaku apabila LaTeX mengarahkan borang
\input{file} atau \includegraphics{figure}, apabila fail sumber yang berkaitan tidak
wujud.

Dalam keadaan ini, latexmk mencari kebergantungan tersuai untuk membuat yang hilang
fail(s), tetapi mengehadkannya kepada sambungan yang ditentukan oleh pembolehubah
%pdflatex_input_extensions. Sambungan lalai ialah 'tex', 'pdf', 'jpg dan
'png'.

(Untuk pakar Perl: %pdflatex_input_extensions ialah cincang yang kuncinya ialah
sambungan. Nilai tidak relevan.) Dua subrutin disediakan
memanipulasi ini dan pembolehubah yang berkaitan %latex_input_extensions, add_input_ext
dan keluarkan_input_ext. Mereka digunakan seperti dalam contoh berikut adalah mungkin
baris dalam fail permulaan:

remove_input_ext( 'pdflatex', 'tex' );

mengalih keluar sambungan 'tex' daripada pdflatex_input_extensions

add_input_ext( 'pdflatex', 'asdf' );

tambah sambungan 'asdf ke pdflatex_input_extensions. (Sememangnya dengan seperti itu
sambungan, anda sepatutnya membuat pergantungan tersuai yang sesuai untuk lateksmk, dan
sepatutnya juga telah melakukan pengaturcaraan yang sesuai dalam fail sumber LaTeX untuk
membolehkan fail dibaca. Sambungan standard dikendalikan oleh pdflatex dan
pakej grafik/graphicxnya.)

$pdflatex_silent_switch ["-interaction=batchmode"]
Suis(es) untuk program pdflatex (dinyatakan dalam pembolehubah $pdflatex apabila
mod senyap dihidupkan.

Jika anda menggunakan MikTeX, anda mungkin lebih suka keputusan jika anda mengkonfigurasi pilihan untuk
sertakan -c-style-errors, cth, dengan baris berikut dalam fail permulaan

$latex_silent_switch = "-interaction=batchmode -c-style-errors";

$pdf_previewer ["mula acroread %O %S"]
Perintah untuk memanggil pdf-previewer.

Pada MS-WINDOWS, lalai ditukar kepada "cmd /c start """; di bawah yang lebih terkini
versi Windows, ini akan menyebabkan untuk menjalankan apa-apa arahan sistem mempunyai
dikaitkan dengan fail .pdf. Tetapi ini mungkin tidak diingini jika persatuan ini
acroread -- lihat nota dalam penjelasan -pvc pilihan.]

Pada OS-X lalai ditukar kepada "buka %S", yang mengakibatkan OS-X dimulakan (dan
melepas) pemapar yang dikaitkan dengan fail. Secara lalai, untuk fail pdf ini
perkaitan adalah untuk pratonton OS-X, yang agak memuaskan.

BERKHATAN :: Masalah di bawah MS-Windows: jika acroread digunakan sebagai pratonton pdf, dan
ia sebenarnya sedang melihat fail pdf, fail pdf tidak boleh dikemas kini. Justeru menjadikan
acroread pilihan pratonton yang tidak baik jika anda menggunakan lateksmkmod berterusan sebelumnya
(pilihan -pvc) di bawah MS-windows. Masalah ini tidak berlaku jika, sebagai contoh,
SumatraPDF atau gsview digunakan untuk melihat fail pdf.

penting ambil perhatian: Biasanya anda akan mahu menjalankan pratonton dipisahkan, supaya
lateksmk tidak menunggu pratonton ditamatkan sebelum meneruskan kerjanya. Jadi
biasanya anda harus awalan arahan dengan "mula", yang menandakan lateksmk bahawa ia
harus melakukan pengasingan pratonton itu sendiri (dengan apa-apa kaedah yang sesuai
kepada sistem pengendalian). Tetapi kadang-kadang membiarkan lateksmk melakukan detaching tidak
sesuai (untuk pelbagai sebab yang tidak remeh), jadi anda harus meletakkan "mula"
sedikit dalam diri anda, bila-bila masa ia diperlukan.

$pdf_update_command [""]
Apabila pratonton pdf ditetapkan untuk dikemas kini dengan menjalankan arahan, ini ialah
perintah yang dijalankan. Lihat maklumat untuk pembolehubah $pdf_update_method.

$pdf_update_method [1 di bawah UNIX, 3 di bawah MS-Windows]
Bagaimana pemapar pdf mengemas kini paparannya apabila fail pdf telah berubah. Lihat
maklumat tentang pembolehubah $dvi_update_method untuk kod. (Perhatikan bahawa
maklumat perlu diubah sedikit supaya untuk nilai 4, untuk menjalankan arahan ke
lakukan kemas kini, arahan ditentukan oleh pembolehubah $pdf_update_command, dan
untuk nilai 2, untuk menentukan kemas kini mengikut isyarat, isyarat ditentukan oleh
$pdf_update_signal.)

Ambil perhatian bahawa acroread di bawah MS-Windows (tetapi bukan UNIX) mengunci fail pdf, jadi fail pdf
nilai lalai ialah 3.

Mengatur untuk menggunakan arahan untuk mendapatkan pratonton dikemas kini secara eksplisit memerlukan tiga
pembolehubah yang akan ditetapkan. Sebagai contoh:

$pdf_previewer = "mulakan xpdf -remote %R %O %S";
$pdf_update_method = 4;
$pdf_update_command = "xpdf -remote %R -reload";

Tetapan pertama mengatur program xpdf untuk digunakan dalam "pelayan jauh
mod", dengan nama pelayan ditentukan sebagai nama akar fail TeX. Yang kedua
tetapan mengatur pengemaskinian dilakukan sebagai tindak balas kepada arahan, dan yang ketiga
tetapan menetapkan arahan kemas kini.

$pdf_update_signal [Di bawah UNIX: SIGHUP, yang is a bergantung kepada sistem nilai]
Nombor isyarat yang dihantar kepada pemapar pdf apabila ia dikemas kini oleh
menghantar isyarat -- lihat maklumat pada pembolehubah $pdf_update_method. Yang
nilai lalai ialah nilai yang sesuai untuk gv pada sistem UNIX.

$pid_position[1 di bawah UNIX, -1 di bawah MS-Windows]
Pemboleh ubah $pid_position digunakan untuk menentukan perkataan dalam baris output
dari $pscmd sepadan dengan ID proses. Perkataan pertama dalam baris bernombor
0. Nilai lalai 1 (perkataan ke-2 dalam baris) adalah betul untuk Solaris 2.6 dan Linux.
Menetapkan pembolehubah kepada -1 digunakan untuk menunjukkan bahawa $pscmd tidak boleh digunakan.

$postscript_mode [0]
Jika bukan sifar, hasilkan versi posskrip dokumen. Setaraf dengan -ps
pilihan.

Jika beberapa permintaan lain dibuat yang mana fail postskrip diperlukan, maka
$postscript_mode akan ditetapkan kepada 1.

$preview_continuous_mode [0]
Jika bukan sifar, jalankan pratonton untuk melihat dokumen dan teruskan berjalan lateksmk kepada
pastikan .dvi dikemas kini. Setaraf dengan -pvc pilihan. Pratonton mana yang dijalankan
bergantung pada tetapan lain, lihat pilihan baris arahan -pandangan=, Dan
berubah-ubah $pandangan.

$preview_mode [0]
Jika bukan sifar, jalankan pratonton untuk pratonton dokumen. Setaraf dengan -pv pilihan.
Pratonton yang dijalankan bergantung pada tetapan lain, lihat pilihan baris arahan
-pandangan=, dan pembolehubah $pandangan.

$printout_mode [0]
Jika bukan sifar, cetak dokumen menggunakan lpr. Setaraf dengan -p pilihan. Ini adalah
disyorkan tidak untuk ditetapkan daripada fail RC, jika tidak, anda boleh membazirkan banyak kertas.

$print_type = ["auto"]
Jenis fail untuk dicetak: kemungkinan adalah "auto", "dvi", "none", "pdf", atau "ps".
Lihat pilihan -cetak= untuk maksud nilai "auto".

$pscmd Perintah digunakan untuk mendapatkan semua proses yang sedang dijalankan oleh pengguna. Pilihan -pvc
menggunakan arahan yang ditentukan oleh pembolehubah $pscmd untuk menentukan sama ada terdapat
sudah menjalankan pratonton, dan untuk mencari ID proses (diperlukan jika lateksmk perlu
memberi isyarat kepada pratonton tentang perubahan fail).

Setiap baris output arahan ini diandaikan sepadan dengan satu proses.
Melihat $pid_position pembolehubah untuk cara nombor proses ditentukan.

Lalai untuk pscmd ialah "TIADA" di bawah MS-Windows dan cygwin (iaitu, arahannya ialah
tidak digunakan), "ps --width 200 -f -u $ENV{USER}" di bawah linux, "ps -ww -u $ENV{USER}"
di bawah darwin (Macintosh OS-X) dan "ps -f -u $ENV{USER}" di bawah operasi lain
sistem (termasuk perisa UNIX yang lain). Dalam spesifikasi ini "$ENV{USER}" ialah
digantikan dengan nama pengguna.

$ps2pdf ["ps2pdf %O %S %D"]
Perintah untuk menukar ps kepada fail pdf.

$ps_filter [kosong]
Penapis fail postscript yang akan dijalankan pada fail postscript yang baru dihasilkan sebelum ini
pemprosesan lain. Bersamaan dengan menyatakan -pF pilihan.

$ps_previewer ["mula gv %O %S", tetapi permulaan %O %S di bawah MS-WINDOWS]
Perintah untuk memanggil ps-previewer. (Lalai di bawah MS-WINDOWS akan menyebabkan kepada
dijalankan apa sahaja arahan yang dikaitkan sistem dengan fail .ps.)

Ambil perhatian bahawa gv boleh digunakan dengan pilihan -watch mengemas kini paparannya bila-bila masa
fail postscript berubah, manakala ghostview tidak. Namun, versi berbeza
gv mempunyai cara yang sedikit berbeza untuk menulis pilihan ini. Anda boleh mengkonfigurasi ini
berubah dengan sewajarnya.

BERKHATAN :: Sistem Linux mungkin telah memasang satu (atau lebih) versi gv di bawah
nama yang berbeza, cth., ggv, kghostview, dll, tetapi mungkin tidak ada yang dipanggil gv.

penting ambil perhatian: Biasanya anda akan mahu menjalankan pratonton dipisahkan, supaya
lateksmk tidak menunggu pratonton ditamatkan sebelum meneruskan kerjanya. Jadi
biasanya anda harus awalan arahan dengan "mula", yang menandakan lateksmk bahawa ia
harus melakukan pengasingan pratonton itu sendiri (dengan apa-apa kaedah yang sesuai
kepada sistem pengendalian). Tetapi kadang-kadang membiarkan lateksmk melakukan detaching tidak
sesuai (untuk pelbagai sebab yang tidak remeh), jadi anda harus meletakkan "mula"
sedikit dalam diri anda, bila-bila masa ia diperlukan.

$ps_previewer_landscape ["mula gv -tukar %O %S", tetapi permulaan %O %S di bawah MS-WINDOWS]
Perintah untuk memanggil ps-previewer dalam mod landskap.

$ps_update_command [""]
Apabila pratonton postskrip ditetapkan untuk dikemas kini dengan menjalankan arahan, ini adalah
arahan yang dijalankan. Lihat maklumat untuk pembolehubah $ps_update_method.

$ps_update_method [0 di bawah UNIX, 1 di bawah MS-Windows]
Bagaimana pemapar postskrip mengemas kini paparannya apabila fail ps telah berubah. Lihat
maklumat tentang pembolehubah $dvi_update_method untuk kod. (Perhatikan bahawa
maklumat perlu diubah sedikit supaya untuk nilai 4, untuk menjalankan arahan ke
lakukan kemas kini, arahan ditentukan oleh pembolehubah $ps_update_command, Dan untuk
nilai 2, untuk menentukan kemas kini mengikut isyarat, isyarat ditentukan oleh
$ps_update_signal.)

$ps_update_signal [Di bawah UNIX: SIGHUP, yang is a bergantung kepada sistem nilai]
Nombor isyarat yang dihantar kepada pemapar pdf apabila ia dikemas kini oleh
menghantar isyarat -- lihat $ps_update_method. Nilai lalai ialah satu
sesuai untuk gv pada sistem UNIX.

$pvc_view_file_via_temporary [1]
Sama seperti $always_view_file_via_temporary, kecuali ia hanya terpakai dalam
mod pratonton-berterusan (pilihan-pvc).

$quote_filenames [1]
Ini menentukan sama ada penggantian untuk ruang letak dalam spesifikasi arahan (sebagai
in $pdflatex) dikelilingi oleh petikan berganda. Jika pembolehubah ini ialah 1 (atau mana-mana yang lain
nilai Perl menganggap sebagai benar), maka petikan dilakukan. Jika tidak, petikan ditiadakan.

Kaedah petikan yang digunakan oleh lateksmk diuji untuk berfungsi dengan betul di bawah sistem UNIX
(termasuk Linux dan Mac OS-X) dan di bawah MS-Windows. Ia membenarkan penggunaan
nama fail yang mengandungi aksara khas, terutamanya ruang. (Tetapi perhatikan bahawa ramai
versi LaTeX dan PdfLaTeX tidak boleh berurusan dengan betul dengan fail TeX yang namanya
mengandungi ruang. Petikan Latexmk hanya memastikan bahawa nama fail tersebut adalah betul
dirawat oleh sistem pengendalian dalam menghantar hujah kepada program.)

$perakam [0]
Sama ada hendak menggunakan -perakam pilihan untuk getah and pdflatex. Penggunaan pilihan ini
menghasilkan fail sambungan .fls mengandungi senarai fail yang ini
program telah membaca dan menulis. Latexmk kemudian akan menggunakan fail ini untuk memperbaikinya
pengesanan fail sumber dan fail yang dijana selepas dijalankan getah or pdflatex.

Biasanya disyorkan untuk menggunakan pilihan ini (atau untuk mengkonfigurasi $perakam
pembolehubah untuk dihidupkan.) Tetapi ia hanya berfungsi jika (pdf) lateks menyokong pilihan -recorder,
yang benar untuk kebanyakan pelaksanaan semasa

Nota mengenai yang nama of yang .fls fail: Kebanyakan pelaksanaan (pdf) lateks menghasilkan sebuah
Fail .fls dengan nama asas yang sama seperti LaTeX dokumen utama, cth, untuk
Document.tex, fail .fls ialah Document.fls. Walau bagaimanapun, beberapa pelaksanaan sebaliknya
menghasilkan fail yang dinamakan untuk atur cara, iaitu, lateks.fls atau pdflatex.fls. Di dalam ini
kes kedua, lateksmk menyalin lateks.fls atau pdflatex.fls ke fail dengan
nama asas dokumen LaTeX utama, cth, Document.fls.

$search_path_separator [Lihat di bawah khususnya lalai]
Watak yang memisahkan laluan dalam persekitaran pembolehubah TEXINPUTS, BIBINPUTS,
dan BSTINPUTS. Pembolehubah ini digunakan terutamanya oleh lateksmk apabila -luar, -pengeluaran-
direktori, -auxdir, Dan / atau -aux-direktori pilihan digunakan. Kalau macam itu lateksmk
perlu menyampaikan laluan carian yang diubah suai dengan sewajarnya kepada $bibtex, dvipdf, dvips,
and (pdf) lateks.

[Ulasan kepada pembaca yang mahir dari segi teknikal: (pdf) lateks sebenarnya tidak memerlukan
laluan carian diubah suai, kerana ia membetulkannya secara dalaman. Tetapi, yang menghairankan, dvipdf
and dvips lakukan, kerana kadangkala fail grafik dijana dalam output atau aux
direktori.]

Lalai di bawah MSWin dan Cygwin ialah ';' dan di bawah sistem pengendalian seperti UNIX
(termasuk Linux dan OS-X) ialah ':'. Biasanya lalai memberikan tingkah laku yang betul.
Tetapi mungkin terdapat kesukaran jika sistem pengendalian anda adalah satu jenis, tetapi beberapa daripadanya
perisian anda berjalan di bawah emulator untuk jenis sistem pengendalian yang lain;
dalam kes itu anda perlu mengetahui perkara yang diperlukan, dan tetapkan $search_path_separator
secara eksplisit. (Begitu juga, tentu saja, untuk sistem pengendalian luar biasa yang tidak
dalam koleksi MSWin, Linux, OS-X, Unix.)

$silence_logfile_warnings [0]
Sama ada selepas menjalankan (pdf) lateks untuk meringkaskan amaran dalam fail log tentang
petikan dan rujukan yang tidak ditentukan. Menetapkan $silence_logfile_warnings=0 memberikan
ringkasan amaran (dengan syarat mod senyap tidak juga ditetapkan), dan ini berguna untuk
cari petikan dan rujukan yang tidak ditentukan tanpa mencari lebih banyak lagi
fail log verbose atau output skrin (pdf) lateks. Tapi ringkasannya boleh juga
terlampau menjengkelkan. Perkara lalai adalah untuk tidak memberikan amaran ini. Barisan arahan
pilihan -senyap_logfile_amaran_senarai and -senyap_logfile_senarai_amaran- juga ditetapkan
pembolehubah ini.

Ambil perhatian bahawa berbilang kejadian untuk objek tidak ditentukan yang sama pada halaman yang sama dan
baris yang sama akan dimampatkan kepada satu amaran.

$senyap [0]
Sama ada berlari senyap. Menetapkan $senyap kepada 1 mempunyai kesan yang sama seperti -senyap of
-senyap pilihan pada baris arahan.

$sleep_time [2]
Masa untuk tidur (dalam saat) antara menyemak fail sumber berubah apabila
berlari dengan -pvc pilihan. Ini tertakluk kepada kelewatan sekurang-kurangnya satu saat,
kecuali kelewatan sifar juga dibenarkan.

Nilai tepat 0 tidak memberikan kelewatan, dan biasanya menghasilkan 100% penggunaan CPU, yang
mungkin tidak diingini.

$texfile_search [""]
Ini adalah pembolehubah usang, digantikan dengan @default_files berubah-ubah.

Untuk keserasian ke belakang, jika anda memilih untuk menetapkan $texfile_search, ia adalah rentetan daripada
nama fail yang dipisahkan ruang, dan kemudian lateksmk menggantikan @default_files dengan
nama fail dalam $texfile_search yang ditambah "*.tex".

$success_cmd [tidak ditentukan]
Lihat dokumentasi untuk $compiling_cmd.

$tmpdir [Lihat di bawah khususnya lalai]
Direktori untuk menyimpan fail sementara yang lateksmk boleh menjana semasa berjalan.

Lalai di bawah MSWindows (termasuk cygwin), adalah untuk menetapkan $tmpdir kepada nilai
yang pertama mana-mana pembolehubah persekitaran sistem TMPDIR atau TEMP wujud,
sebaliknya ke direktori semasa. Di bawah sistem pengendalian lain (dijangka
UNIX/Linux, termasuk OS-X), lalai ialah nilai persekitaran sistem
pembolehubah TMPDIR jika ia wujud, jika tidak "/ tmp".

$use_make_for_missing_files [0]
Sama ada hendak digunakan membuat untuk mencuba dan membuat fail yang hilang selepas dijalankan getah or
pdflatex, dan pergantungan tersuai tidak ditemui. Ini secara amnya
berguna hanya apabila lateksmk digunakan sebagai sebahagian daripada projek yang lebih besar yang dibina oleh
menggunakan membuat program.

Ambil perhatian bahawa apabila fail yang hilang telah dibuat, tiada lagi panggilan ke membuat akan dibuat
pada larian seterusnya lateksmk untuk mengemas kini fail. Mengendalikan masalah ini adalah
tugas Makefile yang ditakrifkan sesuai. Lihat bahagian " MENGGUNAKAN lateksmk DENGAN membuat"untuk
bagaimana untuk melakukan ini. Niat memanggil membuat dari lateksmk hanyalah untuk mengesan
kebergantungan.

$pandangan ["lalai"]
Jenis fail yang akan dipratonton jika pratonton digunakan. Nilai yang mungkin
ialah "lalai", "dvi", "ps", "pdf". Nilai "lalai" bermaksud bahawa "tertinggi"
jenis fail yang dihasilkan adalah untuk digunakan (antara dvi, ps dan pdf).

CUSTOM KEBERGANTUNGAN

Dalam mana-mana fail RC satu set kebergantungan tersuai boleh disediakan untuk menukar fail dengan satu
sambungan kepada fail dengan yang lain. Contoh penggunaan ini adalah untuk membenarkan lateksmk kepada
menukar a .rajah memfailkan untuk .eps untuk dimasukkan ke dalam .tex fail.

Kaedah lama untuk mengkonfigurasi lateksmk adalah untuk memanipulasi secara langsung @cus_dep_list pelbagai
yang mengandungi maklumat yang menentukan kebergantungan tersuai. Kaedah ini masih berfungsi. Tetapi
kini terdapat subrutin yang membenarkan manipulasi mudah bagi pergantungan tersuai
senarai. Ini adalah

add_cus_dep( fromextension, toeextension, must, subroutine )
remove_cus_dep( fromextension, toeextension )
show_cus_dep()

Kebergantungan tersuai ialah senarai peraturan, setiap satunya ditentukan seperti berikut:

dari sambungan:
Sambungan fail yang kami tukar daripada (cth "rajah"). Ia dinyatakan
tanpa haid.

kepada sambungan:
Sambungan fail yang kami tukarkan (cth "eps"). Ia dinyatakan
tanpa haid.

Mesti: Jika bukan sifar, fail dari mana kami menukar kemestian wujud, jika ia tidak wujud
lateksmk akan memberikan mesej ralat dan keluar melainkan jika -f pilihan ditentukan. Jika
kemestian adalah sifar dan fail yang kami tukar daripadanya tidak wujud, maka tiada tindakan
diambil.

fungsi:
Nama subrutin itu lateksmk harus memanggil untuk melakukan penukaran fail.
Argumen pertama kepada subrutin ialah nama asas fail yang hendak ditukar
tanpa sebarang sambungan. Subrutin diisytiharkan dalam sintaks Perl. Yang
fungsi harus mengembalikan 0 jika ia berjaya dan nombor bukan sifar jika ia gagal.

Ia dipanggil bila-bila masa lateksmk mengesan bahawa latex/pdflatex perlu membaca fail,
seperti fail grafik, yang sambungannya ialah sambungan kepada pergantungan tersuai. Kemudian
lateksmk memeriksa sama ada fail wujud dengan nama yang sama, tetapi dengan yang sepadan
from-extension, seperti yang dinyatakan dalam peraturan pergantungan tersuai. Jika ia berlaku, maka bila-bila masa
fail destinasi (yang mempunyai sambungan kepada) sudah lapuk berkenaan dengan fail
fail sumber yang sepadan.

Untuk membuat fail destinasi baharu, fail Perl subrutin yang dinyatakan dalam peraturan digunakan,
dengan hujah yang merupakan nama asas bagi fail yang dipersoalkan. Kes mudah sahaja
melibatkan subrutin yang menggunakan program luaran; ini boleh dilakukan dengan mengikuti
templat di bawah, walaupun oleh mereka yang tidak mengetahui tentang Perl bahasa pengaturcaraan. Daripada
Sudah tentu, pakar boleh melakukan sesuatu yang lebih terperinci.

Satu item lain dalam setiap peraturan pergantungan tersuai yang dilabelkan "mesti" di atas menentukan cara peraturan tersebut
hendaklah digunakan apabila fail sumber gagal wujud.

Contoh kod yang mudah dan tipikal dalam rcfile permulaan ialah

add_cus_dep( 'rajah', 'eps', 0, 'rajah2eps' );
sub fig2eps {
system( "fig2dev -Leps \"$_[0].fig\" \"$_[0].eps\"" );
}

Baris pertama menambah kebergantungan tersuai yang menukar fail dengan sambungan "rajah", sebagai
dicipta oleh atur cara xfig, kepada fail posskrip terkapsul, dengan sambungan "eps".
Baris selebihnya mentakrifkan subrutin yang menjalankan penukaran. Jika peraturan untuk
menukar fail "rajah" kepada "eps" sudah wujud (cth, daripada fail baca masuk sebelum ini
fail permulaan), the lateksmk akan memadamkan peraturan ini sebelum membuat peraturan baharu.

Anggaplah lateksmk sedang menggunakan peraturan ini untuk menukar fail "figure.fig" kepada "figure.eps". Kemudian
ia akan menggunakan subrutin fig2eps yang ditakrifkan dalam kod di atas dengan satu hujah
"figure", yang merupakan nama asas bagi setiap fail (mungkin dengan komponen laluan).
Hujah ini dirujuk oleh Perl sebagai $_[0]. Dalam contoh di atas, subrutin menggunakan
yang Perl sistem arahan untuk menggunakan program fig2dev. Petikan berganda di sekeliling
rentetan ialah a Perl simpulan bahasa yang menandakan bahawa setiap rentetan bentuk nama pembolehubah,
$_[0] dalam kes ini, hendaklah digantikan dengan nilainya.

Jika nilai pulangan subrutin adalah bukan sifar, maka lateksmk akan menganggap ralat
berlaku semasa pelaksanaan subrutin. Dalam contoh di atas, tiada pulangan yang jelas
nilai diberikan, dan sebaliknya nilai pulangan ialah nilai yang dikembalikan oleh yang terakhir (dan sahaja)
pernyataan, iaitu, permohonan sistem, yang mengembalikan nilai 0 pada kejayaan.

Jika anda menggunakan pdflatex dan bukannya lateks, maka anda mungkin akan memilih untuk menukar anda
fail grafik kepada format pdf, dalam kes ini anda akan menggantikan kod di atas dalam
fail permulaan oleh

add_cus_dep( 'rajah', 'pdf, 0, 'rajah2pdf' );
sub fig2pdf {
system( "fig2dev -Lpdf \"$_[0].rajah\" \"$_[0].pdf\"" );
}

Nota 1: Dalam baris arahan yang diberikan dalam arahan sistem dalam contoh di atas, gandakan
petikan telah dimasukkan di sekitar nama fail (dilaksanakan oleh '\"' dalam fail Perl
bahasa). Mereka mengimunkan perjalanan program terhadap watak istimewa dalam
nama fail. Selalunya petikan ini tidak perlu, iaitu, ia boleh ditinggalkan. Tetapi ia
biasanya lebih selamat untuk menyimpannya. Walaupun peraturan untuk memetik berbeza antara
sistem pengendalian, cengkerang arahan dan kepingan perisian individu, petikan dalam
contoh di atas tidak menyebabkan masalah dalam kes yang telah saya uji.

Nota 2: Satu kes di mana petikan penting ialah apabila fail berada dalam subdirektori
dan sistem pengendalian anda ialah Microsoft Windows. Kemudian watak pemisah untuk
komponen direktori boleh sama ada garis miring ke hadapan '/' atau Microsoft yang lebih biasa ke belakang
tetak ´\'. Garis miring ke hadapan dihasilkan oleh lateksmk, untuk mengekalkan kewarasannya daripada perisian
seperti MiKTeX yang mencampurkan kedua-dua pemisah direktori; tetapi penggunaannya yang betul biasanya memerlukan
dipetik nama fail. (Lihat fail log daripada larian MiKTeX (sekurang-kurangnya dalam v. 2.9) untuk a
contoh penggunaan kedua-dua pemisah direktori.)

Jika anda mempunyai beberapa kebergantungan tersuai umum yang ditakrifkan dalam sistem atau permulaan pengguna
fail, anda mungkin mendapati bahawa untuk projek tertentu ia tidak diingini. Jadi anda mungkin mahu
untuk memadam yang tidak diperlukan. Contohnya, anda mengalih keluar sebarang peraturan "rajah" hingga "eps" mengikut baris

remove_cus_dep( 'rajah', 'eps' );

Jika anda mempunyai set kebergantungan tersuai yang rumit, anda mungkin ingin mendapatkan penyenaraian
kebergantungan tersuai. Ini dilakukan dengan menggunakan talian

show_cus_dep();

dalam fail permulaan.

Satu lagi contoh pergantungan tersuai mengatasi had lateksmk berkenaan indeks
fail. Satu-satunya penukaran fail indeks terbina dalam lateksmk adalah daripada fail ".idx" yang ditulis
pada satu larian lateks/pdflatex ke fail ".ind" untuk dibaca pada larian berikutnya. Tetapi
dengan pakej index.sty anda boleh membuat indeks tambahan dengan sambungan yang anda
mengkonfigurasi. Latexmk tidak tahu bagaimana untuk menyimpulkan sambungan daripada maklumat itu
mempunyai. Tetapi anda boleh menulis pergantungan tersuai dengan mudah. Contohnya jika fail lateks anda menggunakan
arahan "\newindex{special}{ndx}{nnd}{Special index}" anda perlu menukar fail
dengan sambungan .ndx kepada .nnd. Baris berikut dalam fail RC permulaan akan
menyebabkan perkara ini berlaku:

add_cus_dep('ndx', 'nnd', 0, 'makendx2nnd');
sub makendx2nnd {
system( "makeindex -o \"$_[0].nnd\" \"$_[0].ndx\"" );
}

(Anda perlu mengubah suai kod ini jika anda menggunakan nama fail dengan ruang di dalamnya, untuk menyediakan
petikan nama fail yang betul.)

Anda yang berpengalaman dengan Makefiles, sudah pasti akan bimbang bahawa .ndx
fail ditulis semasa menjalankan lateks/pdflatex dan sentiasa lewat daripada fail .nnd bacaan terakhir
dalam. Oleh itu .nnd nampaknya sentiasa ketinggalan zaman. Keadaan ini, pekeliling
kebergantungan, adalah endemik kepada lateks, dan lateksmk dalam versi semasanya berfungsi dengan betul dengan
kebergantungan bulat. Ia memeriksa kandungan fail (dengan menggunakan md5 checksum),
dan hanya membuat semula apabila kandungan fail sebenarnya telah berubah.

Sudah tentu jika anda memilih untuk menulis data rawak ke .nnd (atau dan .aux fail, dll) itu
perubahan pada setiap larian baharu, maka anda akan menghadapi masalah. Untuk pakar sebenar: Lihat
%hash_cal_ignore_pattern jika anda terpaksa berhadapan dengan masalah sebegini.

Glosari boleh ditangani dengan cara yang sama.

TUA KAEDAH OF MENENTUKAN CUSTOM KEBERGANTUNGAN

Dalam versi sebelumnya dari lateksmk, satu-satunya kaedah untuk menentukan kebergantungan tersuai adalah dengan
memanipulasi secara langsung jadual kebergantungan tersuai. Ini terkandung dalam
@cus_dep_list tatasusunan. Ia adalah tatasusunan rentetan, dan setiap rentetan dalam tatasusunan mempunyai empat
item di dalamnya, setiap satu dipisahkan oleh ruang, sambungan daripada, sambungan kepada, "mesti"
item dan nama subrutin untuk pergantungan tersuai. Ini semua telah ditakrifkan
atas.

Contoh kaedah lama untuk menentukan kebergantungan tersuai adalah seperti berikut. Ia adalah kod
dalam fail RC untuk memastikan penukaran automatik bagi .rajah fail ke .eps fail:

tolak @cus_dep_list, "fig eps 0 fig2eps";
sub fig2eps {
system( "fig2dev -Lps \"$_[0].rajah\" \"$_[0].eps\"" );
}

Kaedah ini masih berfungsi, dan bersamaan dengan kod sebelumnya menggunakan add_cus_dep
subrutin, kecuali ia tidak memadamkan sebarang pergantungan tersuai sebelumnya untuk perkara yang sama
penukaran. Jadi kaedah baru adalah lebih baik.

MENGGUNAKAN lateksmk DENGAN membuat
Bahagian ini disasarkan hanya kepada pengguna lanjutan yang menggunakan membuat program untuk kompleks
projek, seperti untuk pembangunan perisian, dengan kebergantungan yang ditentukan oleh Makefile.

Sekarang tugas asas lateksmk adalah untuk menjalankan program yang sesuai untuk membuat boleh dilihat
versi dokumen LaTeX. Namun, yang biasa membuat program tidak sesuai untuk ini
tujuan untuk sekurang-kurangnya dua sebab. Pertama ialah penggunaan LaTeX melibatkan pekeliling
kebergantungan (cth, melalui fail .aux), dan ini tidak boleh dikendalikan oleh standard membuat
program. Kedua ialah dalam dokumen besar set fail sumber boleh berubah agak
kerap, terutamanya dengan fail grafik yang disertakan; dalam situasi ini mengekalkan a
Makefile secara manual dikemas kini adalah tidak sesuai dan terdedah kepada ralat, terutamanya apabila fail
kebergantungan boleh ditentukan secara automatik. Latexmk menyelesaikan kedua-dua masalah ini
dengan mantap.

Oleh itu untuk banyak dokumen LaTeX standard lateksmk boleh digunakan dengan sendirinya tanpa membuat
program. Dalam projek yang kompleks, ia hanya perlu dikonfigurasikan dengan sesuai. Satu standard
konfigurasi adalah untuk menentukan kebergantungan tersuai untuk membuat fail grafik daripada mereka
fail sumber (cth, seperti yang dicipta oleh xfig program). Kebergantungan tersuai adalah lateksmk's
setara dengan peraturan corak dalam Makefiles.

Namun begitu, terdapat projek yang mana Makefile sesuai, dan ia berguna untuknya
tahu guna lateksmk daripada Makefile. Contoh biasa ialah menjana
dokumentasi untuk projek perisian. Berpotensi interaksi dengan selebihnya
peraturan dalam Makefile mungkin agak rumit, contohnya jika beberapa fail sumber
untuk dokumen LaTeX dihasilkan oleh perisian projek.

Dalam bahagian ini, saya memberikan beberapa contoh bagaimana lateksmk boleh digunakan dengan berguna daripada a
Makefile. Contoh-contoh menggunakan ciri khusus versi semasa GNU membuat, Yang merupakan
lalai pada kedua-dua sistem linux dan OS-X. Mereka mungkin memerlukan pengubahsuaian untuk yang lain
versi membuat.

Kaedah yang paling mudah adalah hanya untuk mewakilkan semua tugas yang berkaitan kepada lateksmk, sebagaimana adanya
sesuai untuk dokumen LaTeX yang mudah. Untuk ini Makefile yang sesuai adalah seperti

.PHONY : FORCE_MAKE
semua : cuba.pdf
%.pdf : %.tex FORCE_MAKE
lateksmk -pdf -dvi- -ps- $

(Nota: baris terakhir mesti diperkenalkan oleh tab untuk Makefile berfungsi dengan betul!)
Sememangnya, jika membuat try.pdf daripada fail LaTeX yang berkaitan try.tex adalah satu-satunya tugas
dilaksanakan, penggunaan langsung daripada lateksmk tanpa Makefile biasanya lebih baik. The
faedah menggunakan Makefile untuk dokumen LaTeX akan berada dalam projek yang lebih besar, di mana baris
seperti di atas hanya akan menjadi sebahagian kecil daripada Makefile yang lebih besar.

Contoh di atas mempunyai peraturan corak untuk membuat fail .pdf daripada fail .tex, dan ia adalah
ditakrifkan untuk menggunakan lateksmk dengan cara yang jelas. Terdapat sasaran lalai konvensional yang dinamakan
"semua", dengan prasyarat try.pdf. Jadi bila membuat dipanggil, secara lalai ia membuat
cuba.pdf. Satu-satunya komplikasi ialah mungkin terdapat banyak fail sumber selain daripada try.tex, tetapi
ini tidak dinyatakan dalam Makefile, jadi perubahan di dalamnya tidak akan menyebabkannya sendiri
lateksmk untuk diseru. Sebaliknya, peraturan corak dilengkapi dengan prasyarat "palsu".
PAKSA_BUAT; ini mempunyai kesan menyebabkan peraturan sentiasa ketinggalan zaman, supaya
lateksmk sentiasa dijalankan. Ia adalah lateksmk yang memutuskan sama ada sebarang tindakan diperlukan, cth., a
tayangan semula pdflatex. Secara berkesan Makefile mewakilkan semua keputusan kepada lateksmk, Manakala
membuat tidak mempunyai pengetahuan tentang senarai fail sumber kecuali fail LaTeX utama untuk
dokumen. Jika terdapat, sebagai contoh, fail grafik yang akan dibuat, ini mesti dibuat oleh
kebergantungan tersuai dikonfigurasikan dalam lateksmk.

Tetapi sesuatu yang lebih baik diperlukan dalam situasi yang lebih rumit, contohnya, apabila
pembuatan fail grafik perlu ditentukan oleh peraturan dalam Makefile. Untuk melakukan ini, satu
boleh menggunakan Makefile seperti berikut:

SASARAN = document1.pdf document2.pdf
DEPS_DIR = .deps
LATEXMK = lateksmk -recorder -use-make -deps \
-e 'amaran qq(Dalam Makefile, matikan kebergantungan tersuai\n);' \
-e '@cus_dep_list = ();' \
-e 'show_cus_dep();'
semua : $(SASARAN)
$(foreach fail,$(SASARAN),$(eval -include $(DEPS_DIR)/$(fail)P))
$(DEPS_DIR):
mkdir $@
%.pdf : %.tex
jika [ ! -e $(DEPS_DIR) ]; kemudian mkdir $(DEPS_DIR); fi
$(LATEXMK) -pdf -dvi- -ps- -deps-out=$(DEPS_DIR)/$@P $
%.pdf : %.rajah
fig2dev -Lpdf $< $@

(Sekali lagi, baris yang mengandungi arahan untuk peraturan harus dimulakan dengan tab.)
Contoh ini diilhamkan oleh bagaimana GNU automatik mengendalikan penjejakan pergantungan automatik C
fail sumber.

Selepas setiap latexmk dijalankan, maklumat pergantungan dimasukkan ke dalam fail dalam .deps
subdirektori. Makefile menyebabkan fail pergantungan ini dibaca oleh membuat, yang kini
mempunyai maklumat pergantungan penuh untuk setiap fail .pdf sasaran. Untuk mengurangkan perkara
remeh adalah khusus bahawa dua fail document1.pdf dan document2.pdf adalah sasaran.
Fail pergantungan ialah .deps/document1.pdfP dan .deps/document2.pdfP.

Kini tiada keperluan untuk prasyarat palsu bagi peraturan untuk membuat fail .pdf daripada .tex
fail. Tetapi saya telah menambah peraturan untuk membuat fail .pdf daripada fail .fig yang dihasilkan oleh xfig
program; ini biasanya digunakan untuk sisipan grafik dalam dokumen LaTeX. Latexmk is
disusun untuk mengeluarkan fail kebergantungan selepas setiap larian. Ia diberi -perakam pilihan,
yang meningkatkan pengesanan fail yang dijana semasa menjalankan pdflatex; fail sedemikian
tidak sepatutnya berada dalam senarai tanggungan. The -e pilihan digunakan untuk mematikan semua tersuai
tanggungan, dan untuk mendokumenkan ini. Sebaliknya -guna-buat digunakan untuk mewakilkan pembuatan
kehilangan fail ke membuat sendiri.

Katakan dalam fail LaTeX terdapat perintah \includegraphics{graph} dan an xfig fail
"graph.fig" wujud. Pada larian pertama, pdflatex melaporkan fail yang hilang, bernama "graf".
Latexmk berjaya membuat "graph.pdf" dengan memanggil "make graph.pdf", dan selepas selesai
daripada kerjanya, ia menyenaraikan "fig.pdf" antara tanggungan fail lateksmk sedang membuat. Kemudian
biarkan "fig.fig" dikemas kini, dan kemudian biarkan membuat dijalankan. Membuat pembuatan semula pertama "fig.pdf", dan
barulah ditayangkan semula lateksmk.

Oleh itu, kami kini mempunyai satu kaedah di mana semua pemprosesan subsidiari diwakilkan kepada membuat.

Gunakan latexmkL dalam talian menggunakan perkhidmatan onworks.net