【新手/零基础】Hexo+Gitee个人博客搭建教程--详细版
前言
点此转到--精简版
可能很多小伙伴都有搭建一个属于自己的博客的想法。但是经常是无奈于自己匮乏的知识。但是,每个老手都是新手过来的,再困难的事情,只要肯花一点时间都可以办成。
本次教程分为详细版和精简版。
精简版,顾名思义,废话少说,重在操作。
详细版,重在拓展基础知识,并且通俗易懂的讲解。大家可以按需取用。
另外,文章末尾常见问题部分写了几个新手经常忽略的点 & 遇到的坑
建议大家在遇到问题的时候,先ctrl+F在此页面先搜索,找不到再百度或谷歌。
前期准备
搭建前需要知道的
域名是什么?
我们大家耳熟能详的www.baidu.com
就是一个域名,比如当你想去朋友家玩的时候,首先要知道朋友家在哪,就是我们常说的ip地址,可以把它理解为一个门牌号。比如百度的ip地址220.181.38.150
,我们可以直接在浏览器中输入这串数字访问百度。但是有小伙伴该说了,这么长谁记得住。确实,由于IP地址具有不方便记忆并且不能显示地址组织的名称和性质等缺点,人们设计出了域名,并通过网域名称系统(DNS)来将域名和IP地址相互映射,使人更方便地访问互联网,而不用去记住能够被机器直接读取的IP地址数串。所以如果你也想有自己的博客/网站,也需要有自己的域名。
服务器是什么?云服务器呢?
域名和云服务器都可以购买。
Git是什么?gitee呢?
讲完前面两个东西,又有小伙伴问了,我就是练练手,不想买呢。
那么这篇教程就很适合你了,Github和Gitee为了方便用户展示自己仓库的项目,都提供了Git(ee) Pages服务,这是什么东西呢?它们是一个免费的静态网页托管服务。简单来说,就是项目作者用来展示项目内容或者发布帮助文档的地方。当开启这个服务后,gitee会自动分配一个https://www.你的用户名.gitee.io/你的仓库名
这样一个域名。
白嫖党福利?
这就有意思了,前面我们提到,一个网站的搭建主要就有域名``服务器``配置
这三个方面,前两个人家不都已经提供给我们了嘛,对于我们这种小白,抱着试一试的想法去搞个人博客/网站,是不是很香?又是白嫖党的福利。
域名和服务器
- 常用windows系统的小伙伴可能不经常使用命令行,所以可以了解一点关于命令行和终端相关基本操作
(http://),有精力和兴趣的可以直接学Linux,它是大势所趋 - git bush/cmd等命令行操作,如果没有在环境变量里设为全局变量,哪个包(或者应用)的操作就要到它对应的目录下运行命令行语句!而且要注意区分目录层级。
- 一定要善于查看和使用对应的技术手册or文档,这是开源作者or团队成员的高度精华。你现在存在问题,可能他们已经有解决方案了。
举个例子:在使用不同的Hexo主题时,一定要查阅主题作业自己的文档,他们在做自己的主题的时候,是会修改甚至覆盖Hexo官方的一些配置项目的。本人的主题就是这样,配置文件也转变成了melodyxxxx。 - 换源很重要!
由于大部分源代码都在GitHub上下载的,而国内访问会超时导致无法下载。要事先换成镜像源。这对经常接触各类项目的人来说很常见。
搭建步骤
3和1顺序调换!
安装git
git是什么?
git的配置
安装node.js
码云Gitee
注册
(Gitee是中国版的github,用它而不是用github的原因显而易见,国内访问国内服务器当然比较快了。感兴趣的可以按照这篇文章的步骤搭建基于Github Page的个人博客)
新建仓库
SSH公钥
部署Gitee Page
下载hexo
hexo init
运维
缝缝补补+发布新文章
如果在缝缝补补(换主题/添加了第三方插件)的过程中又出现问题,ctrl+f。
以后发布文章就可以
(可选)hexo clean --删掉本地public目录,清除本地缓存
hexo g --收集生成相应文件
(可选)hexo s --打开服务,可以在localhost:4000预览
hexo d --部署/git push到远端仓库
写文章/博客
首先推荐的就是在CSDN里面写,有很多快捷方式,并且一些LaTex、UML图都有,写完再导出markdown文件。(需要注意的是你的hexo项目里的makedown是否可以解析,这一点可以百度)
或者在VS Code这类编辑器里写,也很方便。它们都有实时预览,保证解析出来的效果。
Markdown教程--菜鸟教程
常见问题FAQ
搭建过程中的问题
- 一个在我搭建的过程中困扰我很久的问题:明明hexo s运行后,在localhost:4000里看的很正常,但是hexo d部署后gitee.io网页没有更新,甚至有时候排版错乱。这种情况下可以尝试下面几个步骤:
- 试一下hexo clean,再hexo g
这个是由于xxxxxxxxxx - 清除浏览器缓存
其实别人查看的时候是没有问题的。浏览器为了加快访问速度,因为你之前多次打开,都会有缓存,导致更新没有真正完成,不同的浏览器可以百度看怎么清缓存 - 在git page服务中,更新部署这个是前面两步都没有效果的时候,试试这个可能有奇效。
参考资料
1. Hexo+Gitee 搭建独立博客
2. 基于Gitee+Hexo搭建个人博客
3. Hexo官方中文文档
4. melody主题使用文档
5. MARKSZのBlog--主题作者博客demo