#216 Index page support for wikis

Open
opened 1 month ago by ncc1988 · 1 comments
ncc1988 commented 1 month ago

Repositories automatically get a description if there is a markdown file. I would like to do the same in a project’s wiki to get the documentation structurised by topic and using a hierarchy for pages.

This is how it could work:

There is an automatism that looks for a file called “index.md”. If it exists, it is used as index page. That file may contain links to other wiki pages in the same directory or in subdirectories of the wiki repository. “Second layer” index pages may also exist and link to “third layer” pages inside subdirectories of subdirectories of the wiki repository (and so on).

In case there is no “index.md” file, the page list is shown like it is currently the case. To get the page list in the case that an “index.md” file exists, buttons (like the “Labels” and “Milestones” button) could be added to switch between the page view and the page list.

Repositories automatically get a description if there is a markdown file. I would like to do the same in a project's wiki to get the documentation structurised by topic and using a hierarchy for pages. This is how it could work: There is an automatism that looks for a file called "index.md". If it exists, it is used as index page. That file may contain links to other wiki pages in the same directory or in subdirectories of the wiki repository. "Second layer" index pages may also exist and link to "third layer" pages inside subdirectories of subdirectories of the wiki repository (and so on). In case there is no "index.md" file, the page list is shown like it is currently the case. To get the page list in the case that an "index.md" file exists, buttons (like the "Labels" and "Milestones" button) could be added to switch between the page view and the page list.
hw commented 1 month ago
Owner

This would be a patch to gitea, right? PR welcome!

This would be a patch to gitea, right? PR welcome!
Sign in to join this conversation.
No Milestone
No Assignees
2 Participants
Notifications
Due Date

No due date set.

Dependencies

This issue currently doesn't have any dependencies.

Loading…
There is no content yet.