Kuidas luua Hugoga blogi

Sissejuhatus

Hugo on staatiline saidigeneraator, millel on välkkiire renderduskiirus ja suurepärane kasutusmugavus. Tänu kõigile sisule orienteeritud funktsioonidele saate alati keskenduda sisu loomisele, mitte keskkonna loomisele.

• Hugo abil saate mõne minutiga luua kõikjal töötava staatilise saidi, ilma et peaksite muretsema tüütute sõltuvuste või andmebaaside pärast.
• Saate koostada oma sisu kõige mugavamas kirjutamisstiilis Markdown ja vaadata koheselt veebis tehtud muudatusi.
• Lisaks saate Hugo jõukast teemahoidlast ja kiiresti kasvavast kogukonnast maksimumi võtta.

Selles õpetuses näitan teile, kuidas installida ja kasutada Hugot staatilise ajaveebisaidi loomiseks CentOS-il põhineval Vultr LEMP serveri eksemplaril.

Eeltingimused

Logige oma eksemplari sisse mitte-root-kasutajana, kellel on sudo õigused. Vaadake sellest artiklist, kuidas sellist kasutajat luua .

1. samm: installige programm Hugo

Hugo saab paigaldada peaaegu kõigile tavaplatvormidele. CentOS-i jaoks peate lihtsalt .tar.gzarhiivis alla laadima uusima programmifaili ja pakkima selle sobivasse kohta lahti. Selle artikli kirjutamise ajal on uusim versioon 0.15.

sudo yum update -y
sudo yum install git -y
cd ~
wget https://github.com/spf13/hugo/releases/download/v0.15/hugo_0.15_linux_amd64.tar.gz
tar -zxvf hugo_0.15_linux_amd64.tar.gz
sudo mv hugo_0.15_linux_amd64/hugo_0.15_linux_amd64 /usr/local/bin/hugo

Testige installimist järgmise käsuga:

 hugo version

2. samm: looge oma sait

Hugo abil saate luua saidi mis tahes serveri kaustast. Siin ehitasin saidi mysite/oma kodukataloogi all olevasse kataloogi.

cd ~
hugo new site ~/mysite

Käivitage saidi arhitektuuri vaatamiseks järgmised käsud:

cd mysite
ls -lF

Nagu näete, sarnaneb saidi praegune arhitektuur:

archetypes/

config.toml

content/

data/

layouts/

static/

Lisaks veel kahele loodavale kataloogile themes/ja public/on kogu Hugo saidi arhitektuur kompaktne, kuid terviklik.

Alustuseks pidage meeles, et teie sisu tuleks salvestada kataloogi content/.

3. samm: installige teemad Hugo hoidlast

Kõigi teemade installimiseks Hugo hoidlast käivitage järgmised käsud. Need loovad themes/teie saidi kataloogis nimega kataloogi ja laadivad Hugo teemarepost alla kõik teemad.

cd ~/mysite/
git clone --depth 1 --recursive https://github.com/spf13/hugoThemes.git themes

Kui soovite installida vaid ühe teema, külastage oma lemmikteema määramiseks Hugo teemade repot . Kopeerige selle URL ja kleepige see git cloneallolevasse käsku.

cd ~/mysite/
mkdir themes
cd themes
git clone https://github.com/jaden/twentyfourteen

4. samm: tehke mõned põhikonfiguratsioonimuudatused

config.tomlTeie saidikataloogis nimetatud fail sisaldab teie Hugo saidi globaalset konfiguratsiooni. Redigeerige faili tekstiredaktoriga, et teha mõned allpool loetletud põhikonfiguratsioonimuudatused. Ärge unustage asendada väärtused vastavalt teie konkreetsetele tingimustele.

baseurl = "http://[YourSiteIP]/"
languageCode = "en-us"
title = "Your Site Name"
theme = "twentyfourteen"

5. samm: koostage oma sisu

Sisestage oma saidi kataloogis järgmine käsk, et luua kataloogis sisuleht ~/mysite/content/post/.

cd ~/mysite/
hugo new post/about.md

Ava fail tekstiredaktoris, faili vorming peaks sarnanema järgmisega.

+++
date = "2015-12-25T03:21:23Z"
draft = true
title = "about"

+++

Kahe rea vahel +++on teie sisulehe metateave. Siin saate rea eemaldada draft = trueja pealkirja rida vastavalt soovile muuta.

Teise +++rea alla lisage sisu, mida soovite veebilehel kuvada. Ärge unustage kirjutada oma sisu Markdowni keeles.

## This is an H2 headline

Text goes here.

Pärast selle redigeerimise lõpetamist hoidke tekstiredaktor hilisemaks kasutamiseks avatuna.

6. samm: kohandage oma sisu Hugo serveriga

Saate oma saidi juurutamiseks kasutada Hugo sisseehitatud veebiserverit, mis kuvab teie muudatused veebilehel kohe, kui muudate oma sisu tekstiredaktoris.

Avage teine ​​terminal, konfigureerige iptablesreeglid, mis võimaldavad teil juurdepääsu teie saidile Hugo serveri vaikepordis 1313:

sudo iptables -I INPUT -p tcp --dport 1313 -j ACCEPT

Käivitage Hugo server:

hugo server --bind="[YourServerIP]"

Külastage oma saiti brauseris:

http://[YourServerIP]:1313

Nüüd võite proovida eelmises terminalis lehefaili sisu redigeerida või lehefaili lisada/eemaldada. Te leiate, et kõik content/kataloogis tehtud muudatused kajastuvad samaaegselt teie brauseri ekraanil. See on suurepärane funktsioon hõivatud ajaveebipidaja jaoks, sest näete alati kohe oma muudatusi, et luua paremaid kogemusi.

Pärast redigeerimise lõpetamist vajutage Ctrl+CHugo serveri peatamiseks .

7. samm: avaldage oma sait

Nüüd on aeg oma sait veebis avaldada. Käivitage järgmised käsud ja Hugo genereerib kogu public/kataloogis avaldamiseks sobiva staatilise sisu .

cd ~/mysite
hugo

Märkus : Hugo ei kustuta ülaltoodud käskude käivitamisel vanu varem loodud faile. Ootamatute tulemuste vältimiseks saate public/kataloogi alati enne hugokäsu käivitamist kustutada või määrata uue väljundsihtkoha, nagu on näidatud järgmises käsus.

hugo --destination=public2

Kuna Nginxi veebiserver on serveris juba töötanud, pole vaja teha ~/mysite/public/muud , kui kopeerida kataloogi või muude kohandatud sihtkataloogide sisu oma veebikataloogi /usr/share/nginx/html/.

Kustutage algsed failid:

cd /usr/share/nginx/html/
sudo rm -rf background.jpg index.php logo.png

Kopeerige oma staatilised saidi failid veebikataloogi:

cd ~/mysite/public
sudo cp -R ~/mysite/public/. /usr/share/nginx/html/

See on kõik. Nüüd saate brauserist külastada oma ülikiiret staatilist saiti: http://[YourServerIP].

Lisateabe vaatamiseks kasutage käsku hugo helpvõi külastage Hugo ametlikku veebisaiti .