Hexo+GitHub博客搭建教程

本文讲述的Hexo博客搭建主要是配合GitHub来进行部署,不需要购买任何服务器。

搭建大致分为三个流程:准备工作、安装Hexo以及部署在GitHub,下面介绍详细流程。

image-20211114222835670


一:准备工作

1、下载Node.js,并进行安装(详见注意事项

a.选择windows安装包.msi下载

b.安装过程默认C盘,中间切记要选择Add to PATH,然后点Next继续

2、下载Git,并进行安装

可自行选择安装路径,后面的安装步骤只要全部点击Next即可,无需自行配置

3、下载Cmder,并进行安装,后文所涉及到命令均是在Cmder里面进行运行

下载选择Full版本


二:安装Hexo

  • 打开Cmder面板,分别输入以下命令(检测软件配置是否安装成功)

    输出了版本号,那么证明配置成功

    如果没有版本号,请重新安装node.js,检查是否勾选Add to Path,或者手动为node.js添加环境变量

    1
    2
    node -v
    npm -v
  • 安装cnpm,输入以下命令

    1
    npm install -g cnpm --registry=https://registry.npm.taobao.org
  • 检测cnpm是否安装成功,输出版本号即为成功

    1
    cnpm -v 
  • 安装Hexo,输入以下命令

    1
    cnpm install hexo-cli -g
  • 在电脑文件夹中新建一个文件夹来保存Hexo文件

    例如:D:\Blog\hexo

  • 切换Cmder的目录到新建的hexo文件路径,命令如下

    1
    cd D:\Blog\hexo
  • 执行hexo init命令,见注意事项

    上面这个命令运行到Install dependencies的时候,如果出现卡住情况,按Ctrl + c结束命令即可

  • 执行cnpm install 命令,等待完成初始化工作后,输入hexo s,按住ctrl键,并单击http://localhost:4000,可以在本地查看预览效果了。

  • 主题的话,我们选用入门级别的next主题进行配置,输入以下命令

    1
    git clone https://github.com/theme-next/hexo-theme-next.git themes/next
  • 修改配置文件(主要是theme和language),输入ls命令查看是否有_config.yml文件,再输入vi _config.yml进入根目录的配置文件进行修改,按 i 可以进行修改,退出修改得依次按esc键 shift加; wq,即可返回到根目录下

    theme栏的内容更换成next

    language栏的内容更换成zh-CN

  • 输入hexo s预览更改后的效果


三、部署在GitHub

  • 注册好GitHub账号,并登陆进去(建议不熟悉英文的开启谷歌翻译)

  • 左侧新建一个仓库,仓库的命名格式为:用户名+github.io (例如用户名为dk,则对应的仓库名字为dk.github.io),添加仓库描述,勾选public,勾选add README,然后点击创建。

  • 创建git密匙,在cmder里输入ssh-keygen -t rsa -C “[email protected](这里改成你自己的注册邮箱),连续按住回车键

  • 输入cat ~/.ssh/id_rsa.pub,将生成的密匙复制下来(密匙以ssh-rsa开头,复制的时候要把ssh-rsa也复制上)

  • 进入GitHub-点击头像-setting-SSH-New SSH Key,把密匙添加进去,并保存

  • 输入ssh -T [email protected],会出现个Are you sure you want to continue connecting (yes/no/[fingerprint])? ,输入yes按回车即可

  • 进入GitHub,打开项目,点击code,切换到ssh,将地址复制下来

  • 使用vi _config.yml命令,进入根目录下的_config,yml文件下进行配置,找到deploy所在地方,将地址复制在repo一栏,并将branch一栏改成main

    1
    2
    3
    4
    deploy:
    type: git
    repo: [email protected]:username/username.github.io.git
    branch: main(我们新建仓库的时候就是main,所以这里直接采用main分支)
  • 退出配置文件修改,回到根目录下,执行以下命令(里面要改成自己的用户名和注册邮箱)

    1
    2
    git config --global user.name 'yourname'(修改成github用户名)
    git config --global user.email 'youremail'(修改注册github所用的邮箱)
  • 再输入上传插件的命令

    1
    cnpm install hexo-deployer-git –save
  • 提交文件到GitHub仓库

    1
    hexo g -d
  • 至此Hexo博客部署完成,打开GitHub你创建的那个项目,点击Settings,往下滑找到Github pages,点击none 选择main branch,之后你会得到一个地址,这个地址就是你的博客网址了。


申明:本文是对ellen的hexo教程进行个人的二次整理,并非原创!

  • 版权声明: 本博客所有文章除特别声明外,著作权归作者所有。转载请注明出处!
  • Copyrights © 2021-2022 Eren
  • 访问人数: | 浏览次数:

请我喝杯咖啡吧~

支付宝
微信