利用Hugo与GitHub仓库搭建免费的个人博客

保姆级
基于Win10环境下的Hugo免费博客搭建

软件下载

• Hugo下载地址：Hugo
• git下载地址：git，建议先注册GitHub账号。
• 推荐编辑器vs code，下载地址：vs code

配置环境变量

hugo安装完毕后在hugo.exe文件夹中，新建bin文件夹，将hugo.exe放入bin文件夹中

1. 鼠标右键此电脑，点击属性
   

2. 点击高级系统设置
   

3. 点击环境变量
   

4. 在系统变量中找到path双击进入
   

5. 确保hugo.exe文件在bin目录下找到安装的hugo的bin文件路径进行复制(git的环境变量配置相同)
   

6. 在path中点击新建并粘贴；退出时切记点击确定，否则不会保存环境变量。
   

检验环境变量

win+r输入cmd打开命令行

在命令行输入hugo version；git version分别查看环境变量是否添加成功，若打印版本号即配置成功，提示error则失败

hugo version
git version

创建博客文件

跳转到下载hugo的文件夹下；在windows命令行中用磁盘名冒号跳转到对应磁盘，进入文件夹用cd命令

比如我的hugo文件夹在f盘就输入命令 f： 再输入cd 文件夹名称进入目录

f:
cd myblog\hugo_extended_0.55.6_Windows-64bit

创建站点文件夹

hugo new site myblog

cd myblog\themes

下载主题

选择喜欢的主题下载，官方主题地址：theme

任意选一个主题，点击Download跳转到该主题的github页面,点击clone or download

若下载好git可以用命令行克隆（一定要去安装配置好git），复制主题地址进行克隆

在命令行中确保在themes路径下输入git clone (粘贴主题地址),我这里随意选择了一个主题进行下载

git clone https://github.com/darshanbaral/aafu.git

若还未下载git，点击download ZIP下载压缩包解压到themes文件夹下同时必须重命名删除-master，且一定不要有最外层同名文件夹，使用克隆下载不需要这些步骤

主题下载完成后可以打开themes文件夹->进入主题文件->打开exampleSite文件夹->复制
exampleSite文件夹下的所有文件->返回myblog文件夹粘贴并替换相应文件

config.toml是网页的配置文件，可根据需要进行配置，相关操作可参考主题下载页面下的文档。

返回上一级目录输入命令：cd ..

cd ..

本地启动博客，在命令行中输入：hugo server -t 主题文件夹名 –buildDrafts (我这里用我下载的主题名举例)

hugo server -t aafu

复制地址，在浏览器中便可进行访问了

进入页面此时什么也没有，我们回到终端命令行按CTRL+c退出

新建博客

hugo new post\firstblog.md

输入命令后返终端返回了新建博客的位置在content/post/fistblog.md路径下

推荐使用vs code编辑markdown文件，在myblog文件夹下空白处单击右键选择以vs code方式打开

博客为markdown文本格式，使用十分简单方便，网上文档十分多，这里便不再赘述

在vs code中使用CTRL+ ~ 便可打开终端

输入hugo server命令启动博客，本地查看刚才新建的博客内容

hugo server

将个人博客部署到github存储仓库

在你的github页面点击new
新建一个存储仓库,仓库名称必须是小写且和github用户名相同

命名格式为your_name.github.io ，随后点击create repository即可创建空仓库，我这里已经创建过，因此有警告标志

在终端输入以下命令，

hugo --theme=aafu --baseUrl="https://your_name.github.io"

生成public文件，现在要将public文件夹传到github上

cd public
git init
git add .
git commit -m "first commit"
git remote add origin https://github.com/your_name/your_name.github.io.git
# 注意将命令中的your_name改成你自己的github用户名
git push -u origin master

到此个人博客就部署成功了，在浏览器中输入your_name.github.io即可访问。

标签：git,GitHub,Hugo,博客,github,文件夹,hugo,下载,搭建
来源： https://www.cnblogs.com/left23333/p/16349938.html