基于hexo和github pages搭建个人博客

基于hexo和GitHub pages搭建个人博客

成品展示

使用工具:

  • git
  • github
  • hexo
  • vscode( 任意具备markdown编辑能力的工具均可)

git安装

git官网下载
选择电脑对应版本安装即可(一般为64位)

node、npm安装

node.js官网

当然,你也可以直接用winget安装,省的去官网下载

关于winget的使用,可以看完另一篇博客:winget的基础配置与使用

winget install Git.Git
winget install OpenJS.NodeJS.LTS

hexo创建个人博客

安装hexo

1.在任意目录下新建hexo文件夹

  • 打开该文件夹,空白处单击鼠标右键:Git Bash Here
  • 在打开的git bash 窗口中依次输入以下命令:
npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

全部执行完成后,hexo目录下会出现一个新的blog文件夹,里面就是存放博客的地方

  • 然后输入这两条命令
hexo g
hexo s

完成后若显示诸如http://localhost:4000的内容,则说明配置成功。
打开浏览器,地址栏输入上面的地址,即可进入初始博客的预览界面,它长这样:

为什么说是预览界面呢,因为她现在仅仅只是部署在你电脑本地的一个离线版本,只能在你自己的电脑上看见,想要正式发布公开,你需要一台拥有公网IP的服务器,但还有一个更简单的方法,即借助GitHub page的ssh功能实现对外访问。

GitHub创建仓库

  • 首先创建一个GitHub账号,然后在个人主页新建仓库,仓库名为username.github.io,username即你的用户名。
  • 回到gitbash窗口,按Ctrl+C 关闭4000端口的预览,输入以下命令:
git config --global user.name "yourname"    # yourname改为GitHub用户名
git config --global user.email "youremail"  #youremail改为注册GitHub所用的邮箱
ssh-keygen -t rsa -C "youremail"            #创建ssh连接
  • 之后会提示你已经完成ssh创建,接着找到该路径下的这两个文件:

把id_rsa.pub里的内容复制下来,打开GitHub的设置界面(点击头像-setting),找到SSH and GPG keys,x新建一个ssh key,粘贴进key中,title随便填一个就行,保存。

hexo部署到GitHub

  • 在blog文件夹下找到_config.yml,这是博客的配置文件,在这里可以修改博客的一些基本信息,打开它,找到下面这段内容,在最底下:
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: ''

修改deploy部分:

deploy:
  type: git
  repo: https://github.com/username/username.github.io.git   #username改为用户名
  branch: master
  • 另外找到第十六行,修改url为 https://username.github.io

  • 完成后保存文件并退出,在gitbash中输入:npm install hexo-deployer-git --save,安装git部署工具。

  • 最后输入以下三行命令:

hexo clean           #清除缓存
hexo g               #生产静态文章(博客)
hexo d               #部署
  • 当然,如果仅是在本地查看效果,第三行命令也可以换成hexo s
    部署过程中可能会出现warning警告,但不要紧,只要最后呈现这样的内容,就表示成功了:

    之后,你就可以 username.github.io访问到你的博客了,且可以被任何人访问到。

常用命令

在根目录打开gitbash:

hexo new "博客名称"  #新建博客
hexo clean          #清除缓存和静态文件
hexo g              #生产静态文件
hexo s              #生成离线版本
hexo d              #部署

添加插件

主题

我使用的是next,一款简洁美观的主题,功能强大,可拓展性强,在gitbash中下载:
git clone https://github.com/next-theme/hexo-theme-next themes/next
下载完成后,在blog下找到themes文件夹-next,打开主题的_config.yml文件,找到如下部分,大概在100行左右:

# Schemes
#scheme: Muse
#scheme: Mist
#scheme: Pisces
#scheme: Gemini

这代表了四种不同风格的next主题,任选一个取消注释即可。
之后回到根目录的_config.yml文件,找到theme选项,输入next

博客基本信息

在blog下找到_config.yml并打开,配置站点信息

注意,语言要改成中文:zh-CN,其他的可以按个人喜好更改。

END

25 个赞

前排围观 ~

我用的是 hugo

1 个赞

分区改一改,这不是问答,是分享。

快问快答软件分享

很详细的教程!

感谢分享

马克收藏,感谢分享

很不戳,非常详细,搭完还赠送900天历史。。。
哦,原来就是900天前搭的

感谢分享

刚从hexo迁出

好强!

Mark下

还是习惯Hugo整博客,hexo国人的主题更多就是了

大佬,请问这个方法还是需要自己本地有服务器的嘛?

不需要

我只能说快换hugo, 预览快一万倍. 三年前就迁移了

最后有域名的话可以用vercel+自定义域名,暂时还能访问.

谢谢坛佬

感谢楼主,我已经根据您的教程成功部署了个人网站。

用rsa多此一举。

现在是可以点一点登录了,以前可没有。
而且如果把源仓库也推送上去,玩自动部署,还不是要传公钥。