跳转至

克隆 MkDocs - Aaron 主题

本站内容,全部是在本地使用 Markdown 编写,然后一键同步到各平台,你看到的此网站也是使用 MkDocs 一键生成的,非常方便。

如果你也想拥有这样一个简约而不简单的站点平台,可直接拷贝和应用我特意给大家提供的 此网站模板,以简化使用门槛。

特色

  • 基于 MaterialX for MkDocs 优化和美化,内置 Zensical 一样的现代主题
  • 包含主题配色切换功能,支持自适应系统主题配色
  • 包含多语言选择功能,支持自适应本地化语言
  • 内置新一代日期作者头像插件 mkdocs-document-dates
  • 内置 GLightbox 插件,支持图像灯箱特效
  • 内置 AI i18n 多语言插件,支持 100+ 语言自由切换
  • 内置离线插件,可离线访问网站
  • 内置搜索插件、博客插件
  • 支持数理公式、化学方程式渲染
  • 支持 mermaid 绘图渲染
  • 内置侧边栏「最近更新」组件
    • 位于 docs/overrides/partials/nav.html(如不需要,删除 partials 文件夹即可)
  • 内置支持动态设定 lastmod 的 sitemap.xml 模板
  • 内置 GitHub Actions 工作流 (.github/workflows/ci.yml),支持自动部署到 GitHub Pages
  • 清爽简洁、小白易用

快速使用

前置要求:安装好 Python 3.8+

  1. 下载模板:点击下载最新模板文件 jaywhj.github.io-main.zip 并解压它(或 git clone https://github.com/jaywhj/jaywhj.github.io.git
  2. 安装依赖:在终端里切换到解压目录后,执行 pip install -r requirements.txt
  3. 编译启动:执行 mkdocs serve -omkdocs build
  4. 预览效果:打开浏览器访问 http://127.0.0.1:8000,或直接双击 site/index.html 打开

许可声明

任何人都可以免费无限制的使用此主题模板。使用后也麻烦在下面留个言以便互访 🩶


交流群

Discord: https://discord.gg/cvTfge4AUy

Wechat: