Re:VIEW執筆方法Tips
Re:VIEWで技術同人誌作成
第八回 技術書同人誌博覧会に出展予定です。
書籍作成のためにRe:VIEWというソフトを使っているので使い方のメモです。
Re:VIEW環境構築
以下の通りです。
執筆にはVS Codeエディタを使う前提です。日本語入力環境は以下記事のとおりセットアップしています。
執筆Tips
VS Code設定
- 折返し表示は
ALT + Zで切り替えます
図関係
-
articleディレクトリ下のimagesディレクトリに画像を入れます（デフォルト設定）。例えば章ごとにディレクトリ分けたりもできますが、私は全部imagesに入れました。
-
例えば images ディレクトリの
sample.jpgという図を表示するときは、以下のような書式になります。ディレクトリや拡張子は指定しちゃだめです。ファイル名のみ識別子として入れられます。コメントもつけれますが、私は使っていません。
//image[sample][サンプル]
- 図を参照するときは以下です
@<img>{sample}
- 図は画面いっぱいに広がってしまう。小さくするときは、scaleで指定します。ただ、プレビューには反映されないのでビルドして確認するしかない（なぜ）。
//image[sample][サンプル][scale=0.5]
文章ファイル関係
-
文章ファイルは、章ごとに分ける必要があるトップレベルヘッダー（'= title'）が1つのファイルに1つしかつけられません。章のファイルは
catalog.yamlファイルで定義します。トップレベルヘッダーが複数あると、コンパイル（pdf作成）も、VS Codeエディタでのプレビューもできなくなります。 -
同じヘッダー（見出し）の名前があるとコンパイルもプレビューもできなくなります。以下みたいにラベルをつける必要があります。
==={label_A} テスト
==={label_B} テスト
- ファイル名にハイフンはつけないほうがよいです。参考: 別ファイルの章を参照する
コマンドの表記
- 以下のように書けばOKです。
//cmd{
$ ls
//}
imagetableがプレビューできない
- 画像を表として貼りたいとき、以下のようにimgtableを使います。オプションは自分の環境だと必須でした（ないとコンパイルが通らない）。そして、コンパイルは通るけど、なぜかVS Codeエディタのプレビューができないです。
#//imgtable[sample][サンプル]{
//}
強制改行
このあと改行@<br>{}
改行した後、字下げしたくない場合は、noindenを組み合わせます。
//noindent
字下げしたくない文字
何も文字がないところで以下のように強制改行だけ使うとコンパイルエラーになるので気をつけましょう（ハマりました）。
@<br>{}
表紙
-
デフォルトのB5サイズ(18.2cmx25.7cm)だと、Keynoteだと516ptx728ptで作成するとちょうどになります
-
デザインは、技術書典とか技術同人博覧会のよいものを参考にしました。
作例
なかなか
まとめ
Re:VIEW執筆、最初は環境構築含め大変でしたが、商業出版に耐えれるレベルの出力ができるのは良いですね。同じコンテンツから、紙、電子媒体とさまざまなプラットフォームのフォーマットに対応できる点も素晴らしいです。
今回は、最初はGoogle Documentで書いて、途中からRe:VIEWで書き直したので大変でしたが、最初からRe:VIEWで書けば効率よくそこまで手間ではないかもですね。
参考リンク
参考にした情報です。
ガイド的なもの
Tips的なもの
書籍
関連記事
Discussion