Astro ブログの実例


examples/astro-blog は、.csn / .csnx で記事を書く Astro サンプルです。記事一覧、タグ、逆リンク、2 hop リンク、Cosense からのページ取得などを試せます。

起動する

この例はリポジトリのワークスペース外にあり、npm に公開されたパッケージを使います。ディレクトリへ移動して依存関係をインストールし、開発サーバーを起動します。

Shell
cd examples/astro-blog
bun install
bun run dev

サンプルの内容

src/content/posts/ に .csn の記事と、コンポーネントを使う .csnx の記事があります。draft.csn は下書きの例です。
src/pages/about.csnx は Astro のページとして直接配信する例です。src/pages/posts/[slug].astro は記事ページとリンクグラフを、src/pages/tags/[tag].astro はタグ別一覧を作ります。
Astro 統合の設定は astro.config.mjs、.csnx から使うコンポーネントは src/components/cosense.ts にあります。

手元のパッケージで試す

公開前の変更を試す場合は、対象パッケージをビルドして bun link で example から参照します。package.json や bun.lock は書き換わりません。

Shell
# 対象パッケージのディレクトリで実行
bun run build
bun link
# examples/astro-blog で実行
bun link @cosense-toolbox/astro

npm に公開された版へ戻すときは bun install --force を実行します。ディレクトリ構成やリンク方法の詳細は サンプルの README をご覧ください。