hexo+github创建个人博客--基础篇

最新推荐文章于 2024-04-19 09:02:25 发布

Little__Dragon

最新推荐文章于 2024-04-19 09:02:25 发布

阅读量1.1k

点赞数

分类专栏：学习笔记文章标签： hexo github 个人博客

本文链接：https://blog.csdn.net/Little__Dragon/article/details/77163612

版权

学习笔记专栏收录该内容

11 篇文章 0 订阅

订阅专栏

内容简介

此篇文章介绍的是基础的hexo+github搭建个人博客的方法，包括搭建之前的准备工作和搭建的步骤过程，当最后达到了预期效果，并且想深入研究其他功能时，可以参考hexo+github创建个人博客–深入篇,里面介绍了关于博客的主题，图床，评论，统计等功能的配置和实现。

工具介绍

1.hexo介绍

Hexo是一个快速、简洁且高效的博客框架。Hexo使用Markdown解析文章，在几秒内，即可利用靓丽的主题生成静态网页

2.Markdown介绍

Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。

准备工作

1.github账号创建和git安装
- 没有github账号的朋友先进行github账号注册，按照流程注册即可
- 创建仓库,命名格式为 yourname.git.io,例如我的github名称为haloMelody，仓库名为haloMelody.git.io
- 为仓库创建两个分支，master（默认的主分支）用于博客的发布，另外创建一个分支hexo（命名看你自己）用于保存博客项目，为了防止换电脑导致以前的博文丢失的情况，确保记录的同步，并且将自己创建的分支hexo设置为默认分支–settings中可进行设置
- 创建git-pages，一般仓库创建后会自动勾选，此选项可以保证通过已项目名为域名来访问你的博文（有自己域名的可进行域名绑定，参考http://www.cnblogs.com/penglei-it/p/hexo_domain_name.html）
- 接下来为保证可以在终端运行git命令，需要安装git，下载完成后配置环境变量，将cmd目录配置到path中。
```
git version  //检测是否安装成功
```
2.nodejs安装
- 进入node.js官网安装，按照导航进行
```
npm -v  //检测nodejs是否安装成功
```
- 若出现命令未找到的错误提示，则需要手动的配置环境变量，将nodejs目录配到path目录下。此处选择nodejs版本时尽量选择最新的版本，方便后续选择的主题时候的兼容性。
3.hexo安装
- nodejs安装成功后可以使用以下命令安装hexo.
```
npm install hexo -g //安装全局的hexo
npm install hexo //在某目录下有效
hexo -v //检测是否成功安装
```
- 若出现命令未找到的错误提示，则需要手动的配置环境变量，找到hexo的安装目录，全局安装可以参照C:\Users\LittleDragon\AppData\Roaming\npm（改为自己电脑的路径），将此路径配置到path中，并且运行hexo -v检测是否成功。
博客搭建

1.项目创建
- 选择一个位置将仓库同步到本地，进入到文件中，打开文件查看选项中的显示影藏文件，可看到至少有一个.git文件（此处将.git文件复制到别处，随后清空仓库项目文件夹，为了后续操作执行–hexo init 的时候需要文件夹为空），同步命令为：
```
git clone  xxx  //复制github仓库路径
```
- 随后在此目录下（保证此时是空文件夹），打开CMD（shift+鼠标右键），顺序运行：
```
hexo init //初始化项目
npm install hexo //安装插件
npm install hexo-deployer-git //发布到git上时必要的插件
```
- 项目初始化后，可以看到如下的目录结构，分别表示为：
  - .deploy #需要部署的文件
  - node_modules #Hexo插件
  - public #生成的静态网页文件
  - scaffolds #模板
  - source #博客正文和其他源文件，404、favicon、CNAME 都应该放在这里
  - _drafts #草稿
  - _posts #文章
  - themes #主题
  - _config.yml #全局配置文件
  - package.json
- 接下来可以运行命令，创建一篇博文，文章使用的是MarkDown语言，具体语法此处不做介绍
```
hexo new "title" //创建指定标题的文章
```
- 文章内容编辑好以后，执行命令：
```
hexo clean //清除原有记录
hexo g //generate生成html文件
hexo s //server本地运行
```
- 本地运行以后会实时的对本地文件进行监控，修改后直接刷新浏览器即可看到效果，到此，简单的个人博客已经搭建完成了，接下来可以件博客发布到github上，让网友可以通过你的域名访问个人博客,发布需要的几个步骤：
  1. 成功安装了发布需要的插件
```
npm install hexo-deployer-git //发布到git上时必要的插件
```
  2. 为你的github配置SSH Key，只需要配置一次，详情请参照github配置SSH Key
  3. 在博客项目根目录下的_config.yml中进行如下配置：
```
deploy:
  type: git
  repo: git@github.com:yourname/yourname.github.io.git 
  branch: master
```
  4. 执行发布命令，首次可能需要输入github的用户名和密码
    hexo d
  5. 发布之后可以登录你的域名查看效果