Skip to content Skip to navigation

OpenStax-CNX

You are here: Home » Content » Preparing a Word Document for Creating a Connexions Module

Navigation

Lenses

What is a lens?

Definition of a lens

Lenses

A lens is a custom view of the content in the repository. You can think of it as a fancy kind of list that will let you see content through the eyes of organizations and people you trust.

What is in a lens?

Lens makers point to materials (modules and collections), creating a guide that includes their own comments and descriptive tags about the content.

Who can create a lens?

Any individual member, a community, or a respected organization.

What are tags? tag icon

Tags are descriptors added by lens makers to help label content, attaching a vocabulary that is meaningful in the context of the lens.

This content is ...

Endorsed by Endorsed (What does "Endorsed by" mean?)

This content has been endorsed by the organizations listed. Click each link for a list of all content endorsed by the organization.
  • Houston Community College - eLens display tagshide tags

    This module is included in aLens by: Houston Community CollegeAs a part of collection: "Authoring Connexions Modules using Microsoft Word Documents"

    Comments:

    "ET1510 OER Authoring"

    Click the "Houston Community College - eLens" link to see all content they endorse.

    Click the tag icon tag icon to display tags associated with this content.

  • College Open Textbooks display tagshide tags

    This module is included inLens: Community College Open Textbook Collaborative
    By: CC Open Textbook CollaborativeAs a part of collection: "Authoring Connexions Modules using Microsoft Word Documents"

    Click the "College Open Textbooks" link to see all content they endorse.

    Click the tag icon tag icon to display tags associated with this content.

Affiliated with (What does "Affiliated with" mean?)

This content is either by members of the organizations listed or about topics related to the organizations listed. Click each link to see a list of all content affiliated with the organization.
  • CNX Documentation

    This module is included inLens: Connexions Documentation
    By: ConnexionsAs a part of collection: "Authoring Connexions Modules using Microsoft Word Documents"

    Comments:

    "This training collection was written by Connexions Featured Author, winner in the HPC Cup for High Performance Computing education, and Houston Community College faculty member, Ken Busbee. It is […]"

    Click the "CNX Documentation" link to see all content affiliated with them.

  • Houston Community College display tagshide tags

    This module is included in aLens by: Houston Community CollegeAs a part of collection: "Authoring Connexions Modules using Microsoft Word Documents"

    Comments:

    "CIT - ET1510 OER Authoring & 4th Item in a series of Connexions training"

    Click the "Houston Community College" link to see all content affiliated with them.

    Click the tag icon tag icon to display tags associated with this content.

Also in these lenses

  • Busbee's Connexions Training

    This module is included inLens: Busbee's Connexions Training Lens
    By: Kenneth Leroy BusbeeAs a part of collection: "Authoring Connexions Modules using Microsoft Word Documents"

    Comments:

    "4th Item"

    Click the "Busbee's Connexions Training" link to see all content selected in this lens.

  • OER/LOR Connexions T display tagshide tags

    This module is included inLens: OER/LOR Connexions Training
    By: ConnexionsAs a part of collection: "Authoring Connexions Modules using Microsoft Word Documents"

    Comments:

    "This collection by an experienced Connexions author shows how to create new learning materials using Word and special styles for getting cool features like terms, definitions, examples, and exercises."

    Click the "OER/LOR Connexions T" link to see all content selected in this lens.

    Click the tag icon tag icon to display tags associated with this content.

Recently Viewed

This feature requires Javascript to be enabled.

Tags

(What is a tag?)

These tags come from the endorsement, affiliation, and other lenses that include this content.
 

Preparing a Word Document for Creating a Connexions Module

Module by: Kenneth Leroy Busbee. E-mail the author

Summary: Detailed help on how to prepare a Word document for importing into a Connexions module. Use of both Word styles and commonly used Connexions' CNXML styles are demonstrated.

Existing Documentation and Approach

A link is provided in the box to the right for the Connexions web site materials prepared for “Using Microsoft Word to Create a Connexions Modules”. However, the materials are not organized into a fashion that guides a new author from the perspective of how to create a Word document in order to build a Connexions module. Additionally, some information about the use of “templates” applies to an older version of Word (Word 97 or Word 2003). It says that the importer supports the new Microsoft Word 2007 (which creates documents using the .docx file extension), but I have had problems with importing these files as Connexions modules.

This module will take the approach of showing which Word features are preserved (kept) during importing and how you can add Connexions CNXML formatting styles to your Word document to import other useful effects. This will allow you to easily create fantastic OER materials using the convenience of uploading Word documents to create a basic Connexions module.

Typing Your Document Draft

For instructional purposes we have several versions of a Word document file showing its progression from initial typing to a finished product. The subject matter of the document is about flying. The first version shows raw typing that can be done quickly. The second version shows normal formatting that an author would do to a document.You should download the documents to see how they were created.

Click to download: Flying_Ver1.doc

Click to download: Flying_Ver2.doc

Many people will format their documents as they produce it. Thus, the two step approach will be done in only one document. These documents are in the .doc format which is the older Word 97-2003 format. I used the newer Micorsoft Word 2007 software that handles these documents in a “Compatibility Mode”. The following items are formatting effects that will be preserved (will convert) into your Connexisons module. They are listed in the order in which they appear in the Flying_Ver2.doc file.

Preserved Effects

  1. Heading 1 – highlight the text and select “Heading 1” from the “Styles” box on the ribbon. As one example see the first line of the document.
  2. Heading 2 – highlight the text and select “Heading 2” from the “Styles” box on the ribbon. As one example see the second line of the document.
  3. Italic – highlight the text and select “I” from the “Font” box on the ribbon. Look for the word jokes as the example
  4. Bulleted List – highlight the list and select the “Bulleted List” item from the “Paragraph” box on the ribbon.
  5. Bold – highlight the text and select “B” from the “Font” box on the ribbon. Look for the word ficitious as the example
  6. Numbered List – highlight the list and select the “Numbered List” item from the “Paragraph” box on the ribbon.
  7. Table – use the “Insert Tab” selecting “Table” from the “Tables” box on the ribbon.
  8. Hyperlink – use the “Insert Tab” selecting “Hyperlink” from the “Tables” box on the ribbon.
  9. Picture – use the “Insert Tab” selecting “Picture” from the “Illustrations” box on the ribbon. This picture was sized to 320x240 pixels in order to better fix the web page when converted into a Connexions module.
  10. Footnote – use the “References Tab” selecting “Insert Footnote” from the “Footnotes” box on the ribbon.

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.

Figure 1: Word Formattng Styles
Figure 1 (graphics1.jpg)

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.

Figure 2: Connexions Beginning Document
Figure 2 (graphics2.jpg)

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.

Figure 3: New Version with CNXML Formatting Styles
Figure 3 (graphics3.jpg)

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.

Figure 4: Applying a CNXML formatting style
Figure 4 (graphics4.jpg)

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.

Content actions

Download module as:

Add module to:

My Favorites (?)

'My Favorites' is a special kind of lens which you can use to bookmark modules and collections. 'My Favorites' can only be seen by you, and collections saved in 'My Favorites' can remember the last module you were on. You need an account to use 'My Favorites'.

| A lens I own (?)

Definition of a lens

Lenses

A lens is a custom view of the content in the repository. You can think of it as a fancy kind of list that will let you see content through the eyes of organizations and people you trust.

What is in a lens?

Lens makers point to materials (modules and collections), creating a guide that includes their own comments and descriptive tags about the content.

Who can create a lens?

Any individual member, a community, or a respected organization.

What are tags? tag icon

Tags are descriptors added by lens makers to help label content, attaching a vocabulary that is meaningful in the context of the lens.

| External bookmarks