Create a Sub-Wiki

The Right to Create Wikis

Any main wiki user can create wikis, provided he/she has the "createwiki" right which can only be granted via the main wiki, just like programming rights. To do so, click the DrawerMenuIcon.png button which opens the drawer menu, then on "Administer Wiki".

AdministerWikiMenu.png 

Next, in the preferences page, click on the "Creation Right" link from the vertical menu to the left under "Wikis"

WikisAdminSection.png 

which will bring an overview of the global groups rights.

GroupsCreateWikisRight.png 

Click once on a check-box to allow a right, twice to deny it and three times to clear it. Note that access rights are saved automatically.

Create a Sub-Wiki

To create a sub-wiki, you must first access the Wiki Directory - start by clicking the DrawerMenuIcon.png button to open the drawer menu, then on "Wiki Index"

MainMenu.png

and finally, on "+ Create Wiki".

CreateWikiButton.png

You will be redirected to the first step of the new wiki creation wizard allowing you to define:

  • the wiki identifier which corresponds to the database name in the database engine; the wiki identifier is also used to generate the wiki descriptor page which is stored in the main wiki
  • the wiki pretty name which represents the display name
  • the wiki template to use or whether the wiki is going to be used as template
  • a short description of the wiki purpose 

Create a Wiki Template

Supposing you already have the right to create a wiki, the next thing to consider is whether there are wiki templates available. The list of existing wiki templates (if any) is available in the main wiki administration page by clicking on "Templates" under the "Wikis" section.

WikiTemplatesAdmin.png

ExistingWikiTemplates.png

To create a wiki template, it is important that you check the "This wiki will be a template" option during the first step of the wiki creation wizard.

CreateWikiStep1.png

In case you have enabled the domain name based access, the wizard will display a dedicated field so that you can enter the new wiki alias.  

CreateWikiStep1DomainBased.png

After filling in the required fields, click on "Go to the Next Step" in which you will get to choose the wiki owner, the scope and the membership type.

CreateWikiStep2.png

The default owner is the current global user so, if you wish to delete the entry, hover the user name and click on the red "X" in the top right corner. 

DeleteDefaultWikiOwner.png

To add the new owner, enter the first characters of the username and the suggest feature will help you by displaying the occurrences. 

AddWikiOwner.png

The same principle applies for the sub-wiki "Members". The dedicated input has improved allowing you to add multiple users at once. 

AddInitialMembers.png

To remove a member, hover the corresponding user name and click on the red "X" in the top right corner. In case you want to remove all the members at once, click on "Clear selection".

Each type of membership defines a different kind of sub-wiki:

  • any user can join the wiki (an open wiki)
  • any global user can make a join request, but an administrator has to accept it (a join-by-request wiki)
  • only the administrator can make invitations (an invitation-only wiki)

Also, there are 3 possible user scopes which will tell you the type of users that will have access to the sub-wiki:

  • only global users (main wiki users)
  • only local users (users that will be created locally on the sub-wiki)
  • both local and global users

After filling in the required fields, click on "Create" and the system will start provisioning the wiki, which means allocating memory and creating the database. Starting with XWiki Enterprise 7.x, the wiki creation process is not handled by the Distribution Wizard anymore - instead, it has been moved to a job. During the installation, you are informed in real time about each installed extension through a detailed install plan log.

DistributionWizardWikiInitialize.png

When the progress bar reaches 100%, XWiki will display a success message: click on "Go to the wiki" to finish the installation and access the new sub-wiki home page. 

WikiInstallationFinished.png

In the "Wiki Information" panel you will see a welcome message with the name and description of the wiki and also with information about the owner. The panel is not displayed by default, you can use the Panel Wizard for this purpose.

WikiInformationPanel.png

Create a Sub-Wiki from a Template

After creating a default wiki template, it is time to create a sub-wiki that will use it. Unlike the above section, we will choose the "Template Wiki" as template. 

CreatingWikiFromTemplate.png

After choosing the user scope, the membership type and the initial members, click on "Create".

CreatingWikiFromTemplateUsers.png

Just like in the previous case, the system will start allocating memory for the new wiki and create the associated database.

WikiProvisioning.png

Next, click on "Go to the wiki" to perform the last step of the process

FinalizeProcess.png

and to be redirected to the new sub-wiki home page. In case the process fails, there will be an explanatory error message displayed and a button for cleaning and deleting the wiki.

       

Search this space