Skip to content
This repository has been archived by the owner on Oct 30, 2024. It is now read-only.

Archive pages? #112

Open
stufisher opened this issue Oct 6, 2015 · 1 comment
Open

Archive pages? #112

stufisher opened this issue Oct 6, 2015 · 1 comment

Comments

@stufisher
Copy link

Is there a particular reason this is disabled on archive pages? Its very easy to make it work on these pages by editing lines 279 & 1414, but it would be nice if it supported archive pages without needing to be edited each release...

@zedzedzed
Copy link
Owner

This was intentional as it is designed for the majority of users. That is, archived pages usually do not display the entire content for the articles being listed otherwise the result would be a very long page (10 x full articles per page by default). So for the majority of users, the outputted articles would be excerpts so the table of contents for these excerpts wouldn't make much sense and would link to the limited number of headings found in the excerpts.

On a minor technical note, the DOM ID for the table of contents container is toc_container. The HTML specifications do not allow for duplicate IDs. Although it works OK, you may find you have unexpected experiences hiding/showing the index of everything but the first list. The solution would be to use an HTML class rather than an ID but this would take a few versions to flush through as other users may have applied custom CSS or javascript that relied on the ID.

On a related note, the collision detector would not be persistent across table of contents so you may end up with multiple headings with the same anchor, of which only the first would be linked to. Eg: your first article has a heading named "Bacon and Egg" resulting in an anchor of "#Bacon_and_Egg". However, you have used the same heading in other articles producing the same anchor and when clicked on, will only go to the heading of the first article. In contrast, when this occurs on a single page, the plugin will keep tabs of the number of occurences of the same headings and will apply a unique count to the end producing unique anchors.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants