Import - Export Application

The Import - Export Application allows to export one or several pages from your wiki into a XAR file or to import one or several pages from an existing XAR file in order to move wiki pages from one instance to another or to perform a lightweight backup of your wiki.

Import

 

To access the import feature UI, click the DrawerMenuIcon.png button to open the drawer menu, then click on "Administer Wiki".

AdministerWikiMenu.png

In the wiki preferences page, click on the "Import" link from the vertical menu to the left.

ImportIcon.png

Click on "Browse" to select the XAR file you wish to import and it will be automatically uploaded.

UploadPackage.png

The File Upload widget provides an interactive upload User Interface in order to enhance the HTML input elements of type file. To learn more about the configuration options, go to the "HTML 5 File Upload Widget" documentation page listed in the "Related Pages" section under "Developer Guide".

Click on the XAR in the "Available Packages" section

AvailablePackages.png

and you should soon see the preselected page list of your XAR. If you don't want to preserve the page history, the newly imported pages will have the revision set to "1.1". In case you want to keep the author of the imported pages, check the "Import as backup package" option.

PackageContent.png

Finally, click on the "Import" button to confirm. If successful, you will see a list of installed and skipped pages (if any).

ImportingSuccessful.png

Export

To access the export feature UI, click the DrawerMenuIcon.png button to open the drawer menu, then click on "Administer Wiki".

AdministerWikiMenu.png

In the wiki preferences page, click on the "Export" link from the vertical menu to the left.

ExportIcon.png

You will be prompted to download a "backup.xar" file which is a renamed ZIP format with a package.xml file containing metadata about the export.

ExportAdministration.png

A typical XAR created when doing an export will include all the pages on your XWiki instance grouped by folders, one for each space.

ExportFile.png

    

Search this space