静的ファイル
サイトルートで 静的に (現状のまま、変更なしで) 提供されるファイル。
On this page
デフォルトでは、サイトプロジェクト内の 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
を設定する例です。
上記で、テーマが使われていない場合は、
- 英語版サイトでは、“static1”、“static2”、“static_en” の 3つを統合して静的ファイルを取得することになります。ファイルの重複がある場合は、一番右のバージョンが優先されます。
- ノルウェー版サイトでは、“staticDir_override” と “static_no” の 2つを統合して静的ファイルを取得することになります。
- 注 1
staticDir2
の 2 (0 から 10 までの数字) は、このディレクトリをstaticDir
で定義された静的ディレクトリのグローバルセットに 追加 したいことを Hugo に伝えるために追加されます。言語レベルでstaticDir
を使用すると、グローバルな値に置き換わります (ノルウェー版サイトのケースに見られるように)。- 注 2
- 上記の例は マルチホスト設定 です。 通常のセットアップでは、すべての静的ディレクトリがすべてのサイトで利用可能になります。