11. Admonitions
Admonitions are used to draw attention to a specific subject. Here is a note:
<note><title>Please Note:</title>
<para>
Using a hammer to put together your computer is bad.
</para>
</note>
|
Depending on what stylesheet you use to render your document you may need the admonition graphics for this to render properly. This is true of the default stylesheet if you followed my installation instructions at the beginning of this document or you are using the custom stylesheets. You can configure your parser to use another stylesheet like the ldp.dsl but I won't be covering that here...yet. Also, the <title> tags are optional for a note. Here's what it looks like.
 | Please Note: |
|---|---|
Using a hammer to put together your computer is bad. |
Here is an <important> and a <tip> admonition:
<important><title>Important!</title>
<para>
Watch where you're swinging that hammer!
</para>
</important>
<tip><title>Tip</title>
<para>
Do not hit your thumb with the hammer, it hurts!
</para>
</tip>
|
Once again, the <title> tags are optional. Here is what they look like parsed:
 | Important! |
|---|---|
Watch where you're swinging that hammer! |
 | Tip |
|---|---|
Do not hit your thumb with the hammer, it hurts! |
Here is a <caution> and a <warning> admonition:
<caution><title>Caution</title>
<para>
Hitting your thumb with a hammer may lead to an unwanted trip to the hospital!
</para>
</caution>
<warning><title>Warning</title>
<para>
Do not, under any circumstances, admit that you hit your own thumb with a hammer.
The ridicule you will face is astounding!
</para>
</warning>
|
Once again, the <title> tags are optional and are usually left out. I placed them here just so you know you can use them. Here is what they look like parsed:
 | Caution |
|---|---|
Hitting your thumb with a hammer may lead to an unwanted trip to the hospital! |
 | Warning |
|---|---|
Do not, under any circumstances, admit that you hit your own thumb with a hammer. The ridicule you will face is astounding! |
The trick to making your admonition graphics show up for html documents is to keep a directory called images "on the same level" as your html files which includes all the necessary graphics. For a little more information check out the Graphics section. If you'll be posting your documents to newbiedoc cvs (and we hope you do!) you shouldn't have to worry about the admonition graphics. There are already copies in cvs and on the website which will allow your admonition graphics to render in html properly.