[user@demo ~] $ git clone git@github.com:RedHatTraining/skeleton.git

[user@demo skeleton] $ git pull

<!-- Include section content from topics directory -->
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="topics/SG-Sample-ContentSection.xml"/>
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="topics/SG-Sample-PracticeSection.xml"/>
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="topics/SG-Sample-Lab.xml"/>
</chapter>

⁠File Naming Conventions

⁠Example File Names

⁠Presentation section XML

<variablelist><title>Example Variable List</title>
    <varlistentry>
        <term>Example term</term>
        <listitem>
            <para>
                Example definition.
            </para>
        </listitem>
    </varlistentry>
    <varlistentry>
        <term>Another term</term>
        <listitem>
            <para>
                Another definition.
            </para>
        </listitem>
    </varlistentry>
</variablelist>

<table frame="all">
  <title>Example of a Basic Table</title>
  <tgroup cols="3" align="left" colsep="1" rowsep="1">
    <colspec colname="c1" colnum="1" colwidth="1.0*"/>
    <colspec colname="c2" colnum="2" colwidth="2.0*"/>
    <colspec colname="c3" colnum="3" colwidth="2.0*"/>
    <thead>
      <row>
        <entry>Header 1</entry>
        <entry>Header 2</entry>
        <entry>Header 3</entry>
      </row>
    </thead>

    <tbody>
      <row>
        <entry>b1</entry>
        <entry>b2</entry>
        <entry>b3</entry>
      </row>
      <row>
        <entry>c1</entry>
        <entry>c2</entry>
        <entry>c3</entry>
      </row>
      <row>
        <entry>d1</entry>
        <entry>d2</entry>
        <entry>d3</entry>
      </row>
    </tbody>
  </tgroup>
</table>

<table frame="all">
  <title>Example of a Complex Table</title>
  <tgroup cols="5" align="left" colsep="1" rowsep="1">
    <colspec colname="c1" colnum="1" colwidth="1.0*"/>
    <colspec colname="c2" colnum="2" colwidth="2.0*"/>
    <colspec colname="c3" colnum="3" colwidth="2.0*"/>
    <colspec colname="c5" colnum="5"/>
    <thead>
      <row>
        <entry namest="c1" nameend="c2" align="center">Horizontal header span</entry>
        <entry>Header 3</entry>
        <entry>Header 4</entry>
        <entry>Header 5</entry>
      </row>
    </thead>

    <tbody>
      <row>
        <entry>a1</entry>
        <entry>a2</entry>
        <entry>a3</entry>
        <entry>a4</entry>
        <entry morerows="1" valign="middle">
          <para>
            Vertical span across two rows.
          </para>
        </entry>
      </row>
      <row>
        <entry>b1</entry>
        <entry namest="c2" nameend="c3" align="center" morerows="1" valign="bottom">
          Span two rows and two columns.
        </entry>
        <entry>b4</entry>
      </row>
      <row>
        <entry>c1</entry>
        <entry>c4</entry>
        <entry>c5</entry>
      </row>
    </tbody>
  </tgroup>
</table>

<screen>[user01@host ~]$ cd /etc/yum.repos.d <co id="yum.co" linkends="a"/>
[user01@host yum.repos.d]$ ls
dropbox.repo  fedora.repo  fedora-updates.repo  fedora-updates-testing.repo</screen>

<calloutlist>
    <callout id="a" arearefs="yum.co" >
        <para>This command moves you to the /etc/yum.repos.d directory.</para>
    </callout>
    </calloutlist>

[user01@host ~]$ cd /etc/yum.repos.d 
[user01@host yum.repos.d]$ ls
dropbox.repo  fedora.repo  fedora-updates.repo  fedora-updates-testing.repo

<emphasis>italic</emphasis>
<emphasis role="bold">bold</emphasis>
<emphasis role="bold"><code>emphasized code text</code></emphasis>

⁠Examples of References

  
  <note role="References">
    <para>
      For more information, refer to the <citetitle>Graphical Installation</citetitle>, <citetitle>Remote Installation</citetitle>, and <citetitle>Automated Installation </citetitle> sections in the <citetitle>Red&nbsp;Hat Enterprise Linux 7 Installation Guide</citetitle> at <ulink url="https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html-single/installation_guide/index#chap-getting-started"/>
    </para>
  </note>
  

⁠Combining Multiple Reference Types

<note role="References">
      <para>
        <code>info libc</code> (<citetitle>GNU C Library Reference Manual</citetitle>) <itemizedlist>
          <listitem>
            <para>Section 29.2: The Persona of a Process</para>
          </listitem>
        </itemizedlist>
      </para>
      </note>

<note role="References">
      <para>
        <code>info libc 'file name resolution'</code> (<citetitle>GNU C Library Reference Manual</citetitle>) <itemizedlist>
          <listitem>
            <para>Section 11.2.2: File name resolution</para>
          </listitem>
        </itemizedlist>
      </para>
      </note>

<note role="References">
      <para>
        <code>ls</code>(1), <code>mv</code>(1), and <code>su</code>(1) man pages
      </para>
      </note>

<note role="References">
      <para> GNOME Help: <emphasis>Getting Started with GNOME</emphasis>
        <itemizedlist>
          <listitem>
            <para>
              <code>yelp help:gnome-help/getting-started</code>
            </para>
          </listitem>
        </itemizedlist>
      </para>
      </note>

<note role="References">
      <para> Vinagre Help <itemizedlist>
          <listitem>
            <para>
              <code>yelp help:vinagre</code>
            </para>
          </listitem>
        </itemizedlist>
      </para>
      </note>

<note role="References">
      <para>
        <ulink url="http://localhost:631/help/">CUPS Online Help</ulink>
      </para>
      </note>

<note role="References">
      <para>
        <ulink url="https://access.redhat.com/site/solutions/253273"> Knowledgebase: &quot;How to register and subscribe a system using Red Hat Subscription Manager&quot; </ulink>
      </para>
      </note>

<note role="References">
      <para>
        <ulink url="http://www.rfc-editor.org/rfcs/rfc2460.txt"> RFC 2460: Internet Protocol,
          Version 6 (IPv6) Specification</ulink>
      </para>
      <para>
        <ulink url="http://www.ntp.org/">NTP: Network Time Protocol</ulink>
      </para>
      <para>
        <ulink url="http://www.pool.ntp.org/en/use.html">NTP Pool Project: How do I use
          pool.ntp.org?</ulink>
      </para>
      </note>

⁠Referencing Other Sections and Chapters

<uri>http://samplelink.com</uri>

<note role="References">
  <para>
    <ulink url="http://localhost:631/help/">CUPS Online Help</ulink>
  </para>
</note>

<code>public class Plane</code>

<para>
  Use the following query to retrieve the required information:
</para>
<para>
  <code>SELECT student_name, subject1 FROM marks WHERE subject1 > AVG(subject1);</code>
</para>

<screen>[user01@station10 ~]$ <code>ping station<replaceable>X</replaceable></code>
PING station10 (10.1.1.61) 56(84) bytes of data.
64 bytes from station10 (10.1.1.61): icmp_seq=1 ttl=64 time=0.082 ms
64 bytes from station10 (10.1.1.61): icmp_seq=2 ttl=64 time=0.086 ms
^C
--- station10 ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 15ms
rtt min/avg/max/mdev = 0.082/0.084/0.086/0.002 ms</screen>

[user01@station10 ~]$ ping stationX
PING station10 (10.1.1.61) 56(84) bytes of data.
64 bytes from station10 (10.1.1.61): icmp_seq=1 ttl=64 time=0.082 ms
64 bytes from station10 (10.1.1.61): icmp_seq=2 ttl=64 time=0.086 ms
^C
--- station10 ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 15ms
rtt min/avg/max/mdev = 0.082/0.084/0.086/0.002 ms

<replaceable>/usr/bin:/usr/local/bin</replaceable>

<replaceable>local.share.lua</replaceable>

<para>
  The <code>FFmpeg</code> project does not provide a desktop launcher or a GUI.
  To convert the footage for this exercise, open a terminal and type <code>ffmpeg -i slug.mp2 slug.mp4</code>.
  It is standard industry protocol that while <code>FFmpeg</code> is running, you are expected to go get a cup of coffee whilst loudly declaring to your coworkers that your work is rendering.
</para>

<prompt>[user01@host ~] $ </prompt><userinput>cd /etc/yum.repos.d</userinput>
<prompt>[user01@host yum.repos.d] $ </prompt><userinput>ls</userinput>
dropbox.repo  fedora.repo  fedora-updates.repo  fedora-updates-testing.repo

[user01@host ~] $ cd /etc/yum.repos.d
[user01@host yum.repos.d] $ ls
dropbox.repo  fedora.repo  fedora-updates.repo  fedora-updates-testing.repo

[user@host ~]$ oc process mysql-persistent -n openshift \
> -v MYSQL_USER=dev -v MYSQL_PASSWORD=$P4SSD -v MYSQL_DATABASE=bank \
> -v VOLUME_CAPACITY=10Gi | oc create -f -

  [user01@host]$ awk 'BEGIN { FS="=" } /UUID/ { print $2 }' /etc/fstab
  98d0ce6b-c381-4902-b713-3e49f5465ef4 /boot                   ext4    defaults        1 2
  4f5465ef-c381-4902-b713-74d0de6b2e1  /var                    ext4    defaults        1 2

  [user01@host]$ awk 'BEGIN { FS="=" } /UUID/ { print $2 }' /etc/fstab
  98d0...5ef4 /boot  ext4   defaults  1 2
  4f54...b2e1 /var   ext4   defaults  1 2

Mount the ISO file in <code><replaceable>/path/to/iso/file</replaceable></code>.

Mount the ISO file in <code><replaceable>C:\path\to\iso\file</replaceable></code>.

<prompt>[user@host ~] $ </prompt><userinput>traceroute -m 100 -w 2000 \</userinput>
<prompt>&gt; </prompt><code>www.google.com</userinput>

[user@host ~] $ traceroute -m 100 -w 2000 \
> www.google.com

<prompt>c:\Users\user01&gt;</prompt><userinput>tracert -h 100 -w 2000 ^</userinput>
<prompt>More? </prompt><code>www.google.com</code>

c:\Users\user01>tracert -h 100 -w 2000 ^
More? www.google.com

<menuchoice>
  <shortcut>
    <keycombo>
      <keycap>Ctrl</keycap>
      <keycap>N</keycap>
    </keycombo>
  </shortcut>
  <guimenu>GLSPublican</guimenu>
  <guisubmenu>Link</guisubmenu>
  <guimenuitem>Insert URI</guimenuitem>
</menuchoice>.

An example of a GUI menu

<menuchoice>
  <guimenu>Edit</guimenu>
  <guisubmenu>Replace</guisubmenu>
  <guimenuitem>Replace String</guimenuitem>
</menuchoice>

⁠

Example 6.1. Navigating Menus in a web UI

Navigating the menus in OpenShift Container Platform

<para>
In the Red&nbsp;Hat OpenShift Container Platform (RHOCP) web UI, click <menuchoice>
  <guimenu>Builds</guimenu>
  <guimenuitem>Images</guimenuitem>
  </menuchoice> to display the <guilabel>Image Streams</guilabel> page.
</para>

In the configuration file, set the value of <code>rsync</code> to <code>True</code>.

In the configuration file, create a new section named <code>[Hosts]</code>.

Create a new YAML file and enter <code>pre-commit:</code> as the initial value.
Under <code>pre-commit:</code>, add <code>checkout: true</code>.

Join the content of the first record, <code>GNU</code>, with the content of the second record, <code>Linux</code>, to complete the project.

⁠Creating a New Course

⁠Updating Existing Courses

⁠Reusing Content in a New Course

⁠Referencing Other Sections and Chapters

  Supported tags are listed in <xref linkend="supported-yes" />.

<trademark class="registered">Linux</trademark>,
<trademark class="copyright">JBoss</trademark>,
<trademark>Java</trademark>,
e = mc<superscript>2</superscript>,
H<subscript>2</subscript>O

<screen><email>samplemail@example.com</email></screen>

<quote>Sample Quote</quote>

<section>
  <title>Guided Exercise: Sample Title</title>
<!-- Task should have id that is short version of topic -->
  <task role="Checklist" id="topic-practice">
    <title>Can't be empty, won't be used</title>
    <tasksummary>
      <para>
        In this lab, you will .....
      </para>

      <formalpara>
        <title>Outcomes</title>
        <para>
          List outcomes.
        </para>
      </formalpara>
    </tasksummary>
    <taskprerequisites>
      <para>
        List prerequisites.
      </para>
    </taskprerequisites>

<procedure>
   <title>Steps</title>
      <step>
        <para>
          Sample instructions, include solutions. We are holding hands here.
        </para>
        <substeps>
          <step>
            <para>
              Substep One
            </para>
          </step>
          <step>
            <para>
              Substep Two
            </para>
            <para>
              You can include output in <screen> elements. If you need to omit some output that is not relevant, use the format <emphasis>...output omitted...</emphasis>. Note: if this produces questionable output, consult with your scrum master and architect.
            </para>
<screen>The first part of the output.
<code>The important part of the output.</code>
The last part of the output. Everything after this is mostly irrelevant.
<emphasis>...output omitted...</emphasis>
          </step>
        </substeps>
      </step>
      <step>
        <para>
          More Sample instructions
        </para>
        <substeps>
          <step>
            <para>
              You don't have to use these substeps.
            </para>
          </step>
          <step>
            <para>
              Try to limit the number of substeps to six.
            </para>

          </step>
        </substeps>
      </step>
    </procedure>

    <taskrelated>
      <formalpara>
        <title>Finish</title>
        <para>
          On the <code>workstation</code> machine, use the <code>lab</code> command to complete this exercise.
          This is important to ensure that resources from previous exercises do not impact upcoming exercises.
        </para>
      </formalpara>
      <screen><prompt>[student@workstation ~]$ </prompt><userinput>lab chapter-topic finish</userinput></screen>
    </taskrelated>
  </task>
</section>

 <!-- Section should have id that is short version of title -->
<section id="shortsectionname-matching">
  <title>Quiz: Matching Quiz Sample Title</title>

  <!-- Task should have id that is short version of topic -->
  <task role="Matching" id="topic-matching">
    <title>Titles are still mandatory, but replaced by the stylesheet</title>
    <tasksummary>
      <para> Match the items below to their counterparts in the table. </para>
      <para condition="rolehtml"> Drag and drop the items to the cell next to the correct answer. Each cell should contain one answer. If you want to change an answer, either drag it to another location, or click <guilabel>reset</guilabel> to return the quiz to its original settings. </para>
      <para condition="rolehtml"> When you have completed the quiz, click <guilabel>check</guilabel>. Your correct answers will have a blue background and your incorrect answers will be crossed out. If you want to try again, click <guilabel>reset</guilabel>. Note: If you have trouble getting the quiz to function a second time, try refreshing your browser. Click <guilabel>show solution</guilabel> to see all of the correct answers. </para>
    </tasksummary>

<procedure>
      <step>
        <informaltable frame="all">
          <tgroup cols="2">
            <colspec colname="c1" colnum="1" colwidth="1.0*"/>
            <colspec colname="c2" colnum="2" colwidth="2.0*"/>
            <thead>
              <row>
                <entry>Project</entry>
                <entry>Technology</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry> Red Hat </entry>
                <entry role="solution"> Ansible </entry>
              </row>
              <row>
                <entry> GNU </entry>
                <entry role="solution"> libc </entry>
              </row>
              <row>
                <entry> KDE </entry>
                <entry role="solution"> Plasma </entry>
              </row>
              <row>
                <entry> Mozilla </entry>
                <entry role="solution"> Firefox </entry>
              </row>
              <row>
                <entry> FreeDesktop.org </entry>
                <entry role="solution"> colord </entry>
              </row>
              <row>
                <entry> OpenBSD </entry>
                <entry role="solution"> OpenSSH </entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
      </step>
    </procedure>
  </task>
</section>

<!-- Section should have id that is short version of title -->
<section id="shortsectionname-multchoice">
<title>Quiz: Multiple-choice Sample Title</title>

<!-- Tasks should have an id that is a short version of the topic -->
<task role="MultChoice" id="topic-multchoice">
    <title>will not show</title>
    <tasksummary>
        <para> Choose the correct answer to the following questions: </para>
        <!--  <para condition="role"> When you have completed the quiz, click <guilabel>check</guilabel>. If you want to try again, click <guilabel>reset</guilabel>. Click <guilabel>show solution</guilabel> to see all of the correct answers. </para>-->
    </tasksummary>

<procedure>
<step>
    <qandaset>
    <!--  Question with one correct answer-->
        <qandaentry role="multi-radio" id="questionx">
        <!-- Question should have id that is short version of topic -->
            <question>
                <para>
                    The designer needs to limit the chart display to the set of products that contribute 20 percent of the total sales using the top contributors.
                </para>
            </question>
            <answer>
                <para>
                    Show only values that are Greater Than or Equal To 20 percent and select the Show Total checkbox.
                </para>
            </answer>
            <answer>
                <para>
                    Show only First 20 Values, select the Global Grouping Mode checkbox, and select the Exclude Others checkbox.
                </para>
            </answer>
            <answer role="solution">
                <para>
                    Show only values that accumulate to 20 percent and Use Largest Values and select the Check Include Boundary Values checkbox.
                </para>
            </answer>
            <answer>
                <para>
                    Show only Largest 20 Values and select the Show Others checkbox.
                </para>
            </answer>
        </qandaentry>
    </qandaset>
</step>

<!--  Question with more than one correct answer. Indicate how many choices at end of question.-->
<step>
    <qandaset>
        <qandaentry role="multi-check" id="questiony">
            <question>
            <para>
                Based on the Linux partition naming system, which of the following two device names point to "logical" partitions (assuming the corresponding partitions exist at all on the system in question)? (Choose two.)
            </para>
            </question>
            <answer>
                <para> /dev/sda3 </para>
            </answer>
            <answer>
                <para> /dev/fd0 </para>
            </answer>
            <answer role="solution">
                <para> /dev/hdb7 </para>
            </answer>
            <answer>
                <para> /dev/hda4 </para>
            </answer>
            <answer>
                <para> /dev/fd7 </para>
            </answer>
            <answer role="solution">
                <para> /dev/sdc11 </para>
            </answer>
        </qandaentry>
    </qandaset>
</step>

<step>
          <qandaset>
            <qandaentry role="multi-check" id="questionz">
              <question>
                <para>
                  <screen>Name           Null?       Type
  ----------    -------      --------
  STUDENT_ID    NOT NULL  VARCHAR2(4)
  STUDENT_NAME          VARCHAR2(25)
  SUBJECT1            NUMBER(3)
  SUBJECT2            NUMBER(3)
  SUBJECT3            NUMBER(3)</screen>
                </para>
                <para> Given the structure of the MARKS table in the above Exhibit, which two
                  statements would execute successfully? (Choose two.) </para>
              </question>
              <answer>
                <para> SELECT student_name, subject1 FROM marks WHERE subject1 > AVG(subject1);
                </para>
              </answer>
              <answer>
                <para> SELECT student_name, SUM(subject1) FROM marks WHERE student_name LIKE ‘R%’;
                </para>
              </answer>
              <answer role="solution">
                <para> SELECT SUM (subject1+subject2+subject3) FROM marks WHERE student_name is
                  NULL; </para>
              </answer>
              <answer role="solution">
                <para> SELECT SUM (DISTINCT NVL(subject1,0)), MAX(subject1) FROM marks WHERE
                  subject1 > subject2; </para>
              </answer>
            </qandaentry>
          </qandaset>
        </step>
      </procedure>
    </task>
  </section>