Sådan opretter du en blog med Hugo

Introduktion

Hugo er en statisk site-generator med lynhurtig gengivelseshastighed og fremragende brugervenlighed. Takket være alle dets indholdsorienterede funktioner kan du altid fokusere på at skabe indhold i stedet for at bygge miljøet:

• Med Hugo kan du bygge et statisk websted, der kører overalt, på flere minutter uden at bekymre dig om kedelige afhængigheder eller databaser.
• Du kan komponere dit indhold i Markdown, den mest bekvemme skrivestil, og øjeblikkeligt se de ændringer, du har foretaget på nettet.
• Desuden kan du få mest muligt ud af Hugos velhavende temalager og hurtigt voksende fællesskab.

I denne tutorial vil jeg vise dig, hvordan du installerer og bruger Hugo til at bygge en statisk blogside på en CentOS-baseret Vultr LEMP-serverinstans.

Forudsætninger

Log ind på din instans som en ikke-rootbruger med sudo-tilladelser. Se, hvordan du opretter en sådan bruger i denne artikel .

Trin 1: Installer Hugo-programmet

Hugo kan installeres på næsten alle de almindelige platforme. For CentOS skal du blot downloade den seneste programfil i et .tar.gzarkiv og pakke den ud til et passende sted. I skrivende stund er den seneste version 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 din installation med følgende kommando:

 hugo version

Trin 2: Byg dit websted

Med Hugo kan du bygge dit websted fra en hvilken som helst mappe på din server. Her byggede jeg et websted i biblioteket mysite/under mit hjemmebibliotek.

cd ~
hugo new site ~/mysite

Kør følgende kommandoer for at se webstedets arkitektur:

cd mysite
ls -lF

Som du kan se, ligner webstedets nuværende arkitektur:

archetypes/

config.toml

content/

data/

layouts/

static/

Med yderligere to mapper, der skal oprettes, themes/og public/, er hele arkitekturen på et Hugo-websted kompakt, men alligevel omfattende.

Som en starter skal du vide, at dit indhold skal gemmes i mappen content/.

Trin 3: Installer temaer fra Hugo-depotet

For at installere alle temaer fra Hugo-lageret skal du køre følgende kommandoer. Disse vil oprette en mappe med navn themes/i dit webstedsbibliotek og downloade alle temaerne fra Hugo-temaet.

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

Hvis du bare vil installere et enkelt tema, kan du besøge Hugo-temaet for at bestemme dit yndlingstema. Kopier dens URL og indsæt den i git clonekommandoen nedenfor.

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

Trin 4: Foretag nogle grundlæggende konfigurationsændringer

Filen, der er navngivet config.tomli dit webstedsbibliotek, indeholder den globale konfiguration for dit Hugo-websted. Rediger filen med en teksteditor for at foretage nogle grundlæggende konfigurationsændringer som angivet nedenfor. Husk at udskifte værdierne i henhold til dine specifikke forhold.

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

Trin 5: Sammensæt dit indhold

Indtast følgende kommando i dit webstedsbibliotek for at oprette en indholdsside i kataloget ~/mysite/content/post/.

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

Åbn filen i en teksteditor, filformatet skal ligne følgende.

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

+++

Mellem de to linjer +++ligger metainformationen om din indholdsside. Her kan du fjerne linjen draft = trueog ændre titellinjen som du ønsker.

Under den anden +++linje skal du tilføje det indhold, du vil have vist på websiden. Husk at skrive dit indhold på Markdown-sproget.

## This is an H2 headline

Text goes here.

Når du er færdig med denne redigering, skal du holde teksteditoren åben til senere brug.

Trin 6: Juster dit indhold med Hugo-serveren

Du kan bruge Hugos indbyggede webserver til at implementere dit websted, som øjeblikkeligt kan vise dine ændringer på websiden, så snart du ændrer dit indhold i en teksteditor.

Åbn en anden terminal, konfigurer iptablesreglerne for at tillade din adgang til dit websted på Hugo-serverens standardport 1313:

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

Start Hugo-serveren:

hugo server --bind="[YourServerIP]"

Besøg dit websted fra en browser:

http://[YourServerIP]:1313

Nu kan du prøve at redigere indholdet af sidefilen i den forrige terminal eller tilføje/fjerne en sidefil. Du vil opdage, at eventuelle ændringer i content/mappen vil blive afspejlet samtidigt på din browserskærm. Dette er en fantastisk funktion for en travl blogger, fordi du altid umiddelbart kan se dine ændringer for bedre komponerende oplevelser.

Når du er færdig med din redigering, skal du trykke på for Ctrl+Cat stoppe Hugo-serveren.

Trin 7: Udgiv dit websted

Nu er det tid til at offentliggøre dit websted på nettet. Kør følgende kommandoer, og Hugo vil generere alt det statiske indhold, der er egnet til udgivelse i public/biblioteket.

cd ~/mysite
hugo

Bemærk : Hugo vil ikke slette gamle filer, som blev genereret tidligere, når du kører kommandoerne ovenfor. For at undgå uventede resultater kan du altid slette public/mappen, før du kører hugokommandoen eller angive en ny outputdestination som vist i følgende kommando.

hugo --destination=public2

Da Nginx-webserveren allerede har kørt på serveren, skal du blot kopiere indholdet af ~/mysite/public/mappen eller andre brugerdefinerede destinationsmapper til din webmappe /usr/share/nginx/html/.

Slet de originale filer:

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

Kopier dine statiske webstedsfiler til webbiblioteket:

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

Det er det. Nu kan du besøge dit superhurtige statiske websted fra din browser: http://[YourServerIP].

For at se flere detaljer, brug kommandoen hugo helpeller besøg Hugos officielle hjemmeside .