Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Special handling of packages main page #1037

Open
Julow opened this issue Nov 10, 2023 · 0 comments
Open

Special handling of packages main page #1037

Julow opened this issue Nov 10, 2023 · 0 comments

Comments

@Julow
Copy link
Collaborator

Julow commented Nov 10, 2023

Every pages and modules in a package must have a parent page, which is sometimes generated by the driver.
Drivers also want a "package list" page, listing all the packages they have build documentation for.

This is hard to implement with the current --parent flag, as the "package list" page becomes a dependency of everything else.
Drivers currently have to use a dummy page (for example, empty) as the parent of every packages and to swap this dummy page for the final "package list" page in the html output.

How to remove the need to pass the --parent when building the package main page while supporting the "package list" page and the other things we'll want in the future (cross package references, references to a package main page, package-scroped navigation side bar) ?

@Julow Julow changed the title Package main page Special handling of packages main page Nov 10, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant