免费个人博客搭建教程(详细-图文)--Hexo+OSChina

2018-03-29 11:11:59 浏览数 (1)

使用工具介绍

码云 Pages:码云 Pages 是一个免费的静态网页托管服务,您可以使用码云 Pages 托管博客、项目官网等静态网页。这样就不用购买服务器和域名了,如果您使用过 Github Pages 那么您会很快上手使用码云的Pages服务。这里使用码云上的Pages 而不是用Github Pages,主要原因就是在国内没有V**的话。。。你懂得!还有就是支持国产!

链接:https://git.oschina.net/

Hexo:Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。使用者只需要专注于写博客而不需要关注网站是如何生成的。而且还有丰富的博客主题可以选择!

链接:https://hexo.io/zh-cn/

搭建环境

Node.js 安装

参考:http://www.runoob.com/nodejs/nodejs-install-setup.html

(ps:如果没有V**的用户最好切换一下npm的源,不然后续的步骤可能会让你想砸电脑,安装完后,在命令窗口执行下面代码)

npm config set registry http://registry.cnpmjs.org #切换npm为淘宝镜像

Git 安装

参考http://www.runoob.com/git/git-install-setup.html

Hexo安装。( ps:安装完Node.js和Git之后不需要配置些什么,只需要安装成功就是了,如果想明白原理的话可以深入的学习。)

如果您的电脑中已经安装上述必备程序,那么恭喜您!接下来只需要使用 npm 即可完成 Hexo 的安装。打开命令窗口输入下面代码:

npm install -g hexo-cli

npm install -g hexo-cli

安装成功后输入hexo 如果得到下面这个结果,恭喜你!安装成功!

Hexo的常用命令说明:

参考:https://hexo.io/zh-cn/docs/commands.html

本地运行Hexo

安装 Hexo 完成后,请依次执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。将<folder> 替换成项目存放的文件夹目录,

hexo init <folder>

cd <folder>

npm install

hexo generate

新建完成后,指定文件夹的目录如下:

.

├── .deploy #需要部署的文件

├── node_modules #Hexo插件

├── public #生成的静态网页文件

├── scaffolds #模板

├── source #博客正文和其他源文件, 404 favicon CNAME 等都应该放在这里

| ├── _drafts #草稿

| └── _posts #文章

├── themes #主题

├── _config.yml #全局配置文件

└── package.json

进行到这步后就可以先在本地运行下,看看效果了。执行下面命令:

cd <folder> #切换到项目目录下npm install #install before start blogginghexo server #运行本地服务

浏览器输入 http://localhost:4000 就可以看到效果。如下:

修改Hexo的主题

当然,上面运行的只是Hexo官方默认的主题配置效果,想要个性一点?,下面我们就将他改造成自己想要的个性主题。

Hexo的主题都是一些前端民间高手写的模版,可以在官方收录的主题中去挑选:https://hexo.io/themes/

看上一个主题后点击下图位置,进入下载主题文件。如下图:

主题下载完成后,将主题文件解压到Hexo项目的thems文件夹下面(ps:我这里的项目目录是在桌面的Hexo文件夹里面。)

接下来就是修改Hexo的配置文件_config.yml,将里面theme 对应的值改为之前下载的主题的文件夹名字,本文里面下载的主题文件夹名字为hexo-theme-smackdown-master。

修改前

修改后

注意:这里“:”后面必须要有一个空格,而且这个空格要在英文输入法下,不然会报一些稀奇古怪的错。

按照之前步骤本地重新运行后,如下图:

关于Hexo中_config.yml 文件的其他配置,大家可以参考官方的文档,这里就不多赘述了:

文档链接 https://hexo.io/zh-cn/docs/configuration.html

下载的每个主题中,有一个配置文件,名字也叫_config.yml,这里大家千万不要和之前Hexo根目录下的_config.yml搞混淆了,这里面配置的主要是些与主题相关的东西,比如一些文章阅读量,多说插件,cnzz站长工具等等的配置信息。一般里面也都有注释,这里就不赘述了,不懂得可以在我的博客问我。

一些主题在GitHub上面也都有主题安装的一些文档,写的都很详细。推荐一个主题的文档,结合官方的文档看完之后,基本上也就明白了。

推荐一个主题的文档:https://github.com/yscoder/hexo-theme-indigo/wiki

编写博客文章

如果你使用过MarkDown 来写博客文章的话,接下来就简单多了,没使用过也没关系,推荐大家一个编辑工具马克飞象 链接:https://maxiang.io/,在编辑器里面写好文章后,复制或另存为.md文件, 与普通的.md文件不同 要在文件开头添加下面代码

title: #文章标题

date: #文章日期

tags: #文章标签

categories: #文章分类

---

在.md文件的开头添加上面代码,是为了让Hexo框架在生成网页的时候,设置相应的参数。例如下图所示:

将写好的.md文件放入Hexo项目的source 目录下的_posts 文件夹中,可以看到里面有个hello-world.md 文件,这就是默认的文章。

重新在本地启动项目,访问就可以看到之前添加的文章。

生成静态Html文件

现在只能在本地启动项目然后通过本地地址访问博客网站,下面我们就可以利用Hexo生成静态Html,很简单,只需要在命令窗口执行下面代码:

cd <folder> #切换到项目目录下hexo generate #生成静态文件到项目根目录的public文件夹中

发布静态Html文件到码云 Pages上

注册一个码云帐号,并创建一个项目。如下图:

创建完项目后得到项目的Https的地址后面要用。地址获取如下图

这里借用一个插件来帮助我们完成代码上传的工作,安装 hexo-deployer-git。安装代码如下:

npm install hexo-deployer-git --save #把public里面生成的文件推上到码云上。

配置项目根目录_config.yml 文件,修改deploy 的值,如下图:

修改前

修改后,注意repo 的地址是之前在码云上面创建醒目后获取的地址。

修改完后在命令窗口执行下面命令:

cd <folder> #切换到项目目录下hexo deploy #一键部署功能

之后会弹出一个对话框,输入码云的帐号密码。

部署成功之后,登录码云,查看之前创建的项目中出现了本地项目中public 文件夹中的文件,这时候代表之前的部署是成功的。

然后如下图,启动码云的pages功能:

访问链接:

这时候就看到之前和本地启动一样的效果了。博客部署完成,在这之后,只需要每次用马克飞象写好文章后,放入Hexo项目的source 目录下的_posts 文件夹中,在按照之前步骤更新博客就OK了。还可以随时切换博客的主题哦!

0 人点赞