使用github与Hexo搭建个人博客
2017年7月9日 16:19:38
很多人都想自己拥有一个博客,把自己的学习总结心得写在上面,技术类类似的网站“简书”、“博客园”、“CSD博客”都可以使用,但是如果你不想前篇一律的博客格式,那就造起来,拥有一个属于自己的博客,自己的网址。
这篇文章是根据我自己搭建博客的经验来总结,关键是————让想搭建博客的小白……不,小透明也能轻轻松松的搭建成功。
github能创建静态的网站博客。写的文章做成HTML网页传到github,加载会很快,也提供免费的空间和域名。关于使用github与Hexo的用法各大论坛网站都有使用方法,本人觉得他们总结的太麻烦。不如一句一句的教你才是最好的 ,干脆会复制粘贴你就能成功了!
搭建博客的步骤
- 环境搭建
- 创建配置Hexo
- 配置github库
- 配置域名
- 创建第一篇文章
The first:环境搭建
注册Github帐号注册参考详细图解、https://github.com/
下载、安装git(点击直接下载< Windows版 >)
下载、安装 Node.js官网下载(找到DOWNLOADS、选择你系统的下载)
直接下载点击安装就行- 创建和配置Hexo: 先在本的目录中创建一个名为Hexo的文件夹,初期配置完成,接下来的事情就交给第二部分完成了 。
The second: 创建配置Hexo
Hexo作为本地博客的根目录
在本地的目录里创建Hexo后,类似于我直接创建
在Hexo的目录下右键打开GitBash(或者你按住Shift➕右键>在此处打开命令窗口)
输入或者复制下面的代码 ( 本文中前面有 $ 符号的是在GitBash中打开的。当然你也可以把命名在计算机命令窗口下运行)
$ npm install -g hexo
$ hexo init
然后空空的Hexo就会有下面的结构
$ hexo generate
$ hexo server
(hexo server 启动本地的服务……ctrl+c中断服务的开启)
然后打开浏览器,打开http://localhost:4000/如果能打开就说明这一步已经成功了(ps:打开本地地址的时候,hexo server一定要在开启的状态)
然后出现了hexo–hello world 相当于你自己本地计算机搭建的网站,这个网站只能你自己看到,所以你要把他和Github连接上传。来达到让被人也能看到的目的。
如果你感觉这个主题很low,可以去改变一下主题 选择你喜欢的炫酷主题
下载的部分我喜欢的主题
进入Hexo文件夹下的thems,在这个文件夹下右键GitBash,打开终端
git clone https://github.com/litten/hexo-theme-yilia.git
克隆完成在你的themes中会有一个新的主题包hexo-theme-yilia。
然后打开Hexo下面的_config.yml文件,修改里面的theme–>hexo-theme-yilia
这
重新打开服务
hexo s
进入本地地址 http://localhost:4000主题旧改变了,同样的方法也可以下载官网中你喜欢的炫酷的主题。
进入上面主题网站下载里面Github的文档
- 选择喜欢的主题
- 点击要下载主题的名称,进入Github库
- 找到绿色按钮,Clone or download,下载压缩包
- 解压到Hexo–>themes中
- 修改Hexo下面的_config.yml文件中themes下面的为你下载的主题的名字
The Third:配置Github库
在这步的前提你要完成了Github帐号的注册与新建一个库。
打开电脑的开始Git–>Git Bash
检查SSH keys
$ cd ~/.ssh
如果第一次在电脑上装此步骤,就显示No such file or directory 是正常的,如果你以前装过,或者装失败过,那就要清除原来的ssh key设置
$ ls
config id_rsa id_rsa.pub known_hosts
$ mkdir key_backup
$ cp id_rsa* key_backup
$ rm id_rsa*
再次检查
$ cd ~/.ssh
生成新的SSH key
$ ssh-keygen -t rsa -C "你要就收信息的邮箱"
Generating public/private rsa key pair.
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:<再次输入加密串>
添加key到Github
在计算机中搜索文件id_rsa.pub,打开文件复制里面的内容
进入你自己Github的主页悬着按钮settings
选择SSH Key选项,title随便写,把内容复制到key中, 点击add添加成功
测试在命令行下面直接是复制ssh -T git@github.com (复制不要该任何东西)
$ ssh -T git@github.com
出现,输入:yes
Are you sure you want to continue connecting (yes/no)?
提示successfully
Hi <em>username</em>! You've successfully authenticated, but GitHub does not provide shell access.
设置账号信息
别傻傻傻傻的复制了
$ git config --global user.name "张三"(你的真实名字)
$ git config --global user.email 你的邮箱"(你的邮箱)
上传与发布
进入到Hexo的目录下,用Git Bash执行下面的命令
$ hexo clean
$ hexo g
$ hexo d
在此过程中会让你输入一次密码,这个密码就是生成SSH keys 键入的密码(不知道是啥的抬头向上看看)
成功的提示是
Edpoly done:git
如果没有出现这句话ERROR Deployer not found: git运行下面这就话
npm install hexo-deployer-git --save
在进行一次
The Forth:绑定域名
是这样的此时个人的博客的第一种形式可以使用,就是通过gtihub分配给你的域名访问,形如:xxx.github.io的。
购买域名
得到域名后,点击github自己创建的博客仓库create new file here
IO/+
名字命为CNAME,内容为你自己买的域名(格式要严谨www开头,这个地方容易出错)
提交后,仓库里面会有CNAME的文件,然后点击右上角的Download zip将整个仓库压缩包下载,只要里面的CNAME文件,复制到Hexo下的Source的目录下。这样就可以解析了
ps:如果不想花钱买域名,那就直接用人家github分的域名吧!这也是可以的
The fifth:创建第一篇文章
在Hexo->Source->——post文件夹下面创建你要写的博客
hexo new "文章标题"
他是md类型的文件,使用支持Markdown编译器的的软件打开文件。这样写出来的博客才会好看
同时推荐用Markdown pad,下载地址http://markdownpad.com/download.html
传送豪门–Markdown语法通俗易懂使用https://segmentfault.com/markdown
写完第一篇文章后。可以现在上传到本地预览在网站效果
hexo g
hexo s
达到自己的满意程度就可以发布自己的文章
hexo d
第一次上传可能需要密码,如果出现报错
ERROR Deployer not found: git
就执行一次
npm install hexo-deployer-git --save
再试一次
INFO Deploy done: git
git上传成功,开启博客之旅–!
报错
hexo部署到github时,提示typeError [ERR_INVALID_ARG_TYPE]: The “mode“ argument must be integer. Receive…
查阅相关文章得知,是node版本过高导致的(我用的是v14.11.0),将node版本换为v10.16.0版本后,部署就成功了!
如果你的其他项目中有需要使用高版本的node,那么你可以使用nvm来进行node版本切换。
https://www.runoob.com/w3cnote/nvm-manager-node-versions.html
1 | $ node -v |