为了方便搭建个人博客,我推荐如下软件:
- $VScode$:可以当作方便的$markdown$编辑器,可实现实时预览,但启动速度较慢
- $notepad++$:轻量级编辑器,对不同编程语言有不同颜色的区分,启动速度快
- $chrome$:在设计过程中预览效果较快
搭建$GitHub$仓库
注册$GitHub$
Github$GitHub$是一个面向开源及私有软件项目的托管平台,因为只支持git作为唯一的版本库格式进行托管,故名$GitHub$.
注册$GitHub$仓库用于存储你的博客,其实还可以用其他仓库,我还是推荐用$GitHub$.
注册过程很简单,我草草过一下(我创建名为$waterdrop100$的账号用于演示).
注册后还需要验证,它会给你的邮箱发一个链接,打开链接完成验证.
创建仓库
注册好后,单击左边提示栏的”$Create$ $a$ $repository$”,创建仓库.
在”$Repository$ $name$”栏里按用户名.github.io
的格式填入,比如我应该填waterdrop100.github.io
.
其他的不用填,直接点”$Create$ $repository$”,$GitHub$仓库创建完成(仓库生效可能需要一点时间)!
搭建环境
下载$node.js$和$git$
node.js下载 git下载$node.js$和$git$的安装很简单,网上资料很多,我就不多赘述了.
最好验证一下安装是否成功. 打开$cmd$,输入node -v
、npm -v
和git --version
,若输出正常则配置成功.
安装$hexo$
找一个你觉得 安全 好的地方新建文件夹用于存储本地博客,最好不要在系统盘($C$盘)建. 我在E盘建了一个$blog$文件夹,用$cmd$进入.
再输入npm install hexo -g
安装$hexo$.
输入hexo -v
,若输出版本信息,则安装成功. 输入hexo init
初始化文件夹(慢慢等).
输入npm install
安装插件.
至此$hexo$安装完毕.
体验$hexo$
如果你想看一下成果,那继续往下看.
输入hexo g
更新文件,再输入hexo s
开启本地测试用服务器.
在浏览器中输入网址http://localhost:4000
预览你的博客!页面默认如下($hexo$默认创建了名为Hello World
的文章)
连接$hexo$和$GitHub$
设置$git$用户名和邮箱
在博客目录(我的是$E:/blog$)右键,选择Git Bash Here
,输入git config --global user.name "你注册GitHub的用户名"
,设置$git$的用户名.
输入git config --global user.email "你注册GitHub的邮箱"
,设置$git$的邮箱.
配置$ssh$
采用$ssh$加密传输,防止信息被窃.
下面的教程适用于用户目录下没有$.ssh$文件夹的人,如果有且有2个文件($id$_$rsa$和$id$_$rsa.pub$),则可以直接跳过此节.
在$git$中输入ssh-keygen -t rsa -C "你的邮箱"
,显示如下
输入eval "$(ssh-agent -s)"
将密钥添加到$ssh-agent$.
再输入ssh-add ~/.ssh/id_rsa
.
打开$GitHub$,单击头像,选择settings
,再选择SSH and GPG keys
选择New SSH key
,新建$ssh key$,粘贴用户目录下$.ssh$文件夹中$id_rsa.pub$文件的内容.
在$git$中输入ssh -T git@github.com
,输入yes
,若显示大概如下,则标准$ssh$配置成功.
配置$
_$config.yml$
在博客文件夹中有一个文件叫_config.yml
,它是博客核心配置,用编辑器打开,在文件末尾有如下内容.
将其修改为如下格式(注意,在每一个”$:$”后都必须有一个空格)
1 | deploy: |
其中repository
一项是$GitHub$仓库页面的$ssh$地址.
完成连接
现在$GitHub$和本地文件夹已经连接好了,下面讲解本地上传到$GitHub$的方法
打开$cmd$,安装扩展:npm install hexo-deployer-git --save
.
先hexo clean
清一下缓存.
输入hexo d -g
生成$+$部署,这个命令很重要,以后每次对博客有更改都要上传部署.
等个几分钟,你的网页就可以访问了,地址是GitHub用户名.github.io
,比如我的是waterdrop100.github.io
.
发布文章
有了博客还不会发布文章怎么行呢,下面来讲如何发布文章. 文章一般在主页显示,就是你日常写博客的文章啦!
在cmd中输入hexo new 文章名
就会在source\_posts
目录下创建一个名为文章名.md
的文件,推荐用$VScode$打开,用$markdown$继续编辑.
打开文件后,可以在右上角选择继续预览编辑. 在文件开头有如下几行字:
1 |
|
这些是此文章的配置,后面可以增添删改一些内容.
配置文件
前面说过_$config.yml$是重要的配置文件,下面对其内容进行讲解(暂时不必更改).
1 | # 字前面加"#"的是注释 |
小结
要弄好一个自己的博客,不是一蹴而就的,希望大家有耐心,当初寒假的时候,我也是一个什么都不懂的小白(现在也是),按照网上的教程蹒跚学步似地用了很长时间做了一个属于自己的博客,高兴之余,摆在我面前的确是不计其数的bug. 我于是抱着一颗虔诚的心,勤能补拙,才有了现在的博客
参考:
资料一 资料二 资料三本文作者:Xecades
本文链接:https://blog.xecades.xyz/articles/BuildBlog/
文章默认使用 CC BY-NC-SA 4.0 协议进行许可,使用时请注意遵守协议。
评论