hexo 使用及命令
Hexo 命令
Hexo 是一个快速、简洁且高效的博客框架。它使用 Markdown 编辑文章,在几秒内,即可利用靓丽的主题生成静态网页。
安装
安装 Hexo 相当简单,只需要先安装下列应用程序即可:
- Node.js (Node.js 版本需不低于 10.13,建议使用 Node.js 12.0 及以上版本)
- Git
安装完毕后,运行以下命令安装 Hexo:
1 | npm install hexo |
创建博客
安装完毕后,运行以下命令创建博客:
1 | hexo init <博客名称> |
例如,创建一个名为 “我的博客” 的博客:
1 | hexo init 我的博客 |
这将在当前目录下创建一个名为 “我的博客” 的文件夹,该文件夹包含 Hexo 所需的所有文件和目录。
编写文章
Hexo 使用 Markdown 编辑文章。Markdown 是一种轻量级标记语言,可以使用易读易写的纯文本格式来编写文档,然后转换成有效的 HTML 文档。
要编写文章,只需在 source/_posts
目录下创建一个新文件,文件名必须以 YYYY-MM-DD-标题.md
的格式命名。例如,创建一篇名为 “我的第一篇文章” 的文章:
1 | hexo new posts/2023-11-26-我的第一篇文章.md |
打开 posts/2023-11-26-我的第一篇文章.md
文件,编写文章内容:
1 | # 我的第一篇文章 |
生成静态网页
编写完文章后,运行以下命令生成静态网页:
1 | hexo generate |
这将在 public
目录下生成静态网页。
启动本地服务
要启动本地服务,运行以下命令:
1 | hexo server |
这将在本地端口 4000 上启动一个 HTTP 服务。
部署到线上
要将博客部署到线上,可以使用 GitHub Pages 或其他静态网站托管服务。
GitHub Pages
要将博客部署到 GitHub Pages,需要在 GitHub 上创建一个仓库,并将仓库的根目录设置为 Hexo 项目的根目录。然后,在仓库的 README.md
文件中添加以下内容:
1 | --- |
最后,将仓库设置为 GitHub Pages 的博客:
1 | git remote add origin git@github.com:<用户名>/<仓库名>.git |
其他静态网站托管服务
其他静态网站托管服务的部署方式各不相同,请参考相关文档进行设置。
常用命令
Hexo 提供了许多常用命令,可以帮助开发者快速完成各种操作。
命令 | 说明 |
---|---|
hexo init <博客名称> |
创建博客 |
hexo new <文件类型> <文件名> |
创建新文件 |
hexo generate |
生成静态网页 |
hexo server |
启动本地服务 |
hexo clean |
清除缓存 |
hexo publish |
发布博客 |