Kuinka luoda online-ansioluettelo, jota käyttävät Jekyll- ja GitHub-sivut

Homerin jatkaminen täyteaineena - Joel Glovier

Viime viikolla olen tutkinut muutama mielenkiintoinen aihe, joka liittyy staattisiin verkkosivustoihin, joita ylläpitävät yksinkertaiset vaihtoehdot. Koko tämän lisätietomatkan aikana paljasin Jekyllin, staattisen sivuston generaattorin, joka toimii sujuvasti valtavan arkistopalvelun tarjoaman GitHub Pages -ominaisuuden kanssa.

Vaikka minulla ei ollut konkreettista suunnitelmaa näistä kahdesta asiasta, aloin selata GitHubia Jekyll-teemoista nähdäkseni, mitä muut ovat keksineet, ja saadakseni tunteen Jekyllin tarjoamien mukautusten määrästä.

Löysin nopeasti Joel Glovierin rakentaman yksinkertaisen jatkamismallin Jekyllille. Heti, hehkulamppu käynnistyi mielessäni, kun aloin äskettäin päivittää ja tarkentaa ansioluetteloni. Sen sijaan, että haluaisin taistella sähköpostien .docx- ja .pdf-tiedostojen, Google Docs- tai Dropbox-tiedostojen kanssa, voisin helposti isännöidä online-versiota GitHub-profiilissani parantaen pääsyä minulle ja rekrytoijille sekä korostaa samalla kokemuksiani repo-palvelusta.

Prosessi ei ollut tarkalleen sujuvin, joten päätin kroonistaa matkani, jotta muilla on helpompaa aikaa. Kaivataan sellaisenaan.

Jekyllin perustaminen ja sen edellytykset

Ensin sinun on asennettava Jekyll ja sen erilaiset edellytykset, joista tärkein on Ruby. Virallisen verkkosivuston dokumentaatio-osa on melko hyvin kirjoitettu, mutta koska käytän Windowsia, tarvitsin erityistä apua. Ne, jotka käyttävät Windows 10 -käyttöjärjestelmää, jossa on Creators- tai Anniversary-päivitys, voivat käyttää uutta Bash-kuorta. Vanhemmat versiot voivat tarkistaa tämän oppaan.

Kun olet asentanut kaiken, on aika haastaa ja kloonata jatkamismallin repo Joel Glovieriltä paikalliselle koneellesi. Suosittelen tätä varten GitHub Desktopin asentamista, joka sisältää myös Git-kuoren.

Mallin mukauttaminen

Kun arkistosi on koneellasi, on aika aloittaa tärkeimpien tiedostojen mukauttaminen, alkaen _config.yml-tiedostosta. Tämä sisältää kaikkien Jekyll-sivustojen konfigurointitiedot. Tässä mallissa voit käyttää sitä osoittamaan tai piilottamaan erilaisia ​​osioita sekä muuttamaan metatietoja, kuten sivustosi otsikkoa.

Saavuttuaan tämän voit hypätä _data-kansioon täyttääksesi osiot itse tiedoillasi. Tiedostot ovat itsestään selviä nimiä ja ovat .yml-muodossa. Voit muokata niitä Notepad / Notepad ++: n tai muiden muokkausohjelmien avulla (käytän Atomia).

Ylimääräistä mukauttamista varten voit siirtyä _layouts-sivulle ja muokata resume.html-tiedostoa esimerkiksi osioiden järjestyksen muuttamiseksi.

Yksi tärkeä muutos, johon kamppailisin, oli korvata rajoitettu määrä kuvakkeita, jotka näkyvät tehtäväsi vastapäätä. Joel lisäsi vain muutaman kuvakkeen, jotka olivat riittävän hyviä, mutta eivät olleet merkityksellisiä minulle. Vietin jonkin aikaa yrittäessään lisätä uutta .svg-kuvaketta Mediumille, koska haluan mainostaa työni täällä. Loppujen lopuksi asiat eivät huonontuneet, joten päätin vain lisätä melko kätevän fonttikokoisen kirjaston.

Sellaisena menin _lisäkkeisiin ja liitin ots.html-tiedostoon skripti-linkin fontti-mahtava. Myöhemmin muokkasin samassa kansiossa kuvaketta-links.html määritelläksesi svg-kuvakkeiden sijasta ne, jotka on rakennettu fonttikokoisiksi.

Saavuttaaksesi värinmuutoksen hiiren osoittimella ja poistaaksesi oletuslinkin värin kuvakkeista, tein myös matkan _sass-kansioon muokkaamaan _resume.css. Täällä kommentoin .icon-link ja sisällöltään .icon-link-item:

Viimeisenä, mutta ei vähäisimpänä, vaikuttaa siltä, ​​että mallin Koulutus-osioon liittyy pieni ongelma. Kuten täsmentin Joelille lähetetyssä lehdessä, kappaleetunnisteesta puuttuu tarvittava tyylimääritys, minkä vuoksi yhteenveto liitetään tutkinnon nimeen.

Asettaa kaiken GitHubiin ja ylläpitää sivuilla

Kun olet mukauttanut kaiken, on aika nostaa se GitHubiin ja antaa Sivut-ominaisuuden isännöidä sitä automaattisesti maailman näkemistä varten.

Virallisella verkkosivustolla annettujen ohjeiden mukaan sinun on luotava uusi arkisto, jonka otsikko on .github.io. Minun tapauksessani tämä on andreidbr.github.io. Klooni tämä repo paikallisesti. Täältä nähtiin nykyinen kokemukseni puute, kun kopioin juuri tiedostoja ja kansioita jatkamismallin paikallisesta kansiosta. Huomaa, että et saa kopioida .git-kansion tai CNAME-tiedoston yli. Lähetä uudet tiedostot ja uusi verkkosivustosi on saatavilla osoitteessa repo-nimessä. Minun tapauksessani jatkaminen on suorana osoitteessa https://andreidbr.github.io/.

Jos haluat käyttää ulkoista osoitetta mukautetulla nimellä, luo tiedosto nimeltä CNAME ja kirjoita osoitteeseen, johon haluat sivuston näkyvän.

takeaways

Tämän kokemuksen jälkeen voin sanoa, että Jekyll on melko komea staattinen sivustogeneraattori, joka voi olla niin monimutkainen tai yksinkertainen kuin haluat. Aloittamalla mallilla onnistuin oppimaan joitain erittäin hyödyllisiä asioita ja saamaan online-jatkamisen prosessissa. Käsittelin myös GitHubia ja sen Pages-ominaisuutta, joten toivon, että tämä artikkeli auttaa muita, jotka haluavat tehdä saman.