Kako ustvariti blog s Hugo

Uvod

Hugo je generator statične strani z bliskovito hitrostjo upodabljanja in odlično enostavno uporabo. Zahvaljujoč vsem vsebinsko usmerjenim funkcijam se lahko vedno osredotočite na ustvarjanje vsebine in ne na ustvarjanje okolja:

• S Hugo lahko v nekaj minutah zgradite statično spletno mesto, ki se izvaja kjer koli, ne da bi se ukvarjali z dolgočasnimi odvisnostmi ali bazami podatkov.
• Svojo vsebino lahko sestavite v Markdownu, najbolj priročnem slogu pisanja, in si takoj ogledate spremembe, ki ste jih naredili v spletu.
• Poleg tega lahko kar najbolje izkoristite Hugovo bogato skladišče tem in hitro rastočo skupnost.

V tej vadnici vam bom pokazal, kako namestiti in uporabiti Hugo za izgradnjo statičnega spletnega dnevnika na primerku strežnika Vultr LEMP, ki temelji na CentOS.

Predpogoji

Prijavite se v svoj primer kot nekorenski uporabnik z dovoljenji sudo. Kako ustvariti takega uporabnika, si oglejte v tem članku .

1. korak: Namestite program Hugo

Hugo je mogoče namestiti na skoraj vse glavne platforme. Za CentOS morate samo prenesti najnovejšo programsko datoteko v .tar.gzarhiv in jo razpakirati na priročno mesto. V času pisanja je najnovejša različica 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

Preizkusite svojo namestitev z naslednjim ukazom:

 hugo version

2. korak: zgradite svoje spletno mesto

S Hugo lahko zgradite svoje spletno mesto iz katere koli mape na vašem strežniku. Tukaj sem zgradil spletno mesto v imeniku mysite/pod domačim imenikom.

cd ~
hugo new site ~/mysite

Zaženite naslednje ukaze, da si ogledate arhitekturo mesta:

cd mysite
ls -lF

Kot vidite, je trenutna arhitektura spletnega mesta podobna:

archetypes/

config.toml

content/

data/

layouts/

static/

Z še dvema imenikoma, ki ju je treba ustvariti, themes/in public/, je celotna arhitektura spletnega mesta Hugo kompaktna, a obsežna.

Za začetek vedite, da mora biti vaša vsebina shranjena v imeniku content/.

3. korak: Namestite teme iz skladišča Hugo

Če želite namestiti vse teme iz skladišča Hugo, zaženite naslednje ukaze. Ti bodo ustvarili imenik z imenom themes/v imeniku vašega spletnega mesta in prenesli vse teme iz skladišča teme Hugo.

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

Če želite namestiti samo eno temo, obiščite repo teme Hugo in določite svojo najljubšo temo. Kopirajte njegov URL in ga prilepite v spodnji git cloneukaz.

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

4. korak: Izvedite nekaj osnovnih sprememb konfiguracije

Datoteka, imenovana config.tomlv imeniku vašega spletnega mesta, vsebuje globalno konfiguracijo za vaše spletno mesto Hugo. Uredite datoteko z urejevalnikom besedil, da naredite nekaj osnovnih konfiguracijskih sprememb, kot je navedeno spodaj. Ne pozabite zamenjati vrednosti glede na vaše posebne pogoje.

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

5. korak: Sestavite svojo vsebino

V imenik spletnega mesta vnesite naslednji ukaz, da ustvarite stran z vsebino v imeniku ~/mysite/content/post/.

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

Odprite datoteko v urejevalniku besedil, oblika datoteke mora biti podobna naslednji.

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

+++

Med obema vrsticama +++so meta informacije o vaši strani z vsebino. Tukaj lahko odstranite vrstico draft = truein spremenite naslovno vrstico, kot želite.

Pod drugo +++vrstico dodajte vsebino, ki jo želite prikazati na spletni strani. Ne pozabite napisati svoje vsebine v jeziku Markdown.

## This is an H2 headline

Text goes here.

Po končanem urejanju pustite urejevalnik besedil odprt za kasnejšo uporabo.

6. korak: prilagodite svojo vsebino s strežnikom Hugo

Za namestitev spletnega mesta lahko uporabite vgrajeni spletni strežnik Hugo, ki lahko vaše spremembe takoj prikaže na spletni strani, takoj ko spremenite svojo vsebino v urejevalniku besedil.

Odprite drug terminal, konfigurirajte iptablespravila, da omogočite dostop do svojega spletnega mesta na privzetih vratih strežnika Hugo 1313:

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

Zaženite strežnik Hugo:

hugo server --bind="[YourServerIP]"

Obiščite svoje spletno mesto iz brskalnika:

http://[YourServerIP]:1313

Zdaj lahko poskusite urediti vsebino datoteke strani v prejšnjem terminalu ali dodati/odstraniti datoteko strani. Ugotovili boste, da se bodo vse spremembe v content/imeniku hkrati odražale na zaslonu vašega brskalnika. To je odlična funkcija za zaposlenega blogerja, saj lahko vedno takoj vidite svoje spremembe za boljšo izkušnjo sestavljanja.

Ko končate z urejanjem, pritisnite Ctrl+Cza zaustavitev strežnika Hugo.

7. korak: Objavite svoje spletno mesto

Zdaj je čas, da svojo spletno stran objavite na spletu. Zaženite naslednje ukaze in Hugo bo ustvaril vso statično vsebino, primerno za objavo v public/imeniku.

cd ~/mysite
hugo

Opomba : Hugo ne bo izbrisal starih datotek, ki so bile ustvarjene prej, ko zaženete zgornje ukaze. Da bi se izognili nepričakovanim rezultatom, lahko vedno izbrišete public/imenik, preden zaženete hugoukaz ali podate novo izhodno destinacijo, kot je prikazano v naslednjem ukazu.

hugo --destination=public2

Ker spletni strežnik Nginx že deluje na strežniku, je vse, kar morate storiti, kopirati vsebino ~/mysite/public/imenika ali drugih ciljnih imenikov po meri v vaš spletni imenik /usr/share/nginx/html/.

Izbrišite izvirne datoteke:

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

Kopirajte svoje statične datoteke spletnega mesta v spletni imenik:

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

To je to. Zdaj lahko iz brskalnika obiščete svoje super hitro statično spletno mesto: http://[YourServerIP].

Če si želite ogledati več podrobnosti, uporabite ukaz hugo helpali obiščite uradno spletno stran Hugo .