hexo博客搭建和使用
Hexo与Github pages 实现静态博客
第一.博客搭建
1.hexo
(1)hexo是什么
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
(2)hexo安装
a.安装前提
安装Hexo前,需要先安装下列应用程序:
- Node.js (Node.js 版本需不低于 10.13,建议使用 Node.js 12.0 及以上版本)
- Git
git 和 node 的安装方法 在后面hexo + github pages给出 着急的小伙伴可以直接从那里开始看
b.安装 Hexo
所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。
$ npm install -g hexo-cli
或者
$ npm install hexo
安装以后,可以使用以下两种方式执行 Hexo:
-
npx hexo
-
将 Hexo 所在的目录下的 node_modules 添加到环境变量之中即可直接使用 hexo
: echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile
2.Github page
(1) github page创建
基本页面的生成
- 首先你需要注册一个 GitHub 账号,并在个人主界面里选择创建一个新的 Repository 。
- 进入页面后,在 Repository name 的位置填写域名,格式是 username.GitHub.io。
- 创建成功之后,点击右上角的 Settings找到 GitHub Pages 选项,选择一个 GitHub 官方提供的主题
- 选择完毕之后 GitHub Pages 就会自动帮你生成好网站,在他跳转的界面点击 Commit changes 按钮,网站就可以访问了。
- 在浏览器里输入你的项目名称,比如 brick713.GitHub.io,就可以看到,你刚刚选择的主题的个人网站的页面了。
3.hexo + Github page
(1).git
a. git安装
- windows下载安装 git
- linux下载安装指令
sudo apt-get install git-core
或者sudo yum install git-core
b. git和github绑定
-
安装成功后,将 git 与 GitHub 账号绑定,右键打开 Git Bash
-
配置用户名和邮箱
git config --global user.name "github 用户名"
git config --global user.email "github 注册邮箱"
-
生成 ssh 密钥
ssh-keygen -t rsa -C "github 注册邮箱"
-
一般执行上述命令之后,会生成 id_rsa 和 id_rsa.pub 两个文件,前者是我们私有的,而后者则是对外开放的。接着找到生成的 .ssh 的文件夹中id_rsa.pub 密钥,将内容复制,然后打开 GitHub-Settings-Keys 页面,创建一个新的 SSH key,填写 Title 和 Key,Title 可以随意,而 Key 的内容则是我们刚才复制的 id_rsa.pub 中的内容,最后点击 Add SSH key 即可
(2).node.js
a. node.js安装
- 下载node.js下载
- 一直下一步即可
- 验证 在命令行输入 node -v可以查看版本
b. node.js初始化
- 在git bash中安装
npm i hexo-cli -g
- 选择一个文件夹来放置博客文件,并用如下命令进行初始化并安装必备组件
//在对应文件夹下git bash here
hexo init .
npm install
c.初始化后的文件
- _config.yml # 网站配置信息
- package.json # 应用程序信息
- scaffolds # 模板文件夹
- source # 存放用户资源 _drafts 草稿箱 _posts 文章
- themes # 主题文件夹
(3) 将自己的github网址 替换 _config.yml最后的
deploy:
type: git
repo: //此处替换为自己的github的对应仓库网址
例:https://github.com/xxxxx/xxxxx.github.io.git
branch: master
第二.博客使用
1.新建博客
在搭建博客的文件夹中git bash here 进入到 Blog/source/_post文件夹中(_post为默认选项 即发表文章)
可以在source文件夹中创建文件夹 new时加参数 例如草稿箱_draft)
hexo new [layout]
例如 hexo new "我的博客"
hexo new post "我的文章" //就会在/source/_post文件创建名为 我的文章.md的文件
hexo new draft "我的草稿" //就会在/source/_draft文件创建名为 我的草稿.md的文件
其中[layout]为布局
- 创建md文件时可以指定布局
- 包括三种布局 page draft post分别为页面,草稿,文章 默认为post
- 在新建文件时,Hexo 会根据 scaffolds 文件夹内相对应的文件(可以理解为模板)来建立md文件
- 当创建不同的md文件会在不同的存储路径
注意但不想一个文件显示在页面上时,可以移动到_draft文件夹
- 在启动服务器时加上 --draft来查看草稿
- 还可以在站点配置文件中把render_drafts设为true 可以通过publish将草稿发布文章或者页面
hexo server --draft
hexo publish [layout]
2.博客编写
(1)Front-matter
创建一个文件后可以看到这些,成为Front-matter
---
title: hexo博客搭建和使用
tags:
---
此处包括一些预定义参数如下
layout 布局 默认为true,如果你不想你的文章被处理,可以设置为false
title 标题 标题会显示在最上方居中位置
date 建立日期如果不指定则为默认值-文件创建日期,可以自定义。
update 更新日期 如果不指定则为默认值-文件修改后重新生成静态文件的日期。
comments 是否开启文章的评论功能 默认值为true
tags 标签(不适用于页面page布局)
categoreies 分类(不适用于页面page布局)
permalink 覆盖文章网址
keywords 仅用于 meta 标签和 Open Graph 的关键词(不推荐使用)
举个例子
---
title: hexo博客搭建和使用
date: 2022-03-22 11:51
tags:
- 博客搭建
categories:
- 个人博客
- 博客搭建使用
---
(2)博客正文编写
使用markdow文法编写博客,保存
markdown语法可以参考这个markdown官方语法
3.博客预览和发布
(1)基本操作
一般发布文章或者修改博客后需要这些操作:
- 清除缓存
- 生成静态文件
- 启动服务器
- 测试没问题
- 部署
(2)常用命令
- 清除缓存:hexo clean
- 生成静态文件:hexo generate可简写为 hexo g
- 启动服务器:hexo server或者 hexo s 此处默认的端口号为4000 可以使用-p(--port)重设端口,此处使用浏览器浏览localhost:4000可以预览自己的博客
- 部署:hexo deploy可简写为hexo d,用于将网站部署到服务器上。将博客托管到GitHub Pages或Gitee Pages 注意:此处可以使用-g(--generate),hexo d -g部署前预先生成静态文件,等同于 hexo g -d
举个例子
hexo clean
hexo g
hexo s //此处注意预览完在git bash窗口Ctrl+c关闭,直接关闭浏览器可能会使端口无法释放
hexo d