高度な使用方法

設定ファイル

jrnlには、テンプレート、フォーマット、複数のジャーナルなど、設定ファイルを通してカスタマイズできる多様なオプションがあります。詳細については設定ファイルリファレンスを参照するか、以下の一般的な使用例をお読みください。

複数のジャーナルファイル

設定ファイルでより多くのジャーナルを定義することで、jrnlを複数のジャーナル（例：privateとwork）で使用するように設定できます。例えば：

journals:
  default: ~/journal.txt
  work: ~/work.txt

defaultジャーナルはjrnlを初めて起動したときに作成されます。これで、jrnlの代わりにjrnl workを使用してworkジャーナルにアクセスできます。例えば：

jrnl work at 10am: @Steveとのミーティング
jrnl work -n 3

これらはどちらも~/work.txtを使用しますが、jrnl -n 3は~/journal.txtから最後の3つのエントリーを表示します（jrnl default -n 3も同様です）。

各ジャーナルのデフォルトオプションを個別にオーバーライドすることもできます。 jrnl.yamlが以下のようになっている場合：

encrypt: false
journals:
  default: ~/journal.txt
  work:
    journal: ~/work.txt
    encrypt: true
  food: ~/my_recipes.txt

defaultとfoodジャーナルは暗号化されませんが、workジャーナルは暗号化されます！

jrnl.yamlのトップレベルにあるすべてのオプションをオーバーライドできますが、少なくともそのジャーナルのジャーナルファイルを指すjournal: ...キーを指定してください。

以下の設定例を考えてみましょう：

editor: vi -c startinsert
journals:
  default: ~/journal.txt
  work:
    journal: ~/work.txt
    encrypt: true
    display_format: json
    editor: code -rw
  food:
    display_format: markdown
    journal: ~/recipes.txt

workジャーナルは暗号化され、デフォルトでjson形式で出力され、VSCodeの既存のウィンドウで編集されます。同様に、foodジャーナルはデフォルトでmarkdown形式で出力されますが、他のすべてのデフォルト設定を使用します。

コマンドラインから設定を変更する

現在のjrnlインスタンスの設定フィールドを--config-override CONFIG_KEY CONFIG_VALUEを使用してオーバーライドできます。ここで、CONFIG_KEYは有効な設定フィールドをドット表記で指定し、CONFIG_VALUEは希望する（有効な）オーバーライド値です。ドット表記を使用して、colors.titleのような他のキー内のキーを変更することもできます。

複数のオーバーライドを指定するには、--config-overrideを複数回呼び出します。

Note

これらのオーバーライドにより、jrnl設定の任意のフィールドを変更できます。自己責任で使用してください。

例

# 高速ログ記録のために`stdin`プロンプトを使用してエントリーを作成する
jrnl --config-override editor ""

# プロジェクトのログを記録する
jrnl --config-override journals.todo "$(git rev-parse --show-toplevel)/todo.txt" todo タオルを見つける

# 複数のオーバーライドを渡す
jrnl --config-override display_format fancy --config-override linewrap 20 \
--config-override colors.title green

代替設定の使用

現在のjrnlインスタンスに対して、--config-file CONFIG_FILE_PATHを使用して代替設定ファイルを指定できます。ここでCONFIG_FILE_PATHは代替jrnl設定ファイルへのパスです。

例

# 個人的なジャーナルエントリーに個人用設定ファイルを使用する
jrnl --config-file ~/foo/jrnl/personal-config.yaml

# 仕事関連のエントリーに代替設定ファイルを使用する
jrnl --config-file ~/foo/jrnl/work-config.yaml

# デフォルトの設定ファイルを使用する（初回実行時に作成される）
jrnl