心血来潮重新搭建了一次 Hexo,过程还算顺利。本想着其实网上教程已经足够多了,随便搜一搜就能找到各种详尽的资料和教程,但是当我想起之前看到那条 Twitter 的时候,还是抱以分享的态度去试着写点东西。再此引用全文以激励阅读本文的读者和没有习惯更新博客的自己。
ruanyf @ruanyf 3 月 25 日
不管你干什么,我都建议经常写作。随便写什么,不一定文辞优美,只需包含对自己领域的一些体会。不要低估写作的力量,它能让你从日常琐事抽身出来,透彻思考心中的问题。最重要的是,写给别人看时,你就成为更广阔世界的一部分。发表文字就是在宣称自己是社会一员,愿意做一些有意义的贡献。# 书摘
申请 GitHub Page
- 申请 GitHub 账号
- 登录 GitHub 后在主页点击
New repository
,在Repository name
中输入前缀与自己 GitHub 用户名一致的仓库名称[用户名].github.io
。例如,你的用户名为helloworld
,则创建仓库名称为helloworld.github.io
- 勾选
Initialize this repository with a README
并创建仓库
PS:
- 仓库名称前缀若与用户名不一致则无法成功申请 GitHub Page。
- 仓库属性必须为公开,即必须为
Public
。
环境准备
- 安装所需的 Git Bash 和 Node.js 程序
- 按照 Github 官方教程 生成并添加 SSH 密钥到 Github 设置中。
安装&部署 Hexo
- 运行 Git Bash,使用如下命令安装 Hexo:
$ npm install -g hexo-cli
- 安装完成后对 Hexo 进行部署,创建一个文件夹作为 Hexo 工作目录。为避免不必要的麻烦,建议使用英文路径。
- 运行 Git Bash 并进入 Hexo 工作目录,使用如下命令对 Hexo 进行初始化:
$ hexo init
$ npm install
- 安装 Hexo 插件,详细信息可以访问插件页面查看相关内容
$ npm install hexo-generator-index --save #首页生成插件
$ npm install hexo-generator-archive --save #归档页生成插件
$ npm install hexo-generator-category --save #分类页生成插件
$ npm install hexo-generator-tag --save #标签页生成插件
$ npm install hexo-renderer-marked --save #Markdown 语法渲染插件
$ npm install hexo-renderer-stylus --save #Stylus 渲染插件
$ npm install hexo-renderer-ejs --save #ejs 渲染插件
$ npm install hexo-server --save #Hexo 本地服务器插件
$ npm install hexo-deployer-git --save #git 部署插件(选装 推荐)
$ npm install hexo-generator-feed --save #feed 生成插件(选装 推荐)
$ npm install hexo-generator-sitemap --save #sitemap 生成插件(选装 推荐)
$ npm install hexo-hey --save #hey 可视化后台编辑插件(选装 推荐)
$ npm install hexo-tag-owl --save #Owl 多媒体插件(选装)
$ npm install hexo-ruby-character --save #萌娘百科注音插件(选装)
$ npm install hexo-generator-search --save #Search 生成插件(选装)
$ npm install hexo-git-backup --save #使用 Github 备份博客(选装)
- 执行如下命令,访问 http://localhost:4000 即可本地预览 Hexo 页面
$ hexo server
HEXO 基本操作
HEXO 命令需要在 Hexo 工作目录内运行。
新建文章
$ hexo new "My New Post" #创建一篇新文章,引号内为标题
More info: Writing
本地预览 Hexo 页面
$ hexo server
$ hexo s #命令简写
More info: Server
生成静态文件
$ hexo generate
$ hexo g #命令简写
PS:Hexo 是静态播客生成器,故修改博客内容后都需重新生成静态文件
More info: Generating
部署静态文件到远程站点
$ hexo deploy
$ hexo d #命令简写
More info: Deployment
生成静态文件并部署到远程站点
$ hexo g -d
清除 public 文件夹和数据库
$ hexo clean
$ rm db.json -f