26 Nov
2015
26 Nov
'15
7:38 p.m.
On 26 Nov 2015 at 19:11:37, Anton Hughes (ah@tradeworks.io(mailto:ah@tradeworks.io))
wrote:
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#HHist… ?
@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
On 26 November 2015 at 19:02, vincent@massol.net(mailto:vincent@massol.net) wrote:
Indeed right now we don’t rename references used in Macro parameters upon rename. We do
rename backlinks though (references in links).
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. 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/ Anton Hughes