什么是Hexo博客
Hexo 是一个基于nodejs 的静态博客网站生成器,作者是来自台湾的Tommy Chen。
特点:
- 不可思议的快速 ─ 只要一眨眼静态文件即生成完成
- 支持 Markdown
- 仅需一道指令即可部署到 GitHub Pages 和 Heroku
- 已移植 Octopress 插件
- 高扩展性、自订性
- 兼容于 Windows, Mac & Linux
安装
1.全局安装Hexo-cli脚手架
npm install hexo-cli -g
2.初始化你的博客
hexo init blog
3.安装依赖
cd 你的博客名
npm install
4.运行本地dev server
hexo server or
npm run dev
运行dev server出现localhost:4000s时就可以在浏览器看到效果
Hexo的常见运行命令
命令 | 描述 | 参数 |
---|---|---|
hexo init [folder] | 使用脚手架初始化一个博客模型 | folder:博客文件夹名称 |
hexo generate(g) | 一键生成静态代码,生成在博客目录下的public文件夹下 | -d or --deploy:文件生成后立即部署网站 -w or --watch: 监视文件变动 -b or --bail: 生成过程中如果发生任何未处理的异常则抛出异常 -f or --force: 强制重新生成文件 Hexo 引入了差分机制,如果 public 目录存在,那么 hexo g 只会重新生成改动的文件。 使用该参数的效果接近 hexo clean && hexo generate -c or --concurrency:最大同时生成文件的数量,默认无限制 |
hexo new [Page] | 新建一篇文章 | Page:文章标题名 -p or --path: 指定新文章的路径 -r or --replace:如果存在同名文章,将其替换 -s or --slug:文章的 Slug,作为新文章的文件名和发布后的 URL |
hexo server | 启动服务器 | -p or --port:重设端口 -s or --static:只使用静态文件 -l or --log:启动日记记录,使用覆盖记录格式 |
hexo deploy | 部署打包到public文件夹 | -g or --generate:部署之前预先生成静态文件 |
hexo clean | 清除缓存 | 无 |
hexo version | hexo的当前版本 | 无 |
配置
博客元数据
参数 | 描述 |
---|---|
title | 网站标题 |
subtitle | 网站副标题 |
description | 网站描述 |
keywords | 网站的关键词。支援多个关键词。 |
author | 您的名字 |
language | 网站使用的语言。对于简体中文用户来说,使用不同的主题可能需要设置成不同的值,请参考你的主题的文档自行设置,常见的有 zh-Hans和 zh-CN。 |
timezone | 网站时区。Hexo 默认使用您电脑的时区。请参考 时区列表 进行设置,如 America/New_York, Japan, 和 UTC 。一般的,对于中国大陆地区可以使用 Asia/Shanghai。 |
博客url
参数 | 描述 |
---|---|
url | 网址 |
root | 网站根目录 |
permalink | 文章的 永久链接 格式 :year/:month/:day/:title/ |
permalink_defaults | 永久链接中各部分的默认值 |
pretty_urls | 改写 permalink 的值来美化 URL |
pretty_urls.trailing_index | 是否在永久链接中保留尾部的 index.html,设置为 false 时去除默认值true |
pretty_urls.trailing_html | 是否在永久链接中保留尾部的 .html, 设置为 false 时去除 (对尾部的 index.html无效)默认值true |
代码高亮
参数 | 描述 |
---|---|
highlight | 代码块的设置 |
highlight.enable | 开启代码块高亮默认值true |
highlight.auto_detect | 如果未指定语言,则启用自动检测默认值false |
日期格式
参数 | 描述 |
---|---|
date_format | 日期格式 YYYY-MM-DD |
time_format | 时间格式 HH:mm:ss |
updated_option | 当 Front Matter 中没有指定 updated 时 updated 的取值默认值mtime |
分页
参数 | 描述 | 默认值 |
---|---|---|
per_page | 每页显示的文章量 (0 = 关闭分页功能) | 10 |
pagination_dir | 分页目录 | page |
扩展
参数 | 描述 |
---|---|
theme | 当前主题名称。值为false时禁用主题 |
theme_config | 主题的配置文件。在这里放置的配置会覆盖主题目录下的 _config.yml 中的配置 |
deploy | 部署部分的设置 |
打包
项目配置完成。在部署之前检查depoly是否配置git远程仓库地址,确认过后使用hexo d命令一键部署到git远程仓库上,开启GitPage就可以访问。
不知道如何玩GitPage参考这篇博客:
域名
tip: 国内域名需要备案,如果不备案就无法正常访问,国外可以不用备案。
首先购买域名,到阿里云,腾讯云等购买域名,然后在控制台管理域名界面填写域名解析设置,重点是记录类型和记录值,记录类型填写CNAME,记录值就填写你的部署页网址,如果是把博客放到自己的服务器上,记录值就是A(指向一个ip4),记录值填写服务器的ip地址。保存设定后,过几分钟大概就可以访问了。