github.com/shohhei1126/hugo@v0.42.2-0.20180623210752-3d5928889ad7/docs/content/en/content-management/static-files.md (about)

     1  ---
     2  title: Static Files
     3  description: "The `static` folder is where you place all your **static files**."
     4  date: 2017-11-18
     5  categories: [content management]
     6  keywords: [source, directories]
     7  menu:
     8    docs:
     9      parent: "content-management"
    10      weight: 130
    11  weight: 130	#rem
    12  aliases: [/static-files]
    13  toc: true
    14  ---
    15  
    16  The `static` folder is where you place all your **static files**, e.g. stylesheets, JavaScript, images etc.
    17  
    18  You can set the name of the static folder to use in your configuration file.  From **Hugo 0.31** you can configure as many static directories as you need. All the files in all the static directories will form a union filesystem.
    19  
    20  Example:
    21  
    22  {{< code-toggle copy="false" file="config" >}}
    23  staticDir = ["static1", "static2"]
    24  [languages]
    25  [languages.no]
    26  staticDir = ["staticDir_override", "static_no"]
    27  baseURL = "https://example.no"
    28  languageName = "Norsk"
    29  weight = 1
    30  title = "På norsk"
    31  
    32  [languages.en]
    33  staticDir2 = "static_en"
    34  baseURL = "https://example.com"
    35  languageName = "English"
    36  weight = 2
    37  title = "In English"
    38  {{</ code-toggle >}}
    39  
    40  In the above, with no theme used:
    41  
    42  * 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.
    43  * The Norwegian site will get its static files as a union of "staticDir_override" and "static_no".
    44  
    45  **Note:** The `2` `static2` (can be a number between 0 and 10) is added to tell Hugo that you want to **add** this directory to the global set of static directories. Using `staticDir` on the language level would replace the global value.
    46  
    47  
    48  **Note:** The example above is a [multihost setup](/content-management/multilingual/#configure-multilingual-multihost). In a regular setup, all the static directories will be available to all sites.