Rabbit - rabbitコマンドの使い方

起動モード

Rabbitはコマンドラインから起動する方法とコマンドランチャーから起動する方法（例えば、ダブルクリックで起動する方法）があります。どちらもrabbitコマンドを使うことになります。

コマンドライン

コマンドラインから起動する場合は引数にスライドを書いたファイルを指定してください。

% rabbit XXX.rd

例えば、XXX.rd の内容はこのようになっています。

= タイトル

:author
  発表者名

= 1ページ目

ここは内容

= 2ページ目

おしまい

sample/rabbit-implementation.rdを使うには、トップのディレクトリで以下のようにします。

% rabbit sample/rabbit-implementation.rd

ただし、いくつかのサンプルは、テーマがsample/rabbit/theme以下にあるためトップからではうまく表示できないかもしれません。サンプルの実行は sample ディレクトリに入ってするとよいでしょう。

WindowsユーザならRDファイルをbin/rabbit.batにドラッグアンドドロップしてもよいです。

あるいは、*.rd（とか*.rab（Rabbitの略））を

<rubyをインストールしたフォルダ>\bin\rubyw -S rabbit

に関連付けて、RDファイルをダブルクリックすることで起動することもできます。

オプション

-t, --theme=THEME

テーマを指定します。

-I, --include=PATH

ロードパスを追加します。ロードパスはテーマの検索などにも使用されます。

--comment-theme=THEME

コメント用のテーマを指定します。現在利用可能なテーマはスライド下部にコメントを表示するfooter-comment（デフォルト）と、スライド上にコメントを流すstream-commentです。

--allotted-time=TIME

プレゼン時間を指定します。タイトルスライドにメタデータとして指定したプレゼン時間よりも優先されます。

-B, --base=BASE

入力ソース中の相対パス（例えば画像へのパス）を解決するためのURIまたはパスを指定します。省略した場合は入力ソースの種類に応じて自動的に決定されます。

-T, --type=TYPE

入力ソースの種類を指定します。

入力ソースの種類は file（デフォルト）, argf, uri のいずれかを指定します。

argf

入力ソースとしてARGFを利用します。つまり，標準入力からソースを入力することも出来ます。

ソースの自動再読み込み機能は利用できません。

例:

% rabbit --type argf file1.rd file2.rd ...

とか

% cat file1.rd file2.rd ... | rabbit --type argf

とか

% rabbit --type argf
= title
...
^D

とか

file

デフォルト。つまり--type fileは省略可。

指定したファイルからソースを取得します。

ソースの自動再読み込み機能を利用できます。

例:

% rabbit --type file file.rd

uri

指定したURIからソースを取得します。

ソースの自動再読み込み機能を利用できますが、パフォーマンスなどを考慮して、最後にソースを読み込んでから一定時間（現在は60秒）以上たたないとたとえソースが変更されていてもソースを再読み込みしません。

例:

% rabbit --type uri https://raw.github.com/rabbit-shocker/rabbit/master/sample/rabbit-implementation.rd

とか

% rabbit --type uri ftp://.../XXX.rd

とか

ちなみに、

% rabbit --type uri file:///.../XXX.rd

とか

% rabbit --type uri /.../XXX.rd

とかは

% rabbit --type file /.../XXX.rd

と同じ

memory

ソースをメモリ上に置いて管理します。このタイプではdRuby やSOAPなどのインターフェイスを用いてソースの内容を書き換えることができます。

初期ソースはファイル名を指定して、そのファイルの内容を与えることができます。

例（初期ソースなし）:

% rabbit --type memory

例（初期ソースあり）:

% rabbit --type memory file.rd

-e, --encoding=ENCODING

入力ソースのエンコーディングを指定します。

指定しなかった場合は自動検出を試みます。

-f, --full-screen, --no-f, --no-full-screen

フルスクリーンモードで起動するかどうかを指定します。

デフォルトではフルスクリーンモードにはなりません。

--index-mode, --no-index-mode

一覧モードで起動するかどうかを指定します。

デフォルトでは一覧モードにはなりません。

-w, --width=WIDTH

ウィンドウの幅を指定します。

デフォルトは800です。

-h, --height=HEIGHT

ウィンドウの高さを指定します。

デフォルトは600です。

-S, --size=WIDTH,HEIGHT

ウィンドウの高さと幅を指定します。

-s, --save-as-image

各スライドを画像として保存し，終了します。

-i, --saved-image-type=TYPE

保存される画像の種類を指定します。

例えば，png（デフォルト）とかjpegとか。

-b, --saved-image-base-name=BASE_NAME

保存される画像のファイルのベース名を指定します。保存される画像の名前は"#{ベース名}#{ページ番号}.#{拡張子}"となります。

デフォルトはスライドのタイトルです。

もし、ファイルシステムのエンコーディングがUTF-8ではないのに、ファイル名がUTF-8で保存される場合は、環境変数LANGとか G_FILENAME_ENCODINGとかを設定するとよいかもしれません。

--output-html, --no-output-html

保存されたスライドを表示するHTMLを生成するかどうかを指定します。

デフォルトでは生成しません。

--output-index-html, --no-output-index-html

保存されたスライドのサムネイルを表示するHTMLを生成するかどうかを指定します。

デフォルトでは生成しません。

-p, --print

スライドを印刷し，終了します。--output-filenameを指定することによりファイルに印刷したり、プリンタに直接印刷することもできます。

ただし，現在のところ，あまり品質はよくありません。

-o, --output-filename=FILENAME

印刷ファイル名を指定します。印刷フォーマットは拡張子により決定します。拡張子が.psの場合はPostScript形式で，.pdfの場合はPDF形式で出力します。それ以外の場合はPostScript形式で出力します。

"|プログラム名"とすると、PostScript形式の出力をプログラムに渡します。

デフォルトは"#{スライドのタイトル}.ps"です。

--paper-width=WIDTH

印刷時の用紙幅を指定します。用紙幅の単位はinchです。

デフォルトは横置きA4の幅です。

--paper-height=HEIGHT

印刷時の用紙の高さを指定します。用紙の高さの単位はinchです。

デフォルトは横置きA4の高さです。

--paper-size=WIDTH,HEIGHT

印刷時の用紙の高さと幅を指定します。用紙の高さと幅の単位はinchです。

デフォルトは横置きA4です。

--slides-per-page=SLIDES

1ページに何枚のスライドを入れて印刷するかを指定します。

デフォルトは1枚です。

--margin={全部|上下,左右|上,左右,した|上,右,下,左}, --margin-*=MARGIN

1ページに複数枚のスライドを印刷する時のスライドの周りの余白を指定します。

デフォルトではスライドの枚数に応じて調節しますが、2枚と8 枚以外の時はあまりうまくありません。

--page-margin={全部|上下,左右|上,左右,した|上,右,下,左}, --page-margin-*=MARGIN

印刷時のページの余白を指定します。

デフォルトでは余白はとられません。

--locale-dir=DIR

ロケール用データ（*.mo）を置くためのディレクトリを指定します。Rabbitをシステムにインストールせずに使う場合は Rabbitのトップディレクトリで以下のようにします。

% ruby -I./lib bin/rabbit --locale-dir data/locale sample/rabbit.rd

デフォルトでは/usr/local/share/locale/や /usr/share/locale/あたりが使われます。

--logger-type=TYPE

エラーログをどのように出力するかを指定します。guiを指定するとエラーログはダイアログボックスに表示されます。rabbit の起動オプションを解析するときにエラーが起こることもあるので、--logger-typeはオプションの先頭で指定することをお薦めします。

% rabbit --logger-type gui ...

デフォルトはstderrで標準エラー出力に表示されます。

--use-druby, --no-use-druby

dRubyインターフェイスを使うかどうかを指定します。

デフォルトでは使います。

--druby-uri=URI

dRubyインターフェイスのURIを指定します。

デフォルトではdruby://:10101です。

--output-druby-uri, --no-output-druby-uri

dRubyインターフェイスのURIを表示するかどうかを指定します。

デフォルトでは表示しません。

--use-soap, --no-use-soap

SOAPインターフェイスを使うかどうかを指定します。

デフォルトでは使いません。

--soap-host=HOST

SOAPインターフェイスのホストを指定します。

デフォルトでは0.0.0.0です。

--soap-port=PORT

SOAPインターフェイスのポートを指定します。

デフォルトでは10103です。

--use-xmlrpc, --no-use-xmlrpc

XML-RPCインターフェイスを使うかどうかを指定します。

デフォルトでは使いません。

--xmlrpc-host=HOST

XML-RPCインターフェイスのホストを指定します。

デフォルトでは0.0.0.0です。

--xmlrpc-port=PORT

XML-RPCインターフェイスのポートを指定します。

デフォルトでは10104です。

--server, --no-server

サーバとして起動するかを指定します。

デフォルトではサーバとして起動しません。

--public-level=LEVEL

外部インターフェイス（dRuby/XML-RPC/SOAP経由）にRabbitの機能をどのくらい公開するかを指定します。公開レベルは strict, move, read-size, change-size, size, read-source, change-source, source, allから選びます。後ろに挙げた公開レベルほど多くの機能を公開します。

デフォルトではstrictです。

--comment-source=FILE