斜杠青年Felix的博客
0%

利用Hexo搭建博客

发表于 更新于

本文包括三部分内容，分别是：

  • 如何利用Markdown书写blog
  • 图床制作与使用说明
  • Hexo基础使用说明

如何利用Markdown书写blog

就像大多数编程语言一样，markdown也有属于自己的一套语法，熟练掌握这些基础语法才能让我们在书写的时候游刃有余。
原文地址一：markdown基础语法

blog时常需要引用图片，因此需要搭建图床，便于markdown书写的链接在任何地方都可以引用到所需的图片。
原文地址二：markdown图床搭建

markdown基础语法

一、标题

通过在标题前方加#来表示标题，标题级数每增加一级就增加一个#号
注：标准语法一般在#后跟个空格再写文字。

二、字体

加粗需要在文字前后分别加两个*号;斜体前后分别加一个;加粗斜体则需要三个。
删除线需要在文字前后分别加两个~号。

三、引用

在文字前面加>即可，与标题级数同理，引用每多一级就在前面多加一个>即可。

四、分割线

用连续三个*号即可。（会用一种即可。也有其他方式，可以知道，但没必要学）

五、超链接

这个我觉得最好是给个例子，例子如下：

1
[百度](http://baidu.com)

显示效果如下：
百度

六、列表

无序列表

这种列表只需在开头加上一个*号即可，后面再紧跟一个空格。

1
2
3
* 无序列表1
* 无序列表2
* 无序列表3

效果如下：

  • 无序列表1
  • 无序列表2
  • 无序列表3

    有序列表

    开头为数字加点，也要加空格。
    1
    2
    3
    1. 有序列表1
    2. 有序列表2
    3. 有序列表3
    效果如下：
  1. 有序列表1
  2. 有序列表2
  3. 有序列表3

    嵌套列表

    级数每多一级，就在开头多加三个空格。
    1
    2
    3
    4
    1. 嵌套列表1
    2. 嵌套列表2
       1. 嵌套列表3
       2. 嵌套列表4

七、图片

图片相对复杂一些。
这里我已经搭建好了静态图床，通过markdown语句就可以进行访问。
语法如下：

1
2
3
4
5
6
7
![图片alt](图片地址 ''图片title'')

其中，[]中的内容为图片下方需要显示的文字;
图片地址就是图片的链接，其中本文的图片来自gitee搭建的图床;
""中填的是图片标题，图片标题就是当鼠标移动到图片上会显示的内容，这部分可加可不加。

注：""前面有一个空格。

示例如下：

1
![一江春水向东流](https://gitee.com/lu-qixin/murmur-ofthe-heart7.gitee.io/raw/master/images/bg2.jpg "测试图片")

效果如下：
一江春水向东流

图床制作与使用说明

这里图床搭建用到的玛云提供的Gitee Pages搭建的静态页面服务，下面是我在ubuntu16.04系统上搭建的步骤。

第一步可以参考下面这篇文章，在gitee上搭建一个仓库。
如何利用玛云搭建一个自己的图床？
注：文中提到的网站模板下载可以用其他的方式。目的只是帮助我们这些小白快速获得一个网站雏形，模板不做任何修改也能使用。

图床搭建完成后就是如何使用的问题。
第二步，也就是如何使用。使用过程主要包括上传图片和引用图片。
这里我们介绍两种上传图片的方法。

  1. 我们只需点击gitee仓库中的上传文件，上传相应的图像文件到我们想要保存的目录下即可。
    上传文件
    注：如果我们在第一步中使用了模板，就会发现模板中都有相应的images文件夹，我们最好在该文件夹下进行保存和管理。
  1. 使用本地仓库上传。（推荐使用）

本地仓库上传指令
三条指令分别如下：

1
2
3
4
5
6
7
8
$ git add .
添加文件到版本控制 .代表全部

$ git commit -m "qx"
提交到本地库，-m 添加备注

$ git push origin master
把本地仓库的文件推送到远程仓库

注：这些操作都要在本地仓库中进行。

同时，每次上传完成后，我们都要手动的打开Gitee Pages更新部署一下，否则新图片将无法访问。

打开Gitee Pages

更新部署

在ubuntu下上传极少会出现的一个错误，这里记录一下解决方法。
更新被拒绝，因为远程仓库包含您本地尚不存在的提交

接下来就是用markdown引用图片，具体语法前文提到过，这里只说一个注意事项。
注意事项：引用时要把链接中的blob换成raw，这样生成的链接才是永久引用，前者只是一个临时链接，会失效。

1
2
3
示例：
将https://gitee.com/lu-qixin/murmur-ofthe-heart7.gitee.io/blob/master/images/bg2.jpg
换成https://gitee.com/lu-qixin/murmur-ofthe-heart7.gitee.io/raw/master/images/bg2.jpg

图片链接获取也很简单，只需点开gitee仓库中所需引用的图片，复制它的网址即可。

图片链接获取

这里有一点需要注意，我们需要在gitee库中，将 管理-基础设置-是否开源 更改为是，否则我们就无法引用图床的图片啦！！！

是否开源

Hexo基础使用说明

Hexo官方使用说明就是最好的教程。
Hexo中文官网
可以根据文档中的信息完成安装部署等一系列操作。

Hexo常用指令

1
2
3
$ hexo g       //生成静态网页
$ hexo server  //启动服务
$ hexo d       //部署

注：这些命令都要在本地库中进行才是有效的。如果不能识别hexo指令，可以在前面加上npx。

部署Hexo时，我们可能需要一些ssh密钥方面的知识。具体的操作步骤，可以参考如下的几篇文章。
ubuntu16.04如何生成ssh密钥以及如何查看ssh密钥
ubuntu系统中使用ssh生成密钥并保存在不同的文件

注：ubuntu的密钥保存在~/.ssh文件夹中。

生成新的ssh密钥

1
2
$ ssh-keygen -t rsa -C "your_email@example.com"
your_email@example.com 为你在 GitHub或者GitLab 注册时的邮箱。

回车后会显示：

1
2
Created directory '/Users/xxx/.ssh'.
Enter passphrase (empty for no passphrase):

到这一步输入一个新密码。
之后会提醒保存的文件目录，如果是第一次创建，可以直接回车，密钥会保存在默认文件中。
这里使用ssh-keygen -t rsa即可在家目录下的.ssh目录中生成id_rsa以及id_rsa.pub。这个文件名是默认的。
上传成功后，会出现以下界面：
ssh密钥生成成功
如果想要使用其他的文件名，使用如下命令即可：

1
2
$ ssh-keygen -t rsa -f ~/.ssh/文件名
注：只是文件名，没有任何后缀

查看生成的ssh密钥

只需在终端输入：

1
2
$ cat /Users/xxx/.ssh/id_rsa.pub
注：id_rsa.pub名称需要根据创建时设置的文件名进行修改。

OK，此时终端会输出ssh密钥，直接复制就可以啦。