Connexions

You are here: Home » Content » Training: Published Module from Word Using Connexions Styles

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?

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

In these lenses

• OER/LOR Connexions T

This module is included inLens: OER/LOR Connexions Training
By: Connexions

"This module shows how a properly styled Word document will look once it is published on Connexions. The original Word file can be downloaded from the Links box on the side of the module."

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

Click the 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.

Training: Published Module from Word Using Connexions Styles

Module by: Connexions. E-mail the author

Summary: This module shows how a Word document that uses the Connexions template and applies Connexions styles will look once it is published.

Using the Word Importer

It’s easy to use the Word template to prepare documents in MS Word for importing. We’ll show you here some examples of what you can do in your Word document.

We strongly recommend that you practice importing this document into a module that you have created to see examples of the different kinds of CNXML you can create using the Word template.

First, as you see here, you can use headings to create sections and subsections. The H1 heading “Using the Connexions Word Importer” creates the first section. Let’s create another…

Text Markup Using the Word Template

We can use the text styles provided by the Word template to generate Connexions text markup tags when the Word document is imported. We’ll go over the options here with examples - and we’ll give each its own subsection using the H2 heading.

Emphasis

The “CNXML Emphasis” style is used to give emphasis to some really important text. Use this style where you would have used bold or italics to emphasize particular words or phrases.

Foreign

The CNXML Foreign style allows us to designate a term which is in another language than the rest of the text. For example, we can use it to mention our favorite Latin expression, cogito ergo sum. We can also point its usage at a website of our choice by marking it as a hyperlink in addition to CNXML Foreign: a well-known Spanish newspaper is El Mundo.

Code

With the CNXML Code style, we can designate text as code written in a computer programming language, such as the famous “hello world” program in C: main() {printf("hello, world\n");}. It’s a really great program, huh?

NOTE: this will import as inline code. Here’s the block code version:

main() {
printf("hello, world\n");
}


Cite

The CNXML Cite style allows us to refer to non-electronic sources. For example, A Tale of Two Cities is a classic novel we can cite by Charles Dickens. Or we can cite a hyperlinked source by marking it as a hyperlink and then applying CNXML Cite: the full text of War and Peace [link] can now be read online.

Term

With the CNXML Term style, we can designate key terms in our document. For this document, the Word template style is a critical and recurring term. We can also point this term at an example of its usage by marking it as a hyperlink and then applying CNXML Term: lolcats are the funniest things ever.

Quote

Using the CNXML Quote (Block) style, we can designate a section of text as a block quote from another source. Speaking of that Dickens novel referenced above, the opening passage goes like this:

IT WAS the best of times, it was the worst of times, it was the age of wisdom, it was the age of foolishness, it was the epoch of belief, it was the epoch of incredulity, it was the season of Light, it was the season of Darkness, it was the spring of hope, it was the winter of despair, we had everything before us, we had nothing before us, we were all going direct to Heaven, we were all going direct the other way -- in short, the period was so far like the present period, that some of its noisiest authorities insisted on its being received, for good or for evil, in the superlative degree of comparison only.

And here’s an inline quote, marked up with CNXML Quote (Inline): ““To be, or not to be: that is the question”” We could also point this at an online source by marking it as a hyperlink and then applying CNXML Quote (Inline): ““It was the best of times, it was the worst of times…””[source]

Using the Hyperlink style, we can create a hyperlink pointing to a URL. For example, here’s a link to a website. This will become a <link> element in your module.

We can also point at other modules or collections inside the Connexions repository – these will become <cnxn> elements in your module. For example, we can point to the latest versions of the first module or to the CNXML tutorial collection. We can also point to specific elements within modules, such as the last paragraph of the above module, or specific versions of a module or collection, such as version 2.3 of the first module or version 1.1 of the CNXML tutorial.

We can also point at specific locations within this document using hyperlinks. First, we can point at any section title created using the H1, H2, … styles, such as the first section. Second, we can point at top of the document. Third, we can point at any bookmark we have inserted into the document, such as the caption of the figure or the third item of the enumerated list that both follow.

Exercise

We can make exercises that only have problems. To do so, mark them up using the CNXML Exercise (Problem) style:

Exercise 1

How much wood would a woodchuck chuck if a woodchuck could chuck wood?

We can also make exercises that have problems and solutions by following the text marked CNXML Exercise (Problem) with some more text marked CNXML Exercise (Solution):

Exercise 2

Why did the chicken cross the road?

Solution

To get to the other side.

Theorems

We can have theorems with or without proofs. To make a theorem statement, we can use the CNXML Theorem (Statement) style:

Theorem 1

I am totally awesome.

To construct a theorem with both a statement and a proof, we use CNXML Theorem (Statement) followed by CNXML Theorem (Proof):

Theorem 2

I am not totally awesome.

Proof

(contradiction) If I were totally awesome, I would not smell so bad. I smell bad. Therefore, I am not totally awesome.

Definitions

We can have terms with definitions. To do so, we mark the term using the CNXML Definition (Term) style, and we follow it with the explanation marked using the CNXML Definition (Meaning) style:

Definition 1: Connexions
An online, open educational resource.

Notes

We can create note boxes using the CNXML Note style:

Note:

This is a note. I hope you’re noting this note. Duly noted?

Examples

We can create example boxes using the CNXML Example style:

Example 1

Here’s an example of an example. Egad!

Other Objects

We can do more than just mark up text using the Word importer. We can also add images to our document, create tables, add lists, and even insert mathematical expressions…

Images

You can insert images into your Word document as you would normally, and they will import. It’s best to stick to images with .eps, .png, .jpeg, or .gif extensions. Images of other file types may not import at all or may not import well. As an example of a successful image, we’ll put a graphic representation of the Course Composer here.

We can preceed this this with text mared in the CNXML Figure Title style to give it a title, and follow it with text marked in the CNXML Figure Caption style to give it a caption:

Tables

Using the built-in Word table editor, we can create tables which are easily imported. Consider the following example comparing some open education resources:

 MIT OCW Connexions Wikipedia format PDF CNXML Wiki-syntax content course notes books, online courses encyclopedia articles

Lists

A table entry can include single-paragraph text, an image, or a mathematical expression (entered as discussed below). It cannot include a list or multiple paragraphs of text.

We can create both bulleted and numbered lists using Word and import them using the Word importer. Here’s an example bulleted list with all the different text markup styles:

• H1, H2, H3, etc.
• CNXML Emphasis
• CNXML Foreign
• CNXML Code
• CNXML Cite
• CNXML Term
• CNXML Quote

And here’s an example numbered lists with the steps to importing a document using the Word importer:

1. Obtain the Word template
2. Prepare your document in Word using the template
3. Import the Word document
4. Edit the CNXML generated by the importer using the Edit-in-Place tool

Mathematics

We can include mathematics in our Word document using Word’s built-in Equation Editor 3.0. These mathematical objects are imported as Presentation MathML in our document.

These equations can be as simple as x=yx=y size 12{x=y} {}, or they can be more complicated, as is the solution to a quadratic equation:

x = b ± b 2 4 ac 2a x = b ± b 2 4 ac 2a size 12{x= { { - b +- sqrt {b rSup { size 8{2} } - 4 ital "ac"} } over {2a} } } {}
(1)

Or they can be even more complicated, like the classic Fourier transform:

c k = 1 T 0 T s ( t ) e j kt T dt c k = 1 T 0 T s ( t ) e j kt T dt size 12{c rSub { size 8{k} } = { {1} over {T} } Int cSub { size 8{0} } cSup { size 8{T} } {s $$t$$ e rSup { size 8{ - j { {2π ital "kt"} over {T} } } } ital "dt"} } {}
(2)

Footnotes

Finally, footnotes inserted using Word’s footnote tool will import as module footnotes.1

Finally, we can designate a glossary section for our module. We must first give it a title and mark that with the CNXML Glossary Section style. Then, for each glossary element we wish to include, we mark the term portion with CNXML Definition (Term) and the meaning portion with CNXML Definition (Meaning), as we did before in the body of our document.

Footnotes

1. See – here’s a footnote!

Glossary

Doe:
A deer. A female deer.

Content actions

PDF | EPUB (?)

What is an EPUB file?

EPUB is an electronic book format that can be read on a variety of mobile devices.

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?

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