Kuidas luua veebipõhine resümee, mida toetavad Jekylli ja GitHubi lehed

Homerose jätkamine täitematerjalina - Joel Glovier

Viimase nädala jooksul olen uurinud mõnda huvitavat teemat, mis on seotud staatiliste veebisaitidega, mida hostivad lihtsad võimalused. Kogu selle lisateabe saamiseks mõeldud reisi jooksul paljastasin ma Jekylli, staatilise saidigeneraatori, mis töötab sujuvalt GitHub Pages funktsiooniga, mida pakub tohutu hoidlateenus.

Kuigi mul ei olnud nende kahe asja jaoks konkreetset plaani, asusin GitHubis sirvima Jekylli teemasid, et näha, mida teised on ette tulnud, ja saada ülevaade Jekylli pakutavate kohandamisvõimaluste hulgast.

Leidsin kiiresti Joel Glovieri ehitatud Jekylli lihtsa jätkamismalli. Kohe hakkas minu peas tööle lamp, kuna hakkasin hiljuti oma CV värskendama ja viimistlema. Selle asemel, et e-kirjades, Google Docsis või Dropboxis .docx ja .pdf failidega žongleerida, saaksin oma GitHubi profiilil hõlpsalt veebiversiooni võõrustada, parandades nii minu kui ka värbajate ligipääsetavust, tuues samas esile ka oma kogemused repo teenusega.

Protsess ei olnud just kõige sujuvam, seetõttu otsustasin oma reisi kroonida, et teistel oleks kergem aega veeta. Vaatame siis sisse.

Jekylli seadistamine ja selle eeldused

Esiteks peate installima Jekylli ja selle erinevad eeldused, millest peamine on Ruby. Ametliku veebisaidi dokumentatsiooni osa on üsna hästi kirjutatud, kuid nähes, kuidas ma Windowsi töötan, vajasin konkreetset abi. Need, kes käitavad Windows 10 koos loojate või aastapäeva värskendustega, saavad kasutada uut Bash-kesta. Vanemate versioonidega kasutajad saavad seda juhendit vaadata.

Kui olete kõik seadistanud, on aeg teha Joel Glovieri käest võetud jätkamise malli repo oma kohalikku masinasse kahvlid ja kloonida. Selleks soovitan installida GitHub Desktop, mis sisaldab ka Giti kesta.

Malli kohandamine

Kui teie arvutis on hoidla, on aeg hakata kohandama kõige olulisemaid faile, alustades failist _config.yml. See hõlmab iga Jekylli saidi konfiguratsiooni üksikasju. Sellisel juhul saate seda kasutada mitmesuguste jaotiste kuvamiseks või peitmiseks ning metaandmete muutmiseks, nagu näiteks oma saidi pealkiri.

Pärast selle saavutamist võite hüpata kausta _data, et täita jaotised oma andmetega. Failidel on iseenesestmõistetavad nimed ja need on .yml-vormingus. Saate neid redigeerida Notepad / Notepad ++ või muude redigeerijate abil (ma kasutan Atomit).

Täiendavaks kohandamiseks võite minna jaotistesse _layouts ja redigeerida resume.html, et muuta näiteks jaotiste järjekorda.

Üks oluline muudatus, millega ma hädas olin, oli teie ametinimetuse vastas kuvatavate piiratud arvu ikoonide asendamine. Joel lisas vaid mõned ikoonid, mis olid piisavalt head, kuid ei olnud minu jaoks asjakohased. Veetsin mõnda aega, et lisada keskmisele uus .svg-ikoon, kuna tahan siin oma tööd reklaamida. Lõpuks ei hakanud asjad paika, nii et otsustasin lihtsalt lisada päris käepärase fondi-vinge teegi.

Nagu näiteks, käisin _inclates ja lisasin head.html skriptilingi font-awesome jaoks. Seejärel redigeerisin samas kaustas ikooni-links.html, et täpsustada svg-ikoonide asemel need, mis on sisse ehitatud font-awesome.

Hiirekursoril värvimuutuse saavutamiseks ja ikoonide vaikimisi lingivärvi kaotamiseks võtsin ette ka faili _resume.css redigeerimise kausta _sass. Siin kommenteerisin .icon-link ja enda lisatud .icon-link-üksust:

Ja viimane, kuid mitte vähem oluline, näib, et malli jaotist Haridus puudutab väike teema. Nagu täpsustasin Joelile saadetud väljaandes, puudub lõigumärgendil vajalik stiilimääratlus, mis põhjustab kokkuvõtte lisamist kraadi nimetusele.

Kõigi ülespanek GitHubisse ja majutamine lehtedele

Kui olete kõik kohandanud, on aeg see üles tõsta GitHubisse ja lasta funktsioonil Pages seda automaatselt näha, et maailm seda näeks.

Vastavalt ametliku veebisaidi juhistele peate looma uue hoidla pealkirjaga .github.io. Minu puhul on see andreidbr.github.io. Kloonige see repo kohapeal. Siit näitas minu praegune kogemuste puudumine, kuna kopeerisin lihtsalt failid ja kaustad resume-malli kohalikust kaustast. Pange tähele, et te ei tohi kopeerida .git kausta ega CNAME-faili. Esitage uued failid ja teie uus veebisait on saadaval aadressil repo nimel. Minu puhul on resümee otseülekandes aadressil https://andreidbr.github.io/.

Kui soovite välise aadressi jaoks kasutada kohandatud nime, looge fail nimega CNAME ja kirjutage sellele aadressile, kuhu soovite saiti kuvada.

Eemaldatavad

Pärast seda kogemust võin öelda, et Jekyll on üsna moodne staatiline saitide generaator, mis võib olla nii keeruline või nii lihtne kui soovite. Malliga alustades õnnestus mul õppida väga kasulikke asju ja hankida selle käigus veebipõhine resümee. Samuti sattusin GitHubi ja selle funktsiooni Pages poole, nii et loodan, et see artikkel aitab teisi, kes tahavad sama teha.