【保姆级】利用Github搭建自己的个人博客,看完就会

image

大家好,我是辰哥~

作为一名喜欢技术的爱好者,平时喜欢把自己学习技术的心得或者一些踩坑、易错的过程记录下来,首选的是技术平台(博客),今天辰哥来教大家如何利用Github来搭建一个自己的个人博客平台。

相信Github大家都有听过,甚至是经常用,除了可以作为开源源码的交流平台,还提供了搭建博客的功能。目前一些大佬、老师的博客用的就是Github搭建的(辰哥见过很多)

访问地址:

https://liyunchen.github.io

image

01、环境准备

在搭建Github博客之前,先准备一下环境(安装下方的顺序来安装,别弄混了)

1.安装git

官方地址:https://git-scm.com/

1、访问git官方地址,下载对应的安装包,进行安装(简单的点击下一步)。

2、安装好之后,鼠标右键可以看到:Git Bash Here,点击后打开了。

3、输入:git --version

image

出现这个说明git安装成功。

2.安装node.js

官方地址:https://nodejs.org/en/download/

1、访问nodejs官方地址,下载对应的安装包,进行安装(简单的点击下一步)。

2、安装好之后,配置环境变量,并在终端里面输入:node -v

image

出现这个说明nodejs安装成功~

3.安装Hexo

安装命令:npm install hexo -g

image

测试是否安装成功,命令:hexo -v

image

4.安装hexo依赖

命令:npm install --save hexo-deployer-git

image

02、git配置SSH key

相信看到本文的你应该听过github,并且也注册了自己的github账号,如果现在还没有的可以去github注册一个账号。

为什么要配置SSH key?

目的:可以免密的将本地的源码和资源上传到github,无需要每次都输账号和密码。

先看本地是否配置好SSH key(命令:cd ~/.ssh)

image

这里辰哥之前就配置了,现在删除配置,重新配置一边,方便读者可以跟着进行配置。

再次查看

image

可以看到提示:/c/Users/Administrator/.ssh: No such file or directory

备注:

因为ssh配置好之后是保存到 c:/用户/Administrator/.ssh

1.配置ssh

先生成ssh key

ssh-keygen -t rsa -C "邮件地址"

备注:这里的邮件地址是github账号绑定的邮件地址

输入生成命令:ssh-keygen -t rsa -C "邮件地址"后。连续回车三次即可

image

可以看到在用户文件夹下生成了一个ssh文件夹

image

进入到ssh文件夹,复制id_rsa.pub文件里全部内容

image

接着打开github主页,点击个人设置,点击左侧的SSH and GPG keys,点击New SSH key

image

将id_rsa.pub复制的内容粘贴到key中,title随便起一个就行。

image

点击 Add SSH key

测试是否成功:

ssh -T git@github.com

输入测试命令后,接着输入yes,出现下面这个提示说明成功

image

配置账号和密码

$ git config --global user.name "liyunchen" #你的github用户名
$ git config --global user.email "xxx@163.com" #填写你的github注册邮箱

备注:用户名和邮箱记得改为 自己的

03 搭建个人博客

1.新建博客

开始之前先介绍一下heox的基本命令

hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #部署到GitHub
hexo help  # 查看帮助
hexo version  #查看Hexo的版本

对应的缩写,比如:

hexo n == hexo new

hexo g == hexo generate

新建一个保存博客的存放目录,比如辰哥的是:D:\公众号\0722

进入到本地博客存放目录

初始化 个人博客

命令:hexo init

image

可以看到博客存放目录出现了如下内容:

image

生成静态网页

命令:hexo g

预览

命令:hexo s

image

报错解决:

问题:hexo g报错,line.mathALL is not funciton问题解决

原因:nodejs版本低于12

解决:两种方法

方法1)请将nodejs升级到高于12.0.0的版本

方法2)config.xml中的 highlight->enable的值从true更改为false,这样可以避免异常。

在浏览器这访问:

http://localhost:4000/

image

可以看到访问没问题。

但这个只是在本地预览,接着将这个博客部署到github。

2.部署到github

新建一个github仓库

image

给仓库起个名称,注意!注意!注意!

仓库名称格式: 用户名.github.io

辰哥的仓库名称为:liyunchen.github.io

因为这个仓库名称将作为你github博客的访问地址

image

编辑_config.yml,_config.yml在博客存放目录下

deploy:
  type: git
  repository: git@github.com:liyunchen/liyunchen.github.io.git
  branch: main

repository仓库地址改为自己的

branch看自己的github仓库是master还是main,辰哥这里是main,所以就填写main

image

发布到github

命令:hexo d

image

在浏览器访问

https://liyunchen.github.io/

image

可以看到成功访问

这个博客地址已经是部署到了公网,感兴趣的读者也可以访问

04 编写博客

搭建好博客之后,日常中肯定是需要编写博客并且同步到github,辰哥来带大家写一篇博客

新建一篇名为:chenge-first-blog的博客

命令:hexo new 'chenge-first-blog'

image

查看对应的文件夹

image

可以看到生成了一个chenge-first-blog.md文件,通过这个md文件去写博客

默认的内容是这样的:

---
title: chenge-first-blog
date: 2021-07-22 14:08:14
tags:
---
这里方开始编写正文
 
 

开始编写博客内容(markdown格式)

image

这里辰哥以之前的一篇文章为例

其中的,作用是在查看文章的时候,点击more的时候再加载全部的文章内容

编写好之后,开始部署到github

1.生成html文件

hexo g

2.上传到github

hexo d

再次访问:

https://liyunchen.github.io/

image

可以看到编写的博客已经同步到github平台,并且的作用也可以看到了:read more

05 小结

本文从0到1搭建了自己的个人博客,过程很详细,并且可能会出现的错误都做出了说明和解决方法。绝对的保姆级教程,看完就会

希望看到本文的你可以给辰哥一个赞,点个再看就更好了,鼓励原创作者不断前进。最后附上辰哥搭建好的博客地址,所有人都有可以访问。

访问地址:

https://liyunchen.github.io

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

推荐阅读更多精彩内容