wiki icon indicating copy to clipboard operation
wiki copied to clipboard

Enhancing Main Page of Wiki with Mind Map-style Sitemap

Open xsub opened this issue 2 years ago • 2 comments

We propose enhancing the main page of the wiki by adding a mind map-style sitemap. This visual representation will provide users with a more intuitive way to navigate through the various sections of the wiki, helping them quickly locate relevant information and improving overall user experience.

Feature Details:

  • Integrate a mind map-style sitemap on the main page of the wiki.
  • The sitemap will visually represent the hierarchy of sections, categories, and pages within the wiki.
  • Each node in the mind map will represent a category or a page, and clicking on a node will take the user directly to the respective content.
  • The mind map will be interactive, allowing users to expand and collapse nodes for easier navigation and also understand what is available.

Notes:

We are considering using the markmap extension for markdown, which provides the exact functionality we're looking for. You can see live experiments with it here: Markmap Live Experiment.

Static example (I also like this form, we just could not agree on expanding just one branch (Security Guides) to the leaves level):

AlmaLinux-Wiki-Sitemap-static

The attached picture was created using the following code:


# AlmaLinux Wiki _
## About 
## Contribute _
 - Help AlmaLinux OS _
 - Mirrors
## Development _
- Building Packages Guide _
- Modified Packages (list) _
- Packaging Guideline _
## Documentation _
 - EL 8 Distro Comparison _
 - FAQ
 - Howtos
 - Release Notes _
 ### Security Guides _
 - AlmaLinux Security Central _
 - Errata
- OpenSCAP Guide _
- OpenSCAP Guide for 9 _
- SBOM Guide _
## Installation _
- AlmaLinux Installation Guide _
- AlmaLinux WSL _
- Live Media _
- Raspberry Pi _
- Cloud Images
- Containers
- Repositories
## Migration _
- Migration Guide _
- Elevate Project _
## The Foundation _
- AlmaLinux OS Foundation _
- Election 2022 _
- Google Summer Of Code _
- Special Interest Groups _

xsub avatar Aug 11 '23 22:08 xsub

@xsub this would be a very visually appealing addition to the page, but it would be out of date as soon as the navigation was updated. Do we have plans for how to keep it up to date in the future?

bennyvasquez avatar Jan 15 '24 21:01 bennyvasquez

This should be integrated into the CI to avoid anything manual.

codyro avatar Jan 16 '24 19:01 codyro