利用GitHub搭建一个你的博客

Photo From Google

为什么要写博客
作为一只程序猿,踩到坑是一件非常正常的事,当我们踩到坑的时候就会花心思去研究它,可能我们能够在当时把问题弄懂并把问题给解决掉。可是过一段时间我们又遇到了同样的坑的时候,难道还要再去 百度 Google 重新搜索一遍吗?这样做效率难免太低了,倒不如在第一次解决问题的时候就把解决方法写到我们的博客了,当我们再一次遇到相同的坑的时候翻一翻我们之前写的博客就能快速的把问题给解决掉,何乐而不为。而且我们学习新技术的时候也可以将当时学到的内容写到我们的博客,再次遇到的时候我们就可以找回当时学习的思路,继续学习。废话不多说,马上开始行动起来,搭建博客!

声明:本文在Windows下进行操作的,Mac以及其它操作系统请做参考 多图警告!

如果你觉得太麻烦,欢迎 Fork/Star 我的 GitHub 但是环境搭建以及怎么使用命令还是要看一看的。

1. 环境搭建

首先需要下载两个东西

  • node.js
  • git

具体的下载,安装就不用多说了,基本上下载完默认安装即可,安装的路径最好先记住。Git 安装的时候会弹出下面的窗口,我们选择第二个即可。这样我们在Windows的命令窗口也可以进行Git操作了。

Git Setup Detail
两个都安装完了之后,打开命令窗口(按住Win+R后输入CMD即可打开命令窗口),分别输入 node -vnpm -vgit --version 这三个命令是为了查看刚才我们安装的软件的版本,如果你能够看到他们的版本号(如同下图,也许版本号会有不同),那么恭喜你,环境搭建这一个大难关你已经过了,可以进入下一步骤了。
Check Version

1.1 有问题看这里

打开我们刚才安装软件的路径,例如我的路径“D:\Program Files\nodejs”、“D:\Program Files\Git”。
复制我们刚才安装的路径,打开计算机>右键单击属性,选择高级系统设置>选择环境变量>双击 PATH >将我们安装的路径追加到变量值之后 !注意分号以及确定保存
这个时候再试一下 node -vnpm -vgit --version 这三个命令,一般都不会有问题的了。

PATH

2. 配置 GitHub

2.1 注册 GitHub

先到GitHub官网Sign up(注册)一个账号。

填好用户名、邮箱、密码进入下一步

2.2 SSH授权

注册好账号之后我们可以随意的查看其他人的项目,甚至是clone下载,但是要提交代码就必须完成SSH授权,如果可以不用授权就提交代码的话,那么Github岂不是乱了套。

2.2.1.生成SSH key

打开Git Bash,输入ssh-keygen -t rsa然后按三下回车,如下图所示

接着就会在C:\Users\Administrator.ssh目录下生成到id_rsa和id_rsa.pub两个文件,id_rsa是密钥,id_rsa.pub是公钥,接下来需要将id_rsa.pub的内容添加到GitHub上,这样本地的id_rsa密钥才能跟GitHub上的id_rsa.pub公钥进行配对,才能够授权成功。

2.2.2.在GitHub上添加SSH Key

首先点击右上角的倒三角进入Settings

紧接着选择左侧SSH and GPG keys,然后选择右上角的New SSH key,再把id_sra.pub的内容复制粘贴到key(id_sra.pub可以使用 sublime 或者 记事本打开),最后Add SSH key就可以了。
SSH key 添加成功之后,输入ssh -T git@github.com进行测试,如果出现以下提示证明添加成功了。

这一步一般没什么问题,有问题的话留言评论(顺便来一波打赏)就好了。直接进入下一步!

3. 创建 GitHub 仓库


需要特别注意的是,项目名称一定要使用 你的名字 + .github.io
这一步也没什么问题,如果有问题,一定是你没有给我打赏(∩_∩)

4. 设置本地博客的配置

4.1 安装Hexo

在你认为合适的地方创建一个文件夹,然后在文件夹空白处按住 Shift+鼠标右键,然后点击在此处打开命令行窗口。(同样要记住啦,下文中会使用在当前目录打开命令行来代指上述的操作)
在命令行输入npm install -g hexo

然后输入 npm install hexo --save 这时候你会看到命令窗口刷了一堆白字,然后输入 hexo -v 查看hexo是否安装成功了。
如果出现与上图一样的情况的话,就说明你离成功就近在咫尺了。

4.2 初始化Hexo

同样是在命令窗口中,继续输入 hexo init,等待下载好了之后输入 hexo s


这时候我们就可以打开浏览器了,在地址栏中输入 http://localhost:4000/ 我们就可以看到如下图的界面,这个就是我们的博客。没错,我们的博客就这样建好了。不过这个只是我们本地的博客,下面就要考虑怎么把我们的本地博客上传到我们的GitHub上了。

接下来先看一下我们的博客文章放在哪里。打开我们的文件夹下面的source文件夹,你会发现里面有一个_posts文件夹,再进入就会看到一片初始化的文章hello-world.md也就是上图显示在页面的文章。如果我们想新建文章的话,可以通过命令窗口输入hexo new 'filename'我们的文件夹下面就会生成一个新的md文件,然后我们打开编辑就可以了。

4.3 发布博客

首先复制我们的GitHub项目地址,如下图。

然后打开我们新建的文件夹下面生成的_config.yml文件,在最下方作如下修改。

deploy 是部署的意思,type: git 就是使用 git 进行部署,repo: github仓库地址

注意:repo 原本是没有的,在最后自己加上就好。冒号之后有一个空格 冒号之后有一个空格 冒号之后有一个空格

接下来回到命令窗口,输入 npm install hexo-deployer-git --save

安装好Git上传插件之后,输入 hexo g,然后输入 hexo d就可以将我们的博客上传到我们的GitHub了,而且以后更新文章就只需要用这两个命令就可以了。这样别人也可以通过 https://yourname.github.io 来访问我们的博客了(开头一定要用https,yourname是你的github的名字)。

5. 个性化设置(更换主题)

有木有觉得这个博客的默认主题特别的丑,如果不觉得可以忽略这一步(哈哈)。
这里以我使用的主题为例。
第一步去找我们想要的主题,然后下载下来。我用的是next主题,在命令窗口输入git clone https://github.com/iissnan/hexo-theme-next themes/next


然后打开配置文件,找到 theme 将原来默认的 landscape 替换 next。然后在命令窗口输入 hexo cleanhexo ghexo s,先看一下本地博客是什么样子,确认好了在输入 hexo d 部署到GitHub

每一个主题都有一个使用文档,next的使用文档为 http://theme-next.iissnan.com/getting-started.html 我们可以为我们的主题修改名字,添加评论等等,具体的你们就自己去研究了。如果你们觉得太麻烦的话,欢迎大家直接 Fork 我的,地址为 https://github.com/AD-feiben/hexo 当然里面的也有大家要修改的地方。

如果文章对你有所帮助,那么请您点一下❤
由于本人水平有限,如有错误,欢迎大家指正。如果你在操作过程中发现一些没有讲到的错误或者问题,欢迎在评论留言,一起探讨,共同学习进步!
有钱的来波赞赏,没钱的帮忙宣传一下(上不了首页!)

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

推荐阅读更多精彩内容