リンクとナビゲーション

Methanol はファイルベースルーティングを採用しています。サイト内のリンクは、ルーティングパスを指定するだけで作成できます。

内部リンク

拡張子を除いたルートパスを指定してリンクを作成します。

[執筆の基本](./writing)

表示例: 執筆の基本

ページを移動またはリネームした場合は、リンク先も併せて更新してください。

サブパス配信時の設定（site.base）

サイトをサブパス（例: https://example.com/docs/）で配信する場合は、site.base: '/docs/' を設定してください。その際、本文中で /blog/post のようなルート絶対パスを使用した内部リンクは避ける必要があります。

基本的には相対リンクの使用を推奨します。

[次の記事](./next-post)
[ブログへ戻る](../blog/)

MDX や JSX 内でルート絶対パスのリンクを生成する必要がある場合は、ctx.withBase を使用してパスを処理してください。

<a href={ctx.withBase('/blog/post')}>読む</a>

外部リンク

外部サイトへのリンクには、完全な URL を使用します。

[例](https://example.com)

表示例: 例

ナビゲーションの順序制御

フロントマターを使用することで、表示順序や表示/非表示を詳細に制御できます。

• weight: 数値が小さいほど上位に表示されます。
• hidden: サイドバーのナビゲーションから除外されます。
• isRoot: index.mdx に設定することで、ナビゲーションの起点（ルート）を定義します。

詳細は Frontmatter リファレンス を参照してください。