<commit_before># Cocoa Enhanced

A consistent and responsive [Hugo](http://gohugo.io) [theme](https://github.com/spf13/hugoThemes/) with clean typograhy. This is a fork from the original [Cocoa](https://www.github.com/nishanths/cocoa-hugo-theme) theme, with some improvements. A demo is available [here](https://kodewolf.com).

You can use this theme either for your blog or your personnal website.

<img src="https://raw.githubusercontent.com/fuegowolf/cocoa-eh-hugo-theme/master/images/screenshot.png" width="800">

# Table of Contents

* [Getting Started](#getting-started)
* [Features](#features)
* [Usage](#usage)
* [Screenshots](#screenshots)
* [Changelog](#changelog)
* [Contributing](#contributing)
* [License](#license)

## Getting Started 

From the root of your Hugo site, clone the theme into `themes/cocoa-eh` by running:

````
git clone https://github.com/fuegowolf/cocoa-eh-hugo-theme.git themes/cocoa-eh
````

Then, generate your site's files by running:

````
hugo -t cocoa-eh
````

If you want a simple blog you can just use the `exampleSite`, however if you desire a more 
complex website you can build it with the [Usage](#usage) section.

## Features

* Responsive.
* Suited for blogging and personal webpages.
* Disqus support.
* Built-in support for 404 pages.
* Syntax highlighting with hightlightjs.
* Progressive images.
* Logo and title in the header for a clear identity.
* Possibility to have sections with a header and a list of articles.
* Possibility to have single pages.

#### Differences from the original Cocoa

This theme is less minimalist than the original Cocoa, with some new features :

* Displays a logo on the side of the header, and there is a title different from the author name.
* Very modulable with sections and single pages.
* Group articles by month and year.
* Progressive images.
* Fonts are different : stronger and sharper, with a clear identity.
* The font size in articles is higher, the text justified and lines are more spaced.
* On mobile : display the date next to article's titles.

## Usage

#### config.toml

Please see the sample [`config.toml`](https://github.com/fuegowolf/cocoa-eh-hugo-theme/blob/master/exampleSite/config.toml) in `exampleSite/`.

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)

#### Blog posts

The core of this theme is a **Blog**, but you can decide to not have this section if you want a personnal website for example. The last 5 months with articles will be displayed on the [homepage](#homepage), and all articles will be available in the `blog` section.

If you want to add a blog section and a post, just type :

````
hugo new blog/your-new-post.md
````

#### Homepage

The homepage is meant to display few articles or a description of yourself and the `home.md` post, which should be in the root of the folder. If you don't want to display something special on the front page, just don't create this file. If you want to add text before the article list :

````
hugo new home.md
````

#### Sections

You can add **Sections** like Projects or Talks by adding a directory with the name of the section. They will be automatically in the header.

* If you only want a list with articles, just create an article :

````
hugo new projects/my-project.md
````

* If you want to add a header to you section, with some markdown too, create an article with the same name as your section.

````
$ hugo new projects/projects.md
````

#### Single pages

If you want to add a small page like an About one, just create an article in the root. It will be automatically added to the header too.

````
$ hugo new about.md
````

#### Progressive images

You can activate the defering of images with this line in the `config.toml` : 

```
progressively = true
```

And call images in markdown like usual : 

```
![image](./images/image.jpg)
```

This will call the `./images/low/image.jpg` image and the `./images/high/image.jpg`.


## Changelog<commit_msg>Add twitter card to README<commit_after># Cocoa Enhanced

A consistent and responsive [Hugo](http://gohugo.io) [theme](https://github.com/spf13/hugoThemes/) with clean typograhy. This is a fork from the original [Cocoa](https://www.github.com/nishanths/cocoa-hugo-theme) theme, with some improvements. A demo is available [here](https://kodewolf.com).

You can use this theme either for your blog or your personnal website.

<img src="https://raw.githubusercontent.com/fuegowolf/cocoa-eh-hugo-theme/master/images/screenshot.png" width="800">

# Table of Contents

* [Getting Started](#getting-started)
* [Features](#features)
* [Usage](#usage)
* [Screenshots](#screenshots)
* [Changelog](#changelog)
* [Contributing](#contributing)
* [License](#license)

## Getting Started 

From the root of your Hugo site, clone the theme into `themes/cocoa-eh` by running:

````
git clone https://github.com/fuegowolf/cocoa-eh-hugo-theme.git themes/cocoa-eh
````

Then, generate your site's files by running:

````
hugo -t cocoa-eh
````

If you want a simple blog you can just use the `exampleSite`, however if you desire a more 
complex website you can build it with the [Usage](#usage) section.

## Features

* Responsive.
* Suited for blogging and personal webpages.
* Disqus support.
* Built-in support for 404 pages.
* Syntax highlighting with hightlightjs.
* Progressive images.
* Logo and title in the header for a clear identity.
* Possibility to have sections with a header and a list of articles.
* Possibility to have single pages.
* Twitter cards support

#### Differences from the original Cocoa

This theme is less minimalist than the original Cocoa, with some new features :

* Displays a logo on the side of the header, and there is a title different from the author name.
* Very modulable with sections and single pages.
* Group articles by month and year.
* Progressive images.
* Fonts are different : stronger and sharper, with a clear identity.
* The font size in articles is higher, the text justified and lines are more spaced.
* On mobile : display the date next to article's titles.

## Usage

#### config.toml

Please see the sample [`config.toml`](https://github.com/fuegowolf/cocoa-eh-hugo-theme/blob/master/exampleSite/config.toml) in `exampleSite/`.

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)

#### Blog posts

The core of this theme is a **Blog**, but you can decide to not have this section if you want a personnal website for example. The last 5 months with articles will be displayed on the [homepage](#homepage), and all articles will be available in the `blog` section.

If you want to add a blog section and a post, just type :

````
hugo new blog/your-new-post.md
````

#### Homepage

The homepage is meant to display few articles or a description of yourself and the `home.md` post, which should be in the root of the folder. If you don't want to display something special on the front page, just don't create this file. If you want to add text before the article list :

````
hugo new home.md
````

#### Sections

You can add **Sections** like Projects or Talks by adding a directory with the name of the section. They will be automatically in the header.

* If you only want a list with articles, just create an article :

````
hugo new projects/my-project.md
````

* If you want to add a header to you section, with some markdown too, create an article with the same name as your section.

````
$ hugo new projects/projects.md
````

#### Single pages

If you want to add a small page like an About one, just create an article in the root. It will be automatically added to the header too.

````
$ hugo new about.md
````

#### Progressive images

You can activate the defering of images with this line in the `config.toml` : 

```
progressively = true
```

And call images in markdown like usual : 

```
![image](./images/image.jpg)
```

This will call the `./images/low/image.jpg` image and the `./images/high/image.jpg`.

#### Twitter cards

You can share your article on Twitter using the article link, and Twitter will show a summary card with the params of the post (`meta_img` is the image of the card) :

```
title = "Test title"
description = "Test description"
meta_img = "./images/high/test.jpg"
```

If you don't specify a meta image, it will take the global parameter `social_banner` in the `config.toml` :

```
social_banner = "img/banner.png"
```

## Changelog
{'fraction_non_alphanumeric': 0.10227006786800842, 'fraction_numerical': 0.002808331383103206, 'mean_word_length': 4.161231884057971, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 12, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6900812', 'n_tokens_mistral': 2638, 'n_tokens_neox': 2457, 'n_words': 1148}