Re:VIEW et flux de publication

Pour publier un livre, surtout un ouvrage technique japonais (技術書), écrire directement du LaTeX brut n’est pas la seule voie. Re:VIEW permet de rédiger dans un balisage simple et de produire PDF (via LaTeX) et EPUB (ainsi que HTML et InDesign) à partir d’une seule source. Cette page le présente.

Ce qu’est Re:VIEW

Re:VIEW (par kmuto et d’autres) est un système de publication où l’on écrit dans un balisage léger propre au projet, plus simple que LaTeX (= chapter, == section, //list, inline @<b>{...}). À partir d’un même ensemble de sources .re, il convertit vers LaTeX, HTML, EPUB, InDesign et texte. C’est l’outil de facto de l’autoédition technique japonaise (技術書典 et assimilés). Pour le PDF, il utilise LaTeX (TeX Live) comme backend, ce qui donne une qualité TeX sans écrire directement du TeX.

terminal
= はじめに
本文です。インラインの強調は @<b>{ここ}。
//image[fig1][図の説明]{
//}

La construction — PDF / EPUB

Un projet se compose de fichiers .re par chapitre, plus config.yml (métadonnées/options) et catalog.yml (ordre des chapitres). La construction se fait avec rake pdf / rake epub (ou review-pdfmaker config.yml / review-epubmaker). Le PDF passe par LaTeX ; depuis Re:VIEW 3.0, la classe par défaut est review-jsbook, et la partie LaTeX (classe, .sty, modèles ERB) peut être personnalisée.

terminal
rake pdf     # PDF(LaTeX 経由)/ PDF via LaTeX
rake epub    # EPUB
# または / or:
review-pdfmaker config.yml

Quand choisir Re:VIEW

Choisissez Re:VIEW si vous voulez, pour un livre, une source → PDF + EPUB et si vous préférez un balisage plus simple au LaTeX brut (avec l’écosystème et les modèles riches de l’édition japonaise). Restez sur LaTeX pur si vous avez besoin d’un contrôle typographique fin ou si vous ne ciblez pas EPUB. Pour construire de grands livres LaTeX, consultez « Gestion de grands documents ».