公開とトラブルシューティング

公開の境界を決める

記事とサイトを分けたら、何を公開し、何を公開しないかを明確にします。

公開はどう決まるか

content.filters.publishStrategy は、frontmatter で公開状態を指定していないノートの扱いを決めます。既定は explicit です。

frontmatter の visibility と publishAt は、publishStrategy より優先されます。

visibility や publishAt が不正な場合、推測せずにビルドを失敗させます。publishAt はビルド時刻だけで判定するため、Riebeckite が実行時にタイマーを起動することはありません。公開時刻を過ぎても記事が出ない場合は、次のビルドかデプロイを実行してください。

非公開の Vault で explicit を使うのが最も安全です。公開し忘れることはあっても、意図しないノートが公開される可能性は低くなります。

リポジトリの公開範囲と Riebeckite の公開判定は別です。

flowchart TD
    Repo["Git リポジトリ"]
 
    Repo --> RepoVisibility["リポジトリの公開範囲<br/>public / private"]
 
    Repo --> Riebeckite["Riebeckite"]
 
    Riebeckite --> Exclude["exclude"]
    Exclude --> Strategy["publishStrategy / visibility"]
    Strategy --> Site["公開サイト"]

公開時に守るルール

• 非公開のノートに publish: true や visibility: public を付けない。非公開用のディレクトリは content.exclude で丸ごと除外する。
• .obsidian/ を exclude に入れ、Obsidian の設定やワークスペースの状態をサイトに混ぜない。
• Templates/** などのテンプレート用ディレクトリを除外し、テンプレートが記事として公開されないようにする。
• publishStrategy、visibility、publishAt のどれで公開を決めているかを把握する。
• アセットは種類ごとに公開方法が違うことを意識する。

アセットは種類ごとに公開方法が違う

Vault 内のアセットは3種類に分かれ、公開を担当する場所も異なります。

コンテンツ画像は、公開ページから参照されているものだけがビルドの出力に含まれます。public/ へ手動でコピーする必要はありません。

添付ファイルやメディアは URL が生成されるだけで、実ファイルは自動ではコピーされません。

![[attachments/report.pdf]]

この参照が URL に変換されても、report.pdf が公開出力になければブラウザでは 404 になります。

flowchart LR
    Image["コンテンツ画像<br/>assets/logo.png"]
    Attach["![[attachments/report.pdf]]"]
 
    Image -->|"ビルドが書き出す"| Output["公開出力"]
    Attach -->|"URL だけ生成"| Prebuild["ビルド前にコピー"]
    Prebuild --> Output

公開する添付ファイルやメディアだけを public/assets/attachments/ へコピーする prebuild 処理を、サイト側に用意してください。Vault 全体を public/ へコピーすると、非公開記事や未参照のファイルまで公開される可能性があります。

参照実装は Riebeckite リポジトリの website/scripts/build_images.ts にあります。アセットの種類と公開方法の詳細は Attachment ・ Media と公開 を参照してください。

よくある質問

サイト内の content/ のまま、一部だけ非公開にできる？

できます。content.directory を既定の content のままにして、非公開ノートから publish: true を外し、必要に応じてディレクトリを exclude へ追加します。リポジトリを分けるのは Vault を物理的に別の場所へ置くための方法で、公開の制御は publishStrategy、visibility、exclude の役割です。

Vault を移動したら記事が表示されなくなった

content.directory は相対パスなので、Vault を動かすとサイトルートからの距離が変わります。inspect config で解決済みの Directory を確認し、../ の数を直してください。絶対パスも使えますが、開発端末と CI でずれやすいため、通常は相対パスが扱いやすくなります。

記事は表示されるのにアセットだけ 404 になる

まずアセットの種類を確認します。画像が 404 なら、公開ページから実際に参照されているかを見てください。コンテンツ画像は、公開ページからの参照があるものだけがビルドの出力に含まれます。

添付ファイルやメディアが 404 なら、prebuild のコピー処理を確認します。ビルドより前に実行され、public/assets/attachments/ へコピーされる必要があります。

CI でだけ Vault が見つからない

CI には、追加のチェックアウトかサブモジュールを設定しない限り Vault がありません。手順5の設定を確認し、相対パスの directory が CI 上の配置と一致しているかを見てください。たとえば CI で content/ にチェックアウトするなら directory: "content"、notes/ に置くなら directory: "notes" です。

publishAt の時刻を過ぎたのに公開されない

publishAt はビルド時の時刻で判定します。時刻を過ぎた後にビルドとデプロイを実行してください。定期実行したい場合は、サイトのワークフローに schedule を追加します。

Windows でも同じ設定を使える？

はい。exclude のパターンは / 区切りで書き、OS のパス区切りには依存しません。

原因を切り分ける

記事が公開されないときは、次の順番で確認すると原因を絞れます。

flowchart TD
    Start["記事が公開されない"]
 
    Start --> Source{"記事を読めている？"}
    Source -->|"いいえ"| Directory["content.directory<br/>外部チェックアウト"]
    Source -->|"はい"| Exclude{"exclude されている？"}
 
    Exclude -->|"はい"| Config["exclude を確認"]
    Exclude -->|"いいえ"| Publish{"公開条件を満たす？"}
 
    Publish -->|"いいえ"| Frontmatter["publish: true<br/>visibility / publishAt"]
    Publish -->|"はい"| Build{"ビルドは成功した？"}
 
    Build -->|"いいえ"| Diagnostics["check / doctor"]
    Build -->|"はい"| Deploy{"デプロイされた？"}
 
    Deploy -->|"いいえ"| CI["dispatch / ワークフローを確認"]
    Deploy -->|"はい"| Asset{"画像だけ問題？"}
 
    Asset -->|"はい"| Copy["アセットの参照と出力を確認"]

より詳しい調査方法は、リポジトリ分離の詳細編 のトラブルシューティングを参照してください。