mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-26 14:52:40 +00:00
211d20a3c7
Deployment to Gitlab fails if the theme folder is a git submodule.
46 lines
1.7 KiB
Markdown
46 lines
1.7 KiB
Markdown
---
|
|
lastmod: 2015-10-10
|
|
date: 2014-05-12T10:09:49Z
|
|
menu:
|
|
main:
|
|
parent: themes
|
|
next: /themes/usage
|
|
prev: /themes/overview
|
|
title: Installing Themes
|
|
weight: 20
|
|
---
|
|
|
|
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.
|
|
|
|
## 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](https://git-scm.com/) on your computer.
|
|
Otherwise you will not be able to clone the theme repositories.
|
|
|
|
```bash
|
|
$ git clone --depth 1 --recursive https://github.com/spf13/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.
|