几个月前就想写这篇文章了,很多人也让我写过,也帮很多人搭建过,但是一直没时间纪录下来,这次有时间了,把安装的过程详细的记录下来。虽然网上有大量教程,我为什么又要造轮子呢?因为长时间的观察和浏览,教程这东西写的详细的很少,当然还是有的,百度上大部分都是一模一样的教程,博主为了浏览量爬虫或者粘贴复制过来的,参考价值不大,排版混乱。所以,自己动手写一个,让初学者不走弯路。
教程分为四大部分:
- Hexo 本地部署(博客前端设置)
- Hexo 简单个性化(博客前端设置)
- 文章迁移(可选)
- Github域名设置(博客后端设置)
- Hexo 与 Github 关联(前端后端连接)
1.Hexo本地部署
1.1.安装Homebrew
Homebrew 是一个套件管理器,安装完之后就可以用 brew 命令安装各种依赖软件,类似于 Linux 下的 apt-get 和 yum。进入 Homebrew 的官方中文网站:Homebrew 官方网站,打开 Mac 的终端,输入一行命令:/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" ,稍作等待,就可以安装成功,我的电脑基本上都是挂着 ss 的,你们如果没有梯子的话,下载速度可能有点慢,Mac 用户在编译时可能会遇到问题,请先到 App Store 安装 Xcode,Xcode 完成后,启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。
1.2.安装 Node.js
a.输入命令brew install wget ,安装 wget:
b.输入wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh 安装nvm,这一步是为了安装 Node.js,因为安装 Node.js 的最佳方式是使用 nvm。
c.输入nvm install stable 安装 Node.js:
1.3.安装Git
输入brew install git 安装 Git:
1.4.安装Hexo
输入npm install -g hexo-cli 安装我们今天的主角:
2.Hexo 简单个性化
我们来看一看 Hexo 的主页:
让我们继续设置下我们的博客,这里简单配置下然后修改下样式,后面大家有时间研究可以深入研究,先初始化一个 Hexo 目录,用来放我们所有的博客静态文件,文件夹命名随意,这里我规范点,以 timhbw.github.io 命名,因为这个就是GitHub 提供给我们的免费域名,后面会讲到。输入hexo init xxxxx :
然后执行下面命令,1.进入博客目录,2.安装 npm模块,安装在node_modules目录下图中执行的hexo generate 暂时可以不用执行,是用来生成静态文件的:
- cd xxxxx
- npm install
启动 Hexo 本地服务,输入hexo server ,然后浏览器输入http://localhost:4000/,点击访问:
默认的主题不太美观,还是换一个主题比较好,就换 NexT主题,Hexo 平台用户量数一数二的,外观、效果、扩展性也的确没话说,可玩性高。输入git clone https://github.com/iissnan/hexo-theme-next themes/next 安装 NexT 主题,关于 NexT 主题,可以去官网看一看,做 iOS 想必大家都熟悉瞄神,他的主题在这里,Hexo 官方收录的主题在这里:
下载好文件到博客目录的themes文件夹下后,系统怎么知道你要用哪一个主题呢?当然要自己修改配置文件了。打开_config.yml 文件修改66行左右为theme: next :
修改主题为 next 后,可以顺便把配置文件里面的其他东西一并修改,下面是我修改好的_config.yml ,个人添加了详细解释,大家根据自己情况修改(_config.yml是博客的整体配置文件,很多基础配置、插件配置等都需要在里面进行,有些是在主题里面设置。要注意的是,该文件格式要求比较严格,冒号后要一定有空格,不要 Tab 缩进,用空格):
3.文章迁移(可选)
如果是刚刚开始写博客读者,可以直接看 GitHub 域名设置了。有些人是其他博客转过来的,之前还有文章,一篇一篇复制过来太慢,像我的文章快100多篇了,手动转换的话估计没人愿意转移到 Hexo 平台下。所以就有一键迁移这个工具,我试了下,效果还不错。
支持以下格式迁移:
- RSS
- Jekyll
- Octopress
- WordPress
- Joomla
这里我以用户数量庞大的WordPress 为例:
先在 Mac 终端里面输入npm install hexo-migrator-wordpress --save 插件用来迁移 WordPress 文章,然后根据图中所示登录 WordPress 后台下载好 xml 格式的文件:
然后回到终端,输入如下命令,注意 xml 文件的路径请修改为自己的路径:
- hexo migrate wordpress /Users/timhbw/Downloads/tim.wordpress.2017-03-08.xml
然后重新启动 Hexo,输入hexo server ,然后浏览器输入http://localhost:4000/,点击访问:
4.Github域名设置
经过以上步骤,网站在本地已经有模有样了,就差部署到服务器上了,这样普通用户就可以通过网络任意访问你写的文章,而不是只有你本地或者局域网能访问,那这样博客的意义也就消失了。这里既然是免费,那就采取 GitHub 的免费服务器和免费域名,如果折腾一会儿,想要更好的性能或者权限,就得自己购买服务器和域名,域名30左右,服务器国内阿里云,腾讯云一般60左右一个月,一般人不会掏这个钱,国外 VPS 性价比比较高,可以搭建梯子还可以放置个人博客等等,价格100到几千一年不等。下面开始 Github 服务端部署:
4.1.注册一个 GitHub 账号
注意注册账号时填写的 username,将会是你的域名的一部分,你的域名是 username.github.io 这个样子,所以取一个自己常用的,有代表性的 username。如果已经有了可以进行下一步。
4.2.新建一个仓库
4.3.设置仓库信息
Repository name设置为username.github.io,Description (描述)可以选填:
创建好仓库后稍作设置,就可以访问了:
5.Hexo 与 Github 关联
5.1.修改 Hexo 配置文件
文件位于xxxxx.github.io/_config.yml ,注意配置文件内的冒号后要有空格:
这里只要修改Deployment 部分,大家根据自己情况修改,不要照抄:
- # Deployment
- ## Docs: https://hexo.io/docs/deployment.html
- deploy:
- type: git #用 Git 发布
- repo: https://github.com/Timhbw/timhbw.github.io.git #刚刚在 Github 上创建的仓库的地址
然后安装安装 hexo-deployer-git:
- npm install hexo-deployer-git --save
然后一键部署,只需一条命令就能将网站部署到服务器上:
- hexo deploy
更多常用的命令:
- hexo clean && hexo g -s #清除、生成、启动
- hexo clean && hexo g -d #清除、生成、部署
- hexo new "postName" #新建文章
- hexo new page "pageName" #新建页面
- hexo generate #生成静态页面至public目录
- hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
- hexo deploy #将.deploy目录部署到GitHub
- hexo help #查看帮助
- hexo version #查看Hexo的版本
打开 GitHub 上你的仓库,刷新一下页面,然后访问 xxxxx.github.io,就可以看到你的博客了。
6.总结
到这里,简单的搭建一个完全免费的个人博客已经搞定。其实还是挺简单的,而且有官方文档,挺详细的,想要更多的设置,更加个性化,还有很多要做,一步一步来,先把整个框架搭起来,保证博客能访问。后面我会写一篇关于 Hexo 个性化设置的详细文章,以我的博客为基础,让大家也能够实时的看到效果。