jekyllCommencer avec jekyll


Remarques

Jekyll est un générateur de site statique simple, compatible avec les blogs. Il prend un répertoire de modèles contenant des fichiers de texte brut dans divers formats, l'exécute via un convertisseur (comme Markdown) et son moteur de rendu Liquid, et crée un site Web statique complet et prêt à être publié pour servir avec votre serveur Web préféré. Jekyll est également le moteur de GitHub Pages, ce qui signifie que vous pouvez utiliser gratuitement Jekyll pour héberger la page, le blog ou le site Web de votre projet à partir des serveurs de GitHub.

Le site Web de Jekyll se trouve à l'adresse http://jekyllrb.com/ , et la documentation peut être consultée à l' adresse http://jekyllrb.com/docs/home/ .


Dernière version:

Version de gemme

Utilisation de base

Le bijou 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 localement le site généré dans votre navigateur.

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

Créer un message et des pages Jekyll

Créer un nouveau post Jekyll

Pour créer un nouveau message Jekyll, créez un nouveau fichier sur le répertoire _posts avec le format

YYYY-MM-DD-title.MARKUP
 

Remplacez MARKUP par l'extension de fichier correspondant à la langue que vous souhaitez utiliser. C'est généralement 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 tout dossier ou répertoire non exclu par Jekyll dans votre répertoire de projet.

about.html
contact/company_info.md
 

REMARQUE: Les fichiers de Page et Post fichiers de Post doivent tous deux être considérés comme des points à traiter. Sinon, ils sont simplement désignés comme StaticFile .

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

---
---

< your content >
 

Installez 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
 

Installez Jekyll sur Windows

  1. Ouvrir 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=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin
  3. Fermez l'invite de commande car Chocolatey ne sera disponible que lorsque vous fermez et rouvrez.
  4. Ouvrir une invite de commande avec un accès administrateur
  5. Intall 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

J'ai trouvé ce guide ici .

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
 

Maintenant, accédez à 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
 

Maintenant, accédez à http: // localhost: 4000