Hogyan készítsünk blogot Hugoval

Bevezetés

A Hugo egy statikus oldalgenerátor villámgyors renderelési sebességgel és kiválóan használható egyszerűséggel. Minden tartalomorientált funkciójának köszönhetően mindig a tartalom létrehozására összpontosíthat a környezet kialakítása helyett:

• A Hugo segítségével néhány perc alatt létrehozhat egy bárhol működő statikus webhelyet anélkül, hogy unalmas függőségekkel vagy adatbázisokkal kellene foglalkoznia.
• A Markdown segítségével, a legkényelmesebb írási stílusban állíthatja össze a tartalmat, és azonnal láthatja az interneten végzett módosításokat.
• Ezenkívül a legtöbbet hozhatja ki Hugo jómódú tématárából és gyorsan növekvő közösségéből.

Ebben az oktatóanyagban bemutatom, hogyan telepítheti és használhatja a Hugo-t statikus blogwebhely létrehozásához CentOS-alapú Vultr LEMP kiszolgálópéldányon.

Előfeltételek

Jelentkezzen be a példányába nem root felhasználóként, sudo engedélyekkel. Ebben a cikkben megtudhatja, hogyan hozhat létre ilyen felhasználót .

1. lépés: Telepítse a Hugo programot

A Hugo szinte az összes mainstream platformra telepíthető. A CentOS esetében csak le kell töltenie a legújabb programfájlt egy .tar.gzarchívumban, és ki kell csomagolnia egy kényelmes helyre. A cikk írásakor a legújabb verzió a 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

Tesztelje a telepítést a következő paranccsal:

 hugo version

2. lépés: Építse fel webhelyét

A Hugo segítségével webhelyét a szerver bármely mappájából felépítheti. Itt létrehoztam egy webhelyet a saját könyvtáram mysite/alatti könyvtárban.

cd ~
hugo new site ~/mysite

Futtassa a következő parancsokat a webhely architektúrájának megtekintéséhez:

cd mysite
ls -lF

Amint látja, a webhely jelenlegi architektúrája a következőhöz hasonlít:

archetypes/

config.toml

content/

data/

layouts/

static/

További két létrehozandó könyvtárral themes/és public/a Hugo webhely teljes architektúrája kompakt, de átfogó.

Kezdőként tudja, hogy a tartalmat a könyvtárban kell tárolni content/.

3. lépés: Telepítse a témákat a Hugo-tárból

Az összes téma Hugo tárolóból való telepítéséhez futtassa a következő parancsokat. Ezek létrehoznak egy könyvtárat themes/az Ön webhelykönyvtárában, és letöltik az összes témát a Hugo tématárból.

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

Ha csak egyetlen témát szeretne telepíteni, keresse fel a Hugo tématárat, hogy meghatározza kedvenc témáját. Másolja ki az URL-címét, és illessze be az git clonealábbi parancsba.

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

4. lépés: Végezzen néhány alapvető konfigurációs módosítást

A config.tomlwebhelykönyvtárban elnevezett fájl tartalmazza a Hugo webhely globális konfigurációját. Szerkessze a fájlt egy szövegszerkesztővel, és hajtson végre néhány alapvető konfigurációs módosítást az alábbiak szerint. Ne felejtse el az értékeket az adott feltételeknek megfelelően cserélni.

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

5. lépés: Állítsa össze a tartalmat

A webhelykönyvtárban írja be a következő parancsot egy tartalomoldal létrehozásához a könyvtárban ~/mysite/content/post/.

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

Nyissa meg a fájlt egy szövegszerkesztőben, a fájl formátuma hasonlítson a következőre.

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

+++

A két sor között +++található a tartalmi oldalának metainformációja. Itt eltávolíthatja a sort, draft = trueés tetszés szerint módosíthatja a címsort.

A második +++sor alatt adja hozzá a weboldalon megjeleníteni kívánt tartalmat. Ne felejtse el a Markdown nyelven írni a tartalmat.

## This is an H2 headline

Text goes here.

A szerkesztés befejezése után tartsa nyitva a szövegszerkesztőt későbbi használatra.

6. lépés: Állítsa be a tartalmat a Hugo szerverrel

A Hugo beépített webszerverével telepítheti webhelyét, amely azonnal megjelenítheti a módosításokat a weboldalon, amint módosítja a tartalmat egy szövegszerkesztőben.

Nyisson meg egy másik terminált, és iptablesállítsa be a szabályokat, hogy engedélyezze a hozzáférést a webhelyéhez a Hugo szerver alapértelmezett 1313-as portján:

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

Indítsa el a Hugo szervert:

hugo server --bind="[YourServerIP]"

Látogassa meg webhelyét egy böngészőből:

http://[YourServerIP]:1313

Most megpróbálhatja szerkeszteni az oldalfájl tartalmát az előző terminálban, vagy hozzáadni/eltávolítani egy oldalfájlt. Látni fogja, hogy a content/könyvtárban végrehajtott módosítások egyidejűleg megjelennek a böngésző képernyőjén. Ez egy nagyszerű funkció egy elfoglalt blogger számára, mert mindig azonnal láthatja a módosításokat a jobb komponálási élmény érdekében.

A szerkesztés befejezése után nyomja meg Ctrl+Ca gombot a Hugo szerver leállításához.

7. lépés: Tegye közzé webhelyét

Most itt az ideje, hogy közzétegye webhelyét az interneten. Futtassa a következő parancsokat, és a Hugo előállítja az összes publikálásra alkalmas statikus tartalmat a public/könyvtárban.

cd ~/mysite
hugo

Megjegyzés : A Hugo nem törli a korábban generált régi fájlokat a fenti parancsok futtatásakor. A váratlan eredmények elkerülése érdekében public/a hugoparancs futtatása előtt bármikor törölheti a könyvtárat, vagy megadhat egy új kimeneti célt a következő parancs szerint.

hugo --destination=public2

Mivel az Nginx webszerver már fut a szerveren, mindössze annyit kell tennie, hogy átmásolja a ~/mysite/public/címtár vagy más egyéni célkönyvtárak tartalmát a webes könyvtárába /usr/share/nginx/html/.

Törölje az eredeti fájlokat:

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

Másolja a statikus webhelyfájlokat a webkönyvtárba:

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

Ez az. Mostantól böngészőjéből meglátogathatja szupergyors statikus webhelyét: http://[YourServerIP].

További részletek megtekintéséhez használja a parancsot, hugo helpvagy keresse fel a Hugo hivatalos webhelyét .