为了方便搭建个人博客,我推荐如下软件:
- VScode:可以当作方便的 markdown 编辑器,可实现实时预览,但启动速度较慢;
- Notepad++:轻量级编辑器,对不同编程语言有不同颜色的区分,启动速度快;
- Chrome:在设计过程中预览效果较快。
搭建 GitHub 仓库
注册 GitHub
GithubGitHub 是一个面向开源及私有软件项目的托管平台,因为只支持 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 秘钥,粘贴用户目录下 .ssh
文件夹中 id_rsa.pub
文件的内容。
在 git 中输入 ssh -T [email protected]
,输入 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 | # 字前面加"#"的是注释 |
参考
本文作者:Xecades
本文链接:https://blog.xecades.xyz/drafts/BuildBlog.html
文章默认使用 CC BY-NC-SA 4.0 协议进行许可,使用时请注意遵守协议。
评论