iPhone では pandoc も LaTeX も動かないため、Folio Writer for iOS は Folio Writer サーバーで組版します——短時間で、透明に、そして求めたときだけ。何が起こり、何を選べ、どんなときに Mac を使うべきかを説明します。
原稿をプレビュー(無料)は原稿全体を組み立ててデバイス上で描画し、数式は KaTeX で組みます。共有メニューから PDF の作成や印刷ができ、何もスマートフォンの外へ出ません。読み用のコピーを得る、速くて私的な経路です。
コンパイル(Pro)は本物の組版——Mac と同じ pandoc パイプライン——で、Typst または LaTeX による PDF、Word 文書、Typst ソースを生成します。引用は .bib ファイルに対して解決され、図・表・数式には番号が付きます。これはサーバーで実行されます。
すでに Folio Cloud 上にあるプロジェクトは、サーバーのコピーからコンパイルされます。追加のアップロードはありません。ローカルまたは iCloud のプロジェクトはパッケージ化してコンパイルのために送られ(Folio Cloud アカウントへのサインインが必要)、コンパイルが終わると削除されます。残ったものも数分後にはサーバーが掃除します。エンドツーエンド暗号化プロジェクトはクラウドのコピーが封印されているため、読めるコピーを一部送る前に確認を求めます。初回のコンパイル時に、これらを一度だけ説明する通知が表示されます。
サーバーでのコンパイルは iPhone と iPad のためだけのものです。Mac では Folio Writer が自前のツールでローカルにコンパイルし、ファイルはコンピュータの外へ出ません。
形式:PDF、Word、Typst ソース。組版エンジン(PDF のみ):既定の Typst——高速で、CJK フォントと SVG 図版をネイティブに扱う——か、Tectonic を通して動く LaTeX——LaTeX 文書の見た目と付随するパッケージのため。完成したファイルの下の一行に、実際にどちらで組まれたかが表示されます。バインダーのタイトルを見出しとして挿入はフォルダと文書のタイトルをバインダー内の深さに応じて印字します(Mac と同じ)。文書の最初の見出しがタイトルと重複する場合は省くはタイトルの二重印字を防ぎます。セクション番号と目次はそのままの意味で、修正提案を含む原稿は「すべて承認」または「すべて却下」としてコンパイルできます。
Markdown(ソース)を書き出すは、組み立てた原稿を一つの .md としてデバイス上に書き出します——コンパイルが送るのと同じテキスト——共著者やリポジトリ、別のツールのために。
サーバーは pandoc-crossref を実行するので、@fig:key・@tbl:key・@eq:key は "Fig. 1"・"Table 1"・"eq. 1" となり、順番に番号が振られます。文頭では大文字の @Fig:key を。本文が参考文献の項目を引用していれば、番号なしの見出しの下に References セクションが末尾に追加されます。位置を自分で決めるには、原稿内に ::: {#refs} ブロックを置いてください。記法は図・数式・相互参照を参照。
コンパイルはジョブとして動きます。スマートフォンが原稿を送信し、進捗(「変換中」「LaTeX で組版中…」)を問い合わせ、ファイルを取得するので、長い書籍がリクエストのタイムアウトで途切れることはありません。「キャンセル」はサーバー上の組版を停止します。失敗した場合、「問題」ボックスの先頭の行が実際のエラー——行番号つきの LaTeX エラーか pandoc のメッセージ——で、警告はその後に続きます。