GitHub搭建个人博客初始版

一、前言

       在这之前我就写博客,一直以来没有好的储存地址。在搭建的过程中遇到了很多困难。melog ，wordpress  等等 ，一点了解都没有导致满头雾水,不断的跳进一个又一个坑,甚至想过放弃，但最后还是决定自己搭建要不写一个，现在好了，纯属自己的博客网站。感谢GitHub

 

那么我为什么要建立自己的博客？

1.“提高将事情讲清楚的能力”.

2.分享带来的连锁反应

3.记录成长

4.探索未知的世界人和知识正在世界的某个角落在等着你。

5.帮助更多想要获取帮助的人

废话不多说开始-----文章有点长哦  >_<

二、开始搭建Github Pages

参考:傻瓜都可以利用github pages建博客
参考:手把手教你使用Hexo + Github Pages搭建个人独立博客

1.使用前了解Github

GitHub是一个共享虚拟主机服务，用于存放使用Git版本控制的软件代码和内容项目(引自维基百科）

2.为什么选择Github?

github有一个很有爱的项目，叫做github pages，这个项目是给开发者建立一个私人页面，上面用来分享新颖的想法和自己写的代码.

3.注册属于你自己的Github账号

首先进入Github站点,然后进行注册(此处不做详细说明可自行阅读github教程：[1]注册github)

注册完毕后你就拥有了自己的代码仓库了.

4.创建仓库

在Github首页右上角头像左侧加号点选择 New repositor(新存储库)或点击这里进行创建一个仓库.

5.开启Github Pages

 

往下翻

GitHub官方自带的模板

最好设置下

系统环境配置

要使用Hexo，需要在你的系统中支持Nodejs以及Git，如果还没有，那就开始安装吧！

二、Hexo

要使用Hexo,需要安装Nodejs以及Git

安装Node.js

下载Node.js                      参考:安装Node.js

安装Git

下载Git                              一路点击Next就行了.

安装Hexo

   详细命令请参考Hexo文档

    1.(新建一个文件夹【电脑的任何位置】)
    2.桌面右键选择 Git Bash
    3.先创建一个文件夹（用来存放所有blog的东西），然后cd到该文件夹下
    3.安装hexo命令npm install hexo-cli -g  或者 npm i -g hexo
    4.hexo init #初始化网站
    5.npm install
    6.hexo g #生成或 hexo generate
    7.hexo s #启动本地服务器 或者 hexo server,这一步之后就可以通过http://localhost:4000  查看了

常用简写

hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

新建一篇文章后就可以了,在hexo new之后执行一次生成hexo g再执行hexo s启动本地服务器,如果之前还在hexo s 按Ctrl + C 结束.

使用Hexo deploy部署到github

还是编辑根目录下_config.yml文件

deploy:
    type: git
    repo: git@github.com:13469940053/13469940053.github.io.git  #这里的网址填你自己的
    branch: master   

接下来就是将Hexo部署到我们的Github仓库上

三、部署到Github

1.检查SSH keys的设置

以下命令均是在Git bash里输入

 1.检查SSH keys的设置
    cd ~/.ssh 检查本机的ssh密钥
    ls

    此时会显示一些文件
        mkdir key_backup
        cp id_rsa* key_backup
        rm id_rsa*  
    以上三步为备份和移除原来的SSH key设置

    生成新的 SSH Key：
    ssh-keygen -t rsa -C "2508723631@qq.com" #生成新的key文件,邮箱地址填你的Github地址
   
    Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<回车就好>
    然后系统会要你输入密码：
    Enter passphrase (empty for no passphrase):<输入加密串>
    Enter same passphrase again:<再次输入加密串>

    在回车中会提示你输入一个密码，这个密码会在你提交项目时使用，如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。
    注意：输入密码的时候没有 * 字样的，你直接输入就可以了。

之后就可以看到成功的界面。

解释一下：
    node_modules：是依赖包
    public：存放的是生成的页面
    scaffolds：命令生成文章等的模板
    source：用命令创建的各种文章
    themes：主题
    _config.yml：整个博客的配置
    db.json：source解析所得到的
    package.json：项目所需模块项目的配置信息
    做好这些前置工作之后接下来的就是各种配配配置了。

2.添加SSH Key到Github

进入github首页

添加SSH Key。

找到 系统当前用户目录下(开启查看隐藏文件) C:\Users\用户名\ .ssh id_rsa.pub文件以文本方式打开。打开之后全部复制到key中

    到了这就可以测试一下是否成功了:

ssh -T git@github.com
#之后会要你输入yes/no,输入yes就好了。

设置你的账号信息:

git config --global user.name "XX"     #真实名字不是github用户名
git config --global user.email "2508723631@qq.com"    #github邮箱

3.部署到github

hexo d

但是执行，hexo d报错：ERROR Deployer not found: git
解决方案
这是因为没安装hexo-deployer-git插件，输入下面的插件安装就好了：

npm install hexo-deployer-git --save

然后在使用Hexo -d命令就可以推送了。

 

到了这你以为就结束了吗？没有，还有坑没有给你们填好。

四、最后的填坑【见下一篇文章hexo主题的设置】

1. 不知道怎么修改yilia主题?(修改themes/yilia/_config.yml)请参考一个简洁优雅的hexo主题
2. Hexo主题配置(根目录_config.yml文件)
3. 电脑重装了系统/多台电脑写博客？那就赶紧戳这里使用hexo，如果换了电脑怎么更新博客？
4. 不知道如何编写Markdown语法？Markdown——入门指南
5. 想要给网站添加图片？请把图片放入根目录 source\ 下建立一个文件夹，当你执行hexo g的时候此文件夹自动生成到public中。

 

参考链接

Hexo主页
hexo你的博客