Hexo-Github静态博客搭建

环境配置

  1. 前言
    Hexo是一个基于Node.js的静态博客程序,可以方便的生成静态网页托管在github和Heroku上。作者是来自台湾的tommy351

  2. 安装Node.js
    Node.js下载地址
    Node.js安装流程
    安装完成后,执行 node --version和npm --version 命令,如果输出如下图所示结果,就代表安装成功了。

    Paste_Image.png

    git的安装和github账户的注册和配置我在这里就不在赘叙了。

使用GitHub Pages建立博客

GitHub账号建立好之后,就可以方便的使用它提供的Pages服务,GitHub Pages分两种,一种是你的GitHub用户名建立的username.github.io这样的用户&组织页(站),另一种是依附项目的pages。想建立个人博客用的是第一种,形如cytmxk.github.io这样的可访问的站,每个用户名下面只能建立一个。

  1. github上建立仓库
    登录后系统,在github首页,点击页面右下角「New Repository」


    Paste_Image.png
  2. 填写项目信息:
    project name:cytmxk.github.io
    注:Github Pages的Repository名字是特定的,比如我Github账号是cytmxk,那么我Github Pages Repository名字就是cytmxk.github.io。
Paste_Image.png

点击「Create Repository」 完成创建。

安装和配置Hexo

  1. 执行如下命令安装hexo
    $ npm install -g hexo
  2. 搭建本地博客
    $ hexo init blog
    上面的命令会在当前目录下创建一个blog目录,用来存放构建静态网页的资源,目录结构如下所示:
    Paste_Image.png

    其中source文件夹就是用来存放MarkDown文件的,默认会存放一个hello-world.md文件。
    执行如下命令将source中的MarkDown文件生成相应的html文件:
    $ hexo generate
    执行上面的命令后,多了一个public目录,该目录就是用来存放生成的html文件,目录结构如下图示:
    Paste_Image.png

    在部署到github上之前,需要将资源库cytmxk.github.io配置到_config.yml文件中,具体配置如下所示:
    deploy:
    type: git
    repo: git@github.com:cytmxk/cytmxk.github.io.git
    branch: master
    执行如下命令将public文件夹中存放的html文件部署到资源库cytmxk.github.io中:
    $ hexo deploy
    执行完上面的命令后会生成一个.deploy_git的目录,该目录实际上存放的实一个git资源库,对应的远程资源库就是_config.yml文件中配置的资源库,目录结构如下图所示:
    Paste_Image.png

    打开浏览器输入https://cytmxk.github.io/
    就可以看到自己的博客首页了,至此一切好像大功告成了,但是还有一个问题没有解决,就是多台电脑之间博客同步的问题。

多台电脑之间博客同步

我们通过 hexo deploy会将public目录(html文件)自动push到远程仓库的master分支。但这个对多终端博客同步没有任何意义,因为我们每次hexo generate都会根据source目录下的markdown源文件重新生成html文件,所以解决问题的关键是怎么同步source目录下的源文件,不仅如此,还有配置文件_config.yml,依赖包记录文件package.json,scanffolds目录,themes目录。

  1. 首先我们进入到博客系统的根目录,比如blog目录,这里边有个.gitignore文件(如果该文件不存在,自己创建一个),里边默认已经把该忽略的目录文件都写好了,里边内容如下:


    Paste_Image.png
  2. 然后在blog目录初始化仓库,切换到source分支,关联远程仓库,并push到远程仓库的source分支:
    $ cd blog
    $ git init
    $ git checkout -b source
    $ git add .
    $ git commit -m "first commit"
    $ git remote add origin git@github.com:cytmxk/cytmxk.github.io.git
    $ git push origin source
  3. 操作完成后,在另外一台电脑上,首先按照上面的进行环境配置,然后创建
    注意不要再执行:
    $ hexo init blog
    取而代之的是
    $ git clone -b source git@github.com:cytmxk/cytmxk.github.io.git
    $ npm install //根据package.json来下载依赖包
    执行上面的命令就把远程仓库的source分支克隆下来并且安装依赖包。接下来我们就可以继续写博客了
    $ hexo new "about hexo sync"
    $ hexo generate$ hexo deploy
    $ git add .$ git commit -m "add blog"
    $ git push origin source
    这样就完成了多终端的博客同步。

遇到的问题

  1. 执行 hexo deploy 报错,如下图所示:


    Paste_Image.png

    上面的报错是由于依赖包hexo-deployer-git没有安装,所以执行如下命令安装即可:
    $ npm install hexo-deployer-git --save

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 222,252评论 6 516
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,886评论 3 399
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 168,814评论 0 361
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,869评论 1 299
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,888评论 6 398
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,475评论 1 312
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 41,010评论 3 422
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,924评论 0 277
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,469评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,552评论 3 342
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,680评论 1 353
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,362评论 5 351
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 42,037评论 3 335
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,519评论 0 25
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,621评论 1 274
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 49,099评论 3 378
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,691评论 2 361

推荐阅读更多精彩内容