Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nishanths/cocoa-hugo-theme
Responsive Hugo blog theme (note: not actively worked on)
https://github.com/nishanths/cocoa-hugo-theme
hugo hugo-blog-theme hugo-theme
Last synced: 2 months ago
JSON representation
Responsive Hugo blog theme (note: not actively worked on)
- Host: GitHub
- URL: https://github.com/nishanths/cocoa-hugo-theme
- Owner: nishanths
- License: mit
- Created: 2015-08-24T23:31:36.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-05-11T19:48:03.000Z (7 months ago)
- Last Synced: 2024-09-29T05:40:55.212Z (3 months ago)
- Topics: hugo, hugo-blog-theme, hugo-theme
- Language: CSS
- Homepage: https://cocoa-hugo-theme-demo.netlify.app/
- Size: 3.59 MB
- Stars: 326
- Watchers: 10
- Forks: 155
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - nishanths/cocoa-hugo-theme - Responsive Hugo blog theme (note: not actively worked on) (others)
README
# Cocoa
**NOTE:** I don't actively work on this theme now. Pull requests for bug fixes or new features are welcome however.
Before working on a substantial change, please discuss it in an issue. Thanks. :)
A consistent and responsive [Hugo](https://gohugo.io) [theme](https://github.com/spf13/hugoThemes/) with clean typography. The primary typefaces are Open Sans, Raleway, and Ubuntu Mono.
[__Demo__](https://cocoa-hugo-theme-demo.netlify.app/) / [__Screenshots__](https://github.com/nishanths/cocoa-hugo-theme/blob/master/screenshots.md)
## Features
* Responsive
* Suited for blogging and personal webpages
* Disqus support
* Built-in 404 page
* Syntax highlighting with highlightjs (by @andy4thehuynh)
* Gravatar/static profile image (by @remeh)
* RSS feed and icon (by @mvrilo)
* Optimized SVG icons (by @robinst) for Instagram, 500px, and more
* Cache busting
* Google Analytics
* Piwik and Gitalk support
Most features are optional and can be individually enabled/disabled in your [`config.toml`](https://github.com/nishanths/cocoa-hugo-theme/blob/master/exampleSite/config.toml).
## Table of Contents
* [Quick Start](#quick-start)
* [Usage](#usage)
* [Development](#development)
* [License](#license)
## Quick Start
From the root of your Hugo site, clone the theme into `themes/cocoa` by running:
```sh
# Clone theme into the themes/cocoa directory
$ git clone https://github.com/nishanths/cocoa-hugo-theme.git themes/cocoa
# Generate site files into the public directory
$ hugo -t cocoa
# Or, serve your site and visit localhost:1313 in your browser
$ hugo -t cocoa --watch serve
```
## Usage
### Configuration
Please see the sample [`config.toml`](https://github.com/nishanths/cocoa-hugo-theme/blob/master/exampleSite/config.toml). Note that if you already use cocoa but have updated to Hugo 0.18, you must lowercase every params of your existing `config.toml` (like in the sample).
### Creating Posts
Posts should generally go under a `content/blog` directory. Typically you would run:
````sh
hugo new blog/your-new-post.md
````
For posts to appear on your site, you may need `draft = false` in the post's front matter or use the `--buildDrafts` option when building.
### Creating Fixed Pages
Fixed pages such as an About page should preferably go under `content/fixed` or be present at the root of the `content` directory.
````sh
hugo new fixed/about.md
````
## Development
This theme is built and improved upon by open source
[contributions](https://github.com/nishanths/cocoa-hugo-theme/graphs/contributors).
Pull requests, bug fixes, and new features are welcome!
## License
Licensed under the MIT License. See the [LICENSE](https://github.com/nishanths/cocoa-hugo-theme/blob/master/LICENSE) file for more details.