41bc6f702a
2c0125b52 Remove .Site.Author 2cf8841b3 Update partialCached.md (#1924) 385487191 Update data-templates.md (#1926) ce207e141 Remove redundant markdown and fix a few typos (#1936) 3687c2953 Make heading id linkable, take 2 45c79bea7 Make heading id linkable b22079344 Delete duplicates the lines 557-569 and 570-582. (#1934) 0a90dc122 Rework the taxonomy variables page (#1935) 7f8979c50 Update theme 26e682a3a Update multilingual.md d40e7693f Update postcss.md 375d75c01 Update postcss npm instructions (#1931) 63020094a Emphasize Window shell selection (#1930) 56824be2c Update configuration.md b7b8f16b3 Docu 'Theme components': minor fix (#1929) 09dc81a05 Remove Docker from BSD page (#1927) 205fea204 netlify: Hugo 0.108.0 6abe49c28 Merge commit 'da670c38ee63a7fef25e2b9f42519232055b60dc' 12b59a4c5 docs: Add basic doc for wrapStandAloneImageWithinParagraph etc. ba07bd970 dartsass: Add sourceMapIncludeSources option git-subtree-dir: docs git-subtree-split: 2c0125b5290494d49334606c451446ebd9df3c21
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="config" >}} 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.