Blog: missing integrated table of contents in pagination

[jiegec]

Context

No response

Bug description

A table of contents is generated for the index page, but not in pagination (/page/2/ etc.)

• index page: has TOC
• pagination page 2 does not have TOC

Related links

• Reporting a bug
• Setting up a blog

Reproduction

example.zip

Steps to reproduce

1. mkdocs serve
2. View localhost:8000/page/2

Browser

Chrome

Before submitting

• I have read and followed the bug reporting guidelines.
• I have attached links to the documentation, and possibly related issues and discussions.
• I assure that I have removed all customizations before submitting this bug report.
• I have attached a .zip file with a minimal reproduction.

[squidfunk]

I'm not able to reproduce the problem. The first problem is that your example is not runnable for us - it is far too big to be useful. However, I checked it on our own blog, and I'm unable to reproduce the behavior you're describing. The table of contents renders just fine on any page. For example, if I limit the number of posts to 2:

If you're still experiencing the issue, please create a minimal reproduction, and we can look into it.

[jiegec]

I have reduced to three posts, here's the new reproducer:

example.zip

[squidfunk]

This is still not a proper reproduction. There's additional JavaScript, some wavedrom snippets that we can't run, pages that don't seem to belong to the blog and are not relevant for this problem, etc.

Please remove everything that is not necessary to observe the problem. Thank you! 😊

[jiegec]

Please check this one: example.zip

[squidfunk]

Finally reproducible, thanks you!

[squidfunk]

Okay, so this is actually tricky to fix, because the integrated table of contents will only be rendered for the currently active page. Since the paginated page is not part of the navigation, but essentially a shadow of the index page, the integrated table of contents is not rendered, This does not apply for the non-integrated table of contents which is rendered just fine.

We'll address this issue as part of the refactoring which we'll be doing shortly.

[squidfunk]

Resolved in 38b7282 – it's going to be released as part of 9.2.

[squidfunk]

Released as part of 9.2.0.

[fungaren]

Still unable to work. Have you retried it? @squidfunk

[squidfunk]

Yes, and it works. Your example structure is however wrong. You have blog_dirset to . which means the posts folder must be at docs/posts, not at docs/blog/posts. If you move the folder up, it works as expected: