L'une des difficultés que j'ai rencontrées lorsque essaie de passer de Worpress à Jekyll fJe dois comprendre à quoi servait chaque composant et comment ils interagissaient les uns avec les autres. J'ai trouvé la solution lorsque j'ai arrêté d'essayer de créer mon blog à partir de zéro et que j'ai commencé à faire de l'ingénierie inverse un thème développé par quelqu'un d'autre. Les avantages de l'open source.
Pour commencer, en supposant que vous ayez installé les prérequis décrits dans les articles précédents, nous allons créer notre site. L'exemple est un blog de jardinage.
jekyll new blog_de_jardineria
Si vous allez dans le dossier, vous verrez ce qui suit :
- Un dossier appelé _des postes.
- Deux fichiers avec extension markdown
- Une page Web.
- Un fichier de configuration avec une extension .yml dont nous parlerons longuement dans le prochain article.
- Un fichier Gemfile qui répertorie les composants du site et un autre du même nom mais avec une extension .lock qui empêche les modifications par inadvertance.
La structuration du projet
Comme tout site basé sur WordPress, Jekyll crée également une structure de dossiers dans laquelle il stocke tous les fichiers, et ce pour les mêmes raisons. Permettez à l'utilisateur de regrouper les fichiers de manière ordonnée et, à mesure que le projet se développe, reste gérable.
Nous créons le dossier de base avec la commande jekyll new. À l'intérieur, nous trouvons deux types de dossiers; ceux qui sont liés à la configuration du blog qui sont identifiés par un trait d'union devant le nom (dans notre cas le dossier _post et ceux qui ont des ressources qui ne seront pas incluses dans le processus de création. Par exemple, ceux qui contiennent des images.
Dossiers basés sur le contenu
Dans ce groupe se stocke du contenu destiné aux visiteurs du site
_ Publier
Le tapis _POST contient toutes les entrées de blog. Ici, un format très spécifique est utilisé pour chacun des fichiers qui y sont enregistrés. Le nom du fichier doit être au format date-filename - year-month-date-full_filename.md - et cette date de publication sera affichée comme la date à laquelle ce billet de blog Jekyll a été rédigé. Nous devons garder à l'esprit que bien que le dossier s'appelle _ des postes, voici tout le contenu que les lecteurs du blog verront, par exemple le formulaire de contact ou les biographies des auteurs. Plus tard, nous verrons qu'il est possible d'attribuer différents designs aux pages.
_brouillons
C'est l'équivalent de sauvegarder le brouillon WordPress. Son utilisation recommandée est pour les articles qui ne sont pas prêts à être publiés, bien qu'ils puissent être utilisés pour stocker des listes d'idées, des conceptions à utiliser plus tard, etc.
_inclut
Dans cet espace, nous pouvons stocker du code html qui peut être réutilisé plusieurs fois. Par exemple, dans notre cas, une bannière qui salue le début d'une saison en fonction de l'hémisphère dans lequel se trouve l'utilisateur.
_mises en page
Comme nous l'avons dit ci-dessus, différentes parties du contenu peuvent nécessiter des mises en page différentes. Par exemple, pour montrer une vidéo, nous pouvons vouloir que la page soit une seule colonne, tandis que s'il s'agit d'un auteur invité, nous aurions besoin d'une colonne pour afficher sa biographie et ses coordonnées. Les différents designs que le site utilisera sont stockés dans ce dossier.
Dossiers d'informations
Ces deux dossiers sont utilisées par le site pour son fonctionnement.
_données
Dans un blog individuel, le fichier de configuration peut stocker toutes les données nécessaires. Mais, si nous avons un blog avec de nombreux auteurs, une autre façon de gérer les informations est nécessaire. Le tapis _données Il permet de stocker des données aux formats JSON ou CSV que le site peut récupérer en fonction de l'interaction avec les utilisateurs.
_Si vous
Le tapis _Si vous Le site le complète avec toutes les informations disponibles dans les dossiers précédents. Ici, nous trouverons le site que nous téléchargerons sur le serveur afin que les utilisateurs puissent accéder. Bien sûr, puisqu'il s'agit de code html et css, il est possible d'y apporter des modifications comme n'importe quel autre site Web.
Dans le prochain article, nous commencerons à modifier le fichier de configuration.