Welcome

A blog by moplord

欢迎来到我的博客一起分享学习

1-Minute Read

1. 安装Hugo

Hugo官网提供了不同系统的安装方法,直接安装即可,本人用的Ubuntu20.04LTS,运用的brew

,apt与snap也可以安装。官方安装教程:https://gohugo.io/getting-started/installing

输入hugo version验证是否安装成功

windows:下载下来,放到某个文件夹下,例如我放到了D:\hugo\bin下,那么在环境变量下,系统变量里的Path中填写该地址即可。


2. 创建一个站点

首先cd到你要创建站点的目录下(否则会在桌面等默认初始位置创建),然后执行命令

hogo new site blog

其中blog为你要创建的名称,可以更改。


3. 有关github与git的设置

首先进入github官网https://github.com 注册github,创建一个新的repository,Repository name内填写moplord.github.io 其中moplord是我的github用户名小写,此处填写你自己的github用户名(未测试填写其他内容)。https://moplord.github.io/将作为访问博客的网址。

返回自己现在使用的电脑安装好git,进入git bash输入(本人ubuntu在命令行界面直接输入的):

ssh-keygen -t rsa -C "[email protected]"   //引号内邮箱是github注册邮箱,未尝试输入其他邮箱

遇到啥询问回车即可,找到.ssh文件夹,本人的在/home/gong/.ssh

返回github,点右上角头像,Settings,左边列表的SSH and GPG keys,点击New SSH key,Title自行填写,Key在.ssh文件下id_rsa.pub里,注意不要用id_rsa,把所有内容复制到Key里,进行添加。

然后返回现在用的主机,输入

ssh -T [email protected]   //无需更改@前面的内容,这不是自己的邮箱

遇到询问输入yes,出现含successfully字样的语句则代表成功,继续输入

git config --global user.name  "你的github用户名"   //未尝试过输入自定义名字
git config --global user.email "你的github注册邮箱"  //未尝试过输入其他邮箱
git remote add origin [email protected]:moplord/moplord.github.io                     //其中moplord/moplord.github.io是刚刚用github建立的repository,/之前为github用户名,/之后是repository名称

4. 选择主题

cd到网站文件夹内,里面有一个名为themes的文件夹对应的是主题,cd进入到themes,在hugo主题网站挑选自己喜欢的主题https://themes.gohugo.io/,本人选择的是hugo-future-imperfect-slim,这是他的github地址https://github.com/pacollins/hugo-future-imperfect-slim/,有可以看的demo以及设置方法等,本人用git方法安装的主题,在themes文件夹下输入

git init  //初始化
git submodule add https://github.com/pacollins/hugo-future-imperfect-slim.git
//安装主题,此主题自行选择,不一定用我这个

5. 设置

返回上一层,即网站主目录,有一个config.toml文件,这个是用来设置的,本人选择的主题在themes/hugo-future-imperfect-slim/exampleSite里是个范例网站,可以借用参考里面的设置,我把此处的设置文档复制替换放到主目录下,在此基础上进行修改,其中

baseurl = "https://moplord.github.io/"  //此处填写将要访问的网址,moplord.github.io改为自己设置的repository名称
theme  = "hugo-future-imperfect-slim"  //此处填写自己下载的主题名称

其他各种参数可到主题的wiki中查看修改,本主题wiki地址为https://github.com/pacollins/hugo-future-imperfect-slim/wiki/config.toml

blog,about等内容需要在content文件夹下创建单独文件夹,并把内容放在里面,参考themes/hugo-future-imperfect-slim/exampleSite里的样式即可。在网站主目录输入

hugo new post/test.md

可创建博客文档,在content的post下,test.md为要编写的文件,本人用Typora编写。本主题要同时在blog与post里同时放博客,才可以在主页面与博客栏同时显示文章。发布时draft改为false。

2022-04-19补充:该主题的样例网站已无法访问,new post生成的博客文档与主题要求的格式不符合,需要参照example里的格式。


6. 本地调试

在网站根目录下输入

hugo server --buildDrafts

可以创建一个可以本地访问的测试网站 http://localhost:1313


7.部署到github

cd进入到主目录下的public文件夹,然后输入

git init  //初始化
git remote add origin [email protected]:moplord/moplord.github.io.git  //冒号后面写自己的
git add -A
git commit -m "test"
git push -u origin master

每次写完博客,放到指定位置后,需要在网站主目录执行命令

hugo

然后cd进入到public,执行

git add .
git commit -m "备注信息"
git push origin master

即可更新到github


2021/11/27补充:

如何部署到服务器上

安装nginx

本人服务器用的ubuntu,直接输入

sudo apt install nginx

部署ssl证书

本人运用的dnspod购买的域名,dnspod提供trust asia的免费1年证书,申请即可。点击查看腾讯云官方提供如何部署。下载好证书后,解压缩,把压缩包里的nginx下的两个文件拷贝到/etc/nginx下(win scp即可,可能会有变动),注意权限。在/etc/nginx/conf.d下进行配置文件,参考官方提供。随后在DNSPOD添加记录,本人用*,A记录,记录值是服务器IP地址。


nginx常用命令:

查看配置文件语法:
sudo nginx -t

停止nginx
sudo nginx -s stop

启动nginx
sudo systemctl start nginx

开机自启动
sudo systemctl enable nginx

重启nginx
sudo systemctl restart nginx

生成hugo静态页面

运用以下命令生成一个public的文件夹,用于部署

hugo --baseUrl="/"

部署到服务器上

上传到服务器,并在nginx配置文件location下的root后面填写public文件夹的地址,验证配置文件,重启nginx即可使用。

Recent Posts

CSS3

Categories

About

没有名字的博客