New table of contents feature (6.x and 7.x)

Created on 5 June 2010, about 14 years ago
Updated 13 June 2023, about 1 year ago

With longer help pages, I think it is helpful to have an automatically generated table of contents block.

Before including such a mechanism in advanced_help proper, I've created one as a tiny separate module, to gather opinions/comments. The initial version if attached, and the repository is live on http://git.osinet.eu/drupal/modules/ah_toc.git/

✨ Feature request
Status

Closed: outdated

Version

1.0

Component

Code

Created by

πŸ‡«πŸ‡·France fgm Paris, France

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

  • πŸ‡³πŸ‡΄Norway gisle Norway

    12 years without activity.

  • πŸ‡«πŸ‡·France fgm Paris, France

    @gisle AFAICS it's still a missing feature on the D8+ version. Interested in my rerolling it ?

  • πŸ‡³πŸ‡΄Norway gisle Norway

    Yes, this feature is still missing.

    Since this feature was initially suggested (in 2010, for Drupal 6) the ambitions for this module has become significantly lower. Back in 2010, the then main maintainer (merlinofchaos) envisaged that this module should become part of core, and also that it would be used on Drupal.org itself for creating handbooks and online user manuals. This is no longer the case. Instead Help Topics 🌱 Help Topics module roadmap: the path to beta and stable Fixed the Tour β†’ is being developed, and will probably at one point obsolete this project for all new online help. To be frank, I don't see much need for such a feature for the relatively short help texts that this module is being used for.

    As the current main maintainer, I think that Advanced Help still need to be developed for Drupal 10. However, its main use case now is to allow the Drupal 7 projects that depends on it for online help to be upgraded to Drupal 10 without having to convert their help files to the newer help formats that is now provided by core. For that end, fixing Drupal 7 regressions is my highest priority. Take a look at the child issues of 🌱 [meta] Regressions vis-à-vis Drupal 7 Active . If you have some time available, helping out getting those resolved would be most appreciated.

    As for rerolling your table of contents feature for Drupal 10, feel free to reopen this issue if you still feel the module will benefit from it being added. Note that both .html and .md is supported for help text, so a table of contents should work with both markup formats. If this feature can be implemented as a submodule that cam be installed independently, I would prefer that solution.

    PS: In comment #6, it is suggested that those looking for this may use Table of Contents β†’ – but that module looks pretty abandoned.

  • πŸ‡«πŸ‡·France fgm Paris, France

    I understand your decision, thanks.

    The main reason why I implemented it was for client projects where modules had significant/longer documentation in A.H.. I'll have a look at what it entails on the current version. IIRC it's just a small bit of JS, probably using jQuery at the time but no longer needing it these days.

Production build 0.69.0 2024