Jak stworzyć blog z Hugo

• Wprowadzenie
• Wymagania wstępne
• Krok 1: Zainstaluj program Hugo
• Krok 2: Zbuduj swoją witrynę
• Krok 3: Zainstaluj motywy z repozytorium Hugo
• Krok 4: Wprowadź podstawowe zmiany konfiguracji
• Krok 5: Utwórz treść
• Krok 6: Dostosuj zawartość za pomocą serwera Hugo
• Krok 7: Opublikuj swoją witrynę

Wprowadzenie

Hugo to statyczny generator witryn z błyskawiczną szybkością renderowania i doskonałą łatwością użycia. Dzięki wszystkim funkcjom związanym z treścią zawsze możesz skupić się na tworzeniu treści, a nie na budowaniu środowiska:

• Dzięki Hugo możesz zbudować działającą w dowolnym miejscu stronę statyczną w kilka minut bez uciążliwych zależności lub baz danych.
• Możesz komponować swoje treści w Markdown, najwygodniejszym stylu pisania i od razu widzieć zmiany, które wprowadziłeś w Internecie.
• Ponadto możesz w pełni wykorzystać bogate repozytorium motywów Hugo i szybko rozwijającą się społeczność.

W tym samouczku pokażę, jak zainstalować i używać Hugo, aby zbudować statyczną stronę blogu na opartej na CentOS instancji serwera Vultr LEMP.

Wymagania wstępne

Zaloguj się do instancji jako użytkownik inny niż root z uprawnieniami sudo. Zobacz, jak utworzyć takiego użytkownika w tym artykule .

Krok 1: Zainstaluj program Hugo

Hugo można zainstalować na prawie wszystkich głównych platformach. W przypadku CentOS wystarczy pobrać najnowszy plik programu z .tar.gzarchiwum i rozpakować go w dogodnej lokalizacji. W chwili pisania tego tekstu najnowsza wersja to 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

Przetestuj swoją instalację za pomocą następującego polecenia:

 hugo version

Krok 2: Zbuduj swoją witrynę

Dzięki Hugo możesz zbudować swoją witrynę z dowolnego folderu na serwerze. Tutaj zbudowałem witrynę w katalogu mysite/w moim katalogu domowym.

cd ~
hugo new site ~/mysite

Uruchom następujące polecenia, aby zobaczyć architekturę witryny:

cd mysite
ls -lF

Jak widać, obecna architektura witryny przypomina:

archetypy /

config.toml

zawartość/

dane/

układy /

statyczny/

Kolejne dwa katalogi, które zostaną utworzone, themes/oraz public/cała architektura witryny Hugo jest zwarta, ale wszechstronna.

Na początek wiedz, że Twoje treści powinny być przechowywane w katalogu content/.

Krok 3: Zainstaluj motywy z repozytorium Hugo

Aby zainstalować wszystkie kompozycje z repozytorium Hugo, uruchom następujące polecenia. Spowoduje to utworzenie katalogu o nazwie themes/w katalogu witryny i pobranie wszystkich motywów z repozytorium motywów Hugo.

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

Jeśli chcesz zainstalować tylko jeden motyw, odwiedź repozytorium motywów Hugo, aby określić swój ulubiony motyw. Skopiuj adres URL i wklej go w git cloneponiższym poleceniu.

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

Krok 4: Wprowadź podstawowe zmiany konfiguracji

Plik o nazwie config.tomlw katalogu witryny zawiera globalną konfigurację witryny Hugo. Edytuj plik za pomocą edytora tekstu, aby wprowadzić podstawowe zmiany konfiguracji, jak podano poniżej. Pamiętaj, aby zastąpić wartości zgodnie z określonymi warunkami.

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

Krok 5: Utwórz treść

W katalogu witryny wprowadź następującą komendę, aby utworzyć stronę zawartości w katalogu ~/mysite/content/post/.

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

Otwórz plik w edytorze tekstów, format pliku powinien wyglądać następująco.

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

+++

Między dwoma wierszami +++leży meta informacja o stronie z treścią. Tutaj możesz usunąć linię draft = truei zmodyfikować linię tytułu, jak chcesz.

Pod drugim +++wierszem dodaj treść, którą chcesz wyświetlić na stronie internetowej. Pamiętaj, aby pisać swoje treści w języku Markdown.

## This is an H2 headline

Text goes here.

Po zakończeniu edycji pozostaw edytor tekstu otwarty do późniejszego użycia.

Krok 6: Dostosuj zawartość za pomocą serwera Hugo

Za pomocą wbudowanego serwera internetowego Hugo można wdrożyć witrynę, która może natychmiast wyświetlać zmiany na stronie internetowej, gdy tylko zmienisz treść w edytorze tekstu.

Otwórz inny terminal, skonfiguruj iptablesreguły, aby zezwolić na dostęp do Twojej witryny na domyślnym porcie 1313 serwera Hugo:

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

Uruchom serwer Hugo:

hugo server --bind="[YourServerIP]"

Wejdź na swoją stronę w przeglądarce:

http://[YourServerIP]:1313

Teraz możesz spróbować edytować zawartość pliku strony w poprzednim terminalu lub dodać / usunąć plik strony. Przekonasz się, że wszelkie modyfikacje w content/katalogu będą widoczne jednocześnie na ekranie przeglądarki. Jest to świetna funkcja dla zapracowanego blogera, ponieważ zawsze możesz od razu zobaczyć swoje modyfikacje w celu lepszego komponowania.

Po zakończeniu edycji naciśnij, Ctrl+Caby zatrzymać serwer Hugo.

Krok 7: Opublikuj swoją witrynę

Teraz nadszedł czas, aby opublikować swoją witrynę w Internecie. Uruchom następujące polecenia, a Hugo wygeneruje całą zawartość statyczną odpowiednią do opublikowania w public/katalogu.

cd ~/mysite
hugo

Uwaga : Hugo nie usunie starych plików, które zostały wcześniej wygenerowane po uruchomieniu powyższych poleceń. Aby uniknąć nieoczekiwanych wyników, zawsze możesz usunąć public/katalog przed uruchomieniem hugopolecenia lub określić nowe miejsce docelowe wyjścia, jak pokazano w poniższym poleceniu.

hugo --destination=public2

Ponieważ serwer WWW Nginx już działa na serwerze, wystarczy skopiować zawartość ~/mysite/public/katalogu lub innych niestandardowych katalogów docelowych do katalogu internetowego /usr/share/nginx/html/.

Usuń oryginalne pliki:

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

Skopiuj pliki strony statycznej do katalogu internetowego:

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

Otóż ​​to. Teraz możesz odwiedzić swój super szybki statycznej strony z przeglądarki: http://[YourServerIP].

Aby zobaczyć więcej szczegółów, użyj polecenia hugo helplub odwiedź oficjalną stronę Hugo .