2014-05-29 18:42:05 -04:00
|
|
|
---
|
2016-01-06 17:45:19 -05:00
|
|
|
lastmod: 2015-10-10
|
2014-05-29 18:42:05 -04:00
|
|
|
date: 2014-05-12T10:09:49Z
|
|
|
|
|
menu:
|
|
|
|
|
main:
|
|
|
|
|
parent: themes
|
|
|
|
|
next: /themes/usage
|
|
|
|
|
prev: /themes/overview
|
|
|
|
|
title: Installing Themes
|
|
|
|
|
weight: 20
|
|
|
|
|
---
|
2014-05-27 18:32:57 -04:00
|
|
|
|
2015-10-10 12:52:23 -04:00
|
|
|
Community-contributed [Hugo themes](http://themes.gohugo.io/), showcased
|
|
|
|
|
at [themes.gohugo.io](//themes.gohugo.io/), are hosted in a centralized
|
|
|
|
|
GitHub repository. The [Hugo Themes Repo](https://github.com/spf13/hugoThemes)
|
|
|
|
|
itself at [github.com/spf13/hugoThemes](https://github.com/spf13/hugoThemes) is
|
|
|
|
|
really a meta repository which contains pointers to set of contributed themes.
|
2014-05-27 18:32:57 -04:00
|
|
|
|
|
|
|
|
## Installing all themes
|
|
|
|
|
|
2015-01-13 22:48:44 -05:00
|
|
|
If you would like to install all of the available Hugo themes, simply
|
2016-10-22 11:08:35 -04:00
|
|
|
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](https://git-scm.com/) on your computer.
|
|
|
|
|
Otherwise you will not be able to clone the theme repositories.
|
2014-05-27 18:32:57 -04:00
|
|
|
|
2014-12-04 11:26:12 -05:00
|
|
|
```bash
|
2016-10-22 11:08:35 -04:00
|
|
|
$ git clone --depth 1 --recursive https://github.com/spf13/hugoThemes.git themes
|
2014-12-04 11:26:12 -05:00
|
|
|
```
|
2016-12-19 23:52:24 -05:00
|
|
|
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.
|
2014-05-27 18:32:57 -04:00
|
|
|
|
|
|
|
|
## Installing a specific theme
|
|
|
|
|
|
2016-10-22 11:08:35 -04:00
|
|
|
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`:
|
|
|
|
|
|
2015-01-13 22:48:44 -05:00
|
|
|
$ cd themes
|
|
|
|
|
$ git clone URL_TO_THEME
|
2016-10-22 11:08:35 -04:00
|
|
|
|
|
|
|
|
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.
|
