Συνεχίζοντας με αυτή τη σειρά άρθρων για το πώς πήγα από το WordPress στο Jekyll, Ήρθε η ώρα να αφήσουμε τη θεωρία πίσω και να προχωρήσουμε στην εξάσκηση.
Περιγράφω τα βήματα διαμόρφωσης με την έννοια ότι τα έκανα. Το πρώτο αρχείο που θα επεξεργαστείτε είναι το config.yml. Σε αυτό βρίσκουμε την προεπιλεγμένη διαμόρφωση του ιστότοπου. Σε κάθε συγκεκριμένη ανάρτηση ή σελίδα μπορεί να εκχωρηθεί διαφορετική διαμόρφωση. Αλλά, σε αντίθετη περίπτωση, θα εκχωρηθεί αυτό που έχει δημιουργηθεί σε αυτό το αρχείο.
Θυμηθείτε ότι στο προηγούμενο άρθρο είχαμε κατεβάσει ένα θέμα και στηριζόμαστε σε αυτό για τη δημιουργία του ιστότοπού μας.
Η επέκταση .yml δηλώνει ότι το έγγραφο έχει γραφτεί χρησιμοποιώντας το YAML. Αυτή η γλώσσα επιτρέπει την καθιέρωση ιεραρχιών μεταξύ δεδομένων με τρόπο κατανοητό τόσο στους υπολογιστές όσο και στους ανθρώπους. Ο Jekyll το χρησιμοποιεί για να δώσει συνέπεια στα διάφορα στοιχεία ενός έργου.
Πώς να ρυθμίσετε τον ιστότοπο χρησιμοποιώντας το YAML
Ένα βασικό έργο Jekyll διαθέτει ένα αρχείο config.yml που μας επιτρέπει να καθορίσουμε ορισμένες παραμέτρους.
Αυτές οι παράμετροι παρουσιάζονται στη μορφή
Κατηγορία: "περιεχόμενο" Αξίζει να σημειωθεί ότι προηγείται η πινακίδα # αγνοείται, οπότε αν θέλουμε ο Jekyll να χρησιμοποιήσει αυτήν την παράμετρο, πρέπει να την αφαιρέσουμε.
Στο αρχείο config.yml θα δούμε κάτι σαν αυτό:
title: Ο τίτλος του ιστότοπου
email: Το email του ιστότοπου
description: Μια περιγραφή του αντικειμένου του ιστότοπου για εμφάνιση των μηχανών αναζήτησης
baseurl: Εάν το ιστολόγιο είναι μέρος άλλου ιστότοπου και έχει αντιστοιχιστεί ένας συγκεκριμένος φάκελος, αναφέρεται εδώ
url: Ο κύριος τομέας του ιστότοπου.
Υπάρχουν επίσης δύο άλλες κατηγορίες.
twitter_username
github_username:
Αυτές οι δύο παράμετροι δείχνουν συνδέσμους προς λογαριασμούς χρηστών Twitter και Github.
Παρακάτω θα πείτε στον Jekyll ποιο θέμα να χρησιμοποιήσετε και ποια πρόσθετα.
Config.yml σε ελάχιστα λάθη
Nπρόκειται να χρησιμοποιήσουμε ένα θέμα με πολλές ακόμη επιλογές και, ως εκ τούτου, απαιτεί ένα πιο πλήρες config.yml. Το πιο πρακτικό είναι να αντιγράψετε το αρχείο από το θεματικό έργο και επικολλήστε το στο δικό μας αντί για το περιεχόμενό του. Μόλις γίνει αυτό, επεξεργαζόμαστε τις ακόλουθες παραμέτρους
Θυμηθείτε ότι το παράδειγμα έργου μας ήταν ένα blog κηπουρικής.
Το πρώτο πράγμα που πρέπει να κάνουμε είναι να θέσουμε το θέμα. Σε αυτή τη γραμμή
# theme : "minimal-mistakes-jekyll»Διαγράφουμε το σύμβολο του αριθμού" # "
Αυτό το θέμα προσφέρει πολλές παραλλαγές. Μου αρέσει η κλήση Aqua. Σχολιάζουμε "προεπιλογή", βάζοντας το σύμβολο #d πριν από το όνομα και την αποστολή "aqua
Το Locale δηλώνει τη γλώσσα του ιστότοπου με τη μορφή language_VARIANT. Για παράδειγμα, αφού είμαι στην Αργεντινή, είναι
locale : "es-AR»
Μπορείτε να βρείτε τη λίστα των γλωσσών στο αυτή τη σελίδα
Δείχνουμε τον τίτλο του ιστότοπου
title : "Blog de jardinería"
Επιλέγουμε διαχωριστικό μεταξύ του τίτλου του ιστότοπου και του τίτλου της ανάρτησης έτσι ώστε να εμφανίζεται σωστά στις μηχανές αναζήτησης.
title_separator : "-"
Μπορούμε να προσθέσουμε έναν υπότιτλο
subtitle: “Llevamos la naturaleza a tu computadora”
Υποδεικνύουμε το όνομα του υπευθύνου του ιστότοπου
name : "Rosendo Margarito Flores"
Συμπληρώνουμε την περιγραφή του ιστότοπου για προβολή στις μηχανές αναζήτησης και στην αρχική σελίδα
description : "Un blog para difundir el auto cultivo de vegetales y flores entre aquellos que no tienen la menor idea de cómo se hace."
Οι επόμενες δύο παράμετροι είναι δύο παλιοί γνωστοί, αλλά με αντίστροφη σειρά.
EΣτην πρώτη περίπτωση δηλώνουμε τον τομέα του ιστότοπου
url: "https: //desdeeljardin.flor"
Ας υποθέσουμε ότι το ιστολόγιό μας ήταν μέρος ενός καταστήματος σπόρων. Ίσως θέλουμε να του εκχωρήσουμε τη δική του τυπική διεύθυνση από το λουλούδι κήπου / blog
Τότε κάνουμε
baseurl : "/blog"
Για κάποιο λόγο, οι αναρτήσεις με εικόνες έχουν περισσότερες επισκέψεις από αυτές χωρίς. Σε περίπτωση που δεν τους έχετε εκχωρήσει, μπορείτε να το εμφανίσετε από προεπιλογή ενεργοποιώντας αυτήν την παράμετρο.
teaser : "/assets/images/500x300.png"
Για να αποφευχθεί η σύγχυση, θα διατηρήσω την αρχική δομή αρχείων του θέματος. Επομένως, στο φάκελο του έργου μας πρέπει να δημιουργήσουμε ένα φάκελο που ονομάζεται περιουσιακά στοιχεία, μέσα σε αυτό αποκαλούμενες εικόνες και μέσα σε αυτό 500 × 300 pixel που ονομάζεται 500 × 300.png
Μπορούμε επίσης να επιλέξουμε το λογότυπο του ιστότοπου. Επαναλαμβάνουμε τη διαδικασία για να τη δημιουργήσουμε και να την αποθηκεύσουμε στους ίδιους φακέλους και να ολοκληρώσουμε την παράμετρο:
logo : "/assets/images/88x88.png"
Μπορούμε να επιλέξουμε διαφορετικό τίτλο από τον ιστότοπο που θα εμφανίζεται στην κορυφή πρόγραμμα περιήγησης
masthead_title: “¡Feliz primavera!”
Στο επόμενο άρθρο θα συνεχίσουμε να εξετάζουμε τις επιλογές διαμόρφωσης. Όμως, εκμεταλλεύομαι την ευκαιρία να διευκρινίσω ότι δεν έχω ιδέα για την κηπουρική. Επομένως, δεν είμαι υπεύθυνος για αυτό που λέει το παράδειγμα ιστολογίου.