1. 此篇教程适用于想搭建博客但没有基础的小白,只要你会百度和下载安装就行了,新手教程,大佬勿喷。
  2. 复制/输入代码时请检查一下内容是否正确(中英文输入法/空格)。

准备安装软件

点击即可跳转到下载链接,如果下载缓慢建议用迅雷或者自行下载。 遇到问题要百度

安装看不懂的话可以直接点下一步就行了,均采用默认安装。

  1. Node.js
  2. Git

创建并连接仓库

注册github

Github:https://github.com/ 注册登录,看不懂英语的可以用浏览器翻译

创建repository

注册登录后点击右上角的+号,选择New repository。填写Repository name应该保持和前面的Owner一致,填进去的是XXX.github.io,例如你的用户名是ABC,那么填入ABC.github.io,点击creat repository

配置SSH key

ssh keys就是一把钥匙,用来使本地git项目与github联系

  1. 检查SSH key的设置
    首先要检查自己电脑上现有的 SSH key:
    右键桌面-选择git bash here(要复制粘贴的话,在git里面点右键-paste)
    $ cd ~/.ssh
    如果显示“No such file or directory”,说明这是你第一次使用 git。
  2. 生成新的 SSH Key:
    $ ssh-keygen -t rsa -C "填写你的邮箱地址"
    然后会显示:
    $ ssh-keygen -t rsa -C "填写你的邮箱地址"
    Generating public/private rsa key pair.
    Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):
    看到这里直接回车就好了。

    1.这里的邮箱地址,输入注册 Github 的邮箱地址
    2.「-C」的是大写的「C」

    然后系统会要你输入密码:
    Enter passphrase (empty for no passphrase):<设置密码>
    Enter same passphrase again:<再次输入密码>
    这个密码会在你提交项目时使用,如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。
    建议直接回车不输入。注意:输入密码的时候没有输入痕迹的,不要以为什么也没有输入。
    最后看到一个RSA 2048和SHA256的框框,就说明成功了。
  3. c:/用户(或者user)/Administrator/.ssh找到id_rsa.pub文件,如果没有点击左上角的查看,勾选文件扩展名隐藏的项目
    右键这个文件-打开方式-记事本,然后全选复制。
    回到github,点右上角头像-settings-左边栏选择SSH and GPG keys-右上绿色按钮New SSH key
    然后title随便写,key里面粘贴刚刚复制的,然后Add SSH key
  4. 测试
    右键桌面-git bash here,然后输入完整代码:
    $ ssh -T git@github.com
    如果反馈
    The authenticity of host 'GitHub.com (207.97.227.239)' can't be established.
    RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
    Are you sure you want to continue connecting (yes/no)
    输入yes 然后回车 如果你刚刚设置了密码,现在输入密码:
    Enter passphrase for key '/c/Users/lenovo/.ssh/id_rsa':
  5. 设置用户信息
    现在已经可以通过 SSH 链接到 GitHub 啦!当然还需要完善一些个人信息:
    $ git config --global user.name "输入注册时的用户名"
    $ git config --global user.email "输入注册时的邮箱"
    GitHub 也是用这些信息来做权限的处理,输入的代码进行个人信息的设置,把名称和邮箱替换成你自己的,名字必须是你的真名,而不是GitHub的昵称。
    SSH Key配置成功!本机已成功连接到 github。如果有问题请检查之前的步骤,或者百度

搭建Hexo博客

在桌面右键git bash here,利用npm指令安装hexo

$ npm install -g hexo
  1. 创建一个用来放博客项目的文件夹(你随便找个位置)
    安装完成后,关掉前面那个 Git Bash 窗口。在本地创建一个与刚刚创建仓库名字一样的文件夹(如ABC.github.io),进入文件夹点右键,选择 Git bash here。

    在进行博客搭建工作时,每次使用命令都要在这个文件夹里面下。

    执行下面的指令,Hexo就会自动在这个文件夹建立独立博客所需要的所有文件

    $ hexo init
  2. 安装依赖包
    由于node下载第三方依赖包是从国外服务器下载,虽然没有被墙,但是下载的速度是非常的缓慢且有可能会出现异常。
    所以为了提高效率,我们还是把npm的镜像源替换成淘宝的镜像源。

    $ npm config set registry https://registry.npm.taobao.org

    然后检查是否修改成功

    $ npm config get registry

    如果显示https://registry.npm.taobao.org说明成功,这下可以开始安装依赖包了。

    $ npm install
  3. 确保git部署

    $ npm install hexo-deployer-git --save
  4. 本地查看
    现在已经搭建好本地的Hexo博客了,执行完下面的命令就可以到浏览器输入localhost:4000查看到啦,git不要关闭。

    $ hexo g && hexo s

    hexo g 每次进行相应改动都要hexo g 生成一下,然后hexo s 启动服务预览,上述代码合并执行了。

  5. 用Hexo克隆主题(选择你喜欢的主题啦)
    之前执行完 hexo init 命令后会给一个默认的主题:landscape
    你可以到官网找你喜欢的主题进行下载,知乎:有哪些好看的Hexo主题
    找到它所在的Github Repository(至于怎么下载可以看看别人的文档,里面会有说明如何安装和使用的,或者直接百度
    有些主题甚至可以直接npm i hexo-theme-XXXX下载下来的,保存在你文件的theme文件夹里面

  6. 修改整站配置文件
    打开刚刚创建的XXX.github.io文件夹,里面有个_config.yml文件,用记事本打开修改相关的属性

    后面所说的打开均是右键-打开方式-以记事本打开

    一般都有注释,#后面的都是注释,不影响内容,比如:

    # Site 站点
    title: CarpeDiem #主标题
    subtitle: '' #副标题
    description: '晚来天欲雪,能饮一杯无?' #博客描述
    keywords: #关键字
    author: Jesse_Chang #博主
    language: zh-CN #语言
    timezone: '' #时区
    ......

    到此位置公共部分基本就完成了,剩下7-9的就是主题和自己的博客美化了,就大概说一下,如果感兴趣的可以继续研究。不想管的直接可以跳转到下一部分————将博客部署到Github

  7. 启用新下载的主题
    首先在刚打开的的_config.yml文件中,(CTRL+F)查找到# Extensions,把下面的themelandscape修改为刚刚下载下来的主题名

  8. 更新主题
    git bash里执行(在博客项目的文件夹里面执行)

    $ cd themes/主题名
    $ git pull
  9. 本地查看调试
    每次修改都要hexo g生成一下

    $ hexo g #生成
    $ hexo s #启动本地服务,进行文章预览调试,退出服务用Ctrl+c

    浏览器输入localhost:4000预览效果

将博客部署到Github

  1. 复制SSH码
    进入Github个人主页中,点击右上角头像Your Repository,选择之前创建的仓库XXX.github.io,点击上方绿色code按钮选择SSH,然后复制SSH码。

  2. 编辑整站配置文件
    打开之前创建的XXX.github.io文件夹找到_config.yml,把刚刚复制的SSH码粘贴到(用CTRL+F搜索)repository:后面,别忘了冒号后要空一格
    然后改成这样子

    deploy:
    type: git
    repository: git@github.com:你的用户名/你的用户名.github.io.git
    branch: main
  3. 执行下列指令即可完成部署

    每次修改本地文件后,需要 hexo g 才能保存。如果修改过东西,可以用hexo clean先清理,每次使用命令时,都要在你的博客文件夹目录下,合起来一套指令。

    $ hexo clean && hexo g && hexo s

    如果在配置 SSH key 时设置了密码,执行 hexo d 命令上传文件时需要输入密码进行确认,会出现一个小框框。

    输入密码之后在浏览器输入:你的用户名.github.io
    如果得到你想要的效果,那么恭喜你,博客已经搭建好啦!你的用户名.github.io这个就是你的博客地址啦!如果搭建完了,记得留言给我,给你添加好友链接噢~