guma - Online w chmurze

PROGRAM:

IMIĘ

guma - system budowania dokumentów LaTeX

STRESZCZENIE

gumowy [Opcje] źródła ...
gumowa rurka [Opcje]

OPIS

Rubber to opakowanie dla programów LaTeX i towarzyszących. Jego celem jest, biorąc pod uwagę LaTeX
source do przetworzenia, aby skompilować go wystarczająco dużo razy, aby rozwiązać wszystkie odwołania, prawdopodobnie uruchomione
programy satelitarne, takie jak BibTeX, makeindex, Metapost itp., w celu uzyskania odpowiednich danych
akta.

Komenda gumowy całkowicie buduje określone dokumenty. Pliki źródłowe mogą być
albo źródła LaTeX (w takim przypadku sufiks .tex można pominąć) albo dokumenty w formacie a
format Rubber wie, jak tłumaczyć na LaTeX. Jeśli jedna kompilacja się nie powiedzie, cała
zatrzymanie procesu, w tym kompilację kolejnych dokumentów w wierszu poleceń i
gumowy zwraca niezerowy kod wyjścia.

Komenda gumowa rurka robi to samo dla jednego dokumentu, ale czyta źródło LaTeX-a
standardowego wejścia i wyrzuca skompilowany dokument na standardowe wyjście.

Niektórych informacji nie można wydobyć ze źródeł LaTeX. Dzieje się tak m.in
instancji ze ścieżkami wyszukiwania (które można określić w zmiennych środowiskowych, takich jak
TEXINPUTS) lub styl, który ma być używany z Makeindex. Aby rozwiązać ten problem, można dodać
informacje dotyczące gumy w komentarzach źródeł LaTeX, patrz rozdział DYREKTYWY.

OPCJE

Opcje służą do wyboru akcji do wykonania lub do konfiguracji
proces budowy. W większości są takie same gumowy oraz gumowa rurka. Opcje są analizowane
przy użyciu konwencji GNU Getopt.

-B, --bzip2
Skompresuj końcowy dokument (w bzip2 format). Jest to równoważne z powiedzeniem -o
bzip2 po wszystkich innych opcjach.

--czysty
Usuń wszystkie pliki utworzone przez kompilację, zamiast budować dokument.
Ta opcja jest dostępna w gumowy tylko. Dotyczy to kompilacji tak, jak by to miało miejsce
zrobić z innymi opcjami wiersza poleceń, np. mówiąc „rubber --clean
foo” nie usunie foo.ps, podczas gdy powiedzenie „rubber --ps --clean foo” usunie.

-C, --Komenda
Wykonaj określone polecenie (lub dyrektywę) zanim parsowanie plików wejściowych. Widzieć
Sekcja DYREKTYWY .

-mi, --epilog
Wykonaj określone polecenie (lub dyrektywę) po parsowanie plików wejściowych. Widzieć
Sekcja DYREKTYWY .

-F, --siła
Wymuś co najmniej jedną kompilację źródła. Może to być przydatne, jeśli np
zmodyfikowano jakąś nietypową zależność (np. pakiet w katalogu systemowym). Ten
opcja nie ma znaczenia w gumowa rurka.

-z, --gzip
Skompresuj końcowy dokument (w gzip format). Jest to równoważne z powiedzeniem -o gz
po wszystkich innych opcjach.

-H, --help
Wyświetl listę wszystkich dostępnych opcji i ładnie wyjdź.

--w miejscu
Przejdź do katalogu plików źródłowych przed kompilacją, aby kompilacja
wyniki znajdują się w tym samym miejscu, co ich źródła.

--do
Przejdź do określonego katalogu przed kompilacją, aby wszystkie pliki zostały utworzone
tam, a nie w bieżącym katalogu.

--Nazwa pracy
Określ nazwę zadania inną niż podstawowa nazwa pliku. To zmienia nazwę
pliki wyjściowe i dotyczy tylko pierwszego celu.

-k, --trzymać
Ta opcja jest używana w gumowa rurka tylko. Dzięki tej opcji pliki tymczasowe
nie zostaną usunięte po skompilowaniu dokumentu i zrzuceniu wyników
standardowe wyjście. Dokument tymczasowy nosi nazwę rubtmpX.tex, gdzie X jest liczbą
taki, że początkowo żaden plik o tej nazwie nie istnieje.

-ja, --krajobraz
Określ, że ostateczny dokument powinien mieć orientację poziomą. To jest istotne
tylko podczas używania dvipy or dvipdfm.

-N, --maxerr
Ustaw maksymalną liczbę wyświetlanych błędów. Domyślnie występuje do 10 błędów
zgłosił, mówiąc -n -1 wyświetla wszystkie błędy.

-M, --moduł [:]
Użyj określonego modułu oprócz pakietów dokumentu. Argumenty mogą być
przekazane do pakietu przez dodanie ich po dwukropku, odpowiadają pakietowi
opcje w LaTeXu. Moduł jest załadowany zanim parsowanie źródeł dokumentu.

--tylko
Skompiluj dokument częściowo, uwzględniając tylko określone źródła. To działa
wstawiając wywołanie \includeonly w wierszu poleceń. Argumentem jest przecinek
oddzielna lista nazw plików.

-o, --Poczta [:]
Użyj określonego modułu jako postprocesora. To jest podobne do -m Opcje
poza tym, że moduł jest załadowany po parsowanie dokumentu.

-D, --pdf
Twórz pliki PDF. Kiedy ta opcja pojawi się później --ps (na przykład w formularzu
-pd) jest synonimem -o ps2pdf, w przeciwnym razie działa jako -m pdftex, w celu wykorzystania
pdfLaTeX zamiast LaTeXa.

-P, --ps
Przetwórz DVI wytworzone przez ten proces dvipy(1) do stworzenia PostScriptu
dokument. Ta opcja jest synonimem -o dvipy, to nie może przyjść później --pdf.

-Q, --cichy
Zmniejsz poziom gadatliwości. To jest odwrotność -v.

-R, --czytać
Odczytaj dodatkowe dyrektywy z podanego pliku (zobacz także dyrektywę "read").

-S, --src-specjalne
Włącz generowanie ofert specjalnych źródła, jeśli kompilator to obsługuje. To jest
równoważne ustawieniu zmiennej src-specjalne do tak.

-tak, --niski
Wyświetlaj komunikaty o błędach LaTeX w zwartej formie (jeden błąd w linii).

-i, --ścieżka tekstu
Dodaj określony katalog do ścieżki wyszukiwania TeX-a.

--synctex
Włącz obsługę SyncTeX w uruchomieniu LaTeX.

--niebezpieczny
Zezwól dokumentowi na wywoływanie dowolnych programów zewnętrznych. To jest potencjalnie
niebezpieczne, używaj tej opcji tylko w przypadku dokumentów pochodzących z zaufanego źródła.

-v, --gadatliwy
Zwiększ poziom gadatliwości. Istnieją poziomy od 0 do 4, domyślnym poziomem jest 1
dla gumowy i 0 dla gumowa rurka. Uważaj, mówiąc -vvv sprawia, że ​​Rubber dużo mówi.

--wersja
Wydrukuj numer wersji i ładnie wyjdź.

-W, --ostrzegać
Podaj informacje danego typu, jeśli podczas kompilacji nie wystąpił błąd. The
dostępne typy to: Skrzynki (boksów przepełnionych i niedopełnionych), ref (nieokreślony lub
wielokrotne zdefiniowane referencje), misc (inne ostrzeżenia) i cała kolekcja zgłaszać wszystkie ostrzeżenia.

MODUŁY

Na działanie gumy mają wpływ moduły. Moduły dbają o poszczególne funkcje
pakiety i programy zewnętrzne.

Pakiety
Dla każdego pakietu używanego przez dokument Rubber szuka modułu o tej samej nazwie
wykonaj zadania, których wymaga ten pakiet oprócz kompilacji przez LaTeX.
Moduły mogą być dodawane do tych dostarczonych domyślnie, aby zawierały nowe funkcje (to jest
punkt układu modułowego). Standardowe moduły to:

asymptota
Przetwarza pliki .asy wygenerowane przez pakiet LaTeX, a następnie uruchamia plik
rekompilacja.

beamer Ten moduł obsługuje dodatkowe pliki Beamera w taki sam sposób, jak inne spisy treści.

Bibtex, biblateks
W razie potrzeby zajmuje się przetwarzaniem bibliografii dokumentu za pomocą BibTeX. Ten
moduł jest ładowany automatycznie, jeśli dokument zawiera makro \bibliografię
(patrz też w DYREKTYWY dla opcji).

połączyć
Pakiet Combine służy do zebrania kilku dokumentów LaTeX w jeden,
i ten moduł obsługuje zależności w tym przypadku.

epsrys Ten moduł obsługuje dołączanie grafiki do dokumentów, które używają starego stylu
Makro \psfig. W rzeczywistości jest to interfejs modułu graficznego, patrz ten
.

glosariusze
Uruchom makeglossaries i przekompiluj, gdy zmieni się plik .glo.

grafika, grafikax
Moduły te identyfikują grafiki zawarte w dokumencie i uznają je za
zależności do kompilacji. Używają również standardowych reguł do tworzenia tych plików
z zewnętrznymi programami. Szczegółowe informacje znajdują się w dokumentacji informacyjnej.

hiperref
Obsługuje dodatkowe pliki, które ten pakiet tworzy w niektórych przypadkach.

indeks, makeidx, nomenklat
Przetwarzaj indeksy i nomenklatury dokumentu za pomocą makeindex(1) w razie potrzeby (zob
Sekcja DYREKTYWY dla opcji).

ltxtable
Dodaj zależności dla plików wstawionych przez pakiet ltxtable LaTeX.

minitok, minitoc-hyper
Podczas czyszczenia usuń dodatkowe pliki, które utworzyły częściowe tabele
zawartość

więcejczasownik, dosłownie
Dodaje pliki dołączone do \verbatiminput i podobnych makr do listy
zależności.

multiśliniak
Obsługuje dodatkowe bibliografie tworzone przez ten pakiet i usuwa dodatkowe
pliki dotyczące sprzątania.

xr Dodaj do listy zależności dodatkowe pliki .aux służące do odnośników zewnętrznych,
więc ponowna kompilacja jest automatyczna po zmianie dokumentu odniesienia.

Przetwarzanie wstępne
Poniższe moduły są przeznaczone do korzystania z programów generujących źródła LaTeX z pliku a
inny format pliku:

pajęczyna Celem tego modułu jest uruchomienie tkać(1) w razie potrzeby przed procesem kompilacji do
stworzyć źródło LaTeX. Ten moduł jest ładowany automatycznie, jeśli plik
określony w wierszu poleceń ma .w jako jego sufiks.

lhs2TeX
Ten moduł wykorzystuje lhs2TeX preprocesor do generowania źródła LaTeX z a
Literacki program Haskell. Jest uruchamiany automatycznie, jeśli nazwa pliku wejściowego
kończy się .lhs.

Przetwarzanie końcowe
Następujące moduły służą do obsługi różnych rodzajów przetwarzania końcowego. Notatka
że kolejność ma znaczenie podczas korzystania z tych modułów: jeśli chcesz użyć łańcucha przetwarzania
lubić
foo.tex -> foo.dvi -> foo.ps -> foo.pdf -> foo.pdf.gz
musisz załadować moduły dvipy, ps2pdf oraz gz w tej kolejności, na przykład za pomocą
linii poleceń
guma -p -o ps2pdf -z foo.tex

bzip2 Utwórz wersję pliku końcowego skompresowanego za pomocą bzip2(1).

dvipdfm
Działa dvipdfm(1) na koniec kompilacji w celu wytworzenia dokumentu PDF.

dvipy Działa dvipy(1) na końcu kompilacji, aby utworzyć dokument PostScript. Ten
moduł jest również ładowany przez opcję wiersza poleceń --ps.

rozszerzać Stwórz rozszerzone źródło LaTeX, zastępując makra \input dołączonymi plikami,
makra bibliografii według bibliografii wyprodukowanej przez Bibtex(1) i zajęcia lokalne
i pakiety według ich źródła. Jeśli głównym plikiem jest foo.tex następnie rozszerzony plik
zostanie nazwany foo-final.tex. Szczegółowe informacje znajdują się w dokumentacji informacyjnej.

gz Utwórz wersję pliku końcowego skompresowanego za pomocą gzip(1).

ps2pdf Zakładając, że kompilacja tworzy dokument PostScript (na przykład używając
moduł dvipy), przekonwertuj ten dokument do formatu PDF za pomocą ps2pdf(1).

kompilator wybór
Następujące moduły służą do zmiany kompilatora LaTeX:

Aleph Używa kompilatora Aleph zamiast TeX-a, tzn. kompiluje dokument używając kulawy(1)
zamiast lateks.

omega Użyj kompilatora Omega zamiast TeX-a, tzn. kompiluje dokument za pomocą lambda(1)
zamiast lateks. Jeśli moduł dvipy jest używany, będzie używany odwipy(1) do
przetłumaczyć plik DVI. Należy zauważyć, że ten moduł jest uruchamiany automatycznie, gdy plik
dokument korzysta z pakietu omega.

pdftex Instruuje gumę do użycia pdflateks(1) zamiast lateks(1) skompilować dokument. Przez
domyślnie tworzy to plik PDF zamiast DVI, ale podczas ładowania modułu
z opcją Dvi (na przykład mówiąc -m pdftex: dvi) dokument jest kompilowany
do DVI za pomocą pdflateks. Ten moduł jest również ładowany przez opcję wiersza poleceń
--pdf.

vteks Nakazuje firmie Rubber użycie kompilatora VTeX. Domyślnie to używa vlatex jak
kompilator do tworzenia danych wyjściowych w formacie PDF. Z opcją ps (np. mówiąc „guma -m
vtex:ps foo.tex") używany jest kompilator vlatex a wynikiem jest plik PostScript.

xelatex
Instruuje gumę do użycia xelatex(1) zamiast lateks.

DYREKTYWY

Automatyczne zachowanie Rubber opiera się na wyszukiwaniu makr w źródłach LaTeX.
Gdy to nie wystarczy, można dodać dyrektywy w komentarzach źródeł. A
dyrektywa jest podobna do linii
% gumy: cmd argumenty
Wiersz musi zaczynać się od znaku „%”, następnie dowolna sekwencja znaków „%” i spacji, a następnie tekst
„rubber:”, po którym następują spacje i nazwa polecenia, po których ewentualnie występują spacje i
argumenty.

Ogólne Dyrektywy
alias
Udawaj, że makro LaTeX name1 odpowiada name2. Może to być przydatne, gdy
definiowanie opakowań wokół obsługiwanych makr.

kleń
Wskazuje, że określony plik powinien zostać usunięty podczas czyszczenia za pomocą --czysty.

zależeć
Rozważ określony plik jako zależność, tak aby czas jego modyfikacji wyniósł
sprawdzone.

robić []
Zadeklaruj, że określony plik ma zostać wygenerowany. Opcje mogą określić sposób
powinien zostać wyprodukowany, dostępne są opcje od aby określić źródło
oraz w aby określić regułę konwersji. Na przykład powiedzenie „make foo.pdf
z foo.eps” wskazuje na to foo.pdf powinien być produkowany z foo.eps, z jakimkolwiek
reguła konwersji, która może to zrobić. Zobacz dokumentację informacyjną, aby uzyskać szczegółowe informacje na temat pliku
konwersja.

moduł []
Ładuje określony moduł, prawdopodobnie z opcjami. Jest to równoważne z
opcja wiersza poleceń --moduł.

zmieniamy się
Wykonaj określone polecenie powłoki po kompilacji, jeśli zawartość pliku
określony plik uległ zmianie. Nazwa pliku kończy się na pierwszej spacji.

papier
Określ opcje związane z rozmiarem papieru. Obecnie służą do dawania -t Opcje
do dvipy oraz -p opcje do dvipdfm.

ścieżka
Dodaje określony katalog do ścieżki wyszukiwania dla TeX (i Rubber). Nazwa
katalog to wszystko, co następuje po spacjach po „ścieżce”.

produkować
Deklaruje, że uruchomienie LaTeX utworzy lub zaktualizuje określone pliki.

czytać
Przeczytaj określony plik dyrektyw. Plik musi zawierać jedną dyrektywę na
linia. Puste linie i linie zaczynające się od „%” są ignorowane.

reguły
Przeczytaj dodatkowe reguły konwersji z określonego pliku. Format tego pliku to
to samo co z zasady.ini, zapoznaj się z dokumentacją informacyjną, aby uzyskać szczegółowe informacje.

zestaw
Ustaw wartość zmiennej jako ciąg. Aby uzyskać szczegółowe informacje na temat istniejących zmiennych i
ich znaczenie, patrz dokumentacja informacyjna.

Setlista
Ustaw wartość zmiennej jako (oddzieloną spacjami) listę łańcuchów. Aby uzyskać szczegółowe informacje na temat
istniejące zmienne i ich znaczenie można znaleźć w dokumentacji informacyjnej.

powłoka_ucieczka
Oznacz dokument jako wymagający programów zewnętrznych (shell-escape lub write18). Guma
w rzeczywistości nie włącza tego, chyba że zostanie wywołany z opcją --unsafe.

synteks
Włącz obsługę SyncTeX w uruchomieniu LaTeX.

zegarek
Obserwuj określony plik pod kątem zmian. Jeśli zawartość tego pliku uległa zmianie
po kompilacji uruchamiana jest kolejna kompilacja. Jest to przydatne w
przykładowo w przypadku spisów treści.

Specyficzne dla modułu Dyrektywy
Jeśli polecenie ma postać foo.bar, jest to uważane za polecenie bar dla modułu bla. Jeśli
ten moduł nie jest zarejestrowany, gdy dyrektywa zostanie znaleziona, wtedy polecenie jest ciche
ignorowane. W przypadku standardowych modułów dyrektywy są następujące:

biblatex.ścieżka
Dodaje określony katalog do ścieżki wyszukiwania baz danych BibTeX (plików .bib).

bibtex.odnośniki
Ustaw minimalną liczbę odniesienie wymagane do automatycznego włączenia
pozycja odniesienia na liście cytowań. To ustawia opcję -min-odnośniki jeśli chodzi o komunikację i motywację
powołanie Bibtex(1).

bitex.ścieżka
Dodaje określony katalog do ścieżki wyszukiwania baz danych BibTeX (plików .bib).

bitex.ścieżka stylu
Dodaje określony katalog do ścieżki wyszukiwania stylów BibTeX (plików .bst).

bibtex.narzędzie
Użyj innego narzędzia bibliograficznego zamiast BibTeX.

dvipdfm.opcje
Przekaż określone przełączniki wiersza polecenia do dvipdfm.

dvips.opcje
Przekaż określone przełączniki wiersza polecenia do dvipy.

indeks.narzędzie (indeks)
Określa, które narzędzie ma być używane do przetwarzania indeksu. Obecnie obsługiwane
narzędzia są makeindex(1) (wybór domyślny) i Xindy(1). Argument wskaźnik is
opcjonalne, może służyć do określenia listy indeksów, których dotyczy polecenie.
Jeśli jest obecny, musi być ujęty w nawiasy; lista jest rozdzielana przecinkami.
Gdy argument nie jest obecny, polecenie dotyczy wszystkich indeksów.

język.indeksu (indeks)
Wybiera język używany do sortowania indeksu. Dotyczy to tylko używania
Xindy(1) jako narzędzie indeksujące. Opcjonalny argument ma taką samą semantykę jak
powyżej.

moduły indeksu (indeks) ...
Określ, które moduły mają być używane podczas przetwarzania indeksu Xindy(1). Opcjonalny
argument ma taką samą semantykę jak powyżej.

indeks.kolejność (indeks)
Modyfikuje opcje sortowania indeksów. Argumenty to słowa (oddzielone
spacjami) wśród , Niemiecki oraz list. Dotyczy to tylko używania
makeindex(1). Argument opcjonalny ma taką samą semantykę jak powyżej.

ścieżka.indeksu (indeks)
Dodaje określony katalog do ścieżki wyszukiwania stylów indeksu (plików .ist). The
opcjonalny argument ma taką samą semantykę jak powyżej.

styl.indeksu (indeks)
Określa używany styl indeksu. Argument opcjonalny ma tę samą semantykę
jak powyżej.

makeidx.język, .moduły, .zamówienie, .ścieżka, .styl, .narzędzie
Dyrektywy te są takie same jak dla wskaźnik moduł, z wyjątkiem tego, że nie
zaakceptuj opcjonalny argument.

multibib.odnośniki, .ścieżka, ścieżka stylu, .narzędzie
Dyrektywy te są takie same jak dla Bibtex moduł, ale dotyczą
Bibliografie prowadzone przez multiśliniak pakiet. Najpierw biorą opcję opcjonalną
Argument, z taką samą konwencją jak dla dyrektyw wskaźnik moduł, który
może służyć do określenia listy bibliografii, których dotyczy polecenie.

Korzystaj z gumy online, korzystając z usług onworks.net