小白教你在Ubuntu上用Hexo搭建博客托管到github

网上关于这个的教程非常多,今天我自己尝试一下,感觉教程讲得非常明白,但自己实践起来总是没有那么的一帆风顺,会遇到这样那样的问题,所以写点东西记下来,以防自己下次再碰到,或者可以及时救出跟我掉进同个坑里的朋友。

什么是Hexo

hexo是一个基于Node.js的静态博客程序,可以方便的生成静态网页托管在github和Heroku上。Hexo更加简单优雅, 而且风格多变, 适合程序员搭建个人博客,而且支持多平台的搭建。

1. 安装Nodejs

nodejs是一个js的框架,因为Hexo依赖于这个框架,所以要使用Hexo必须先安装它。

ubuntu上安装

本人比较懒,一般可以简单安装就不想去麻烦。和一般冉欢类似,在Ubuntu上Node也可以用apt-get安装

$ sudo apt-get install nodejs
$  sudo apt-get install npm

当然也有源码编译安装的方法。

windows用户

用户可以直接用exe文件安装(又是偷懒的办法,哈哈),具体可以参考Nodejs安装

2.安装Hexo

正式安装Hexo

$ sudo npm install -g hexo

初始化

$ hexo init

到这一步,其实Hexo的安装都已经完成了,下面是来显示它的步骤

Hexo设置

$ hexo g    #生成静态网页
$ hexo s    #运行本地服务器  

关于hexo 的命令,和命令的缩写下面会讲。顺利的话会出现

INFO  Start processing
INFO  Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

此时说明你已经安装成功了,在浏览器地址栏输上http://localhost:4000就能出现默认主题的博客界面了。

主题更改

我使用的是next主题,大家的评论还是非常不错的。

安装主题

$ hexo clean
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

更新主题

修改Hexo目录下的_config.yml,在theme属性上,将其设置为next,默认是landscape。

$ cd themes/next
$ git pull
$ hexo g
$ hexo s

现在重新打开http://localhost:4000/ ,就发现新的主题安装成功了。
next主题的配置方法作者都非常全,Hexo官方配置教程

hexo 常用命令

1. $ hexo g == hexo generate #生成静态网页
2. $ hexo d == hexo deploy  #部署
3. $ hexo s == hexo server  #启动服务器

安装配置github

安装git

ubuntu系统一般都自带的git,如果没有可以通过这个命令

 sudo apt-get install git

要是不知道有没有安装,也可以在命令行里输入这个安装命令,如果你有安装会告诉你git已经是最新版本了。
windows用户可以在Git官网下载安装就可以。安装完成后出现Git Bash了就说明成功了。

配置github

在命令行里输入

$ git config --global user.name "yourName"
$ git config --global user.eamil "email@example.com"

ubuntu直接在命令行里输入,windows在Git Bash 里输入,其中yourname 是输入你自己的用户名,email@example.com输入你自己的注册邮箱。

创建公钥

输入

ssh-keygen -C 'you email address@gmail.com' -t rsa

这里的C必须大写,之后你可以一直按回车,直到出现


之后会在用户目录 ~/.ssh/ 下建立相应的密钥文件,即 ~/.ssh/id_rsa.pub ,打开该文件,在下面一步有用。

添加公钥

还是在github首页右上角点击头像,选择Settings,然后选择New SSH KEY,把上面一步id_rsa.pub文件的秘钥复制进去就好了。


rsa.png

创建项目仓库

登录Github官网,点击右上角的+,选择New repository。
在页面里输入github账户名.github.io只能这么填,不能改,例如我的是**tofulife.github.io填完后点击Create repository即可。

respository.png

现在github也配置完了。。。

部署到github

打开hexo 目录下的_config.yml

$ sudo gedit _config.yml

到最底下,改成这样子,注意:后面一定要空格

deploy:
  type: git
  repository: https://github.com/tofulife/tofulife.github.io.git
  branch: master

把其中的tofulfie改成你的username。另外,还需要装个Hexo的插件才能push到git上。

npm install hexo-deployer-get --save

现在你就可以浏览器上输入,yourname.github.io访问的你的博客了。

掉进的坑

网页404

总是会有些坑一直等着你跳。我的git也配置好了,Hexo也能在本地打开,但就是push不到git上,一直显示404。使用

$ hexo d 

提示“无法推送一些引用到 'git@github.com:tofulife/tofulife.github.io.git'”其实到现在我也不知道原因。


网上有教程说,不用deploy,直接通过git命令push上去,但是还是提示错误。
后来我用这些命令重新来了一遍

$ hexo clean
$ hexo generate
$ hexo deploy

竟然成功了,现在我知道估计是deploy文件有问题,但是具体什么问题不清楚。如果有“坑友”跟我遇到一样的问题,或者类似的问题,可以试试上面的命令,重新把Hexo部署一般,希望能帮到你。


接下来就是博客的配置了,发现博客有好多东西可以玩,例如,浏览量,评论等,抽时间自己配置完了再写哈!

最后我有参考下面的文章

  1. Hexo搭建独立博客,托管到Github和Coding上教程
  2. 手把手教你使用Hexo + Github Pages搭建个人独立博客

感谢这样的大神,让我们小白涨姿势。

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

推荐阅读更多精彩内容