API › @builder.io/qwik-city/static
generate
この関数は、Viteプラグインなど、別のモジュールからSSGを生成する必要がある場合に使用します。この関数には、エントリモジュールとQwik Cityプランのパスを渡す必要があります。
export declare function generate(
opts: StaticGenerateOptions,
): Promise<StaticGenerateResult>;
パラメータ
型
説明
opts
Promise<StaticGenerateResult>
StaticGenerateOptions
export interface StaticGenerateOptions extends StaticGenerateRenderOptions
拡張: StaticGenerateRenderOptions
プロパティ
修飾子
型
説明
string
(オプション) デフォルトは/
string
デフォルトの@qwik-city-plan
をエクスポートするQwik Cityプランモジュールへのパス。
string
デフォルトのレンダリング関数をエクスポートするSSRモジュールへのパス。ほとんどの場合、./src/entry.ssr.tsx
になります。
string
(オプション)
StaticGenerateRenderOptions
export interface StaticGenerateRenderOptions extends RenderOptions
拡張: RenderOptions
プロパティ
修飾子
型
説明
boolean
(オプション) 静的ビルドでカスタムまたはデフォルトの404.html
ページを書き込まない場合はfalse
に設定します。デフォルトはtrue
です。
boolean
(オプション) 生成されたq-data.json
データファイルをディスクに書き込まない場合はfalse
に設定します。デフォルトはtrue
です。
boolean
(オプション) 生成された静的HTMLファイルをディスクに書き込まない場合はfalse
に設定します。false
に設定すると、SSGはq-data.json
ファイルのみをディスクに書き込みます。デフォルトはtrue
です。
string[]
(オプション) ソースroutes
ディレクトリを基準とした、静的に生成されないファイルシステムルートを定義します。ワイルドカード動作を受け入れます。「base」パス名は含まれません。exclude
は常にinclude
よりも優先されます。
string[]
(オプション) ソースroutes
ディレクトリを基準とした、静的に生成されるファイルシステムルートを定義します。ワイルドカード動作を受け入れます。「base」パス名は含まれません。指定しない場合、すべてのルートが静的に生成されます。exclude
は常にinclude
よりも優先されます。
'debug'
(オプション) ログレベル。
number
(オプション) ワーカーごとに同時に実行できるタスクの最大数です。デフォルトは20
です。
number
(オプション) 静的ページを生成する際に使用するワーカーの最大数です。デフォルトは使用可能なCPU数です。
string
スキーム(プロトコル)とホスト名(ドメイン)を組み合わせたURLのorigin
です。たとえば、https://qwik.dokyumento.jp
のプロトコルはhttps://
、ドメインはqwik.dev
です。ただし、origin
にはpathname
は含まれません。
origin
は、静的サイト生成(SSG)中に完全なURLを提供し、pathname
だけでなく完全なURLをシミュレートするために使用されます。たとえば、正しいカノニカルタグURLまたはsitemap.xml
内のURLをレンダリングするには、origin
も提供する必要があります。
サイトが/
以外のパス名で始まる場合も、Qwik Cityの設定オプションでbasePathname
オプションを使用してください。
string
静的ファイルを書き込むファイルシステムディレクトリ。
string | null
(オプション) sitemap.xml
を書き込むファイルシステムパスです。デフォルトはsitemap.xml
で、outDir
のルートに書き込まれます。null
に設定すると、サイトマップの作成が防止されます。
StaticGenerateResult
export interface StaticGenerateResult
プロパティ
修飾子
型
説明
number
number
number
string[]