Una dintre dificultățile pe care le-am întâmpinat când încearcă să treci de la Worpress la Jekyll fTrebuie să înțeleg pentru ce a fost fiecare componentă și cum au interacționat între ele. Am găsit soluția când am încetat să încerc să îmi creez blogul de la zero și am început să fac inginerie inversă o tema dezvoltat de altcineva. Avantajele open source.
Pentru a începe, presupunând că ați instalat condițiile prealabile pe care le-am subliniat în articolele anterioare, vom construi site-ul nostru. Exemplul este un blog de grădinărit.
jekyll new blog_de_jardineria
Dacă accesați dosarul, veți vedea următoarele:
- Un folder numit _posturi.
- Două fișiere cu extensie de reducere
- O pagină web.
- Un fișier de configurare cu o extensie .yml despre care vom discuta pe larg în articolul următor.
- Un fișier Gemfile care listează componentele site-ului și altul cu același nume, dar cu o extensie .lock care împiedică modificările accidentale.
Structura proiectului
Ca orice site bazat pe WordPress, Jekyll creează, de asemenea, o structură de dosare în care stochează toate fișierele și o face din aceleași motive. Permiteți utilizatorului să grupeze fișierele în mod ordonat și, pe măsură ce proiectul crește, să rămână gestionabil.
Creăm folderul de bază cu comanda jekyll new. În interiorul acestuia găsim două tipuri de foldere; cele care sunt legate de configurația blogului care sunt identificate cu o liniuță în fața numelui (în cazul nostru dosarul _post și cele care au resurse care nu vor fi incluse ca parte a procesului de creare. De exemplu, cele care conține imagini.
Dosare bazate pe conținut
În acest grup se stochează conținut destinat vizitatorilor site-ului
_ postări
Dosarul _POST conține toate intrările de blog. Aici este utilizat un format foarte specific pentru fiecare dintre fișierele salvate în acesta. Numele fișierului trebuie să fie în formatul date-file-name - year-month-date-full_filename.md - și această dată de afișare va fi afișată ca data la care a fost făcută această postare pe blogul Jekyll. Trebuie să avem în vedere că, deși folderul este numit _ postări, iată tot conținutul pe care cititorii blogului îl vor vedea, de exemplu formularul de contact sau biografiile autorilor. Mai târziu vom vedea că este posibil să atribuiți diferite modele paginilor.
_proiecte
Este echivalentul salvării proiectului WordPress. Utilizarea sa recomandată este pentru postările care nu sunt gata de publicare, deși pot fi folosite pentru a stoca liste de idei, modele de utilizat ulterior etc.
_include
În acest spațiu putem stoca cod html care poate fi reutilizat de mai multe ori. De exemplu, în cazul nostru un banner care salută începutul unui sezon, în funcție de emisfera în care se află utilizatorul.
_aspecte
După cum am spus mai sus, diferite părți ale conținutului pot avea nevoie de aspecte diferite. De exemplu, pentru a afișa un videoclip, am putea dori ca pagina să fie o singură coloană, în timp ce, dacă este un autor invitat, am avea nevoie de o coloană pentru a le arăta biografia și informațiile de contact. Diferitele modele pe care le va utiliza site-ul sunt stocate în acest folder.
Dosare cu informații
Aceste două foldere sunt utilizate de site pentru funcționarea sa.
_date
Într-un blog unic, fișierul de configurare poate stoca toate datele necesare. Dar, dacă avem un blog cu mulți autori, este nevoie de un alt mod de gestionare a informațiilor. Dosarul _date Este folosit pentru a stoca date în format JSON sau CSV pe care site-ul le poate prelua în funcție de interacțiunea cu utilizatorii.
_daca tu
Dosarul _daca tu Site-ul îl completează cu toate informațiile disponibile în folderele anterioare. Aici vom găsi site-ul pe care îl vom încărca pe server, astfel încât utilizatorii să poată accesa. Desigur, deoarece este cod html și css, este posibil să faceți modificări la fel ca orice alt site web.
În articolul următor vom începe modificarea fișierului de configurare.