Hierarchy (sub directory) in Wiki

go-gitea / gitea

Git with a cup of tea! Painless self-hosted all-in-one software development service, including Git hosting, code review, team collaboration, package registry and CI/CD

https://gitea.com

MIT License

44.76k stars 5.47k forks source link

Hierarchy (sub directory) in Wiki #823

Open MorphBonehunter opened 7 years ago

MorphBonehunter commented 7 years ago

Feature Description

This Feature Request is about Support for Hierarchy/Subdirectories in Gitea Wiki. That includes below content.

[ ] Files Can be Put in Subdirectories from UI or git client side
[ ] Files In Subdirectories can be normally Visited from UI and git client side
[ ] Files In Subdirectories can be normally Linked in Markdown to
[ ] Subdirectories pages can be listed in the Pages View.
[ ] Files Renamed in Sudirs stay in them. (API support for Subdirs)
[ ] / in File names is interpreted as Path/folder even if it's in a Windows OS

Why the feature is necessary

I think Support for Subdirectories is a Great Feature, because:

It helps to bring better structure into a Wiki, especially for those big wiki
It would work with a lot of Tools Out of the Box like: Obsidian and Logseq

lunny commented 7 years ago

do you mean #822 ?

MorphBonehunter commented 7 years ago

@lunny: no, #822 is about table of content, this here is about "Subdirectorys" in wiki. Maybe it is easier to explain if you could please take a look at https://github.com/gogits/gogs/issues/3087 as this describes it realy well in my eyes.

lunny commented 7 years ago

@MorphBonehunter oh. I see.

dakira commented 6 years ago

Compared to Github this is actually a bug, I would say. I create subdirectories, in contrast to github, they're just irgnored, though.

stale[bot] commented 5 years ago

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs during the next 2 weeks. Thank you for your contributions.

pinpox commented 5 years ago

This would be greatly appreciated and probably not too hard to implement. Using a wiki with +300 pages is a pain without folders

ghost commented 5 years ago

Nice! That would be really great. I also have quite a few pages which isn't clear to read without folders.

Cherrg commented 5 years ago

Some modification on my script for #822 gives following:

grafik

This hijacks the page select/search and generates the page tree with this data. The container is only shown on large screens >1760px -> there is no place for the container otherwise

Is more needed? Otherwise I could create an pull request. (If #822 is done)

pinpox commented 5 years ago

Some modification on my script for #822 gives following:

This hijacks the page select/search and generates the page tree with this data. The container is only shown on large screens >1760px -> there is no place for the container otherwise

Is more needed? Otherwise I could create an pull request. (If #822 is done)

This is really nice, but not the whole thing. Having real folders allows to clone the wiki repo itself and work on it. This is actually quite usefull for lager wikis and makes import/export of .md files easy

Cherrg commented 5 years ago

done some coding, so its now possible to render wiki pages from directories. Create/update/delete pages works well. If an old page is updated, the page will be moved to subdirectory.

grafik

(Red is a is an error in repository -> file exists in old and new wiki file structure)

Images currently the images are weird:

external images: working
use absolute path: working
use relative path:
- currently the path has to be relative to <giteaurl>/<user>/<repo>/<wiki>/ -> also on every wiki sub page
- i could try to add some JS to rewrite relative urls on rendered wiki pages
  - I think thats a bad idea -> toggle JS on/off will enable/disable working images -> so there need to be an update on wiki renderer -> Any better suggestions?

Does anyone has a good idea where to place the 'table of pages/wiki tree' on small screens?

Cherrg commented 5 years ago

You could try it out on this branch: https://github.com/Cherrg/gitea/tree/gitea_wiki_page_toc I will create an PR if #822 is done

Cherrg commented 5 years ago

Found some solutions for both questions, see images in pull request.

ivptr commented 2 years ago

Any update on this? This could be a good solution for migration from Confluence.

lunny commented 2 years ago

Any update on this? This could be a good solution for migration from Confluence.

You can find a PR in #7225 . But there are some different opinions about how to display the hierarchy tree.

matthias-colt commented 1 year ago

would be great to get this on the Plans for Gitea 1.19 #21598 at least, if it can be added in 1.18

pcone commented 1 year ago

Please consider hierarchical pages rather than a structure where folders and pages are treated differently.

By this I mean pages would have a tree structure with parents and children, but parent nodes have page content just like children do.

See the wiki system in Azure DevOps for an example of this behaviour.