Ako vytvoriť blog s Hugom

Úvod

Hugo je generátor statických stránok s bleskovou rýchlosťou vykresľovania a vynikajúcou jednoduchosťou použitia. Vďaka všetkým funkciám orientovaným na obsah sa môžete vždy sústrediť na vytváranie obsahu a nie na vytváranie prostredia:

• S Hugom si môžete vytvoriť statickú stránku spustenú kdekoľvek za niekoľko minút bez toho, aby ste sa museli zaoberať únavnými závislosťami alebo databázami.
• Svoj obsah môžete zostaviť v Markdown, najpohodlnejšom štýle písania, a okamžite uvidíte zmeny, ktoré ste vykonali na webe.
• Okrem toho môžete naplno využiť Hugov bohatý archív tém a rýchlo rastúcu komunitu.

V tomto návode vám ukážem, ako nainštalovať a použiť Hugo na vytvorenie statickej blogovej stránky na inštancii servera Vultr LEMP založenej na CentOS.

Predpoklady

Prihláste sa do svojej inštancie ako používateľ bez oprávnenia root s oprávneniami sudo. Ako vytvoriť takéhoto používateľa nájdete v tomto článku .

Krok 1: Nainštalujte program Hugo

Hugo je možné nainštalovať na takmer všetky bežné platformy. Pre CentOS si stačí stiahnuť najnovší súbor programu v .tar.gzarchíve a rozbaliť ho na vhodné miesto. V čase písania tohto článku je najnovšia verzia 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

Otestujte inštaláciu pomocou nasledujúceho príkazu:

 hugo version

Krok 2: Vytvorte si svoj web

S Hugom si môžete vytvoriť svoju stránku z ľubovoľného priečinka na vašom serveri. Tu som vytvoril stránku v adresári mysite/pod mojím domovským adresárom.

cd ~
hugo new site ~/mysite

Ak chcete zobraziť architektúru lokality, spustite nasledujúce príkazy:

cd mysite
ls -lF

Ako vidíte, súčasná architektúra stránky sa podobá:

archetypes/

config.toml

content/

data/

layouts/

static/

S ďalšími dvoma adresármi, ktoré sa majú vytvoriť, themes/a public/, je celá architektúra stránky Hugo kompaktná, ale komplexná.

Ako začiatočník vedzte, že váš obsah by mal byť uložený v adresári content/.

Krok 3: Nainštalujte témy z úložiska Hugo

Ak chcete nainštalovať všetky témy z úložiska Hugo, spustite nasledujúce príkazy. Tým sa vytvorí adresár s názvom themes/v adresári vašej lokality a stiahnu sa všetky témy z úložiska tém Hugo.

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

Ak si chcete nainštalovať iba jednu tému, navštívte úložisko tém Hugo a určte svoju obľúbenú tému. Skopírujte jeho URL a vložte ho do git clonepríkazu nižšie.

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

Krok 4: Vykonajte niekoľko základných zmien konfigurácie

Súbor s názvom config.tomlv adresári vašej lokality obsahuje globálnu konfiguráciu vašej lokality Hugo. Upravte súbor pomocou textového editora a vykonajte niektoré základné konfiguračné zmeny, ako je uvedené nižšie. Nezabudnite nahradiť hodnoty podľa vašich špecifických podmienok.

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

Krok 5: Vytvorte svoj obsah

V adresári vašej lokality zadajte nasledujúci príkaz na vytvorenie stránky s obsahom v adresári ~/mysite/content/post/.

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

Otvorte súbor v textovom editore, formát súboru by mal vyzerať takto.

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

+++

Medzi týmito dvoma riadkami sa +++nachádzajú meta informácie o vašej obsahovej stránke. Tu môžete odstrániť riadok draft = truea upraviť riadok nadpisu, ako chcete.

Pod druhý +++riadok pridajte obsah, ktorý chcete zobraziť na webovej stránke. Nezabudnite napísať svoj obsah v jazyku Markdown.

## This is an H2 headline

Text goes here.

Po dokončení tejto úpravy ponechajte textový editor otvorený pre neskoršie použitie.

Krok 6: Upravte svoj obsah pomocou servera Hugo

Na nasadenie svojej stránky môžete použiť vstavaný webový server spoločnosti Hugo, ktorý dokáže okamžite zobraziť vaše zmeny na webovej stránke hneď, ako upravíte obsah v textovom editore.

Otvorte iný terminál, nakonfigurujte iptablespravidlá tak, aby vám umožnili prístup na vašu stránku na predvolenom porte servera Hugo 1313:

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

Spustite server Hugo:

hugo server --bind="[YourServerIP]"

Navštívte svoje stránky z prehliadača:

http://[YourServerIP]:1313

Teraz sa môžete pokúsiť upraviť obsah súboru stránky v predchádzajúcom termináli alebo pridať/odstrániť súbor stránky. Zistíte, že akékoľvek úpravy v content/adresári sa súčasne prejavia aj na obrazovke vášho prehliadača. Toto je skvelá funkcia pre zaneprázdnených blogerov, pretože vždy môžete okamžite vidieť svoje úpravy, aby ste mali lepšie skúsenosti s písaním.

Po dokončení úprav stlačením Ctrl+Czastavíte server Hugo.

Krok 7: Zverejnite svoj web

Teraz je čas zverejniť vašu stránku na webe. Spustite nasledujúce príkazy a Hugo vygeneruje všetok statický obsah vhodný na publikovanie v rámci public/adresára.

cd ~/mysite
hugo

Poznámka : Hugo nevymaže staré súbory, ktoré boli vygenerované predtým, keď spustíte vyššie uvedené príkazy. Aby ste predišli neočakávaným výsledkom, vždy môžete public/pred spustením hugopríkazu vymazať adresár alebo zadať nové miesto výstupu, ako je to znázornené v nasledujúcom príkaze.

hugo --destination=public2

Keďže webový server Nginx už na serveri beží, všetko, čo musíte urobiť, je skopírovať obsah ~/mysite/public/adresára alebo iných vlastných cieľových adresárov do vášho webového adresára /usr/share/nginx/html/.

Vymažte pôvodné súbory:

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

Skopírujte svoje statické súbory lokality do webového adresára:

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

To je všetko. Teraz môžete navštíviť vašu super rýchlu statickú stránku z vášho prehliadača: http://[YourServerIP].

Ak chcete zobraziť ďalšie podrobnosti, použite príkaz hugo helpalebo navštívte oficiálnu webovú stránku spoločnosti Hugo .