静的ファイル

デフォルトでは、サイトプロジェクト内の static/ ディレクトリがすべての 静的ファイル (たとえば、スタイルシート、JavaScript、画像) に使用されます。 静的ファイルは、サイトのルートパスで提供されます (たとえば、ファイル static/image.png があれば、 http://{server-url}/image.png でアクセスでき、ドキュメントに含めるには、 ![Example image](/image.png) ) で可能です)。

Hugo は、サイト設定 に staticDir パラメータを設定することで、そのような静的ファイルを別のディレクトリ、あるいは 複数のディレクトリ を探すように設定することができます。 すべての静的ディレクトリ内のすべてのファイルは、ユニオン ファイルシステムを形成します。

このユニオン ファイルシステムは、サイトのルートから提供されます。つまり、<SITE PROJECT>/static/me.png というファイルは <MY_BASEURL>/me.png としてアクセスすることができます。

以下は、多言語サイトに staticDir と staticDir2 を設定する例です。

languages:
  en:
    baseURL: https://example.com
    languageName: English
    staticDir2: static_en
    title: In English
    weight: 2
  "no":
    baseURL: https://example.no
    languageName: Norsk
    staticDir:
    - staticDir_override
    - static_no
    title: På norsk
    weight: 1
staticDir:
- static1
- static2

staticDir = ['static1', 'static2']
[languages]
  [languages.en]
    baseURL = 'https://example.com'
    languageName = 'English'
    staticDir2 = 'static_en'
    title = 'In English'
    weight = 2
  [languages.no]
    baseURL = 'https://example.no'
    languageName = 'Norsk'
    staticDir = ['staticDir_override', 'static_no']
    title = 'På norsk'
    weight = 1

{
   "languages": {
      "en": {
         "baseURL": "https://example.com",
         "languageName": "English",
         "staticDir2": "static_en",
         "title": "In English",
         "weight": 2
      },
      "no": {
         "baseURL": "https://example.no",
         "languageName": "Norsk",
         "staticDir": [
            "staticDir_override",
            "static_no"
         ],
         "title": "På norsk",
         "weight": 1
      }
   },
   "staticDir": [
      "static1",
      "static2"
   ]
}

上記で、テーマが使われていない場合は、

• 英語版サイトでは、“static1”、“static2”、“static_en” の 3つを統合して静的ファイルを取得することになります。ファイルの重複がある場合は、一番右のバージョンが優先されます。
• ノルウェー版サイトでは、“staticDir_override” と “static_no” の 2つを統合して静的ファイルを取得することになります。

注 1

staticDir2 の 2 (0 から 10 までの数字) は、このディレクトリを staticDir で定義された静的ディレクトリのグローバルセットに 追加 したいことを Hugo に伝えるために追加されます。言語レベルで staticDir を使用すると、グローバルな値に置き換わります (ノルウェー版サイトのケースに見られるように)。

注 2

上記の例は マルチホスト設定 です。 通常のセットアップでは、すべての静的ディレクトリがすべてのサイトで利用可能になります。