デフォルトテーマ
デフォルトテーマ(Methanol リポジトリ内 themes/default)は、サイトの基礎となるレイアウト、サイドバーナビゲーション、および標準的なスタイルを提供します。
主要機能
- ページ構造に基づき自動生成されるサイドバーナビゲーション
- 見出し階層に応じたページ内目次(オプション)
- ディレクトリの
index.mdxにlangが設定されている場合の言語スイッチャー - Pagefind を利用した全文検索 UI の統合
言語スイッチャー
ディレクトリ(ルートを含む)の index.mdx において frontmatter.lang が定義されている場合、言語スイッチャーが自動的に有効化されます。表示されるラベルは lang の値に基づき、現在の選択状態は ctx.language によって判定されます。
全文検索 (Pagefind)
設定ファイルで pagefind: true を有効にし、プロジェクトに Pagefind をインストールすることで、検索機能が利用可能になります。
npm i -D pagefind
pagefind が有効な場合、Methanol はビルドプロセスの最後に Pagefind CLI を実行し、dist/pagefind に検索用索引を生成します。
構文ハイライト (Starry Night)
本テーマの CSS には、Starry Night によるコードハイライト用のスタイルが組み込まれています。
「このページを編集」リンク (site.repoBase)
フッター領域にソースコードへの編集リンクを表示できます。
site.repoBase に、リポジトリ内のコンテンツディレクトリ(pages/ など)を指すベース URL を設定してください。
// methanol.config.js
export default () => ({
site: {
repoBase: 'https://github.com/OWNER/REPO/edit/main/pages/'
}
})
個別のページのフロントマターに sourceURL が定義されている場合は、site.repoBase よりもその値が優先されます。