mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
c2037f0c9a
acf70cdd9 Update CSS after removing Purge 74c0bb7f2 Remove purge from Webpack, temporarily 397b7284f Merge commit 'ccb1e38f3822e9b5e4fb89a296324daf3400f23b' ccb1e38f3 Squashed 'themes/gohugoioTheme/' changes from 042112e2d..b7853ae70 bca84e914 Fix search box text being invisible in Safari 3f21d0957 FAQ: "this feature is not available in your current Hugo version" d8b318f90 Remove Gulp from Victor Hugo description 09d9b4c24 Update contribute/development.md 4d0f6ba47 Theme Components Support on the Hugo Themes Site (#769) f2ec3f2a6 Fix broken link 404 af82c56c5 config: Remove superflous param 8dc14f563 Update theme total on homepage (#765) 7838fd7e2 Update description of Atlas to reflect new changes 6abab23c6 update: total of hugo themes 1dba24fde Clarify: summaryLength uses words not characters 8c54f45d6 Add missing punctuation d17000481 Remove Hugo Frontend caddy-plugin a7094ae62 remove unneeded meta tags f8b0f31c6 Fix typo in cross references 61781bab9 Fix: use gh shortcode correctly 357bfca43 Update files.md d1d2406cc Updated Hugo convert to clarify for and not .. 86850f3c3 Fix typos in multilingual.md b68d0d892 Fix typo 8cba70e28 Document disableAliases 00e440260 Remove extra whitespace 212d63e4c Update with latest Theme Submission Guidelines (#744) c24ea638f Update frontends.md 942bc1972 Add one more video 2e1e1091d Update the rest of the videos a7dc70f2b Add new installation video 1a78f8487 Hosting on AWS amplify 112420c46 Fix typo f723425e4 Add fireship.io bio to showcase 574f43503 Fixed typo 88e0e0cb7 Release 0.54.0 303edf19e Merge branch 'temp54' c38debebd releaser: Prepare repository for 0.55.0-DEV 5c6c56fa1 releaser: Add release notes to /docs for release of 0.54.0 f86e05950 releaser: Bump versions for release of 0.54.0 6a2684fe4 Add the default cache configuration f75c0125a Merge commit 'f27faf9afd0a8db768a21954b8755f1bf1a14f1b' e440dc6a4 Merge commit '5e078383a787e8b5ec3ba73f05ea4130840afbe2' 981bf53f8 Update _index.md b54aea066 tpl: Fix reflect 41f8af5a6 Merge commit '978856e2ad12d2bcaf37bb9e31f806b30a4c42f4' git-subtree-dir: docs git-subtree-split: acf70cdd9fe2a89413e13db29466e45629372343
135 lines
5.1 KiB
Markdown
135 lines
5.1 KiB
Markdown
---
|
||
title: Add Your Hugo Theme to the Showcase
|
||
linktitle: Themes
|
||
description: If you've built a Hugo theme and want to contribute back to the Hugo Community, add your theme to the Hugo Showcase.
|
||
date: 2017-02-01
|
||
publishdate: 2017-02-01
|
||
lastmod: 2017-02-27
|
||
categories: [contribute]
|
||
keywords: [contribute,themes,design]
|
||
authors: [digitalcraftsman]
|
||
menu:
|
||
docs:
|
||
parent: "contribute"
|
||
weight: 30
|
||
weight: 30
|
||
sections_weight: 30
|
||
draft: false
|
||
aliases: [/contribute/theme/]
|
||
wip: true
|
||
toc: true
|
||
---
|
||
|
||
A collection of all themes created by the Hugo community, including screenshots and demos, can be found at <https://themes.gohugo.io>. Every theme in this list will automatically be added to the theme site. Theme updates aren't scheduled but usually happen at least once a week.
|
||
|
||
## Adding a theme to the list
|
||
|
||
1. Create your theme using `hugo new theme <THEMENAME>`;
|
||
2. Test your theme against <https://github.com/gohugoio/hugoBasicExample> \*
|
||
3. Add a `theme.toml` file to the root of the theme with all required metadata
|
||
4. Add a descriptive `README.md` to the root of the theme source
|
||
5. Add `/images/screenshot.png` and `/images/tn.png`
|
||
|
||
\* If your theme doesn't fit into the `Hugo Basic Example` site, we encourage theme authors to supply a self-contained Hugo site in `/exampleSite/`, but note that for security reasons the content directory on the Hugo showcase will still be published from the [`Hugo Basic Example`](https://github.com/gohugoio/hugoBasicExample/tree/master/content) repository.
|
||
|
||
{{% note %}}
|
||
The folder name here---`exampleSite`---is important, as this folder will be picked up and used by the script that generates the Hugo Theme Site. It mirrors the root directory of a Hugo website and allows you to add custom content, assets, and a `config` file with preset values.
|
||
{{% /note %}}
|
||
|
||
See the [Hugo Artist theme's exampleSite][artistexample] for a good example.
|
||
|
||
{{% note %}}
|
||
Please make your example site's content is as neutral as possible. We hope this goes without saying.
|
||
{{% /note %}}
|
||
|
||
## Theme Requirements
|
||
|
||
In order to add your theme to the Hugo Themes Showcase, the following requirements need to be met:
|
||
|
||
1. `theme.toml` with all required fields
|
||
2. Images for thumbnail and screenshot
|
||
3. A good README file instructions for users
|
||
4. Addition to the hugoThemes GitHub repository
|
||
|
||
### Add Your Theme to the Repo
|
||
|
||
The easiest way to add your theme is to [open up a new issue in the theme repository][themeissuenew] with a link to the theme's repository on GitHub.
|
||
|
||
### Create a `theme.toml` File
|
||
|
||
`theme.toml` contains metadata about the theme and its creator and should be created automatically when running the `hugo new theme`. The auto-generated file is provided here as well for easy downloading:
|
||
|
||
{{< code file="theme.toml" download="theme.toml" >}}
|
||
name = ""
|
||
license = "MIT"
|
||
licenselink = "https://github.com/<YOURNAME>/<YOURTHEME>/blob/master/LICENSE.md"
|
||
description = ""
|
||
homepage = "https://example.com/"
|
||
tags = []
|
||
features = []
|
||
min_version = 0.19
|
||
|
||
[author]
|
||
name = ""
|
||
homepage = ""
|
||
|
||
# If porting an existing theme
|
||
[original]
|
||
name = ""
|
||
homepage = ""
|
||
repo = ""
|
||
{{< /code >}}
|
||
|
||
The following fields are required:
|
||
|
||
```
|
||
name = "Hyde"
|
||
license = "MIT"
|
||
licenselink = "https://github.com/spf13/hyde/blob/master/LICENSE.md"
|
||
description = "An elegant open source and mobile first theme"
|
||
homepage = "http://siteforthistheme.com/"
|
||
tags = ["blog", "company"]
|
||
features = ["blog"]
|
||
min_version = 0.13
|
||
|
||
[author]
|
||
name = "spf13"
|
||
homepage = "http://spf13.com/"
|
||
|
||
# If porting an existing theme
|
||
[original]
|
||
author = "mdo"
|
||
homepage = "http://hyde.getpoole.com/"
|
||
repo = "https://www.github.com/mdo/hyde"
|
||
```
|
||
|
||
{{% note %}}
|
||
1. This is different from the `theme.toml` file created by `hugo new theme` in Hugo versions before v0.14.
|
||
2. Only `theme.toml` is accepted; ie. not `theme.yaml` and `theme.json`.
|
||
{{% /note %}}
|
||
|
||
### Images
|
||
|
||
Screenshots are used for previews in the Hugo Theme Gallery. Make sure that they have the right dimensions:
|
||
|
||
* Thumbnail should be 900px × 600px
|
||
* Screenshot should be 1500px × 1000px
|
||
* Media must be located in
|
||
* <THEMEDIR>/images/screenshot.png</code>
|
||
* <THEMEDIR>/images/tn.png</code>
|
||
|
||
Additional media may be provided in the same directory.
|
||
|
||
### Create a README File
|
||
|
||
Your theme's README file should be written in markdown and saved at the root of your theme's directory structure. Your `README.md` serves as
|
||
|
||
1. Content for your theme's details page at <https://themes.gohugo.io>
|
||
2. General information about the theme in your GitHub repository (i.e., it's usual purpose, features and instructions)
|
||
|
||
{{% note "Screenshots in your `README.md`"%}}
|
||
If you add screenshots to the README, please make use of absolute file paths instead of relative ones like `/images/screenshot.png`. Relative paths work great on GitHub but they don't correspond to the directory structure of [themes.gohugo.io](http://themes.gohugo.io/). Therefore, browsers will not be able to display screenshots on the theme site under the given (relative) path.
|
||
{{% /note %}}
|
||
|
||
[artistexample]: https://github.com/digitalcraftsman/hugo-artists-theme/tree/master/exampleSite
|
||
[themeissuenew]: https://github.com/gohugoio/hugoThemes/issues/new
|