Hvordan lage en blogg med Hugo

Introduksjon

Hugo er en statisk nettstedsgenerator med lynrask gjengivelseshastighet og utmerket brukervennlighet. Takket være alle de innholdsorienterte funksjonene, kan du alltid fokusere på å lage innhold i stedet for å bygge miljøet:

• Med Hugo kan du bygge et statisk nettsted som kjører hvor som helst på flere minutter uten å bekymre deg for kjedelige avhengigheter eller databaser.
• Du kan komponere innholdet ditt i Markdown, den mest praktiske skrivestilen, og umiddelbart se endringene du har gjort på nettet.
• Videre kan du få mest mulig ut av Hugos velstående temalager og raskt voksende fellesskap.

I denne opplæringen vil jeg vise deg hvordan du installerer og bruker Hugo til å bygge en statisk bloggside på en CentOS-basert Vultr LEMP-serverforekomst.

Forutsetninger

Logg på forekomsten din som en ikke-rootbruker med sudo-tillatelser. Se hvordan du oppretter en slik bruker i denne artikkelen .

Trinn 1: Installer Hugo-programmet

Hugo kan installeres på nesten alle ordinære plattformer. For CentOS trenger du bare å laste ned den nyeste programfilen i et .tar.gzarkiv og pakke den ut til et passende sted. I skrivende stund er siste versjon 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

Test installasjonen med følgende kommando:

 hugo version

Trinn 2: Bygg nettstedet ditt

Med Hugo kan du bygge nettstedet ditt fra en hvilken som helst mappe på serveren din. Her bygde jeg et nettsted i katalogen mysite/under hjemmekatalogen min.

cd ~
hugo new site ~/mysite

Kjør følgende kommandoer for å se nettstedets arkitektur:

cd mysite
ls -lF

Som du ser, ligner nettstedets nåværende arkitektur:

archetypes/

config.toml

content/

data/

layouts/

static/

Med ytterligere to kataloger som skal opprettes, themes/og public/, er hele arkitekturen til en Hugo-side kompakt, men likevel omfattende.

Som en start, vet at innholdet ditt skal lagres i katalogen content/.

Trinn 3: Installer temaer fra Hugo-depotet

For å installere alle temaer fra Hugo-depotet, kjør følgende kommandoer. Disse vil opprette en katalog som heter themes/i nettstedskatalogen din og laste ned alle temaene fra Hugo-tema-repoen.

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

Hvis du bare vil installere et enkelt tema, besøk Hugo-temaet for å finne favoritttemaet ditt. Kopier URL-en og lim den inn i git clonekommandoen nedenfor.

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

Trinn 4: Gjør noen grunnleggende konfigurasjonsendringer

Filen som er navngitt config.tomli nettstedskatalogen inneholder den globale konfigurasjonen for Hugo-siden. Rediger filen med et tekstredigeringsprogram for å gjøre noen grunnleggende konfigurasjonsendringer som oppført nedenfor. Husk å erstatte verdiene i henhold til dine spesifikke forhold.

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

Trinn 5: Komponer innholdet ditt

Skriv inn følgende kommando i nettstedkatalogen for å opprette en innholdsside i katalogen ~/mysite/content/post/.

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

Åpne filen i et tekstredigeringsprogram, formatet på filen skal ligne følgende.

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

+++

Mellom de to linjene +++ligger metainformasjonen om innholdssiden din. Her kan du fjerne linjen draft = trueog endre tittellinjen som du ønsker.

Under den andre +++linjen legger du til innholdet du vil vise på nettsiden. Husk å skrive innholdet ditt på Markdown-språket.

## This is an H2 headline

Text goes here.

Etter å ha fullført denne redigeringen, hold tekstredigeringsprogrammet åpent for senere bruk.

Trinn 6: Juster innholdet ditt med Hugo-serveren

Du kan bruke Hugos innebygde webserver til å distribuere nettstedet ditt, som umiddelbart kan vise endringene dine på nettsiden så snart du endrer innholdet ditt i et tekstredigeringsprogram.

Åpne en annen terminal, konfigurer iptablesreglene for å tillate tilgang til nettstedet ditt på Hugo-serverens standardport 1313:

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

Start Hugo-serveren:

hugo server --bind="[YourServerIP]"

Besøk nettstedet ditt fra en nettleser:

http://[YourServerIP]:1313

Nå kan du prøve å redigere innholdet i sidefilen i forrige terminal eller legge til/fjerne en sidefil. Du vil finne at eventuelle endringer i content/katalogen vil reflekteres samtidig på nettleserskjermen. Dette er en flott funksjon for en travel blogger fordi du alltid umiddelbart kan se endringene dine for bedre komposisjonsopplevelser.

Når du er ferdig med redigeringen, trykk for Ctrl+Cå stoppe Hugo-serveren.

Trinn 7: Publiser nettstedet ditt

Nå er det på tide å publisere nettstedet ditt på nettet. Kjør følgende kommandoer og Hugo vil generere alt det statiske innholdet som er egnet for publisering i public/katalogen.

cd ~/mysite
hugo

Merk : Hugo vil ikke slette gamle filer som ble generert tidligere når du kjører kommandoene ovenfor. For å unngå uventede resultater, kan du alltid slette public/katalogen før du kjører hugokommandoen eller spesifisere en ny utdatadestinasjon som vist i følgende kommando.

hugo --destination=public2

Siden Nginx-nettserveren allerede har kjørt på serveren, er alt du trenger å gjøre å kopiere innholdet i ~/mysite/public/katalogen eller andre tilpassede destinasjonskataloger til nettkatalogen din /usr/share/nginx/html/.

Slett originalfilene:

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

Kopier de statiske nettstedfilene dine til nettkatalogen:

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

Det er det. Nå kan du besøke ditt superraske statiske nettsted fra nettleseren din: http://[YourServerIP].

For å se flere detaljer, bruk kommandoen hugo helpeller besøk Hugo offisielle nettsted .