hexo博客搭建和配置

原文地址

前言

从工作开始,一路过来都是在学习。由于不是计算机专业,所以只能比其他人更勤奋才行。从刚进公司学习.net,到后来业务需要而接触web前端、cordova、H5等,各种全新的知识给我带了极大的冲击。感觉接触到的知识太乱,天天都是在迷迷糊糊中学习忘记,忘记学习。后来决定开始做一些备忘,于是就在博客园上开始记录一些东西。用了一段时间后,觉得在博客园上编辑太繁琐,翻出来查看时太麻烦,再加上刚接触Markdown,所以很想直接用Markdown来编辑记录,于是找到了Hexo + GitHub Page建立个人博客

准备

  • 硬件:MacBook Pro
  • 软件:Git + Node.js + homebrew + GitHub帐号

以上准备请自行百度,这里不赘述

创建GitHub仓库

1. 注册帐号(此步跳过)

2. 创建代码库

屏幕快照 2016-07-12 16.47.57.png

3. 填写信息

填写信息.png

4. 填写完后,创建成功后出现如下页面:

屏幕快照 2016-07-12 16.54.45.png

5. 设置,开启gh-pages功能

点击右上角的Settings,向下拖动,直到看到下图:

屏幕快照 2016-07-12 16.55.12.png

点击 “launch automatic page generator”,开启gh-pages功能

6. 生成默认github Page

屏幕快照 2016-07-12 18.44.31.png

7. 随便选择默认主题

屏幕快照 2016-07-12 18.53.52.png

配置SHH

打开GitHub,点击页面上方的齿轮按钮进入设置界面,点击左边的SSH keys,添加一个SSH keys。SSH keys的好处是让我们以后在本地进行操作并同步到GitHub上时不用输密码,那么如何配置SSH keys?

  1. 创建SSH Key

    • 打开终端,输入 ssh-keygen -t rsa -C "418120186@qq.com" 邮箱更新为自己的
    • 回车保存默认位置
    • 输入密码,用来加密私钥(以后就要用这个密码)
    image
    • 密钥存放在主文件夹的.ssh文件夹内
    • 打开文件备份 id_rsa(私钥) ; id_rsa.pub(公钥)两个文件,打开公钥,复制所有内容
  2. 与远程仓库绑定

    • 在远程服务器,如coding/github页面内找到添加公钥选项,粘贴刚刚复制的内容,添加即可.
    add-key.png
  3. 测试是否配置成功:

    ssh -T git@github.com

    如果返回的结果如下:

    屏幕快照 2016-07-12 22.40.58.png

    输入yes,就能看到

    屏幕快照 2016-07-12 22.42.01.png

    这样你的SSH key就配置完成了。

    到这里github仓库已经建好了。接下来是本地部分了。

Hexo

  1. 创建文件夹

    在自己认为合适的地方创建一个文件夹

  2. 安装Hexo

    打开终端,cd 到当前文件夹

    屏幕快照 2016-07-12 20.18.23.png

    输入 sudo npm install hexo-cli -g ,回车

    在命令行前面多加 sudo 是为了获取权限,可能需要密码(Mac才需要)

    屏幕快照 2016-07-12 20.20.32.png

    安装全局的hexo,可能你会看到一个WARN,但是不用担心,这不会影响你的正常使用。

    然后输入 sudo npm install hexo --save ,回车

    然后你会看到命令行窗口刷了一大堆白字,可能时间会比较久(若一直不行,请看最后面)。

    屏幕快照 2016-07-12 22.00.56.png

    最后输入 sudo hexo -v

    验证是否安装完成

    屏幕快照 2016-07-12 22.02.59.png
  3. 初始化Hexo

    接着上面的操作

    输入sudo hexo init

    然后再接着

    输入 npm install

    之后npm将会自动安装你需要的组件,只需要等待npm操作即可

    文件夹目录中最少含有以下几项:

    屏幕快照 2016-08-01 22.20.35.png
  1. 操作Hexo

    输入 sudo hexo generate,回车,也可以简写成 sudo hexo g

    生成静态文件。

    屏幕快照 2016-07-12 22.45.52副本.png

    输入 sudo hexo server,回车,也可以简写成 sudo hexo s

    启动服务器。默认情况下,访问网址为: http://localhost:4000/这时候,可以复制网址,打开浏览器,浏览到你刚建完的本地静态网站

  2. 部署网站

    修改配置,打开文件夹中的 _config.yml,这里说必须更改的项目

    • url(网址)

        url: https://a418120186.github.io/
        root: /Lion/
        permalink: :year/:month/:day/:title/
        permalink_defaults:
      
    • deploy(部署)

        deploy:
          type: git
          repo: git@github.com:a418120186/Lion.git
          ##在github对应项目中复制,选择shh和http都行
          branch: gh-pages
      

    以上两个是部署前必须配置的,其他配置详见官网文档

    然后输入 sudo hexo deploy,回车,也可以简写成 sudo hexo d

    随后按照提示,分别输入自己的Github账号用户名和密码,开始上传

    屏幕快照 2016-07-12 22.44.45.png

    然后通过https://a418120186.github.io/Lion/(更换为自己的地址)来访问刚刚上传的网站

  3. 常规操作

    • 打开Hexo目录下的source文件夹,所有的文章都会以md形式保存在_post文件夹中,只要在_post文件夹中新建md类型的文档,进行编辑。

    • 编辑完成后,执行sudo hexo g渲染成网页。

    • 再执行sudo hexo d部署新文件,这样就完成了一个操作。

    • 新建的文章头需要添加一些yml信息,如下所示:

      屏幕快照 2016-07-12 21.17.57.png
  4. 更换主题

    • Hexo Themes - http://hexo.io/themes/,选择喜欢的主题,复制github地址(这里以Next主题为例)

    • 输入sudo git clone https://github.com/iissnan/hexo-theme-next.git themes/next

    将主题克隆到themes文件夹

    • 修改_config.yml中的主题配置为:theme: next

    • 然后先执行sudo hexo clean,然后重新sudo hexo g,并且sudo hexo d,很快就能看到新主题的效果了~

相关知识

  1. 常见问题

    修改配置文件时注意YAML语法,参数冒号:后一定要留空格

    中文乱码请修改文件编码格式为UTF-8

  2. 勤学勤练Markdown

    本地+云端备份数据是一种习惯

    Markdown学习路径 - http://wsgzao.github.io/post/markdown/

  3. 使用性感的文本编辑器

    工欲善其事必先利其器

    Sublime Text - link

    Cmd Markdown - link

    大神整理的软件 - link

  4. 若遇见卡住不往下执行现象,更换 npmcnpm

    cnpm是淘宝提供的npm中国镜像加速,cnpm不仅可以加速npm上包的下载,也提供了镜像加速Node.js 源码的下载。https://npm.taobao.org/

    npm install -g cnpm --registry=https://registry.npm.taobao.org #可能需要sudo

    然后把上面包换npm的命令行都改为下面这种形式:

    sudo cnpm install -g hexo-cli

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

推荐阅读更多精彩内容