bundledoc - Online sa Cloud

PROGRAMA:

NAME

bundledoc - bundle ang lahat ng mga file na kailangan ng isang LaTeX na dokumento

SINOPSIS

bundledoc [--bersyon] [- Tumulong] [--[hindi]pandiwang] [--texfile=file] [--direktoryo=direktoryo]
[--[hindi]lokal lamang] [--ibukod=pisi] [--isama=filespec] [--manifest=file]
[--listdeps=[oo|hindi|lamang|rel]...] [--[hindi]keepdirs] [--config=file] .dep file

DESCRIPTION

bundledoc ay isang post-processor para sa retrato package na pinagsama-sama ang lahat ng
mga klase, pakete, at mga file na kailangan para makabuo ng isang ibinigay na LaTeX na dokumento. Binabasa nito ang .dep
file kana retrato gumagawa, hinahanap ang bawat isa sa mga file na binanggit doon, at ini-package ang mga ito
sa iisang archive file (hal., a .tar.gz file), na angkop para sa paglipat sa mga system,
pagpapadala sa isang kasamahan, atbp.

Bilang pinakasimpleng halimbawa na posible, isaalang-alang ang isang LaTeX file na tinatawag, sabihin nating, hello.tex:

\RequirePackage{snapshot} % Kailangan ng bundledoc
\documentclass[11pt]{artikulo}

\ Simulan {dokumento}
Kumusta, mundo!
\ End {dokumento}

Ang "\RequirePackage{snapshot}" ay nagdudulot ng a hello.dep file na gagawin. Kailan bundledoc is
pagkatapos ay binigyan ng "hello.dep" bilang argumento, hinahanap nito ang mga dependent na file -- snapshot.sty,
artikulo.cls, at sukat11.clo -- at i-bundle ang mga ito sa iisang archive file, kasama ng
hello.tex at MANIFEST file (inilalarawan sa "OPTIONS", sa ibaba).

Opsyon

Sa mga sumusunod na paglalarawan, somefile ay tumutukoy sa pangalan ng iyong pangunahing LaTeX na dokumento (no
extension).

bundledoc nangangailangan ng pangalan ng dependency file na ginawa ni retrato (karaniwan
somefile.dep). Ang mga sumusunod na opsyon ay maaari ding ibigay:

--bersyon
I-output ang bundledoc numero ng bersyon ng script. Ino-override nito ang lahat ng natitira
mga pagpipilian.

- Tumulong
Magbigay ng maikling mensahe ng paggamit. Ino-override nito ang lahat ng natitirang opsyon.

--[hindi]pandiwang (default: "noverbose")
bundledoc karaniwang hindi naglalabas ng anuman maliban sa mga mensahe ng error. Gamit ang "--verbose",
naglalabas ito ng napakaraming mensahe ng katayuan.

--texfile=pangunahin .tex file (default: somefile.tex)
retratoAng dependency file ng 's ay hindi nakalista ang pangunahing LaTeX file (ang isa na maipapasa
sa LaTeX). Para sa bundledoc upang mahanap at i-bundle ang file na iyon, bundledoc ipinapalagay ito
ay may parehong pangalan ng retrato dependency file ngunit may a .tex extension. Kung ito
ay hindi ang kaso, pagkatapos ay gamitin ang "--texfile" upang tukuyin ang tamang filename.

--direktoryo=archive direktoryo (default: somefile)
Kailan bundledoc lumilikha ng archive (hal., a .tar or zip file) na naglalaman ng
dokumento, inilalagay nito ang lahat sa isang direktoryo upang maiwasan ang kalat sa kasalukuyang
direktoryo na may mga file. Kung ang ibinigay na dependency file ay tinawag somefile.dep pagkatapos ay ang
ang nagreresultang archive, bilang default, ay mag-iimbak ng lahat ng mga nakadependeng file sa a somefile
direktoryo. Upang baguhin ang pangalan ng direktoryo, gamitin ang opsyong "--directory".

--[hindi]lokal lamang (default: "nolocalonly")
Bagaman bundledoc karaniwang naka-archive ang lahat ng mga file na pinangalanan sa .dep file, ang
Sinasabi ng "--localonly" na opsyon bundledoc upang ibukod ang lahat ng mga file na matatagpuan sa isang iba pang direktoryo
kaysa sa .tex direktoryo ng file o isa sa mga subdirectory nito.

--ibukod=pisi (default: wala)
Habang ang "--localonly" ay nagdudulot ng mga file sa labas ng .tex puno ng direktoryo ng file upang maging
inalis mula sa archive, ang "--exclude" ay nagbibigay ng mas pinong kontrol sa mga file sa
alisin mula sa archive. Ang opsyong "--exclude", na maaaring tukuyin nang paulit-ulit sa
ang command line, nagiging sanhi ng lahat ng mga file na naglalaman ng pangalan pisi na tanggalin sa
archive

--isama=filespec (default: wala)
Ang "--include" na opsyon, na maaaring tukuyin nang paulit-ulit sa command line,
nagtuturo bundledoc upang isama sa archive ang lahat ng mga file na tumutugma filespec, kahit na
kung hindi sila tinutukoy sa .dep file.

--manifest=mahayag file (default: MANIFEST)
Bilang karagdagan sa mga nakadependeng file, bundledoc kasama sa archive file ang isang dagdag
file na tinatawag, bilang default, ``MANIFEST" MANIFEST ay isang text file na naglilista ng
orihinal na mga filename ng lahat ng dependencies. Upang palitan ang filename mula sa ``MANIFEST''
sa ibang bagay, gamitin ang "--manifest" na opsyon. Bilang isang espesyal na kaso, "--manifest="""
nagsasabi bundledoc huwag magsama ng isang manifest file sa lahat.

--listdeps=[oo|hindi|lamang|rel]...] (default: "hindi")
Ang "--listdeps" ay tumatanggap ng isa o higit pa sa "yes", "no", "only", o "rel" bilang isang comma-separated
listahan. Hangga't hindi lumalabas ang "hindi" sa listahang ito, bundledoc output ang lahat ng pangunahing
Mga dependency ng LaTeX file. Kung ang listahan ay naglalaman ng "rel", kung gayon bundledoc output ang
listahan ng mga dependency na may mga kamag-anak na pangalan. Kung ang listahan ay naglalaman ng "lamang", kung gayon
bundledoc lalabas pagkatapos ipakita ang listahan, nang hindi gumagawa ng archive.

--[hindi]keepdirs (default: "nokeepdirs")
Karaniwan, ang archive file na bundledoc produces ay naglalaman ng isang solong direktoryo -- at
mga subdirectory, kung ang dokumento ay tahasang tumutukoy sa kanila -- kung saan ang lahat ng
kasinungalingan ang dependent files. Kung ang "--keepdirs" ay tinukoy, lahat ng mga nakadependeng file ay naka-imbak
kasama ang kanilang orihinal na mga pathname. Halimbawa, kung somefile.tex depende sa
figures/somefigure.eps, artikulo.cls, at snapshot.sty, pagkatapos ay ang somefile kalooban ng archive
karaniwang naglalaman ng mga sumusunod na file:

· somefile/somefile.tex

· somefile/figures/somefigure.eps

· somefile/article.cls

· somefile/snapshot.sty

· somefile/MANIFEST

Gayunpaman, ang "--keepdirs" ay magiging sanhi ng somefile archive na naglalaman ng mga sumusunod na uri
ng mga filename sa halip:

· home/me/mydocs/somefile.tex

· home/me/mydocs/figures/somefigure.eps

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

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

Ang "--directory" ay hindi ginagamit kapag ang "--keepdirs" ay may bisa. Bilang karagdagan, walang manifest
Ang file ay isinulat sa archive file dahil naglalaman ito ng kalabisan na impormasyon.

--config=configuration file (default: )
Ang "--config" na opsyon ay ginagamit upang ituro bundledoc sa naaangkop na pagsasaayos
(.cfg) na file para sa iyong TeX distribution at operating system. bundledoc ay may isang
kaunting mga configuration file at madaling magsulat ng higit pa. Tingnan ang "CONFIGURATION FILES"
(sa ibaba) para sa isang paglalarawan ng format ng configuration file.

Configuration MGA FILE

format
Ang mga file ng configuration ay sumusunod sa isang medyo simpleng format. Ang mga linyang nagsisimula sa "#" ay mga komento.
Binabalewala ang mga blangkong linya. Ang lahat ng iba pang mga linya ay nasa anyo:

variable: halaga

Ang kasalukuyang bersyon ng bundledoc kinikilala ang mga sumusunod na variable:

atado
Ang utos na gagamitin upang i-bundle ang isang hanay ng mga file sa iisang archive file

lababo
Ang pandikit sa isang utos upang itapon ang output nito

mahanap
Ang utos upang maghanap ng file sa loob ng (mga) puno ng TeX.

Ang mga value na masyadong mahaba para sa isang linya ay maaaring hatiin sa maraming linya sa pamamagitan ng paggamit ng "\" bilang
ang simbolo ng linya-pagpapatuloy.

Mayroong dalawang mga variable ng kapaligiran na bundledoc ginagawang available para magamit ng
configuration-file command: "BDBASE", na nakatakda sa somefile (tulad ng sa "OPTIONS"), at
"BDINPUTS", na nakatakda sa isang space-separated na listahan ng mga file na pinapatakbo ng isang command
sa. Iyon ay, kapag ang command na nauugnay sa "bundle" ay tumatakbo, ang "BDINPUTS" ay naglalaman ng
ang listahan ng lahat ng mga file na dapat i-archive. Sa kaibahan, kapag ang utos
na nauugnay sa "hanapin" ay tumatakbo, "BDINPUTS" ay naglalaman ng pangalan ng file na hahanapin.

Mga halimbawa
Ang sumusunod na configuration file ay magkatulad bundledocAng mga default na halaga ng iba't-ibang
configuration-file variable, na kumakatawan sa isang kpathsea-based na pamamahagi ng TeX na tumatakbo
sa isang generic na Unix system, na hindi kinakailangang magkaroon ng alinman sa mga tool ng GNU, gaya ng
gzip o GNU alkitran:

# "Default" na configuration file
# Ni Scott Pakin[protektado ng email]>

bundle: (tar -cvf - $BDINPUTS | compress > $BDBASE.tar.Z)
lababo: > /dev/null 2>&1
hanapin: kpsewhich -progname=latex $BDINPUTS

Ang mga panaklong sa linyang "bundle:" ay nagsasabi sa Unix shell na patakbuhin ang command sa a
subshell. Ito ay para gumana nang maayos ang "sink:" affix (ibig sabihin, walang dalawa
">" ay nasa parehong utos).

Pansinin kung paano tinatrato ng mga utos ang "BDBASE" at "BDINPUTS" tulad ng anumang iba pang mga variable ng kapaligiran
sa isang Unix shell, gamit ang "$" para kunin ang kanilang halaga. Iba ang ginagamit ng ibang mga operating system
mga kumbensyon para sa pagtukoy sa mga variable ng kapaligiran. Halimbawa, isang configuration file
para sa pamamahagi ng TeX na nakabatay sa Windows ay gagamit ng "%BDBASE%" at "%BDINPUTS%" sa halip.

Ang halaga para sa "sink:" ay partikular sa isang operating system. Ang halaga para sa "hanapin:" ay
tiyak sa isang pamamahagi ng TeX. "bundle:" ay kung saan ang pinaka pagkakataon para sa pagpapasadya
kasinungalingan. Maaari mong gamitin ang "bundle:" upang tukuyin ang iyong paboritong format ng archive. Halimbawa, ikaw
ay maaaring gumawa ng isang shar file sa Unix na may tulad ng:

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

o isang CAB file sa Microsoft Windows na may tulad ng:

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

HALIMBAWA

Ipagpalagay na myfile.dep ay ginawa mula sa myfile.tex sa pamamagitan ng pagsunod sa mga tagubilin sa
Seksyon ng paglalarawan. Ang sumusunod na utos ay gumagawa ng a zip file gamit ang MikTeX TeX
pamamahagi na tumatakbo sa Microsoft Windows:

bundledoc --config=miktex.cfg myfile.dep

(Sa pagsasagawa, malamang na kinakailangan na tukuyin sa "--config" ang kumpletong landas sa
bundledoc's miktex.cfg configuration file.)

Ang mga sumusunod ay bumuo ng a .tar.gz archive gamit ang pamamahagi ng TeX Live na tumatakbo sa isang Unix-
tulad ng operating system. bundledoc gagawa ng verbose output na naglalarawan sa mga operasyon nito.
Ang lahat ng mga file ay wala sa parehong puno ng direktoryo bilang myfile.tex at lahat ng mga file na naglalaman ng ".fd" o
".sty" sa kanilang mga pangalan ay tinanggal. Gayunpaman, lahat .bib mga file sa kasalukuyang direktoryo ay
isama sa archive kahit wala sa kanila ang tinutukoy ng myfile.dep.
Sa wakas, hindi MANIFEST file ay gagawin.

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

Gumamit ng bundledoc online gamit ang mga serbisyo ng onworks.net