d3927310d5
1798dc0d5 Update theme 403fa716e Update CLI documentation (#2092) aade5a09e Correct media subtype example 53cd9dea6 netlify: Hugo 0.112.3 b78b86cb1 Add source/target warning to resources.Copy (#2091) 50c299729 netlify: Hugo 0.112.2 73197046f Change config.xxx to hugo.xxx throughout the documentation (#2090) d489d4c6f Add hugo.WorkingDir to docs (#2089) 7487df809 Fix typos (#2088) 6d0572cd6 netlify: Hugo 0.112.1 6838600b2 netlify: Hugo 0.112.0 513e7a80f Merge branch 'tempv0.112.0' 91eb44275 Some more about 0.112.0 bd3b33a27 docs: Regen docshelper fb3027daf docs: Regen CLI docs 8e7b8e987 Merge commit 'f96384a3b596f9bc0a3a035970b09b2c601f0ccb' a942ceef4 tpl/tplimpl: Add img loading attribute to figure shortcode (#10927) 0e0c7b25e tpl/urls: Return empty string when JoinPath has zero args 310ce949a tpl/urls: Add JoinPath template function ae435ca77 tpl: Add math.Abs f340139f8 Revert "Update syntax-highlighting.md (#10929)" (#10930) 917a0e24d Update syntax-highlighting.md (#10929) git-subtree-dir: docs git-subtree-split: 1798dc0d54ce048dd975863b490cd809ef14268a
2.4 KiB
| title | linkTitle | description | categories | keywords | menu | toc | weight | aliases | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Static Files | Static Files | Files that get served **statically** (as-is, no modification) on the site root. |
|
|
|
true | 200 |
|
By default, the static/ directory in the site project is used for
all static files (e.g. stylesheets, JavaScript, images). The static files are served on the site root path (eg. if you have the file static/image.png you can access it using http://{server-url}/image.png, to include it in a document you can use  ).
Hugo can be configured to look into a different directory, or even
multiple directories for such static files by configuring the
staticDir parameter in the site config. All the files in all the
static directories will form a union filesystem.
This union filesystem will be served from your site root. So a file
<SITE PROJECT>/static/me.png will be accessible as
<MY_BASEURL>/me.png.
Here's an example of setting staticDir and staticDir2 for a
multi-language site:
{{< code-toggle copy=false file="hugo" >}} staticDir = ["static1", "static2"]
[languages] [languages.en] staticDir2 = "static_en" baseURL = "https://example.com" languageName = "English" weight = 2 title = "In English" [languages.no] staticDir = ["staticDir_override", "static_no"] baseURL = "https://example.no" languageName = "Norsk" weight = 1 title = "På norsk" {{</ code-toggle >}}
In the above, with no theme used:
- The English site will get its static files as a union of "static1", "static2" and "static_en". On file duplicates, the right-most version will win.
- The Norwegian site will get its static files as a union of "staticDir_override" and "static_no".
- Note 1
- The 2 (can be a number between 0 and 10) in
staticDir2is added to tell Hugo that you want to add this directory to the global set of static directories defined usingstaticDir. UsingstaticDiron the language level would replace the global value (as can be seen in the Norwegian site case). - Note 2
- The example above is a multihost setup. In a regular setup, all the static directories will be available to all sites.