On 26 Nov 2015 at 20:17:54, Anton Hughes ([email protected](mailto:[email protected])) wrote:
> > On 26 November 2015 at 19:38, [email protected](mailto:[email protected]) > wrote: > > > > Give us the full name of your 2 pages and we can show you what to use. > > > http://localhost:8080/xwiki/bin/view/test/ > > > http://localhost:8080/xwiki/bin/view/MyExamplePage/ > > > > These 2 pages are not relative to each other. > Ok, now Im confused. Ive been doing web development for more years than I > care to count, and relative, to me, means 'they are next to each other'. See > http://www.scriptingmaster.com/html/relative-link.asp > > These two pages sit next to each other in the same tree. The root of the reference is the path starting after “view”. So you have: [root] |_ test |_ WebHome |_ MyExamplePage |_ WebHome As you can see, both WebHome are not relative to each other. As I mentioned the hard part is in understanding this WebHome (the name of the page) from which we’re transitioning from. To be clear, in this example: * Space: test, Page: WebHome * Space: MyExamplePage, Page: WebHome > > In MyExamplePage, you’d need to write: > > > > {{include reference=“test.WebHome”/}} > What is WebHome? And why do I need this when I am referencing relative > document? Yeah I know, hard to understand ATM since XWiki 7.2. See my previous answer for details. > > Note that it seems we have a bug (not related to your example above, just > > mentioning it for completeness); I’ve just created > > http://jira.xwiki.org/browse/XWIKI-12861 for it. > > > > Now to understand what this “WebHome” does here is a bit complex. Starting > > with XWiki 7.2 we’re moving from a Page/Space paradigm to a Nested Pages > > one and this is currently causing some friction to understand it for > > newcomers. I’m not sure how we’re going to handle this (except that at some > > point we’ll need to rewrite our model to remove the concept of spaces > > probably). > > > > Does that help: > > http://platform.xwiki.org/xwiki/bin/view/Features/ContentOrganization#HHistory > > ? > Yes it does - thanks. But, I think you have given it the wrong name. If I am > not wrong, this is just a tree structure. Not nested. > > > > @devs: > > I think we need some better explanation. Maybe you can help tune the doc. I > > think we need a documentation page on xwiki.org(http://xwiki.org) to > > explain what is a Page Reference. On > > http://rendering.xwiki.org/xwiki/bin/view/Main/XWikiSyntax#HLinks we > > explain it as: "A wiki page reference in the form [[wikiName:] space.] > > (page). Examples: WebHome, Main.WebHome, mywiki:Main.WebHome”. However I > > think we should instead link to that page about Page Reference, and explain > > why you have to use something a bit different from what you see in the UI. > > I think adding more documentation will help. But - IMO - there is a > fundamental design flaw. You have built XWiki to use a tree structure of > documents. And documents MUST be referenced using the tree structure. Compare > this to Mediawiki where all you need to know is the doucment name, eg, > https://en.wikipedia.org/wiki/Korea_Medal_(South_Africa). This simple concept > is enough for millions of wikipedia documents. Wikipedia documents can be any > number of categories - and this does not affect how they are referenced. If you want to root all your wiki pages under a single space in XWiki, feel free to do it. That will work :) But please consider that thousands of xwiki users don’t want to do that and that’s why we’ve created the (sub)Wiki>Space>Page hierarchy in the past (and the parent/child one too) and since even that wasn’t enough for our users we’re now moving to Nested Pages. > Again, IMO, the tree structure is something that early CMSs introduced, as it > basically replicates the file system in an OS. Wikis improved on this by > realizing that: > documents often need to be in multiple categories > users tend to want to find a specific document by name only > When the unique id of a document is the document name you then have: That was true 20 years ago when wikis started :) Since then, they’ve learnt that it’s not enough for users for organizing their content. Users want the same concept as what they have in their computers i.e. folders and files. > more friendly urls - wiki/my_document > more flexibility on how documents are organized - a document could be in more > than one 'folder' at a time. XWiki has tags for this as I already mentioned. > easier to link to documents Your choice as a user. Again, you can decide to put all your content in a single space if that’s what you want but I can easily bet that you users would not like you… :) Thanks -Vincent > Anton Hughes _______________________________________________ users mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/users
