跳到正文
Sumi 中文文档已上线,部分页面暂为英文。阅读 Sumi 介绍
Sumi

本页还没有翻译,下面是 English 版本。

Releases#

Install the latest release from PyPI:

pip install --upgrade mkdocs-sumi

Sumi follows semantic versioning. Until 1.0, minor versions may change template blocks; configuration keys and Markdown syntax stay compatible.

0.1.2

最新

Landing page links to Markdown files now lead to the built pages.

  • A landing page link: guide.md in front matter now points at the page built from guide.md, not at its Markdown copy. Like a Markdown link, it is relative to the landing page and keeps its #anchor, and the build warns when the file doesn't exist.

0.1.1

API reference styling and layout fixes, found by moving the MkDocs-ng site to Sumi.

  • Style mkdocstrings API pages: signatures, symbol badges, labels and nested members.
  • Centre pages that have a table of contents but no sidebar, such as top-level pages and blog posts.
  • Drop the second rule when a page puts --- right before a heading.
  • New logo_dark theme option: a second header logo for the dark palette.
  • git_dates no longer fails on Python 3.10 when Git writes a UTC commit date as Z.

0.1.0

The first public release.

  • Theme with header tabs, sidebar, table of contents, breadcrumbs and pager.
  • Twelve native-Markdown components: callouts, tabs, steps, cards, fields, captions, file trees, Mermaid, KaTeX, keys and icons.
  • Command palette with local, CJK-aware search.
  • Landing, blog, releases and print page types.
  • Markdown copy of every page, llms.txt discovery links, Copy as Markdown.
  • English, Simplified Chinese and Traditional Chinese interface.
Esc
↵ 打开 ↑↓ 移动 Esc 关闭
键盘快捷键
Ctrl K /
打开搜索与命令面板
t
切换深色模式
[ ]
上一页 / 下一页
j k
上一个 / 下一个标题
?
显示本帮助