File: faq.rd

package info (click to toggle)
rabbit 3.0.5-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 14,220 kB
  • sloc: ruby: 29,637; lisp: 309; makefile: 43; sh: 9
file content (202 lines) | stat: -rw-r--r-- 8,902 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
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 にするときに環境設定にアクセス出来なくて困るという事にならなくて済みます.