Πώς να δημιουργήσετε ένα ιστολόγιο με τον Hugo

Εισαγωγή

Το Hugo είναι μια γεννήτρια στατικών τοποθεσιών με αστραπιαία ταχύτητα απόδοσης και εξαιρετική ευκολία στη χρήση. Χάρη σε όλες τις προσανατολισμένες στο περιεχόμενο χαρακτηριστικά του, μπορείτε πάντα να εστιάσετε στη δημιουργία περιεχομένου αντί στη δημιουργία του περιβάλλοντος:

• Με το Hugo, μπορείτε να δημιουργήσετε μια στατική τοποθεσία που τρέχει οπουδήποτε σε λίγα λεπτά χωρίς να ανησυχείτε για κουραστικές εξαρτήσεις ή βάσεις δεδομένων.
• Μπορείτε να συνθέσετε το περιεχόμενό σας στο Markdown, το πιο βολικό στυλ γραφής, και να δείτε αμέσως τις αλλαγές που έχετε κάνει στον Ιστό.
• Επιπλέον, μπορείτε να αξιοποιήσετε στο έπακρο το πλούσιο αποθετήριο θεμάτων και την ταχέως αναπτυσσόμενη κοινότητα του Hugo.

Σε αυτό το σεμινάριο, θα σας δείξω πώς να εγκαταστήσετε και να χρησιμοποιήσετε το Hugo για να δημιουργήσετε έναν στατικό ιστότοπο ιστολογίου σε μια παρουσία διακομιστή Vultr LEMP που βασίζεται σε CentOS.

Προαπαιτούμενα

Συνδεθείτε στην παρουσία σας ως χρήστης χωρίς root με δικαιώματα sudo. Δείτε πώς μπορείτε να δημιουργήσετε έναν τέτοιο χρήστη σε αυτό το άρθρο .

Βήμα 1: Εγκαταστήστε το πρόγραμμα Hugo

Το Hugo μπορεί να εγκατασταθεί σχεδόν σε όλες τις mainstream πλατφόρμες. Για το 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/κατάλογο θα αντικατοπτρίζονται ταυτόχρονα στην οθόνη του προγράμματος περιήγησής σας. Αυτή είναι μια εξαιρετική δυνατότητα για έναν πολυάσχολο blogger, επειδή μπορείτε πάντα να δείτε αμέσως τις τροποποιήσεις σας για καλύτερες εμπειρίες σύνθεσης.

Αφού ολοκληρώσετε την επεξεργασία σας, πατήστε 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 .