Turpinot ar šī sērija rakstu par to, kā es pārgāju no WordPress uz Jekyll, Ir pienācis laiks atstāt teoriju aiz muguras un pāriet pie prakses.
Es aprakstīju konfigurācijas darbības tādā nozīmē, ka es tās veicu. Pirmais rediģējamais fails ir config.yml. Tajā mēs atrodam vietnes noklusējuma konfigurāciju. Katram konkrētam ierakstam vai lapai var piešķirt atšķirīgu konfigurāciju. Bet, ja mēs to nedarīsim, tiks piešķirts šajā failā izveidotais.
Atcerieties, ka iepriekšējā rakstā mēs bijām lejupielādējuši motīvu un uz to balstāmies savas vietnes izveidē.
Paplašinājums .yml norāda, ka dokuments ir rakstīts, izmantojot YAML. Šī valoda ļauj hierarhijas starp datiem izveidot veidā, kas ir saprotams gan datoriem, gan cilvēkiem. Džekils to izmanto, lai piešķirtu konsekvenci dažādām projekta sastāvdaļām.
Kā konfigurēt vietni, izmantojot YAML
Jekyll pamata projektā ir fails config.yml, kas ļauj mums definēt dažus parametrus.
Šie parametri ir attēloti formātā
Kategorija: “saturs” Ir vērts pieminēt, ka pirms tā ir zīme # tas tiek ignorēts, tādēļ, ja mēs vēlamies, lai Džekils izmantotu šo parametru, tas ir jānoņem.
Mūsu failā config.yml mēs redzēsim kaut ko līdzīgu:
title:
Vietnes nosaukums
email:
Vietnes e-pasts
description:
Vietnes objekta apraksts, kuru var parādīt meklētājprogrammās
baseurl
: Ja emuārs ir citas vietnes daļa un tam ir piešķirta īpaša mape, tas tiek norādīts šeit
url:
Vietnes galvenais domēns.
Ir arī divas citas kategorijas.
twitter_username
github_username:
Šie divi parametri parāda saites uz Twitter un Github lietotāju kontiem.
Zemāk jūs pastāstīsit Jekyll, kuru motīvu izmantot un kuri papildinājumi.
Config.yml sadaļā Minimālas kļūdas
NMēs izmantosim motīvu ar daudz vairāk opcijām, un tāpēc ir nepieciešams pilnīgāks config.yml. Vispraktiskāk ir kopēt failu no tēmas projekta un tā satura vietā ielīmējiet to mūsējā. Kad tas ir izdarīts, mēs rediģējam šādus parametrus
Atcerieties, ka mūsu paraugprojekts bija dārzkopības emuārs.
Pirmais, kas mums jādara, ir noteikt tēmu. Šajā rindā
# theme : "minimal-mistakes-jekyll
»Mēs izdzēšam cipara" # "simbolu
Šī tēma piedāvā vairākas variācijas. Man patīk zvans Aqua. Mēs komentējam "noklusējumu", pirms vārda un komentāra "aqua" ievietojot simbolu #d
Lokalizācija norāda vietnes valodu formātā language_VARIANT. Piemēram, tā kā esmu Argentīnā, tā ir
locale : "es-AR
»
Valodu sarakstu varat atrast šādā valodā: šo lapu
Mēs norādām vietnes nosaukumu
title : "Blog de jardinería"
Mēs izvēlamies atdalītāju starp vietnes nosaukumu un ziņas nosaukumu lai tas meklētājprogrammās tiktu parādīts pareizi.
title_separator : "-"
Mēs varam pievienot apakšvirsrakstu
subtitle: “Llevamos la naturaleza a tu computadora”
Mēs norādām par vietni atbildīgās personas vārdu
name : "Rosendo Margarito Flores"
Mēs pabeidzam vietnes aprakstu parādīt meklētājprogrammās un mājas lapā
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."
Nākamie divi parametri ir divi seni paziņas, bet apgrieztā secībā.
EPirmajā gadījumā mēs norādām vietnes domēnu
url: "https: //desdeeljardin.flor"
Pieņemsim, ka mūsu emuārs bija daļa no sēklu veikala. Mēs, iespējams, vēlēsimies tai piešķirt savu standarta adresi no dārza zieda / emuāra.
Tad mēs darām
baseurl : "/blog"
Kādu iemeslu dēļ ziņas ar attēliem apmeklē vairāk nekā tās, kuras nav. Gadījumā, ja neesat viņiem tādu piešķīris, aktivizējot šo parametru, varat to pēc noklusējuma likt rādīt.
teaser : "/assets/images/500x300.png"
Lai izvairītos no neskaidrībām, es saglabāšu tēmas oriģinālo failu struktūru. Tāpēc mūsu projekta mapē mums ir jāizveido mape ar nosaukumu aktīvi, tajā sauktie attēli, un tās iekšpusē 500 × 300 pikseļi ar nosaukumu 500 × 300.png
Mēs varam izvēlēties arī vietnes logotipu. Mēs atkārtojam procedūru, lai to izveidotu, saglabātu tajās pašās mapēs un pabeigtu parametru:
logo : "/assets/images/88x88.png"
Mēs varam izvēlēties citu nosaukumu nekā vietne, kas tiks parādīta augšpusē pārlūku
masthead_title: “¡Feliz primavera!”
Nākamajā rakstā mēs turpināsim pārskatīt konfigurācijas opcijas. Bet es izmantoju iespēju paskaidrot, ka man nav ne jausmas par dārzkopību. Tāpēc es neesmu atbildīgs par to, ko saka emuāra piemērs.