ゴム - クラウドでオンライン

プログラム：

NAME

ラバー-LaTeXドキュメントの構築システム

SYNOPSIS

ゴム [オプション] ソース ...
ゴムパイプ [オプション]

DESCRIPTION

Rubberは、LaTeXおよびコンパニオンプログラムのラッパーです。 その目的は、LaTeXが与えられた場合です
処理するソース、すべての参照を解決するのに十分な回数コンパイルする、場合によっては実行する
適切なデータを生成するためのBibTeX、makeindex、Metapostなどの衛星プログラム
ファイル。

コマンド ゴム 指定されたドキュメントを完全にビルドします。 ソースファイルは
LaTeXソース（この場合、接尾辞.texは省略できます）またはドキュメント
formatRubberはLaTeXに変換する方法を知っています。 XNUMXつのコンパイルが失敗した場合、全体
コマンドラインでの次のドキュメントのコンパイルを含むプロセスが停止し、
ゴム ゼロ以外の終了コードを返します。

コマンド ゴムパイプ XNUMXつのドキュメントに対して同じことを行いますが、LaTeXソースを
標準入力であり、コンパイルされたドキュメントを標準出力にダンプします。

一部の情報は、LaTeXソースから抽出できません。 これは、
インスタンス、検索パス（次のような環境変数で指定できます）
TEXINPUTS）、またはMakeindexで使用されるスタイル。 この問題に対処するために、
LaTeXソースのコメントにあるRubberの情報については、セクションを参照してください。 指令.

OPTIONS

オプションは、実行するアクションを選択するか、
構築プロセス。 それらはほとんど同じです ゴム と ゴムパイプ。 オプションが解析されます
GNUGetopt規則を使用します。

-NS、 --bzip2
最終的なドキュメントを圧縮します（ bzip2 フォーマット）。 これは言うことと同じです -o
bzip2 他のすべてのオプションの後。

- 掃除
ドキュメントを作成する代わりに、コンパイルによって生成されたすべてのファイルを削除します。
このオプションはに存在します ゴム それだけ。 コンパイルに適用されます
コマンドラインの他のオプション、つまり「rubber--clean」を使用して実行する
foo」はfoo.psを削除しませんが、「rubber--ps--cleanfoo」は削除します。

-NS、 - 指図
指定されたコマンド（またはディレクティブ）を実行します 入力ファイルの解析。 見る
指令 詳細については。

-e、 - エピローグ
指定されたコマンド（またはディレクティブ）を実行します After 入力ファイルの解析。 見る
指令 詳細については。

-NS、 - 力
ソースの少なくともXNUMXつのコンパイルを強制します。 これは、たとえば、次の場合に役立ちます。
いくつかの異常な依存関係が変更されました（たとえば、システムディレクトリ内のパッケージ）。 これ
オプションは無関係です ゴムパイプ.

-z、 --gzip
最終的なドキュメントを圧縮します（ gzip フォーマット）。 これは言うことと同じです -o gz
他のすべてのオプションの後。

-NS、 - 助けて
使用可能なすべてのオプションのリストを表示して、正常に終了します。

- 所定の位置に
コンパイルする前にソースファイルのディレクトリに移動して、コンパイルするようにします
結果はそれらのソースと同じ場所にあります。

- の中へ
コンパイルする前に指定されたディレクトリに移動して、すべてのファイルが作成されるようにします
そこにあり、現在のディレクトリにはありません。

- 職種名
ベースファイル名とは異なるジョブ名を指定してください。 これにより、の名前が変更されます
出力ファイルであり、最初のターゲットにのみ適用されます。

-k、 - 保つ
このオプションはで使用されます ゴムパイプ それだけ。 このオプションを使用すると、一時ファイル
ドキュメントをコンパイルして結果をにダンプした後は削除されません
標準出力。 一時文書の名前はrubtmpX.texです。ここで、Xは数字です。
その名前のファイルが最初に存在しないように。

-l、 - 風景
最終的なドキュメントで横向きを使用するように指定します。 これは関連しています
使用する場合のみ dvips or dvipdfm.

-NS、 --maxerr
表示されるエラーの最大数を設定します。 デフォルトでは、最大10個のエラーが発生します
報告、言って -n -1 すべてのエラーを表示します。

-NS、 -モジュール [:]
ドキュメントのパッケージに加えて、指定されたモジュールを使用します。 引数は次のようになります
コロンの後に追加してパッケージに渡され、パッケージに対応します
LaTeXのオプション。 モジュールがロードされます ドキュメントのソースを解析します。

- それだけ
指定されたソースのみを含めて、ドキュメントを部分的にコンパイルします。 これは動作します
コマンドラインで\includeonlyへの呼び出しを挿入します。 引数はコンマです-
ファイル名の分離されたリスト。

-o、 - 役職 [:]
指定されたモジュールをポストプロセッサとして使用します。 これはに似ています -m オプション
モジュールがロードされていることを除いて After ドキュメントの解析。

-NS、 --pdf
PDF出力を生成します。 このオプションが後に来るとき --ps （たとえば、フォームで
-pd）それはの同義語です -o ps2pdf、それ以外の場合は、 -m pdftex、使用するために
LaTeXの代わりにpdfLaTeX。

-NS、 --ps
プロセスによって生成されたDVIを処理します dvips（1）PostScriptを作成する
資料。 このオプションはの同義語です -o dvips、後に来ることはできません --pdf.

-NS、 - 静かな
詳細レベルを下げます。 これは逆です -v.

-NS、 - 読んだ
指定されたファイルから追加のディレクティブを読み取ります（ディレクティブ「read」も参照）。

-NS、 --src-スペシャル
コンパイラがサポートしている場合は、ソーススペシャルの生成を有効にします。 これは
変数を設定するのと同じです src-スペシャル 〜へ はい.

-s、 - 短い
LaTeXのエラーメッセージをコンパクトな形式で表示します（XNUMX行にXNUMXつのエラー）。

-私、 --textpath
指定したディレクトリをTeXの検索パスに追加します。

--synctex
LaTeX実行でSyncTeXサポートを有効にします。

-安全ではない
ドキュメントが任意の外部プログラムを呼び出すことを許可します。 これは潜在的に
危険です。このオプションは、信頼できるソースからのドキュメントにのみ使用してください。

-v、 -詳細
詳細レベルを上げます。 0から4までのレベルが存在し、デフォルトのレベルは1です。
for ゴム と0用 ゴムパイプ。 注意して、言って -vvv ラバーにたくさん話させます。

- バージョン
バージョン番号を印刷して、うまく終了します。

-W、 - 暖かい
コンパイル中にエラーが発生しなかった場合は、指定されたタイプの情報を報告します。 The
使用可能なタイプは次のとおりです。 ボックス （オーバーフルおよびアンダーフルボックス）、 ヒント （未定義または
多重定義された参照）、 miscの （その他の警告）および を すべての警告を報告します。

モジュール

ラバーの動作はモジュールの影響を受けます。 モジュールは、の特定の機能を処理します
パッケージと外部プログラム。

パッケージ
ドキュメントが使用するすべてのパッケージについて、Rubberは同じ名前のモジュールを探します。
LaTeXによるコンパイルとは別に、このパッケージに必要なタスクを実行します。
モジュールをデフォルトで提供されているモジュールに追加して、新しい機能を含めることができます（これは
モジュールシステムのポイント）。 標準モジュールは次のとおりです。


LaTeXパッケージによって生成された.asyファイルを処理してから、
再コンパイル。

プロジェクター このモジュールは、他の目次と同じ方法でBeamerの追加ファイルを処理します。

bibtex、 ビブラテックス
必要に応じて、BibTeXを使用してドキュメントの参考文献を処理します。 これ
ドキュメントにマクロ\bibliographyが含まれている場合、モジュールは自動的にロードされます
（も参照してください 指令 オプションについて）。

組み合わせる
結合パッケージは、複数のLaTeXドキュメントをXNUMXつにまとめるために使用されます。
この場合、このモジュールは依存関係を処理します。

エプスフィグ このモジュールは、古いスタイルを使用するドキュメントのグラフィックインクルードを処理します
\psfigマクロ。 これは実際にはグラフィックモジュールのインターフェイスです。これを参照してください
詳細については。

用語集
makeglossariesを実行し、.gloファイルが変更されたときに再コンパイルします。

グラフィックス、 graphicsx
これらのモジュールは、ドキュメントに含まれているグラフィックを識別し、それらを次のように見なします
コンパイルの依存関係。 また、これらのファイルを作成するために標準のルールを使用します
外部プログラムで。 詳細については、情報ドキュメントを参照してください。

ハイパーリファレンス
このパッケージが生成する余分なファイルを処理する場合があります。

インデックス、 makeidx、 命名法
ドキュメントのインデックスと命名法を次のように処理します メイクインデックス（1）必要な場合（を参照）
指令 オプションについて）。

ltxtable
ltxtableLaTeXパッケージを介して挿入されたファイルの依存関係を追加します。

minitoc、 minitoc-ハイパー
クリーニング時に、の部分的なテーブルを作成するために生成された追加のファイルを削除します
内容。

moreverb、 逐語的
\verbatiminputおよび同様のマクロに含まれるファイルをのリストに追加します
依存関係。

マルチビブ
このパッケージが作成する余分な参考文献を処理し、余分なものを削除します
クリーニングに関するファイル。

xr 外部参照に使用される追加の.auxファイルを依存関係のリストに追加します。
したがって、参照されるドキュメントが変更されると、再コンパイルは自動的に行われます。

前処理
次のモジュールは、からLaTeXソースを生成するプログラムを使用するために提供されています。
異なるファイル形式：

クウェブ このモジュールの目的は実行することです 編む（1）必要に応じて、コンパイルプロセスの前に
LaTeXソースを生成します。 このモジュールは、ファイルがあれば自動的にロードされます
コマンドラインで指定された .w その接尾辞として。

lhs2TeX
このモジュールは lhs2TeX からLaTeXソースを生成するプリプロセッサ
識字能力のあるHaskellプログラム。 入力ファイルの名前があれば自動的にトリガーされます
で終わる .lhs.

後処理
次のモジュールは、さまざまな種類の後処理をサポートするために提供されています。 ノート
これらのモジュールを使用する場合は、順序が重要です。処理チェーンを使用する場合
ような
foo.tex-> foo.dvi-> foo.ps-> foo.pdf-> foo.pdf.gz
モジュールをロードする必要があります dvips, ps2pdf と gz この順序で、たとえば、
コマンドライン
ラバー-p-ops2pdf -z foo.tex

bzip2 で圧縮された最終ファイルのバージョンを作成します bzip2とします。

dvipdfm
Active Runs dvipdfm（1）コンパイルの最後にPDFドキュメントを作成します。

dvips Active Runs dvips（1）コンパイルの最後にPostScriptドキュメントを作成します。 これ
モジュールはコマンドラインオプションによってもロードされます --ps.

拡張 \ inputマクロをインクルードされたファイルに置き換えて、拡張されたLaTeXソースを生成します。
によって作成された参考文献による参考文献マクロ ビブテックス（1）、およびローカルクラス
およびソース別のパッケージ。 メインファイルが foo.tex 次に展開されたファイル
名前が付けられます foo-final.tex。 詳細については、情報ドキュメントを参照してください。

gz で圧縮された最終ファイルのバージョンを作成します gzipとします。

ps2pdf コンパイルによってPostScriptドキュメントが生成されると仮定します（たとえば、
モジュール dvips）、を使用してこのドキュメントをPDFに変換します ps2pdfとします。

コンパイラ 選択
LaTeXコンパイラを変更するには、次のモジュールを使用します。

アレフ TeXの代わりにAlephコンパイラを使用します。つまり、を使用してドキュメントをコンパイルします。 ラメド(1)
ラテックス.

オメガ TeXの代わりにOmegaコンパイラを使用します。つまり、を使用してドキュメントをコンパイルします。 ラムダ(1)
ラテックス。 モジュールの場合 dvips も使用されます、それは使用します odvips（1）〜
DVIファイルを翻訳します。 このモジュールは、
ドキュメントはパッケージを使用します オメガ.

pdftex ラバーに使用を指示します pdflatex（1）の代わりに ラテックス（1）ドキュメントをコンパイルします。 に
デフォルトでは、これはDVIの代わりにPDFファイルを生成しますが、モジュールをロードするとき
オプション付き dvi （例えば、 -m pdftex：dvi）ドキュメントがコンパイルされます
を使用してDVIに pdflatex。 このモジュールは、コマンドラインオプションによってもロードされます
--pdf.

ヴテックス VTeXコンパイラを使用するようにRubberに指示します。 デフォルトでは、これは ヴラテックス として
PDF出力を生成するコンパイラ。 オプション付き ps （例：「rubber-m
vtex：ps foo.tex "）使用されるコンパイラは vlatex 結果はPostScriptファイルです。

ゼラテックス
ラバーに使用を指示します ゼラテックス（1）の代わりに ラテックス。

指令

Rubberの自動動作は、LaTeXソースでのマクロの検索に基づいています。
これだけでは不十分な場合は、ソースのコメントにディレクティブを追加できます。 A
ディレクティブは次のような行です
％ゴム：cmd args
行は「％」で始まり、次に「％」記号とスペースのシーケンス、そしてテキストで始まる必要があります
「rubber：」の後にスペースとコマンド名が続き、場合によってはスペースとコマンド名が続く
引数

ディレクティブ
alias
LaTeXマクロのふりをする name1 に相当します name2。 これは、次の場合に役立ちます。
サポートされているマクロのラッパーを定義します。


を使用してクリーニングするときに、指定されたファイルを削除する必要があることを示します - 掃除.

決まる
指定されたファイルを依存関係と見なし、その変更時刻が次のようになるようにします。
チェックしました。

make []
指定されたファイルを生成する必要があることを宣言します。 オプションで方法を指定できます
作成する必要があり、利用可能なオプションは次のとおりです。 from ソースを指定します
と 　 変換ルールを指定します。 たとえば、「foo.pdfを作成する
from foo.eps」は、 foo.pdf から生成する必要があります foo.eps、任意の
それを行うことができる変換ルール。 ファイルの詳細については、情報ドキュメントを参照してください
変換。

モジュール []
指定されたモジュールを、場合によってはオプションとともにロードします。 これは、
コマンドラインオプション -モジュール.

変化する
の内容が
指定されたファイルが変更されました。 ファイル名は最初のスペースで終わります。

紙
用紙サイズに関連するオプションを指定します。 現在、それらは与えるために使用されています -t オプション
〜へ dvips と -p オプション dvipdfm.

path
指定したディレクトリをTeX（およびRubber）の検索パスに追加します。 の名前
ディレクトリは、「パス」の後のスペースに続くすべてのものです。

作り出す
LaTeXの実行により、指定されたファイルが作成または更新されることを宣言します。

read
指定されたディレクティブのファイルを読み取ります。 ファイルには、ごとにXNUMXつのディレクティブが含まれている必要があります
ライン。 空の行と「％」で始まる行は無視されます。

ルール
指定されたファイルから追加の変換ルールを読み取ります。 このファイルの形式は次のとおりです。
と同じ ルール.ini、詳細については、情報ドキュメントを参照してください。

セッションに
変数の値を文字列として設定します。 既存の変数の詳細と
それらの意味については、情報ドキュメントを参照してください。

セットリスト
変数の値を（スペースで区切られた）文字列のリストとして設定します。 詳細については
既存の変数とその意味については、情報ドキュメントを参照してください。

シェルエスケープ
ドキュメントに外部プログラム（shell-escapeまたはwrite18）が必要であることを示します。 ゴム
オプション--unsafeで呼び出されない限り、実際にはこれを有効にしません。

シンクテックス
LaTeX実行でSyncTeXサポートを有効にします。

watch
指定されたファイルの変更を監視します。 このファイルの内容が変更された場合
コンパイル後、別のコンパイルがトリガーされます。 これは、
たとえば、目次の場合。

モジュール固有 ディレクティブ
コマンドの形式が foo.bar、コマンドと見なされます バー モジュール用 foo。 場合
ディレクティブが見つかったときにこのモジュールは登録されず、コマンドはサイレントに送信されます
無視されます。 標準モジュールの場合、ディレクティブは次のとおりです。

ビブラテックスパス
指定したディレクトリをBibTeXデータベース（.bibファイル）の検索パスに追加します。

bibtex.crossrefs
の最小数を設定します 相互参照 自動包含に必要
引用リストの参照エントリ。 これはオプションを設定します -min-crossrefs いつ
呼び出し ビブテックスとします。

ビブテックス.パス
指定したディレクトリをBibTeXデータベース（.bibファイル）の検索パスに追加します。

ビブテックス.スタイルパス
指定したディレクトリをBibTeXスタイル（.bstファイル）の検索パスに追加します。

ビブテックスツール
BibTeXの代わりに別の参考文献ツールを使用してください。

dvipdfm.options
指定されたコマンドラインスイッチをに渡します dvipdfm.

dvips.オプション
指定されたコマンドラインスイッチをに渡します dvips.

索引ツール （インデックス）
インデックスの処理に使用するツールを指定します。 現在サポートされている
ツールは メイクインデックス（1）（デフォルトの選択）および シンディ（1）。 議論 index is
オプションで、コマンドが適用されるインデックスのリストを指定するために使用できます。
存在する場合は、括弧で囲む必要があります。 リストはコンマで区切られます。
引数が存在しない場合、コマンドはすべてのインデックスに適用されます。

索引.言語 （インデックス）
インデックスの並べ替えに使用する言語を選択します。 これは、使用する場合にのみ適用されます
シンディ（1）インデックス作成ツールとして。 オプションの引数は、と同じセマンティクスを持ちます
上記。

インデックス.モジュール （インデックス） ..。
インデックスを処理するときに使用するモジュールを指定します シンディ（1）。 オプション
引数のセマンティクスは上記と同じです。

インデックス順 （インデックス）
インデックスの並べ替えオプションを変更します。 引数は単語です（分離されています
スペースで） 標準, ドイツ人 と 手紙。 これは、使用する場合にのみ適用されます
メイクインデックス（1）。 オプションの引数のセマンティクスは上記と同じです。

インデックス.パス （インデックス）
指定したディレクトリをインデックススタイル（.istファイル）の検索パスに追加します。 The
オプションの引数のセマンティクスは上記と同じです。

インデックス.スタイル （インデックス）
使用するインデックススタイルを指定します。 オプションの引数のセマンティクスは同じです
上記のように。

makeidx.language、 .modules、 。注文、 。道、 。スタイル、 。道具
これらのディレクティブは、 index モジュール、ただし、そうではない
オプションの引数を受け入れます。

multibib.crossrefs、 。道、 .stylepath、 。道具
これらのディレクティブは、 ビブテックス モジュールが適用されます
によって管理される書誌 マルチビブ パッケージ。 彼らは最初にオプションを取ります
引数、のディレクティブと同じ規則 index モジュール、これ
コマンドが適用される参考文献のリストを指定するために使用できます。

onworks.net サービスを使用してオンラインでラバーを使用する