Les plats clés

• Jekyll, un générateur de sites statique écrit en Ruby, peut être utilisé pour créer des sites Web ou des blogs simples et gérables sans avoir besoin de bases de données complexes. Il peut être hébergé gratuitement sur les pages github.
• Poole, décrit comme une ?configuration fondamentale? pour les sites Jekyll, peut être utilisé pour rationaliser le processus de configuration d'un site Jekyll. Il est livré avec des exemples de modèles, de pages, de publications et de styles pour commencer rapidement.
• L'ajout de nouveaux articles à un blog Jekyll consiste à placer un fichier de démarrage dans le dossier _Posts et à s'assurer qu'il contient la matière de front YAML appropriée en haut. Le blog peut ensuite être publié via GitHub Pages, qui nécessite une compréhension de base de Git.

Ces derniers temps, il y a eu quelque chose d'un swing loin des sites Web complexes axés sur la base de données, vers des sites plus simples et plus statiques - où, ce qui est possible, bien s?r, comme avec un simple site de portefeuille ou un blog.

Cela ne veut pas dire que les gens reviennent sur les sites .html d'antan. Vous voulez toujours être en mesure de gérer efficacement les modèles et le code à l'échelle du site, et c'est là que les générateurs de sites statiques entrent en jeu.

Les générateurs de sites statiques sont con?us pour prendre vos différents fichiers statiques et les transformer en site Web. Il y en a beaucoup, beaucoup d'entre eux à choisir, et il y a des articles récents à leur sujet ici sur SitePoint, couvrant les différentes langues dans lesquelles ils viennent, les options basées sur des n?uds, leurs avantages potentiels par rapport à WordPress, et même comment rouler le v?tre avec Grunt .

Dans cet article, nous examinerons Jekyll, l'un des plus populaires et largement utilisés. Je vais décrire comment vous pouvez créer un blog, avec un codage minimal, puis l'héberger gratuitement sur les pages GitHub. Nous utiliserons également Poole, une sorte de cadre - ou ?configuration fondamentale? - pour construire des sites de Jekyll.

Jekyll en un mot

Jekyll est écrit en Ruby. Il est installé sur votre ordinateur sous forme de joyau de rubis. Ce n'est pas un CMS, ce n'est pas un logiciel de blog, il ne vient pas avec des modèles, du contenu, etc. C'est beaucoup plus simple que ?a. Considérez-le comme un programme simple qui fournit des moyens pratiques de traiter vos fichiers.

Une fois Jekyll installé, vous pouvez le mettre au travail à partir de la ligne de commande. Il peut faire des choses comme la marque de processus, et parce qu'elle génère un site statique, vous pouvez facilement visualiser les progrès localement et héberger votre site sur un serveur Web statique comme les pages GitHub.

Installation de Jekyll

Vous devez d'abord installer Jekyll sur votre système. Pour Mac, exécutez la commande suivante dans le terminal pour installer Jekyll:

$ gem install jekyll

Cela installera automatiquement toutes les dépendances de gemmes de Jekyll. Si vous êtes coincé lors de l'installation, consultez la page de dépannage sur le site officiel de Jekyll ou liez un problème sur GitHub.

Bien que Jekyll ne soit pas officiellement pris en charge sur Windows, vous pouvez toujours l'exécuter avec quelques ajustements. Veuillez vous référer à Jekyll sur la page Windows sur le site Web de Jekyll ou à ce guide de Julian Thilo.

Obtenir Poole et votre premier serveur

Au lieu de commencer par un thème de Jekyll brut, utilisons Poole. Il a été créé par Mark Otto, et c'est ainsi qu'il le décrit:

Poole est le majordome de Jekyll, le générateur de sites statique. Il est con?u et développé par @MDO pour fournir une configuration fondamentale claire et concise pour tout site Jekyll. Il le fait en fournissant une installation complète de jekyll à la vanille avec des modèles d'exemples, des pages, des poteaux et des styles.

Vous pouvez voir la version de base ici. Bien que ce soit très bon pour un blog minimal, j'aime les deux thèmes construits plus en plus: Hyde et Lanyon. Utilisons Hyde pour construire notre blog de démonstration.

Pour obtenir la configuration de Hyde, accédez à sa page GitHub et téléchargez le référentiel. Placez-le dans le dossier de votre choix et dirigez-vous vers le terminal. Supposons que vous le gardez sur votre bureau. Exécutez les commandes suivantes pour passer à ce répertoire et démarrer le serveur:

$ gem install jekyll

La commande Jekyll Serve démarrera un serveur de développement qui vous permettra de prévisualiser le site généré dans votre navigateur localement.

Pour comprendre ce que je veux dire, ouvrez un nouvel onglet dans votre navigateur et type: http: // localhost: 4000. Si vous avez tout suivi correctement, vous y trouverez votre nouveau blog.

ajoutant de nouveaux messages

Le référentiel Hyde-Master que vous venez de télécharger contient de nombreux dossiers comme _Layouts, _Posts et _includes. Mais il n'y a qu'un seul dossier dont vous devez vous soucier si vous souhaitez gérer les articles pour votre blog: _Posts. Il contient tous vos messages au format Markdown.

Pour ajouter un nouvel article de blog, placez simplement votre fichier Markdown dans le dossier _Posts. Assurez-vous que vos fichiers Markdown contiennent les éléments suivants (connus sous le nom de YAML Front Matter) en haut:

$ cd Desktop/hyde-master/

$ jekyll serve

Cela indiquera à Jekyll que vous ajoutez un message. (Vérifiez les exemples de messages dans le dossier _Posts si vous avez des doutes.)

Exécutez Jekyll servir à nouveau dans votre terminal et vous trouverez le nouveau message dans votre blog si vous ouvrez http: // localhost: 4000.

Pour assurer une bonne construction de votre blog, Jekyll nécessite cette convention de dénomination:

---
layout: post
title: Your Post Title
---

L'année est un numéro à quatre chiffres, le mois et le jour sont tous deux des numéros à deux chiffres, et le balisage est l'extension de fichier représentant le format utilisé dans le fichier (dans notre cas MD). Par exemple, votre premier message peut être nommé 2015-03-29-mon-premier-Post.md.

Publier votre blog

Une fois que vous avez suivi les étapes ci-dessus et que vous avez ajouté certains de vos propres articles, vous êtes prêt à montrer votre nouveau blog au monde. Vous pouvez publier vos fichiers sur de nombreux h?tes Web, mais GitHub a rendu très facile (et gratuit!) Pour héberger un site Jekyll statique via les pages GitHub. Tout ce que vous avez besoin est d'un compte github.

Avant de le pousser vers GitHub, faisons quelques modifications:

Dans le fichier config.yml:

• Modifier le titre, le slogan, la description github et l'auteur à vos coordonnées personnelles.
• Modifier l'URL vers votre_github_username.github.io.

Dans Cname, mentionnez votre_github_username.github.io au lieu de hyde.getpoole.com. Et modifier à propos de md pour inclure vos coordonnées.

Celui que vous avez apporté ci-dessus modifie, créez un référentiel Votre_GitHub_Username.github.io et déplacez tous les fichiers de votre bureau vers ce référentiel.

Essayez d'ouvrir votre_github_username.github.io dans un navigateur, et vous y trouverez votre nouveau blog.

Un point important à noter: vous devrez conna?tre un peu Git pour pouvoir ajouter vos nouveaux messages au référentiel. Si la ligne de commande n'est pas votre truc, il y a beaucoup d'outils - comme GitHub pour Mac - qui facilitent le travail avec Git. Quoi qu'il en soit, une fois que vous avez ajouté vos messages au référentiel, les pages GitHub prendront en charge le reste.

lecture plus approfondie

Ce post était de vous faire démarrer avec Jekyll, mais il y a beaucoup de choses que vous pouvez faire si vous êtes prêt à passer du temps pour apprendre. Vous trouverez un peu mieux les ressources suivantes pour comprendre Jekyll et Git:

• Documentation Jekyll - très soignée et au point de documentation
• Intro à Jekyll - une bonne explication de Johan Ronsee
• Bases de Git et Github - de la cha?ne YouTube GitHub officielle
• Apprenez les bases de Git en 15 minutes - un tutoriel interactif de l'école de code.

J'espère que vous avez trouvé cet article utile. Si vous essayez de créer un blog en utilisant les étapes mentionnées ci-dessus et restez coincé n'importe où, veuillez poser une question dans les commentaires ci-dessous. Je serai actif là-bas.

Les questions fréquemment posées (FAQ) sur la création d'un blog Jekyll en 5 minutes avec Poole

Qu'est-ce que Jekyll et pourquoi devrais-je l'utiliser pour mon blog?

Jekyll est un générateur de sites simples, conscient de blog, parfait pour les sites personnels, de projet ou d'organisation. Il prend un répertoire de modèle contenant des fichiers texte bruts dans divers formats, l'exécute via un convertisseur et un rendu et crache un site Web statique complet et prêt à publier. Le principal avantage de l'utilisation de Jekyll est sa simplicité. Il ne nécessite pas de bases de données ou de mises à jour, ce qui le rend sécurisé et facile à maintenir. De plus, vous pouvez héberger votre site Web directement sur GitHub gratuitement.

Qu'est-ce que Poole et comment compléte-t-il Jekyll?

Poole est une configuration fondamentale pour les projets Jekyll. Il fournit une configuration fondamentale claire et concise pour tout site Jekyll. Il le fait en fournissant une installation complète de jekyll à la vanille avec des modèles, des pages, des messages et des styles d'exemples. Cela vous aide à vous opérer avec Jekyll en un rien de temps.

Comment installer Jekyll et Poole?

Pour installer Jekyll, vous devez faire installer Ruby sur votre système. Une fois que vous aurez Ruby, vous pouvez installer Jekyll en exécutant la commande GEM Installer Jekyll Bundler. Pour Poole, il vous suffit de télécharger ou de cloner le référentiel Poole de GitHub et vous êtes prêt à y aller.

Comment créer un nouveau message dans Jekyll?

Création d'un nouveau message dans Jekyll est simple. Il vous suffit d'ajouter un fichier dans le répertoire _Posts qui suit la convention Yyyy-mm-dd-name-of-Post.ext et Jekyll le traiteront automatiquement dans un post.

Comment puis-je personnaliser l'apparence et la sensation de mon blog Jekyll?

Vous pouvez personnaliser l'apparence de votre blog Jekyll en modifiant les feuilles de style et les fichiers de mise en page dans les _layouts et _SASS répertoires. Vous pouvez également ajouter vos propres feuilles de style dans le répertoire CSS.

Comment héberger mon blog Jekyll sur GitHub?

Héberger votre blog Jekyll sur Github est facile. Il vous suffit de créer un nouveau référentiel, de pousser votre site Jekyll vers lui, puis de configurer les paramètres du référentiel pour utiliser la branche GH-Pages pour les pages GitHub.

Comment puis-je mettre à jour mon blog Jekyll?

La mise à jour de votre blog Jekyll est aussi simple que d'apporter des modifications à vos fichiers et de les pousser vers votre référentiel GitHub. Jekyll reconstruia automatiquement votre site chaque fois que vous appuyez sur les modifications.

Puis-je utiliser Jekyll avec d'autres langues?

Oui, Jekyll prend en charge plusieurs langues. Vous pouvez configurer la langue de votre site dans le fichier _config.yml et Jekyll gérera le reste.

Comment ajouter des images à mon blog Jekyll?

Vous pouvez ajouter des images à votre Jekyll Blog en les pla?ant dans le répertoire d'images et en les référen?ant dans vos messages ou pages en utilisant la marque appropriée ou la syntaxe HTML.

Puis-je utiliser des plugins avec Jekyll?

Oui, Jekyll prend en charge une large gamme de plugins qui peuvent étendre ses fonctionnalités. Vous pouvez installer des plugins en les ajoutant dans votre fichier Gemfile et _config.yml, puis en exécutant la commande d'installation du bundle.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!