All Themes Hugo
Pull request Compare This branch is 2 commits ahead, 144 commits behind spf13:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
agency @ bea47bd
aglaus @ 1a6bcfc
air @ 0e1c3b0
allegiant @ 6c49d13
angels-ladder @ 4b858d8
artists @ baf5506
aurora @ d760f75
base16 @ 058fd51
beg @ 1c17d13
blackburn @ 21e0fff
bleak @ acdec75
bootie-docs @ 81e1459
bootstrap @ d8219ca
cactus @ cd7c540
casper @ a334a8e
cocoa @ e32b495
creative @ 7731870
crisp @ e99ce5d
detox @ b56f0e2
freelancer @ e8dd137
ghostwriter @ 39e9751
gindoro @ 6bfc86b
github-project-landing-page @ 9d8a23c
greyshade @ 28fb061
grid-side @ d384625
heather-hugo @ edfe501
herring-cove @ fe7ce04
hikari @ c4d4932
html5 @ aa44279
hugo-base-theme @ 2d7c110
hugo-bootswatch @ 6681963
hugo-future-imperfect @ f2867fd
hugo-geo @ b14540d
hugo-h5bp @ 7741bbc
hugo-icarus @ ff019b8
hugo-incorporated @ 3d21a63
hugo-mdl @ ade4b69
hugo-minimalist @ 7451d28
hugo-multi-bootswatch @ 0f12d1b
hugo-octopress @ 6c1b38d
hugo-phlat-theme @ b4d1219
hugo-plus @ bba9290
hugo-uno @ 75c9028
hugo-zen @ 0b977e8
hugoscroll @ 6f6ce41
hurock @ 4136087
hyde @ a04b9e1
hyde-x @ ee61d83
hyde-y @ 493bf99
internet-weblog @ 0fe38b4
journal @ e543e4b
landing-page-hugo @ 9280715
lanyon @ f2a808b
liquorice @ b2b6d57
material-design @ 0d88058
material-docs @ c1b2d3d
material-lite @ 24a23e3
next @ 7234b44
nofancy @ f733407
persona @ afb2d45
pixyll @ 50dad69
polymer @ d8be002
projecthub @ d0fb856
purehugo @ c50a94d
redlounge @ 7853d1e
robust @ 106a6b6
rocktopus @ c47bcd7
shiori @ e23d4a1
simple-a @ 3338b25
simple-hugo @ 20d9086
slender @ da36837
slim @ a491cb0
startbootstrap-clean-blog @ d728fae
steam @ d917cfa
strata @ 7874cc9
tachyons @ a98c649
tinyce @ ec650df
twentyfourteen @ 1d5ca2f
type @ e8a2c26
vienna @ 890e97c
.gitmodules
LICENSE
README.md

README.md

hugoThemes

All Themes Hugo

See a complete listing of all of these themes along with screenshots and demos at themes.gohugo.io.

Every theme in this list will automatically be added to the theme site.

Installing Themes

Installing all themes

If you would like to install all of the available Hugo themes, simply clone the entire repository from within your working directory with this command:

git clone --depth 1 --recursive https://github.com/spf13/hugoThemes.git themes

Installing a single theme

mkdir themes
cd themes
git clone URL_TO_THEME

Adding a theme to the list

  • Create your theme using hugo new theme THEMENAME;
  • Test your theme against https://github.com/spf13/HugoBasicExample;
  • Add a theme.toml file to the root of the theme;
  • Add a README.md to the root of the theme;
  • Add /images/screenshot.png and /images/tn.png;
  • Open up a new Issue with a link to the theme's repository on GitHub.

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. NOTE: The folder name here is important, as this folder will be picked up and used by the script that generates the Hugo Theme Site. See Artist theme's exampleSite for a good example. And please make the site's content as neutral as possible.

Each theme needs:

  1. to be added to the hugoThemes repo;
  2. the right fields in theme.toml;
  3. the right images;
  4. a good README.

theme.toml

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"

Notes:

  1. This is different from the file created by hugo new theme in the old v0.12. The current Hugo v0.13 does create the same template with the new fields except min_version that was created in 0.14-DEV.

  2. Only theme.toml is accepted, not theme.yaml, not theme.json.

Media

  • Thumbnail should be 900×600 in pixels
  • Screenshot should be 1500×1000 in pixels
  • Media must be located in:
    • [ThemeDir]/images/screenshot.png
    • [ThemeDir]/images/tn.png

Additional media may be provided in that same directory.

README

The README file serves double purposes. It is used on GitHub as the content for the main page. It is also used as the content on the detailed theme view page for themes.gohugo.io. It should be in Markdown format and called README.md.