bundledoc - Online în cloud

PROGRAM:

NUME

bundledoc - grupează toate fișierele necesare unui document LaTeX

REZUMAT

bundledoc [--versiune] [--Ajutor] [--[Nu.]prolix] [--texfile=fişier] [--director=director]
[--[Nu.]numai local] [--exclude=şir] [--include=fisierspec] [--manifesta=fişier]
[--listdeps=[da|nu|doar|rel]...] [--[Nu.]keepdirs] [--config=fişier] .dep fişier

DESCRIERE

bundledoc este un post-procesor pentru instantaneu pachet care reunește toate
clase, pachete și fișiere necesare pentru a construi un anumit document LaTeX. Se citește .dep
fișier care instantaneu produce, găsește fiecare dintre fișierele menționate acolo și le împachetează
într-un singur fișier de arhivă (de exemplu, a .tar.gz fișier), potrivit pentru mutarea între sisteme,
transmiterea unui coleg etc.

Ca exemplu cel mai simplu posibil, luați în considerare un fișier LaTeX numit, de exemplu, salut.tex:

\RequirePackage{snapshot} % Necesar de bundledoc
\documentclass[11pt]{articol}

\ Begin {document}
Salut Lume!
\ End {document}

„\RequirePackage{snapshot}” cauzează a salut.dep fișier care urmează să fie produs. Cand bundledoc is
apoi dat „hello.dep” ca argument, localizează fișierele dependente -- instantaneu.sty,
articol.cls, și dimensiune11.clo -- și le grupează într-un singur fișier arhivă, împreună cu
salut.tex și MANIFESTA fișier (descris în „OPȚIUNI”, mai jos).

OPŢIUNI

În următoarele descrieri, un fişier se referă la numele documentului principal LaTeX (nr
extensie).

bundledoc necesită numele fișierului de dependență produs de instantaneu (în mod normal
somefile.dep). De asemenea, pot fi oferite următoarele opțiuni:

--versiune
Ieșiți bundledoc numărul versiunii scriptului. Aceasta anulează toate celelalte
opțiuni.

--Ajutor
Dați un scurt mesaj de utilizare. Aceasta anulează toate opțiunile rămase.

--[Nu.]prolix (implicit: „noverbose”)
bundledoc în mod normal, nu scoate nimic, cu excepția mesajelor de eroare. Cu „--verbose”,
emite mesaje de stare abundente.

--texfile=principal .tex fişier (Mod implicit: somefile.tex)
instantaneuFișierul de dependență al lui nu listează fișierul principal LaTeX (cel care este trecut
la latex). In asa fel incat bundledoc pentru a găsi și a grupa acel fișier, bundledoc o presupune
are același nume ca și instantaneu fișier de dependență dar cu a .tex extensie. Dacă aceasta
nu este cazul, apoi utilizați „--texfile” pentru a specifica numele corect al fișierului.

--director=Arhiva director (Mod implicit: un fişier)
Cand bundledoc creează o arhivă (de exemplu, a .gudron or .zip fișier) care conține
fișierele documentului, le pune pe toate într-un director pentru a evita aglomerarea curentului
director cu fișiere. Dacă fișierul de dependență dat este apelat somefile.dep apoi
arhiva rezultată va stoca, implicit, toate fișierele dependente într-un un fişier
director. Pentru a schimba numele directorului utilizați opțiunea „--directory”.

--[Nu.]numai local (implicit: „nolocalonly”)
Cu toate ca bundledoc în mod normal arhivează toate fișierele denumite în .dep fișier,
Opțiunea „--localonly” spune bundledoc pentru a exclude toate fișierele aflate într-un alt director
decât .tex directorul fișierului sau unul dintre subdirectoarele acestuia.

--exclude=şir (Mod implicit: nici unul)
În timp ce „--localonly” provoacă fișiere în afara .tex arborele de directoare al fișierului să fie
omis din arhivă, „--exclude” oferă un control mai fin asupra fișierelor către
omite din arhivă. Opțiunea „--exclude”, care poate fi specificată în mod repetat
linia de comandă, provoacă toate fișierele al căror nume conține şir a fi omis din
Arhiva.

--include=fisierspec (Mod implicit: nici unul)
Opțiunea „--include”, care poate fi specificată în mod repetat pe linia de comandă,
instruiește bundledoc pentru a include în arhivă toate fișierele care se potrivesc fisierspec, chiar
dacă nu sunt menționate în .dep fișier.

--manifesta=manifesta fişier (Mod implicit: MANIFESTA)
Pe lângă fișierele dependente, bundledoc include in fisierul de arhiva unul in plus
fișier numit, implicit, ``MANIFESTA''. MANIFESTA este un fișier text care listează
numele de fișiere originale ale tuturor dependențelor. Pentru a schimba numele fișierului din ``MANIFESTA''
la altceva, folosește opțiunea „--manifest”. Ca caz special, "--manifest="""
spune bundledoc să nu includă deloc un fișier manifest.

--listdeps=[da|nu|doar|rel]...] (implicit: „nu”)
„--listdeps” acceptă unul sau mai multe dintre „da”, „nu”, „numai” sau „rel” ca fiind separate prin virgulă
listă. Atâta timp cât „nu” nu apare în această listă, bundledoc iese toate principalele
Dependențe ale fișierului LaTeX. Dacă lista conține „rel”, atunci bundledoc ieșiri
listă de dependențe cu nume de căi relative. Dacă lista conține „doar”, atunci
bundledoc iese după afișarea listei, fără a produce o arhivă.

--[Nu.]keepdirs (implicit: "nokeepdirs")
În mod normal, fișierul de arhivă care bundledoc produces conține un singur director -- și
subdirectoare, dacă documentul se referă în mod explicit la acestea -- în care toate
fișierele dependente mint. Dacă este specificat „--keepdirs”, toate fișierele dependente sunt stocate
cu denumirile lor originale. De exemplu, dacă somefile.tex depinde
figuri/somefigure.eps, articol.cls, și instantaneu.sty, apoi un fişier arhiva va
conțin în mod normal următoarele fișiere:

· somefile/somefile.tex

· somefile/figures/somefigure.eps

· somefile/article.cls

· somefile/snapshot.sty

· somefile/MANIFEST

Cu toate acestea, „--keepdirs” va cauza un fişier arhiva pentru a conține următoarele tipuri
de nume de fișiere în schimb:

· home/eu/mydocs/somefile.tex

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

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

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

„--directory” nu este folosit când „--keepdirs” este în vigoare. În plus, nici un manifest
fișierul este scris în fișierul arhivă deoarece conține informații redundante.

--config=configuraţie fişier (Mod implicit: )
Opțiunea „--config” este folosită pentru a indica bundledoc la configurația corespunzătoare
(.CFG) pentru sistemul dumneavoastră de operare și distribuție TeX. bundledoc vine cu un
puține fișiere de configurare și este ușor să scrieți mai multe. Consultați „FIȘIERE DE CONFIGURARE”
(mai jos) pentru o descriere a formatului fișierului de configurare.

CONFIGURARE DOSARE

Format
Fișierele de configurare urmează un format destul de simplu. Rândurile care încep cu „#” sunt comentarii.
Liniile goale sunt ignorate. Toate celelalte linii sunt de forma:

variabilă: valoare

Versiunea actuală a bundledoc recunoaște următoarele variabile:

pachet
Comanda de utilizat pentru a grupa un set de fișiere într-un singur fișier arhivă

chiuvetă
Afixul unei comenzi pentru a renunța la ieșirea acesteia

găsi
Comanda pentru a găsi un fișier în arborele (arborele) TeX.

Valorile care sunt prea lungi pentru o singură linie pot fi împărțite pe mai multe linii folosind „\” ca
simbolul linie-continuare.

Există două variabile de mediu care bundledoc pune la dispoziție pentru utilizare de către
comenzi pentru fișierul de configurare: „BDBASE”, care este setat la un fişier (ca în „OPȚIUNI”) și
„BDINPUTS”, care este setat la o listă de fișiere separate prin spațiu pe care urmează să le opereze o comandă
peste. Adică, atunci când comanda asociată cu „bundle” rulează, „BDINPUTS” conține
lista tuturor fișierelor care urmează să fie arhivate. În schimb, când comanda
asociat cu „find” rulează, „BDINPUTS” conține numele fișierului de căutat.

Exemple
Următoarele fișiere de configurare sunt paralele bundledocvalorile implicite ale diferitelor
variabilele fișierului de configurare, care reprezintă o distribuție TeX bazată pe kpathsea care rulează
pe un sistem Unix generic, care nu are neapărat niciunul dintre instrumentele GNU, cum ar fi
gzip sau GNU gudron:

# Fișierul de configurare „implicit”.
# De Scott Pakin[e-mail protejat]>

pachet: (tar -cvf - $BDINPUTS | compress > $BDBASE.tar.Z)
sink: > /dev/null 2>&1
găsiți: kpsewhich -progname=latex $BDINPUTS

Parantezele din linia „bundle:” spun shell-ului Unix să execute comanda într-un
subshell. Acest lucru este pentru a face ca afixul „chiuvetă:” să funcționeze corect (adică, astfel încât să nu fie două
„>” este în aceeași comandă).

Observați cum comenzile tratează „BDBASE” și „BDINPUTS” ca orice alte variabile de mediu
într-un shell Unix, folosind „$” pentru a le lua valoarea. Alte sisteme de operare folosesc diferite
convenții pentru referirea la variabilele de mediu. De exemplu, un fișier de configurare
pentru o distribuție TeX bazată pe Windows ar folosi în schimb „%BDBASE%” și „%BDINPUTS%”.

Valoarea pentru „sink:” este specifică unui sistem de operare. Valoarea pentru „găsiți:” este
specific unei distribuții TeX. „pachet:” este locul unde există cele mai multe oportunități de personalizare
minciuni. Puteți folosi „bundle:” pentru a specifica formatul de arhivă preferat. De exemplu, tu
poate produce un fișier shar pe Unix cu ceva de genul:

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

sau un fișier CAB pe Microsoft Windows cu ceva de genul:

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

EXEMPLE

Asuma ca myfile.dep a fost produs din fişierul meu.tex urmând instrucțiunile din
Secțiunea de descriere. Următoarea comandă produce a .zip fișier cu MikTeX TeX
distribuție care rulează pe Microsoft Windows:

bundledoc --config=miktex.cfg myfile.dep

(În practică, probabil că este necesar să specificați „--config” calea completă către
bundledoc's miktex.cfg Fișier de configurare.)

Următoarele construiesc a .tar.gz arhivă cu distribuția TeX Live care rulează pe Unix-
ca un sistem de operare. bundledoc va produce rezultate detaliate care descriu operațiunile sale.
Toate fișierele nu sunt în același arbore de directoare ca fişierul meu.tex și toate fișierele care conțin „.fd” sau
„.sty” în numele lor sunt omise. Cu toate acestea, toate .bib fișierele din directorul curent vor
să fie incluse în arhivă chiar dacă niciuna dintre ele nu este referită de myfile.dep.
În fine, nu MANIFESTA va fi produs fișierul.

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

Utilizați bundledoc online folosind serviciile onworks.net