サイトをドメインまるごとではなく example.com/field-notes/ の下に置きたい。よくある要件です。メインのサイトは別のシステムで、ブログはその下にぶら下げるだけ、という形です。
Astro で対応する設定は base の 1 行だけです。だから私たちは、このガイドは短くなるだろうと思っていました。
ところが、新しくブログテンプレートのサイトを作り、base: "/field-notes" を設定してビルドし、起動して、すべてのアドレスを curl で叩いてみると、1 行の設定以外にも思ったより多くのことがありました。以下は、実際に見たものです。
テスト環境:EmDash 1.4.0、Node アダプター、SQLite、公式ブログテンプレート。テンプレート付属の 8 本の記事は emdash seed で投入しました。
export default defineConfig({
output: "server",
base: "/field-notes",
// ...
});
どのアドレスが base に従って移動したか?
まず良い知らせです。ページ自体は問題ありません。
| アドレス | 結果 |
|---|---|
/field-notes/ | 200 |
/field-notes/posts | 200 |
/field-notes/rss.xml | 200 |
/field-notes/robots.txt | 200 |
どのアドレスが動かなかったか?
管理画面と API はその場に残ります。
| アドレス | 結果 |
|---|---|
/_emdash/api/health | 200 |
/_emdash/admin | 302。/_emdash/admin/setup にリダイレクト |
つまり、/_emdash で始まるものはすべて /field-notes の中には移りません。前段のルーティング規則は、/field-notes/* と /_emdash/* の両方をこのアプリケーションに送る必要があります。前者だけを送ると、管理画面は開きません。
ほかに私たちが出くわした 2 つのアドレスも触れておきます。/field-notes/_emdash/api/health と /field-notes/sitemap.xml は、どちらも 500 を返します。もともとアクセスされるべきアドレスではありませんが、チェック用スクリプトが「プレフィックスを付けて再試行する」という作りだと、驚くことになります。
もう 1 つ意外だったのは、ルートの / と /posts も 200 を返すことです。同じ内容に入口が 2 つあるということです。検索エンジンに 2 つのコピーを見せたくなければ、前段のルーティングで /field-notes/* と /_emdash/* だけを通し、それ以外は拒否してください。
ページ内のリンクには、1 つもプレフィックスが付いていない
これが私たちにとっていちばん予想外だった点です。/field-notes/ のトップページを開いてソースを表示すると、リンクは次のようになっています。
- 記事 7 本:
/posts/a-weekend-with-a-side-projectなど - タグ 4 つ:
/tag/opinionなど - ナビゲーションバー:
/、/pages/about、/posts - そのほか
/rss.xml、/search
どれにも /field-notes は付いていません。クリックするとサブパスから外れ、ルートパスの下に落ちます。
リンクの出どころは 2 か所あり、直す場所が違います。
- テンプレートのコードに直接書かれているもの。 たとえば
src/pages/posts/[slug].astroのhref={`/tag/${t.slug}`}や、いくつものページにあるhref="/posts"です。これらはimport.meta.env.BASE_URLで始まるように書き換える必要があります。 - データベースに保存されているもの。 ナビゲーションの 3 項目は、テンプレートに書かれているのではなく、メニューのデータとして
_emdash_menu_itemsテーブルに保存されており、アドレスは/、/pages/about、/postsです。テンプレートだけを直しても、ナビゲーションバーはまったく変わりません。メニュー項目自体のアドレスを変えるか、シードファイルを変えて読み込み直す必要があります。
このテンプレートでのこうした書き方は、テンプレート自身の選択であり、base の設定に問題があるわけではありません。また、テンプレート全体を書き換えて検証したわけでもないので、ここでお伝えできるのは探す場所までです。直せばすべて正しくなる、とまでは保証できません。
機械が読むアドレスにも、プレフィックスがない
人が見るリンクのほかに、機械が読むものが 3 つあるので、それも確認しました。
/sitemap.xmlに並ぶアドレスは.../sitemap-posts.xmlのような形で、その中の記事アドレスは.../posts/the-case-for-staticのような形です。どれにも/field-notesはありません。- RSS の各記事の
<link>も同じく.../posts/...です。 - ルートの
/robots.txtにはDisallow: /_emdash/があり、サイトマップも指しています。一方/field-notes/robots.txtにはUser-agent: *とAllow: /しかなく、/_emdash/のブロックもサイトマップもありません。
最後の点は少し考える価値があります。検索エンジンが robots.txt を読みに行くのは、ドメインのルートだけです。サブパスの下に置いたものは、実際には誰にも読まれません。メインのサイトが EmDash でない場合は、メインサイトの robots.txt で /_emdash/ を自分でブロックする必要があります。
サイトマップや RSS にプレフィックスがないということは、検索エンジンに送るアドレスがサブパスの外のアドレスになるということです。この点は現象を確認しただけで、どのコードの何行目が決めているのかまでは追っていません。
開発モードは惑わせる
私たちは最初 astro dev でテストしていて、結果は次のとおりでした。
/_emdash/api/healthが 500 を返し、ログにはCannot read properties of undefined (reading 'registry')と出ました。/sitemap.xmlが 500 を返し、内容はEmDash not configuredでした。
base がランタイムを壊したのだと思いました。base を外すと、2 つのアドレスはまた 200 に戻り、確信はさらに強まりました。
ところが、先に astro build を実行して node ./dist/server/entry.mjs で起動する方法に切り替えると、base を設定した状態でも、先ほどの 2 つのアドレスは 200 を返しました。
ですから、サブパスの設定が正しいかどうかを開発モードで判断してはいけません。2 つのモードで差が出る理由は、突き止められていません。
公開前に、私たちが手で確認する箇所
- ビルドして起動し、curl で
/field-notes/のトップページのソースを見る。href="/で始まるのに/field-notesを含まないリンクがないか探す。 /_emdash/adminを開き、前段のルーティング規則がアプリケーションに送っていることを確認する。sitemap.xmlとrss.xmlの中のアドレスを見る。- メインサイトの
robots.txtで/_emdash/がブロックされていることを確認する。 /と/postsにアクセスして、それらを存在させたいかどうかを決める。
私たちがテストしていないこと
- 前段のルーティング規則を、実際の Cloudflare Worker や nginx に置いては試していません。「
/field-notes/*と/_emdash/*の両方を送る必要がある」という上の説明は、観察した挙動から導いたものです。 - Cloudflare アダプターでは試していません。試したのは Node だけです。
- テンプレート全体のリンクを書き換えきってはいません。
サブパスを使わずに済むなら、独立したサブドメインを使えば、この記事の内容のほとんどは不要になります。