Reardon

基于Hugo和Github搭建个人网站

注意:以下教程仅适用于在Windows系统下,基于Hugo及Github,搭建个人网站。

第一步,安装并配置Hugo

1.下载Hugo

下载最新版Hugo:点击下载

2.建立目录

下载好后,解压。在D盘建立Hugo文件夹,并把解压后出现的hugo.exe文件放在bin目录下。

3.配置环境变量–>系统变量

下载完成后,需要配置path,按下键盘组合键Win+S键,输入path,点击“编辑系统环境变量”,此时弹出“系统属性弹窗”,点击弹窗右下角“环境变量”,出现“环境变量弹窗”,在下方“系统变量(S)”弹窗,双击“Path”这一行,此时出现“编辑环境变量”弹窗,点击“新建”按钮,将前面hugo.exe的路径(形如:D:\Hugo\bin)粘贴进去。然后依次点击“确认”按钮,共点击三次。

4.验证

验证是否安装并配置成功,按下键盘组合键Win+R键,出现“运行”弹窗,在弹窗中输入“CMD”,点击确认,出现“命令提示符”窗口,输入D:,按下回车键,然后输入cd hugo/bin,然后输入hugo version,出现类似:hugo v0.110.0-e32a493b7000000763c3b79623952e6254000000+extended windows/amd64 BuildDate=2023-01-17T12:16:09Z VendorInfo=gohugoio的信息,即代表安装成功。

至此,完成安装并配置Hugo。

第二步,安装Visual Studio Code

下载最新版Visual Studio Code:点击下载

下载完成后,直接双击安装。建议安装在D盘,一路点击确认和下一步,选择默认配置即可。

至此,完成安装并配置Visual Studio Code.

第三步,安装并配置Git

1.下载Git

下载最新版Git:点击下载

下载完成后,直接双击安装。建议安装在D盘,一路点击确认和下一步,选择默认配置即可。

2.配置Git

在以上步骤出现的“命令提示符”窗口,输入git config --global user.name "Jack",(请将“Jack”替换为自己的用户名)然后按下回车键。

再输入git config --global user.email "Jack@gmail.com",(请将“Jack@gmail.com”替换为自己的邮箱地址)然后按下回车键。

至此,完成安装并配置Git.

第四步,网站初始化及配置模板

1.网站初始化

这里我们以在D盘创建个人网站仓库文件夹为例,在“命令提示符”窗口,输入D:,按下回车键,然后输入hugo new site jack.com,(请将“jack.com”替换为自己想要命名的仓库名称,建议使用英文),然后按下回车键。

出现类似以下文字,即代表网站初始化成功。

Congratulations! Your new Hugo site is created in D:\jack.com.

Just a few more steps and you're ready to go:

1. Download a theme into the same-named folder. Choose a theme from https://themes.gohugo.io/ or create your own with the "hugo new theme <THEMENAME>" command.

2. Perhaps you want to add some content. You can add single files with "hugo new <SECTIONNAME>\<FILENAME>.<FORMAT>".

3. Start the built-in live server via "hugo server".

Visit https://gohugo.io/ for quickstart guide and full documentation.

进入D盘,打开jack.com.文件夹,共可看到7个文件夹和一个文件,这些文件分别代表:

2.配置模板

这里以本站使用的hugo-bearblog模板为例,其他更多Hugo模板可点击这里下载

点击预览本站模板

点击下载本站模板,如果下载链接失效,请点击这里进行下载。

下载完成后,解压,获取hugo-bearblog-master文件夹。将hugo-bearblog-master文件夹直接拷贝到上一步D盘中生成的jack.com/themes目录下,将拷贝过来的hugo-bearblog-master文件夹重新命名为hugo-bearblog(即去掉master,这一步一定要做,不然后续可能无法识别到对应模板)

然后进入hugo-bearblog目录下exampleSite文件夹,直接将exampleSite文件夹下面的contentstaticconfig.toml的三个文件直接复制到D盘jack.com目录下,注意,此时会提示“替换或跳过文件”弹窗,选择“替换目标中的文件”,非常推荐这么做,这样做能解决很多问题。

3.验证是否成功安装模板

在“命令提示符”窗口,输入D:,按下回车键,然后输入cd jack.com

然后输入hugo server,会出现类似以下的文字。

Start building sites …

hugo v0.110.0-e32a493b7826d02763c3b79623952e625402b168+extended windows/amd64 BuildDate=2023-01-17T12:16:09Z VendorInfo=gohugoio

…………………………………………

Built in 38 ms

Watching for changes in D:\reardon.com\{archetypes,assets,content,data,layouts,static,themes}

Watching for config changes in D:\reardon.com\config.toml

Environment: "development"

Serving pages from memory

Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender

Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)

成功出现以上文字后,在浏览器输入http://localhost:1313/,即可打开模板网站实例页面。

至此,完成网站初始化及配置模板。

第五步,使用Visual Studio Code定制网站信息,书写网站内容

现在我们要用到前面安装的Visual Studio Code,非常推荐直接用Visual Studio Code来书写内容及调整模板参数。

双击打开Visual Studio Code,会出现配置界面,选择默认即可。

点击右上角文件按钮,点击“打开文件夹”,然后选择D盘中的jack.com文件夹,然后点击“选择文件夹”,即可对实例页面进行修改,以及新增页面了。

接下来,即可根据自己的需求,定制网站信息,并且书写自己的网站内容啦。

点击这里,参考模板说明信息。

点击这里,参考Hugo官方帮助手册。

第六步,将建设完成的站点部署至Github

1.创建Github仓库

注册Github账户,注册完成后。点击右上角个人头像旁边的“+”号,点击New repository.

在打开的页面中,填写仓库名称。

Description这一栏可填写相关描述。

勾选Public,设置为公开仓库。(系统默认已经勾选,不用更改)

勾选Add a README file。这会设置main分支为仓库的默认主分支,这在后面提交推送网站内容时很重要。

3.在本地完成git初始化,并与Github仓库完成连接

完成以上步骤后,现在我们在在“命令提示符”窗口,输入D:,按下回车键,然后输入cd jack.com,按下回车键,再输入cd public,进入public文件夹。

然后再输入git init,完成本地仓库初始化。

然后再输入git remote add origin https://github.com/ReardonYang/ReardonYang.github.io.git,这一步后,我提示我们输入Github账号和密码。

完成以上步骤后,建议从Github仓库同步一次数据。输入git pull origin master.

4.在本地生成网站页面文件并同步至Github仓库

在“命令提示符”窗口,输入D:,按下回车键,然后输入cd jack.com,按下回车键。再输入hugo,按下回车键。此时,在public文件夹下会生成页面文件,这些生成的文件,就是我们要上传到Github仓库的文件。(以后每次更新完网站,都建议删除这些public目录下生成的页面,然后按此步骤重新生成页面后上传)

以上完成后,在“命令提示符”窗口,输入git add .,然后输入git commit -m "在此处添加文件上传备注信息"

最后,输入git push -u origin master,将文件同步至Github仓库。

第七步,完成

至此,完成所有操作。

在Github上打开你所创建的仓库,进入Setting界面,然后在页面左侧点击Pages,即可找到所搭建网站的地址链接信息。点击该地址链接,即可进行访问。

常用命令:

初始化git init

链接本地仓库与Githubgit remote add origin https://github.com/ReardonYang/ReardonYang.github.io.git

获取Github仓库文件git pull origin master

将更新信息进行确认git add .

添加备注信息git commit -m "在此处添加文件上传备注信息"

将文件同步至Github仓库git push -u origin master

#工具应用