Summary: This document explains and elaborates on CNXML tags that you can insert into a Connexions document using Edit-in-Place.
When working in Edit-in-Place, notice that the first item of the "Add Here" drop-down menu is "Paragraph". When you select this item and click Add Here, a text box will appear. You can now insert text in the white box, including inline tags. Note the id="element-143" in the upper left hand part of the blue box in Figure 1.
element-143 is the paragraph's unique ID, which you can use to refer to the paragraph directly using a cnxn tag. Also, you can find some helpful tips in the upper right-hand corner of the blue box: "Help editing <para>".
| A Paragraph Box |
|---|
|
<para id='intro'>
Working on trees or bushes can generate a lot of limbs and branches to
haul away. If you just carry them, it'll take all day. Instead, make a
sledge.
</para>
<para id="intro2">
Find a large, complex branch to make the base of your sledge. It should
be relatively flat, and broad and long enough to make a decent pile;
that is, as big or bigger than anything else you need to haul away.
Green branches from hardwoods are best. Place it with the cut end
pointing the way you want to go. If no single branch is good enough, two
can be used. Just place their cut ends a couple feet apart.
</para>
<para id="intro3">
Then pile on the remaining branches. Most will naturally weave together;
if not, give 'em a little help. Once the pile it a few layers deep,
smaller waste, like weeds or maybe even leaves can be added to the pile.
If it gets unstable, another big branch will help.
</para>
<para id="intro4">
When you're done, grab the cut end of the bottom branch, and maybe the
base of one of the other big branches in the pile, and drag the thing
where you want to go. You'll be surprised how much one person can drag!
</para>
<para id="intro5">
If you have a lot of leaves or similar small stuff to move, you can use
a similar technique. Get a tarp, toss the leaves and weeds and whatnot
in the middle, and then drag the whole thing away.
</para> which displays as the following:
Working on trees or bushes can generate a lot of limbs and branches to haul away. If you just carry them, it'll take all day. Instead, make a sledge.
Find a large, complex branch to make the base of your sledge. It should be relatively flat, and broad and long enough to make a decent pile; that is, as big or bigger than anything else you need to haul away. Green branches from hardwoods are best. Place it with the cut end pointing the way you want to go. If no single branch is good enough, two can be used. Just place their cut ends a couple feet apart.
Then pile on the remaining branches. Most will naturally weave together; if not, give 'em a little help. Once the pile it a few layers deep, smaller waste, like weeds or maybe even leaves can be added to the pile. If it gets unstable, another big branch will help.
When you're done, grab the cut end of the bottom branch, and maybe the base of one of the other big branches in the pile, and drag the thing where you want to go. You'll be surprised how much one person can drag!
If you have a lot of leaves or similar small stuff to move, you can use a similar technique. Get a tarp, toss the leaves and weeds and whatnot in the middle, and then drag the whole thing away.
You can select two different types of list from the "Add Here" drop-down menu: enumerated and bulleted. As with adding a paragraph, adding a list will insert a blue box, with the list's unique ID in the upper left-hand corner and a helpful link in the upper right-hand corner.
| Lists Available in Edit-in-Place | ||||||
|---|---|---|---|---|---|---|
|
Note that the only differences between Subfigure 2.1 and Subfigure 2.2 are the lists' unique IDs and their types. Also, notice that premade tags have been inserted into the text area. The item tag separates the items of your list and can contain inline tags. Optionally, you can also add a name tag to give your list a name, as shown in Example 2.
<list id='sledge' type='enumerated'>
<name>Making a Sledge</name>
<item>
Find a large, complex branch to make the base of your sledge.
It should be relatively flat, and broad and long enough to make a
decent pile; that is, as big or bigger than anything else you
need to haul away. Green branches from hardwoods are best. Place
it with the cut end pointing the way you want to go. If no single
branch is good enough, two can be used. Just place their cut ends
a couple feet apart.
</item>
<item>
Then pile on the remaining branches. Most will naturally
weave together; if not, give 'em a little help. Once the pile it
a few layers deep, smaller waste, like weeds or maybe even
leaves can be added to the pile. If it gets unstable, another
big branch will help.
</item>
<item>
When you're done, grab the cut end of the bottom branch, and
maybe the base of one of the other big branches in the pile, and
drag the thing where you want to go. You'll be surprised how
much one person can drag!
</item>
</list>
The resulting list will look like:
<list id="ex-bulleted-list" type="bulleted">
<item>branches</item>
<item>leaves</item>
<item>sweat</item>
<item>lemonade</item>
</list>The equation tag is used to set off and number
equations in CNXML documents. If you have MathML enabled for your document, you will only be able to place MathML equations within the equation tags. Otherwise, to write the actual equations, you can use ASCII or images.
| Adding an Equation |
|---|
|
| Enabling MathML |
|---|
|
As with lists, you can add an optional name at the beginning of each equation.
<equation id="eqn14">
<media type='image/gif' src='euler.gif' />
</equation>displays as:
(1)<equation id='eqn15'>
<name>Simple Arithmetic</name>
11+27=38
</equation>This equation will display as:
The exercise tag allows authors to
add practice problems into their documents. When you initially add an exercise, you will see the familiar blue box, with the unique ID and the helpful link in the top corners. However, also notice that new tags have been premade in your text box: problem and solution.
| Adding an Exercise |
|---|
|
To continue utilizing edit-in-place to edit your exercise, press the Save button (see Figure 6). You can now add various block tags to your problem and solution, including paragraphs and lists!
| A New Exercise after Saving |
|---|
|
To create more complex exercises, such as multiple-choice, multiple-response, ordered-response, and free-response questions, QML (Questions Markup Language) may used in place of the problem and solution tags. For more information, please see the information about QML.
<exercise id='hyd_test'>
<problem>
<para id='hyd_testp1'>
The color of a hydrangea changes with the pH of the soil.
What color would the hydrangea be if the soil were highly
acidic? Highly basic? Neutral?
</para>
</problem>
<solution>
<para id='hyd_sol1p1'>
Highly acidic soil produces blue flowers. Highly basic soil
produces pink flowers. Neutral soil produces very pale cream
flowers.
</para>
</solution>
</exercise>This code will display as:
The color of a hydrangea changes with the pH of the soil. What color would the hydrangea be if the soil were highly acidic? Highly basic? Neutral?
Highly acidic soil produces blue flowers. Highly basic soil produces pink flowers. Neutral soil produces very pale cream flowers.
The figure tag provides the structure for
creating a figure within a document. They can contain either
two or more subfigure tags, or
a single media, table, or code tag.
| Adding a Figure |
|---|
|
The optional first tag of the figure tag is name which is used to
title a figure.
The name tag is followed by any of the tags
listed above; however, the most commonly used tag is media,
which is used to include any sort of media such as images,
video, music, or java applets. For more information on what media you can add to your content, and how to add it, see Adding Multimedia to Your Connexions Content.
The final tag is the optional caption which is
used to add a small caption to the figure.
<figure id='blossom'>
<name>Momosa Blossom</name>
<media type="image/jpeg" src="alb_jul_flo_1.jpg"/>
<caption>
Picture taken by Jenn Drummond (CC Attribution).
</caption>
</figure>This code will display as:
| Momosa Blossom |
|---|
![]() |
As seen in Using Basic CNXML in Edit-in-Place, you can add inline code to your document; edit-in-place also allows you in insert a block of code, separate from text.
| Adding a Block of Code |
|---|
|
If you need to use the > and < symbols in your block of code, you must either use the unicode for these characters (> and <, if you have MathML enabled), or use the CDATA method. To utilize the CDATA method, insert <![CDATA[ before your code and ]]> after it, as seen in Example 8.
| Using CDATA in a Code Block |
|---|
|
When saved, Figure 10 will display as:
<para id='copy'>
In a unix terminal the command to copy a file is <code
type='inline'>cp original copy</code>.
</para>As mentioned in Using Basic CNXML in Edit-in-Place, the note tag creates an "out
of line" note to the reader. You can also insert a note using the drop-down box in Edit-in-Place; however, unless you edit the full source, the type of note will be set to the default.
| Adding a Note using Edit-in-Place |
|---|
|
<note>
Gardening requires a lot of intense physical exertion. Please
drink plenty of water to avoid dehydration!
</note> The above markup will display as:
As is often the case in textbooks, authors will include examples in the middle of a chapter or section. For this reason CNXML provides the example tag that allows an author to include examples in a document.
| Adding an Example Using Edit-in-Place |
|---|
|
Here is the code for Example 9:
<example id="notexamp">
<code type="block">
<note>
Gardening requires a lot of intense physical exertion. Please
drink plenty of water to avoid dehydration!
</note>
</code>
<para id="notep2">
The above markup will display as:
</para>
<note>
Gardening requires a lot of intense physical exertion. Please
drink plenty of water to avoid dehydration!
</note>
</example>The final element you can add using Edit-in-Place is table. To learn more about adding and editting tables using Edit-in-Place, see CALS Table. For a more
complete description of the CALS Table consult the CALS Table
Spec.