Cum să creezi un blog cu Hugo

• Introducere
• Cerințe preliminare
• Pasul 1: Instalați programul Hugo
• Pasul 2: Construiește-ți site-ul
• Pasul 3: Instalați teme din depozitul Hugo
• Pasul 4: Faceți câteva modificări de configurare de bază
• Pasul 5: Compuneți-vă conținutul
• Pasul 6: Ajustați conținutul cu serverul Hugo
• Pasul 7: Publicați site-ul

Introducere

Hugo este un generator de site static cu viteză rapidă de redare fulger și ușurință excelentă în utilizare. Datorită tuturor caracteristicilor sale orientate către conținut, vă puteți concentra întotdeauna pe crearea de conținut, mai degrabă decât pe construirea mediului:

• Cu Hugo, puteți construi un site static care rulează oriunde în câteva minute, fără a ține cont de dependențe sau baze de date obositoare.
• Puteți compune conținutul dvs. în Markdown, cel mai convenabil stil de scriere și puteți vedea instantaneu modificările pe care le-ați făcut pe web.
• În plus, puteți profita la maxim de depozitul tematic bogat și de o comunitate cu creștere rapidă.

În acest tutorial, vă voi arăta cum să instalați și să utilizați Hugo pentru a construi un site de blog static pe o instanță a serverului Vultr LEMP bazat pe CentOS.

Cerințe preliminare

Conectați-vă la instanța dvs. ca utilizator non-root cu permisiuni sudo. Vedeți cum puteți crea un astfel de utilizator în acest articol .

Pasul 1: Instalați programul Hugo

Hugo poate fi instalat pe aproape toate platformele mainstream. Pentru CentOS, trebuie doar să descărcați cel mai recent fișier de program într-o .tar.gzarhivă și să-l decuplați într-o locație convenabilă. În momentul scrierii, ultima versiune este 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

Testați instalarea cu următoarea comandă:

 hugo version

Pasul 2: Construiește-ți site-ul

Cu Hugo, puteți construi site-ul dvs. din orice folder de pe serverul dvs. Aici, am construit un site din directorul din directorul mysite/meu de acasă.

cd ~
hugo new site ~/mysite

Executați următoarele comenzi pentru a vedea arhitectura site-ului:

cd mysite
ls -lF

După cum vedeți, arhitectura actuală a site-ului seamănă cu:

arhetipuri /

config.toml

conţinut/

date/

machete /

static/

Cu alte două directoare care urmează să fie create themes/și public/, întreaga arhitectură a unui site Hugo este compactă, dar cuprinzătoare.

Ca starter, știți că conținutul dvs. ar trebui să fie stocat în director content/.

Pasul 3: Instalați teme din depozitul Hugo

Pentru a instala toate temele din depozitul Hugo, executați următoarele comenzi. Acestea vor crea un director numit themes/în directorul site-ului dvs. și vor descărca toate temele din repertoriul temei Hugo.

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

Dacă doriți doar să instalați o singură temă, accesați tematica Hugo pentru a determina tema preferată. Copiați URL-ul și lipiți-l în git clonecomanda de mai jos.

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

Pasul 4: Faceți câteva modificări de configurare de bază

Fișierul numit config.tomlîn directorul site-ului dvs. conține configurația globală pentru site-ul dvs. Hugo. Editați fișierul cu un editor de text pentru a face unele modificări de configurare de bază, așa cum sunt enumerate mai jos. Nu uitați să înlocuiți valorile în funcție de condițiile dvs. specifice.

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

Pasul 5: Compuneți-vă conținutul

În directorul site-ului dvs., introduceți următoarea comandă pentru a crea o pagină de conținut în director ~/mysite/content/post/.

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

Deschideți fișierul într-un editor de text, formatul fișierului trebuie să semene cu următoarele.

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

+++

Între cele două linii de +++minciuni se află informațiile meta despre pagina dvs. de conținut. Aici, puteți elimina linia draft = trueși modifica linia de titlu așa cum doriți.

Sub a doua +++linie, adăugați conținutul pe care doriți să îl afișați pe pagina web. Nu uitați să vă scrieți conținutul în limba Markdown.

## This is an H2 headline

Text goes here.

După terminarea acestei modificări, mențineți editorul de text deschis pentru o utilizare ulterioară.

Pasul 6: Ajustați conținutul cu serverul Hugo

Puteți utiliza serverul web încorporat al lui Hugo pentru a implementa site-ul dvs., care vă poate afișa instantaneu modificările pe pagina web imediat ce modificați conținutul într-un editor de text.

Deschideți un alt terminal, configurați iptablesregulile care vă permit accesul la site-ul dvs. pe portul implicit 1313 al serverului Hugo:

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

Lansați serverul Hugo:

hugo server --bind="[YourServerIP]"

Accesați site-ul dvs. dintr-un browser:

http://[YourServerIP]:1313

Acum, puteți încerca să editați conținutul fișierului paginii în terminalul anterior sau să adăugați / eliminați un fișier de pagină. Veți vedea că orice modificări din content/director vor fi reflectate simultan pe ecranul browserului. Aceasta este o caracteristică excelentă pentru un blogger ocupat, deoarece puteți vedea întotdeauna imediat modificările pentru experiențe de compunere mai bune.

După ce terminați modificarea, apăsați Ctrl+Cpentru a opri serverul Hugo.

Pasul 7: Publicați site-ul

Acum este timpul să publicăm site-ul dvs. pe web. Rulați următoarele comenzi și Hugo va genera tot conținutul static potrivit pentru publicarea în public/director.

cd ~/mysite
hugo

Notă : Hugo nu va șterge fișierele vechi care au fost generate anterior atunci când rulați comenzile de mai sus. Pentru a evita rezultatele neașteptate, puteți șterge întotdeauna public/directorul înainte de a rula hugocomanda sau a specifica o nouă destinație de ieșire, așa cum se arată în următoarea comandă.

hugo --destination=public2

Deoarece serverul web Nginx a rulat deja pe server, tot ce trebuie să faceți este să copiați conținutul ~/mysite/public/directorului sau al altor directoare de destinație personalizate în directorul dvs. Web /usr/share/nginx/html/.

Ștergeți fișierele originale:

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

Copiați fișierele dvs. de sit static în directorul web:

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

Asta e. Acum puteți vizita site-ul dvs. static super rapid din browserul dvs http://[YourServerIP]. : .

Pentru a vedea mai multe detalii, utilizați comanda hugo helpsau accesați site-ul oficial Hugo .