=== WindBlog 标尺滚动条 ===
Contributors: hhjmk
Tags: scrollbar, scroll indicator, reading progress, ui, windblog
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

把 WindBlog 页面右侧那条带刻度与章节动画的标尺滚动条带到 WordPress。

== Description ==

WindBlog 的标尺滚动条不只是一根进度条：页面右边缘是一条带刻度的标尺，滚动时指针移动、刻度逐格点亮并显示百分比读数；文章标题会沿着导轨从底部队列升起、翻转成右侧标签；鼠标移到标尺上会展开全文位置预览，可拖动或点击跳转。

本插件是它的 WordPress 移植版：

* 文章 / 页面：按正文标题（h1–h6）分段，点击可跳转到对应章节；
* 首页 / 分类 / 标签 / 日期 / 作者 / 搜索：按文章卡片分段；
* 自动适配主题调色板（`--wp--preset--color--base/contrast/primary`），没有时按系统明暗模式回退；
* 自动避开 WordPress 后台工具栏和主题的粘性头部；
* 内容动态加载（懒加载图片、评论、区块）后自动重新测量；
* 尊重 `prefers-reduced-motion`：开启时不做逐字飞行动画，只保留静态标尺；
* 窄屏（<1024px）和触屏设备自动隐藏，交还给系统滚动条。

== Installation ==

1. 把 `windblog-ruler` 文件夹上传到 `/wp-content/plugins/`；
2. 在「插件」页面启用；
3. 到「设置 → WindBlog 标尺」选择启用页面、强调色和布局。

== Frequently Asked Questions ==

= 为什么手机上不显示？ =

标尺需要精确的鼠标指针交互和 56px 的右侧空间，窄屏和触屏设备上会遮挡内容，所以自动隐藏。

= 原来的系统滚动条去哪了？ =

桌面端默认隐藏，由标尺接管（和 WindBlog 一致）。想保留可在设置里勾选「保留系统原生滚动条」。

= 标尺压住了页面内容怎么办？ =

默认是浮在内容之上的半透明图层。如果主题内容贴边，勾选「为标尺在右侧留出 56px 空间」即可。

= 想改颜色？ =

主题或子主题里覆盖变量：

```
:root {
    --wb-ruler-accent: #e11d48;
    --wb-ruler-bg: #0b0d12;
    --wb-ruler-text: #f5f5f5;
}
```

= 文章里没有标题怎么办？ =

章节分段来自正文标题。没有标题时只显示刻度尺和百分比，不显示章节标签。

== Changelog ==

= 1.0.0 =
* 移植 WindBlog 的标尺滚动指示器，适配 WordPress 单页 / 列表 / 搜索 / 404 等页面。
