github.com/lyeb/hugo@v0.47.1/docs/content/en/themes/creating.md (about)

     1  ---
     2  title: Create a Theme
     3  linktitle: Create a Theme
     4  description: The `hugo new theme` command will scaffold the beginnings of a new theme for you to get you on your way.
     5  date: 2017-02-01
     6  publishdate: 2017-02-01
     7  lastmod: 2017-02-01
     8  categories: [themes]
     9  keywords: [themes, source, organization, directories]
    10  menu:
    11    docs:
    12      parent: "themes"
    13      weight: 30
    14  weight: 30
    15  sections_weight: 30
    16  draft: false
    17  aliases: [/themes/creation/,/tutorials/creating-a-new-theme/]
    18  toc: true
    19  wip: true
    20  ---
    21  
    22  {{% warning "Use Relative Links" %}}
    23  If you're creating a theme with plans to share it with the community, use relative URLs since users of your theme may not publish from the root of their website. See [relURL](/functions/relurl) and [absURL](/functions/absurl).
    24  {{% /warning %}}
    25  
    26  Hugo can initialize a new blank theme directory within your existing `themes` using the `hugo new` command:
    27  
    28  ```
    29  hugo new theme [name]
    30  ```
    31  
    32  ## Theme Folders
    33  
    34  A theme component can provide files in one or more of the following standard Hugo folders:
    35  
    36  layouts
    37  : Templates used to render content in Hugo. Also see [Templates Lookup Order](/templates/lookup-order/).
    38  
    39  static
    40  : Static files, such as logos, CSS and JavaScript.
    41  
    42  i18n
    43  : Language bundles.
    44  
    45  data
    46  : Data files.
    47  
    48  archetypes
    49  : Content templates used in `hugo new`.
    50  
    51  
    52  ## Theme Configuration File
    53  
    54  A theme component can also provide its own [Configuration File](/getting-started/configuration/), e.g. `config.toml`. There are some restrictions to what can be configured in a theme component, and it is not possible to overwrite settings in the project.
    55  
    56  The following settings can be set:
    57  
    58  * `params` (global and per language)
    59  * `menu` (global and per language)
    60  * `outputformats` and `mediatypes`
    61  
    62  
    63  ## Theme Description File
    64  
    65  In addition to the configuration file, a theme can also provide a `theme.toml` file that describes the theme, the author and origin etc. See [Add Your Hugo Theme to the Showcase](/contribute/themes/).
    66  
    67  
    68  {{% note "Use the Hugo Generator Tag" %}}
    69  The [`.Hugo.Generator`](/variables/hugo/) tag is included in all themes featured in the [Hugo Themes Showcase](http://themes.gohugo.io). We ask that you include the generator tag in all sites and themes you create with Hugo to help the core team track Hugo's usage and popularity.
    70  {{% /note %}}
    71  
    72