Tęsiant šią seriją straipsnių apie tai, kaip perėjau iš „WordPress“ į „Jekyll“, Atėjo laikas palikti teoriją ir pereiti prie praktikos.
Aš aprašau konfigūracijos veiksmus ta prasme, kad aš juos atlikau. Pirmasis redaguojamas failas yra config.yml. Čia randame numatytąją svetainės konfigūraciją. Kiekvienam konkrečiam įrašui ar puslapiui galima priskirti skirtingą konfigūraciją. Bet jei to nepadarysime, bus priskirtas tas, kuris nustatytas šiame faile.
Atminkite, kad ankstesniame straipsnyje mes atsisiuntėme temą ir ja remiamės kurdami savo svetainę.
.Yml plėtinys rodo, kad dokumentas parašytas naudojant YAML. Ši kalba leidžia nustatyti hierarchijas tarp duomenų taip, kad būtų suprantama tiek kompiuteriams, tiek žmonėms. Jekyll naudojasi tuo, kad suteiktų nuoseklumo įvairiems projekto komponentams.
Kaip sukonfigūruoti svetainę naudojant YAML
Pagrindiniame „Jekyll“ projekte yra failas config.yml, kuris leidžia mums apibrėžti kai kuriuos parametrus.
Šie parametrai pateikiami formatu
Kategorija: „turinys“ Verta paminėti, kad prieš jį yra ženklas # jis ignoruojamas, todėl jei norime, kad Jekyll naudotų tą parametrą, turime jį pašalinti.
Mūsų faile config.yml pamatysime kažką panašaus:
title:
Svetainės pavadinimas
email:
Svetainės el
description:
Svetainės objekto, kurį gali rodyti paieškos varikliai, aprašymas
baseurl
: Jei tinklaraštis yra kitos svetainės dalis ir jam priskirtas konkretus aplankas, jis nurodomas čia
url:
Pagrindinis svetainės domenas.
Taip pat yra dvi kitos kategorijos.
twitter_username
github_username:
Šie du parametrai rodo nuorodas į „Twitter“ ir „Github“ vartotojų paskyras.
Žemiau Jekyll papasakosite, kurią temą naudoti ir kokius priedus.
Config.yml skiltyje Minimalios klaidos
Nnaudosime temą su daug daugiau parinkčių, todėl reikia išsamesnio config.yml. Praktiškiausia yra kopijuoti byla iš teminio projekto ir įklijuokite jį į mūsų, o ne į jo turinį. Kai tai bus padaryta, mes redaguosime šiuos parametrus
Atminkite, kad mūsų pavyzdinis projektas buvo sodininkystės tinklaraštis.
Pirmas dalykas, kurį turime padaryti, yra nustatyti temą. Šioje eilutėje
# theme : "minimal-mistakes-jekyll
»Ištriname skaitmens„ # “simbolį
Ši tema siūlo keletą variantų. Man patinka skambutis „Aqua“. Mes pakomentuojame „numatytasis“, prieš pavadinimą įrašydami simbolį #d ir nepažymėdami „aqua“
Lokalė nurodo svetainės kalbą formatu language_VARIANT. Pavyzdžiui, kadangi esu Argentinoje, taip yra
locale : "es-AR
»
Kalbų sąrašą galite rasti šiuo puslapiu
Mes nurodome svetainės pavadinimą
title : "Blog de jardinería"
Mes pasirenkame skirtuką tarp svetainės pavadinimo ir įrašo kad jis būtų tinkamai rodomas paieškos sistemose.
title_separator : "-"
Galime pridėti paantraštę
subtitle: “Llevamos la naturaleza a tu computadora”
Nurodome už svetainę atsakingo asmens vardą ir pavardę
name : "Rosendo Margarito Flores"
Mes užpildome svetainės aprašymą rodyti paieškos sistemose ir pagrindiniame puslapyje
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."
Kiti du parametrai yra du seni pažįstami, tačiau atvirkštine tvarka.
EPirmuoju atveju nurodome svetainės domeną
URL: "https: //desdeeljardin.flor"
Tarkime, kad mūsų tinklaraštis buvo sėklų parduotuvės dalis. Galbūt norime priskirti jam savo standartinį adresą iš sodo gėlės / tinklaraščio.
Tada mes darome
baseurl : "/blog"
Kažkodėl įrašuose su vaizdais apsilankoma daugiau nei be jų. Jei nepaskyrėte jų, galite nustatyti numatytąjį ekraną aktyvindami šį parametrą.
teaser : "/assets/images/500x300.png"
Siekdamas išvengti painiavos, ketinu išlaikyti originalią temos failų struktūrą. Todėl savo projekto aplanke turime sukurti aplanką, vadinamą turtu, jame vadinamus vaizdus, o jo viduje - 500 × 300 taškų, vadinamą 500 × 300.png
Taip pat galime pasirinkti svetainės logotipą. Mes pakartojame procedūrą, kad ją sukurtume ir išsaugotume tuose pačiuose aplankuose, ir užpildykite parametrą:
logo : "/assets/images/88x88.png"
Mes galime pasirinkti kitą pavadinimą nei svetainė, kuri bus rodoma viršuje naršyklė
masthead_title: “¡Feliz primavera!”
Kitame straipsnyje mes ir toliau peržiūrėsime konfigūracijos parinktis. Bet aš naudojuosi proga paaiškinti, kad neturiu idėjos apie sodininkystę. Todėl neatsakau už tai, ką sako tinklaraščio pavyzdys.