executablebooks / sphinx-book-theme

A clean book theme for scientific explanations and documentation with Sphinx
https://sphinx-book-theme.readthedocs.io
BSD 3-Clause "New" or "Revised" License
438 stars 201 forks source link

no table of contents marker on sections with more than 110 lines #805

Open v-au opened 10 months ago

v-au commented 10 months ago

Describe the bug

context When a section contains more than 110 lines the table of contents marker is not displayed

expectation I expected the marker to jump to the corresponding section in the ToC as I move up and down the page.

bug But instead the marker disappears, and reappears when I reach a section with less than 110 lines. See the attached screen recording.

problem This is a problem for people using larger sections.

https://github.com/executablebooks/sphinx-book-theme/assets/86463740/238d2c2e-310d-4fb3-8a41-652984cceebe

Reproduce the bug

S1

S1.1

line 1

line 2

line 3

line 4

line 5

line 6

line 7

line 8

line 9

line 10

line 11

line 12

line 13

line 14

line 15

line 16

line 17

line 18

line 19

line 20

line 21

line 22

line 23

line 24

line 25

line 26

line 27

line 28

line 29

line 30

line 31

line 32

line 33

line 34

line 35

line 36

line 37

line 38

line 39

line 40

line 41

line 42

line 43

line 44

line 45

line 46

line 47

line 48

line 49

line 50

line 51

line 52

line 53

S1.2

line 1

line 2

line 3

line 4

line 5

line 6

line 7

line 8

line 9

line 10

line 11

line 12

line 13

line 14

line 15

line 16

line 17

line 18

line 19

line 20

line 21

line 22

line 23

line 24

line 25

line 26

line 27

line 28

line 29

line 30

line 31

line 32

line 33

line 34

line 35

line 36

line 37

line 38

line 39

line 40

line 41

line 42

line 43

line 44

line 45

line 46

line 47

line 48

line 49

line 50

line 51

line 52

line 53

S2

S2.1

line 1

line 2

line 3

line 4

line 5

line 6

line 7

line 8

line 9

line 10

line 11

line 12

line 13

line 14

line 15

line 16

line 17

line 18

line 19

line 20

line 21

line 22

line 23

line 24

line 25

line 26

line 27

line 28

line 29

line 30

line 31

line 32

line 33

line 34

line 35

line 36

line 37

line 38

line 39

line 40

line 41

line 42

line 43

line 44

line 45

line 46

line 47

line 48

line 49

line 50

line 51

line 52

line 53

S2.2

line 1

line 2

line 3

line 4

line 5

line 6

line 7

line 8

line 9

line 10

line 11

line 12

line 13

line 14

line 15

line 16

line 17

line 18

line 19

line 20

line 21

line 22

line 23

line 24

line 25

line 26

line 27

line 28

line 29

line 30

line 31

line 32

line 33

line 34

line 35

line 36

line 37

line 38

line 39

line 40

line 41

line 42

line 43

line 44

line 45

line 46

line 47

line 48

line 49

line 50

line 51

line 52

line 53

- `conf.py`
```python
# Configuration file for the Sphinx documentation builder.
#
# For the full list of built-in configuration values, see the documentation:
# https://www.sphinx-doc.org/en/master/usage/configuration.html

# -- Project information -----------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information

project = 'test'
copyright = '2024, t'
author = 't'

# -- General configuration ---------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

extensions = []

templates_path = ['_templates']
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', '.sphinx-virtualenv']

# -- Options for HTML output -------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output

html_theme = 'sphinx_book_theme'
html_static_path = ['_static']

List your environment

environment

$ type pip
pip is hashed (/tmp/ebp/.sphinx-virtualenv/bin/pip)
$ pip freeze --all
accessible-pygments==0.0.4
alabaster==0.7.13
Babel==2.14.0
beautifulsoup4==4.12.2
certifi==2023.11.17
charset-normalizer==3.3.2
docutils==0.20.1
idna==3.6
imagesize==1.4.1
Jinja2==3.1.2
MarkupSafe==2.1.3
packaging==23.2
pip==22.0.2
pydata-sphinx-theme==0.15.1
Pygments==2.17.2
requests==2.31.0
setuptools==59.6.0
snowballstemmer==2.2.0
soupsieve==2.5
Sphinx==7.2.6
sphinx-book-theme==1.1.0
sphinxcontrib-applehelp==1.0.7
sphinxcontrib-devhelp==1.0.5
sphinxcontrib-htmlhelp==2.0.4
sphinxcontrib-jsmath==1.0.1
sphinxcontrib-qthelp==1.0.6
sphinxcontrib-serializinghtml==1.1.9
typing_extensions==4.9.0
urllib3==2.1.0
wheel==0.37.1
$ 
$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 20.04.6 LTS
Release:        20.04
Codename:       focal
welcome[bot] commented 10 months ago

Thanks for opening your first issue here! Engagement like this is essential for open source projects! :hugs:
If you haven't done so already, check out EBP's Code of Conduct. Also, please try to follow the issue template as it helps other community members to contribute more effectively.
If your issue is a feature request, others may react to it, to raise its prominence (see Feature Voting).
Welcome to the EBP community! :tada:

ngulden commented 8 months ago

I see the same behavior at https://docs.software-univention.de/manual/latest/en/ip-config/radius.html#mac-authentication-bypass-with-computer-objects

I use SBT and customize the CSS to build the document. When you open the link in Firefox, the right sidebar should have 11.2.6.4 highlighted. In some cases it is, it some not. Scrolling up and down, marks the toc entry active or not.

I use SBT 1.1.0.

You can find the sources for the linked page above at https://raw.githubusercontent.com/univention/univention-corporate-server/5.0-6/doc/manual/ip-config/radius.rst

chen19901225 commented 2 months ago

does it fixed?