CLI
Methanol には、開発サーバーの起動、静的サイトのビルド、およびローカルでのプレビューを行うための軽量な CLI ツールが付属しています。
基本コマンド
npx を使用して実行する方法(推奨):
npx methanol dev # 開発サーバーを起動
npx methanol build # dist/ ディレクトリにビルド成果物を出力
npx methanol serve # ビルド済みの成果物をローカルでプレビュー
CLI の起動速度を向上させたい場合は、グローバルインストールを検討してください。
npm install methanol -g
methanol dev
input(入力)および output(出力)ディレクトリは、位置引数として指定可能です(順序にご注意ください)。
npx methanol build ./pages ./dist
dev コマンドは input 引数のみを受け付けます。
npx methanol dev ./pages
主要なフラグ一覧
--input,-i:pages/ディレクトリの設定を上書きします。--components:components/ディレクトリの設定を上書きします。--assets:public/ディレクトリの設定を上書きします。--output,-o:dist/ディレクトリの設定を上書きします。--config,-c: 設定ファイルのパスを明示的に指定します。--site-name: 設定ファイルのサイト名を上書きします。--base: 今回の実行に限りsite.baseを上書きします(devモードでは無視されます)。--port: 開発およびプレビューサーバーのポート番号(デフォルト: 5173)。--host: サーバーを指定したホストにバインドします(--host単体指定ですべてのインターフェースにバインドします)。--intermediate-dir: 中間 HTML の出力先ディレクトリ(build時のみ有効)。--emit-intermediate:build/ディレクトリへの中間 HTML 出力を有効化します(build時のみ有効)。--code-highlighting: 構文ハイライトの有効/無効を切り替えます(--code-highlightingで有効、--code-highlighting falseで無効)。-v,--verbose: 詳細なログを出力します(ビルド時の Vite や Pagefind のログが含まれます)。
構文ハイライトはデフォルトで無効に設定されており、必要に応じて実行時に有効化できます。
npx を使用しない場合
node node_modules/methanol/bin/methanol.js dev