rabbit-qt 0.1.0

data/doc/index.html.en

@@ -0,0 +1,58 @@
+---
+layout: en
+title: A presentation tool for Rubyist
+lang_suffix: true
+no_sidebar: true
+---
+<div class="latest-release">
+  <p><a href="/en/news.html">{{ site.version }}</a> is the latest release. It was released on {{ site.release_date }}.</p>
+</div>
+
+<section id="screenshots">
+  <h2>Screenshots</h2>
+  <ul>
+    <li><img src="images/screenshots/en/blue-circle.png"
+             alt="Blue Circle theme"></li>
+    <li><img src="images/screenshots/en/clear-blue.png"
+             alt="Clear Blue theme"></li>
+    <li><img src="images/screenshots/en/cozmixng.png"
+             alt="COZMIXNG theme"></li>
+    <li><img src="images/screenshots/en/dark-gradation.png"
+             alt="Dark Gradation theme"></li>
+    <li><img src="images/screenshots/en/day-white.png"
+             alt="Day White theme"></li>
+    <li><img src="images/screenshots/en/debian.png"
+             alt="Debian theme"></li>
+    <li><img src="images/screenshots/en/green-circle.png"
+             alt="Green Circle theme"></li>
+    <li><img src="images/screenshots/en/night-black.png"
+             alt="Night Black theme"></li>
+    <li><img src="images/screenshots/en/rabbit.png"
+             alt="Rabbit theme"></li>
+    <li><img src="images/screenshots/en/ranguba.png"
+             alt="Ranguba theme"></li>
+    <li><img src="images/screenshots/en/red-frame.png"
+             alt="Red Frame theme"></li>
+    <li><img src="images/screenshots/en/ruby-gnome2.png"
+             alt="Ruby-GNOME2 theme"></li>
+    <li><img src="images/screenshots/en/rubykaigi2011.png"
+             alt="RubyKaigi2011 theme"></li>
+  </ul>
+</section>
+
+<div id="main">
+  <section class="contents">
+    <h2>About Rabbit</h2>
+    <nav>
+      <ul>
+        <li><a href="en/">README</a></li>
+        <li><a href="en/news.html">News</a></li>
+        <li><a href="en/install/">Install</a></li>
+        <li><a href="en/usage.html">Usage</a></li>
+        <li><a href="en/how-to-make/">How to make a slide</a></li>
+        <li><a href="en/faq.html">FAQ</a></li>
+        <li><a href="en/users.html">Rabbit Shocker - Rabbit users group</a></li>
+      </ul>
+    </nav>
+  </section>
+</div>

data/doc/index.html.ja

@@ -0,0 +1,58 @@
+---
+layout: ja
+title: Rubyist用プレゼンツール
+lang_suffix: true
+no_sidebar: true
+---
+<div class="latest-release">
+  <p>{{ site.release_date }}にリリースされた<a href="/ja/news.html">{{ site.version }}</a>が最新リリースです。</p>
+</div>
+
+<section id="screenshots">
+  <h2>スクリーンショット</h2>
+  <ul>
+    <li><img src="images/screenshots/ja/blue-circle.png"
+             alt="青い円テーマ"></li>
+    <li><img src="images/screenshots/ja/clear-blue.png"
+             alt="きれいな青テーマ"></li>
+    <li><img src="images/screenshots/ja/cozmixng.png"
+             alt="COZMIXNGテーマ"></li>
+    <li><img src="images/screenshots/ja/dark-gradation.png"
+             alt="暗めのグラデーションテーマ"></li>
+    <li><img src="images/screenshots/ja/day-white.png"
+             alt="Day Whiteテーマ"></li>
+    <li><img src="images/screenshots/ja/debian.png"
+             alt="Debianテーマ"></li>
+    <li><img src="images/screenshots/ja/green-circle.png"
+             alt="緑の円テーマ"></li>
+    <li><img src="images/screenshots/ja/night-black.png"
+             alt="Night Blackテーマ"></li>
+    <li><img src="images/screenshots/ja/rabbit.png"
+             alt="Rabbitテーマ"></li>
+    <li><img src="images/screenshots/ja/ranguba.png"
+             alt="ラングバテーマ"></li>
+    <li><img src="images/screenshots/ja/red-frame.png"
+             alt="赤い枠テーマ"></li>
+    <li><img src="images/screenshots/ja/ruby-gnome2.png"
+             alt="Ruby-GNOME2テーマ"></li>
+    <li><img src="images/screenshots/ja/rubykaigi2011.png"
+             alt="日本Ruby会議2011テーマ"></li>
+  </ul>
+</section>
+
+<div id="main">
+  <section class="contents">
+    <h2>Rabbitについて</h2>
+    <nav>
+      <ul>
+        <li><a href="ja/">はじめに</a></li>
+        <li><a href="ja/news.html">お知らせ</a></li>
+        <li><a href="ja/install/">インストール</a></li>
+        <li><a href="ja/usage.html">使い方</a></li>
+        <li><a href="ja/how-to-make/">スライドの作り方</a></li>
+        <li><a href="ja/faq.html">よくある質問</a></li>
+        <li><a href="ja/users.html">Rabbitショッカー - ユーザーのみなさん</a></li>
+      </ul>
+    </nav>
+  </section>
+</div>

data/doc/ja/about.rd

@@ -0,0 +1,21 @@
+---
+layout: ja
+title: Rabbitとは？
+---
+== Rabbit
+
+RabbitはRubyでカスタマイズできるプレゼンテーションツールです。
+
+Rabbitはテキスト形式でプレゼン資料を作成できるので、常にエディ
+タとバージョン管理システムを使っているプログラマ向きのプレゼ
+ンテーションツールです。テキストの書式にはRDまたはWiki記法を
+使います。
+
+((<rd.rd/RD>))はRuby Documentの略で、素の状態でも読み書
+きしやすいようにデザインされたテキストの書式です。Wiki記法に
+近い書きかたなので比較的簡単に理解できます。
+
+Wiki記法にはいくつか亜種がありますが、Rabbitでは((<hiki.html/Hiki記法
+>))を採用しています。
+
+

data/doc/ja/development.rd

@@ -0,0 +1,78 @@
+---
+layout: ja
+title: 開発
+---
+== リポジトリ
+
+Rabbitのリポジトリは
+((<GitHub|URL:https://github.com/rabbit-shocker/rabbit/>))にあります。
+
+== コミットメール
+
+以下のメーリングリストにコミットメール毎に変更点が流れます。
+メーリングリストに参加することで開発状況を確認できます。メー
+リングリストに参加するには以下のようなメールを送信してくださ
+い。
+
+  To: rabbit@ml.commit-email.info
+  Cc: null@commit-email.info
+  Subject: 登録
+
+  登録
+
+== バグの報告方法
+
+ご意見ご要望不具合報告等は作者へのメール、メーリングリスト（メーリング
+リストについては((<users.rd/ユーザー>))ページを見てください）、
+((<GitHubの
+Issues|URL:https://github.com/rabbit-shocker/rabbit/issues>))をご利用く
+ださい。
+
+== 開発へ参加
+
+Rabbitプロジェクトはみなさんが開発に参加してくれることを歓迎
+します！
+
+=== テーマ
+
+新しいテーマを作ったら、ぜひメーリングリストなどで教えてくだ
+さい。Rabbit本体に取り込みませんか？
+
+=== ドキュメント
+
+Rabbitのドキュメントが不足しています。まずは、あなたの知って
+いることを((<faq.rd/FAQ>))ページに書いてみませんか？
+
+慣れてきたら((<"how-to-make/"/スライドの作り方>))ページの内
+容を充実させませんか？あるいは、既存の日本語のドキュメントを
+英語に翻訳しませんか？
+
+=== 開発環境の作り方
+
+==== リポジトリをclone
+
+((<"http://rabbit-shocker.org/"/本サイト>))のソースコードもRabbitと同じ((<リポジトリ|URL:https://github.com/rabbit-shocker/rabbit/>))にあります。Rabbitのリポジトリをクローンします。
+
+  % git clone https://github.com/rabbit-shocker/rabbit.git
+
+サイトのソースコードはdocディレクトリにあります。
+
+==== Gemライブラリのインストール
+
+開発に必要なライブラリをBundlerでインストールします。
+
+  % cd rabbit
+  % bundle install --path vendor/bundle
+
+((<"http://bundler.io/"/Bundler>))はgemのパッケージ管理ツールです。事前のインストールが必要です。
+
+  % gem install bundler
+
+==== 開発サーバーの起動
+
+Rakeタスクで開発サーバーを起動します。
+
+  % bundle exec rake doc:server
+
+doc:server タスクを実行するとWebServerが立ち上がります。((<"http://127.0.0.1:4000/index.html.ja"/"http://127.0.0.1:4000/index.html.ja">)) にアクセスしてください。
+Rabbitウェブサイトのホームページが表示されます。

data/doc/ja/faq.rd

@@ -0,0 +1,202 @@
+---
+layout: ja
+title: FAQ
+---
+== FAQ
+
+以下のような形式でよくある質問に対する答えが書かれています。
+
+== 質問...
+
+答え...
+
+== Twitterのtweetをスライド中に表示するには？
+
+rabbiterコマンドを使います。Rabbitが起動した状態で以下のよう
+にrabbiterコマンドを起動すると、「ruby」という単語が含ま
+れたtweetがコメントとしてスライド下部に表示されます。
+
+  % rabbiter --filter ruby
+
+== Twitterのtweetをニコニコ動画のようにスライド上に流すには？
+
+((%--comment-theme stream-comment%))オプション付きで
+((%rabbit%))コマンドを実行してください。
+
+  % rabbit --comment-theme stream-comment slide.rab
+
+((%rabbiter%))コマンドでTwitterからtweetを取り込むと、スライ
+ド上をコメントが流れていきます。
+
+== 1ページに複数枚のスライドが入ったPDFを作るには？
+
+XXX.rdから1ページに8枚のスライドが入ったPDF（XXX_multi.pdf）を
+作成する手順は以下の通りです。
+
+  % rabbit -p --slides-per-page 8 -o XXX_multi.pdf XXX.rd
+
+== PDFでうさぎと亀を使いたいときは？
+
+--allotted-timeオプションを使います。
+
+  % rabbit --allotted-time 5m slide.pdf
+
+--allotted-timeの値の書式はスライド中に
+
+  # _
+  : allotted-time
+      5m
+
+と書くときと同じものが使えます。
+
+上の例だと「5m」なので、亀が5分かけて走ります。
+
+すべてのテーマがうさぎと亀をサポートしているわけではないことに注意してください。たとえば、「default」テーマはサポートしていますが、「lightning-talk」テーマはサポートしていません。
+
+== 亀を元に戻したいときは？
+
+ Alt+t
+
+== 高橋メソッドスライドの中に普通のスライドを混ぜたいときは？
+
+高橋メソッド用のテーマはRabbitではlightning-talkと呼ばれています。
+
+通常，高橋メソッドのみを使ったスライドを作成する場合は以下のように「lightning-talk」テーマを使います。
+
+  = タイトル
+  : author
+     オレ
+  : theme
+     lightning-talk # <= こんな感じ
+
+  = オレは
+
+  = オレだ
+
+もし，高橋メソッドを使ったスライドだけではなく，箇条書きなどを使った「普通の」スライドを混ぜたい場合はこれではうまくいきません。なぜなら，「lightning-talk」テーマは箇条書きなどの見栄え定義を持たないからです。
+
+これを解決するには，テーマを混ぜます。実は，「ligntning-talk」と混ざったテーマが標準でいくつか用意されています。例えば，「rabbit」テーマと「lignting-talk」テーマを混ぜた「lightning-rabbit」です。このテーマを使うと以下のように，高橋メソッドを使ったスライドと普通の「rabbit」テーマのスライドを混ぜることができます。
+
+  = タイトル
+  : author
+     オレ
+  : theme
+     lightning-rabbit
+
+  = オレは
+
+  = 。。。
+
+    * 。。。
+    * 。。。
+    * 。。。
+
+  = オレだ
+
+「lightning-rabbit」テーマは以下のようにとても小さなテーマです。
+
+  # enscript ruby
+  include_theme("rabbit")       # (1)
+
+  @lightning_talk_proc_name = "lightning-rabbit"
+  @lightning_talk_as_large_as_possible = true
+  include_theme("lightning-talk-toolkit")
+
+  match(Slide) do |slides|
+    slides.each do |slide|
+      if slide.lightning_talk?  # (2)
+        slide.lightning_talk    # (3)
+      end
+    end
+  end
+
+作戦は，以下のようになっています。
+
+  (1) ベースとなるテーマを適用する。（(1)の部分）
+  (2) lightning-talk用のスライドだけ（(2)の部分）
+      見栄えをlightning-talk用の見栄え定義で上書きする。（(3)の部分）
+
+これを応用すれば，簡単にちょっとだけ高橋メソッドを使ったプレゼンテーションを行うことができます。注意点は「((*slide.lightning_talkは最後に！*))」ということです。これは，既存の見栄えを上書きするという作戦を用いているためです。
+
+ちなみに，(({slide.lightning_talk}))の別名として(({slide.takahashi}))が，(({slide.lightning_talk?}))の別名として(({slide.takahashi?}))が用意されています。
+
+Happy Rabbitting!
+
+== 特定のスライドだけプロパティを変えたい時は？
+
+例えば以下は "Redhanded" を含むスライドのフォントをイタリックに変更します。
+  match Slide do |slides|
+    slides.each do |slide|
+      if slide.match?(/Redhanded/)
+        slide.prop_set("style", "italic")
+      end
+    end
+  end
+
+== 改行をするには？
+
+以下のように書きます。
+
+  \n
+
+これはスライドの内容だけではなく，スライドタイトルでも有効です。
+
+TODO: 前は&NewLine;と書かなきゃいけなかったけど、今は\nで書
+けるようにしたから↓は古くなっている。どうしよう。
+
+RabbitにはRubyと同じ魔法の粉がかかっています。つまり，「やってはいけないことは汚く見える」ようになっています((-Rubyの魔法の粉は，例えばグローバル変数に(({$}))を使うというものです。-))。
+
+Rabbitで改行が書きづらくて，書くとソースが見づらくるのも，Rabbitが改行をできるだけ使わないで欲しいからです。
+
+できるだけ使わないで欲しい一番の理由は「スライドには改行をしなければいけないくらい長い文章は書かない方がよい」からです。文章が長くなってしまった場合は，改行をすることを考える前にその文章を短く言い替えられないかなどを考えた方がよいでしょう。
+
+スライドに長い文章を書くと，聞いている人はスライドの内容を読むことに集中して，発表者への注意が少なくなってしまいがちです。プレゼンテーションのテクニックとして，「大事なこと，一番言いたいことを話すときは発表者に注目させる」というものがあります((-ホント？-))。スライドに長い文章を書いていると，このテクニックが使いづらくなってしまいます。
+
+== ブラックアウト？ホワイトアウト？
+
+スライド全体を黒または白くして，スライドの内容を見えなくして，「発表者に注目させる」というテクニックを使うときに利用するための機能です。
+
+ブラックアウトは((%B%))で，ホワイトアウトは((%W%))で切替えることができます。それぞれのキーバインドの理由は((*B*))lackと((*W*))hiteです。
+
+== タイトルスライドの背景を指定するには？
+
+title-background-colorテーマを使います。
+
+例えば，背景を赤くしたい場合は以下のようにします。
+
+  @title_background_color = "red"
+  include_theme("title-background-color")
+
+背景色の指定には(({#RRGGBB}))形式も使えます。以下の例も背景を赤くします。
+
+  @title_background_color = "#ff0000"
+  include_theme("title-background-color")
+
+色ではなくて，画像を指定したいときはtitle-background-imageテーマを使います。
+
+以下は背景にマスコットキャラクタ「ラビィ」を指定する例です。
+
+  @title_background_image = "lavie.png"
+  include_theme("title-background-image")
+
+== スライドの背景を指定するには？
+
+例えば，背景を赤くしたい場合は以下のようにします。
+
+  set_background("red")
+
+背景色の指定には(({#RRGGBB}))形式も使えます。以下の例も背景を赤くします。
+
+  set_background("#ff0000")
+
+色ではなくて，画像を指定したいときはslide-background-imageテーマを使います。
+
+以下は背景にマスコットキャラクタ「ラビィ」を指定する例です。
+
+  @slide_background_image = "lavie.png"
+  include_theme("slide-background-image")
+
+== Mac OS X で rabbit --full-screen としたとき, 上部のメニューバーや下部のドックが表示されてしまう場合があります.
+
+X11 > 環境設定 > 出力 > フルスクリーンモード のチェックボックスを ON にすると, 上下の表示が消えます.
+環境設定の画面に「コマンド + Option + A キー」でフルスクリーンモードの ON/OFF を切り替えられると書いてありますが, 動かないことがありますので, 「フルスクリーンモード時のメニューバーへのアクセスを許可」というサブオプションも ON にしておくと, X11 のフルスクリーンモードを OFF にするときに環境設定にアクセス出来なくて困るという事にならなくて済みます.