Gungnir V0

A blog theme for VuePress 1. The Jekyll version of it is available here.

Notice: I'm now working on Gungnir v2 for VuePress 2. So no further update expected for Gungnir v0 except bug fixes.

Gungnir is the spear of the god Odin in Norse mythology.

English | 中文

V2

I'm now working on Gungnir v2, with the power of VuePress 2, Vue 3, Vite and Webpack 5. The new version will be written using Composition API and with a much higher dev server spinning up speed.

V2 is still WIP, see v2 branch for the progress.

Features

• Simple and beautiful
• Responsive design
• Multi-level navigation
• Switchable cover images for home page
• Dark and light mode: system theme detection with a theme-switcher to set the theme as per the user preference
• Search
• Table of contents
• Multiple syntax highlighting themes, support full screening the code blocks (inspired by WordPress theme Sakura)
• Tex support (KaTex)
• Draw charts and graphs in Markdown easily: Chart.js, Mermaid and roughViz.js
• Markdown enhancements:
  • Footnote (markdown-it-footnote)
  • Mark (markdown-it-mark)
• Analytics (Google Analytics and Baidu Tongji)
• Comment (Vssue)
• RSS
• Reading time
• Multi-language support (English, Simplified Chinese)
• Archive page with tags, links page

Installation

yarn add -D vuepress-theme-gungnir
# or
npm i -D vuepress-theme-gungnir

Demo

Here are some live demos:

• vuepress-theme-gungnir.vercel.app
• zxh.io (my blog)

Documentation

Documentation is available here.

License

VuePress theme Gungnir is Apache License 2.0 licensed, see the LICENSE file for details.