Démarrer avec jekyll

Installation ou configuration

Démarrage rapide pour Jekyll

 $ gem install jekyll
 $ jekyll new my-awesome-site
 $ cd my-awesome-site
~/my-awesome-site $ jekyll serve

Accédez maintenant à http://localhost:4000


Démarrage rapide pour Jekyll avec Bundler

 $ gem install jekyll bundler
 $ jekyll new my-awesome-site
 $ cd my-awesome-site
~/my-awesome-site $ bundle exec jekyll serve

Accédez maintenant à http://localhost:4000

Utilisation de base

La gemme Jekyll met à votre disposition un exécutable jekyll dans votre fenêtre Terminal. Vous pouvez utiliser cette commande de plusieurs manières :

$ jekyll build
# => The current folder will be generated into ./_site

$ jekyll build --destination <destination>
# => The current folder will be generated into <destination>

$ jekyll build --source <source> --destination <destination>
# => The <source> folder will be generated into <destination>

$ jekyll build --watch
# => The current folder will be generated into ./_site,
#    watched for changes, and regenerated automatically.

Jekyll est également livré avec un serveur de développement intégré qui vous permettra de prévisualiser à quoi ressemblera le site généré dans votre navigateur localement.

$ jekyll serve
# => A development server will run at http://localhost:4000/
# Auto-regeneration: enabled. Use `--no-watch` to disable.

Créer des publications et des pages Jekyll

Créer un nouveau message Jekyll

Pour créer un nouveau Jekyll Post, créez un nouveau fichier dans le répertoire _posts au format

YYYY-MM-DD-title.MARKUP

Remplacez MARKUP par l’extension de fichier de la langue que vous souhaitez utiliser. Il s’agit généralement de Markdown (.md ou .markdown) ou HTML (.html).

_posts/2017-01-01-hello-jekyll.md

Créer une nouvelle page Jekyll

Pour créer une nouvelle Page Jekyll, créez un nouveau fichier sur n’importe quel dossier ou répertoire non exclu par Jekyll dans votre répertoire de projet.

about.html
contact/company_info.md

REMARQUE : Les fichiers Page et Post nécessitent que les tirets Front Matter soient pris en compte pour le traitement. Sinon, ils sont simplement désignés comme un StaticFile.

Les tirets Front Matter doivent être au tout début, avant votre contenu, et ressembler simplement à ceci :

---
---

< votre contenu >

Installer Jekyll sur Linux Mint 18

Installez jekyll sur Linux Mint 18 en procédant comme suit :

sudo apt install ruby
sudo apt install build-essential 
sudo apt install ruby-dev
sudo gem install jekyll

Installer Jekyll sur Windows

  1. Ouvrez une invite de commande avec un accès administrateur
  2. Installez Chocolatey : @powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH =%CHEMIN%;%ALLUSERSPROFILE%\chocolatey\bin
  3. Fermez l’invite de commande car Chocolatey ne sera pas disponible tant que vous n’aurez pas fermé et rouvert.
  4. Ouvrez une invite de commande avec un accès administrateur
  5. Installer Ruby : choco install ruby ​​-y
  6. Fermez et ouvrez une nouvelle invite de commande avec un accès administrateur
  7. Installez Jekyll : gem install jekyll

Trouvé ce guide ici.