Skip to content

📑 Powerful, elegant and modern Hexo theme, forked from hexo-theme-stellar.

License

Notifications You must be signed in to change notification settings

chiyuki0325/hexo-theme-stellaris

Repository files navigation

📑 Stellaris - 强大、优雅、现代的 Hexo 主题

hexo-theme-stellaris 分叉自 hexo-theme-stellar,基于hexo-renderer-jsx,支持丰富的标签和动态数据组件。

本主题目前已不再活跃维护,并不再同步 Stellar 的新功能特性。如对追新有需求,请使用上游 Stellar 主题,或在 issue 中提交需要使用的新功能。

安装

  • 环境需求
    Hexo: 5.4.0 ~ 6.3.0
    hexo-cli: 4.3.0 ~ latest
    node.js: 14.17.3 ~ 18.12.0
    npm: 6.14.13 ~ 8.19.2
    

使用 Git 安装

  • 安装依赖

    npm install react react-dom hexo-renderer-jsx html-react-parser --save
    npm install node-fetch@2 --save
    // bilicard 插件所需
  • 将主题安装为子模块

    git submodule add https://github.com/chiyuki0325/hexo-theme-stellaris.git themes/stellaris

使用 npm 安装

npm install hexo-theme-stellaris --save

安装好后,在 config.yml 中添加 theme: stellaris

更新

使用 Git

git submodule update --remote --merge

使用 npm

npm update hexo-theme-stellaris

文档

点此查看 Stellaris 主题文档。

也可以适当参考 原主题文档,或对照配置文件的注释。

相关文章推荐

要启用此功能,请先安装 hexo-related-popular-posts,之后在配置文件中启用 article.related_posts

article:
  related_posts:
    enable: true
    max_count: 5

配置的变更

  • 预加载插件改为 InstantClick。

    plugins:
      instant_click:
        js: https://cdn.bootcdn.net/ajax/libs/instantclick/3.1.0/instantclick.min.js
  • 颜色配置部分进行了一些修改,详见配置文件。

  • 支持自定义字体,详见配置文件。

  • 增加了文章过期提示功能。

    article:
      outdate_month: 2

    发布于 3 个月前,更新于 3 个月前,文章内容可能已经过时

  • MathJax 增加了 per_page 选项,开启后无需在每个页面的 front-matter 处添加 mathjax: true 即可开启 MathJax。

    plugins:
      # MathJax
      # 需在 Markdown 文件开头加入 mathjax: true
      # 推荐使用 Pandoc: npm uninstall hexo-renderer-marked --save & npm install hexo-renderer-pandoc --save
      mathjax:
        enable: false
        per_page: false # 启用后无需在文章开头加 mathjax: true 即可启用
        js: https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js # 请使用 3.x 以上版本的 mathjax
  • 本主题没有移植原主题的一些功能(因为我没有用到,比如时间线,友链朋友圈和赫蹏),如有需要请在 issue 中提出,我会进行移植。

标签插件

  • 原主题更名数次的 ablock 容器标签被改回了 border。

    {% border [color:color] [child:codeblock/tabs] title %}
    body
    {% endborder %}
  • 新增了行内图片标签 icon。

    {% icon source [height:1.75em] %}
  • 新增了 Bilibili 视频卡片插件 bilicard。

    {% bilicard BVID %}

Telegram Instant View

本主题编写了模板以适配 Telegram Instant View。

你可以在此获取模板,并且查阅官方文档以了解如何在你的博客中使用。

About

📑 Powerful, elegant and modern Hexo theme, forked from hexo-theme-stellar.

Resources

License

Stars

Watchers

Forks

Packages

No packages published