Github搭建博客教程

一、前言:

关于本博客的搭建,参考了很多网上的教程,虽然说网上教程很多,但总觉得很分散,每个教程的着重点都不一样,因此我顺便整理了下在自己搭建博客过程中参考过的教程。


二、搭建步骤:

2.1 软件安装:

不详细讲,具体教程网上很多,nodejs和git的安装基本都默认下一步。

2.2 搭建本地博客

  • 安装hexo

打开cmd命令(WIN+R),执行命令

npm install hexo-cli -g


npm install hexo-cli -g

等待自动安装完成后,输入

hexo -v

hexo -v

可以检查是否安装成功,如果没问题可以继续。

  • 初始化hexo

新建一个文件夹Hexo,用于存放博客,配置等。右键

Git Bash Here

git bash here

直接定位到当前文件夹,然后执行

hexo init

hexo_init

初始化配置文件,可能时间比较长,耐心等待。完成后,输入

npm install

npm_install

配置node。接下来输入

hexo g

hexo_g

加载hexo基础html、css、js等文件。
在这完成后等于已经在本地创建了一个网页,想查看的话,输入

hexo s

hexo_s

这相当于开启了一个本地的服务器,会提示你拷贝url到浏览器。(Ctrl + C 是停止的意思,不是复制!)

这里注意:不要Ctrl+C!不要Ctrl+C!不要Ctrl+C!

把网址输入到浏览器就能访问本地网页了。

一定要先浏览网页再执行Ctrl+C结束,顺序颠倒会导致访问不了网页。

但如果提示错误解决办法如下:Hexo server not working;Hexo 无法访问页面


打开文件Hexo/_config.yml,添加如下代码

1
2
3
4
5
6
server:
port: 5000 # or anohter number
log: false
ip: 0.0.0.0
compress: false
header: true

如图所示

重新输入

hexo s

端口号会变成5000。同样,先输入网址。

localhost:5000


至此,本地博客框架搭建完成

  • DIY博客主题

之前的博客界面主题是默认的,当然是要换成别的啦。说是DIY,其实就是搬运别人的主题。下面按照我的主题举例介绍如何搬运。

首先输入

git clone https://github.com/yelog/hexo-theme-3-hexo.git themes/3-hexo

把对应的主题clone到本地Hexo/theme/3-hexo

git clone

这时在theme文件夹下面多了一个3-hexo的文件夹,这就是下载下来的主题。

修改根目录下的 _config.yml文件

theme: 3-hexo

3-hexo

再次运行

hexo s

hexo s

到这里为止,主题算是搬运完了,接下来就是细节上的修改,将别人的主页变成自己的,具体修改方法参考原作者在GitHub上的说明。

2.3 部署到GitHub

  • 配置远程仓库地址

在根目录下的 _config.yml文件中修改

1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/用户名/用户名.github.io.git
branch: master
  • 其他

具体可以参考其他参考教程。

关于新建分支用于存放源文件的操作其他参考教程上也有。

三、使用方法:

3.1 编写博客

  • 打开git:

右键 Git Bash Here,定位到当前文件夹
git bash here

  • 新建文章:

hexo new “文件名字”

3.2 部署博客

  • 本地写完后,将本地源文件备份到github:
1
2
3
git add .
git commit -m "备注"
git push origin hexo
  • 将文件转换为网页,部署到博客:

hexo clean && hexo g && hexo d


四、参考网站:

next主题
配合简书

也可以看Hexo置顶及排序问题
等主要参考如何设置主题

主要看使用hexo+github免费搭建个人博客网站超详细教程另外
GitHub Pages + Hexo搭建博客\
以及
Hexo+Github搭建个人博客两个分支方便维护等主要参考如何部署和维护

其他有关修改主题内容的教程:
为 hexo NexT 添加 Gitment 评论插件
Hexo Next 主题博客添加gitment评论功能

坚持原创技术分享,您的支持将鼓励我继续创作!
显示 Gitment 评论