如果只是介绍Hexo客户端的用法就太无聊了,干脆简单的说一下搭建Hexo博客的流程好了。系统自动生成的那些东西的翻译就放在最后一个板块了==
这里只简单的介绍一下在 Windows 10 平台上将 Hexo 博客部署到 Github Pages 上的基本操作,大概就是:准备必须的环境->在Github上创建仓库->使用Hexo客户端->修改博客工程的配置文件->写作并发表。
仔细看看官方文档,发现它讲的其实挺全面的…… 瞬间就不想写这个了。
准备工作
这一步主要的是准备Hexo运行的基本环境。
安装程序
首先,你得在你的电脑上安装Node.js和Git。文章里的链接可能不是最新版本的,需要最新版本请去官网:
- Git官网的下载页面: https://git-scm.com/downloads
- Node.js官网的下载页面: https://nodejs.org/zh-cn/
特别注意,安装Git的时候,安装向导会出现一个复选框提示是否将Git增加到系统变量(PATH),选择这个。
安装完成之后,右键开始菜单按钮选择 Windows Powershell,输入命令npm
和git
测试它们是否已经正确安装。如果已经正确安装会出现帮助文字,否则会出错。如果Git已经正确安装但是在控制台中没有找到,可能是因为Git不在系统变量中,这个时候需要手动将Git添加到Path或者使用 git bash 作为终端。
安装Hexo客户端
之后你需要使用Hexo安装Hexo的客户端,执行的命令是:
1 | $ npm install -g hexo-cli |
安装之后,使用npx hexo
应该就可以使用hexo了。如果需要之后使用的更方便,还可以将 Hexo 所在的目录下的 node_modules 添加到环境变量,之后即可直接使用hexo
使用它。(但是我的电脑似乎并没有做这一步操作)
布置Github
首先,Hexo的Github部署工具只支持SSH方式部署。也就是说在使用前,你需要将你的电脑的SSH公钥存放到Github账户里。你的电脑的SSH公钥的存放位置在你的个人文件夹下的一个叫做.ssh
的文件夹下,如果该目录不存在,或者该目录下没有叫做id_rsa
和id_rsa.pub
的文件存在,则说明公钥不存在,这时需要生成一个公钥。
可以通过在 Git Bash 或者其他任何终端中键入以下命令生成一个公钥:
1 | $ ssh-keygen -t rsa -C "your_email@youremail.com" |
将your_email@youremail.com
替换成自己的邮箱,或者任何其他包含一个@
的字符串后一路回车采取默认设置,就会在上述位置生成默认SSH密钥对,也就是上面提到的那两个文件。
登录 Github,点击自己的头像进入 Settings 页面,在 SSH and GPG Keys 目录下,选择新建密钥,将上文提到的id_rsa.pub
文件里的所有文本信息复制到网页的文本框里,保存即可。这样就将你电脑的SSH公钥增加到你的 Github 账号里了。
创建站点
这一步的主要目的是创建一个Hexo的工程。
初始化
选择主题
创建仓库
配置站点
修改主题
设置部署信息
使用
写作
……闲的时候会回来补的……
快速开始(原文翻译)
欢迎使用Hexo!这是系统默认生成的您的第一篇博文。您可以阅读官方文档来获得更多的消息。如果您在使用Hexo的过程中遇到了任何的问题,您可以在检修页面中找到答案,或者您也可以在GitHub上向我发起询问。
创建一篇新的博文
使用模板创建一篇新的博文的md文件,可以通过执行以下命令:
1 | $ hexo new "My New Post" |
这样就创建了一篇叫做 "My New Post" 的博文。
更多信息: 使用Hexo写作 - Hexo官方文档
启动服务器
在本机启动服务器,然后在浏览器中预览您的博客,您可以通过执行以下命令:
1 | $ hexo server |
这样您的博客会在https://localhost:4000(默认端口4000)启动,您可以在浏览器中访问它,或在终端Ctrl+C中断服务器。
更多信息: Hexo服务器 - Hexo官方文档
生成静态文件
要将博客发布,需要先生成静态文件,这可以通过执行以下命令:
1 | $ hexo generate |
这将根据您的配置文件生成静态的html文件,以供部署。
更多信息: 构建/生成 - Hexo官方文档
部署到远程站点
要让您的博客可以在互联网中访问,您可以执行以下命令:
1 | $ hexo deploy |
这样将根据您的配置文件,自动将生成的静态文件发布到互联网。
特别注意:
如果您要将博客发布到 Github Pages,您还额外需要先执行以下命令安装 Github 部署工具。
1 $ npm install hexo-deployer-git --save最新版本的 Hexo 客户端已经不再默认包含这个工具。
更多信息: 部署到远端 - Hexo官方文档