Viena no grūtībām, ko piedzīvoju, kad mēģiniet iet garām no Vorpressas līdz Jekyll fMan jāsaprot, kam katrs komponents bija domāts un kā viņi mijiedarbojās viens ar otru. Atradu risinājumu, kad pārtraucu mēģināt izveidot savu emuāru no jauna un sāku strādāt inženierzinātnēs tēma ko izstrādājis kāds cits. Atvērtā koda priekšrocības.
Lai sāktu, pieņemot, ka esat instalējis iepriekšējos rakstos izklāstītos priekšnoteikumus, izveidosim savu vietni. Piemērs ir dārzkopības emuārs.
jekyll new blog_de_jardineria
Pārejot uz mapi, redzēsiet sekojošo:
- Mape ar nosaukumu _posteņi.
- Divi faili ar iezīmēšanas paplašinājumu
- Tīmekļa lapa.
- Konfigurācijas fails ar paplašinājumu .yml, kuru mēs ilgi apspriedīsim nākamajā rakstā.
- Gemfile fails, kurā ir uzskaitīti vietnes komponenti un cits nosaukums ar tādu pašu nosaukumu, bet ar paplašinājumu .lock, kas novērš netīšas modifikācijas.
Projekta struktūra
Tāpat kā jebkura vietne, kuras pamatā ir WordPress, arī šeit Jekyll arī izveido mapju struktūru, kurā glabā visus failus, un to dara to pašu iemeslu dēļ. Ļaujiet lietotājam kārtot failus kārtīgi un, projektam pieaugot, palikt pārvaldāmam.
Mēs izveidojam bāzes mapi ar komandu jekyll new. Tās iekšpusē mēs atrodam divu veidu mapes; tie, kas ir saistīti ar emuāra konfigurāciju, kas apzīmēti ar domuzīmi nosaukuma priekšā (mūsu gadījumā mape _post un tie, kuriem ir resursi, kas netiks iekļauti veidošanas procesā. Piemēram, tie, satur attēlus.
Satura mapes
Šajā grupā se uzglabā vietnes apmeklētājiem paredzētu saturu
_ ziņa
Mape _POST satur visus emuāra ierakstus. Šeit katram no tajā saglabātajiem failiem tiek izmantots ļoti īpašs formāts. Faila nosaukumam ir jābūt formātā date-filename - year-month-date-full_filename.md - un šis izlikšanas datums tiks parādīts kā datums, kurā tika publicēta šī Jekyll emuāra ziņa. Mums jāpatur prātā, ka, lai gan mape tiek izsaukta _ ziņas, šeit ir viss saturs, ko redzēs emuāru lasītāji, piemēram, kontaktu veidlapa vai autoru biogrāfijas. Vēlāk mēs redzēsim, ka lapām ir iespējams piešķirt dažādus dizainus.
_ melnraksti
Tas ir ekvivalents WordPress melnraksta saglabāšanai. To ieteicams izmantot ziņām, kuras nav gatavas publicēšanai, lai gan tās var izmantot, lai saglabātu ideju sarakstus, vēlāk izmantojamus dizainus utt.
_ietilpst
Šajā vietā mēs varam uzglabāt html kodu, kuru var atkārtoti izmantot vairākas reizes. Piemēram, mūsu gadījumā reklāmkarogs, kas sveicina sezonas sākumu atkarībā no puslodes, kurā atrodas lietotājs.
_ izkārtojumi
Kā mēs teicām iepriekš, dažādām satura daļām var būt nepieciešami dažādi izkārtojumi. Piemēram, lai parādītu videoklipu, mēs varam vēlēties, lai lapa būtu viena kolonna, savukārt, ja tas ir viesautors, mums ir nepieciešama kolonna, lai parādītu viņu biogrāfiju un kontaktinformāciju. Dažādi dizaini, kurus vietne izmantos, tiek saglabāti šajā mapē.
Informācijas mapes
Šīs divas mapes vietne izmanto tās darbībai.
_dati
Viena cilvēka emuārā konfigurācijas failā var saglabāt visus nepieciešamos datus. Bet, ja mums ir emuārs ar daudziem autoriem, ir nepieciešams cits informācijas pārvaldības veids. Mape _dati To izmanto datu glabāšanai JSON vai CSV formātos, kurus vietne var izgūt atbilstoši mijiedarbībai ar lietotājiem.
_ja tu
Mape _ja tu Vietne to papildina ar visu iepriekšējās mapēs pieejamo informāciju. Šeit mēs atradīsim vietni, kuru augšupielādēsim serverī, lai lietotāji varētu tai piekļūt. Protams, tā kā tas ir html un css kods, tajā ir iespējams veikt izmaiņas kā jebkurā citā vietnē.
Nākamajā rakstā mēs sāksim modificēt konfigurācijas failu.