cupper-hugo-theme/exampleSite/content/patterns/updating.md

39 lines
1.6 KiB
Markdown
Raw Normal View History

2017-08-22 10:54:01 +02:00
+++
2017-11-02 16:37:06 +01:00
title = "Updating Cupper"
2017-09-03 14:30:01 +02:00
weight = 5
2017-08-22 10:54:01 +02:00
+++
2017-11-02 16:37:06 +01:00
The core of **Cupper's** functionality is in its Hugo theme, also called **Cupper**. This is found in the theme folder.
2017-08-22 10:54:01 +02:00
{{% fileTree %}}
* content
* docs
* lib
* snippets
* static
* themes
2017-11-02 16:37:06 +01:00
* cupper
2017-08-22 10:54:01 +02:00
{{% /fileTree %}}
2017-11-02 16:37:06 +01:00
Do not "hack the core". If you have any issues with **Cupper**, please report them to [the **Cupper** Github repository](https://github.com/ThePacielloGroup/cupper/issues) and they will be dealt with ASAP.
2017-08-22 10:54:01 +02:00
2017-11-02 16:37:06 +01:00
Cupper is undergoing constant development, so keep an eye out for new releases. To update to a new version of **Cupper**, simply run the `update` command from inside your local project folder.
2017-08-22 10:54:01 +02:00
{{<cmd>}}
npm run update
{{</cmd>}}
This will save a timestamped backup of the current version, and download the latest version. Your theme folder will now look something like the following.
{{% fileTree %}}
* themes
2017-11-02 16:37:06 +01:00
* cupper
* cupper-old-1503389765972
2017-08-22 10:54:01 +02:00
{{% /fileTree %}}
2017-11-02 16:37:06 +01:00
If you experience breaking changes and are having trouble fixing them, you can rename the old folder and revert to using it. In the meantime, you can [submit an issue](https://github.com/ThePacielloGroup/cupper/issues) with the "help" tag describing your problem.
2017-08-22 10:54:01 +02:00
{{% warning %}}
2017-11-02 16:37:06 +01:00
The described update process relies on SVN because Github does not support downloading individual repository folders. If you have a Mac, SVN should be installed already. If not, or if you are on Windows, you can either install SVN or download the latest [**Cupper** theme folder](https://github.com/ThePacielloGroup/cupper/tree/master/themes/cupper) manually, using the Github web interface.
2017-08-22 10:54:01 +02:00
{{% /warning %}}