HTML CSS JavaScript Shell Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github fix: orthographe Jun 20, 2017
_authors feat | add author mmaireaux (#497) Jul 27, 2018
_drafts Fix article deboguer vos applications dockerisees avec phpstorm (#486) May 17, 2018
_i18n feat(google-analytics): Add CNIL cookie banner to authorize or not GA Jan 16, 2018
_includes fix: cahnge logo Mar 29, 2018
_layouts feat(font-awesome): update font-awesome to version 5 Mar 12, 2018
_plugins perf(html): compress html and js with layouts Nov 8, 2017
_posts Fix code block in sapient bundle post Aug 16, 2018
_sass style(h2): fix h2 which was inline Apr 27, 2018
assets Renforcer la confidentiatlité des données avec sapient-bundle (#495) Aug 16, 2018
bin fix(bin): proper escaping and add attachment Mar 13, 2018
fonts blog new look and english version (#335) Nov 14, 2017
img feat | add author mmaireaux (#497) Jul 27, 2018
js feat(tracking): use data-tracking attribute Mar 15, 2018
.aspell.en.pws Add script to check spelling in PR using Aspell and Travis (issue #163)… Aug 22, 2017
.aspell.fr.pws Add script to check spelling in PR using Aspell and Travis (issue #163)… Aug 22, 2017
.editorconfig perf(html): compress html and js with layouts Nov 8, 2017
.gitignore Added i18n support Nov 8, 2017
.ruby-version chore(ruby): bump ruby version to match github pages Jul 6, 2017
.travis.yml chore(travis): notify slack script Mar 12, 2018
404.html Added i18n support Nov 8, 2017
CNAME Create CNAME Jul 11, 2017
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Oct 27, 2017
Gemfile Added i18n support Nov 8, 2017
Gemfile.lock feat(security): update gems May 15, 2018
LICENSE Remove trailing whitespace and clean up indentation of files Mar 17, 2015
README.md feat(github,rename): update readme Nov 9, 2017
Rakefile Added i18n support Nov 8, 2017
_algolia.yml Added i18n support Nov 8, 2017
_config.yml blog new look and english version (#335) Nov 14, 2017
docker-compose.yml Add service-workers strategy Nov 9, 2017
favicon.ico fix(pagination): remove wrong or missing slashes Nov 10, 2017
feed.xml Added i18n support Nov 8, 2017
index.html feat(font-awesome): update font-awesome to version 5 Mar 12, 2018
manifest.json feat: ajout des notificaitons Dec 19, 2017
sw.js post(mlenglet): add react optimisation post (#388) Dec 22, 2017

README.md

Build Status

Participer à notre blog

Bienvenue sur le blog d'ElevenLabs, il s'agit d'un site en Jekyll sur lequel tout le monde peut participer.


Installer le blog

Le blog s'installe comme un projet classique.

Prérequis

Avoir ruby d'installé sur sa machine (dernière version) et installer la gem bundler avec la commande qui suit :

gem install bundler

1 - Cloner le projet

git clone git@github.com:eleven-labs/blog.eleven-labs.com.git

2 - Installer Jekyll

cd blog.eleven-labs.com && bundle install

3 - Lancer le blog

bundle exec jekyll serve

Ou via docker

docker run --rm --label=jekyll --volume=$(pwd):/srv/jekyll -it -p 127.0.0.1:4000:4000 jekyll/jekyll jekyll serve

ou

docker-compose up

Vous devriez avoir le blog qui s'affiche dans votre navigateur préféré à l'adresse suivante http://localhost:4000


Créer votre page auteur

1 - Ajoutez votre page

Dans le dossier _authors ajoutez votre page.

cd _authors && touch login.md

2 - Remplissez votre fiche

Veuillez utiliser le template d'auteur suivant. Vous pouvez copier le template disponible dans le fichier _authors/TEMPLATE-AUTOR

---
layout: author
login: votre_login
name: Prénom Nom
twitter: Compte twitter
---
Votre Bio

3 - Ajoutez votre avatar

Ajoutez votre avatar dans le dossier /img/authors/<votre_login>.jpg.

4 - Faites votre pull request

Vous pouvez créer votre branche, avec le naming suivant :

git checkout -b feat/add-author-login

Il ne vous reste plus qu'à faire votre pull request, en mettant le TAG publication.


Créer votre article

1 - Ajoutez votre article

Dans le dossier _drafts ajoutez un fichier pour votre article avec le naming suivant :

AAAA-MM-DD-titre.md

2 - Remplissez le template d'article

Veuillez utiliser le template d'article suivant, vous pouvez copier le template disponible dans le fichier _drafts/TEMPLATE-ARTICLE

---
layout: post
title: TITRE
excerpt: DESCRIPTION (VISIBLE SUR LA HOME)
authors:
    - LOGIN
permalink: /LANGUE (fr/en)/TITRE SANS ESPACES/
categories:
    - CATEGORIE 1
    - CATEGORIE 2
    - ...
tags:
    - TAG 1
    - TAG 2
    - ...
image:
  path: URL D'IMAGE DE HOME
  height: HAUTEUR DE L'IMAGE
  width: LARGEUR DE L'IMAGE
---

VOTRE ARTICLE EN MARKDOWN

ATTENTION S'il s'agit de la reprise d'un article il faut garder le même lien qu'actuellement sur le site dans le permalink.

3 - Ecrivez votre article

Votre article doit être écrit en markdown. Il existe de nombreuses solutions online pour écrire en markdown comme par exemple :

Si vous avez besoin de mettre des images dans votre article il faut d'abord les ajouter dans le dossier suivant assets/AAAA-MM-DD-titre/, puis les insérer dans votre article.

![DESCRIPTION](/assets/AAAA-MM-DD-titre/MON IMAGE)

4 - Demandez la publication

Une fois votre article terminé il faut déplacer le fichier de l'article du dossier _draftsau dossier _posts

cp _drafts/AAAA-MM-DD-NOUVEL-ARTICLE.md _posts/AAAA-MM-DD-NOUVEL-ARTICLE.md

Il vous suffit de faire une pull request avec le nom de branche suivant :

git checkout -b feat/add-article-TITRE

N'oubliez pas le tag publication.


Mettre en ligne un article

1 - Validation d'un article

Tout le monde peut commenter une pull request de publication. Une fois approuvée, elle est mergée dans master.

ATTENTION: Seulement quelques personnes ont le droit de merger les pulls requests

2 - On partage

L'article est en ligne !!! Vous n'avez plus qu'à le partager.


Bonnes pratiques sur les images

1 - Attention à la taille des images

Ne mettez pas d'image ayant une résolution trop grande sur vos articles. Cela engendrerait des baisses de performance. Il ne sert à rien que votre image fasse plus de 800px de large.

2 - Optimiser vos images

Toujours afin de garder des performances satisfaisantes, optimisez vos images à l'aide de logiciels adaptés. Des logiciels comme ImageOptim sur Mac, Trimage sur Lisnux ou FileOptimizer sur Windows offrent des interfaces très faciles d'utilisation et des compressions efficaces.