Using Basic CNXML in Edit-In-Place

Inline Tags Inline tags, such as emphasis, are used to embed content and functionality inside the structural tags, such as paragraphs. Some of the more commonly used tags are discussed below.

Emphasis As mentioned previously, the emphasis tag is used to accent certain text. Note that this refers to semantic emphasis and not a typeface. Different stylesheets can render emphasis with different typefaces.


<para id='intro'>
  Gardenias are my absolute <emphasis>favorite</emphasis> 
  flower. Their petals are soft, and their bloom has an 
  absolutely <emphasis>heavenly</emphasis> scent.
</para>

The above markup will display as:Gardenias are my absolute favorite flower. Their petals are soft, and their bloom has an absolutely heavenly scent.

Term The term tag is used to mark words or phrases which are being defined. However, its use is confined to either a para or definition tag. The term tag has one optional attribute: URL - a URL specifying the source or definition of the term.


<para id='gardenia'>
  <term url="http://en.wikipedia.org/wiki/Gardenia">Gardenias
  </term> can be tricky to maintain.  The soil around the 
  roots of a <term>gardenia</term> must remain moist always, 
  but too much water can damage the plant.  Also, 
  <term>gardenias</term> enjoy the sun, but if the 
  <emphasis>foliage</emphasis> gets wet to bring the gardenia
  into the shade.
</para>

The above markup will display as:Gardenias can be tricky to maintain. The soil around the roots of a gardenia must remain moist always, but too much water can damage the plant. Also, gardenias enjoy the sun, but if the foliage gets wet to bring the gardenia into the shade.

Note The note tag creates an "out of line" note to the reader. The type of note is specified by an optional type attribute. If a type is not specified, the default is Note. The type attribute can contain any of the following values: note aside warning tip important


<para id='pollen'>
  Receiving flowers is, on the whole, a wonderful thing.  
  However, sometimes pollen from the flowers can cause 
  problems.  In particular, the clean up of a bit of 
  pollen can be tricky.  <note type="Important">Do not 
  use water when cleaning up pollen!  This can lead to 
  counter-top and clothing stains!</note>  Your best bet 
  is to use a dry method of cleaning with a paper-towel.
</para>

The above markup will display as: Receiving flowers is, on the whole, a wonderful thing. However, sometimes pollen from the flowers can cause problems. In particular, the clean up of a bit of pollen can be tricky. ImportantDo not use water when cleaning up pollen! This can lead to counter-top and clothing stains! Your best bet is to use a dry method of cleaning, with a paper-towel, for example.

Link The link tag is the tag in CNXML used for linking to other Connexions modules or collections as well as external links. strengthThe Strength attribute can contain the value 1, 2, or 3 specifying the relevance of the link. windowThe Window attribute determines the manner in which the link location will be opened. It can contain the values "Replace" or "New". "Replace" will result in the link location opening in the current window replacing the page with the link. "New" will result in the link location opening in a new browser window. url The URL attribute can contain the web address of the link you wish to reference. documentThe Document attribute is used to reference the ids of other Connexions modules or Collections. target-idThe Target-id attribute is used to reference the ids of specific elements within Connexions modules. resource versionThe Version attribute is used to reference a specific version of a Connexions module or collection. The target and document attributes can be used together or alone. If both are used then you will link to a particular tag in another document. If only document is used, you will link to another document. If only target is used, you will link to a particular tag within the current document.

Cite The cite tag is used to refer to non-electronic materials within a document, and primarily contains the title, the author, and/or a page number of a work. Cite Example


Finally, a good resource is the <cite>Garden Lover's 
Cookbook -- William M. Rice; Paperback</cite>.

The above markup will display as: Finally, a good resource is the

Garden Lover's Cookbook -- William M. Rice; Paperback

Quote The quote tag is used to denote that some text directly quotes another source. The quote tag has a display attribute which denotes whether the quote is inline or block. Quote Example


<para id='plantquote'>
  Every plant needs a different amount of water in order to 
  grow well. <quote display="inline">"If you water each plant the same, you 
  will always water too much and too little."</quote>  Also, 
  remember the words of Lou Erickson: 
  <quote id="quote_example" display='block'>"Gardening requires lots of water - 
  most of it in the form of perspiration."</quote>
</para>

Every plant needs a different amount of water in order to grow well. "If you water each plant the same, you will always water too much and too little." Also, remember the words of Lou Erickson: "Gardening requires lots of water - most of it in the form of perspiration."

Foreign The foreign tag is used to denote that a word or phrase foreign to the language of the document is being used. Foreign Example


<para id='plantquote2'>
  All flowers have a scientific name, often derived from 
  Latin.  <foreign>Gardenia augusta</foreign> is the name 
  of a type of gardenia found in Japan.
</para>

All flowers have a scientific name, often derived from latin. Gardenia augusta is the name of a type of gardenia found in Japan.

Code The code tag is used to insert example computer output/input as either inline text within a paragraph or as a block of text. The code tag has a display attribute with two possible values: inline (default) - used to specify code that is inline. block - used to specify code that should be in a separate block of text. Inline Code Example For now, take a look at what the inline code looks like:


<para id='copy'>
  In a unix terminal the command to copy a file is 
  <code display='inline'>cp original copy</code>.
</para>

In a unix terminal the command to copy a file is cp original copy You will see more about code blocks in Advanced CNXML using Edit-In-Place.