Extension/ImportOfficeFiles

Word Import allows you to import Word documents and convert their content into wiki pages. This functionality is provided by the ImportOfficeFiles extension. Depending on the structure of the document, the content is imported as a single page or split into a page with subpages. Images contained in the document are imported together with the page content. Imported pages can be used as a page collection to create a Book.

Prepare a Word document for import

Note:Word Import requires DOCX files to be enabled as an allowed upload file type in the wiki configuration. This is the default setting. Administrators can manage this setting in the Config Manager.

Before importing a Word document, review its structure to ensure that the content can be converted correctly. During the import, the following elements are converted into wiki content:

• Document title:
  • The document should contain only one title. If several titles exist, error messages are displayed in the wiki at the relevant locations.
• Text:
  • Most text formatting is removed. Some formatting, such as bold and italic text, is retained.
  • Text boxes are converted to unformatted text.
• Headings:
  • Use correct heading levels if you want the document to be converted into multiple subpages.
• Images:
  • Images are imported into the wiki.
  • Image names are generated using the format Wiki-page-name_image_<consecutive number>.
  • Image overlays are not imported.
  • Image names are inserted below the image. Consecutive numbering of the images cannot be continued in the wiki.
  • Images are inserted as centered thumbnails by default.

Note:When uploading images, the system does not check whether the same image already exists in the wiki.

• Tables:
  • Tables are converted into wikitext tables.
• Bullet points:
  • Review imported bullet points and adjust them if necessary.

Import a word document

Import a Word document:

1. Select the New content button > New Word file import

   

   Import menu

2. Select Select a file and choose the Word document, or drag the document into the upload area.

   

   Upload dialog

3. Select Next.
4. Configure the import settings:

   

   Settings

   1. Title: Enter the title of the main wiki page. If the content is split into multiple pages, the importated pages are created as subpages of this page.
   2. Content structure: Select Split content to pages to create multiple wiki pages from the Word document. The heading levels in the Word document determine the page strucutre. Up to three heading levels are supported.
   3. Conflicts with page title: Select how to handle an existing page with the same title:
      • Rename: Creates the imported page with a modified title, such as Page name (1). Avoid this option for large Word documents that are split into multiple pages. The modified page name becomes part of the path of all imported subpages. For example, if the original page is names Employee handbook , the imported pages are created below Employee handbook (1). If the preview shows a naming conflict, select Cancel and enter a different page title, or select Override to replace the existing page.
      • Override: Replaces the existing page with the imported content.
5. Select Next.
6. Review the preview:
   • Check the names of the pages that will be created.
   • Select the arrow icon to view the files imported with an individual page.
   • Select the eye icon to preview the content of an indiviual page.
7. Select Import.

After the import is complete, the imported pages are available as a page collection. In an English-language wiki, the page collection is stored under MediaWiki:Page collection. You can use the page collection to create a book.

Create a book from imported pages

After importing the Word document, create a new book. For information about creating and managing books, see Books.
Add imported pages to a book:

1. Open the book's content page.
2. Select Add multiple pages.
3. Select Page collection as the source.
4. Select the page collection created by the Word import. All pages from the page collection are added to the book in the same order as they appear in the page collection. You can use drag and drop to change the order of the pages and create a hierarchy. By default, the chapter titles display the full page path of the imported pages. To change the chapter title, select the Actions menu at the end of the corresponding page and select Edit. In the dialog, enter the chapter title in the Text field.
5. Save the book content page.
   

The book is now available on the Books overview page.

Troubleshoot Word import

Images are not imported

• Images with a background or shadow: Only the background or shadow is imported. Remove the background or shadow from the image before importing the Word document.
• Images are embedded as .tmp files: The images are embedded as .tmp files in the Word document. Save the images locally and replace the original images in the Word document before importing it.