ToshioCP/LaTeX-BuildTools

Rubyl script for building a (big) book using LaTeX system.

日本語の説明はこのファイルの後半にあります。

LaTeX Build Tools

LaTeX Build Tools is a tool to manage big LaTeX source files. This version is different from the old versions.

• Use lbt command to run every sub commands.
• It is provided as a gem, which is a Ruby library program.

The old versions, the one with rake and the other of bash scripts, are moved to the other branches, rake_version and bash respectively.

LaTeX Build Tools supports LuaLaTeX engine only. If you want to use another engine, you need to modify lib/lbt/build.rb and lib/lbt/part_typeset.rb.

Prerequisite

• Linux operating system
• Ruby. You can install it by one of the followings.
  • Install the distribution package
  • Install it with rbenv. Refer to Rbenv's GitHub repository
• LuaLaTeX. You can install it by one of the followings.
  • Install the distribution package
  • Install TexLive. Refer to TexLive website

Installation

You can install lbt from RubyGems.org with gem command.

$ gem install lbt

If you want to install it from the source code, do the following.

1. Click the Code button, then click Download ZIP in the small dialog.
2. Unzip the downloaded Zip file, then a new directory LaTeX-BuildTools-master will be created.
3. Type gem build lbt under the directory, then the gem file lbt-X.X.X.gem is created. The number X.X.X is the version number like 0.5.2.
4. Type gem install lbt-X.X.X.gem, where X.X.X is the version number.

Document

See Tutorial.en.

License

GPL. See License.md.

---

LaTeX Build Tools

LaTeX Build Toolsは大きなLaTeXソースファイルを管理するためのツールです。 現在の版は次の2点が旧版と異なっています。

• lbtというコマンドからすべてを起動
• gem（Rubyのライブラリ・プログラム）として提供される

旧版の、rakeを用いる版とbashスクリプト版は、それぞれrake_versionブランチとbashブランチに移動しました。

LaTeX Build ToolsがサポートするLaTeXエンジンはLuaLaTeXです。 その他のエンジンを使いたい場合はlib/lbt/build.rbとlib/lbt/part_typeset.rbの修正が必要です。

動作条件

• Linux オペレーティング・システム
• Ruby。Rubyのインストール方法は次の2通りがある
  • ディストリビューションのパッケージをインストール
  • Rbenvを用いてインストール。詳しくはRbenvのGitHubレポジトリを参照してほしい
• LuaLaTeX。LuaLaTeXのインストール方法は次の2通りがある
  • ディストリビューションのパッケージをインストール
  • TexLiveをインストール。詳しくはTexLiveのウェブサイトを参照してほしい

インストール

gemコマンドでRubyGems.orgからlbtをインストールする。

$ gem install lbt

以上が最も簡単なインストール方法だが、ソースコードからインストールしたい場合は次のようにする。

1. GitHubのレポジトリを開きCodeボタンをクリック。小さいダイアログが現れるので、Download ZIPをクリックする
2. ZIPファイルを解凍するとLaTeX-BuildTools-masterというディレクトリが作られる
3. 端末をそのディレクトリに移動してgem build lbtとタイプすると、lbt-X.X.X.gemというGemファイルが作られる。 この中のX.X.Xはバージョン番号で、例えば0.5.2などのようなものである
4. gem install lbt-X.X.X.gemとタイプしてインストールする（X.X.Xはバージョン番号）

ドキュメント

使い方の説明はTutorial.jaを参照してほしい。

ライセンス

GPL。License.mdを参照。