/Kratos-Rebirth

o(=•ェ•=)m~🍭

Primary LanguageCSSGNU General Public License v3.0GPL-3.0

Kratos-Rebirth

🍭 关于主题

一只移植的主题,兼具亮暗双主题,身负多种小挂件,短能卡片列首页,长能文章读更多,退可罗列全归档,进可搜索全文章,相关介绍可以参见主题说明页面哦~

构建版本 样例站点部署状态 FOSSA Status

样例站点自动部署已经上线,具体可以参照这篇日志:使用Github Actions部署主题样例站

全新的配置文档增加了!戳这里查看更多~

或者也可以去项目Wiki里面找找哦~

有为这个主题专门开发两个页面,详见Kratos-Rebirth-Specified-Pages

核心结构&样式来源:@MoeDog 狗狗大佬的Kratos的某个上古版本

💞 特别提示

  1. 为了防止更新时配置文件的更新覆盖掉您的配置文件,主题的主配置文件是需要您手动复制一份_config.yml.example,并改名为_config.yml才可正常读取与使用的,请千万不要忘记啦。之前版本的站点配置文件从这个版本开始已经不需要加入了,使用带上主题设置加载Hexo自定义功能的方法即可在代码生成阶段就完成主题配置的读取,进而在监听运行时也能完美地调用相关的配置参数。同时,也可以使用同样的方法精简掉JavaScript的配置,不必再去翻找那些被压缩得面目全非的代码啦。

  2. 这个Branch之后会持续加入一些也许是Hexo 5的新特性,这些特性未必完全兼容Hexo 4,如果您使用的是Hexo 4.x的话您可以移步hexo-4 branch哦,或是更为推荐的,将Hexo升级至5.x版本呢。

🍬超棒的赞助者们

🎁 使用环境小贴士

为了获得更佳的使用体验,建议安装的插件有:

  • hexo-generator-index-pin-top
  • hexo-generator-feed

请注意,不同版本的 Hexo 及相关附属对于此模板的兼容性可能会存在一定的冲突,此处附上开发环境的package.json

{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "build": "hexo generate && npx gulp",
    "clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server"
  },
  "hexo": {
    "version": "5.2.0"
  },
  "dependencies": {
    "hexo": "^5.2.0",
    "hexo-deployer-git": "^2.1.0",
    "hexo-generator-archive": "^1.0.0",
    "hexo-generator-category": "^1.0.0",
    "hexo-generator-feed": "^3.0.0",
    "hexo-generator-index-pin-top": "^0.2.2",
    "hexo-generator-sitemap": "^2.1.0",
    "hexo-generator-tag": "^1.0.0",
    "hexo-renderer-ejs": "^1.0.0",
    "hexo-renderer-marked": "^3.3.0",
    "hexo-renderer-stylus": "^2.0.1",
    "hexo-server": "^2.0.0"
  }
}

🍩 二次开发相关

为了保证最终上线产品的有效空间利用,我们引入了gulp对静态资源文件(js、css)进行压缩;因而您在src文件夹下直接修改的静态文件会无法实时生效,请安装gulp及相应的插件(在主题文件夹下npm install,使用npx gulp指令开启压缩与文件监听应该即可),以便压缩静态文件;

另外,单次压缩完成后不退出是正常现象(因为有watch关注文件变化,当出现静态文件变化则直接自动构建压缩后版本,无需手动再执行npx gulp;在控制台Ctrl+C可结束进程;若您不希望自动监听,而是每次都使用构建的话,您可以直接将gulpfile.js的watch那一行(第44行)注释或是删除掉均可。

💮 非常感谢

🎉 特别赞助

JetBrains

🎵 证书

  • GNU General Public License v3

FOSSA Status