Implement table of content

[kelson42]

This is a really old feature request, for Kiwix Desktop 1.0 too.

See this old ticket: https://sourceforge.net/p/kiwix/feature-requests/1000/

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be now be reviewed manually. Thank you for your contributions.

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be now be reviewed manually. Thank you for your contributions.

[kelson42]

The strategy here is:

• Implement ZIM API to retrieve TOC (here is the ticket for MWoffliner for example https://github.com/openzim/mwoffliner/issues/596)
• Implement client feature in Kiwix Desktop

[knowledge-is-power]

@kelson42 Hi. i saw this issue before opening my own. the fact that this thread is 4 years old without any progress in sight compelled me to make a fresh one. i would like to just clarify here that wikipedia zims already contain the ToCs and Templates(nav boxes). it's just that the kiwix-desktop application is unable to show them. If the kiwix pwa is able to show this stuff, i suppose the same feature could be easily implemented in kiwix-desktop app by borrowing the same feature from pwa. i don't understand why this is not being done? can you please comment on the following two strategies of such implementation (originally presented by @Jaifroid):

• Introduce Desktop CSS (as an option) for Kiwix Desktop -- clearly this makes a lot of sense for an app that targets desktop users;
• Display hidden navboxes -- an option to force-unhide these would be a "quick fix" and could be made available without swapping CSS for the article. It could be done as part of the JS API project.

[Jaifroid]

@knowledge-is-power Just to be clear, the ToC is not in the Wikipedia archives (not even hidden) so it needs to be constructed dynamically from the headers in the article. This isn't too hard, and some work was done on it in this PR, but then stalled. Reader software can implement a generic ToC if an article has H1, H2, H3 etc., but it's probably best done inside the ZIM.

Navboxes, etc., are another matter. These are mostly in the Wikipedia ZIMs, but are hidden by the mobile style, so have to be force-unhidden (unless desktop CSS can be applied).

[knowledge-is-power]

@Jaifroid Ah, I see. thanks for the clarification. my main concern is actually the navboxes (which are very imp for extended exploration). so, will there be any work done towards force-unhiding or getting desktop css in kiwix-desktop application?

[Jaifroid]

@knowledge-is-power Just so you're aware, Kiwix JS isn't just a PWA, we also have installable packages for various platforms, and packages for Linux as well as Windows. See http://kiwix.github.io/kiwix-js-windows/kiwix-js-electron.html. Although it's not the full-featured Desktop app, it works very well with Wikimedia archives (and many others too). It's good to have options!

[kelson42]

Reminder: please one topic per ticket, here you mixed two topics which have nothing in common:

• box collapsing
• TOC

For the rest, the way forward is pretty known, we just need to have the development resources. It's an old problem, but this is on the roadmap and this will be fixed/implemented at some point.

[knowledge-is-power]

@kelson42 yeah I thought both issues were part of the same problem that's why I made a single ticket, sorry about that. now that its clear to me that they are unrelated, is it okay if i open a dedicated ticket for wiki navboxes/templates? (cuz this ticket is dedicated to ToC issue)

[juuz0]

I created a ticket here #869