Loading...

Theme Features Overview

The 夜法之书 customized matery theme is deeply modified on top of the classic matery theme, incorporating architecture ideas from Fluid/Butterfly themes. Below is a quick overview of the core features — click through for detailed guides.

Content & Display

  • Layout & Pages: prev/next post navigation, copyright statement, outdate notice, TOC, ad slots; standalone pages for galleries, movies, messages, friends → Layout & Pages
  • Tag Plugins: note, timeline, tabs, GitHub card, Mermaid diagrams, PDF embed, WeChat dialog card — 15+ plugins → Tag Plugins
  • Markdown Extensions: MathJax formulas, footnotes, task lists, table enhancements, admonition containers, Chinese typography, emoji → Markdown
  • Writing Guide: Front-matter fields, excerpt handling, image reference conventions → Writing Guide
  • Wiki Subsystem: layout: wiki + wiki-sidebar.ejs sidebar directory, powering this two-column tutorial content

Interactions

  • Code Block Enhancements: line numbers, one-click copy, expand/collapse, scroll fade hint → Interaction
  • Lightbox (lightGallery), Typed.js title typing, Page Effects (sakura/ripples/snow/ribbon), Simplified-Traditional toggle
  • Reading Progress / Back-to-Top, Reward Modal, Print Styles
  • APlayer music, DPlayer video, Bilibili cards, ECharts charts
  • Preference Panel: a gear panel in the bottom-right corner centrally manages font scaling / traditional-simplified / display mode / effects / background / language, persisted across pages via localStorage → Interaction

Search & Comments

  • Three-engine search: Local + Algolia + Pagefind, invoked via Ctrl+K
  • Comments: 13 systems supported — Waline (enabled), Valine, Gitalk, Gitment, Disqus, Livere, Changyan, Twikoo, Cusdis, Giscus, Utterances, Remark42, Discuss; with comment count

Visuals & Theme

  • Dark Mode: 3-layer CSS variable architecture (config → Stylus → CSS vars), auto-adapt + manual toggle
  • Live2D Mascot: Cubism2/Cubism5 dual runtime, pure static models
  • Masonry layout + AOS scroll animations + Infinite Scroll
  • Image Lazy-loading: unified handleCard architecture (img/bg-lazy/data-lazy-src dispatch + retry anti-blank)
  • Design Tokens: radius / shadow / typography etc. centralized in the design block of _config.yml, delivered through the three-layer chain theme-config → Stylus variables → CSS variables

Security & Features

  • Post Encryption: per-tag password encryption via in-house HBE v4 (AES-256-GCM + PBKDF2) → Layout
  • RSS / Sitemap: Atom/RSS/JSON feeds + Baidu/Google sitemaps
  • PWA: Service Worker offline cache + versioned resources
  • Multilingual: Wiki system with language support (URL prefix /en/ + fallback) → Multilingual
  • Site-wide i18n: the preference panel’s language dropdown drives both Wiki content and theme UI text (preference.default_lang + lang_meta)
  • SEO Structured Data: structured-data.ejs outputs JSON-LD
  • PWA SW Auto-update: versioned SW + updatefound detection + skipWaiting for instant updates

Deployment & Performance

  • CDN acceleration: jsdelivr + automatic resource versioning (?v=x.y.z)
  • Asset minification: hexo-minify compresses JS/CSS/HTML
  • Image optimization: WebP format + weserv proxy cropping
  • jQuery Removal: the main site-wide flow has dropped jQuery (P4/P5 complete), keeping only essential plugins
  • CI/CD: tools/cicd.sh one-command release (version/tag/CDN purge fully automated) → Deploy

Looking for specific configuration? Visit Configuration Reference. Running into issues? Check the FAQ.

Comments
Data Loading...