GitHubプロジェクト¶プロジェクトは複数ファイルの結合とエクスポートを簡単に行うための機能です。これにより、一つのプロジェクトを複数のファイルに分けて作業することが可能になります。複数のファイルに分けて作業し、最後に結合して一つのPDFファイルにエクスポートします。Zettlrのプロジェクト機能はPDFエクスポートを細かく制御することを可能にします。プロジェクトを使用すると、例えば、タイトルページを作ったり目次を生成したりするように設定することができます。プロジェクトを作成する¶Zettlrのプロジェクトは、基本的にはディレクトリに対する追加の設定項目です。任意のディレクトリをプロジェクトに「変換」することができます。プロジェクトにしたいディレクトリを右クリックして「プロジェクトを作成」を選択します。するとディレクトリが赤色に変わって、名前の左にプロジェクト機能が有効になっていることを表す鉛筆のアイコンが表示されます。次にディレクトリを右クリックすると、コンテキストメニューに「プロジェクト設定」、「プロジェクトをエクスポート」、「プロジェクトを取り除く」の3つの項目が追加されています。プロジェクトでの作業¶プロジェクトディレクトリのコンテキストメニューで「プロジェクト設定」を選択すると、設定画面が表示されます。これはほとんど、単一のMarkdownファイルをエクスポートするためのPDF設定と同じものです。プロジェクトではPDFドキュメントの生成を細かく制御できることと、これらのPDF設定は対象のディレクトリのエクスポート時にのみ適用されるという2点の差があります。グローバルなPDF設定には手を付けることなく、プロジェクトに特異の設定をすることが可能です。プロジェクトの設定を簡単に見ていきます。ファイル名、タイトル(タイトルページを作る設定の場合)、PDFタイトルに使用されます。デフォルトはディレクトリ名です。著者を示すPDFメタデータフィールドに書き込まれます。PDFドキュメントのエクスポート時に任意で設定できるキーワードです。このチェックボックスがオンの場合、タイトルページを生成するようにLaTeXエンジンに命令します。タイトルページには、プロジェクトタイトルと現在日付と作成者名が書かれ、ドキュメントの最初のページに出力されます。このチェックボックスがオンの場合、pandocに対し2ページ目に目次を生成するように命令します。(タイトルページを生成しない場合は、1ページ目になります。このドロップダウンリストでは、どの見出しを目次に使用するかを選択します。デフォルトは「2」で、pandocに2段階目までの見出し(##と#の見出し)を使って目次を作るように命令します。4を設定すると1、2、3、4段階目の見出し(#、##、###、####)が使われます。これ以外の見出しはファイル中には存在したままですが、目次には現れなくなります。プロジェクトでカスタムTeXテンプレートを使用することもできます(これは例えば、投稿するジャーナルで指定のものなどです)。通常の設定ダイアログのエクスポートタブで指定したデフォルトのCSLスタイルを上書きしてカスタムテンプレートを使用することもできます。現在のところ、ページタブとフォントタブは、プロジェクト設定と通常のPDF設定で共通の物となっています。これらについては、PDF設定のページを参照してください。プロジェクトをビルドする¶プロジェクトをビルドすると、Zettlrは以下で説明するステップに従って最終的なPDFを生成します。プロジェクトのエクスポート時の動作について知るには、これらを注意して読んでください。最初に、プロジェクトディレクトリを走査して、すべての内容を1次元の配列にします。すべてのサブフォルダと、そこに含まれるファイルを、平坦化して単なるリストにします。それは何のためでしょうか?ファイルリストを見てみてください。内部的には、ファイルをエクスポートする前に、Zettlrはファイルをプレビューペインのように正確に並べます。プレビューリストを確認すれば、ファイルの順番を正確に把握することができます。意図的にこのようにしてあるので、論文の提出後に3つの章が抜けていることに気づくという悪夢のようなことは発生しません。Zettlrはすべてのサブディレクトリを使用することに注意してください。これは、巨大なプロジェクトで好きなだけ多くのサブディレクトリを使える利便性のためです。プレビューリストがそのまま出力されます。(すべてのディレクトリ構造は単に無視されます。)そのため、2階層目のサブディレクトリにメモを詰め込んで、それらを最終原稿にどうやって取り込むか考えるような使い方はしないでください。エクスポート対象外のファイルを追加したい場合は、単にプロジェクトディレクトリ内に2つフォルダを作って、片方に作業用ファイルを入れてください。一方をエクスポートするためのプロジェクトに変換します。ファイルが読み込まれると、それらを結合する前に小さな変更が加えられます。(pandocとLaTeXが画像を見つけられるようにパスが正規化されます。)それから、結合された巨大なファイルが一時フォルダに保存されます。次に、Zettlrはプロジェクトの設定を読み込み、単一ファイルからPDFを生成するときと同様のプロセスに従います。エクスポート処理を起動し、設定と一時ファイルを受け渡し、pandocとLaTeXが動作できるようにします。エクスポートが完了すると、自動的にデフォルトのPDFプレビューアプリで開かれます。ファイルは自動的にプロジェクトディレクトリ内に保存されます。巨大なプロジェクトでの目次の生成は、非常に時間が掛かる可能性があることに注意してください。目次を生成する場合、実際にはLaTeXは2回PDFをビルドします。1回目はPDFに変換後、どのページに見出しが現れるかを調べるため、そして2回目は実際に目次を含めてビルドが行われます。10のコンピュータで、約150ページを出力するのにおよそ5分を要し、その間何も動作していないように見えました。したがって、pandocやLaTeXが文句を言わない間は動作し続けていますので、辛抱強くお待ちください。FAQなどで知っているかもしれませんが、ZettlrとpandocはMarkdownドキュメント中のTeXコマンドを取り除きません。プロジェクトで作業する間、このことを覚えておいてください。追加のページを作ったり、その他の面白いことをファイルに対して実行して最終出力に残すことができます。新しいファイルを作成するときに拡張子を指定することで、.texファイルを作ることもできます。.texドキュメントではLaTeXのシンタックスハイライトがサポートされ、プロジェクトのエクスポート時にも含まれます。ファイル名を付ける際には、ファイルを出力したい位置に並ぶように注意してください。プロジェクトを取り除く¶プロジェクトを取り除くには、対象のプロジェクトを右クリックして「プロジェクトを取り除く」を選択します。すると、ディレクトリがプロジェクトであることを示すための小さな設定ファイル(.ztr-project)が削除されます。したがって、プロジェクトを取り除くと、実際にはプロジェクトの設定を削除することになります。プロジェクトを作成すると、設定ファイルが再び作られますが、デフォルト設定となります。プロジェクトを取り除くと設定が削除され、再び設定しなおす必要があることを覚えておいてください。