快速建站工具(主要适用:博客、文档等静态站点),可以将Markdown编写的文章解析成html页面。生成的站点可以无需服务器一键部署到github、gitlab或者gitee上。
另外Hexo有许多社区提供的:
安装hexo命令工具到全局环境,安装后可以在shell窗口运行hexo命令。
npm install -g hexo-cli
# or
yarn global add hexo-cli
hexo init demo-folder # 初始化文件夹
cd demo-folder # 进入文件夹
npm install # 安装依赖
文件夹的目录:
├── _config.yml # 配置信息
├── package.json
├── scaffolds # 模版
├── source # 资源
| ├── _drafts # 草稿
| └── _posts # 文章
└── themes # 主题
npm install hexo-deployer-git --save
# 发布后的网址
url: http://krdxst.gitee.io/wenju-blog/
# 首页配置
root: /wenju-blog/
# 部署配置
deploy:
- type: git
repo: git@github.com:wenjuGao/wenju-blog.git # github
branch: gh-pages
- type: git
repo: git@gitee.com:krdxst/wenju-blog.git # gitee
branch: ge-pages
新建仓库
新建仓库
npm run deploy
注意:
新建仓库
新建仓库
npm run deploy
发布后需要手动回到设置Pages页面点击更新。
详细配置见官方文档
以下枚举下常用配置:
参数 | 描述 |
---|---|
title | 网站标题 |
subtitle | 网站副标题 |
description | 网站描述 |
keywords | 网站的关键词。支持多个关键词 |
author | 作者名称 |
language | 语言(多语言是会使用到)zh-CN |
url | 网址 |
root | 网站根目录 |
theme | 主题名称(自定义主题时会用到) |
theme_config | 主题配置 |
deploy | 部署配置 |
详细命令见官方文档
以下枚举下常用命令:
# hexo new [layout] --path [path] --replace [file] --slug [router-name] <title>
hexo new page "我的文章"
hexo new page --path about/me "关于我"
hexo new page --slug me-new "文章内容"
参数 | 描述 |
---|---|
-p, --path | 自定义新文章的路径 |
-r, --replace | 如果存在同名文章,将其替换 |
-s, --slug | 文章的 Slug,作为新文章的文件名和发布后的 URL |
source目录下_posts文件夹之外,开头命名为 _ (下划线)的文件、文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件(图片、字体等其他资源)会被拷贝过去。
hexo generate
# or
hexo g
参数 | 描述 |
---|---|
-d, --deploy | 文件生成后立即部署网站 |
-w, --watch | 监视文件变动 |
-f, --force | 强制重新生成文件(使用该参数的效果接近 hexo clean && hexo generate) |
-c, --concurrency | 最大同时生成文件的数量,默认无限制 |
hexo publish [layout] filename
hexo server
参数 | 描述 |
---|---|
-p, --port | 重设端口,默认端口4000 |
-s, --static | 只使用静态文件 |
-l, --log | 启动日记记录,使用覆盖记录格式 |
hexo deploy
# or
hexo d
参数 | 描述 |
---|---|
-g, --generate | 部署之前预先生成静态文件 |
部署完成
网站到此就部署完成喽,后面你就可以在source下创建你自定义的md或者html来展示你的内容喽。
当然,如果你觉得默认的样式和布局不是那么满足你的需求,你可以在这里找到不同的主题来丰富你的站点,另外还有这里提供的插件来满足你不同的功能需求。后续这边,关于Hexo,还会整理关于主题插件的使用。