Objectif
L'objectif est d'installer Jekyll le générateur de site statique depuis les sources ou standard sur le dépôt Debian 9 Stretch.
Versions du système d'exploitation et du logiciel
- Système d'exploitation : – Étirement de Debian 9
- Logiciel : – jekyll 3.4.3 (source) ou jekyll 3.1.6 (dépôt Debian)
Exigences
Un accès privilégié à votre système Debian est requis pour installer les packages Jekyll ainsi que toutes les gemmes prérequises.
Difficulté
FACILE
Congrès
- # - nécessite que les commandes linux données soient exécutées avec les privilèges root soit directement en tant qu'utilisateur root, soit en utilisant
sudo
commande - $ – nécessite que les commandes linux données soient exécutées en tant qu'utilisateur normal non privilégié
Instructions
Installation de 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 besoins, vous pouvez vous retrouver avec une version de Jekyll stable mais obsolète. Pour installer Jekyll exécutez :
# apt install jekyll
Confirmez l'installation de jekyll en demandant son numéro de version :
$ jekyll -v jekyll 3.1.6
Installation des sources
Exécutez la commande linux suivante pour installer la dernière version de 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 exemple. linuxconfig
:
$ jekyll new linuxconfig
La commande ci-dessus a créé un répertoire appelé linuxconfig
contenant une structure jekyll de base de votre nouvelle application.
$ cd linuxconfig/ $ ls about.md _config.yml Gemfile Gemfile.lock index.md _posts
Vous pouvez maintenant modifier _config.yml
fichier de configuration principal pour définir un nouveau nom pour votre site Web, ajouter une description et plus encore. Pour ajouter de nouveaux articles de blog, accédez à _posts
annuaire. Là, modifiez l'exemple de publication ou créez-en un nouveau en copiant l'exemple de publication d'origine en lui donnant un nouveau nom tout en suivant le même format de dénomination.
Afficher le site Web du projet
Accédez à un répertoire nouvellement créé et démarrez votre nouvelle application de projet. Remplacez l'adresse IP ci-dessous par votre adresse IP locale. Si vous n'accédez pas à distance à votre site Web, vous pouvez omettre complètement l'option d'hébergement et votre site démarrera localement :
$ jekyll serve --host 10.1.1.125
Utilisez votre navigateur pour afficher une URL suivante http://10.1.1.125:4000/
ou si exécuté localement http://127.0.0.1:4000/
.