Wiki improvements #11323

New Issue

GiteaMirror · 2025-11-02T09:34:24-06:00

GiteaMirror commented

2025-11-02 09:34:24 -06:00

Originally created by @ghost on GitHub (Jul 24, 2023).

Feature Description

I think current wiki should be reworked in a different manner (or we should have an alternative option to host project documentation), to be more like mkdocs or hugo documentation.

Projects tend to use their own web-sites with wiki, because github/gitlab/gitea solutions are not good enough. I think that it would be great if documentation related to our projects stored in docs or wiki folder in the root directory of the project, could be automatically transformed into a wiki-like view in project space. With that approach, it would be much easier to maintain project documentation and its versions (simply render documentation from the specified commit).

I can try to create an implementation for the docs page or rework the wiki page for that purpose.

Screenshots

So that documentation in gitea can look somewhat like this:

Originally created by @ghost on GitHub (Jul 24, 2023). ### Feature Description Feature Description I think current wiki should be reworked in a different manner (or we should have an alternative option to host project documentation), to be more like [mkdocs](https://squidfunk.github.io/mkdocs-material/) or [hugo documentation](https://gohugo.io/documentation/). Projects tend to use their own web-sites with wiki, because `github`/`gitlab`/`gitea` solutions are not good enough. I think that it would be great if documentation related to our projects stored in `docs` or `wiki` folder in the root directory of the project, could be automatically transformed into a `wiki-like` view in project space. With that approach, it would be much easier to maintain project documentation and its versions (simply render documentation from the specified commit). I can try to create an implementation for the docs page or rework the wiki page for that purpose. ### Screenshots ![Screenshot from 2023-07-24 19-11-40](https://github.com/go-gitea/gitea/assets/58640116/5cfa6339-959e-4991-a7c5-149027d9b165) So that documentation in gitea can look somewhat like [this](https://squidfunk.github.io/mkdocs-material/getting-started/): ![image](https://github.com/go-gitea/gitea/assets/58640116/3cea34c8-c6ec-48ed-a95a-6d7e2f12693f)

GiteaMirror added the type/proposal label 2025-11-02 09:34:24 -06:00

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/gitea#11323