トラブルシューティング
サイトを確認する
記事を書いたら、Riebeckite のサイトのディレクトリで開発サーバーを起動します。
npm exec riebeckite dev
ブラウザで公開対象の記事を確認します。
問題がないか確認するには、次のコマンドを実行します。
npm exec riebeckite check
npm exec riebeckite doctor
Riebeckite が実際にどのコンテンツを認識しているかを確認したい場合は、次のコマンドを利用できます。
npm exec -- riebeckite inspect content --list
記事が表示されないとき
記事が表示されない場合は、次の順番で確認すると原因を絞りやすくなります。
Diagram source
flowchart TD
Start["記事が表示されない"]
Start --> Dir{"正しい Vault を<br/>読み込んでいる?"}
Dir -->|"いいえ"| Config["content.directory を確認"]
Dir -->|"はい"| Excluded{"exclude されている?"}
Excluded -->|"はい"| Exclude["content.exclude を確認"]
Excluded -->|"いいえ"| Publish{"publish: true<br/>がある?"}
Publish -->|"いいえ"| Frontmatter["frontmatter を追加"]
Publish -->|"はい"| Diagnose["check / doctor"]
解決済みのコンテンツディレクトリは、次のコマンドで確認できます。
npm exec riebeckite inspect config
読み込まれているコンテンツは、次のコマンドで確認できます。
npm exec -- riebeckite inspect content --list
普段の使い方
設定が終われば、特別な操作はほとんど必要ありません。
Diagram source
flowchart TD
Write["Obsidian でノートを書く"]
Decide{"公開する?"}
Decide -->|"はい"| Publish["publish: true"]
Decide -->|"いいえ"| Private["そのまま"]
Write --> Decide
Publish --> Dev["Riebeckite で確認"]
Private --> Write
Dev --> Push["コミット / デプロイ"]
つまり、普段の執筆方法はこれまでとほぼ同じです。Obsidian で書き、公開したいノートにだけ publish: true を付けます。
Riebeckite は、その Vault を公開サイトのコンテンツソースとして利用します。