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

Hierarchy (sub directory) in Wiki #823

Open
6 tasks
MorphBonehunter opened this issue Feb 2, 2017 · 16 comments
Open
6 tasks

Hierarchy (sub directory) in Wiki #823

MorphBonehunter opened this issue Feb 2, 2017 · 16 comments
Labels
issue/confirmed Issue has been reviewed and confirmed to be present or accepted to be implemented topic/wiki type/feature Completely new functionality. Can only be merged if feature freeze is not active.

Comments

@MorphBonehunter
Copy link
Contributor

MorphBonehunter commented Feb 2, 2017

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 lunny added this to the 1.x.x milestone Feb 2, 2017
@lunny lunny added the type/feature Completely new functionality. Can only be merged if feature freeze is not active. label Feb 2, 2017
@lunny
Copy link
Member

lunny commented May 4, 2017

do you mean #822 ?

@MorphBonehunter
Copy link
Contributor Author

@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 gogs/gogs#3087 as this describes it realy well in my eyes.

@lunny
Copy link
Member

lunny commented May 5, 2017

@MorphBonehunter oh. I see.

@dakira
Copy link
Contributor

dakira commented Feb 13, 2018

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

@stale
Copy link

stale bot commented Feb 8, 2019

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.

@stale stale bot added the issue/stale label Feb 8, 2019
@lunny lunny added issue/confirmed Issue has been reviewed and confirmed to be present or accepted to be implemented and removed issue/stale labels Feb 8, 2019
@pinpox
Copy link

pinpox commented Feb 13, 2019

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

@ghost
Copy link

ghost commented May 14, 2019

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

@Cherrg
Copy link
Contributor

Cherrg commented Jun 13, 2019

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
Copy link

pinpox commented Jun 13, 2019

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)

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
Copy link
Contributor

Cherrg commented Jun 13, 2019

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
Copy link
Contributor

Cherrg commented Jun 13, 2019

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
Copy link
Contributor

Cherrg commented Jun 18, 2019

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

@ivptr
Copy link

ivptr commented Jan 10, 2022

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

@lunny
Copy link
Member

lunny commented Jan 12, 2022

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
Copy link

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

@lunny lunny removed this from the 1.x.x milestone Mar 20, 2023
@pcone
Copy link

pcone commented Sep 8, 2023

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.

@wxiaoguang wxiaoguang changed the title Hierarchy in Wiki Hierarchy (sub directory) in Wiki Oct 16, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
issue/confirmed Issue has been reviewed and confirmed to be present or accepted to be implemented topic/wiki type/feature Completely new functionality. Can only be merged if feature freeze is not active.
Projects
None yet
8 participants