Afficher/cacher Sommaire
Jekyll sur Linux Debian 9 Stretch
Installer Jekyll, le générateur de site statique à partir de la source ou du standard sur le référentiel Debian 9 Stretch.
Versions de systèmes d’exploitation et de logiciels
- Système d’exploitation: - Debian 9 Stretch
- Logiciels: - jekyll 3.4.3 (source) ou jekyll 3.1.6 (dépôt Debian)
L’accès privilégié à votre système Debian est nécessaire pour installer les paquets Jekyll ainsi que tous les “gems” préalables.
#
- nécessite que la commande donnée soit exécutée avec les privilèges root soit directement en tant qu’utilisateur root, soit par l’utilisation de la commande sudo$
- commande donnée à exécuter en tant qu’utilisateur régulier non privilégié
Installation Jekyll
Dépôt Debian
C’est de loin le moyen le plus simple d’installer Jekyll sur votre système Linux. L’inconvénient est qu’en fonction de vos exigences, vous risquez de vous retrouver avec une version Jekyll stable mais désuète.
# apt install jekyll
Confirmez l’installation de jekyll en demandant son numéro de version:
$ jekyll -v
jekyll 3.1.6
Installation source
Exécutez la commande suivante pour installer le dernier Jekyll à l’aide de gems:
# apt install build-essential ruby-full
# gem install bundler minima jekyll-feed
Confirmez l’installation de jekyll en demandant son numéro de version:
$ jekyll -v
jekyll 3.4.3
Créer un nouveau projet
Nous sommes maintenant prêts à créer un nouveau projet. Choisissez n’importe quel nom de projet par ex. linuxconfig:
$ jekyll new linuxconfig
La commande ci-dessus a créé un répertoire appelé linuxconfig contenant une structure de base jekyll de votre nouvelle application.
$ cd linuxconfig/
$ ls
about.md _config.yml Gemfile Gemfile.lock index.md _posts
Vous pouvez maintenant éditer le fichier de configuration principal _config.yml pour définir un nouveau nom pour votre site Web, ajouter une description et plus encore. Pour ajouter de nouveaux billets de blog, naviguez dans le répertoire _posts. Là, soit éditer le post d’exemple ou en créer un nouveau en copiant le post d’exemple original en lui donnant un nouveau nom tout en suivant le même format de nommage.
Voir le site Web du projet
Naviguez jusqu’ à un nouveau répertoire et lancez votre nouvelle application de projet. Remplacez l’adresse IP ci-dessous par votre adresse IP locale. Si vous n’accédez pas à votre site Web à distance, vous pouvez omettre complètement l’option hôte et votre site démarrera localement:
$ jekyll serve --host 10.1.1.125
Utilisez votre navigateur pour afficher l’URL suivante http://10.1.1.125:4000/ ou, si vous exécutez localement http://127.0.0.1:4000/.
Jekyll site statique
Installation
Exécutez la commande suivante pour installer le dernier Jekyll à l’aide de gems:
sudo apt install build-essential ruby-full
sudo gem install bundler minima jekyll-feed
Confirmez l’installation de jekyll en demandant son numéro de version:
$ jekyll -v
jekyll 3.6.2
Projet ‘static’
Créer un nouveau projet
$ jekyll new static
Running bundle install in /home/xo/static...
Bundler: The dependency tzinfo-data (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for x86-mingw32, x86-mswin32, x64-mingw32, java. To add those platforms to the bundle, run `bundle lock --add-platform x86-mingw32 x86-mswin32 x64-mingw32 java`.
Bundler: Fetching gem metadata from https://rubygems.org/...........
Bundler: Fetching gem metadata from https://rubygems.org/.
Bundler: Resolving dependencies...
Bundler: Using public_suffix 3.0.0
Bundler: Using addressable 2.5.2
Bundler: Using bundler 1.16.0
Bundler: Using colorator 1.1.0
Bundler: Using ffi 1.9.18
Bundler: Using forwardable-extended 2.6.0
Bundler: Using rb-fsevent 0.10.2
Bundler: Using rb-inotify 0.9.10
Bundler: Using sass-listen 4.0.0
Bundler: Using sass 3.5.3
Bundler: Using jekyll-sass-converter 1.5.0
Bundler: Using listen 3.0.8
Bundler: Using jekyll-watch 1.5.0
Bundler: Using kramdown 1.15.0
Bundler: Using liquid 4.0.0
Bundler: Using mercenary 0.3.6
Bundler: Using pathutil 0.16.0
Bundler: Using rouge 2.2.1
Bundler: Using safe_yaml 1.0.4
Bundler: Using jekyll 3.6.2
Bundler: Using jekyll-feed 0.9.2
Bundler: Using minima 2.1.1
Bundler: Bundle complete! 4 Gemfile dependencies, 22 gems now installed.
Bundler: Use `bundle info [gemname]` to see where a bundled gem is installed.
New jekyll site installed in /home/xo/static.
La commande ci-dessus a créé un répertoire appelé linuxconfig contenant une structure de base jekyll de votre nouvelle application.
$ cd static/
Structure /home/$USER/static/
.
|-- 404.html
|-- Gemfile
|-- Gemfile.lock
|-- _config.yml
|-- _posts
| `-- 2017-11-08-welcome-to-jekyll.markdown
|-- about.md
`-- index.md
1 directory (_posts), 7 files
Vous pouvez maintenant éditer le fichier de configuration principal _config.yml pour définir un nouveau nom pour votre site Web, ajouter une description et plus encore. Pour ajouter de nouveaux billets de blog, naviguez dans le répertoire _posts. Là, soit éditer le post d’exemple ou en créer un nouveau en copiant le post d’exemple original en lui donnant un nouveau nom tout en suivant le même format de nommage.
Voir le site Web du projet
Naviguez jusqu’ à un nouveau répertoire et lancez votre nouvelle application de projet. Remplacez l’adresse IP ci-dessous par votre adresse IP locale. Si vous n’accédez pas à votre site Web à distance, vous pouvez omettre complètement l’option hôte et votre site démarrera localement:
$ jekyll serve --host 93.115.96.97
Utilisez votre navigateur pour afficher l’URL suivante http://93.115.96.97:4000/ ou, si vous exécutez localement http://127.0.0.1:4000/.
Thèmes
Préalable, installer les librairies
sudo apt install patch ruby-dev zlib1g-dev liblzma-dev ruby-rmagick
Ajouter le thème minimal-mistakes
Méthode Gem Ruby
Ajouter la ligne suivante au fichier Gemfile:
gem "minimal-mistakes-jekyll"
Ajouter la ligne suivante au fichiers _config.yml:
theme: minimal-mistakes-jekyll
Exécuter Bundler pour installer le theme gem et les dépendances:
bundle install
Apparence du thème, ajouter la ligne suivante au fichiers _config.yml:
minimal_mistakes_skin: "default" # "air", "aqua", "contrast", "dark", "dirt", "neon", "mint", "plum" "sunrise"
Méthode git
export LANG=fr_FR.UTF-8
git clone https://github.com/mmistakes/minimal-mistakes.git
mv minimal-mistakes jeksite
rm -r jeksite/{.editorconfig,.gitattributes,.github,docs,test,CHANGELOG.md,minimal-mistakes-jekyll.gemspec,README.md,screenshot-layouts.png,screenshot.png}
cd jeksite
Modifier Gemfile et _config.yml
bundle install
Déploiement git https://jekyllrb.com/docs/deployment-methods/ How-to setup a simple git push deployment https://gist.github.com/thomasfr/9691385
Nuage de tag jekyll http://jovandeginste.github.io/2016/05/04/add-a-tag-cloud-to-my-jekyll-site.html