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

Add note about relative protocol URLs

Browse Source 
See https://github.com/gohugoio/hugoThemes/pull/521#issue-239913619 for the need to have this note about relative protocol URLs in themes.
This commit is contained in:
Alexandros 2018-12-22 09:42:48 +02:00 committed by Bjørn Erik Pedersen
parent a13751ac53
commit 6d0c155c82
1 changed files with 1 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -23,6 +23,7 @@ wip: true
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're creating a theme with plans to share it on the [Hugo Themes website](https://themes.gohugo.io/) please note the following:
- If using inline styles you will need to use absolute URLs, for the linked assets to be served properly, e.g. `<div style="background: url('{{ "images/background.jpg" | absURL }}')">` - If using inline styles you will need to use absolute URLs, for the linked assets to be served properly, e.g. `<div style="background: url('{{ "images/background.jpg" | absURL }}')">`
- 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. - 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.
- If using external CSS and JS from a CDN, make sure to load these assets over `https`. Please do not use relative protocol URLs in your theme's templates.
{{% /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: