<< Chapter < Page Chapter >> Page >

Title

The title tag can be used with many CNXML tags to hold the name of its parent. This tagcan only contain information in ASCII text or MathML. I mention it here to allow you to put in the name of the module (since Imentioned that it was the first required tag in the document tag).

<title>Grilling a Good Steak</title>
Please see the CNXML tag list in Edit-In-Place to see if a tag can be named.

Content

Now that you have the document tag set up with an id and namespace info, the next thing to do with your document is add content. By 'content' I meanthe text that will make up the bulk of your document.

Strictly speaking the metadata should precede information about content, but we will leave this untillater.
All of this content is conveniently placed in the content tag. Every CNXML document will have one content tag. The body of the document will be here inside the content tag.

Structural tags are the tags which are used inside of the content tag to give structure to the document. These tags are discussed below.

Structure tags

Some of the structure tags are section , para , document , and content .

We have already discussed the document and content tags, so we will proceed with a short description and examples of the other other tags listed.

Para

Text can be inserted into documents by using the para tag. Each para has a required id which must be unique within the document.

<para id='intro'>I have eaten many steaks in my life and none have been more satisfying than the backyard-grill cooked steak. Maybe this is because of therelaxing nature of drinking a beer, being outside, and lounging that accompanies the grilling procedure. Maybe it is because of the aromaof the grill and the beef perfectly seasoned to your taste. Either way, this document shows how a good steak can be prepared.</para>

Section

As often is the case in textbooks, chapters are divided into smaller sections. Because it is often necessary tosegment text for better understanding and coherence, CNXML has included a section tag.

The section tag has one required attribute, id , and a optional first child tag, title .

<section id='ingredsec'><title>Ingredients</title><list>...</list></section><section id='marinadesec'><title>Marinade</title><para id='marinate'>...</para><list id='marinade'>...</list><para id='tobecontinued'>...</para></section><section id='grillingsec'><title>Grilling</title><para id='prepgrill'>...</para><para id='grilling'>...</para></section>

Obviously ellipses would be replaced by appropriate text.

Inline tags

Inline tags are used to embed content and functionality inside of the structural tags . Some of the more commonly used tags are discussed below.

Emphasis

The emphasis tag is used to emphasize text in a CNXML document where emphasis intext would be needed or desired. It is important to note that this refers to semantic emphasis and not a typeface, although many stylesheets may choose to render it visually with a differenttypeface.

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