Kuinka luoda blogi Hugon kanssa

Johdanto

Hugo on staattinen sivustogeneraattori, jolla on salamannopea renderöintinopeus ja erinomainen helppokäyttöisyys. Kaikkien sen sisältölähtöisten ominaisuuksien ansiosta voit aina keskittyä sisällön luomiseen ympäristön rakentamisen sijaan:

• Hugon avulla voit rakentaa missä tahansa käynnissä olevan staattisen sivuston muutamassa minuutissa ilman tylsiä riippuvuuksia tai tietokantoja.
• Voit kirjoittaa sisältösi Markdownilla, kätevimmällä kirjoitustyylillä, ja nähdä välittömästi verkossa tekemäsi muutokset.
• Lisäksi voit hyödyntää Hugon vauras teemavarasto ja nopeasti kasvava yhteisö.

Tässä opetusohjelmassa näytän sinulle, kuinka Hugo asennetaan ja miten staattinen blogisivusto rakennetaan CentOS-pohjaiseen Vultr LEMP -palvelinesiintymään.

Edellytykset

Kirjaudu ilmentymääsi ei-root-käyttäjänä, jolla on sudo-oikeudet. Katso, kuinka tällainen käyttäjä luodaan tästä artikkelista .

Vaihe 1: Asenna Hugo-ohjelma

Hugo voidaan asentaa lähes kaikille valtavirran alustoille. CentOS:lle sinun tarvitsee vain ladata uusin ohjelmatiedosto .tar.gzarkistosta ja purkaa se sopivaan paikkaan. Kirjoitushetkellä uusin versio on 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

Testaa asennus seuraavalla komennolla:

 hugo version

Vaihe 2: Luo sivustosi

Hugon avulla voit rakentaa sivustosi mistä tahansa palvelimesi kansiosta. Täällä rakensin sivuston kotihakemistoni mysite/alla olevaan hakemistoon.

cd ~
hugo new site ~/mysite

Suorita seuraavat komennot nähdäksesi sivuston arkkitehtuurin:

cd mysite
ls -lF

Kuten näet, sivuston nykyinen arkkitehtuuri muistuttaa:

archetypes/

config.toml

content/

data/

layouts/

static/

Kahdella vielä luotavalla hakemistolla themes/ja public/Hugo-sivuston koko arkkitehtuuri on kompakti mutta kattava.

Ensinnäkin tiedä, että sisältösi tulee tallentaa hakemistoon content/.

Vaihe 3: Asenna teemat Hugo-arkistosta

Asenna kaikki teemat Hugo-arkistosta suorittamalla seuraavat komennot. Nämä luovat themes/sivustosi hakemistoon nimetyn hakemiston ja lataavat kaikki teemat Hugo-teemavarastosta.

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

Jos haluat asentaa vain yhden teeman, käy Hugo-teemavarastossa määrittääksesi suosikkiteemasi. Kopioi sen URL-osoite ja liitä se git clonealla olevaan komentoon.

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

Vaihe 4: Tee joitain perusasetuksia

Sivustohakemistossasi nimetty tiedosto config.tomlsisältää Hugo-sivustosi yleiset asetukset. Muokkaa tiedostoa tekstieditorilla tehdäksesi joitain perusasetuksia, kuten alla on lueteltu. Muista vaihtaa arvot erityisehtojesi mukaan.

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

Vaihe 5: Luo sisältösi

Kirjoita sivustohakemistoosi seuraava komento luodaksesi sisältösivun hakemistoon ~/mysite/content/post/.

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

Avaa tiedosto tekstieditorilla, tiedoston muodon tulee olla seuraavanlainen.

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

+++

Kahden rivin välissä +++on sisältösivusi metatiedot. Täällä voit poistaa rivin draft = trueja muokata otsikkoriviä haluamallasi tavalla.

+++Lisää toisen rivin alle sisältö, jonka haluat näyttää verkkosivulla. Muista kirjoittaa sisältösi Markdown-kielellä.

## This is an H2 headline

Text goes here.

Kun tämä muokkaus on valmis, pidä tekstieditori auki myöhempää käyttöä varten.

Vaihe 6: Säädä sisältöäsi Hugo-palvelimella

Voit ottaa sivustosi käyttöön Hugon sisäänrakennetun verkkopalvelimen avulla, joka voi välittömästi näyttää tekemäsi muutokset verkkosivulla heti, kun muokkaat sisältöäsi tekstieditorissa.

Avaa toinen pääte, määritä iptablessäännöt sallimaan pääsy sivustollesi Hugo-palvelimen oletusportissa 1313:

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

Käynnistä Hugo-palvelin:

hugo server --bind="[YourServerIP]"

Vieraile sivustollasi selaimella:

http://[YourServerIP]:1313

Nyt voit yrittää muokata sivutiedoston sisältöä edellisessä päätteessä tai lisätä/poistaa sivutiedoston. Huomaat, että kaikki content/hakemistoon tehdyt muutokset näkyvät samanaikaisesti selaimesi näytöllä. Tämä on loistava ominaisuus kiireiselle bloggaajalle, koska näet aina heti tekemäsi muutokset paremman sävellyskokemuksen saavuttamiseksi.

Kun olet lopettanut muokkauksen, Ctrl+Cpysäytä Hugo-palvelin painamalla .

Vaihe 7: Julkaise sivustosi

Nyt on aika julkaista sivustosi verkossa. Suorita seuraavat komennot ja Hugo luo kaiken staattisen sisällön, joka sopii julkaistavaksi public/hakemistossa.

cd ~/mysite
hugo

Huomautus : Hugo ei poista vanhoja tiedostoja, jotka on luotu aiemmin, kun suoritat yllä olevat komennot. Odottamattomien tulosten välttämiseksi voit aina poistaa public/hakemiston ennen hugokomennon suorittamista tai määrittää uuden tulostuskohteen seuraavan komennon mukaisesti.

hugo --destination=public2

Koska Nginx-verkkopalvelin on jo toiminut palvelimella, sinun tarvitsee vain kopioida ~/mysite/public/hakemiston sisältö tai muut mukautetut kohdehakemistot verkkohakemistoosi /usr/share/nginx/html/.

Poista alkuperäiset tiedostot:

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

Kopioi staattiset sivustotiedostosi verkkohakemistoon:

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

Se siitä. Nyt voit vierailla supernopealla staattisella sivustollasi selaimellasi: http://[YourServerIP].

Jos haluat nähdä lisätietoja, käytä komentoa hugo helptai käy Hugon virallisella verkkosivustolla .