example-tutorial/en example-tutorial.xml, NONE, 1.1 para.xml, NONE, 1.1

[Tommy Reynolds (jtr)]

Author: jtr

Update of /cvs/docs/example-tutorial/en
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv636

Added Files:
	example-tutorial.xml para.xml 
Log Message:
Using language-neutral filenames.



--- NEW FILE example-tutorial.xml ---
<!-- $Id: -->

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [

 <!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../../docs-common/common/fedora-entities-en.ent">
%FEDORA-ENTITIES-EN;

<!ENTITY DOCNAME "example-tutorial">
<!ENTITY DOCVERSION "0.14.1"> <!-- change version here -->
<!ENTITY DOCDATE "2006-01-21"> <!-- change revision date here -->
<!ENTITY DOCID "&DOCNAME;-&DOCVERSION; (&DOCDATE;)">
<!ENTITY BUG-NUM "000000"> <!-- use this only while in draft stage -->

<!ENTITY FDP-INFO	SYSTEM	"fdp-info.xml"	>

]>

<article id="example-tutorial">

   <xi:include href="fdp-info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" >
  <xi:fallback>WHERE IS MY FDP-INFO, DUDE</xi:fallback>
</xi:include>


  <section id="sn-some-section">
    <title>Some Section</title>
    <indexterm>
      <primary>Index term</primary>
    </indexterm>
    <para>
      This is an example section. You should not use sect1, sect2, etc.,
      since those tags will make sections less modular, i.e., harder to
      relocate without changing a lot of other markup.
    </para>
    <xi:include href="para.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>
        <para>
          Could not find the <filename>para-en.xml</filename> file
        </para>
      </xi:fallback>
    </xi:include>
    <para>
      Keep text within the <command>title</command> tags on the same
      line as the tags. Nesting the title on a separate line from the
      enclosing tags results in extra spaces in HTML rendering.
    </para>

    <warning>
      <title>Warning</title>

      <para>
        Example of an admonition.
      </para>
    </warning>

    <para>
      This paragraph illustrates the use of command syntax to accomplish
      a task. Note that specific filenames denoting versions should be
      avoided. To install any RPM package, use the following syntax:
    </para>
<screen>
<userinput><command>rpm -ivh <replaceable>pkgname</replaceable>-<replaceable>version</replaceable>.<replaceable>arch</replaceable>.rpm</command>
      </userinput>
</screen>
    <para>
      Notice that the <command>screen</command> section is entirely
      left-justified with no preceding indent. This is necessary to
      ensure proper rendering in PDFs. Also notice that the entire
      <command>command</command> has been surrounded by
      <command>userinput</command> since the user types this command.
      Computer output would be enclosed in
      <command>computeroutput</command> tags, as in the following
      sample.
    </para>
<screen>
<userinput><command>grep snmptrap /etc/services</command>
      </userinput>
<computeroutput>snmptrap        162/udp         snmp-trap       # Traps for SNMP</computeroutput>
</screen>
    <para>
      Lines should be broken <emphasis>exactly</emphasis> as they are
      on-screen. Also, note that spaces inside <command>screen</command>
      tags are automatically treated as non-breaking.
    </para>
    <tip>
      <title>Fill modes and <command>screen</command> tags</title>
      <para>
        Using automatic or manual fill commands in Emacs/PSGML will
        sometimes mangle <command>screen</command> sections. Use care
        when performing fill operations, and check the results.
      </para>
    </tip>
  </section>

  <section>
    <title>Callout Example</title>
<programlisting id="pl-callout">
Line 1 <co id="pl-callout-L1"/>
Line 2
Line 3
Line 4 <co id="pl-callout-L4"/>
</programlisting>
    <calloutlist>
      <callout arearefs="pl-callout-L1">
        <para>
          Here is a callout.
        </para>
      </callout>
      <callout arearefs="pl-callout-L4">
        <para>
          The second callout.
        </para>
      </callout>
    </calloutlist>
  </section>

  <section>
    <title>Deeply nested sections</title>

    <para>
      Early to bed, early to rise
    </para>

    <section>
      <title>Second Level</title>

      <para>
        Is the curse of the working class
      </para>

      <section>
        <title>Third Level</title>

        <para>
          He who can, does
        </para>

        <section>
          <title>Fourth Level</title>

          <para>
            He who cannot, manages.
          </para>
        </section>
      </section>
    </section>
  </section>

  <section id="sn-procedure-test">
    <title>Procedure Test</title>
    <procedure>
      <step>
        <para>
          First step
        </para>
      </step>
      <step>
        <para>
          Second step
        </para>
      </step>
      <step>
        <para>
          Third step
        </para>
      </step>
    </procedure>
  </section>

  <index id="generated-index"></index>
</article>

<!--
Local variables:
mode: xml
End:
-->


--- NEW FILE para.xml ---
<!-- $Id: -->

<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook V4.2//EN"
 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

 <!ENTITY BOILERPLATE "This header makes editing XML easier" >

]>

<para>
  This paragraph was obtained via an
  <wordasword><xi:include></wordasword> element, just for an
  example.
</para>