mirror of
https://github.com/Noettore/cocoa-eh-hugo-theme.git
synced 2025-10-15 03:36:41 +02:00
Cocoa
A Hugo theme with clear typograhy for easy, disturbance-free reading.
Table of Contents
Setup
From the root of your Hugo site, clone the theme into a folder named cocoa by running:
$ mkdir themes
$ cd themes
$ git clone https://github.com/nishanths/cocoa-hugo-theme cocoa
Then, generate static files by running:
hugo -t cocoa
Theme
Creating Content
- Posts should go under a
content/postsdirectory. Typically you would run:
$ hugo new posts/newpost.md
- Fixed pages such as an About page should preferably go under a
content/fixedor be present at the root of thecontentsdirectory.
$ hugo new fixed/about.md
Fonts and Colors
The primary font face is Proxima Nova. You will need to place your own copy of the font under ``. The monospace font face is Ubuntu Mono from Google Fonts.
The main colors are
#333333#b7b7b7#21bb5b
For syntax highlighting, set pygmentsuseclasses = true in your config.toml. Syntax highlighting classes in css/pygments.css are from default.css.
Site Variables
- Add the following params in
config.tomlto customize your site.- The only required key is
DateForm.
- The only required key is
[params]
Author = "Firstname Lastname"
DateForm = "Jan 2, 2006" # required
Description = "eat, sleep, rave, repeat"
Email = "username@hogwarts.edu"
Facebook = "//facebook.com/username"
FaviconFile = "myicon.ico" # relative to img/ directory, defaults to themes/cocoa/img/favicon.ico
GATracker = "<Google-Analytics-ID>"
GitHub = "//github.com/username"
Lang = "en" # <body lang="en">
LinkedIn = "//linkedin.com/in/username"
Twitter = "//twitter.com/username"
Extras
Less files
The .less files used to generate main.css are available at the root of the repository.
Screenshots
single post
Example Sites
Contributing
Pull requests are welcome!
License
Licensed under the MIT License. See the LICENSE file for more details.