Folio Writer

一つの原稿、四つのエンジン:
Markdown、pandoc、Quarto、Typst

多くの執筆ツールでは、形式を選んだらその出力と付き合っていくしかありません。Folio Writer はこの二つの決定を切り離します。プレーンテキストで一度書き、コンパイルのたびにレンダリングエンジンを選ぶのです——学位論文の審査委員会、学術誌、プレプリントサーバーが同じものを求めることはまずないのですから。

コンパイルシート:コンパイルごとのフォーマットとレンダラー。
コンパイルシート:コンパイルごとのフォーマットとレンダラー。

Markdown:唯一の正本

Folio Writer プロジェクトの通常の文書はすべてプレーンな .md ファイルです——学術執筆に重要な拡張を備えた pandoc 流の Markdown:[@citations]、$math$、脚注、パイプテーブルとグリッドテーブル、@fig:/@tbl:/@eq: の相互参照、タスクリスト、Wikiリンク。エディタはそれをライブで描画します——スタイルの付いた見出し、組まれた数式、解決された引用——が、ファイルは grep も diff もでき、2040 年にも開けるテキストのままです。以下のどれもこれを変えません。エンジンは出力の選択であって、ファイル形式ではないのです。

pandoc:万能の翻訳者

デフォルトのパイプラインです。コンパイルはバインダーを一つの文書に縫い合わせて 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:学術誌と実行可能なコード

レンダラーを Quarto に切り替えると、二つの扉が開きます。一つ目は出版社の仕様どおりの出力です(学術誌への投稿ガイドを参照)。学術誌の拡張(AGU、Elsevier、Copernicus…)を追加し、メタデータを一行(quarto-to: agu-pdf)設定してコンパイルするだけ——Folio Writer は構造化された著者と所属を学術誌テンプレートへそのまま渡し、学術誌のクラスと衝突する汎用のレイアウトキーを取り除きます。二つ目は実行可能な原稿です。{python} と {r} のセルはコンパイル時に実行されるので、ビルドのたびにデータから図が再生成されます(動的なプロットを参照)。どこでも @fig:xrd と書いてください——Folio Writer が自動的に Quarto ネイティブのダッシュ記法に変換するので、二つのレンダラーに一つの記法で済みます。

Typst:高速でモダンな組版システム

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 用の OpenDocumentpandoc → .odt(数式はネイティブの ODF 数式として)
最小限の設定で美しい PDFTypst レンダラー(brew install typst——TeX は不要)
学術誌の仕様どおりの投稿(AGU、Elsevier…)Quarto + 学術誌の拡張
コンパイル時にデータから生成される図Quarto + {python}/{r} セル
投稿システム用の LaTeX ソースpandoc または Quarto → .tex
手作業による精密な組版の制御ネイティブの .typ 文書/.typ の書き出し
ツールについて:App Store 版はサンドボックス化されているため、外部ツール——pandoc、pandoc-crossref、TeX ディストリビューション、Quarto——Typst も含めて——は無料の Folio Helper を介して実行されます。Folio Helper は決められた許可リストのものだけを、Folio Writer が求めたときにだけ実行します。中でも Typst はいちばん軽く、単一のバイナリで TeX ディストリビューションも不要です。ライブプレビューにはツールは一切不要です——テキスト、数式、引用を、オフラインで単独で組版します。

貫かれている原則

四つのエンジン、一つの原則:原稿は決してレンダラーのものにはなりません。同じプレーンファイルのフォルダが、月曜には審査委員会向けの Word 文書を、水曜には学術誌向けの LaTeX を、金曜には Typst で組版したプレプリントを生み出せます——そしていつか Folio Writer を離れることがあっても、それらのファイルはどれも開け、読め、コンパイルできます。

Folio Writer を無料でダウンロード →  ·  ほかのガイド