Jak vytvořit blog s Hugem

Úvod

Hugo je generátor statických stránek s bleskovou rychlostí vykreslování a vynikající snadností použití. Díky všem funkcím orientovaným na obsah se můžete vždy soustředit na vytváření obsahu spíše než na vytváření prostředí:

• S Hugem můžete vytvořit statický web běžící kdekoli během několika minut, aniž byste se museli zabývat únavnými závislostmi nebo databázemi.
• Svůj obsah můžete sestavit v Markdown, nejpohodlnějším stylu psaní, a okamžitě uvidíte změny, které jste na webu provedli.
• Kromě toho můžete na maximum využít Hugovo bohaté úložiště témat a rychle rostoucí komunitu.

V tomto tutoriálu vám ukážu, jak nainstalovat a používat Hugo k vytvoření statického blogu na instanci serveru Vultr LEMP založené na CentOS.

Předpoklady

Přihlaste se ke své instanci jako uživatel bez oprávnění root s oprávněními sudo. Podívejte se, jak takového uživatele vytvořit v tomto článku .

Krok 1: Nainstalujte program Hugo

Hugo lze nainstalovat na téměř všechny běžné platformy. Pro CentOS si stačí stáhnout nejnovější soubor programu v .tar.gzarchivu a rozbalit jej na vhodné místo. V době psaní tohoto článku je nejnovější verze 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 instalaci pomocí následujícího příkazu:

 hugo version

Krok 2: Vytvořte svůj web

S Hugem můžete vytvořit svůj web z libovolné složky na vašem serveru. Zde jsem vytvořil web v adresáři mysite/pod mým domovským adresářem.

cd ~
hugo new site ~/mysite

Chcete-li zobrazit architekturu webu, spusťte následující příkazy:

cd mysite
ls -lF

Jak vidíte, současná architektura webu se podobá:

archetypes/

config.toml

content/

data/

layouts/

static/

S dalšími dvěma adresáři, které mají být vytvořeny, themes/a public/, je celá architektura webu Hugo kompaktní, ale komplexní.

Pro začátek vězte, že váš obsah by měl být uložen v adresáři content/.

Krok 3: Nainstalujte motivy z úložiště Hugo

Chcete-li nainstalovat všechna témata z úložiště Hugo, spusťte následující příkazy. Ty vytvoří adresář s názvem themes/v adresáři vašeho webu a stáhnou všechna témata z úložiště témat Hugo.

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

Pokud si chcete nainstalovat pouze jeden motiv, navštivte úložiště motivů Hugo a určete si své oblíbené téma. Zkopírujte jeho adresu URL a vložte ji do git clonepříkazu níže.

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

Krok 4: Proveďte základní změny konfigurace

Soubor pojmenovaný config.tomlv adresáři vašeho webu obsahuje globální konfiguraci vašeho webu Hugo. Upravte soubor pomocí textového editoru a proveďte některé základní konfigurační změny, jak je uvedeno níže. Nezapomeňte nahradit hodnoty podle vašich konkrétních podmínek.

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

Krok 5: Vytvořte svůj obsah

V adresáři webu zadejte následující příkaz k vytvoření stránky s obsahem v adresáři ~/mysite/content/post/.

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

Otevřete soubor v textovém editoru, formát souboru by měl vypadat následovně.

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

+++

Mezi těmito dvěma řádky +++leží metainformace o vaší obsahové stránce. Zde můžete odstranit řádek draft = truea upravit titulní řádek, jak si přejete.

Pod druhý +++řádek přidejte obsah, který chcete na webové stránce zobrazit. Nezapomeňte svůj obsah napsat v jazyce Markdown.

## This is an H2 headline

Text goes here.

Po dokončení této úpravy ponechte textový editor otevřený pro pozdější použití.

Krok 6: Upravte svůj obsah pomocí serveru Hugo

K nasazení svého webu můžete použít vestavěný webový server společnosti Hugo, který dokáže okamžitě zobrazit vaše změny na webové stránce, jakmile upravíte obsah v textovém editoru.

Otevřete jiný terminál, nakonfigurujte iptablespravidla tak, aby vám umožnila přístup k vašemu webu na výchozím portu 1313 serveru Hugo:

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

Spusťte server Hugo:

hugo server --bind="[YourServerIP]"

Navštivte svůj web z prohlížeče:

http://[YourServerIP]:1313

Nyní se můžete pokusit upravit obsah souboru stránky v předchozím terminálu nebo přidat/odebrat soubor stránky. Zjistíte, že jakékoli úpravy v content/adresáři se současně projeví na obrazovce vašeho prohlížeče. To je skvělá funkce pro zaneprázdněné bloggery, protože vždy můžete okamžitě vidět své úpravy pro lepší zážitky při skládání.

Po dokončení úprav stiskněte Ctrl+Cpro zastavení serveru Hugo.

Krok 7: Zveřejněte svůj web

Nyní je čas publikovat vaše stránky na webu. Spusťte následující příkazy a Hugo vygeneruje veškerý statický obsah vhodný pro publikování v public/adresáři.

cd ~/mysite
hugo

Poznámka : Hugo nesmaže staré soubory, které byly vygenerovány dříve, když spustíte výše uvedené příkazy. Abyste se vyhnuli neočekávaným výsledkům, můžete vždy public/před spuštěním hugopříkazu odstranit adresář nebo zadat nový výstupní cíl, jak je znázorněno v následujícím příkazu.

hugo --destination=public2

Protože webový server Nginx již na serveru běží, vše, co musíte udělat, je zkopírovat obsah ~/mysite/public/adresáře nebo jiných vlastních cílových adresářů do vašeho webového adresáře /usr/share/nginx/html/.

Smazat původní soubory:

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

Zkopírujte své statické soubory webu do webového adresáře:

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

A je to. Nyní můžete navštívit váš super rychlý statický web z vašeho prohlížeče: http://[YourServerIP].

Chcete-li zobrazit další podrobnosti, použijte příkaz hugo helpnebo navštivte oficiální web Hugo .