加载头像

关于此站

基于hexo+github+butterfly的个人博客网站

依赖项目

  • 本站采用hexo框架

    hexo 是一款快速、简洁且高效的博客框架。Hexo

  • 本站采用github托管,没有后端服务器

  • 本站采用基于butterflyanzhiyu主题

  • 本站评论服务基于valine,是一个无后端的评论服务

  • 本站数据统记基于51a,是一款先进的网站数据统计服务

  • 本站实时聊天基于Chatra,是一款免费的实时聊天服务

搭建指南(踩坑记)

Hexo是一款基于Node.js的静态博客框架,依赖少易于安装使用,可以方便的生成静态网页托管在GitHubHexo官方网站。因为Hexo的创建者是台湾人,对中文的支持很友好,可以选择中文进行查看。

安装Git

廖雪峰老师的Git教程写的非常好,大家可以了解一下。Git教程

windows:到git官网上下载,Download git,下载后会有一个Git Bash的命令行工具,以后就用这个工具来使用git。

安装好后,用git --version 来查看一下版本

安装node.js

参考这篇博文2024最新版Node.js下载安装及环境配置教程【保姆级】_nodejs下载-CSDN博客

注意,本人踩的坑:

安装hexo

前面gitnodejs安装好后,就可以安装hexo了,你可以先创建一个文件夹blog(建议装到D盘哦,记住位置!),然后通过cmd窗口cd到这个文件夹下(或者在这个文件夹下直接右键git bash打开)

输入命令

npm install -g hexo-cli

依旧用hexo -v查看一下版本

至此就全部安装完了。

接下来初始化一下hexo

hexo init myblog
  • node_modules:依赖包,注意,你装的所有插件都在这里
  • public:存放生成的页面
  • source:源码,用于生成public文件
  • themes:主题
  • _config.yml:博客的配置文件

然后再你的myblog目录里运行

hexo generate
hexo server

然后会出现一个链接,crtl+鼠标左键点击就可以进去

这个链接只是预览,仅仅在本地访问有用,用的是你自己的电脑做的服务器。

GitHub创建个人仓库

登录后,在GitHub.com中看到一个New repository,新建仓库

创建一个和你用户名相同的仓库,后面加.github.io,只有这样,将来要部署到GitHub page的时候,才会被识别,也就是xxxx.github.io,其中xxx就是你注册GitHub的用户名。一定要注意必须是这样才可以被识别

生成SSH添加到GitHub

回到你的git bash(myblog根目录)中,

git config --global user.name "yourname"
git config --global user.email "youremail"

这里的yourname输入你的GitHub用户名,youremail输入你GitHub的邮箱。这样GitHub才能知道你是不是对应它的账户。

可以用以下两条,检查一下你有没有输对

git config user.name
git config user.email

然后创建SSH,一路回车

ssh-keygen -t rsa -C "youremail"

这个时候它会告诉你已经生成了.ssh的文件夹。在你的电脑中找到这个文件夹。

ssh,简单来讲,就是一个秘钥,其中,id_rsa是你这台电脑的私人秘钥,不能给别人看的,id_rsa.pub是公共秘钥,可以随便给别人看。把这个公钥放在GitHub上,这样当你链接GitHub自己的账户时,它就会根据公钥匹配你的私钥,当能够相互匹配时,才能够顺利的通过git上传你的文件到GitHub上。

而后在GitHubsetting中,找到SSH keys的设置选项,点击New SSH key
把你的id_rsa.pub里面的信息复制进去。

gitbash中,查看是否成功

ssh -T git@github.com

hexo部署到GitHub

这一步,我们就可以将hexo和GitHub关联起来,也就是将hexo生成的文章部署到GitHub上,打开站点配置文件 _config.yml,翻到最后,修改为
YourgithubName就是你的GitHub账户

deploy:
type: git
repo: https://github.com/YourgithubName/YourgithubName.github.io.git
branch: master

这个时候需要先安装deploy-git ,也就是部署的命令,这样你才能用命令部署到GitHub

npm install hexo-deployer-git --save

然后

hexo clean
hexo generate
hexo deploy

hexo clean是清除你之前生成的东西(也就是public文件夹),建议加上

hexo generate是生成新的public,可以用hexo g但在主题配置中和其他命令冲突,建议用hexo generate

hexo deploy就是把public推到网页上。可以用hexo d缩写

注意:这只是创建网页,在之后要推送文章时,要在hexo d使用hexo server预览,看看和自己写的一样不一样,不一样再hexo clean后重新写,一样后,在cmd窗口中,crtl+c停止运行hexo server后再运行hexo d

注意deploy时可能要你输入username和password。

部署成功后,过一会儿就可以在http://yourname.github.io 这个网站看到你的博客了!!

至于安装主题

我用的是安知鱼主题,详细参考这个博文主题安装 | 安知鱼主题官方文档 (anheyu.com)

主题配置不简单,建议仔细阅读文章后操作

参考博文

hexo史上最全搭建教程-CSDN博客

Hexo

零成本搭建一款博客网站(基于Vercel+Hexo完美实现)【保姆级教程】_vercel博客-CSDN博客

Front-matter | Hexo

hexo 博客插入本地图片时遇到的坑_hexo-asset-img-CSDN博客(注意把存放md文档的图片的文件夹设置成和md文档同名)

特别鸣谢

Arthals’ ink - 所见高山远木,阔云流风;所幸岁月盈余,了无拘束。(卓佬,我永远的神!)

本站耗费五天时间,踩了无数的坑才搭建完成,本站除去域名是零花费,适合想搭建个人博客网站而且预算不高的同学(其实域名三年我也才花了79软妹币)。

一款无后端的静态hexo个人博客网站,你值得拥有!


avatar
status
大家好鸭,我是北京大学计算机专业的一名学生,本站会分享本人课程学习的笔记和感悟以及生活,希望对大家有所帮助。
公告
欢迎来看我的博客鸭~这里有中国区加速地址:https://www.cjw-cs-pku.fun/


网站资讯
文章总数 :
7
建站天数 :
总访客数 :
总访问量 :
引用到评论
随便逛逛博客分类文章标签
复制地址关闭热评深色模式轉為繁體