博客搭建教程


博客搭建过程(采用hexo框架+部署到github)

1.前期准备

1.1 注意事项

hexo有2种_config.yml文件,一个是根目录下的全局的_config.yml,一个是各个theme下的

1.2 下载并安装node.js

官网下载:https://nodejs.org/en/

安装与使用:https://blog.csdn.net/qq_43557395/article/details/124325563

安装后验证:node -v

1.3 下载并安装git

官网下载:  https://git-scm.com/download/win

安装与使用:https://www.cnblogs.com/itweb666/articles/15670680.html

安装后验证:git -v

1.4 命令行安装cnpm

命令:npm install -g cnpm --registry==https://registry.npm.taobao.org

安装后验证:cnpm -v

1.5 命令行安装hexo

命令:cnpm install -g hexo-cli

安装后验证:hexo  -v

2.配置github

2.1 在github上创建仓库

创建:

新建一个名为你的用户名.github.io的仓库

比如说,如果你的github用户名是test,那么你就新建test.github.io的仓库(必须是你的用户名,其它名称无效),将来你的网站访问地址就是 http://test.github.io 了,是不是很方便?由此可见,每一个github账户最多只能创建一个这样可以直接使用域名访问的仓库。

注意:

仓库名字必须是:username.github.io,其中username是你的用户名;

创建成功后,默认会在你这个仓库里生成一些示例页面,以后你的网站所有代码都是放在这个仓库里啦。

  1. 配置SSH免密登录

为什么要配置这个呢?因为你提交代码肯定要拥有你的github权限才可以,但是直接使用用户名和密码太不安全了,所以我们使用ssh key来解决本地和服务器的连接问题。

操作步骤:

第一步:在C:\Users\blog文件夹下右键打开Git Bash Here输入命令:ssh-keygen -t rsa -C github邮件地址 生成.ssh秘钥,输入后连敲三次回车,出现下图情况代表成功

第二步:最终生成了一个新的 C:\Users\.ssh文件夹,打开这个文件夹,找到.ssh\id_rsa.pub文件,记事本打开并复制里面的内容

第三步:打开你的github主页,进入个人设置 -> SSH and GPG keys -> New SSH key,把复制的内容粘贴进去,title随便填,保存即可,我们的公钥就添加成功了

第四步:检测是否设置成功:

输入命令: $ ssh -T git@github.com # 注意邮箱地址不用改

如果提示Are you sure you want to continue connecting (yes/no)?,输入yes,然后会看到:

Hi liuxianan! You’ve successfully authenticated, but GitHub does not provide shell access.

看到这个信息说明SSH已配置成功!

第五步:此时你还需要配置:

$ git config –global user.name “RickyLove67”// 你的github用户名,非昵称$ git config –global user.email “xxx@qq.com“// 填写你的github注册邮箱

4.使用 hexo 搭建博客

4.1 初始化

第一步:在电脑的某个地方新建一个名为hexo的文件夹(名字可以随便取),比如我的是C:\Users\blog

第二步:在C:\Users\blog文件夹下右键打开 Git Bash Here,输入hexo init 初始化

第三步:执行以下命令之后,hexo就会在public文件夹生成相关html文件,这些文件将来都是要提交到github去的

第四步:hexo s 是开启本地预览服务,打开浏览器访问 http://localhost:4000 即可看到内容,很多人会碰到浏览器一直在转圈但是就是加载不出来的问题,一般情况下是因为端口占用的缘故,因为4000这个端口太常见了,解决端口冲突问题请参考这篇文章https://www.runoob.com/w3cnote/windows-finds-port-usage.html

到这里初始化就完成了

4.2 将博客部署到 github 个人主页上

第一步:在C:\Users\blog目录下安装 hexo-deployer-git 插件

安装命令: npm install hexo-deployer-git --save  

必须安装,否则执行hexo d 的话会报如下错误:

第二步:编辑C:\Users\blog目录下的 _config.yml 文件, 在文件末尾添加如下内容:

注意:其中 repo 中的内容即为 github 个人主页链接地址,具体看下图:

![img](file:///C:\Users\RickyLove\Documents\Tencent Files\839351467\Image\C2C{UGLTDK$0(4YVV[@1XBWLTX.png)

第三步:在C:\Users\blog目录下, 输入命令:hexo d 将本地 blog 推送到 github仓库, 也可能需要输入 username & pwd。

推送成功后, 在浏览器中输入对应域名, 即可访问 https://yoursname.github.io
  1. 更换主题

5.1 寻找主题

hexo官网:https://hexo.io/themes/,可在里面下载主题,点击主题名即可跳转到github上,也可以直接在github上搜索主题

在这里我使用github上一个大佬的主题blinkfox/hexo-theme-matery

链接:https://github.com/blinkfox/hexo-theme-matery    

5.2 下载主题

第一步:Git Bash Here中先cd到C:\Users\blog目录

第二步:再输入命令 $ git clone 主题http链接 themes/主题名称

注意:

C:\Users\blog目录下的 theme 文件夹下存放的就是博客的主题,主题是否下载成功可到该目录下查看:

5.3 使用主题

打开C:\Users\blog目录下的_config.yml文件,在里面找到theme: landscape改为theme: blinkfox   (blinkfox为我们要使用的主题名),然后重新执行hexo g来重新生成。

如果出现一些莫名其妙的问题,可以先执行hexo clean来清理一下public的内容,然后再执行hexo g 和 hexo s 重新生成和发布。

再次在浏览器中输入对应域名, 即可发现主题已更换

5.4 修改主题内容

在这里我使用的是blinkfox主题,后期相关修改参考这个主题文档

文档链接:https://github.com/blinkfox/hexo-theme-matery/blob/develop/README_CN.md

注意:一些非md文件可以把他们放到source文件夹下,这里的所有文件都会原样复制(除了md文件)到public目录的

修改文件,记得修改后的文件需要关闭后,再在blog根目录右键打开Git Bash Here,输入两个命令:hexo g 重新生成,hexo s 开启本地预览服务,等修改的符合要求了,再输入 hexo d 推送到github仓库即可

这样就可以输入网址查看更改后的内容了

文档上没有提及的修改:

返回按钮样式修改:在主题下面的 blinkfox\layout\_partial 文件夹中的 back-top.esj 文件中修改

特别注意:

修改生成的默认页面信息,要到主题下面的_config.yml文件里面去改,而不是根目录下的_config.yml文件


要把根目录下的_config.yml文件中的这些信息替换成自己的和设置中文

6.利用Typora软件来写博客

6.1 Typora介绍

Typora–一款简单高效的Markdown编辑器,保存后直接为md格式,Markdown中点击导入就可以。

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式,其目标是实现易读易写,说人话就是删减版的HTML语言

Markdown教程:https://www.runoob.com/markdown/md-tutorial.html

6.2 安装Typora

官网:https://www.typora.io/#windows

6.3 写博客的步骤

第一步:创建.md文件

方法1:定位到我们的hexo根目录,Git Bash Here 中执行命令:  hexo new 'my-first-blog'                hexo会帮我们在C:\Users\blog\source\_posts 下生成相关.md文件,用这个命令的好处是帮我们自动生成了时间。(但是本人尝试后未能成功发布,鉴于本人也是初学者,还未找到原因)

方法2:当然你也可以直接自己打开E:\xpzsData\hexocode\source\_posts 目录新建.md文件

第二步:编写并保存

我们只需要用typora打开这个文件就可以开始写博客了,写完后Ctrl+S 保存关闭即可

第三步:清理然后再生成一下,生成后推送到远程仓库即可,hexo根目录下右键Git Bash Here 中依次输入如下命令:

hexo clean

hexo g

hexo d

6.4 Typora快捷键

Typora中只要记住一些基本的快捷键就可以了,所有功能软件里面都有对应按钮,这点不用慌。

快捷键文章:https://blog.csdn.net/weixin_39533052/article/details/111115263

6.5 注意:所使用的主题的文章 Front-matter 语法

依据使用的不同主题,一些文章功能所使用的语法可能不一样,例如写博客时给文章添加标签的语法等等,这些都要看所使用的主题的文档,例如我们这里使用的是 blinkfox 主题,打开主题文档,往下翻找到” 文章 Front-matter 介绍 “即可。

blinkfox主题文档:https://github.com/blinkfox/hexo-theme-matery/blob/develop/README_CN.md#%E6%96%87%E7%AB%A0-front-matter-%E4%BB%8B%E7%BB%8D

参考文献:

1:https://github.com/blinkfox/hexo-theme-matery/blob/develop/README_CN.md

2:https://www.cnblogs.com/liuxianan/p/build-blog-website-by-hexo-github.html

3:https://www.jianshu.com/p/f72aaad7b852

4:https://blog.csdn.net/qq_43557395/article/details/124325563

5:https://www.cnblogs.com/itweb666/articles/15670680.html


文章作者: RickyLove
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 RickyLove !
  目录