Commit 927f87c2 authored by R茅gis Witz's avatar R茅gis Witz
Browse files

馃拕 rajoute la possibilit茅 d'utiliser le theme ananke
parent ec0d6da7
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](
and this project adheres to [Semantic Versioning](
Generated by [`auto-changelog`](
## [v2.6.1]( - 2020-06-25
### Commits
- Updated minimum theme to .55 [`df4c78a`](
## [v2.6.0]( - 2020-06-23
### Merged
- Update spanish translations [`#304`](
- Add automatic cover image support [`#303`](
## [2.6.0]( - 2020-06-17
### Merged
- Add translation for taxonomy page [`#299`](
- Site logo [`#284`](
- Add head partial [`#285`](
- Long urls or links extend beyond content and overlap sidebar [`#259`](
- Use relative URL for favicon [`#251`](
- Fix relURL for custom_css [`#252`](
- Fixed a typo in form-contact.html [`#266`](
- adding Bulgarian translation [`#267`](
- Use | relLangURL for the base url in the site-navigation [`#277`](
- RSS svg icon [`#282`](
- Updated Windows instructions in [`#276`](
- Replace another 2 .URL occurrences with .Permalink [`#275`](
- Add alternative method for running prod to the readme [`#273`](
- Swap the page title and site title in page <title> elements [`#272`](
- Add the post_content_classes param for changing post content font [`#260`](
- Add sharing links for the posts [`#255`](
- Safari Reader View lacks content [`#254`](
- Add Keybase social icon [`#248`](
- Add StackOverflow social [`#243`](
- Fix to take care of multiple author list, or for setting the [`#221`](
- Fix Slack icon size [`#237`](
- Correct the original translation [`#241`](
## [v2.5.6]( - 2019-12-30
### Merged
- Use Hugo's built in Site Config for copyright according to PR #199 [`#240`](
- Add italian translation [`#239`](
## [v2.5.5]( - 2019-11-15
### Merged
- Remove stray grave accent [`#231`](
- Add Slack to social options [`#236`](
- Fix URL for menus [`#230`](
- Fix word count heading typo in [`#222`](
- Add auto-changelog [`#228`](
- Fix stackbit issues [`#226`](
- Add Stackbit Configuration [`#223`](
- Replace {{ .URL }} with {{ .Permalink }} [`#216`](
- Adds an author to blog posts. [`#209`](
- Fixes #212. [`#213`](
- Add ukrainian translation [`#214`](
- Add swedish translation [`#208`](
- Deprecation messages fixes. [`#196`](
- Fix README instructions [`#204`](
- Use git submodules [`#183`](
- Remove Google News meta tags [`#197`](
### Fixed
- Fix URL for menus (#230) [`#229`](
- Add auto-changelog (#228) [`#227`]( [`#227`](
- Fix stackbit issues (#226) [`#224`](
- Add Stackbit Configuration (#223) [`#200`](
- Fixes #212. (#213) [`#212`](
- Deprecation messages fixes. (#196) [`#180`](
## 2.5.1 - 2019-08-12
### Merged
- remove deprecated meta tags for old Windows Mobile and BlackBerry [`#191`](
- localization for form-contact shortcode [`#185`](
- Fix min_version [`#189`](
- Add portuguese translation [`#179`](
- Add commento [`#178`](
- feat: add RU translation [`#177`](
- Spanish Translation [`#175`](
- Dutch translations. [`#171`](
- Correcting issue with cached i18n menu [`#174`](
- Create zh.toml [`#170`](
- Fix TOC header [`#168`](
- Optimisation "partialCached" [`#165`](
- Add a link to "mastodon" [`#159`](
- Create fr.toml [`#157`](
- add i18n translation support [`#156`](
- Support hiding the featured image header text. [`#155`](
- enable localization/modification of "Recent" string [`#154`](
- add basic support for post translations [`#144`](
- Keep article padding throughout widths [`#152`](
- Improve semantic structure of pages [`#151`](
- Improve social link accessibility [`#147`](
- Add explicit path to image example [`#146`](
- Open social media links in new tab and add Medium icon [`#143`](
- Make cover dimming class customisable. [`#140`](
- Removed hardcoded theme sample hero image. This will allow the user to "blank" out the hero default set in the config. The if statement for blank was unreachable. [`#133`](
- Use relative url function for custom CSS files [`#132`](
- Add Gitlab to social icons [`#131`](
- Add div to wrap social icons [`#128`](
- Fix asset paths when baseURL has sub-folder [`#103`](
- Add inheritance for social links. [`#107`](
- Issue 98 [`#101`](
- Replace Asset References with a data file instead of paths [`#96`](
- Pre-2.0 Enhancements [`#94`](
- Don't duplicate site title in home page TITLE tag [`#78`](
- Fix pagination [`#76`](
- #68|Parmeterize number of recent posts in index.html [`#69`](
- Fix typo in single.html [`#67`](
- Fixed line breaks in code (resolves budparr/gohugo-theme-ananke#56). [`#57`](
- Favicons [`#54`](
- indent fix [`#45`](
- Social icon updates [`#51`](
- Add GitHub social icon [`#48`](
- Make Hero image work out-of-the box [`#40`](
- Removed excess o in Facebook [`#34`](
- Fixes #31 [`#32`](
- Bp/fix now function Fixes #29 [`#30`](
- fix clunky construction on home page to get section name [`#25`](
- fix clunky construction on home page to get section name [`#24`](
- fix clunky construction on home page to get section name [`#17`](
- tweak hero default behavior [`#16`](
- improve terms template [`#15`](
- improve image handling for edge cases Fixes #11 [`#14`](
- Improve featured image handling Ref #11 + minor homepage impvs [`#12`](
- Dev changes [`#10`](
- pull in dev changes [`#9`](
- keeping things in order [`#8`](
- Improve home page posts [`#7`](
- make form email comment make more sense. Ref #5 [`#6`](
- use a cleaner way to include language code [`#3`](
- update from DEV [`#2`](
- add taxonomy templates [`#1`](
### Fixed
- Add blockquote styling [`#169`](
- Keep article padding throughout widths (#152) [`#130`](
- Update readme for formspree change [`#150`](
- Improve semantic structure of pages (#151) [`#149`](
- Add global background color class to footer [`#135`](
- Add div to wrap social icons (#128) [`#127`](
- Fix article padding on mobile [`#115`](
- Make asset paths absolute [`#97`](
- Fix linkedin icon to match the other social icons [`#70`](
- Be smarter about linking to posts on home page. [`#50`](
- Add body_classes parameter to body [`#43`](
- Fixes #31 (#32) [`#31`](
- Bp/fix now function Fixes #29 (#30) [`#29`](
- Merge pull request #14 from budparr/dev [`#11`](
- improve image handling for edge cases Fixes #11 [`#11`](
The MIT License (MIT)
Copyright (c) 2016 Bud Parr
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
# Ananke, A theme for [Hugo](, a framework for building websites.
The intent of this theme is to provide a solid starting place for Hugo sites with basic features and include best practices for performance, accessibility, and rapid development.
- Responsive
- Accessible
- Contact form
- Custom Robots.txt (changes values based on environment)
- Internal templates for meta data, google analytics, and DISQUS or COMMENTO comments
- RSS Discovery
- Table of Contents (must declare `toc: true` in post parameter)
- Stackbit configuration ([Stackbit](
Also includes examples of Hugo Features or Functions:
- Pagination (internal template)
- Taxonomies
- Archetypes
- Custom shortcode
- Related content
- Hugo built-in menu
- i18n
- `with`
- `first`
- `after`
- `sort`
- Site LanguageCode
- `where`
- Content Views
- Partials
- Template layouts (type "post" uses a special list template, single template, and a content view)
- Tags
- `len`
- Conditionals
- `ge` (greater than or equal to)
- `.Site.Params.mainSections` to avoid hard-coding "blog," etc. [[release note](]
This theme uses the "Tachyons" CSS library. This will allow you to manipulate the design of the theme by changing class names in HTML without touching the original CSS files. For more information see the [Tachyons website](
## Installation
### As a Hugo Module (recommended)
> 鈿狅笍 If you installed a [Hugo binary](, you may not have Go installed on your machine. To check if Go is installed:
> ```
> $ go version
> ```
> Go modules were considered production ready in v1.14. [Download Go](
1. From your project's root directory, initiate the hugo module system if you haven't already:
$ hugo mod init<your_user>/<your_project>
2. Add the theme's repo to your `config.toml`:
theme = [""]
### As Git Submodule
Inside the folder of your Hugo site run:
$ git submodule add themes/ananke
For more information read the official [setup guide](// of Hugo.
## Getting started
After installing the theme successfully it requires a just a few more steps to get your site running.
### The config file
Take a look inside the [`exampleSite`]( folder of this theme. You'll find a file called [`config.toml`]( To use it, copy the [`config.toml`]( in the root folder of your Hugo site. Feel free to change the strings in this theme.
You may need to delete the line: `themesDir = "../.."`
### Add comments
To enable comments, add following to your config file:
- DISQUS: `disqusShortname = YOURSHORTNAME`
commentoEnable = true
### Change the hero background
For any page or post you can add a featured image by including the local path in front matter (see content in the `exampleSite/content/` file for examples): `featured_image: '/images/gohugo-default-sample-hero-image.jpg'`
#### Featured image as Page Resources
If user is using [Page Resources](, the theme will try and match the `featured_image` from with a page resource of type `image` and use its relative permalink. If no `featured_image` is set, the theme will look for a Page Resource of type `image` whose filepath incudes either `cover` or `feature`
#### Other hero settings
If you would like to hide the header text on the featured image on a page, set `omit_header_text` to `true`. See `exampleSite/content/` for an example.
You don't need an image though. The default background color is black, but you can change the color, by changing the default color class in the config.toml file. Choose a background color from any on the [Tachyons]( library site, and preface it with "bg-"
example: `background_color_class = "bg-blue"` or `background_color_class = "bg-gray"`
### Activate the contact form
This theme includes a shortcode for a contact form that you can add to any page (there is an example on the contact page in the exampleSite folder). One option is to use [](// as proxy to send the actual email. Each month, visitors can send you up to one thousand emails without incurring extra charges. Visit the Formspree site to get the "action" link and add it to your shortcode like this:
{{< form-contact action="" >}}
### Social Follow + Share
The theme automatically adds "Follow" link icons to the header and footer and "Share" link icons to pages unless `disable_share` parameter is set to true either on the site level (site params) or page level (front matter). Each built-in services sports a label, an icon and a color.
In order to register a service to be used, user must add an `ananke_socials` parameter to its project configuration file and list them through it in the desired order. Each entry must bear a
- name*: It matches the built-in service reference (Ex: twitter, github)
- url*: The url of the handle's profile on the service (Ex:,
- name: twitter
- name: github
If user needs to overwrite default `color` and `label` of the service, they simply need to append the following to the entry:
- label: The displayed name of the service to be used to popuplate `[title]` attributes and read-only. (Ex: Twitter, GitHub)
- color: Used for styling purposes. (Ex: '#1da1f2', '#6cc644')
- name: twitter
label: TND Twitter
- name: github
label: TND GitHub Account
color: '#ff6800'
#### Limit Follow or Share
If a user needs to control Share and Follow of a service, for example enabling "Share on Facebook" without having a Facebook Page to "follow", they can set `follow: false` one the registered service.
- name: facebook
label: Facebook
follow: false
- name: twitter
label: TND Twitter
#### Social Icons Customization
On top of easily customizing the built-in services' label and color, user can overwrite their icon by adding an svg file at `/assets/ananke/socials` with a filename matching the service's name.
For example, in order to use your own GitHub icon, simply add an svg file at `/assets/ananke/socials/github.svg`
#### Built-in Services
Here is the list of built-in services. Those marked with an `*` are also part of the "Share" module.
- twitter*
- instagram
- youtube
- github
- gitlab
- keybase
- linkedin*
- medium
- mastodon
- slack
- stackoverflow
- facebook*
- rss
#### Complement
In order to add an unkown service (absent from the list above), you simply need to add all three settings to `ananke_socials`: name, url, label, color, and optionally add an icon file matching the `name` to the `assets/ananke/socials` directory. In the absence of an icon, the theme will print the service's label.
### Content indexing
If the theme is ran in [production](#production), pages will be indexed by search engines. To prevent indexing on some given pages, add `private: true` to its Front Matter.
### Update font or body classes
The theme is set, by default, to use a near-white background color and the "Avenir" or serif typeface. You can change these in your config file with the `body_classes` parameter, like this:
body_classes = "avenir bg-near-white"
which will give you a body class like this:
<body class="avenir bg-near-white">
note: The `body_classes` parameter will not change the font used in post content. To do this, you must use the `post_content_classes` parameter.
You can find a list of available typefaces [here](
And a list of background colors [here](
_n.b. in future versions we will likely separate the typeface and other body classes._
### CSS
Ananke stylesheet is built with Hugo Pipes's [Asset Bundling]( alone to maximize compatibiliy. The theme simply bundles its several files into one minified and fingerprinted (in production) CSS file.
Ananke uses []( utility class library.
#### Custom CSS
WARNING: Pending resolution of this [discussion](, Custom CSS only works with Hugo Extended
In order to complement the default CSS with your own, you can add custom css files to the project.
1. Just add a `assets/ananke/css` directory to your project and add the file(s) in it.
2. Register the files using the `custom_css` key in your site's parameter. The path referenced in the parameter should be relative to the `assets/ananke/css` folder.
The css files will be added in their registered order to final `main.css` file.
For example, if your css files are `assets/ananke/css/custom.css` and `assets/ananke/special.css` then add the following to the config file:
custom_css = ["custom.css","special.css"]
__IMPORTANT__: Files registered through the `custom_css` array, while unlimited in number, must be of the same type (Ex: all `scss` or all `css`)
__Note on retrocompatibiliy for custom css__: If the files registered through the `custom_css` setting are not found in `assets/ananke/css` the theme will expect them to live at the given path relative to the static directory and load them as <link> requests.
### Show Reading Time and Word Count
If you add a key of `show_reading_time` true to either the Config Params, a page or section's front matter, articles will show the reading time and word count.
### Adding Scripts to the Page Head
Some scripts need to be added within the page head. To add your own scripts to the page head, simply insert them into the `head-additions.html` partial located in the `layouts/partials` folder.
### Logo
You can replace the title of your site in the top left corner of each page with your own logo. To do that put your own logo into the `static` directory of your website, and add the `site_logo` parameter to the site params in your config file. For example:
site_logo = "img/logo.svg"
### Set Content Font Color
You can set the font color of the main content both globally and on individual pages:
Set the `text_color` param in the `config.toml` file.
text_color = "green"
Individual Page (prioritized over global):
Set the `text_color` param in a page's markdown file front matter.
note: The value of `text_color` must be a valid tachyons color class. Alist can be found [here](
### Localize date format
Dates of blog posts and single pages are rendered with the default date format commonly used in the USA and Canada. It is possible to specify a different format.
date_format = "2. January 2006"
With hugo 0.87.0 and above, you can also use predefined layout, like `:date_full`, and it will output localized dates or times.
See hugo's documentation of the [`time.Format` function]( for more details.
### Nearly finished
In order to see your site in action, run Hugo's built-in local server.
`$ hugo server`
Now enter [`localhost:1313`](http://localhost:1313/) in the address bar of your browser.
## Production
To run in production (e.g. to have Google Analytics show up), run `HUGO_ENV=production` before your build command. For example:
HUGO_ENV=production hugo
Note: The above command will not work on Windows. If you are running a Windows OS, use the below command:
set HUGO_ENV=production
## Contributing
If you find a bug or have an idea for a feature, feel free to use the [issue tracker]( to let me know.
- fix hard-coded link to [section](
title: "{{ replace .File.ContentBaseName "-" " " | title }}"
date: {{ .Date }}
tags: []
featured_image: ""
description: ""
pre, .pre {
overflow-x: auto;
overflow-y: hidden;
overflow: scroll;
pre code {
display: block;
padding: 1.5em 1.5em;
white-space: pre;
font-size: .875rem;
line-height: 2;
pre {
background-color: #222;
color: #ddd;
white-space: pre;
hyphens: none;
position: relative;
/* pagination.html: */
.pagination {
margin: 3rem 0;
.pagination li {
display: inline-block;
margin-right: .375rem;
font-size: .875rem;
margin-bottom: 2.5em;
[dir="rtl"] .pagination li {
margin-left: .375rem;
margin-right: 0;
.pagination li a {
padding: .5rem .625rem;
background-color: white;
color: #333;
border: 1px solid #ddd;
border-radius: 3px;
text-decoration: none;
.pagination li.disabled {
display: none;
.pagination a:link,
.pagination a:active,
.pagination a:visited {
background-color: #ddd;
#TableOfContents ul li {
margin-bottom: 1em;
.ananke-socials a{
display: inline-block;
vertical-align: middle;
color: #BABABA;
fill: currentColor;
.ananke-socials a .icon svg{
width: 32px;
height: 32px;