Hexo+GitHub 搭建个人博客(一):安装、配置和第一篇博客
- 本文简单介绍Hexo+GitHub 搭建博客。本文主要目的是对学习内容进行总结以及方便日后查阅。
- 详细教程和原理可以参考Hexo官方中文文档。
- 本文版权归马涛涛所有。
- 本文所引用的图片和文字版权归原作者所有,侵权删。
- 如有错误请在下方评论区指出,欢迎积极讨论。
安装与配置
什么是Hexo
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。——《Hexo官方中文文档》
安装前提
Git可能需要科学地上网,没法下载的话,在Hexo文档——安装指南中有百度云Git同步下载地址。
安装步骤
- 进入一个安全的目录,比如
cd ~/Desktop
或者cd ~/Documents
,别在根目录 / 。养成进入一个安全的目录,别在根目录里乱存东西的习惯,只有 ~ 里面的目录才是安全的。 - 在 GitHub 上新建一个空 repo,repo 名称是「你的用户名.github.io」(一定你的用户名替换成真正的用户名)
- GitBash上运行
npm install -g hexo-cli
,安装 Hexo。 hexo init myBlog
cd myBlog
npm i
生成第一篇博客
-
hexo new 开博大吉
,开博大吉就是你的第一篇博客的标题,后面也可以改。运行完后你会看到一个 md 文件的路径。
-
首先用
cd
命令进入_posts
的这个目录,再start 开博大吉.md
,编辑这个 md 文件,内容自己写,先实验能否成功,后面再教如何编写以及美化博客(Ubuntu 系统用xdg-open 开博大吉.md
命令)Windows 的路径中的
\
需要变成/
才行 -
进入然后返回
myBlog
目录,执行start _config.yml
,编辑网站配置- 把第 6 行的 title 改成你想要的名字,这个就是网站的博客标题
- 把第 9 行的 author 改成你的大名
- 把最后一行的 type 改成
type: git
- 在最后一行后面新增一行,左边与 type 平齐,加上一行
repo: 仓库地址
(请将仓库地址改为「你的用户名.github.io」对应的仓库地址,仓库地址以 git@github.com: 开头。 - 上一步的
repo:
后面有个空格。
npm install hexo-deployer-git --save
,安装 git 部署插件hexo deploy
进入「你的用户名.github.io」对应的 repo,打开 GitHub Pages 功能,如果已经打开了,就直接点击预览链接,链接是 [你的GitHub用户名.github.io]
你现在应该看到了你的博客!
增加新博客
hexo new 第二篇博客标题
- 复制显示的路径,使用
start 路径
来编辑它,里面的内容支持MarkDown语法,编辑的内容就是博客的内容。 hexo generate
-
hexo deploy
部署,提交
然后去看你的博客,应该能看到第二篇博客了