<< Chapter < Page Chapter >> Page >
This is a basic introduction to the CNXML language. It includes a description on how to begin a CNXML module and also examples of the basic tags needed to start writing in CNXML.

Starting with cnxml

CNXML is a lightweight XML markup language for marking up educational content. The goal of CNXML is to conveythe content of the material and not a particular presentation. Connexions uses the Connexions Markup Language (CNXML) as its primary language for storing documents. Now let's get started!

Cnxml tags

Document

All CNXML documents have as their root the document tag. Everything about the document including it's metadata and content are containedwithin the document tag. It is important that you understand the basic structure for a CNXML document. The structure isas follows:

    Document (root tag)

  • Title
  • Metadata Section
  • Content Section

The document tag has one required attribute:

  • id - a unique ID given to the document.
This is automatically assigned.

Id requirements

One major difference between CNXML and other markup languages is the id attribute requirement. Certain tags require that you include the id attribute, but all can possess an id . The tags requiring an id are listed below:

  • document
  • para
  • equation
  • list
  • rule
  • definition
  • exercise
  • table
  • div
  • section
  • subfigure
  • example
  • footnote
  • problem
  • solution
  • block quotes
  • media
  • meaning
  • proof
  • list
  • preformat
  • block code
  • figure
  • block notes
So, if you are going to use any of the above tags, be sure to add the id attribute and give it a unique 'id'. Be aware that in CNXML 0.6 ids will be generated automatically, but you are still permitted to specify you own ids if you wish.

Here is an example of a couple of paras containing a user generated ids.

<para id='uniqueid1'>This is an example to illustrate the use of the<code>id</code>attribute.</para><para id='uniqueid2'>This paragraph has a different id than the last.</para>
Any tag can contain an id attribute. This is useful if you want to link to the information contained in a particular tag.

Namespaces

The document tag should also contain any namespace declarations. Namespaces allow us to easily use other mark-up languages within CNXML without having toworry about whether tag name collision will occur. For simple documents using only CNXML, you need to include theCNXML namespace attribute . Any additional languages need to be declared as well andshould be given their own prefixes. For example, to associate the MathML namespace with the prefix "m",include the following attribute: xmlns:m='http://www.w3.org/1998/Math/MathML' . This states that any tag with a prepended "m" will beinterpreted as a MathML tag while any tag without a prefix will be interpreted as CNXML. The document tag should also contain the metadata namespace xmlns:md="http://cnx.rice.edu/mdml/0.4" , the bibtex namspace xmlns:bib="http://bibtexml.sf.net/" , and the question markup language xmlns:q="http://cnx.rice.edu/qml/1.0" .

This what the document tag should look like.

<document xmlns="http://cnx.rice.edu/cnxml" xmlns:m="http://www.w3.org/1998/Math/MathML"xmlns:md="http://cnx.rice.edu/mdml/0.4" xmlns:bib="http://bibtexml.sf.net/"xmlns:q="http://cnx.rice.edu/qml/1.0" id="m9000" module-id="" cnxml-version="0.6">
Be aware that the you document id can not be the same as this example. Each module will have its own unique id.

Questions & Answers

what's Thermochemistry
rhoda Reply
the study of the heat energy which is associated with chemical reactions
Kaddija
How was CH4 and o2 was able to produce (Co2)and (H2o
Edafe Reply
explain please
Victory
First twenty elements with their valences
Martine Reply
what is chemistry
asue Reply
what is atom
asue
what is the best way to define periodic table for jamb
Damilola Reply
what is the change of matter from one state to another
Elijah Reply
what is isolation of organic compounds
IKyernum Reply
what is atomic radius
ThankGod Reply
Read Chapter 6, section 5
Dr
Read Chapter 6, section 5
Kareem
Atomic radius is the radius of the atom and is also called the orbital radius
Kareem
atomic radius is the distance between the nucleus of an atom and its valence shell
Amos
Read Chapter 6, section 5
paulino
Bohr's model of the theory atom
Ayom Reply
is there a question?
Dr
when a gas is compressed why it becomes hot?
ATOMIC
It has no oxygen then
Goldyei
read the chapter on thermochemistry...the sections on "PV" work and the First Law of Thermodynamics should help..
Dr
Which element react with water
Mukthar Reply
Mgo
Ibeh
an increase in the pressure of a gas results in the decrease of its
Valentina Reply
definition of the periodic table
Cosmos Reply
What is the lkenes
Da Reply
what were atoms composed of?
Moses Reply
what is chemistry
Imoh Reply
what is chemistry
Damilola
Got questions? Join the online conversation and get instant answers!
Jobilize.com Reply

Get Jobilize Job Search Mobile App in your pocket Now!

Get it on Google Play Download on the App Store Now




Source:  OpenStax, Cnxml tutorial. OpenStax CNX. Jul 08, 2009 Download for free at http://cnx.org/content/col10121/1.10
Google Play and the Google Play logo are trademarks of Google Inc.

Notification Switch

Would you like to follow the 'Cnxml tutorial' conversation and receive update notifications?

Ask