Giter Club home page Giter Club logo

kratos-rebirth's Introduction

Kratos-Rebirth

🍭 关于主题

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

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

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

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

或者也可以去我的博客踩踩哦~

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

💞 安装使用

  1. hexo init your-awesome-blog 初始化您的 Hexo 站点目录(已经完成则可以忽略)
  2. 进入您的站点目录,使用 npm install --save hexo-theme-kratos-rebirthyarn add hexo-theme-kratos-rebirth 安装主题。如果您有调整代码的需求,您也可以进入站点的主题目录,使用 git clone 本仓库来使用。
  3. 修改站点目录下的 _config.yml 站点配置文件,将默认的 theme: landscape 修改成 theme: kratos-rebirth
  4. 如有自定义配置的需要,为更有效地管理您的主题配置文件,您可以从该主题代码仓库中,手动复制一份 _config.yml ,并改名为 _config.kratos-rebirth.yml ,移动至您的站点目录下;或者您也可以参考 .demo 目录下的 _config.kratos-rebirth.yml 这个用于构建样例站点的配置文件扩展,将其移动至站点目录下。

每一项配置项的具体解释可以参照配置文档

🎁 使用环境小贴士

  1. hexo的官方渲染器现在也已经支持文章置顶啦,配置Front-Matter段中的sticky参数即可实现置顶降序排序,可以参见生成器的官方文档
  2. 由于使用了 ?. 运算符,在旧版本的 NodeJS 上可能出现工作不正常的情况,因而我们推荐您使用 Node v14 或更新的版本。详情请参见 可选链操作符
  3. (如果您使用的是主题目录内的配置的方案,现在已经不推荐这种方案了)为了防止主题配置文件被上传导致版本管理冲突,主题的 _config.yml 文件是默认被忽略的( .gitignore ),如果您使用远程构建部署的方式(例如 Pages 或是 Vercel 等),您需要手动添加对主题配置文件的追踪,可以使用 git add -f ./themes/kratos-rebirth/_config.yml 来恢复追踪。
  4. 如果发现代码块渲染样式出错(例如块代码被渲染成了行代码样式),可以试着检查一下是不是同时开启了 highlight 和 prismjs 的选项哦,主题对 highlight 的支持更佳呢

💬 支持的评论系统

🍩 二次开发相关

为了保证最终上线产品的有效空间利用,我们引入了gulp对静态资源文件(js、css)进行压缩;因而您在src文件夹下直接修改的静态文件会无法实时生效,请安装gulp及相应的插件(在主题文件夹下 npm install 或是 yarn )。

您可以使用 npm run build 或是 yarn build 来构建一次静态文件。

同时,为方便变化内容实时更新和多浏览器测试开发,您可以使用 npm run dev 或是 yarn dev 来运行。我们也有引入 Browser Sync 功能方便地在多个浏览器上查看变化,推荐您在 Hexo 启动后运行该指令。

💮 非常感谢

🎵 证书

  • GNU General Public License v3

FOSSA Status

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.