在Windows上使用Hugo搭建博客

1,538 阅读2分钟

本文已参与「新人创作礼」活动,一起开启掘金创作之路。

在win11下搭建hugo博客环境

Hugo 简介

hugo 中文网

hugo的仓库地址

Hugo 是一个基于Go 语言的框架,可以快速方便的搭建自己的博客。

Hugo 支持Markdown 语法,可以将自己的文章写成Markdown 的格式,放在用Hugo 搭建的博客系统中,从而展示给他人。

下载安装hugo

下载地址

01-hugo下载.png

  1. 下载好hugo的Windows安装包,注意要下载hugo的扩展包,因为要转换scss。

  2. 将其解压出来,会得到一个后缀为.exe的可执行文件,不要直接双击去运行(因为它根本运行不了)。

  3. 将这个解压好的hugo.exe文件放在D:\hugo\bin目录下。

    注意:hugo.exe必须放在一个名为bin的文件夹下面,至于bin文件夹位置都可以。

  4. 配置环境变量,找到系统变量里的path选项,添加hugo.exe所在的目录,也就是D:\hugo\bin

  5. 打开终端,输入hugo version,查看是否有版本号输出,有版本输出就表示安装成功。

02-查看hugo版本.png

注意:如果正确配置环境变量后,打开终端,输入hugo version,报错:hugo : 无法将“hugo”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。可以重启电脑尝试解决。

使用hugo搭建博客

hugo new site myBlog

03-新建博客.png

下载主题库并设置

主题库官网

切换到主题目录themes,下载主题:

04-下载主题.png

在本地启动博客

回退到博客根目录,启动博客

hugo server -t hugo-theme-stack --buildDrafts
​
// -t 指定主题类型

05-启动博客.png

注意:Ctrl+C 可以停止服务。

在本地访问博客

在浏览器地址栏输入:http://localhost:1313/

06-本地访问博客.png

新建一篇文章

hugo new post/blog.md

07-新建文章.png

将博客部署到远端服务器

hugo --theme=hugo-theme-stack --baseUrl="https://jiyaning.github.io" --buildDrafts

08-部署到git仓库.png

会生成一个public文件夹。

需要把public文件夹里的内容同步到git远程仓库:

git init
​
git add .
​
git commit -m "基于hogo搭建的博客初始化"
​
git remote add origin https://github.com/jiyaning/jiyaning.github.io.git
​
git push -u origin master