Golang application ━ installation, configuration and use of Hugo blog system

First make complaints about it , Several articles about the five elements and eight trigrams were csdn Prompt violation of national laws ... We can only consider self construction blog, Can't be tied .
Coincidentally, I have always wanted to set up a local markdown System , After all md It's always the first thing to do locally .
current hugo It's good to try , Send a document to record the installation process .

Manually download the whole process , no need git

hugo Official website

One 、 Prepare execution file hugo.exe

1. Binary system
   Get ready-made directly ~~
   Execution file download website ：https://github.com/gohugoio/hugo/releases

2. Source code generation
   Source download website ：https://github.com/gohugoio/hugo
   Unzip all , Use command go build, There is no need for more nonsense ... ha-ha .
   Be careful , If I remind you build no , Please check your go Is the version the latest , Used in writing this article go 1.18.3, If it is go 1.17.x Version cannot be generated normally .

Two 、 Generate blogTest project

take hugo.exe Place on D:/test/hugo In the table of contents , Use cmd command

hugo new site blogTest

Generate... After execution D:/test/hugo/blogTest Catalog , This directory is the current blogTest The root directory of the project , And then put hugo.exe Move to the real root directory , Later orders need him .

3、 ... and 、 Installation template testTpl

Official template download address ：https://themes.gohugo.io/

Suppose you download the template testTpl, Download and unzip to D:/test/hugo/blogTest/themes/testTpl in .

Four 、 Create articles first.md and about.md

stay D:/test/hugo In the table of contents , Use cmd command

hugo new first.md
hugo new posts/about.md

The directory and md file ：
D:/test/hugo/blogTest/content/first.md
D:/test/hugo/blogTest/content/posts/about.md.

about.md The contents of the document are as follows ：

---
title: "About"
date: 2022-06-26T16:15:50+08:00
draft: true
---

Pay attention to this draft: true, It means this article is a draft , Later in the article .

In the end --- Write a sentence below ## ok , Test it ,markdown I don't speak much language .

5、 ... and 、 Self built server

stay D:/test/hugo In the table of contents , Use cmd command

hugo server --theme=testTpl --buildDrafts --watch

1. theme： What template to use ;
2. buildDrafts: Show the draft as well ;
3. watch: Any article modification will be refreshed in real time ;

go server The command will automatically enable the built-in web server, It is used in the native browser by default http://127.0.0.1:1313 open , Please pay attention to the result prompt of the terminal for the specific port number .

6、 ... and 、 Generating static files

stay D:/test/hugo In the table of contents , Use cmd command

1. Normal mode

hugo

2. Draft also generates patterns （-B yes --buildDrafts Abbreviation ）

hugo -B

3. Various command modes

hugo --theme=testTpl --buildDrafts

The generated static files are in D:/test/hugo/blogTest/public, Including articles 、 style 、 Multimedia files, etc .

At this time will be public All files in the directory can be uploaded to the hosting server for external use .

7、 ... and 、 The configuration file

There are two key configurations , If these two places are not configured , The generated static file cannot be displayed or used normally ：

1. The system configuration
   stay D:/test/hugo/blogTest/config.toml Content modification baseURL And new theme.
   baseURL For the project at web server Root directory on （ You can add a domain name or not , But you need to conform to the rules of absolute and relative directories ）.
   content It is the local directory where the article is located , You can store the original article separately ,hugo The system belongs to another directory .
   theme Is the name of the template used .
   uglyURLs Use the title name as the file name or as the directory name , The default is false, If it is used locally , It is recommended to use true

baseURL = 'http://127.0.0.1/hugo/blogTest/public/'
contentdir = "c:/blog/test"
languageCode = 'en-us'
title = 'My New Hugo Site'
theme = "testTpl"
uglyURLs = true

2. Article configuration
   take D:/test/hugo/blogTest/content/posts/about.md In the article draft: true Change it to draft: false, Otherwise, direct use hugo If you order , Drafts do not generate static files , It will not appear in the list of articles ,go server The same is true for orders .
   This case first.md and about.md There is only... In the document about.md Non draft , namely draft: false, So use hugo Command to generate a static file directly , There will be a homepage with only one article .
   

8、 ... and 、 Start blogging

If you use Obsidian Blogging , So that the accessories can be used normally , The recommended setting is shown in the figure , The key is Insert a relative path based on the current note .

The details of the obsidian Usage method ：《obsidian coordination hugo Use , Give Way markdown Local editing software and online seamless connection 》

Again, I strongly recommend ： In actual use, try to store the original blog in other directories ,hugo In another directory .
stay hugo Of config.toml Set in contentdir Directory to read the original blog .

Reference resources ：
Hugo Get started quickly
The world's fastest static blog generation tool Hugo Getting started tossing
Enable Ugly URL
To configure Hugo