外部エディタ

お好みの外部エディタを設定するには、設定ファイルeditorオプションを更新してください。エディタがオペレーティングシステムのPATH環境変数に含まれていない場合は、エディタのフルパスを入力する必要があります。

設定が完了したら、jrnlコマンドを単独で使用して、エディタで新しいドキュメントとしてエントリーを作成できます:

jrnl

ドキュメントの最初の行に、通常通りエントリーの時間とタイトルを指定できます。

クイックエントリーを含めることで、エディタをスキップすることもできます:

jrnl yesterday: All my troubles seemed so far away.

コマンドラインでエントリーを開始し、選択したエディタで書き続けたい場合は、--editフラグを使用します。例:

jrnl yesterday: All my troubles seemed so far away. --edit

Note

エントリーの編集を保存してログに記録するには、ファイルを保存して閉じてください。

jrnlで動作するには、すべてのエディタがブロッキングプロセスである必要があります。microのような一部のエディタはデフォルトでブロッキングですが、他のエディタは以下に記載されているような追加の引数でブロッキングにすることができます。jrnlがエディタを開いても即座に実行が終了する場合、そのエディタはブロッキングプロセスではありません。以下の提案のいずれかで修正できる可能性があります。

エディタが機密情報を漏洩する可能性とそのリスクを軽減する方法については、このセクションを参照してください。

Sublime Text

Sublime Textを使用するには、Sublime Textのコマンドラインツールをインストールし、jrnl.yamlを以下のように設定します:

editor: "subl -w"

-wフラグは、jrnlがSublime Textがファイルを閉じるのを待ってからジャーナルに書き込むようにするためのものです。

Visual Studio Code

Visual Studio Codeも、プロセスがファイルを閉じるまで待機するように指示するフラグが必要です:

editor: "code --wait"

Windowsでは、codeはデフォルトでパスに追加されていないので、code.exeファイルのフルパスを入力するか、PATH変数に追加する必要があります。

MacVim

Sublime Textと同様に、MacVimもプロセスがファイルを閉じるまで待機してからジャーナルに制御を戻すように指示するフラグで起動する必要があります。MacVimの場合、このフラグは-fです:

editor: "mvim -f"

Vim/Neovim

Linuxでエディタとしてvimの派生版を使用するには、単純にeditorを実行ファイルに設定します:

editor: "vim"
# または
editor: "nvim"

iA Writer

OS Xでは、素晴らしいiA Writerを使用してエントリーを書くことができます。jrnl.yamlを以下のように設定してください:

editor: "open -b pro.writer.mac -Wn"

これは何をしているのでしょうか?open -b ...は、バンドル識別子(すべてのアプリに固有の文字列)で識別されるアプリケーションを使用してファイルを開きます。-Wnは、制御を戻す前にアプリケーションが閉じるまで待つこと、およびアプリケーションの新しいインスタンスを使用することをアプリケーションに指示します。

システムでpro.writer.macバンドル識別子が見つからない場合は、シェルでiA WriterのInfo.plistファイルを調べることで、使用する正しい文字列を見つけることができます:

grep -A 1 CFBundleIdentifier /Applications/iA\ Writer.app/Contents/Info.plist

Windows上のNotepad++

Notepad++をエディタとして設定するには、jrnlの設定ファイル(jrnl.yaml)を以下のように編集します:

editor: "C:\\Program Files (x86)\\Notepad++\\notepad++.exe -multiInst -nosession"

二重のバックスラッシュは、jrnlがファイルパスを正しく読み取るために必要です。-multiInst -nosessionオプションにより、jrnlは独自のNotepad++ウィンドウを開きます。

emacs

emacsをエディタとして使用するには、jrnlの設定ファイル(jrnl.yaml)を以下のように編集します:

editor: emacsclient -a "" -c

メッセージの編集が終わったら、保存してC-x #でバッファを閉じ、emacsclientプロセスを停止します。

その他のエディタ

他のエディタを使用していて、共有したい場合は、ドキュメントの貢献を自由に行ってください。