Uploaded image for project: 'XWiki Platform'
  1. XWiki Platform
  2. XWIKI-16452

Navigate to Next/Previous Sibling Feature

Details

    • Idea
    • Resolution: Unresolved
    • Minor
    • None
    • 10.11.8
    • Display
    • None
    • Unknown

    Description

      Requested feature: new page navigation features

      • Provide a feature to navigate to the next / previous "sibling page" (page below the same parent page) from within the page.
      • Maybe also provide a feature to navigate to the first child page, and maye to navigate "upwards", from within the page.

      Rationale:

      After importing a Word document using the Office importer, splitting the chapters to individual pages. I noticed a missing feature which also might be very handy in many other situations in Xwiki:

      In Wikis, you sometimes have individual pages which more or less stand on their own, and on the other hand you often have pages which logically belong together, i.e. in which case a "linear" information flow is split accross several pages.

      In case of an imported office document split to many pages, we get many pages logically connected with a common thread / "sequential information flow".

      In the resulting pages I immediately missed an option to easily jump to the "next" or "previous" section / page.

      This could be added to the office importer application, of course, which could generate the naviation links, but I think the general feature is more universal. Imported office documents are not the only example of sequentially connected pages, and a more general solution to this approach would make much more sense.

      On the other hand, there are probably many use cases where sibling pages to not share such a sequential relation, so it might make sense to be able to enable / disable it explicitly for a page(hierarchy).

      (However, maybe those new navigation features would not hurt even in case of pages which do not actually have such a linear information flow / common thread.)

      (Not sure if I assigned this issue to the richt product / component, please re-assign if there are more appropriate options.)

      Attachments

        Issue Links

          Activity

            [XWIKI-16452] Navigate to Next/Previous Sibling Feature
            GOhrner Gunter Ohrner added a comment -

            This suggested feature would definitely benefit from a more precise sibling page ordering mechanism, as suggested in XWIKI-16453 "Provide Some Explicit "Ordering" for Pages and Sub-Spaces in a Given Space".

            GOhrner Gunter Ohrner added a comment - This suggested feature would definitely benefit from a more precise sibling page ordering mechanism, as suggested in  XWIKI-16453 "Provide Some Explicit "Ordering" for Pages and Sub-Spaces in a Given Space".
            GOhrner Gunter Ohrner added a comment - - edited

            Do you have a mockup/idea on how it could be displayed on screen (where?)?

            I gave it a shot - mind you, I'm no UI designer...

            Note that instead of the generic labels "previous", "up", and so on maybe it would be more user-friendly to include the actual page titles of the target pages there instead...

             

            Examples of online manuals showing similar navigation options:

             

            (Note that those manuals linked above usually define "next" to lead to the first sub-page, and they do not provide an explicit "subsection" link instead. Maybe this would be a more common convention users are more used to. So repeatedly clicking "next" would recursively walk through the whole manual until the last page is reached, descending and re-ascending as required, while "previous" works analoguously.)

             

            As it inevitably adds visual clutter to the page, it might be a good idea to allow enabling / disabling on a page-by-page (or maybe page-hierarchy-by-page-hierarchy) base, or maybe in a user specific way such that user A who likes it can see those controls and user B who hates it can disable them...

            GOhrner Gunter Ohrner added a comment - - edited Do you have a mockup/idea on how it could be displayed on screen (where?)? I gave it a shot - mind you, I'm no UI designer... Note that instead of the generic labels "previous", "up", and so on maybe it would be more user-friendly to include the actual page titles of the target pages there instead...   Examples of online manuals showing similar navigation options: http://svnbook.red-bean.com/en/1.7/svn.preface.organization.html https://www.postgresql.org/docs/11/xplang.html https://dev.mysql.com/doc/refman/8.0/en/language-structure.html   (Note that those manuals linked above usually define "next" to lead to the first sub-page, and they do not provide an explicit "subsection" link instead. Maybe this would be a more common convention users are more used to. So repeatedly clicking "next" would recursively walk through the whole manual until the last page is reached, descending and re-ascending as required, while "previous" works analoguously.)   As it inevitably adds visual clutter to the page, it might be a good idea to allow enabling / disabling on a page-by-page (or maybe page-hierarchy-by-page-hierarchy) base, or maybe in a user specific way such that user A who likes it can see those controls and user B who hates it can disable them...
            GOhrner Gunter Ohrner added a comment -

            Yes it makes sense in this specific use case because there's an order for the split (by split heading).

            However, I don't see how it work in a generic way.

            So for me this feature is more a feature related to the office import module.

            Actually, it was my first though that the Office Importer should generate such navigation links into the imported pages.

            But then it struck me that the concept is much more general and also applies to content purely created in the wiki from scratch. So adding it to the Office importer would probably be a more simple solution which would immediately help when importing office documents, but would not be usable for other content.

            Also "hard references" generated into the actual page source would not adapt to modifications applied to the linked pages - so what if I insert a whole new section F between previous sections D and G? The links generated into D will still point to G instead of F, the same holds for the links in G pointing to D, and I have to edit and adjust everything. (With the risk of forgetting to do so, creating a link mess.)

             

            BTW, sorry for getting the prio wrong on issue creation. This wishlist entry clearly is no "important" feature or worse, though I consider it to be "nice to have".

            GOhrner Gunter Ohrner added a comment - Yes it makes sense in this specific use case because there's an order for the split (by split heading). However, I don't see how it work in a generic way. So for me this feature is more a feature related to the office import module. Actually, it was my first though that the Office Importer should generate such navigation links into the imported pages. But then it struck me that the concept is much more general and also applies to content purely created in the wiki from scratch. So adding it to the Office importer would probably be a more simple solution which would immediately help when importing office documents, but would not be usable for other content. Also "hard references" generated into the actual page source would not adapt to modifications applied to the linked pages - so what if I insert a whole new section F between previous sections D and G? The links generated into D will still point to G instead of F, the same holds for the links in G pointing to D, and I have to edit and adjust everything. (With the risk of forgetting to do so, creating a link mess.)   BTW, sorry for getting the prio wrong on issue creation. This wishlist entry clearly is no "important" feature or worse, though I consider it to be "nice to have".
            GOhrner Gunter Ohrner added a comment -

            > Provide a feature to navigate to the next / previous "sibling page" (page below the same parent page) from within the page.

            What does next mean? Next based on the page name? Based on the title name? Based on the data the page was created?

            I created a new wishlist entry which asks for the addition of an explicit "page/space ordering" feature in XWIKI: XWIKI-16453

            GOhrner Gunter Ohrner added a comment - > Provide a feature to navigate to the next / previous "sibling page" (page below the same parent page) from within the page. What does next mean? Next based on the page name? Based on the title name? Based on the data the page was created? I created a new wishlist entry which asks for the addition of an explicit "page/space ordering" feature in XWIKI:  XWIKI-16453
            vmassol Vincent Massol added a comment -

            Do you have a mockup/idea on how it could be displayed on screen (where?)?

            vmassol Vincent Massol added a comment - Do you have a mockup/idea on how it could be displayed on screen (where?)?
            vmassol Vincent Massol added a comment -

            On the other hand, a manual imported into Xwiki and split across several pages would - in my point of view - benefit a lot from this feature.

            Yes it makes sense in this specific use case because there's an order for the split (by split heading).

            However, I don't see how it work in a generic way.

            So for me this feature is more a feature related to the office import module.

            vmassol Vincent Massol added a comment - On the other hand, a manual imported into Xwiki and split across several pages would - in my point of view - benefit a lot from this feature. Yes it makes sense in this specific use case because there's an order for the split (by split heading). However, I don't see how it work in a generic way. So for me this feature is more a feature related to the office import module.
            GOhrner Gunter Ohrner added a comment -

            > Provide a feature to navigate to the next / previous "sibling page" (page below the same parent page) from within the page.

            What does next mean? Next based on the page name? Based on the title name? Based on the data the page was created?

            "Next" / "Previous" in the sense how the pages are displayed in the page tree / breadcrumb menu.

            (This leads to another feature suggestion I'm carrying in my head for some time - provide a way to add some kind of "sort order" to pages such that the ordering can be influenced without specifically doctoring the page titles. This would also help managing "sequential" information distributed accross multiple pages.)

            Also we already provide this feature in the breadcrumb where you can navigate to siblings easily. Wouldn't that fix your need? (see screenshots at https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/ContentOrganization/#HUsingNestedPages ).

            This feature is definitely valuable. In addition, our Wiki also shows the page tree in the left-hand menu bar to simplify navigation.

             

            However, the natural for at least for forward navigation is that I read a page and once I reach the end I want to continue reading on the "next" page. Having to scroll up, open the breadcrumb menu or locate the page tree, locate the current page (which, granted, is simple, as it's highlighted) and select the next document in the list breaks the "natural" flow in my opinion.

             

            The "forward / backward" navigation feature definitely would not replace the breadcrumb navigation, it would rather amend it. And there's also definitely content where it's more fitting / appropriate, and on the other hand content where it's less so.

            Example Wikipedia: A next/previous button which jumps from one article to the next or preceeding one would not be too helpful. It probably would not hurt, but it also wouldn't really be needed.

            On the other hand, a manual imported into Xwiki and split across several pages would - in my point of view - benefit a lot from this feature.

            GOhrner Gunter Ohrner added a comment - > Provide a feature to navigate to the next / previous "sibling page" (page below the same parent page) from within the page. What does next mean? Next based on the page name? Based on the title name? Based on the data the page was created? "Next" / "Previous" in the sense how the pages are displayed in the page tree / breadcrumb menu. (This leads to another feature suggestion I'm carrying in my head for some time - provide a way to add some kind of "sort order" to pages such that the ordering can be influenced without specifically doctoring the page titles. This would also help managing "sequential" information distributed accross multiple pages.) Also we already provide this feature in the breadcrumb where you can navigate to siblings easily. Wouldn't that fix your need? (see screenshots at  https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/ContentOrganization/#HUsingNestedPages  ). This feature is definitely valuable. In addition, our Wiki also shows the page tree in the left-hand menu bar to simplify navigation.   However, the natural for at least for forward navigation is that I read a page and once I reach the end I want to continue reading on the "next" page. Having to scroll up, open the breadcrumb menu or locate the page tree, locate the current page (which, granted, is simple, as it's highlighted) and select the next document in the list breaks the "natural" flow in my opinion.   The "forward / backward" navigation feature definitely would not replace the breadcrumb navigation, it would rather amend it. And there's also definitely content where it's more fitting / appropriate, and on the other hand content where it's less so. Example Wikipedia: A next/previous button which jumps from one article to the next or preceeding one would not be too helpful. It probably would not hurt, but it also wouldn't really be needed. On the other hand, a manual imported into Xwiki and split across several pages would - in my point of view - benefit a lot from this feature.
            vmassol Vincent Massol added a comment -

            Hi Gunter,

            Provide a feature to navigate to the next / previous "sibling page" (page below the same parent page) from within the page.

            What does next mean? Next based on the page name? Based on the title name? Based on the data the page was created?

            Also we already provide this feature in the breadcrumb where you can navigate to siblings easily. Wouldn't that fix your need? (see screenshots at https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/ContentOrganization/#HUsingNestedPages ).

            Thanks

            vmassol Vincent Massol added a comment - Hi Gunter, Provide a feature to navigate to the next / previous "sibling page" (page below the same parent page) from within the page. What does next mean? Next based on the page name? Based on the title name? Based on the data the page was created? Also we already provide this feature in the breadcrumb where you can navigate to siblings easily. Wouldn't that fix your need? (see screenshots at https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/ContentOrganization/#HUsingNestedPages ). Thanks

            People

              Unassigned Unassigned
              GOhrner Gunter Ohrner
              Votes:
              1 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

                Created:
                Updated: