多くの執筆ツールでは、形式を選んだらその出力と付き合っていくしかありません。Folio Writer はこの二つの決定を切り離します。プレーンテキストで一度書き、コンパイルのたびにレンダリングエンジンを選ぶのです——学位論文の審査委員会、学術誌、プレプリントサーバーが同じものを求めることはまずないのですから。
Folio Writer プロジェクトの通常の文書はすべてプレーンな .md ファイルです——学術執筆に重要な拡張を備えた pandoc 流の Markdown:[@citations]、$math$、脚注、パイプテーブルとグリッドテーブル、@fig:/@tbl:/@eq: の相互参照、タスクリスト、Wikiリンク。エディタはそれをライブで描画します——スタイルの付いた見出し、組まれた数式、解決された引用——が、ファイルは grep も diff もでき、2040 年にも開けるテキストのままです。以下のどれもこれを変えません。エンジンは出力の選択であって、ファイル形式ではないのです。
デフォルトのパイプラインです。コンパイルはバインダーを一つの文書に縫い合わせて pandoc に渡し、pandoc が Word (.docx)、OpenDocument (.odt)、LaTeX (.tex)、HTML、EPUB を生成します——TeX ディストリビューションがあれば、xelatex、pdflatex、lualatex、tectonic による学術誌の定番の PDF も。引用は任意の CSL スタイルで citeproc が整形し、pandoc-crossref が図・表・数式に番号を振ります。Folio Writer は縫い合わせた自己完結の .md を書き出すこともできます——pandoc manuscript.md -o out.pdf --citeproc でどこでもビルドを再現できる、それこそがプレーンテキストの意義です。
レンダラーを Quarto に切り替えると、二つの扉が開きます。一つ目は出版社の仕様どおりの出力です(学術誌への投稿ガイドを参照)。学術誌の拡張(AGU、Elsevier、Copernicus…)を追加し、メタデータを一行(quarto-to: agu-pdf)設定してコンパイルするだけ——Folio Writer は構造化された著者と所属を学術誌テンプレートへそのまま渡し、学術誌のクラスと衝突する汎用のレイアウトキーを取り除きます。二つ目は実行可能な原稿です。{python} と {r} のセルはコンパイル時に実行されるので、ビルドのたびにデータから図が再生成されます(動的なプロットを参照)。どこでも @fig:xrd と書いてください——Folio Writer が自動的に Quarto ネイティブのダッシュ記法に変換するので、二つのレンダラーに一つの記法で済みます。
Typst は、LaTeX がもし今日設計されたらこうなるだろう、という姿です。LaTeX 品質の PDF を一瞬で、TeX ディストリビューションなしに生成します——Typst は小さな単一のバイナリ(brew install typst)で、組版された PDF へのいちばん身軽な道です。Folio Writer は Markdown の原稿を Typst ソースに変換し(引用、相互参照、番号付け、目次を含む)、コンパイルします。あるいは .typ そのものを書き出し、typst watch で手作業で調整することもできます。変換にとどまらず、Typst は第一級の文書タイプでもあります。バインダーにネイティブの .typ 文書を作成し——独自の表、正確な図の配置、#show ルール——一つのプロジェクトの中で Markdown の章と混在させ、まとめてコンパイルできます。
| 必要なもの | 使うもの |
|---|---|
| 審査委員会や共著者のための Word ファイル | pandoc → .docx(変更履歴に対応) |
| LibreOffice/OpenOffice 用の OpenDocument | pandoc → .odt(数式はネイティブの ODF 数式として) |
| 最小限の設定で美しい PDF | Typst レンダラー(brew install typst——TeX は不要) |
| 学術誌の仕様どおりの投稿(AGU、Elsevier…) | Quarto + 学術誌の拡張 |
| コンパイル時にデータから生成される図 | Quarto + {python}/{r} セル |
| 投稿システム用の LaTeX ソース | pandoc または Quarto → .tex |
| 手作業による精密な組版の制御 | ネイティブの .typ 文書/.typ の書き出し |
四つのエンジン、一つの原則:原稿は決してレンダラーのものにはなりません。同じプレーンファイルのフォルダが、月曜には審査委員会向けの Word 文書を、水曜には学術誌向けの LaTeX を、金曜には Typst で組版したプレプリントを生み出せます——そしていつか Folio Writer を離れることがあっても、それらのファイルはどれも開け、読め、コンパイルできます。