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

2021-08-13 14:40:51 浏览数 (1)

大家好,我是辰哥~

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

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

访问地址: https://liyunchen.github.io

01

环境准备

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

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

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

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

3、输入:git --version

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

2.安装node.js 官方地址:https://nodejs.org/en/download/

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

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

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

3.安装Hexo 安装命令:npm install hexo -g

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

4.安装hexo依赖 命令:npm install --save hexo-deployer-git

02

git配置SSH key

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

为什么要配置SSH key? 目的:可以免密的将本地的源码和资源上传到github,无需要每次都输账号和密码。

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

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

再次查看

可以看到提示:/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 "邮件地址"后。连续回车三次即可

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

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

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

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

点击 Add SSH key

测试是否成功: ssh -T git@github.com

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

配置账号和密码

代码语言:javascript复制
$ git config --global user.name "liyunchen" #你的github用户名
$ git config --global user.email "xxx@163.com" #填写你的github注册邮箱

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

03

搭建个人博客

1.新建博客

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

代码语言:javascript复制
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:公众号722

进入到本地博客存放目录 初始化 个人博客 命令:hexo init

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

#生成静态网页 命令:hexo g #预览 命令:hexo s

报错解决: 问题:hexo g报错,line.mathALL is not funciton问题解决 原因:nodejs版本低于12 解决:两种方法 方法1)请将nodejs升级到高于12.0.0的版本 方法2)config.xml中的 highlight->enable的值从true更改为false,这样可以避免异常。

在浏览器这访问: http://localhost:4000/

可以看到访问没问题。

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

2.部署到github

新建一个github仓库

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

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

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

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

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

代码语言:javascript复制
deploy:
  type: git
  repository: git@github.com:liyunchen/liyunchen.github.io.git
  branch: main

repository仓库地址改为自己的

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

发布到github 命令:hexo d

在浏览器访问 https://liyunchen.github.io/

可以看到成功访问

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

04

编写博客

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

新建一篇名为:chenge-first-blog的博客 命令:hexo new 'chenge-first-blog'

查看对应的文件夹

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

默认的内容是这样的:

代码语言:javascript复制
---
title: chenge-first-blog
date: 2021-07-22 14:08:14
tags:
---
这里方开始编写正文

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

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

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

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

1.生成html文件 hexo g 2.上传到github hexo d

再次访问:

https://liyunchen.github.io/

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

05

小结

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

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

访问地址: https://liyunchen.github.io

end

0 人点赞