On 26 Nov 2015 at 19:11:37, Anton Hughes ([email protected](mailto:[email protected])) wrote:
> > On 26 November 2015 at 19:02, [email protected](mailto:[email protected]) > wrote: > > You need a reference that is either absolute or relative to the current > > page where the macro is used. > Agh - so its not possible to reference just a page - I also need to reference > the space/category. > I think this is a really bad design. In the Mediawiki world you just need to > know the name of the document. Which category it is in is not required. > > I assume then, that if I move MyExamplePage to a new space(?)/category it > will break the pages where I have the includes/displays. Indeed right now we don’t rename references used in Macro parameters upon rename. We do rename backlinks though (references in links). > > 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. In MyExamplePage, you’d need to write: {{include reference=“test.WebHome”/}} 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 ? @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 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. Thanks -Vincent > Anton Hughes _______________________________________________ users mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/users
