既然是Hexo + github,那么首先得准备这两个平台。(此文章基于读者已懂github使用及熟悉基本git命令,所以就不赘述github的知识了。),直接上干货!
##1、安装Hexo##
下面我默认从安装node.js工具命令开始 —mac版:
[[ -s $HOME/.nvm/nvm.sh ]] && . $HOME/.nvm/nvm.sh # This loads NVM
- 意思就是要在mac 的 ~/.bash_profile 文件中配置一下nvm环境。其中,若配置未成功,请尝试:把‘. $HOME/.nvm/nvm.sh’ 改成:‘source ~/.nvm/nvm.sh’。
ls -a | grep .nvm
If you’re missing that folder then the installation failed to run the git command. This could be due to being behind a proxy. Try running the following instead.
$ git clone http://github.com/creationix/nvm.git .nvm
3、nvm安装好后,使用nvm命令安装node.js:,命令是:
$ nvm install 0.12
4、node.js安装好后,使用npm命令安装hexo client,命令是:
$ npm install hexo-cli -g
这样hexo就安装好了,接下来的,就是设置hexo了,可参考Hexo官方文档–设置
以上4个步骤,就完成了npm命令安装hexo client的工作。
##2、hexo的项目搭建及部署##
1、建站:
安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。
$ hexo init <folder>
$ cd <folder>
$ npm install
你会发现敲完上面的命令后,你的当前目录下会生成一个你指定的文件夹,即上述的folder 。
而npm install命令是会再这个folder下创建:node_modules文件,并且在这个文件中下载很多关于hexo的插件。
其中关键的有hexo和hexo server,从文件夹就可以看出,前者是hexo的主要部分插件,后者时hexo本地服务器插件,稍后本地查看时会用到。
2、配置:
打开初始化的指定文件,会看到根目录下有一个_config.yml配置文件,我们称它为“站点配置文件”,因为根目录下的themes文件下的主题文件目录下,也有一个_config.yml文件,我们称它为“主题配置文件“。
配置这个站点文件,可参考配置教程,
这里我要提点比如重要的地方:
#URL的配置部分
url: http://yoursite.com
root: /
我们是在github上创建blog,所以url设置为访问你的blog时的主页地址,即’你的用户名.github.io‘,别忘了加’http://',比如我的:
#If your website is in a subdirectory (such as http://example.org/blog) set url to http://example.org/blog and set root to /blog/.我们的操作没有涉及到子目录
url: http://qingsong-xu.github.io
root: /
如果上面你乱在后面家了child目录,可能会导致主题应用失败。我就碰到了这个问题!!
另外要注意发布的配置部分,在通常在_config.yml文件内容最末尾:
deploy:
type: git
repo: git@github.com:qingsong-xu/qingsong-xu.github.io.git #库地址
type对应的值,我们设为git,代表将要发布到git服务器上,repo代表仓库地址,也就是我们在github上会创建一个’你的用户名.github.io’仓库,这里的值就是这个仓库地址,可以是https格式,也可以是ssh格式,使用ssh格式地址的话,就不会提示用户名密码验证,所以我用的是ssh格式的库地址。
这里我使用的是默认主题,所以没有更改。theme: landscape
3、生成并且部署提交到git:
涉及的命令:
(1)生成:
$ hexo generate #生成命令,将搭建的文件生成git服务器能展示的静态文件:js、css等。
(2)部署:执行下列命令之前,我们需要先安装部署到git服务器的插件,它也是在初始化文件的node_modules文件中,未安装时,你在这个文件中,只能看到hexo服务器及生成插件等文件目录。所以下面先执行命令安装 hexo-deployer-git:
$ npm install hexo-deployer-git --save
这时node_modules目录下会生成文件hexo-deployer-git,这些命令都是在你’初始化的文件根目录下‘执行。
至此,你已经完成了从建站到发布的整个流程。现在我们来看效果吧!
先进行本地测试看看效果:再强调一遍,是在初始化根目录下执行命令。
(1)、启动本地服务器:$hexo s –debug (意思是启动服务,并打开debug模式)
(2)访问:0.0.0.0:4000 进行访问看效果,4000是默认端口,可以修改,修改方式请看官方文档
成功了吗?!哈哈
##关于github仓库的建立##
##拓展—-切换主题##