🍭 关于主题
一只移植的主题,兼具亮暗双主题,身负多种小挂件,短能卡片列首页,长能文章读更多,退可罗列全归档,进可搜索全文章,相关介绍可以参见主题说明页面哦~
样例站点自动部署已经上线,具体可以参照这篇日志:使用Github Actions部署主题样例站
全新的配置文档增加了!戳这里就能查看~
或者也可以去我的博客踩踩哦~
核心结构&样式来源:@MoeDog 狗狗大佬的Kratos的某个上古版本
💞 安装使用
hexo init your-awesome-blog
初始化您的 Hexo 站点目录(已经完成则可以忽略)- 进入您的站点目录,使用
npm install --save hexo-theme-kratos-rebirth
或yarn add hexo-theme-kratos-rebirth
安装主题。如果您有调整代码的需求,您也可以进入站点的主题目录,使用 git clone 本仓库来使用。 - 修改站点目录下的
_config.yml
站点配置文件,将默认的theme: landscape
修改成theme: kratos-rebirth
- 如有自定义配置的需要,为更有效地管理您的主题配置文件,您可以从该主题代码仓库中,手动复制一份
_config.yml
,并改名为_config.kratos-rebirth.yml
,移动至您的站点目录下;或者您也可以参考.demo
目录下的_config.kratos-rebirth.yml
这个用于构建样例站点的配置文件扩展,将其移动至站点目录下。
每一项配置项的具体解释可以参照配置文档。
🎁 使用环境小贴士
- hexo的官方渲染器现在也已经支持文章置顶啦,配置
Front-Matter
段中的sticky
参数即可实现置顶降序排序,可以参见生成器的官方文档哦 - 由于使用了
?.
运算符,在旧版本的 NodeJS 上可能出现工作不正常的情况,因而我们推荐您使用 Node v14 或更新的版本。详情请参见 可选链操作符 。 - (如果您使用的是主题目录内的配置的方案,现在已经不推荐这种方案了)为了防止主题配置文件被上传导致版本管理冲突,主题的
_config.yml
文件是默认被忽略的( .gitignore ),如果您使用远程构建部署的方式(例如 Pages 或是 Vercel 等),您需要手动添加对主题配置文件的追踪,可以使用git add -f ./themes/kratos-rebirth/_config.yml
来恢复追踪。 - 如果发现代码块渲染样式出错(例如块代码被渲染成了行代码样式),可以试着检查一下是不是同时开启了 highlight 和 prismjs 的选项哦,主题对 highlight 的支持更佳呢
💬 支持的评论系统
🍩 二次开发相关
为了保证最终上线产品的有效空间利用,我们引入了gulp对静态资源文件(js、css)进行压缩;因而您在src文件夹下直接修改的静态文件会无法实时生效,请安装gulp及相应的插件(在主题文件夹下 npm install
或是 yarn
)。
您可以使用 npm run build
或是 yarn build
来构建一次静态文件。
同时,为方便变化内容实时更新和多浏览器测试开发,您可以使用 npm run dev
或是 yarn dev
来运行。我们也有引入 Browser Sync 功能方便地在多个浏览器上查看变化,推荐您在 Hexo 启动后运行该指令。
💮 非常感谢
- Kratos-pjax
- hexo-theme-sagiri
- hexo-theme-suka
- hexo-theme-landscape
- APlayer
- NProgress
- CloudFlare
- jsDelivr
- unpkg
- npm
🎵 证书
- GNU General Public License v3