https://oink.pgsty.com/zh/project/implementation/ Recent content in Implementation on OINK 文档主题 Hugo zh-CN https://oink.pgsty.com/zh/project/implementation/scrollspy-patch/ Mon, 01 Jan 0001 00:00:00 +0000 https://oink.pgsty.com/zh/project/implementation/scrollspy-patch/ <p><span class="badge bg-info text-bg-info">As of Docsy 0.13.0</span></p> <div class="td-alert td-alert--md alert alert-info" role="alert"><div class="td-alert-heading alert-heading" role="heading" aria-level="4">Summary</div> <div class="td-alert-body"> <p>Docsy 0.13.0 includes a <strong>runtime patch</strong> for Bootstrap <a href="https://getbootstrap.com/docs/5.3/components/scrollspy/">ScrollSpy</a> that fixes a bug affecting pages with heading IDs that aren&rsquo;t valid CSS selectors. The patch ensures that <a href="https://oink.pgsty.com/zh/docs/content/navigation/#toc-entry-tracking">active TOC entry tracking</a> works reliably for all pages.</p> </div> </div> <h2 id="problem">Problem<a class="td-heading-self-link" href="#problem" aria-label="Heading self-link"></a></h2> <p>As of Bootstrap 5.3.8 (the version used by Docsy 0.13.0), <a href="https://getbootstrap.com/docs/5.3/components/scrollspy/">ScrollSpy</a> fails if a page contains a heading ID that is not also a valid CSS <code>#</code> selector. This can happen, for example, if a heading ID starts with a digit. For technical details about this bug, see <a href="https://github.com/google/docsy/issues/2329">#2329</a>.</p>