Как да създадете блог с Hugo

Въведение

Hugo е генератор на статичен сайт със светкавична скорост на изобразяване и отлична лекота на използване. Благодарение на всичките му функции, ориентирани към съдържанието, винаги можете да се съсредоточите върху създаването на съдържание, а не върху изграждането на средата:

• С Hugo можете да създадете работещ навсякъде статичен сайт за няколко минути, без да се занимавате с досадни зависимости или бази данни.
• Можете да съставите съдържанието си в Markdown, най-удобния стил на писане, и незабавно да видите промените, които сте направили в мрежата.
• Освен това можете да се възползвате максимално от богатото хранилище за теми на Hugo и бързо развиващата се общност.

В този урок ще ви покажа как да инсталирате и използвате Hugo за изграждане на статичен блог сайт на базиран на CentOS сървър Vultr LEMP.

Предпоставки

Влезте във вашия екземпляр като потребител без root права с sudo разрешения. Вижте как да създадете такъв потребител в тази статия .

Стъпка 1: Инсталирайте програмата Hugo

Hugo може да бъде инсталиран на почти всички основни платформи. За CentOS просто трябва да изтеглите най-новия програмен файл в .tar.gzархив и да го разархивирате на удобно място. Към момента на писане най-новата версия е 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

Тествайте инсталацията си със следната команда:

 hugo version

Стъпка 2: Създайте своя сайт

С Hugo можете да изградите своя сайт от всяка папка на вашия сървър. Тук създадох сайт в директорията mysite/под моята домашна директория.

cd ~
hugo new site ~/mysite

Изпълнете следните команди, за да видите архитектурата на сайта:

cd mysite
ls -lF

Както виждате, текущата архитектура на сайта прилича на:

archetypes/

config.toml

content/

data/

layouts/

static/

С още две директории, които предстои да бъдат създадени, themes/и public/, цялата архитектура на един сайт на Hugo е компактна, но всеобхватна.

Като начало знайте, че вашето съдържание трябва да се съхранява в директорията content/.

Стъпка 3: Инсталирайте теми от хранилището на Hugo

За да инсталирате всички теми от хранилището на Hugo, изпълнете следните команди. Те ще създадат директория с име themes/в директорията на вашия сайт и ще изтеглят всички теми от репото на темата Hugo.

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

Ако просто искате да инсталирате една-единствена тема, посетете хранилището за теми на Hugo, за да определите любимата си тема. Копирайте неговия URL и го поставете в git cloneкомандата по-долу.

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

Стъпка 4: Направете някои основни промени в конфигурацията

Файлът, наречен config.tomlв директорията на вашия сайт, съдържа глобалната конфигурация за вашия сайт Hugo. Редактирайте файла с текстов редактор, за да направите някои основни промени в конфигурацията, както е изброено по-долу. Не забравяйте да замените стойностите според вашите специфични условия.

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

Стъпка 5: Съставете вашето съдържание

В директорията на вашия сайт въведете следната команда, за да създадете страница със съдържание в директорията ~/mysite/content/post/.

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

Отворете файла в текстов редактор, форматът на файла трябва да прилича на следния.

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

+++

Между двата реда +++лежи мета информацията за вашата страница със съдържание. Тук можете да премахнете реда draft = trueи да промените заглавния ред, както желаете.

Под втория +++ред добавете съдържанието, което искате да покажете на уеб страницата. Не забравяйте да напишете съдържанието си на езика Markdown.

## This is an H2 headline

Text goes here.

След като завършите тази редакция, оставете текстовия редактор отворен за по-нататъшна употреба.

Стъпка 6: Настройте съдържанието си със сървъра Hugo

Можете да използвате вградения уеб сървър на Hugo за разгръщане на вашия сайт, който може незабавно да покаже вашите промени на уеб страницата веднага щом промените съдържанието си в текстов редактор.

Отворете друг терминал, конфигурирайте iptablesправилата, за да разрешите достъпа ви до вашия сайт на порта по подразбиране 1313 на Hugo сървъра:

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

Стартирайте сървъра Hugo:

hugo server --bind="[YourServerIP]"

Посетете сайта си от браузър:

http://[YourServerIP]:1313

Сега можете да опитате да редактирате съдържанието на файла на страницата в предишния терминал или да добавите/премахнете файл на страницата. Ще откриете, че всички промени в content/директорията ще бъдат отразени едновременно на екрана на вашия браузър. Това е страхотна функция за зает блогър, защото винаги можете веднага да видите своите модификации за по-добро композиране.

След като приключите с редактирането, натиснете , за Ctrl+Cда спрете сървъра Hugo.

Стъпка 7: Публикувайте сайта си

Сега е време да публикувате сайта си в мрежата. Изпълнете следните команди и Hugo ще генерира цялото статично съдържание, подходящо за публикуване в public/директорията.

cd ~/mysite
hugo

Забележка : Hugo няма да изтрие стари файлове, които са били генерирани по-рано, когато изпълните командите по-горе. За да избегнете неочаквани резултати, винаги можете да изтриете public/директорията, преди да hugoизпълните командата, или да посочите нова изходна дестинация, както е показано в следващата команда.

hugo --destination=public2

Тъй като уеб сървърът на Nginx вече работи на сървъра, всичко, което трябва да направите, е да копирате съдържанието на ~/mysite/public/директорията или други персонализирани дестинационни директории във вашата уеб директория /usr/share/nginx/html/.

Изтрийте оригиналните файлове:

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

Копирайте вашите статични файлове на сайта в уеб директорията:

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

Това е. Сега можете да посетите своя супер бърз статичен сайт от вашия браузър: http://[YourServerIP].

За да видите повече подробности, използвайте командата hugo helpили посетете официалния уебсайт на Hugo .