Nested Pages and SubWikis
You organize content in your wiki by putting them inside pages (a.k.a Documents). Each page usually holds content on a given topic.
However there are several ways to organize your pages:
Also note that the 2 options are not exclusive. You can have several wikis and be using Nested Pages in each. They're just 2 options that you can combine as you see fit.
Using Nested Pages
You can create a hierarchy of pages, by creating pages inside other pages. This feature is called. For example you could have a page "Product Team" inside a page "XWiki" inside a page "Rue Beaubourg" inside a page "Paris" inside a page "Ile de France", inside a page "France" inside a page "Europe" inside a page "Earth". When viewing the "Product Team" page you would see a Breadcrumb with the following (you can click on the ellipsis symbol to expand the tree):
In order to view the full organization of your pages in the current wiki, we offer an, which has a Tree-view. For example:
We also offer Tree navigation in the breadcrumb for each level. For example:
Using several (sub)wikis
XWiki allows. There are a few reasons you may want to use a subwiki instead of using Nested Pages (inside a single wiki):
- You want to provide custom Applications/Extensions to a group of users of your wiki but not to others
- You want to implement an XWiki Farm where each wiki is seen as an island (own users, etc)
- There might be other reasons. See the detailed for more technical details.
- Nested Page (a.k.a Non-Terminal Page): This is a wiki page that can have children pages. Technically a Nested Page is implemented as a Space (i.e. a WebHome page).
- Non-Nested Page (a.k.a Terminal Page): This a wiki page that cannot have children pages. Applications and script can create Terminal Pages. are also able to create Terminal Pages from the UI. Standard Users are only able to create Nested Pages.
- Nested Space: A Space which has another Space as parent. Users only have to deal with Nested Pages, which is hiding the fact that Nested Pages are emulated using Nested Spaces. This is why the concept of Nested Spaces still exists.
Migrating to Nested Pages
If you're upgrading from a version of XWiki prior to the Nested Pages feature (i.e. XWiki < 7.2) to a version that supports Nested Pages, you may want to.