由于最近刚搭建的博客,所以特此来记录下我的个人经验。注:本文使用的环境为Mac OS。Windows的也基本差不多,可以参考。
环境配置
需要安装的工具包括:Node.js, Git, Hexo。
1. 安装Node.js
用来生成静态页面,建议Node.js官网下载,然后一路安装即可。
2.安装git
用来将本地Hexo内容提交到Github上。Xcode自带Git,这里不再赘述。或者点击安装程序来下载安装git.
3.安装Hexo
以上都安装完毕后之后就可以安装Hexo, Hexo 是一个快速、简洁且高效的博客框架。终端命令:
$ sudo npm install -g hexo-cli
这里要需要输入管理员密码(Mac登录密码)即开始安装 (sudo:linux系统管理指令 -g:全局安装)
接下来在你磁盘上新建一个文件夹,比如"Hexo"然后cd到这个目录下,执行hexo init命令:
$ hexo init blog
blog是你建立的文件夹名称。cd到blog文件夹下,执行如下命令,安装npm:
$ npm install
现在已经搭建起一个本地博客了,接着输入一下命令生成静态文件:
$ hexo g
然后输入如下命令:
$ hexo s
启动服务器。默认情况下,访问网址为:http://localhost:4000/。(control+c停止)
关联GitHub
首先登录你的Github帐号,没有的可以先去注册下,这里就不多说了。
1.创建仓库
在github首页,新建仓库,用户名.github.io固定写法,如下图所示:
然后点击Create Repostory完成。
终端cd到blog文件夹下,vim打开_config.yml,(也可使用编辑器打开)命令如下:
$ vim _config.yml
打开后往下滑到最后,修改成下边的样子:
deploy:
type: git
repository: https://github.com/username/username.github.io.git
branch: master
你需要将repository后username换成你自己的用户名,需要注意的是冒号后面都有一个空格
在blog文件夹目录下执行生成静态页面命令:
$ hexo generate 或者:hexo g
此时若出现如下报错:
ERROR Local hexo not found in ~/blog
ERROR Try runing: 'npm install hexo --save‘
则执行命令:
npm install hexo --save
若无报错,自行忽略此步骤。
再执行配置命令:
$ hexo deploy 或者:hexo d
若执行命令hexo deploy仍然报错:无法连接git或找不到git,则执行如下命令来安装hexo-deployer-git:
$ npm install hexo-deployer-git --save
再次执行hexo generate和hexo deploy命令。
若你未关联Github,则执行hexo deploy命令时终端会提示你输入Github的用户名和密码,即
Username for 'https://github.com':
Password for 'https://github.com':
hexo deploy命令执行成功后,浏览器中打开网址http://jimmyju.github.io(将jimmyju换成你的用户名)能看到和打开http://localhost:4000时一样的页面。
2.添加ssh key到Github
1.执行如下命令生成ssh key:
$ ssh-keygen -t rsa -C "your_email@example.com"
注意将
your_email@example.com
换成你自己注册Github的邮箱地址。
默认会在相应路径下(~/.ssh/id_rsa.pub)生成id_rsa和id_rsa.pub两个文件。
2.添加ssh key到github中:
Find前往文件夹~/.ssh/id_rsa.pub打开id_rsa.pub文件,里面的信息即为SSH key,将这些信息复制到Github的Add SSH key页面即可。
进入Github –> Settings –> SSH keys –> add SSH key:
Title里任意添一个标题,将复制的内容粘贴到Key里,点击下方Add key绿色按钮即可。
3.接下来就是发布文章了,终端cd到blog文件夹下,执行如下命令新建文章:
$ hexo new "postName"
名为postName.md的文件会建在目录/blog/source/_posts下,postName是文件名,为方便链接不建议掺杂汉字。你当然可以用vim来编辑文章。我用的MWeb编辑器,如果你有好用的markdown编辑器请推荐给我,感激不尽!
注:文章编辑完成后,终端cd到blog文件夹下,执行如下命令来发布:
$ hexo generate 可简化成:hexo g
//生成静态页面
$ hexo deploy 可简化成:hexo d
//将文章部署到Github
至此,Mac上搭建基于Github的Hexo博客就完成了。
博客主题
下面就说一下安装主题的方法,这里可以你可以到Hexo官网主题页去搜寻自己喜欢的theme。这里以hexo-theme-next为例, 注意: 每根换一次主题之前,运行如下命令:
$ hexo clean //清除缓存文件
1.终端cd到 blog 目录下执行如下命令:
$ git clone https://github.com/iissnan/hexo-theme-next themes/next
然后将blog目录下_config.yml里theme的名称landscape修改为next
2.终端cd到blog目录下执行如下命令(每次部署文章的步骤):
$ hexo clean //清除缓存文件 (db.json) 和已生成的静态文件 (public)
$ hexo g //生成缓存和静态文件
$ hexo d //重新部署到服务器
至于更改theme内容比如名称、描述、头像等去修改blog/_config.yml文件和blog/themes/next/_config.yml文件中对应的属性名称即可, 不要忘记冒号:后加空格。 NexT 使用文档里有极详细的介绍。
后记
以上便是我博客的全过程。。。。。