Bundloc - クラウド上のオンライン

プログラム：

NAME

bundleoc - LaTeX ドキュメントに必要なすべてのファイルをバンドルします

SYNOPSIS

バンドルック [- バージョン] [ - 助けて] [--[いいえ]詳細] [--texfile=file] [- ディレクトリ=ディレクトリにジョブを開始します。]
[--[いいえ]ローカルのみ] [-除外する=文字列] [- 含む=ファイルスペック] [-マニフェスト=file]
[--listdeps=[はい|いいえ|のみ|関係]...] [--[いいえ]キープディレクトリ] [--config=file] .dep file

DESCRIPTION

バンドルック のポストプロセッサです スナップショット すべてをまとめたパッケージ
特定の LaTeX ドキュメントを構築するために必要なクラス、パッケージ、およびファイル。 それは、 .dep
そのファイル スナップショット そこに記載されている各ファイルを作成、検索し、パッケージ化します。
単一のアーカイブ ファイル (例: .tar.gz ファイル)、システム間での移動に適しています。
同僚に送信するなど。

最も単純な例として、次のような LaTeX ファイルを考えてみましょう。 こんにちは.tex:

\RequirePackage{snapshot} % Bundloc に必要
\documentclass[11pt]{記事}

\ {文書}を開始します
こんにちは、世界！
\エンド{文書}

「\RequirePackage{スナップショット}」により、 こんにちは。 生成されるファイル。 いつ バンドルック is
次に、引数として「hello.dep」を指定すると、依存ファイルを見つけます。 スナップショット.sty,
記事.cls, サイズ11.clo -- そしてそれらを XNUMX つのアーカイブ ファイルにバンドルします。
こんにちは.tex フォルダーとその下に マニフェスト ファイル (下記の「オプション」で説明)。

OPTIONS

以下の説明では、 何らかのファイル メインの LaTeX ドキュメントの名前を指します (いいえ)
拡大）。

バンドルック によって生成された依存関係ファイルの名前が必要です スナップショット （通常は
somefile.dep）。 次のオプションも指定できます。

- バージョン
出力 バンドルック スクリプトのバージョン番号。 これは残りのすべてをオーバーライドします
オプション。

- 助けて
簡単な使用方法のメッセージを入力します。 これは残りのオプションをすべてオーバーライドします。

--[いいえ]詳細 (デフォルト:「ノーボーズ」)
バンドルック 通常はエラーメッセージ以外は何も出力しません。 「--verbose」を使用すると、
大量のステータス メッセージが出力されます。

--texfile=メイン .tex file （ディフォルト： somefile.tex)
スナップショットの依存関係ファイルには、メインの LaTeX ファイル (渡されるファイル) がリストされていません。
〜へ ラテックス）。 のために バンドルック そのファイルを見つけてバンドルするには、 バンドルック それを想定している
と同じ名前です スナップショット 依存関係ファイルですが、 .tex 拡大。 これなら
そうでない場合は、「--texfile」を使用して正しいファイル名を指定します。

- ディレクトリ=アーカイブ ディレクトリにジョブを開始します。 （ディフォルト： 何らかのファイル)
日時 バンドルック アーカイブを作成します (例: 。タール or .zip ファイル）を含む
ドキュメントのファイルを作成すると、現在のファイルが乱雑になるのを避けるために、すべてのファイルがディレクトリに配置されます。
ファイルのあるディレクトリ。 指定された依存関係ファイルが呼び出された場合 somefile.dep そうして
結果として得られるアーカイブは、デフォルトで、すべての依存ファイルを 何らかのファイル
ディレクトリ。 ディレクトリ名を変更するには、「--directory」オプションを使用します。

--[いいえ]ローカルのみ (デフォルト: "nolocalonly")
しかし バンドルック 通常、 で指定されたすべてのファイルをアーカイブします。 .dep ファイル、
「--localonly」オプションにより、 バンドルック other ディレクトリにあるすべてのファイルを除外するには
より .tex ファイルのディレクトリまたはそのサブディレクトリの XNUMX つ。

-除外する=文字列 （ディフォルト： なし)
「--localonly」を指定すると、ファイルが外部に存在します。 .tex ファイルのディレクトリツリーは
アーカイブから省略される場合、「--exclude」を使用すると、ファイルをより詳細に制御できます。
アーカイブからは省略します。 「--exclude」オプションは、繰り返し指定できます。
コマンドラインでは、名前に次のものが含まれるすべてのファイルが発生します。 文字列 から省略される
アーカイブ。

- 含む=ファイルスペック （ディフォルト： なし)
コマンドラインで繰り返し指定できる「--include」オプションは、
指示する バンドルック 一致するすべてのファイルをアーカイブに含めるには ファイルスペックでも、
で参照されていない場合は、 .dep ファイルにソフトウェアを指定する必要があります。

-マニフェスト=マニフェスト file （ディフォルト： マニフェスト)
依存ファイルに加えて、 バンドルック アーカイブ ファイルには追加のものが XNUMX つ含まれています
ファイルの名前はデフォルトで ``マニフェスト''。 マニフェスト をリストしたテキスト ファイルです。
すべての依存関係の元のファイル名。 ファイル名を「」から変更するにはマニフェスト''
他のものにするには、「--manifest」オプションを使用します。 特殊な場合として、「--manifest=""」
伝える バンドルック マニフェスト ファイルをまったく含めないでください。

--listdeps=[はい|いいえ|のみ|レル]...] (デフォルト: "いいえ")
「--listdeps」は、「yes」、「no」、「only」、または「rel」の XNUMX つ以上をカンマ区切りで受け入れます。
リスト。 このリストに「いいえ」が表示されない限り、 バンドルック メインのすべてを出力します
LaTeX ファイルの依存関係。 リストに「rel」が含まれている場合、 バンドルック 出力
相対パス名を持つ依存関係のリスト。 リストに「のみ」が含まれている場合、
バンドルック リストを表示した後、アーカイブを作成せずに終了します。

--[いいえ]キープディレクトリ (デフォルト: "nokeepdirs")
通常、アーカイブ ファイルは、 バンドルック 生成されるディレクトリには単一のディレクトリが含まれます -- そして
ドキュメントが明示的にサブディレクトリを参照している場合、そのサブディレクトリにはすべての
依存ファイルは嘘をつきます。 「--keepdirs」を指定すると、依存ファイルがすべて保存されます。
元のパス名で。 たとえば、次の場合 somefile.tex に依存します
フィギュア/somefigure.eps, 記事.cls, スナップショット.sty、 そうして 何らかのファイル アーカイブします
通常、次のファイルが含まれています。

· サムファイル/サムファイル.tex

· somefile/figures/somefigure.eps

· somefile/article.cls

· somefile/snapshot.sty

· 何らかのファイル/マニフェスト

ただし、「--keepdirs」を使用すると、 何らかのファイル 次の種類を含むアーカイブ
代わりにファイル名を指定します:

· ホーム/私/mydocs/somefile.tex

· ホーム/私/mydocs/図/somefigure.eps

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

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

「--keepdirs」が有効な場合、「--directory」は使用されません。 また、マニフェストはありません
ファイルには冗長な情報が含まれているため、アーカイブ ファイルに書き込まれます。

--config=の監視 file （デフォルト： )
「--config」オプションは、次の点を指定するために使用されます。 バンドルック 適切な構成に
(.cfgの) TeX ディストリビューションおよびオペレーティング システム用のファイル。 バンドルック 付属しています
設定ファイルはほとんどないので、さらに書き込むのは簡単です。 「設定ファイル」を参照してください。
構成ファイル形式の説明については (下記) を参照してください。

CONFIGURATION ファイル

フォーマット
設定ファイルは非常に単純な形式に従います。 「#」で始まる行はコメントです。
空白行は無視されます。 他のすべての行は次の形式になります。

変数: 値

の現在のバージョン バンドルック 次の変数を認識します。

バンドル
一連のファイルを単一のアーカイブ ファイルにバンドルするために使用するコマンド

シンク
出力を破棄するコマンドの接辞

find
TeX ツリー内でファイルを検索するコマンド。

XNUMX 行に長すぎる値は、「\」を使用して複数行に分割できます。
行継続記号。

環境変数は XNUMX つあります。 バンドルック が使用できるようにします
設定ファイルコマンド:「BDBASE」、これは次のように設定されます。 何らかのファイル (「オプション」のように)、および
「BDINPUTS」。コマンドが操作するファイルのスペース区切りのリストに設定されます。
その上。 つまり、「bundle」に関連付けられたコマンドが実行されているとき、「BDINPUTS」には次の内容が含まれます。
アーカイブされるすべてのファイルのリスト。 対照的に、コマンドが
「find」に関連付けられたファイルが実行されている場合、「BDINPUTS」には検索するファイルの名前が含まれています。

例
次の構成ファイルは、 バンドルックのさまざまなデフォルト値
構成ファイル変数。kpathsea ベースの TeX ディストリビューションの実行を表します。
汎用 Unix システム上では、次のような GNU ツールが必ずしも備わっているわけではありません。
gzip またはGNU tar:

# 「デフォルト」設定ファイル
# スコット・パキン著[メール保護]>

バンドル: (tar -cvf - $BDINPUTS | 圧縮 > $BDBASE.tar.Z)
シンク: > /dev/null 2>&1
検索: kpsethat -progname=latex $BDINPUTS

「bundle:」行のかっこは、Unix シェルにコマンドを実行するように指示します。
サブシェル。 これは、「sink:」接辞が適切に機能するようにするためです（つまり、接辞が XNUMX つ存在しないようにします）
">" は同じコマンド内にあります)。

コマンドが「BDBASE」と「BDINPUTS」を他の環境変数と同様にどのように扱うかに注目してください。
Unix シェルでは、「$」を使用して値を取得します。 他のオペレーティング システムでは異なる使用法が使用されます
環境変数を参照するための規則。 たとえば、設定ファイル
Windows ベースの TeX ディストリビューションの場合は、代わりに「%BDBASE%」と「%BDINPUTS%」を使用します。

「sink:」の値はオペレーティング システムに固有です。 「find:」の値は次のとおりです。
TeX ディストリビューションに特有のものです。 「bundle:」はカスタマイズの可能性が最も高い場所です
嘘。 「bundle:」を使用して、好みのアーカイブ形式を指定できます。 たとえば、あなたは
Unix 上では次のような shar ファイルを生成できます。

バンドル: (shar --archive-name="$BDBASE" $BDINPUTS > $BDBASE.sh)

または、Microsoft Windows 上の次のような CAB ファイル。

バンドル: cabarc -r -p N %BDBASE%.cab %BDINPUTS%

例

と仮定する myfile.dep から生産されました myfile.tex の指示に従って、
説明セクション。 次のコマンドは、 .zip MikTeX TeXを使用したファイル
Microsoft Windows 上で実行されるディストリビューション:

bundleoc --config=miktex.cfg myfile.dep

(実際には、おそらく完全なパスを「--config」に指定する必要があります。
バンドルック's ミクテックス.cfg 設定ファイル。）

以下は、 .tar.gz Unix 上で実行される TeX Live ディストリビューションを使用したアーカイブ -
オペレーティングシステムのようなもの。 バンドルック その操作を説明する詳細な出力が生成されます。
同じディレクトリ ツリー内にないすべてのファイル myfile.tex 「.fd」を含むすべてのファイルまたは
名前の「.sty」は省略されています。 ただし、すべて .よだれかけ 現在のディレクトリ内のファイルは、
どれも参照されていない場合でも、アーカイブに含めることができます。 myfile.dep.
最後に、 マニフェスト ファイルが作成されます。

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

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