hugo/docs/content/themes/installing.md

1.7 KiB

lastmod date menu next prev title weight
2015-10-10 2014-05-12T10:09:49Z
main
parent
themes
/themes/usage /themes/overview Installing Themes 20

Community-contributed Hugo themes, showcased at themes.gohugo.io, are hosted in a centralized GitHub repository. The Hugo Themes Repo itself at github.com/gohugoio/hugoThemes is really a meta repository which contains pointers to set of contributed 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. Depending on your internet connection the download of all themes might take a while.

NOTE: Make sure you've installed Git on your computer. Otherwise you will not be able to clone the theme repositories.

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

Before you use a theme, remove the .git folder in that theme's root folder. Otherwise, this will cause problem if you deploy using Git.

Installing a specific theme

Switch into the themes directory and download a theme by replacing URL_TO_THEME with the URL of the theme repository, e.g. https://github.com/spf13/hyde:

$ cd themes
$ git clone URL_TO_THEME

Alternatively, you can download the theme as .zip file and extract it in the themes directory.

NOTE: Please have a look at the README.md file that is shipped with all themes. It might contain further instructions that are required to setup the theme, e.g. copying an example configuration file.