Dépendances:
- Ruby (version 2.4 ; Jekyll requiert au minimum la version 2.0 mais le site peut potentiellement ne pas marcher avec cette version).
- Bundler (
gem install bundler
dans un terminal).
$ git clone https://github.com/robin850/fac
$ cd fac
$ bundle
Pour lancer le serveur en local :
$ bundle exec jekyll server
Pour générer le site sans lancer le serveur :
$ bundle exec jekyll build
- Possibilité de colorer le pseudo code
via
pseudo
dans les fenced code blocks. - Possibilité de surligner les lignes.
Par défaut, Jekyll utilise Kramdown pour générer le Markdown. Ici, Redcarpet est utilisé pour que la génération soit plus rapide mais est une bibliothèque écrite en C ; ça risque donc d'être méga chiant à installer sous Windows.
Pour désactiver Redcarpet et utiliser Kramdown, il faut :
- Commenter la ligne
gem 'redcarpet'
dans le fichierGemfile
. - Possible qu'il faille aussi commenter la ligne
gem "listen"
mais pas sûr. ¯\_(ツ)_/¯ - Lancer la commande
bundle
dans une invite de commande. - Éditer le fichier
_config.yml
et changer l'avant dernière ligne parmarkdown: kramdown
. - Supprimer le fichier
_plugins/custom_converter.rb
.
La fonctionnalité de surlignage du code ne sera juste pas disponible avec Kramdown.
Le code Ruby est sous licence MIT.
Les images SVG du dossier icons/
sont toutes sous licence MIT (credits
Octicons, Raphael.js).
Les fichiers Markdown et les images sont sous licence CC-BY-NC 4.0.