2019-02-04 21:55:40 +01:00
|
|
|
# Cupper
|
2017-06-05 17:06:36 +02:00
|
|
|
|
2019-02-13 03:22:28 +01:00
|
|
|
[![Netlify Status](https://api.netlify.com/api/v1/badges/bc8c4e51-37ee-419d-ad4f-b378010ee546/deploy-status)](https://app.netlify.com/sites/cupper-hugo-theme/deploys)
|
|
|
|
|
2019-02-13 06:13:39 +01:00
|
|
|
An accessibility-friendly Hugo theme, ported from the [original Cupper](https://github.com/ThePacielloGroup/cupper) project.
|
2017-06-05 17:06:36 +02:00
|
|
|
|
2019-02-01 01:19:20 +01:00
|
|
|
## Table of contents
|
2017-11-02 16:37:06 +01:00
|
|
|
|
2019-02-13 16:41:11 +01:00
|
|
|
- [Demo](#demo)
|
|
|
|
- [Installation](#installation)
|
|
|
|
- [Updating](#updating)
|
|
|
|
- [Run example site](#run-example-site)
|
|
|
|
- [Configuration](#configuration)
|
2019-02-13 20:05:10 +01:00
|
|
|
- [Disable toc for a blog post](#disable-toc-for-a-blog-post)
|
2019-02-13 21:50:51 +01:00
|
|
|
- [Syntax highlighting](#syntax-highlighting)
|
2019-02-13 16:41:11 +01:00
|
|
|
- [Shortcodes](#shortcodes)
|
|
|
|
- [Favicons](#favicons)
|
|
|
|
- [Credits](#credits)
|
2019-02-01 01:19:20 +01:00
|
|
|
|
|
|
|
## Demo
|
|
|
|
|
2019-02-13 06:13:39 +01:00
|
|
|
https://cupper-hugo-theme.netlify.com/
|
2019-02-01 01:19:20 +01:00
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
From the root of your site:
|
|
|
|
|
|
|
|
```
|
2019-02-01 01:38:14 +01:00
|
|
|
git submodule add https://github.com/zwbetz-gh/cupper-hugo-theme.git themes/cupper-hugo-theme
|
2019-02-01 01:19:20 +01:00
|
|
|
```
|
|
|
|
|
|
|
|
## Updating
|
|
|
|
|
|
|
|
From the root of your site:
|
|
|
|
|
|
|
|
```
|
|
|
|
git submodule update --remote --merge
|
|
|
|
```
|
|
|
|
|
|
|
|
## Run example site
|
|
|
|
|
2019-02-01 01:38:14 +01:00
|
|
|
From the root of `themes/cupper-hugo-theme/exampleSite`:
|
2019-02-01 01:19:20 +01:00
|
|
|
|
|
|
|
```
|
|
|
|
hugo server --themesDir ../..
|
|
|
|
```
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
2019-02-13 16:23:01 +01:00
|
|
|
Copy the `config.toml` from the [`exampleSite`](https://github.com/zwbetz-gh/cupper-hugo-theme/tree/master/exampleSite), then edit as desired.
|
2019-02-01 01:19:20 +01:00
|
|
|
|
2019-02-13 19:53:34 +01:00
|
|
|
Replace `static/images/logo.svg` with your logo. Keep the filename as `logo.svg`.
|
|
|
|
|
2019-02-13 20:05:10 +01:00
|
|
|
## Disable toc for a blog post
|
|
|
|
|
|
|
|
Blog posts that have two or more subheadings (`<h2>`s) automatically get a table of contents. To disable this set `toc` to `false`. For example:
|
|
|
|
|
|
|
|
```
|
|
|
|
---
|
|
|
|
title: "My page with a few headings"
|
|
|
|
toc: false
|
|
|
|
---
|
|
|
|
```
|
|
|
|
|
2019-02-13 21:50:51 +01:00
|
|
|
## Syntax highlighting
|
|
|
|
|
2019-02-13 21:56:14 +01:00
|
|
|
Syntax highlighting is provided by [Prism](https://prismjs.com/). See the [full list of supported languages](https://prismjs.com/#languages-list).
|
2019-02-13 21:50:51 +01:00
|
|
|
|
2019-02-13 16:29:03 +01:00
|
|
|
## Shortcodes
|
2019-02-01 01:19:20 +01:00
|
|
|
|
2019-02-13 16:29:03 +01:00
|
|
|
See the [full list of supported shortcodes](https://cupper-hugo-theme.netlify.com/cupper-shortcodes/).
|
2019-02-01 01:19:20 +01:00
|
|
|
|
2019-02-13 16:29:03 +01:00
|
|
|
## Favicons
|
2019-02-01 01:38:14 +01:00
|
|
|
|
2019-02-13 16:29:03 +01:00
|
|
|
Upload your image to [RealFaviconGenerator](https://realfavicongenerator.net/) then copy-paste the generated favicon files to `static/images`.
|
2019-02-01 01:38:14 +01:00
|
|
|
|
2019-02-01 01:19:20 +01:00
|
|
|
## Credits
|
|
|
|
|
2019-02-13 03:33:05 +01:00
|
|
|
Thank you to:
|
2019-02-01 01:19:20 +01:00
|
|
|
|
2019-02-13 16:21:25 +01:00
|
|
|
- [Heydon Pickering](http://www.heydonworks.com) and [The Paciello Group
|
|
|
|
](https://www.paciellogroup.com/) for creating the original Cupper project
|
2019-02-01 01:19:20 +01:00
|
|
|
- [Netlify](https://www.netlify.com/) for deploys
|