Pandocのインストール¶

Pandocはドキュメントファイルの形式を相互に変換することのできる小さなプログラムです。それは非常にパワフルで多くの機能を持っています。Zettlrでインポートとエクスポートを行うためには、Pandocのインストールが必要です。Zettlr自体にはインポートとエクスポートを行うための機能は内蔵されていません。その理由は、Pandocが非常によくできていて、フリーでオープンソースであり、Zettlrのサポートするすべての環境で利用可能であるということです。

ZettlrはPandocのバージョン2.0以降を必要とします。Linuxリポジトリによっては、未だに古いバージョンが提供されています。そのような場合は、Pandocのダウンロードページからインストールしてください。

Windows¶

Windowsでは、PandocのダウンロードページからWindowsインストーラを取ってきてインストールすることができます。他のアプリケーションと同様にインストールすることができ、すぐにZettlrに認識されます。何かをインポートまたはエクスポートすることで、動作の確認をすることができます。

まれに、Pandocをインストールしたにもかかわらず、Zettlrに認識されないことがあります。特に、デフォルトとは異なるディレクトリにPandocをインストールしたような場合です。そのような場合は、pandoc.exeのフルパスを、設定ダイアログの「高度な設定」タブの該当の項目に設定してください。

pandocはCLIプログラム(コマンドラインインターフェース)のため、アップデートが利用可能かどうか通知することができません。時々、ダウンロードページを開いて、自分でアップデートの有無を確認してください。

macOS¶

macOSの場合、様々な方法でpandocをインストールできます。インストーラパッケージを使用することもできますが、Homebrewを使った方法が簡単でおすすめです。

おすすめの方法: Homebrew¶

おすすめの方法は、Homebrewです。Homebrewはpandocのようなコマンドラインプログラムを簡単にインストールし、メンテナンスするためのパッケージマネージャです。Homebrewをインストールしてあることを確認し、ターミナルで次のコマンドを実行してください:

$ brew install pandoc

pandocをアップデートために、時々次のコマンドを実行してください:

$ brew upgrade

これで、すべてのインストール済みformulaが最新バージョンに更新されます。

pandocのセットアップが終わったら、citeprocもインストールしたくなるかもしれません。citeprocは、Zettlrの参考文献機能を利用するために必要です。Windowsでは、citeprocは自動的にインストールされます。macOSの場合は、pandoc-citeprocを追加でインストールします。Homebrewで次のコマンドを実行してください:

$ brew install pandoc-citeproc

早くて便利なので、Homebrewでのインストールを推奨します。

公式インストーラーを使ったインストール¶

pandocをインストールする昔ながらの方法は、ダウンロードページに行って、macOS用のインストーラをダウンロードし実行することです。完了すれば、pandocが使えるようになっているはずです。この方法でインストールした場合、アップデートの確認は手動で行う必要があります。

Linux¶

Linuxでのインストールは非常に簡単です。パッケージマネージャでpandocを検索してインストールするだけです。提供されるパッケージは、常に最新とは限りませんが、適切なバージョンのものです。最新バージョンを使用したい場合は、Linux用インストーラーを使用して、pandocのサイトのインストール手順に従ってください。

pandoc-citeprocの手動インストールが必要な場合があります。お使いのオペレーティングシステムで適切な方法でインストールを行ってください。