Profile
Back to NewsBack
GitHub Trending 2 min
Reader Mode
ppoffice/hexo-theme-icarus: A simple, delicate, and modern theme for the static site generator Hexo.

ppoffice/hexo-theme-icarus: A simple, delicate, and modern theme for the static site generator Hexo.

20 hours ago

Icarus

npm version npm downloads Test License

A simple, delicate, and modern theme for the static site generator Hexo.
Preview · Documentation · Discussions · 简体中文

!Icarus

Quick Start

For a published install, in the root directory of a Hexo site compatible with ^7.1.1 || ^8.0.0:

npm install hexo-theme-icarus hexo-renderer-inferno
hexo config theme icarus
hexo server

Icarus creates _config.icarus.yml, with every option described, on the first run. See Getting Started for requirements, source installs, and the distinction between published packages and the current development checkout.

Highlights

Dark appearance

Light, dark, or both
Follow each visitor's system setting with appearance: auto, or go dark everywhere.

Cyberpunk variant

Cyberpunk variant
A second look of neon-lit nights, HUD frames and scanlines, one line away.

Responsive layout

Responsive
One to three columns, navbar sub-menus that fold into a menu button, an optional sticky navbar (navbar.sticky), and a mobile table of contents.

Per-page configuration

Configure per page
Set options site-wide, override them per layout in _config.post.yml, or per post in its front-matter.

Waline comments in the dark appearance

40+ plugins built in
Comments, search, sharing, donations, analytics and widgets, ready to switch on in the config.

Navbar sub-menu opened with the keyboard

Fast and accessible
PJAX page loading, keyboard and screen reader support, and translations into 17 languages.

Supported plugins

| Type | Plugins | |---|---| | Comment | Artalk, Beaudar, Changyan, Cusdis, Disqus, DisqusJS, Facebook, Giscus, Gitalk 2 (preview), Gitment (deprecated), Isso, LiveRe, Twikoo, Utterances, Valine (deprecated), Waline | | Search | Algolia, Baidu, Google CSE, Insight (built-in) | | Share | AddToAny, Baidu Share (deprecated), Web Share, ShareThis | | Donate | Afdian, Alipay, Buy Me a Coffee, Patreon, PayPal, WeChat Pay | | Analytics | Baidu Statistics, Bing Webmaster, BuSuanZi, CNZZ, Google Analytics, Hotjar, Matomo, StatCounter, Twitter Conversion Tracking, Umami, Waline page views | | Widgets | Profile, Table of Contents, Recent Posts, Archives, Categories, Tags, GitHub Contributions, Links, Google AdSense, follow.it, Google FeedBurner (deprecated) | | Others | Back to Top, Cookie Consent, Gallery (lightGallery + Justified Gallery), KaTeX, MathJax 4, Browser Capability Notice, Page Loading Animations, Page Prefetching on Hover, Progress Bar |

Most plugins are provided by hexo-component-inferno.

Documentation

Getting Started · Configuring the Theme · Upgrade Guide · FAQ · All Guides

Contributing

Bug reports, feature ideas, translations and tutorials are all welcome. Open an issue or a pull request.

Icarus is built with Hexo, Inferno, Stylus and Bulma. To work on it:

npm ci
npm run lint
npm test            # unit and integration tests
npm run test:e2e    # browser tests; run "npx playwright install chromium" once first

The tests need Node.js 20.19 or later. See the contributing guide for code style and commit conventions.

License

MIT

Chat with me