Re:VIEW ナレッジベース¶
Re:VIEW 開発者の立場から、Re:VIEW のカスタマイズおよび「よくある質問と回答」をまとめています。
Re:VIEW のセットアップおよび基本的な使い方については、Re:VIEW 公式の 各ドキュメント をまず参照してください (特に Re:VIEWクイックスタートガイド と Re:VIEWフォーマットガイド)。
このナレッジベースへのご意見・ご要望については、 https://github.com/reviewml/reviewknowledge-ja の issue 投稿、または Twitter @kmuto までお寄せください。
リリースに関する情報¶
review-ext.rb による拡張¶
LaTeX に関連する長めの Tips¶
- 図表のフロートを制御する
- 見栄えが悪い箇所を「少しだけ」調整する
- フックで LaTeX 処理に割り込む
- jsbook ベースのドキュメントにトンボおよびデジタルトンボを配置する
- 前付(PREDEF)、後付(POSTDEF)の図表採番を本章同様にリセットする
- 部が存在するときのしおりのレベルを調整する
- Re:VIEW 3 からの LaTeX 処理
- 使用書体の変更(upLaTeX 編)
- Re:VIEW 向け日本語 TeX Live 環境のセットアップ(Linux、macOS、Windows)
- review-jsbook.cls の基本版面設計
- カスタムなページ(権利表記、広告や裏表紙など)の挿入
- コードブロック内で自動改行する
- TeX 実行時のエラーを読み解く
- Re:VIEW + upLaTeX で絵文字を使う
- 参考文献にthebibliography環境を利用する
- コードブロックに長体(横方向の縮小変形)をかける
- 表の自由度をHTMLを使って掴み取る
- mintedを使ったコードハイライト
- 章扉を画像で差し替える
EPUB に関連する長めの Tips¶
その他の長めの Tips¶
FAQ(よくある質問と回答)¶
- FAQ - Re:VIEW そのものについて
- Re:VIEW はなんと発音するのですか?
- Re:VIEW とは何ですか?
- Re:VIEW の Web サイトはどこですか?
- Re:VIEW は誰のためのソフトウェアですか?
- 実際、誰が使っていますか?
- Re:VIEW は誰が作っていますか?
- Re:VIEW はいつ作られましたか?
- Re:VIEW のソースコードは公開されていますか?
- Re:VIEW のリリーススケジュールはどうなっていますか?
- Re:VIEW のバージョンルールはどうなっていますか?
- Re:VIEW のサポートルールはどうなっていますか?
- バージョンごとの機能差異はどこかにまとまっていますか?
- Re:VIEW は何の言語で書かれていますか?
- Re:VIEW の開発に参加したいですがどうしたらよいですか?
- 「Re:VIEW」という名前は検索しづらいです。変えるべきではないですか?
- Re:VIEW は TeX ですか? あるいは TeX に置き換わるものなのですか?
- Re:VIEW は TeX (または InDesign など) を知らなくても使えますか?
- Re:VIEW の「主要なビルダ」とは何ですか?
- なぜ便利な「○○.gem」を使わないのですか?
- Re:VIEW は日本語でしか使えませんか?
- なぜこの「Re:VIEW ナレッジベース」は Re:VIEW ではなく Markdown + Sphinx で書かれているのですか?
- FAQ - Re:VIEW とその成果物のライセンスについて
- Re:VIEW のライセンスは何ですか?
- Re:VIEW の LGPL、MIT、LPPL は具体的にどのようなライセンスですか?
- Re:VIEW の利用に料金は必要ですか?
- Re:VIEW を使ったドキュメントや、生成される PDF、EPUB などにはどのようなライセンスが適用されますか?
- Re:VIEW ソフトウェアの権利者表記はどのように記すべきですか?
- review-ext.rb のライセンスはどうなりますか?
- Re:VIEW をフォークして新たなソフトウェアを開発してもよいですか?
- Re:VIEW という名前をソフトウェアやサービス、製品に使ってもよいですか?
- Re:VIEW を Web サービスや製品に組み込みたいのですが?
- Re:VIEW を使って損害が生じました。賠償請求はできますか?
- Re:VIEW プログラムを友人に配りたいのですが?
- Re:VIEW を ○○ OS 用のパッケージにしてもよいですか?
- FAQ - Re:VIEW の使い方について
- Re:VIEW を動かすにはどのような環境が必要ですか?
- Re:VIEW はどうやってインストールしたらよいですか?
- Ruby はどうやってインストールしたらよいですか?
- TeX 環境の構築はどうしたらよいですか?
- Docker のイメージはありますか?
- docker pull で mac M1 (arm64) 用のイメージがありません
- 基礎的なガイダンスを記した公式のドキュメントはありますか?
- Re:VIEW の入門書はありませんか?
- バグを見つけました。どうしたらよいですか?
- 使い方の質問はどこに投稿するとよいですか?
- プロジェクト(作業フォルダ)を作るにはどうしたらよいですか?
- プロジェクトにどのようにコンテンツを置いたらよいですか?
- Re:VIEW がバージョンアップしたときに設定を追従するにはどうしたらよいですか?
- re ファイルを書くのに専用のエディタは必要ですか?
- re ファイルでの執筆・編集を支援するエディタにはどのようなものがありますか?
- Visual Studio Code を使ったところ、^H などのおかしな文字が入り、PDF の生成に失敗します!
- 図版はどこに置くのですか? また、どのような形式に対応していますか?
- config.yml ファイルはどのような役目を持っていますか?
- catalog.yml ファイルはどのような役目を持っていますか?
- PDF(review-pdfmaker)と EPUB(review-epubmaker)、あるいは印刷版 PDF と 電子版 PDF のように出力方法によって若干異なる設定にしたいと思います。重複する内容の yml ファイルを作らずに済みませんか?
- 「図」「リスト」などの一部の固定文字列は locale.yml ファイルで変えられるようですが、どのように書いたらよいですか?
- EPUB に変換するにはどうしたらよいですか?
- LaTeX を使った PDF に変換するにはどうしたらよいですか?
- Web ページに変換するにはどうしたらよいですか?
- プレインテキストに変換するにはどうしたらよいですか?
- Re:VIEW の命令や記法に馴染めそうもありません。Markdown で記述できませんか?
- Markdown に変換することはできますか?
@<code>
などの頻出するインライン命令だけ Markdown 的に記述することはできませんか?- pandoc で Re:VIEW の書式はサポートされますか?
- Sphinx で Re:VIEW の書式はサポートされますか?
- LaTeX を使いたくないのですが、ほかの PDF 作成方法はありませんか?
- 表のセル区切りは、なぜ空白文字ではなく「タブ1つ」なのですか?
- 別フォルダにあるソースコードファイルの一部を原稿内に取り込みたいと思います。動的に取り込む方法はありますか?
- catalog.yml での最小単位は章単位ですが、節や項に分けることはできませんか?
- 見出しの一覧を出力することはできますか?
- Re:VIEW に対応した日本語校正ツールはありますか?
- 変換途中で独自の処理を挟むことはできますか?
- Re:VIEW の標準の命令処理を変えたり、新たな命令を追加したりすることはできますか?
- 索引を入れるにはどうしたらよいですか?
- プロジェクト直下がたくさんの re ファイルだらけでごちゃごちゃしてしまいました。サブフォルダにまとめて置くことはできますか?
- UML やグラフの生成ツールから動的に生成して配置することはできますか?
- インライン命令内で入れ子ができません!
- インライン命令内で「}」を文字として表現したいときにはどうしたらよいですか?
- インライン命令内の最後で「\」を文字として表現したいときにはどうしたらよいですか?
- @<m>命令を使って TeX 式を記述したところ、「}」がたくさん登場して都度「}」とするのが大変です。何か対策はありますか?
- ブロック命令内で「//}」を文字として表現したいときにはどうしたらよいですか?
- 箇条書きを入れ子にするにはどうしたらよいですか?
- Re:VIEW は夏時間に対応していますか?
- 段落を空行区切りではなく、改行をもって区切りにすることはできませんか?
- 英語の段落を記述したところ、改行のところで単語間がつながってしまいます
- ファイル名やラベルに避けたほうがよい文字はありますか?
- 後注を作ることはできますか
- Ruby 3.1 でエラーが発生するようになりました
- Re:VIEW は Log4j のセキュリティ侵害の影響を受けますか?
- Re:VIEW のセキュリティは堅牢ですか?
- コラム内で見出しを入れたところ、地の文の続きで採番されてしまいます
- FAQ - Re:VIEW の使い方について(TeX PDF)
- TeX 環境の構築はどうしたらよいですか?
- LaTeX を使った PDF に変換するにはどうしたらよいですか?
- LaTeX 実行時でのエラーが出ましたが、どのように調べたらよいですか?
- LaTeX のエラーの意味がわかりません。
- LaTeX の紙面サイズを変更するにはどうしたらよいですか?
- LaTeX の紙面レイアウトに満足がいきません。どうやったら置き換えられますか?
- LaTeX の紙面レイアウトとして他のテンプレートはありますか?
- 紙面の余白の調整をするにはどうしたらよいですか?
- LuaTeX-ja を使うにはどうしたらよいですか?
- トンボを付けるにはどうしたらよいですか?
- 入稿先に PDF/X-1a 形式か PDF/X-4 形式にするよう求められました。どうしたらよいですか?
- 全体をグレースケールにするにはどうしたらよいですか?
- コンパイルや PDF 生成処理の途中に割り込むにはどうしたらよいですか?
- 等幅の長い文字を入れると文字の間がスカスカになってしまいます。途中で折り返させるにはどうしたらよいですか?
- ページの途中で強制的に改ページするにはどうしたらよいですか?
- あるページの版面を少しだけ伸ばすにはどうしたらよいですか?
@<tt>
や@<code>
の等幅の箇所が段落からはみ出てしまいます。途中で折り返させるにはどうしたらよいですか?- 表のセルなどで、スペースや-を含まない長い英数字の箇所が折り返されません
- 複数のスペース文字を入れても、1つになってしまいます。どうしたらよいですか?
- PREDEF、POSTDEF で割り当てたファイルで図表を使うと、おかしな番号の振り方になります。
- jsbook ベースのテンプレートで、ページを頭からの通し番号にするにはどうしたらよいですか?
- 開始ページ番号を変えるにはどうしたらよいですか?
- 目次を付けるにはどうしたらよいですか?
- 目次が奇数ページ始まりになってしまいます
- 目次などでリンクに色や囲みが付きます。装飾なしの黒にできませんか?
//image
等で貼り付けた図版が版面幅いっぱいになってしまいます- 表紙を全面に貼り付けるにはどうしたらよいですか?
- 挿絵を全面に入れるにはどうしたらよいですか?
- Illustrator AI ファイルを配置したところ、何かおかしいです
- Re:VIEW 3 で表紙が表示されません
- 電子版用の表紙の画像を指定しましたが、はみ出してしまいます(あるいは小さすぎてフチができてしまいます)
- 裏表紙を入れるにはどうしたらよいですか?
- Photoshop psd ファイルを配置できません
- 隠しノンブルを入れるにはどうしたらよいですか?
- コラム内に image や table を置くとエラーになります
- 表内で @<br> を使ったときの見た目がよくありません
- 奥付を必ず偶数ページにするにはどうしたらよいですか?
- 章が奇数ページ始まりになっていますが偶数ページからも始まるようにしたいです
- 日本語フォントが埋め込まれません
- Windowsでcould not locate a virtual/phisical font for TFM "uphgothr-h" のようなエラーになります
- システムにインストールされているのにフォントがないと言われます
- 各書体を変えるにはどうしたらよいですか?
- PDF の作成に時間がかかります
- review-jsbook において、ページ番号を下部中央に配置するには、どうしたらよいですか?
- review-jsbook において、章名を左ページ、節名を右ページに配置するには、どうしたらよいですか?
- 行番号付きリストが長いときの折り返しはどう表現したらよいですか?
- コラムの脚注をどこに置いたらよいですか?
- 見出しに脚注を入れると、目次や柱にも番号が入り、カウントもされてしまいます
- 長い脚注がページで分かれてしまいます
- 数式への番号付けをRe:VIEWのものではなく、LaTeXの番号付けにするにはどうしたらよいですか?
- 参考文献の表現を LaTeX で一般的な形(bibliography)にしたいです
- 記入した絵文字が消えてしまいます!
- review-jsbook の章見出しの上の空きを取るにはどうしたらよいですか?
- 書き進めたところ、ある時点から画像が消えるようになりました!
- 印刷版と電子版の設定をうまく管理するにはどうしたらよいですか?
- 一部の文字が康煕部首の文字になります!
- 各ページの固定位置に画像を配置するにはどうしたらよいですか?
- コードリストの箇所をコピーペーストすると、半角の`'が全角の‘’になってしまいます
- 囲み記号として全角の「“」「”」を使うと、PDFからのコピーペーストがうまくいかなくなります
- 奥付に連絡先を入れるにはどうしたらよいですか?
- 奥付の著者・出版社等の順序を変更するにはどうしたらよいですか?
- 奥付の「著 者」などを変更するにはどうしたらよいですか?
- 奥付のデザインが気に入らないので、根本的に違うものにしたいです
- 大扉のデザインが気に入らないので、根本的に違うものにしたいです
- 大扉ページの後に権利表記のページを入れたいです
- プロフィールページを入れたいです
- 広告ページを入れたいです
- Re:VIEW 4.0 で media=ebook を使うと、「! TeX capacity exceeded, sorry [input stack size=5000]」なるエラーになります
- 段落の間に少し空きを入れるには?
- アクセント記号の前後に変な空きが入ってしまいます
- コードハイライトを使うにはどうしたらよいですか?
- ちょっとした書き物やレポート用に利用するにはどうしたらよいですか?
@<href>
命令でHTMLのように「#アンカー」でハイパーリンクを付けるにはどうしたらよいですか?- 長いURLを折り返させるのはどうしたらよいですか?
- 複雑な表表現をしたいです
- 索引に範囲や参照を入れたいです
- コード内で
@<u>
を使った下線を引こうとするとエラーになります - 部や章の番号の表記方法が locale.yml で変更しても変わりません
- 章に[nonum]を付けたときに柱の表示がおかしくなります
- FAQ - Re:VIEW の使い方について(EPUB・WebMaker)
- EPUB とは何ですか?
- EPUB に変換するにはどうしたらよいですか?
- Web ページに変換するにはどうしたらよいですか?
- 生成される EPUB のバージョンはいくつですか?
- 生成された EPUB が標準に合致しているかどうかの確認はどうしたらよいですか?
- Kindle 用の mobi ファイルは作れますか?
- 「電書協ガイドライン」に従った EPUB は作れますか?
- iBooks で EPUB を開いたときに左右ページの間に影ができます
- EPUB から PDF を作ることはできませんか?
- CSS を変更するにはどうしたらよいですか?
- Web フォントは利用できますか?
- 縦書き右綴じにするにはどうしたらよいですか?
- 数式を入れたいのですが良い方法はありませんか?
- コードハイライトを使うにはどうしたらよいですか?
- ハイライトを有効にすると、コード内のインライン命令がそのまま出てしまいます
- 複数のスペース文字を入れても、1つになってしまいます。どうしたらよいですか?
- 見出しのない re ファイルが EPUB に収録されません
- 複雑な表表現をしたいです
- EPUB/Web で索引を使うにはどうしたらよいですか
<section>
囲みにすることはできませんか
- FAQ - Re:VIEW の使い方について(InDesign)
- InDesign とは何ですか?
- InDesign ファイルに変換する maker コマンドがないようです。どうやって変換するのですか?
- IDGXML ビルダが生成される XML ファイルはいったい何ですか?
- 中間形式の紙面に合わせてどのような作業をしたらよいのですか?
- なぜ IDGXML の XML ファイルには改行が入っていないのですか?
- なぜ IDGXML の XML ファイルは浅い構造なのですか?
- よくわかりません……Re:VIEW と InDesign の組み合わせについての参考書はありますか?
- InDesign での実績はあるのでしょうか?
- InDesign の IDML 形式に変換することはできますか?
- InDesign の ICML 形式に変換することはできますか?
- ほかの変換器で IDGXML 形式を作ることはできますか?