经过一个下午的奋斗终于使用GitHub搭建了一个属于自己的博客,记录一下自己的搭建步骤.
其中用到的技术如果大家有兴趣可以了解下:
环境配置
上本就有对Hexo安装及使用的详细介绍,推荐。这里来讲述自己安装的亲身步骤,或有区别。
Node.js
用来生成静态页面。移步,下载,一路安装即可。
Git
用来将本地Hexo内容提交到Github上。Xcode自带Git,这里不再赘述。如果没有Xcode可以参考Hexo官网上的安装方法。
安装Hexo
当Node.js和Git都安装好后就可以正式安装Hexo了,终端执行如下命令:
$ sudo npm install -g hexo
输入管理员密码(Mac登录密码)即开始安装 (sudo
:linux系统管理指令 -g
:全局安装)
注意:Hexo官网上的安装命令是$ npm install -g hexo-cli
,安装时不要忘记前面加上sudo
,否则会因为权限问题报错。
初始化
终端cd到一个你选定的目录,执行hexo init
命令:
$ hexo init blog
blog
是你建立的文件夹名称。cd到blog
文件夹下,执行如下命令,安装npm:
$ npm install
执行如下命令,开启hexo服务器:
$ hexo s
此时,浏览器中打开网址,能看到如下页面:
本地设置好后,接下来开始关联Github。
关联Github
创建仓库
登录你的Github帐号,新建仓库,名为用户名.github.io固定写法,如CoderLGL.github.io即下图中所示:
本地的blog
文件夹下内容为:
_config.yml db.json node_modules package.jsonscaffoldssourcethemes
终端cd到blog
文件夹下,vim
打开_config.yml
,命令如下:
$ vim _config.yml
打开后往下滑到最后,修改成下边的样子:
deploy: type: git repository: https://github.com/CoderLGL/CoderLGL.github.io.git branch: master
你需要将repository
后CoderLGL
换成你自己的用户名 。
注意:在配置所有的_config.yml文件时(包括theme中的),在所有的冒号:后边都要加一个空格,否则执行hexo命令会报错 。
在blog
文件夹目录下执行生成静态页面命令:
$ hexo generate 或者:hexo g
此时若出现如下报错:ERROR Deployer not found: git则执行命令:npm install hexo-deployer-git --save 若无报错,自行忽略此步骤。
再执行配置命令:
$ hexo deploy 或者:hexo d
注意:若执行命令hexo deploy
仍然报错:无法连接git或找不到git,则执行如下命令来安装:
$ npm install hexo-deployer-git --save
再次执行hexo generate
和hexo deploy
命令。
然后继续报错。。。。。。。。
一脸怨念
网上找了好多办法都没解决,最后hexo clean
然后hexo g
,hexo d
...就这样解决了,这里建议大家一定要多尝试,多在网上找解决方案。
hexo deploy
命令执行成功后,浏览器中打开网址http://CoderLGL.github.io
(将CoderLGL
换成你的用户名)能看到和打开http://localhost:4000
时一样的页面。
为避免每次输入Github用户名和密码的麻烦,可参照第二节方法
添加ssh key到Github
检查SSH keys是否存在
执行如下命令,检查SSH keys
是否存在。如果有文件id_rsa.pub
或id_dsa.pub
,则直接将SSH key
添加到Github
中,否则进入下一步生成SSH key
。
生成新的ssh key
执行如下命令生成public/private rsa key pair,注意将your_email@example.com
换成你自己注册Github的邮箱地址,在这一步一路按回车,什么也不要填。
$ ssh-keygen -t rsa -C "your_email@example.com"
默认会在相应路径下(~/.ssh/id_rsa.pub
)生成id_rsa
和id_rsa.pub
两个文件。
将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
绿色按钮即可。
发布文章
终端cd到blog文件夹下,执行如下命令新建文章:
$ hexo new "postName"
名为postName.md
的文件会建在目录/blog/source/_posts
下,postName
是文件名,为方便链接不建议掺杂汉字。你当然可以用Markdown编译器来写文章。
文章编辑完成后,终端cd到blog文件夹下,执行如下命令来发布:
hexo generate //生成静态页面hexo deploy //将文章部署到Github
至此,Mac上搭建基于Github的Hexo博客就完成了。下面的内容是介绍安装theme和绑定个人域名,如果有兴趣且还有耐心的话,请继续吧。
安装theme
你可以到去搜寻自己喜欢的theme
。这里以NexT为例,你可以查看自定义自己喜欢的功能。
.