Spaces

Confluence is organized in *spaces*. Spaces are organized by FAI commission.

The entire wiki permissions structure is organized by spaces with one or more [groups|user groups] of users assigned permissions to view, edit, create, delete Etc. pages in each space.

The general premise of this wiki is to make FAI commissions work publicly viewable, but when you login you may see more spaces on the dashboard than when you weren't logged in.

Spaces can be assigned to be a sub-space of another space. This is more of a cosmetic attribute than functional, sub-spaces are stand-alone spaces the same as any other space and do not inherit anything from their parent, but they are useful for organizing groups of spaces, for example all spaces belonging to a FAI commission will be organized under the commission's 'home' space.

Users may also create their own [personal space|Personal spaces].

h4. Spacekey

Each space has a unique identifier across the entire FAI wiki called the *spacekey*.

The spacekey of each top level space in the FAI wiki will generally be the acronym of a FAI commission, for example *cima*.

The FAI wiki is using a protocol that sub-space spaceKeys should start with the same acronym, so for example, the CIMA bureau's spaceKey is *cimaBureau*.

When creating a new space it is *very important* to get the spaceKey right first time because changing it later may involve the loss of some data, for example news/blog posts in a space cannot be moved to another space.

You will notice the spacekey is used in the URL to pages in spaces, for example the space key for this space is _faiWikiDocumentation._ A change of spacekey will therefore break most links pointing at the space, both internal links and ones from outside the wiki.

There are several [macros] which will take the spacekey as an argument to limit the scope of its functionality, for example:

{panel}
To place a search box in a page in a space that will only return results from a space, you would use the following macro:
{code}{livesearch:id=1|spaceKey=cima}{code}
{panel}

h4. Creating a space

As noted above, every space is a stand-alone space with it's own permissions Etc. so moving a space is a merely cosmetic action so it appears in the correct hierarchy of menus Etc.

Go to *Space administration* \--> *Set Parent Space* and assign the correct parent space.
\\
\\