0.4 Creating timea modules using the connexions word importer

Overview

Unless you are an experienced XML encoder, you will probably have an easier time creating your module if you write it in a program such as Microsoft Word and use the handy Importer to convert it to Connexions. You can convert an existing Microsoft Word document into a CNXML file, which is the file in a Connexions module that contains the text andinstructions for displaying images or other files. To convert a Word document you must first create a new module and then import the Worddocument into the module. The Import function applies CNXML tags to the Word paragraph and character styles.

Connexions documents contain not only structural information about the document, but also semantic information. This means that youdo not simply highlight some text and designate it as bold. Rather, you highlight the text and designate it as a "term" or as a "quote".When your document is uploaded to Connexions, the structure and the semantics are both preserved. Using Connexions styles is easy. Ifyou have used styles in Microsoft Word before you will not have a problem. If you have not, have no fear, you will be using stylesin no time.

The connexions template

Before you start creating Connexions modules from Word documents, we recommend that you obtain a copy of the Connexions documenttemplate.

Obtaining the connexions document template

To download the template from the Connexions Web site and to install it on your computer, use the following steps:

• Click the following link to download a copy of the template: Connexions document template . A dialog box opens, displaying options for opening or saving the template file.
• Specify that the template file should be saved to the desktop on your computer and click OK .
• Launch Microsoft Word on your computer.
• Reduce your window size so that the document template icon is visible on your desktop.
• From the Word File menu, click New .
• Drag and drop the document template icon into the "General" tab of the "New" document box.

Now you can apply the Connexions document template to your Word documents.

Creating a new word document with the connexions template

To create a new Word document that uses the Connexions document template,use the following steps:

• Launch Microsoft Word on your computer.
• Select New from the "File" drop-down menu. An empty document will open and the "New" document dialog box displays.
• Select the Connexions-Document.dot icon from the "General" tab on the Microsoft "New" document dialog box.
• Click OK .
• Enter your content into the new document.
• Apply the appropriate paragraph and character styles to the content as you enter it.

Applying connexions styles to an existing word document

To apply the Connexions styles to an existing Word document, use the following steps:

• Complete the process to obtain the Connexions document template.
• Launch Microsoft Word and open your existing document.
• Select "Format" from the menu bar.
• Select "Theme" from the drop-down menu.
• Click the "Style Gallery" button.
• Select Connexions-Document.doc from the "Template" box. The styles from the template are copied into your document. Ifthe Connexions style names match the style names in your existing document, then the Connexions styles are automatically applied tothose items.
• If the style names do not match, you must apply the Connexions template styles to the appropriate items in the existing file. Toapply a paragraph style, place the cursor in the paragraph and select the style from the Style drop-down box in the Word Formatting toolbar.
  Paragraph styles display the paragraph symbol next to their name in the drop-down box.
  To apply a character style, highlight the word or words and selectthe style from the Style drop-down box in the Word Formatting toolbar.
  Character styles display an "a" next to their name in the drop-down box.
• Repeat the previous step for all the content in the file.

Please note these instructions are for Word 2000. The process for other versions of Word will be similar. Consult yourWord Help feature if you have questions with a different version of Word.

Importing your word document

When your Word document is complete, you are ready to import itinto Connexions. To import the Word document, use the following steps:

• Log into Connexions.
• Display the Connexions workspace or workgroup in which you want to work on your document.
• Create a new module in which you will import your Word document. See Creating New Items in aWorkgroup for instructions on creating a new module.
• Click the "Edit" tab in the new module, if it is not already displaying.
• Select Microsoft Word from the Import drop-down list and click Import .
• Click Browse and locate your document.
• Click Import to upload your document. Your new document is uploaded and ready to edit or publish in Connexions.

Feel free to edit your module using our editor, or make your changes in the Word file and repeat the import process.

Word documents can be extremely varied. We have attempted to handle many common cases, with the goal of extracting the text from yourdocument so that you can mark it up in CNXML without having to retype the content. Some cautions:

• Formatting (such as bold and italics) is not preserved.
• Some images and other objects may import correctly and become figures in the module, but others may not. Please let us know whichobjects you have success with and which you do not.
• If you use CNXML-specific styles to create your Word document, you will get a more faithful conversion for elements like terms,citations, code, and others.
• Even without CNXML-specific styling, you can make sure that your section organization is preserved during import by using thestandard Word header styles (Heading 1, Heading 2, and so on) in your original document.