<page xmlns="http://projectmallard.org/1.0/"
      xmlns:e="http://projectmallard.org/experimental/"
      xmlns:its="http://www.w3.org/2005/11/its"
      type="guide"
      id="mancreate">

  <info>
    <link type="guide" xref="index#advanced"/>
    <revision pkgversion="3.0" version="0.1" date="2010-05-04" status="incomplete"/>
    <desc>
      Create your templates manually.
    </desc>
    <credit type="author">
      <name>Jim Evins</name>
      <email>evins@snaught.com</email>
    </credit>
    <credit type="author">
      <name>Mario Blättermann</name>
      <email>mariobl@gnome.org</email>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>    
  </info>

  <title>Manually creating new templates</title>



  <!-- ****************** -->
  <!-- BEGIN Introduction -->
  <!-- ****************** -->
  <p>This page is a reference guide to manually creating <app>gLabels</app> templates.
  <app>gLabels</app> templates are defined in simple XML files as described in the DTD:
  <link href="http://glabels.org/xmlns/2.3/glabels-2.3.dtd.txt">glabels-2.3.dtd</link>
  (this DTD also describes other XML files used by <app>gLabels</app>).</p>

  <p>Manually created template files should be placed in the <file>${HOME}/.glabels</file>
  and be named with a <file>.template</file> extension.</p>

  <note style="advanced">
    <p><app>gLabels</app> searches for templates in several other locations as defined here:</p>
    <table frame="all" rules="rows">
      <tr>
        <td><p>Location</p></td>
        <td><p>Description</p></td>
      </tr>
      <tr>
        <td><p></p></td>
        <td><p></p></td>
      </tr>
      <tr>
        <td><p><file>${prefix}/share/libglabels-3.0/templates</file></p></td>
        <td><p>Predefined templates distributed with <app>gLabels</app>.</p>
            <p><file>${prefix}</file> is usually <file>/usr</file> or <file>/usr/local</file>,
            depending on where <app>gLabels</app> was installed.</p></td>
      </tr>
      <tr>
        <td><p><file>${XDG_CONFIG_HOME}/libglabels/templates</file></p></td>
        <td><p>User defined templates created with the <app>gLabels</app> <gui>Template Designer</gui>.
            <em>Do not put manually created templates in this directory.</em></p>
            <p>If <file>${XDG_CONFIG_HOME}</file> is not defined, it defaults to
            <file>${HOME}/.config</file>.</p></td>
      </tr>
      <tr>
        <td><p><file>${HOME}/.glabels</file></p></td>
        <td><p>User defined templates that have been created manually should be placed in this
            directory.
            Older versions of the <app>gLabels</app> <gui>Template Designer</gui> (prior to 3.0)
            would also put templates in this directory.</p></td>
      </tr>
    </table>
  </note>

  <note><p>Completed template files can be sent to the
        <app>gLabels</app> template
        <link href="mailto:glabels-templates@lists.sourceforge.net">mailing list</link>
        for possible inclusion in future versions of <app>gLabels</app>.</p>
  </note>
  <!-- ****************** -->
  <!-- END Introduction   -->
  <!-- ****************** -->


  <!-- ***************** -->
  <!-- BEGIN Assumptions -->
  <!-- ***************** -->
  <section id="template-assumptions">
    <title>Assumptions/caveats</title>
    <list>
      <item>
        <p>A sheet contains only one size of label or card (if a sheet
          contains more than one size of item, it can be split into
           multiple templates for multiple pass printing)</p>
      </item>
      <item>
        <p>Distances can be expressed in units of <code its:translate="no">pt</code>,
          <code its:translate="no">in</code>, <code its:translate="no">mm</code>,
          <code its:translate="no">cm</code>, or <code its:translate="no">pc</code>.  For example:
          "<code its:translate="no">1.0in</code>" or "<code its:translate="no">2.54cm</code>".  If no
          units are specified, computer points (<code its:translate="no">pt</code>) will
          be assumed (1 <em>pt</em> =
          1/72 <em>in</em> = 0.352778 <em>mm</em>).
          </p>
      </item>
    </list>
  </section>
  <!-- ***************** -->
  <!-- END Assumptions   -->
  <!-- ***************** -->



  <!-- ******************** -->
  <!-- BEGIN Template Files -->
  <!-- ******************** -->
  <section id="template-file">
    <title>Template Files</title>

    <p>A template file contains a single <code its:translate="no">Glabels-templates</code> top-level
    node.</p>

    <code mime="text/xml" its:translate="no">
&lt;?xml version="1.0"?&gt;
&lt;Glabels-templates&gt;

   <var its:translate="yes">...templates...</var>

&lt;/Glabels-templates&gt;</code>

    <listing>
      <title>Example Template</title>
      <desc>Example <app>gLabels</app> template file containing a single
            <code its:translate="no">Template</code> node.</desc>
      <code mime="text/xml" its:translate="no">
&lt;?xml version="1.0"?&gt;
&lt;Glabels-templates&gt;

  &lt;Template brand="Avery" part="8160" size="US-Letter" description="Mailing Labels"&gt;
    &lt;Meta category="label"/&gt;
    &lt;Meta category="mail"/&gt;
    &lt;Meta product_url="http://www.avery.com/avery/en_us/"/&gt;
    &lt;Label-rectangle id="0" width="189pt" height="72pt" round="5pt"&gt;
      &lt;Markup-margin size="5pt"/&gt;
      &lt;Layout nx="3" ny="10" x0="11.25pt" y0="36pt" dx="200pt" dy="72pt"/&gt;
    &lt;/Label-rectangle&gt;
  &lt;/Template&gt;

&lt;/Glabels-templates&gt;</code>
    </listing>

  </section>
  <!-- ******************** -->
  <!-- END Template Files   -->
  <!-- ******************** -->



  <!-- ******************** -->
  <!-- BEGIN Template Node  -->
  <!-- ******************** -->
  <section id="template-template-node">
    <title><span its:translate="no">Template</span> Node</title>

    <p>A <code its:translate="no">Template</code> node describes a single
      stationery product.  It must contain one instance of any type of Label node
      (<code its:translate="no">Label-rectangle</code>,
      <code its:translate="no">Label-round</code>, or
      <code its:translate="no">Label-cd</code>).</p>

    <table frame="all" rules="rows">
      <tr>
        <td><p>Property</p></td>  <td><p>Description</p></td>
      </tr>
      <tr>
        <td><p></p></td>  <td><p></p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">brand</code></p></td>  
        <td><p>Brand or manufacturer of stationery product. E.g. "Avery"</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">part</code></p></td>
        <td><p>Part number or name of stationery product. E.g. "8160"</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">size</code></p></td>
        <td><p>Size of sheet.
               E.g., "<code its:translate="no">US-Letter</code>", "<code its:translate="no">A4</code>", ...
            </p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">description</code></p></td>
        <td><p>Description of stationery product.  E.g, "Mailing Labels."</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">_description</code></p></td>
        <td><p>Translatable description of stationery product. E.g, "Mailing Labels."
            (Only useful for predefined templates)</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">width</code></p></td>
        <td><p>Page width.  Only valid if size="Other"</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">height</code></p></td>
        <td><p>Page height.  Only valid if size="Other"</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">equiv</code></p></td>
        <td><p>Equivalent part number.  If this property is present, the template
            is a clone of another template of the same brand.  The template will
            inherit all properties, except brand and name from the other template.
            This equiv property must refer to a previously defined template - 
            <app>gLabels</app> does not currently support forward references.</p></td>
      </tr>
    </table>

  </section>
  <!-- ******************** -->
  <!-- END Template Node    -->
  <!-- ******************** -->


  <!-- ******************** -->
  <!-- BEGIN Meta Node      -->
  <!-- ******************** -->
  <section id="meta-template-node">
    <title><span its:translate="no">Meta</span> Node</title>

    <p>A <code its:translate="no">Meta</code> node contains some additional
         information about the template. A <code its:translate="no">Template</code>
         node may contain zero or more <code its:translate="no">Meta</code> nodes.</p>

    <table frame="all" rules="rows">
      <tr>
        <td><p>Subnode</p></td>  <td><p>Description</p></td>
      </tr>
      <tr>
        <td><p></p></td>  <td><p></p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">category</code></p></td>
        <td><p>A category for the template.
            A template can belong to multiple categories by simply adding multiple
            <code its:translate="no">Meta</code> nodes to the parent
            <code its:translate="no">Template</code> node.
            Template categories are used by the <app>gLabels</app> <gui>New Label
            Dialog</gui> to filter the results of template searches.</p>

            <p>The value of this category must match a predefined category ID defined in
            the file <file>${prefix}/libglabels-3.0/templates/categories.xml</file>.
	      Currently defined category IDs include:</p>
            <list>
              <item><p><code its:translate="no">label</code></p></item>
              <item><p><code its:translate="no">round-label</code></p></item>
              <item><p><code its:translate="no">elliptical-label</code></p></item>
              <item><p><code its:translate="no">square-label</code></p></item>
              <item><p><code its:translate="no">rectangle-label</code></p></item>
              <item><p><code its:translate="no">card</code></p></item>
              <item><p><code its:translate="no">business-card</code></p></item>
              <item><p><code its:translate="no">media</code></p></item>
              <item><p><code its:translate="no">mail</code></p></item>
              <item><p><code its:translate="no">foldable</code></p></item>
              <item><p><code its:translate="no">photo</code></p></item>
            </list>


        </td>
      </tr>
      <tr>
        <td><p><code its:translate="no">product_url</code></p></td>
        <td><p>A URL pointing to the vendor's webpage for the specific product, if available.</p></td>
      </tr>
    </table>

    <note><p>Suggestions for additional categories can be sent to the 
          <app>gLabels</app> developer's
          <link href="mailto:glabels-devel@lists.sourceforge.net">mailing list</link>.</p>
          <p>Product URLs may be of limited use, because they may not be permanent.</p>
    </note>

  </section>
  <!-- ******************** -->
  <!-- END Meta Node        -->
  <!-- ******************** -->


  <!-- ************************** -->
  <!-- BEGIN Label-rectangle Node -->
  <!-- ************************** -->
  <section id="template-label-rectangle-node">
    <title><span its:translate="no">Label-rectangle</span> Node</title>

    <p>A <code its:translate="no">Label-rectangle</code> node describes the
      dimensions of a single label or business card that is rectangular
      in shape (may have rounded edges).</p>

    <table frame="all" rules="rows">
      <tr>
        <td><p>Property</p></td>  <td><p>Description</p></td>
      </tr>
      <tr>
        <td><p></p></td>  <td><p></p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">id</code></p></td>
        <td><p>Reserved for future use.  Should always be 0.</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">width</code></p></td>
        <td><p>Width of label/card</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">height</code></p></td>
        <td><p>Heigth of label/card</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">round</code></p></td>
        <td><p>Radius of corners.  For items with square edges (business cards),
               the radius should be 0.</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">x_waste</code></p></td>
        <td><p>Amount of horizontal waste (over-print) to allow.  This is useful
                      for minimizing alignment problems when using non-white
                      backgrounds (e.g. images).</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">y_waste</code></p></td>
        <td><p>Amount of vertical waste (over-print) to allow.  This is useful
                      for minimizing alignment problems when using non-white
                      backgrounds (e.g. images).</p></td>
      </tr>
    </table>

    <!-- ==== Figure ==== -->
    <figure>
      <desc><span its:translate="no">Label-rectangle</span> parameters</desc>
      <media type="image" src="figures/glabels-template-rect-label.png" mime="image/png" style="right">
        <p><span its:translate="no">Label-rectangle</span> parameters</p>
      </media>
    </figure>
    <!-- ==== End of Figure ==== -->

  </section>
  <!-- ************************** -->
  <!-- END Label-rectangle Node   -->
  <!-- ************************** -->


  <!-- ************************ -->
  <!-- BEGIN Label-ellipse Node -->
  <!-- ************************ -->
  <section id="template-label-ellipse-node">
    <title><span its:translate="no">Label-ellipse</span> Node</title>

    <p>A <code its:translate="no">Label-ellipse</code> node describes the
      dimensions of a single label or business card that is elliptic
      in shape.</p>

    <table frame="all" rules="rows">
      <tr>
        <td><p>Property</p></td>  <td><p>Description</p></td>
      </tr>
      <tr>
        <td><p></p></td>  <td><p></p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">id</code></p></td>
        <td><p>Reserved for future use.  Should always be 0.</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">width</code></p></td>
        <td><p>Width of the ellipse</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">height</code></p></td>
        <td><p>Heigth of the ellipse</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">waste</code></p></td>
        <td><p>Amount of waste (over-print) to allow.  This is useful
            for minimizing alignment problems when using non-white
            backgrounds (e.g. images).</p></td>
      </tr>
    </table>

    <!-- ==== Figure ==== -->
    <figure>
      <desc><span its:translate="no">Label-ellipse</span> parameters</desc>
      <media type="image" src="figures/glabels-template-ellipse-label.png" mime="image/png" style="right">
        <p><span its:translate="no">Label-ellipse</span> parameters</p>
      </media>
    </figure>
    <!-- ==== End of Figure ==== -->

  </section>
  <!-- ************************ -->
  <!-- END Label-ellipse Node   -->
  <!-- ************************ -->


  <!-- ********************** -->
  <!-- BEGIN Label-round Node -->
  <!-- ********************** -->
  <section id="template-label-round-node">
    <title><span its:translate="no">Label-round</span> Node</title>

    <p>A <code its:translate="no">Label-round</code> node describes the dimensions
      of a simple round label (not a CD).</p>

    <table frame="all" rules="rows">
      <tr>
        <td><p>Property</p></td>  <td><p>Description</p></td>
      </tr>
      <tr>
        <td><p></p></td>  <td><p></p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">id</code></p></td>
        <td><p>Reserved for future use.  Should always be 0.</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">radius</code></p></td>
        <td><p>Radius (1/2 diameter) of label</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">waste</code></p></td>
        <td><p>Amount of waste (over-print) to allow.  This is useful
                for minimizing alignment problems when using non-white
                backgrounds (e.g. images).</p></td>
      </tr>
    </table>

    <!-- ==== Figure ==== -->
    <figure>
      <desc><span its:translate="no">Label-ellipse</span> parameters</desc>
      <media type="image" src="figures/glabels-template-circle-label.png" mime="image/png" style="right">
        <p><span its:translate="no">Label-ellipse</span> parameters</p>
      </media>
    </figure>
    <!-- ==== End of Figure ==== -->

  </section>
  <!-- ********************** -->
  <!-- END Label-round Node   -->
  <!-- ********************** -->


  <!-- ******************* -->
  <!-- BEGIN Label-cd Node -->
  <!-- ******************* -->
  <section id="template-label-cd-node">
    <title><span its:translate="no">Label-cd</span> Node</title>

    <p>A <code its:translate="no">Label-cd</code> node describes the dimensions
      of a CD, DVD, or business card CD.</p>

    <table frame="all" rules="rows">
      <tr>
        <td><p>Property</p></td>  <td><p>Description</p></td>
      </tr>
      <tr>
        <td><p></p></td>  <td><p></p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">id</code></p></td>
        <td><p>Reserved for future use.  Should always be 0.</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">radius</code></p></td>
        <td><p>Outer radius of label</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">hole</code></p></td>
        <td><p>Radius of concentric hole</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">width</code></p></td>
        <td><p>If present, the label is clipped to the given width.
                      (Useful for "business card CDs").</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">height</code></p></td>
        <td><p>If present, the label is clipped to the given height.
                      (Useful for "business card CDs").</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">waste</code></p></td>
        <td><p>Amount of waste (over-print) to allow.  This is useful
                      for minimizing alignment problems when using non-white
                      backgrounds (e.g. images).</p></td>
      </tr>
    </table>

    <!-- ==== Figure ==== -->
    <figure>
      <desc><span its:translate="no">Label-cd</span> parameters</desc>
      <media type="image" src="figures/glabels-template-cd-label.png" mime="image/png" style="right">
        <p>CD label parameters</p>
      </media>
    </figure>
    <!-- ==== End of Figure ==== -->

  </section>
  <!-- ******************* -->
  <!-- END Label-cd Node   -->
  <!-- ******************* -->


  <!-- ***************** -->
  <!-- BEGIN Markup Node -->
  <!-- ***************** -->
  <section id="template-markup">
    <title><span its:translate="no">Markup</span> Nodes</title>

    <p>Templates may contain optional markup nodes.  These nodes are used to describe
    a simple set of markup lines that are visible in the <app>glabels</app> drawing canvas, but
    not visible when printed.  These lines can represent margins, fold lines, center lines,
    special areas, or other helpful hints to the user of a template.</p>


    <!-- ======================== -->
    <!-- BEGIN Markup-margin Node -->
    <!-- ======================== -->
    <section id="template-markup-margin-node">
      <title><span its:translate="no">Markup-margin</span> Node</title>

      <p>A <code its:translate="no">Markup-margin</code> describes a margin along
      all edges of a label.</p>

      <table frame="all" rules="rows">
        <tr>
          <td><p>Property</p></td>  <td><p>Description</p></td>
        </tr>
        <tr>
          <td><p></p></td>  <td><p></p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">size</code></p></td>
          <td><p>Size of the margin.  I.e. the distance of the margin
                        line from the edge of the card/label.</p></td>
        </tr>
      </table>
    </section>
    <!-- ======================== -->
    <!-- END Markup-margin Node   -->
    <!-- ======================== -->


    <!-- ====================== -->
    <!-- BEGIN Markup-line Node -->
    <!-- ====================== -->
    <section id="template-markup-line-node">
      <title><span its:translate="no">Markup-line</span> Node</title>

      <p>A <code its:translate="no">Markup-line</code> node describes a markup line.</p>

      <table frame="all" rules="rows">
        <tr>
          <td><p>Property</p></td>  <td><p>Description</p></td>
        </tr>
        <tr>
          <td><p></p></td>  <td><p></p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">x1</code></p></td>
          <td><p>x coordinate of 1st endpoint of the line segment.</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">y1</code></p></td>
          <td><p>y coordinate of 1st endpoint of the line segment.</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">x2</code></p></td>
          <td><p>x coordinate of 2st endpoint of the line segment.</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">y2</code></p></td>
          <td><p>y coordinate of 2st endpoint of the line segment.</p></td>
        </tr>
      </table>
    </section>
    <!-- ====================== -->
    <!-- END Markup-line Node   -->
    <!-- ====================== -->


    <!-- ======================== -->
    <!-- BEGIN Markup-circle Node -->
    <!-- ======================== -->
    <section id="template-markup-circle-node">
      <title><span its:translate="no">Markup-circle</span> Node</title>

      <p>A <code its:translate="no">Markup-circle</code> describes a markup circle.</p>

      <table frame="all" rules="rows">
        <tr>
          <td><p>Property</p></td>  <td><p>Description</p></td>
        </tr>
        <tr>
          <td><p></p></td>  <td><p></p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">x0</code></p></td>
          <td><p>x coordinate of circle origin (center).</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">y0</code></p></td>
          <td><p>y coordinate of circle origin (center).</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">radius</code></p></td>
          <td><p>Radius of circle.</p></td>
        </tr>
      </table>
    </section>
    <!-- ======================== -->
    <!-- END Markup-circle Node   -->
    <!-- ======================== -->


    <!-- ====================== -->
    <!-- BEGIN Markup-rect Node -->
    <!-- ====================== -->
    <section id="template-markup-rect-node">
      <title><span its:translate="no">Markup-rect</span> Node</title>

      <p>A <code its:translate="no">Markup-rect</code> describes a markup rectangle.</p>

      <table frame="all" rules="rows">
        <tr>
          <td><p>Property</p></td>  <td><p>Description</p></td>
        </tr>
        <tr>
          <td><p></p></td>  <td><p></p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">x1</code></p></td>
          <td><p>x coordinate of upper left corner of rectangle.</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">y1</code></p></td>
          <td><p>y coordinate of upper left corner of rectangle.</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">w</code></p></td>
          <td><p>Width of rectangle.</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">h</code></p></td>
          <td><p>Height of rectangle.</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">r</code></p></td>
          <td><p>Radius of rounded corners of rectangle.</p></td>
        </tr>
      </table>
    </section>
    <!-- ====================== -->
    <!-- END Markup-rect Node   -->
    <!-- ====================== -->


    <!-- ========================= -->
    <!-- BEGIN Markup-ellipse Node -->
    <!-- ========================= -->
    <section id="template-markup-ellipse-node">
      <title><span its:translate="no">Markup-ellipse</span> Node</title>

      <p>A <code its:translate="no">Markup-ellipse</code> describes a markup ellipse.</p>

      <table frame="all" rules="rows">
        <tr>
          <td><p>Property</p></td>  <td><p>Description</p></td>
        </tr>
        <tr>
          <td><p></p></td>  <td><p></p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">x1</code></p></td>
          <td><p>x coordinate of upper left corner of ellipse.</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">y1</code></p></td>
          <td><p>y coordinate of upper left corner of ellipse.</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">w</code></p></td>
          <td><p>Width of ellipse.</p></td>
        </tr>
        <tr>
          <td><p><code its:translate="no">h</code></p></td>
          <td><p>Height of ellipse.</p></td>
        </tr>
      </table>
    </section>
    <!-- ========================= -->
    <!-- END Markup-ellipse Node   -->
    <!-- ========================= -->

  </section>
  <!-- ***************** -->
  <!-- END Markup Node   -->
  <!-- ***************** -->


  <!-- ***************** -->
  <!-- BEGIN Layout Node -->
  <!-- ***************** -->
  <section id="template-layout-node">
    <title><span its:translate="no">Layout</span> Node</title>

    <p>A label node may contain multiple <code its:translate="no">Layout</code>
      children.  If labels are arranged in a simple grid pattern, only
      one layout is needed.  However, if labels are arranged in multiple
      grids, such as a running bond pattern, multiple
      <code its:translate="no">Layout</code> tags can be used. </p>
	<note style="tip">
	<p>A single label can always be treated as a grid of one.</p>
      </note>

    <table frame="all" rules="rows">
      <tr>
        <td><p>Property</p></td>  <td><p>Description</p></td>
      </tr>
      <tr>
        <td><p></p></td>  <td><p></p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">nx</code></p></td>
        <td><p>Number of labels/cards across in the grid (horizontal)</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">ny</code></p></td>
        <td><p>Number of labels/cards across in the grid (vertical)</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">x0</code></p></td>
        <td><p>Distance from left edge of sheet to the left edge of
            the left column of cards/labels in the layout.</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">y0</code></p></td>
        <td><p>Distance from the top edge of sheet to the top edge of
             the top row of labels/cards in the layout.</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">dx</code></p></td>
        <td><p>Horizontal pitch of grid.</p></td>
      </tr>
      <tr>
        <td><p><code its:translate="no">dy</code></p></td>
        <td><p>Vertical pitch of grid.</p></td>
      </tr>
    </table>

    <!-- ==== Figure ==== -->
    <figure>
      <desc><span its:translate="no">Layout</span> parameters</desc>
      <media type="image" src="figures/glabels-template-layout.png" mime="image/png" style="right">
        <p><span its:translate="no">Layout</span> Parameters</p>
      </media>
    </figure>
    <!-- ==== End of Figure ==== -->

  </section>
  <!-- ***************** -->
  <!-- END Layout Node   -->
  <!-- ***************** -->


</page>
