Darbo su Hugo pradžia: kaip sukurti paprastą svetainę

„Hugo“ yra statinis svetainių generatorius, leidžiantis sukurti svetainę be jokios kodavimo patirties. Galite naudoti iš anksto sukurtas temas kaip savo svetainės dizaino pagrindą. Tai leidžia daugiau dėmesio skirti svetainės užpildymui savo turiniu.

Kadangi Hugo dažniausiai naudojamas statinėms svetainėms, jis puikiai tinka tinklaraščiams, aplankams ar dokumentų svetainėms kurti.

Galite lengvai nustatyti ir sukurti Hugo svetainę naudodami iš anksto sukurtą Hugo temą. Atlikę vos kelis trumpus veiksmus, galite pridėti turinio ir puslapių į savo svetainę naudodami Markdown.

Kaip įdiegti Hugo

Jums reikia įdiegti Hugo statinės svetainės generatorius sukurti, paleisti ir išbandyti „Hugo“ svetainę. Pagal Hugo dokumentacija, yra daug būdų jį įdiegti. Žemiau yra keletas variantų.

Mac

„Hugo“ galite įdiegti naudodami „Homebrew“.

1. Atidarykite „MacOS“ terminalą.
2. Įdiekite „Homebrew“ paketų tvarkyklę.

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Įdiekite Hugo.

   užvirinti diegti hugo

Windows

Jums reikės lygiavertės paketų tvarkyklės, skirtos „Windows“. Pavyzdžiui, galite naudoti Scoop paketų tvarkyklė.

1. Atidarykite „Windows PowerShell“, kuri jau turėtų būti jūsų „Windows“ operacinės sistemos dalis.
2. Jei „Scoop“ diegiate pirmą kartą, gali tekti nustatyti vykdymo politiką.

   Nustatyti„ExecutionPolicy RemoteSigned“ –apimtis Dabartinis vartotojas

3. Įdiekite Scoop:

   iex (naujas-object net.webclient).downloadstring('https://get.scoop.sh')
   

4. Įdiekite „Hugo“:

   samtelis diegti hugo

Kaip sukurti Hugo projektą

Norėdami sukurti naują Hugo projektą, turėsite naudoti įmontuotą hugo nauja svetainė komandą.

1. Atidarykite terminalą arba komandų eilutę. Eikite į aplanką, kuriame norite sukurti savo projektą.
2. Vykdyti hugo nauja svetainė komanda:

   hugo naujas svetainę naujas-hugo-svetainė

3. Eikite į savo Hugo projekto vietą failų naršyklėje.
4. Atidarykite projekto aplanką. Pamatysite, kad jūsų naujoje „Hugo“ svetainėje yra failų ir aplankų struktūra, reikalinga jūsų svetainei veikti.

Kaip pridėti temą

Šiuo metu jūsų projekte yra tik pagrindiniai Hugo projekto pagrindiniai aplankai. Paleidus svetainę lokaliai šiuo metu būtų rodomas tik tuščias ekranas. Kadangi dar nesate savo svetainėje nustatę HTML, CSS ar vartotojo sąsajos dizaino, turėsite juos pridėti.

Hugo jau turi integruotą biblioteką Hugo temos sukūrė kūrėjai.

1. Pasirinkite temą, kuri jums patinka. Kiekviena tema gali turėti šiek tiek skirtingas sąrankos instrukcijas, rodomas atitinkamame peržiūros puslapyje. Šioje mokymo programoje bus naudojamas Pasakos tema pavyzdžiui.
2. Eikite į pagrindinį projekto aplanką terminale arba komandų eilutėje.

   cd naujas-hugo-svetainė

3. Vykdykite komandą, kad pridėtumėte pasakos temą. Galite pridėti temą kaip submodulį, kuris sukurs naują aplanką pavadinimu pasaka viduje tema aplanką.

   git init
   git submodulis pridėti https://github.com/EmielH/tale-hugo.git themes/tale

   Arba galite klonuoti „GitHub“ pasakų saugyklą į savo projekto temų aplanką.

   git klonas https://github.com/EmielH/tale-hugo.git themes/tale

4. Eikite į savo projekto aplanką. Spustelėkite ant temos aplanką, kad jį atidarytumėte. Nepriklausomai nuo to, kurią komandą naudojote, bus nauja pasaka aplanką, kuriame saugoma naujai atsisiųsta tema.
5. Viduje konors config.toml failą, pridėkite pasakos temą kaip konfigūracijos dalį. Tai nurodys Hugo naudoti HTML, CSS ir kitus stilius, kuriuos apima tale tema.

   tema = "pasaka"

Kaip pridėti puslapių į savo svetainę

Savo turinį galite rašyti bet kokiu Hugo priimtinu formatu. Tada Hugo automatiškai konvertuos jūsų failus į HTML failus, kai juos pateiks vartotojui. Tai leidžia greitai sukurti ir įdiegti. Šis pavyzdys bus naudojamas Markdown, paprasta paprasto teksto kalba, kaip jūsų turinio formatą.

Galite rašyti „Markdown“ dažniausiai paprasta anglų kalba su keliais pridėtais simboliais, kad nurodytumėte bet kokį formatavimą. Tai apima simbolių pridėjimą antraštėms, kurie žodžiai yra paryškinti, arba bet kokį kitą pagrindinį formatavimą, kurio jums gali prireikti.

Norėdami į savo svetainę įtraukti naują antrinį puslapį arba įrašą, turėsite pridėti naują Markdown failą turinys aplanką. Kiekvienas įrašas ar puslapis turės savo Markdown failą, susietą su juo.

1. Atidaryk turinys aplanką Hugo projekte. Sukurkite naują Markdown failą, pavadintą myFirstPost.md.
2. Atidarykite failą bet kuriame teksto rengyklėje, pvz., „Notepad++“ arba „Visual Studio Code“.
3. Failo viršuje pridėkite metaduomenų. Tai apims svarbią informaciją apie įrašą. Naudojama tema formatuos šią informaciją puslapyje tam tikru būdu.

   
   autorius: "Tavo vardas"
   pavadinimas: "Mano pirmasis įrašas"
   data: "2022-05-17"
   

4. Pridėję metaduomenis galite pradėti pridėti turinį naudodami Markdown.

   Tai yra mano pirmasis įrašas Hugo svetainėje!
   Naudojama Hugo tema dėltai svetainė vadinasi Tale.
   Tai yra labai paprasta montuoti ir konfigūruoti.
   # Paantraštė
   Tai yra tam tikras turinys.
   # Kita paantraštė
   Tai yra daugiau turinio.

5. Nedvejodami pridėkite daugiau sumažinimo failų, kad pridėtumėte daugiau puslapių į savo svetainę.

Kaip paleisti ir išbandyti „Hugo“ svetainę vietoje

Norėdami paleisti savo svetainę, naudokite hugo tarnauti komandą.

1. Atidarykite terminalą arba komandinę eilutę.
2. Eikite į savo Hugo projekto šakninį aplanką.
3. Paleiskite hugo tarnauti komanda:

   hugo tarnauti

4. Palaukite, kol svetainė baigs paleisties procesą. Kai tai bus baigta, terminalas išspausdins pranešimą, iš kurio vietinio adreso galite pasiekti svetainę. Paprastai tai yra http://localhost: 1313/.
5. Atidarykite žiniatinklio naršyklę ir įveskite http://localhost: 1313/, arba bet kurį adresą, kurį jums suteikė terminalas. Pamatysite pagrindinį savo Hugo svetainės puslapį.
6. Puslapyje bus kiekvieno turimo žymėjimo failo įrašų sąrašas. Šiuo atveju yra du žymėjimo failai, užpildyti turiniu. Tai apima myFirstPost.md puslapį, kurį sukūrėte anksčiau. Jame taip pat yra naujas įrašas pavadinimu bananaCakeRecipe.md.
7. Spustelėkite antraštės nuorodą vienoje iš peržiūrų. Jūs pateksite į visą konkretaus įrašo puslapį.

Jūsų Hugo svetainės talpinimas

Su Hugo paprasta ir greita sukurti statinę svetainę. Galite naudoti ir konfigūruoti iš anksto sukurtas temas ir paleisti „Hugo“ svetainę vietoje, kad galėtumėte išbandyti. Taip pat galite pridėti turinio puslapių į savo svetainę naudodami Markdown.

Sukūrę „Hugo“ svetainę, galite pradėti daugiau sužinoti, kaip ją priglobti. Galite rinktis iš daugybės nemokamų svetainių prieglobos parinkčių, tokių kaip „Dropbox“, „Google“ diskas arba „OneDrive“.

Kaip gauti nemokamą svetainių prieglobą naudojant „Dropbox“, „Google“ diską arba „OneDrive“.

Skaitykite toliau