搭建hexo在git上的个人博客

We believe that writing is about content, about what you want to say – not about fancy formatting.

我们坚信写作写的是内容,所思所想,而不是花样格式。
— Ulysses for Mac

虽然我用的是macdown

咱的第一篇文章就写这个博客的搭建过程吧

(当然也是第一次用markdown写文章)

著作权归罪歌moecopilot本人所有。商业转载请联系作者 QQ 1993713026 获得授权,非商业转载请注明出处。
Moecopilot is the original author. Please give credit to the original author when you use it elsewhere.

搭建hexo

(其实也可以去看hexo的官方文档)

以下为MacOS下的hexo安装过程
  1. 首先hexo是基于nodejs的,所以必须安装nodejs
  2. 安装nodejs方法很多,我选择homebrew安装方式,所以需要安装它
  3. 安装homebrew就很简单了,mac自带ruby脚本功能,一句话搞定
  4. hexo提交部署github需要使用git工具,所以需要安装git,用homebrew的话也是一句话搞定
  5. OK整理一下安装顺序:homebrew-nodejs-hexo-git
  6. 上面这段是我抄的……原文这里

安装brewhome

ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)”

安装nodejs

brew install node

安装hexo

npm install -g hexo

安装git

sudo brew install git

于是安装环境就已经准备好啦,接下来我们搭建博客的本地目录

初始化hexo

创建一个文件夹作为博客的本体QAQ
进入其目录执行hexo

hexo init

生成静态页面

hexo generate

并本地渲染启动

hexo server

这样hexo就已经运行了,浏览器进入http://localhost:4000

他们说直接编译渲染的话会出问题(嗯我这里啥问题都没出)

常见的HEXO配置错误(由于我没有问题所以这段借鉴的这里

ERROR Plugin load failed: hexo-server

原因: Besides, utilities are separated into a standalone module. hexo.util is not reachable anymore.

解决方法,执行命令:$ sudo npm install hexo-server

执行命令hexo server,提示:Usage: hexo< Command> ….
原因:我认为是没有生成本地服务
解决方法,执行命令: npm install hexo-server –save
提示:hexo-server@0.1.2 node_modules/hexo-server….
表示成功了参考https://hexo.io/zh-cn/docs/server.html
这个时候再执行:$ hexo-server

得到: INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

这个时候再点击http://0.0.0.0:4000,正常情况下应该是最原始的画面,但是我看到的是: 白板和Cannot GET / 几个字

原因: 由于2.6以后就更新了,我们需要手动配置些东西,我们需要输入下面三行命令:

npm install hexo-renderer-ejs --save
npm install hexo-renderer-stylus --save
npm install hexo-renderer-marked --save

再生成静态页面并启动本地服务器

hexo generate
hexo server

配置Github

建立Repository与本地的关联

建立与你用户名对应的仓库,仓库名必须为【your-user-name.github.io】
然后用编辑器打开本地博客本体的根目录下的_config.yml
这个配置文件就是这个博客全局的设置,我们先来挂上git
最下方找到deploy项并改成下面这样子:

deploy:
type: git
repository: https://github.com/【user-name】/【user-name】.github.io.git
branch: master

执行如下命令部署git
npm install hexo-deployer-git --save

上传配置
hexo deploy

至此,只需每次把文章放入source文件夹中对应的文件夹再
hexo clean
hexo generate
hexo deploy
就可以了

hexo的常用命令有

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的版本

以上。

著作权归罪歌moecopilot本人所有。商业转载请联系作者 QQ 1993713026 获得授权,非商业转载请注明出处。
Moecopilot is the original author. Please give credit to the original author when you use it elsewhere.