nonebot / docusaurus-theme-nonepress

Docusaurus Theme Nonepress

Installation

npx create-docusaurus@latest website classic
yarn add @nullbot/docusaurus-preset-nonepress

Modify your docusaurus.config.js:

module.exports = {
  ...
+ presets: [
+   [
+     "@nullbot/docusaurus-preset-nonepress",
+     /** @type {import('@nullbot/docusaurus-preset-nonepress').Options} */
+     ({docs: docConfig, pages: pageConfig}),
+   ]
+ ]
  ...
}

docusaurus-theme-nonepress's Issues

Feat: 优化 TOC 跳转体验

现状

右侧目录使用 IntersectionObserver 进行页面滚动跟踪，但是点击跳转到对应锚点时只会滚动到元素底部，造成视觉效果上的点击状态未更新，或者由于跳转的章节高度不够，被 observer 将状态更新到下一个章节标题。

改进方法

1. 使用 scroll-padding / scroll-margin 为 anchor 指定样式。

2. 或可以参考 Vitepress，做一个 offset 的计算 。