TheCloud/hugoDocs
1
0
Fork 0
mirror of https://github.com/gohugoio/hugoDocs.git synced 2025-09-15 18:04:45 -04:00
Code Issues Packages Projects Releases Wiki Activity

Update Creating Themes Warning

Browse Source 
See https://github.com/gohugoio/hugo/issues/5488#issuecomment-447807350 and https://github.com/gohugoio/hugo/issues/5488#issuecomment-447860467 for the rationale of this PR.

@bep Feel free to reword if you think, this could be improved.
This commit is contained in:
Alexandros 2018-12-17 16:58:02 +02:00 committed by Bjørn Erik Pedersen
parent 40d88d98f7
commit 6f2b9cf0d6
1 changed files with 5 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
content/en/themes/creating.md
View File

@ -20,7 +20,11 @@ wip: true
--- ---
{{% warning "Use Absolute Links" %}} {{% warning "Use Absolute Links" %}}
If you're creating a theme with plans to share it on the [Hugo Themes website](https://themes.gohugo.io/) please note that your theme's demo will be available in a sub-directory of website and for the theme's assets to load properly you will need to create absolute paths in the templates by using either the [absURL](/functions/absurl) function or `.Permalink`. Also make sure not to use a forward slash `/` in the beginning of a `PATH`, because Hugo will turn it into a relative URL and the `absURL` function will have no effect. If you're creating a theme with plans to share it on the [Hugo Themes website](https://themes.gohugo.io/) please note the following:
- If you choose to use relative URLs in your template you need to quote them.
- In style tags you will need to use absolute URLs, for the linked assets to be served properly.
- Make sure not to use a forward slash `/` in the beginning of a `URL`, because it will point to the host root. Your theme's demo will be available in a subdirectory of the Hugo website and in this scenario Hugo will not generate the correct `URL` for theme assets.
{{% /warning %}} {{% /warning %}}
Hugo can initialize a new blank theme directory within your existing `themes` using the `hugo new` command: Hugo can initialize a new blank theme directory within your existing `themes` using the `hugo new` command: