<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<?xml-stylesheet href="../driver.css" type="text/css"?><article xmlns="http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" xmlns:eg="http://www.badgers-in-foil.co.uk/projects/docbooc-css/tests/examples">
  <title>Inline Docbook Elements</title>
  <section>
    <title>guimenu</title>
    <programlisting>In the &lt;guimenu&gt;File&lt;/guimenu&gt; menu.</programlisting>
    <para>In the <guimenu>File</guimenu> menu.</para>
  </section>
  <section>
    <title>guimenuitem</title>
    <programlisting>Select &lt;guimenuitem&gt;Quit&lt;/guimenuitem&gt; to leave.</programlisting>
    <para>Select <guimenuitem>Quit</guimenuitem> to leave.</para>
  </section>
  <section>
    <title>guimenu and guimenuitem</title>
    <para>In docbook-css 0.2, the 'Quit' in this example would gain
    an arrow in front of it.  That shouldn't appear any more.</para>
    <programlisting>In the &lt;guimenu&gt;File&lt;/guimenu&gt; menu,
select &lt;guimenuitem&gt;Quit&lt;/guimenuitem&gt; to leave.</programlisting>
    <para>In the <guimenu>File</guimenu> menu,
select <guimenuitem>Quit</guimenuitem> to leave.</para>
  </section>
  <section>
    <title>menuchoice</title>
    <para>Within a menuchoice, a guimenu followed by a guimenuitem
    will gain a seperating arrow, to emphasise the navigation action the
    user will typically make with the mouse.</para>
    <programlisting>Select &lt;menuchoice&gt;&lt;guimenu&gt;File&lt;/guimenu&gt;&lt;guimenuitem&gt;Quit&lt;/guimenuitem&gt;&lt;/menuchoice&gt; to leave.</programlisting>
    <para>Select <menuchoice><guimenu>File</guimenu><guimenuitem>Quit</guimenuitem></menuchoice> to leave.</para>
  </section>
  <section>
    <title>email</title>
    <para>Contents of the email element is simply rendered to look
    like a traditional HTML link, with the addition of surrounding
    cheverons.  There is no behavior tied to this element.</para>
    <programlisting>Please send a message to &lt;email&gt;localpart@hostpart&lt;/email&gt;.</programlisting>
    <para>Please send a message to <email>localpart@hostpart</email>.</para>
  </section>
  <section>
    <title>keycap</title>
    <para>The keycap element gains a background colour and raised
    borders in attempt to make it look a bit like a key on a physical
    keyboard.  To try and stop the border dangling into the line bellow, the
    keycap text is smaller than the surrounding content.</para>
    <programlisting>Press &lt;keycap&gt;F1&lt;/keycap&gt; for help.</programlisting>
    <para>Press <keycap>F1</keycap> for help.</para>
  </section>
  <section>
    <title>guibutton</title>
    <programlisting>Click on &lt;guibutton&gt;Ok&lt;/guibutton&gt; to continue.</programlisting>
    <para>Click on <guibutton>Ok</guibutton> to continue.</para>
  </section>
  <section>
    <title>keycombo</title>
    <para>The keycombo element is for grouping keycaps that the user
    needs to invoke 'together'.  To try and emphasise this, we add a dash
    before the second, and subsequent, keycaps in the keycombo.  Unfortunately,
    this content appears inside the border-styling of the keycap elements,
    rather that 'between' the elements.  I should probably remove that
    dash.</para>
    <programlisting>Hit &lt;keycombo&gt;&lt;keycap&gt;ctrl&lt;/keycap&gt;&lt;keycap&gt;c&lt;/keycap&gt;&lt;/keycombo&gt; to quit.</programlisting>
    <para>Hit <keycombo><keycap>ctrl</keycap><keycap>c</keycap></keycombo> to quit.</para>
  </section>
  <section>
    <title>citation</title>
    <para>A citation just gets the typical square brackets fore and
    aft.</para>
    <programlisting>As &lt;citation&gt;Al, et al&lt;/citation&gt; mentions,</programlisting>
    <para>As <citation>Al, et al</citation> mentions,</para>
  </section>
  <section>
    <title>quote</title>
    <para>This makes use of the CSS quotes mechanism.  I don't think
    that CSS automaticaly handles i18n issues (?), and docbook-css certainly
    doesn't, yet.</para>
    <programlisting>&lt;quote&gt;Arrrr!&lt;/quote&gt; exclaimed the pirate.</programlisting>
    <para><quote>Arrrr!</quote> exclaimed the pirate.</para>
  </section>
  <section>
    <title>emphasis</title>
    <para>Currently, nesting empasis tags makes the text bold, as well
    as italic.  I think tradition is to return to upright text in this case.
    Maybe the current styling should be changed to match.</para>
    <programlisting>&lt;para&gt;&lt;emphasis&gt;'plain' emphasis&lt;/emphasis&gt;,
&lt;emphasis role="strong"
    &gt;strong emphasis&lt;/emphasis&gt;,
&lt;emphasis role="bold"
    &gt;bold emphasis&lt;/emphasis&gt;,
&lt;emphasis role="underline"
    &gt;underline emphasis&lt;/emphasis&gt;,
&lt;emphasis role="strikethrough"
    &gt;strike-through emphasis&lt;/emphasis&gt;.&lt;/para&gt;

&lt;para&gt;&lt;emphasis&gt;Within already emphatic text, &lt;emphasis&gt;how&lt;/emphasis&gt; do you
turn up the volume?&lt;/emphasis&gt;&lt;/para&gt;</programlisting>
    <para><para><emphasis>'plain' emphasis</emphasis>,
<emphasis role="strong">strong emphasis</emphasis>,
<emphasis role="bold">bold emphasis</emphasis>,
<emphasis role="underline">underline emphasis</emphasis>,
<emphasis role="strikethrough">strike-through emphasis</emphasis>.</para>

<para><emphasis>Within already emphatic text, <emphasis>how</emphasis> do you
turn up the volume?</emphasis></para></para>
  </section>
  <section>
    <title>filename</title>
    <para>When the directory class is used, we add a '/' after the
    element content.  This would be bad if the document already contains a
    trailing slash, and it also assumes unix-style paths.</para>
    <programlisting>See &lt;filename&gt;README&lt;/filename&gt; within
&lt;filename class="directory"
    &gt;src&lt;/filename&gt;.</programlisting>
    <para>See <filename>README</filename> within
<filename class="directory">src</filename>.</para>
  </section>
  <section>
    <title>sgmltag</title>
    <para/>
    <programlisting>A &lt;sgmltag&gt;tag&lt;/sgmltag&gt; without a
    &lt;sgmltag class="attribute"
    &gt;class&lt;/sgmltag&gt; looks dull.  More fun are
    &lt;code&gt;&lt;sgmltag class="starttag"
    &gt;sgmltag&lt;/sgmltag&gt;sgmltag&lt;sgmltag class="endtag"
    &gt;sgmltag&lt;/sgmltag&gt;&lt;/code&gt; elements with classes
    &lt;sgmltag class="attvalue"
    &gt;starttag&lt;/sgmltag&gt; or
    &lt;sgmltag class="attvalue"
    &gt;endtag&lt;/sgmltag&gt;.
    An empty &lt;sgmltag class="emptytag"
    &gt;tag&lt;/sgmltag&gt; is also
    possible.  We might want to talk about entities, like
    &lt;sgmltag class="genentity"
    &gt;amp&lt;/sgmltag&gt;.  XML may include
    &lt;wordasword&gt;processing instructions&lt;/wordasword&gt;, like
    &lt;sgmltag class="xmlpi"
    &gt;xml-stylesheet&lt;/sgmltag&gt;.</programlisting>
    <para>A <sgmltag>tag</sgmltag> without a
    <sgmltag class="attribute">class</sgmltag> looks dull.  More fun are
    <code><sgmltag class="starttag">sgmltag</sgmltag>sgmltag<sgmltag class="endtag">sgmltag</sgmltag></code> elements with classes
    <sgmltag class="attvalue">starttag</sgmltag> or
    <sgmltag class="attvalue">endtag</sgmltag>.
    An empty <sgmltag class="emptytag">tag</sgmltag> is also
    possible.  We might want to talk about entities, like
    <sgmltag class="genentity">amp</sgmltag>.  XML may include
    <wordasword>processing instructions</wordasword>, like
    <sgmltag class="xmlpi">xml-stylesheet</sgmltag>.</para>
  </section>
</article>

