マニュアル目次 ＞ 設定画面

URL収集

メニュー：静的HTMLジェネレーター ＞ 設定 ＞ URL収集

このセクションで決めること

全ページ再生成のときに、サイトのどのページを静的化の対象として集めるかです。集めたURLに加えて、「差分生成する内容」で登録したページも対象になります。

集め方（5つ）

項目内容
検索インデックスから収集初期値: 有効 baserCMS のサイト内検索用インデックスに載っているページを拾います。通常はこれとその下の2つで足ります。
コンテンツから収集初期値: 有効 固定ページやブログのトップなど、コンテンツ管理に登録されているページを拾います。検索インデックスに載らない設定のページを補えます。
コンテンツ管理にあるブログは、記事詳細・カテゴリ別・タグ別・年別／月別・ページ送り・RSS まで自動で洗い出します（全ページ再生成のメッセージでは 自動列挙 として数えます）。
チェックを外すと、この自動列挙も行いません。ブログのページは1件も作られなくなるので、外す場合は「手動登録URL」「sitemap.xmlから収集」「HTMLのリンクを辿って収集」で拾ってください。
sitemap.xmlから収集初期値: 無効 CMS側に sitemap.xml を出力するプラグインを入れている場合に、その中のURLを拾います。独自プラグインのページを、このプラグインの設定を触らずに対象へ入れたいときに使えます。
このプラグインが公開サイトへ書き出す sitemap.xml とは別のものです（こちらはCMS側から読む収集元）。sitemapindex 形式の場合は子サイトマップも読みます。
HTMLのリンクを辿って収集初期値: 無効 生成したページの中のリンクを辿って、新しいURLを対象に加えます。一覧ページはあるが詳細ページの一覧をCMSから取れない、といったプラグインへの最後の手段です。
下の「クロール許可パターン」を必ず指定してください。空のままだとリンクを辿りません（サイト中のあらゆるリンクを辿ってジョブが際限なく増えるのを防ぐためです）。
手動登録URL 1行1URL。上の方法では拾えないページを手で足します。
sitemap.xml はここに書かないでください。このプラグインが自分で組み立てるため、種別「sitemap.xml」の差分生成する内容を作成してください。

クロールの設定

項目内容
クロール許可パターン 辿ってよいURLを1行1パターンで指定します（例 /property/**）。ここに当てはまるリンクだけを辿ります。「URL除外パターン」に当てはまるものは、ここに書いてあっても対象になりません。
空のまま「HTMLのリンクを辿って収集」を有効にすると、保存時に警告が出ます（そのままではリンクを辿りません）。
クロールの深さの上限初期値: 3 収集の起点から何回リンクを辿るかの上限です（1〜10）。1なら起点のページに直接書かれたリンクまで。

パターンの書き方

除外パターン・許可パターン・同期パターンはすべて同じ書き方です。1行に1つ書きます。

書き方意味例
*1階層ぶんの任意の文字（/ をまたぎません）/news/* は /news/abc に一致、/news/abc/def には一致しません
**階層をまたぐ任意の文字/members/** は /members/ 以下すべてに一致します
そのまま完全一致/contact/ はそのURLだけに一致します
フォルダの中身をすべて指定するときは、末尾に /** を付けてください。 * は「/」をまたがないので、/pdf や /pdf/* ではフォルダの中身すべてにはなりません。
  • /pdf … そのフォルダ自体を指すだけで、中のファイルには1件も当たりません
  • /pdf/* … /pdf/a.pdf には当たりますが、/pdf/2026/a.pdf には当たりません（直下だけ）
  • /pdf/** … /pdf/ より下のすべてに当たります（子も孫も）

URL除外パターン

静的化してはいけないURLを指定します。ログイン画面・フォームの送信先・会員専用ページなど、静的HTMLにすると壊れるページや、公開してはいけないページを除きます。

この除外は、どの経路から登録されたURLにも共通で効きます（上の収集方法・手動登録・差分生成する内容・他プラグインからの登録すべて）。

初期値

/baser/**
/admin/**
/search/**
/contact/confirm/**
/contact/submit/**
/members/**

URLの読み替え

生成したHTMLの中のリンク先だけを、CMS上のURLとは別のURLへ差し替えます。

公開先が別サーバーでPHPが動かない場合に使います。例えば /contact/index は baserCMS のメールフォームなので、静的HTMLにしても送信できません。Googleフォームや、別に用意したフォームへリンクを向け直してください。

読み替え元読み替え先
/contact/indexhttps://forms.gle/xxxx
/apply/apply.html
/contact/index・/contact/・/contact はすべて同じページとして扱います。 どの書き方で登録しても、ページ内のどの書き方のリンクにも当たります。テーマによってリンクの書き方が揺れていても大丈夫です。
差し替えるのはリンク先だけです。読み替え元のページ自体は静的化されます。 公開したくない場合は、上の「URL除外パターン」にも同じURLを追加してください。

読み替え先に指定できる形

https://forms.gle/xxxx     … http:// または https:// から始まる外部URL
/contact.html              … 「/」から始まる公開サイト内のURL

（空白や引用符は使えません。javascript: なども保存できません）

クエリ文字列ホワイトリスト

通常は空欄のままにしてください。静的サイトは「?」以降を区別できないため、URLからクエリ文字列を落として静的化します。ここに書いたパラメータ名だけは残します。

← 基本・実行・全生成 静的ファイル同期 →