使用的是centOS 8.x
1. 安装node.js
# 会安装node.js 以及包管理器npm
sudo yum install nodejs
2. 安装Hexo
Hexo 是一个静态页面生成器,将编写好的markdown → 博客网页
npm install -g hexo-cli
安装Hexo之后,需要执行以下命令,从而在指定文件夹中新建所需要的文件
hexo init myblog # myblog 是博客文件夹名,可以自己指定
cd myblog
npm install # 补全依赖环境
3. 文件结构解析
新建完成后,指定文件夹的目录如下:
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
- _config.yml:网站的配置信息,可以在此配置大部分参数
网站 | ||
参数 | 描述 | 默认值 |
title | 网站标题 | |
subtitle | 网站副标题 | |
description | 网站描述 | |
author | 您的名字 | |
language | 网站使用的语言 | |
timezone | 网站时区,默认使用电脑系统时区 | |
网址 | ||
url | 网址 | |
root | 网站根目录 | |
permalink | 文章的永久链接格式 | :year/:month/:day/:title |
permalink_defaults | 永久链接中各部分的默认值 | |
目录(这部分值新手没必要修改) | ||
source_dir | 资源文件夹,存放内容 | source |
public_dir | 公共文件夹,存放生成的站点文件 | public |
tag_dir | 标签文件夹 | tags |
archive_dir | 归档文件夹 | archives |
code_dir | include code文件夹 | downloads/code |
i18n_dir | 国际化(i18n)文件夹 | :lang |
skip_render | 跳过指定文件的渲染 | |
文章 | ||
new_post_name | 新文章的文件名 | :title.md |
default_layout | 预设布局 | post |
auto_spacing | 在中文和英文之间加入空格 | false |
titlecase | 把标题转换为tilte case | false |
external_link | 在新标签中打开链接 | true |
filename_case | 把文件名称转换为(1)小写或(2)大写 | 0 |
render_drafts | 显示草稿 | false |
post_asset_folder | 启动Asset 文件夹 | false |
relative_link | 把链接改为与根目录的相对位置 | false |
future | 显示未来的文章 | true |
highlight | 代码块的设置 | |
分类&标签 | ||
default_category | 默认分类 | uncategorized |
category_map | 分类别名 | |
tag_map | 标签别名 | |
日期 / 时间格式 | ||
date_format | 日期格式 | YYYY-MM-DD |
time_format | 时间格式 | HH:mm:ss |
分页 | ||
per_page | 每页显示的文章量(0=关闭分页功能) | 10 |
pagination_dir | 分页目录 | page |
扩展 | ||
theme | 当前主题名称 | |
deploy | 部署部分的设置 |
- package.json:应用程序的信息
- scaffolds:模板文件夹。当新建文章时,Hexo 会根据scaffold 来建立文件
- Hexo 的模板是指在新建的markdown 文件中默认填充的内容(骨架)
- 例如:如果修改scaffold/post.md 中的Front-matter 内容,那么每次新建一篇文章时都会包含这个修改
- source:资源文件夹,存放用户资源的地方
- 除了_posts 文件夹外,其他以“_”开头的文件、文件夹会被忽略
- markdown 和HTML 文件会被解析并存放到public 文件夹中,其他文件会被拷贝过去。即写的markdown文件如果存放在这个文件夹中,就会自动被包含到博客中
- themes 主题文件夹。可以去往上下载好看的主题或者自己编写
4. Hexo 使用
- 在myblog 目录下,输入
hexo generate
或者
hexo g
通过以上命令进行页面生成,每次加入一篇新博客时,都要生成一次。Hexo 默认有一个HelloWorld文档,上面的generate 生成了一个只有HelloWorld 的博客文档网页
- 之后输入
hexo server
或者
hexo s
开启网页服务,在浏览器登录服务器ip:4000 就可以看到效果
5. 发布文章
hexo new "博客文章文件名"
或新建和复制md 文件到 /source/_posts 文件夹或其子文件夹
文章要按照规定格式书写:开头部分 可以按标准写入标签、分类,以便归档。这里写的标签会自动汇集到tags 页面上。例如:
---
title:博客标题
tags:
- tag1
- tag2
...
- tagk
category:
- one_category
---
在source/_post 文件夹或子文件夹中复制md 文件、或者直接写md 文件保存好
之后输入:
hexo clean
hexo g
hexo s
即可将刚刚新建的文件发布成功
注意:
- 已发布的文章发生修改,可直接预览,即不执行上述3个命令,刷新浏览器即可
- 远程部署必须要执行上述命令
- 修改内容一旦预览与修改不一致,则需要clean