0.4 Preparing a word document for creating a connexions module  (Page 2/2)

Effects not preserved

Some items do not import that is that are not preserved during the conversion process to a Connexions module. These have been mentioned, but are provided again as a reminder:

• Do not use cntl_Enter as a break.
• Do not use tabs.

Showing the existing styles

The following slide shows the default formatting styles available in Word.

In order to add special formatting styles created by Connexions, we will need to acquire a document that has these special tags. To get the file:

Click to download: Connexions-Document.doc

After downloading, open the file and save it as (Save As): Flyer_Ver3.doc

By doing so, you will retain your original file intact for future use.

Converting your draft document

The contents for the new Flyer_Ver3.doc file contain some basic text as provided by Connexions. This text is unimportant to us. Highlight the text and delete it.

Copy and paste your draft document

Now open your existing draft document: Flying_Ver2.doc, select the entire document and copy it into the Flying_Ver3.doc file. This new version of the document will have the Connexions CNXML formatting styles.

Adding effects with cnxml formatting styles

You are now ready to add some additional formatting to your document that adds tags to inform Connexions as how it should convert your document when imported it into Connexions as a module. An example of highlighting some text and tagging it as a “term” is shown in the following slide.

The following list of CNXML tags are listed in the order in which they appear in the Flying_Ver3.doc file. You can download the document and review the tags.

Click to download: Flying_Ver3.doc

List of cnxml formatting styles

1. CNXML Quote (Inline) – If you have text as a quote you should remove your quote marks and highlight the text, then apply the style. The conversion automatically adds quote marks.
2. CNXML Term – Taging a word as a term will highlight it upon conversion. IN our example we tagged “Hades”. When the module is included in a Connexions collection the term will automatically be added to the “Index of Keywords and Terms” at the end of the collection.
3. CNXML Note – Highlighing text and applying the tag will make the text appear in a separate note box upon conversion. Thus, you will need to remove the wording “Note: “ from your document.
4. CNXML Figure Title – You can add a line of text just before a picture, highlight that text and apply this tag to create a title above your picture.
5. CNXML Figure Caption - You can add a line of text just after a picture, highlight that text and apply this tag to create additional comments below your picture.
6. CNXML Quote (Block) – Highlight the text and apply the tag. No need to use quote marks, the conversion will indent and italicize the quote.
7. CNXML Definition (Term) – The term is usually placed on a line by itself with the definition on the following line(s). Like other formatting styles you highlight it and tag it. When the module is included in a Connexions collection the term will automatically be added to the “Index of Keywords and Terms” at the end of the collection.
8. CNXML Definition (Meaning) – The meaning of the term is added to the line(s) following the term. Like other formatting styles you highlight it and tag it. When the module is included in a Connexions collection the term with its definition will automatically be added to the “Glossary” at the end of the collection.

What’s next?

Additional information

Once you start creating Connexions modules, you will not go through the process of converting your draft document by copying it’s content and pasting it into a Connexions document shell that has the Connexions CNXML tags. You will simply open the original downloaded file that contains the tags (Connexions-Document.doc) and save it as a new document (you must keep it as a .doc file – that is the older Word 97-2003 format). Highlight and delete the existing sample text. Then start writing your module materials. As you build the document you can add any of the formatting styles (both those preserved from normal Word usage and those CNXML tags that will be available to you).

Authoring workshop application

You should spend a few minutes getting one of your prepared “knowledge chunks” ready for conversion into a Connexions module. At a minimum, use at least two of the preserved effects and at least two of the CNXML tags.