git.sur5r.net Git - glabels/blob - help/nl/mancreate.page

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <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" xml:lang="nl">
   3
   4   <info>
   5     <link type="guide" xref="index#advanced"/>
   6     <revision pkgversion="3.0" version="0.1" date="2010-05-04" status="incomplete"/>
   7     <desc>
   8       Create your templates manually.
   9     </desc>
  10     <credit type="author">
  11       <name>Jim Evins</name>
  12       <email>evins@snaught.com</email>
  13     </credit>
  14     <credit type="author">
  15       <name>Mario Blättermann</name>
  16       <email>mariobl@gnome.org</email>
  17     </credit>
  18     <license>
  19       <p>Creative Commons Share Alike 3.0</p>
  20     </license>
  21   </info>
  22
  23   <title>Manually creating new templates</title>
  24
  25
  26
  27   <!-- ****************** -->
  28   <!-- BEGIN Introduction -->
  29   <!-- ****************** -->
  30   <p>This page is a reference guide to manually creating <app>gLabels</app> templates.
  31   <app>gLabels</app> templates are defined in simple XML files as described in the DTD:
  32   <link href="http://glabels.org/xmlns/2.3/glabels-2.3.dtd.txt">glabels-2.3.dtd</link>
  33   (this DTD also describes other XML files used by <app>gLabels</app>).</p>
  34
  35   <p>Manually created template files should be placed in the <file>${HOME}/.glabels</file>
  36   and be named with a <file>.template</file> extension.</p>
  37
  38   <note style="advanced">
  39     <p><app>gLabels</app> searches for templates in several other locations as defined here:</p>
  40     <table frame="all" rules="rows">
  41       <tr>
  42         <td><p>Location</p></td>
  43         <td><p>Description</p></td>
  44       </tr>
  45       <tr>
  46         <td><p/></td>
  47         <td><p/></td>
  48       </tr>
  49       <tr>
  50         <td><p><file>${prefix}/share/libglabels-3.0/templates</file></p></td>
  51         <td><p>Predefined templates distributed with <app>gLabels</app>.</p>
  52             <p><file>${prefix}</file> is usually <file>/usr</file> or <file>/usr/local</file>,
  53             depending on where <app>gLabels</app> was installed.</p></td>
  54       </tr>
  55       <tr>
  56         <td><p><file>${XDG_CONFIG_HOME}/libglabels/templates</file></p></td>
  57         <td><p>User defined templates created with the <app>gLabels</app> <gui>Template Designer</gui>.
  58             <em>Do not put manually created templates in this directory.</em></p>
  59             <p>If <file>${XDG_CONFIG_HOME}</file> is not defined, it defaults to <file>${HOME}/.config</file>.</p></td>
  60       </tr>
  61       <tr>
  62         <td><p><file>${HOME}/.glabels</file></p></td>
  63         <td><p>User defined templates that have been created manually should be placed in this
  64             directory.
  65             Older versions of the <app>gLabels</app> <gui>Template Designer</gui> (prior to 3.0)
  66             would also put templates in this directory.</p></td>
  67       </tr>
  68     </table>
  69   </note>
  70
  71   <note><p>Completed template files can be sent to the
  72         <app>gLabels</app> template
  73         <link href="mailto:glabels-templates@lists.sourceforge.net">mailing list</link>
  74         for possible inclusion in future versions of <app>gLabels</app>.</p>
  75   </note>
  76   <!-- ****************** -->
  77   <!-- END Introduction   -->
  78   <!-- ****************** -->
  79
  80
  81   <!-- ***************** -->
  82   <!-- BEGIN Assumptions -->
  83   <!-- ***************** -->
  84   <section id="template-assumptions">
  85     <title>Assumptions/caveats</title>
  86     <list>
  87       <item>
  88         <p>A sheet contains only one size of label or card (if a sheet
  89           contains more than one size of item, it can be split into
  90            multiple templates for multiple pass printing)</p>
  91       </item>
  92       <item>
  93         <p>Distances can be expressed in units of <code translate="no">pt</code>,
  94           <code translate="no">in</code>, <code translate="no">mm</code>,
  95           <code translate="no">cm</code>, or <code translate="no">pc</code>.  For example:
  96           "<code translate="no">1.0in</code>" or "<code translate="no">2.54cm</code>".  If no
  97           units are specified, computer points (<code translate="no">pt</code>) will
  98           be assumed (1 <em>pt</em> =
  99           1/72 <em>in</em> = 0.352778 <em>mm</em>).
 100           </p>
 101       </item>
 102     </list>
 103   </section>
 104   <!-- ***************** -->
 105   <!-- END Assumptions   -->
 106   <!-- ***************** -->
 107
 108
 109
 110   <!-- ******************** -->
 111   <!-- BEGIN Template Files -->
 112   <!-- ******************** -->
 113   <section id="template-file">
 114     <title>Template Files</title>
 115
 116     <p>A template file contains a single <code translate="no">Glabels-templates</code> top-level
 117     node.</p>
 118
 119     <code mime="text/xml" translate="no">
 120 &lt;?xml version="1.0"?&gt;
 121 &lt;Glabels-templates&gt;
 122
 123    <var translate="yes">...templates...</var>
 124
 125 &lt;/Glabels-templates&gt;</code>
 126
 127     <listing>
 128       <title>Example Template</title>
 129       <desc>Example <app>gLabels</app> template file containing a single
 130             <code translate="no">Template</code> node.</desc>
 131       <code mime="text/xml" translate="no">
 132 &lt;?xml version="1.0"?&gt;
 133 &lt;Glabels-templates&gt;
 134
 135   &lt;Template brand="Avery" part="8160" size="US-Letter" description="Mailing Labels"&gt;
 136     &lt;Meta category="label"/&gt;
 137     &lt;Meta category="mail"/&gt;
 138     &lt;Meta product_url="http://www.avery.com/avery/en_us/"/&gt;
 139     &lt;Label-rectangle id="0" width="189pt" height="72pt" round="5pt"&gt;
 140       &lt;Markup-margin size="5pt"/&gt;
 141       &lt;Layout nx="3" ny="10" x0="11.25pt" y0="36pt" dx="200pt" dy="72pt"/&gt;
 142     &lt;/Label-rectangle&gt;
 143   &lt;/Template&gt;
 144
 145 &lt;/Glabels-templates&gt;</code>
 146     </listing>
 147
 148   </section>
 149   <!-- ******************** -->
 150   <!-- END Template Files   -->
 151   <!-- ******************** -->
 152
 153
 154
 155   <!-- ******************** -->
 156   <!-- BEGIN Template Node  -->
 157   <!-- ******************** -->
 158   <section id="template-template-node">
 159     <title><span translate="no">Template</span> Node</title>
 160
 161     <p>A <code translate="no">Template</code> node describes a single
 162       stationery product.  It must contain one instance of any type of Label node
 163       (<code translate="no">Label-rectangle</code>,
 164       <code translate="no">Label-round</code>, or
 165       <code translate="no">Label-cd</code>).</p>
 166
 167     <table frame="all" rules="rows">
 168       <tr>
 169         <td><p>Property</p></td>  <td><p>Description</p></td>
 170       </tr>
 171       <tr>
 172         <td><p/></td>  <td><p/></td>
 173       </tr>
 174       <tr>
 175         <td><p><code translate="no">brand</code></p></td>
 176         <td><p>Brand or manufacturer of stationery product. E.g. "Avery"</p></td>
 177       </tr>
 178       <tr>
 179         <td><p><code translate="no">part</code></p></td>
 180         <td><p>Part number or name of stationery product. E.g. "8160"</p></td>
 181       </tr>
 182       <tr>
 183         <td><p><code translate="no">size</code></p></td>
 184         <td><p>Size of sheet.
 185                E.g., "<code translate="no">US-Letter</code>", "<code translate="no">A4</code>", ...
 186             </p></td>
 187       </tr>
 188       <tr>
 189         <td><p><code translate="no">description</code></p></td>
 190         <td><p>Description of stationery product.  E.g, "Mailing Labels."</p></td>
 191       </tr>
 192       <tr>
 193         <td><p><code translate="no">_description</code></p></td>
 194         <td><p>Translatable description of stationery product. E.g, "Mailing Labels."
 195             (Only useful for predefined templates)</p></td>
 196       </tr>
 197       <tr>
 198         <td><p><code translate="no">width</code></p></td>
 199         <td><p>Page width.  Only valid if size="Other"</p></td>
 200       </tr>
 201       <tr>
 202         <td><p><code translate="no">height</code></p></td>
 203         <td><p>Page height.  Only valid if size="Other"</p></td>
 204       </tr>
 205       <tr>
 206         <td><p><code translate="no">equiv</code></p></td>
 207         <td><p>Equivalent part number.  If this property is present, the template
 208             is a clone of another template of the same brand.  The template will
 209             inherit all properties, except brand and name from the other template.
 210             This equiv property must refer to a previously defined template -
 211             <app>gLabels</app> does not currently support forward references.</p></td>
 212       </tr>
 213     </table>
 214
 215   </section>
 216   <!-- ******************** -->
 217   <!-- END Template Node    -->
 218   <!-- ******************** -->
 219
 220
 221   <!-- ******************** -->
 222   <!-- BEGIN Meta Node      -->
 223   <!-- ******************** -->
 224   <section id="meta-template-node">
 225     <title><span translate="no">Meta</span> Node</title>
 226
 227     <p>A <code translate="no">Meta</code> node contains some additional
 228          information about the template. A <code translate="no">Template</code>
 229          node may contain zero or more <code translate="no">Meta</code> nodes.</p>
 230
 231     <table frame="all" rules="rows">
 232       <tr>
 233         <td><p>Subnode</p></td>  <td><p>Description</p></td>
 234       </tr>
 235       <tr>
 236         <td><p/></td>  <td><p/></td>
 237       </tr>
 238       <tr>
 239         <td><p><code translate="no">category</code></p></td>
 240         <td><p>A category for the template.
 241             A template can belong to multiple categories by simply adding multiple
 242             <code translate="no">Meta</code> nodes to the parent
 243             <code translate="no">Template</code> node.
 244             Template categories are used by the <app>gLabels</app> <gui>New Label
 245             Dialog</gui> to filter the results of template searches.</p>
 246
 247             <p>The value of this category must match a predefined category ID defined in
 248             the file <file>${prefix}/libglabels-3.0/templates/categories.xml</file>.
 249               Currently defined category IDs include:</p>
 250             <list>
 251               <item><p><code translate="no">label</code></p></item>
 252               <item><p><code translate="no">round-label</code></p></item>
 253               <item><p><code translate="no">elliptical-label</code></p></item>
 254               <item><p><code translate="no">square-label</code></p></item>
 255               <item><p><code translate="no">rectangle-label</code></p></item>
 256               <item><p><code translate="no">card</code></p></item>
 257               <item><p><code translate="no">business-card</code></p></item>
 258               <item><p><code translate="no">media</code></p></item>
 259               <item><p><code translate="no">mail</code></p></item>
 260               <item><p><code translate="no">foldable</code></p></item>
 261               <item><p><code translate="no">photo</code></p></item>
 262             </list>
 263
 264
 265         </td>
 266       </tr>
 267       <tr>
 268         <td><p><code translate="no">product_url</code></p></td>
 269         <td><p>A URL pointing to the vendor's webpage for the specific product, if available.</p></td>
 270       </tr>
 271     </table>
 272
 273     <note><p>Suggestions for additional categories can be sent to the
 274           <app>gLabels</app> developer's
 275           <link href="mailto:glabels-devel@lists.sourceforge.net">mailing list</link>.</p>
 276           <p>Product URLs may be of limited use, because they may not be permanent.</p>
 277     </note>
 278
 279   </section>
 280   <!-- ******************** -->
 281   <!-- END Meta Node        -->
 282   <!-- ******************** -->
 283
 284
 285   <!-- ************************** -->
 286   <!-- BEGIN Label-rectangle Node -->
 287   <!-- ************************** -->
 288   <section id="template-label-rectangle-node">
 289     <title><span translate="no">Label-rectangle</span> Node</title>
 290
 291     <p>A <code translate="no">Label-rectangle</code> node describes the
 292       dimensions of a single label or business card that is rectangular
 293       in shape (may have rounded edges).</p>
 294
 295     <table frame="all" rules="rows">
 296       <tr>
 297         <td><p>Property</p></td>  <td><p>Description</p></td>
 298       </tr>
 299       <tr>
 300         <td><p/></td>  <td><p/></td>
 301       </tr>
 302       <tr>
 303         <td><p><code translate="no">id</code></p></td>
 304         <td><p>Reserved for future use.  Should always be 0.</p></td>
 305       </tr>
 306       <tr>
 307         <td><p><code translate="no">width</code></p></td>
 308         <td><p>Width of label/card</p></td>
 309       </tr>
 310       <tr>
 311         <td><p><code translate="no">height</code></p></td>
 312         <td><p>Heigth of label/card</p></td>
 313       </tr>
 314       <tr>
 315         <td><p><code translate="no">round</code></p></td>
 316         <td><p>Radius of corners.  For items with square edges (business cards),
 317                the radius should be 0.</p></td>
 318       </tr>
 319       <tr>
 320         <td><p><code translate="no">x_waste</code></p></td>
 321         <td><p>Amount of horizontal waste (over-print) to allow.  This is useful
 322                       for minimizing alignment problems when using non-white
 323                       backgrounds (e.g. images).</p></td>
 324       </tr>
 325       <tr>
 326         <td><p><code translate="no">y_waste</code></p></td>
 327         <td><p>Amount of vertical waste (over-print) to allow.  This is useful
 328                       for minimizing alignment problems when using non-white
 329                       backgrounds (e.g. images).</p></td>
 330       </tr>
 331     </table>
 332
 333     <!-- ==== Figure ==== -->
 334     <figure>
 335       <desc><span translate="no">Label-rectangle</span> parameters</desc>
 336       <media type="image" src="figures/glabels-template-rect-label.png" mime="image/png" style="right">
 337         <p><span translate="no">Label-rectangle</span> parameters</p>
 338       </media>
 339     </figure>
 340     <!-- ==== End of Figure ==== -->
 341
 342   </section>
 343   <!-- ************************** -->
 344   <!-- END Label-rectangle Node   -->
 345   <!-- ************************** -->
 346
 347
 348   <!-- ************************ -->
 349   <!-- BEGIN Label-ellipse Node -->
 350   <!-- ************************ -->
 351   <section id="template-label-ellipse-node">
 352     <title><span translate="no">Label-ellipse</span> Node</title>
 353
 354     <p>A <code translate="no">Label-ellipse</code> node describes the
 355       dimensions of a single label or business card that is elliptic
 356       in shape.</p>
 357
 358     <table frame="all" rules="rows">
 359       <tr>
 360         <td><p>Property</p></td>  <td><p>Description</p></td>
 361       </tr>
 362       <tr>
 363         <td><p/></td>  <td><p/></td>
 364       </tr>
 365       <tr>
 366         <td><p><code translate="no">id</code></p></td>
 367         <td><p>Reserved for future use.  Should always be 0.</p></td>
 368       </tr>
 369       <tr>
 370         <td><p><code translate="no">width</code></p></td>
 371         <td><p>Width of the ellipse</p></td>
 372       </tr>
 373       <tr>
 374         <td><p><code translate="no">height</code></p></td>
 375         <td><p>Heigth of the ellipse</p></td>
 376       </tr>
 377       <tr>
 378         <td><p><code translate="no">waste</code></p></td>
 379         <td><p>Amount of waste (over-print) to allow.  This is useful
 380             for minimizing alignment problems when using non-white
 381             backgrounds (e.g. images).</p></td>
 382       </tr>
 383     </table>
 384
 385     <!-- ==== Figure ==== -->
 386     <figure>
 387       <desc><span translate="no">Label-ellipse</span> parameters</desc>
 388       <media type="image" src="figures/glabels-template-ellipse-label.png" mime="image/png" style="right">
 389         <p><span translate="no">Label-ellipse</span> parameters</p>
 390       </media>
 391     </figure>
 392     <!-- ==== End of Figure ==== -->
 393
 394   </section>
 395   <!-- ************************ -->
 396   <!-- END Label-ellipse Node   -->
 397   <!-- ************************ -->
 398
 399
 400   <!-- ********************** -->
 401   <!-- BEGIN Label-round Node -->
 402   <!-- ********************** -->
 403   <section id="template-label-round-node">
 404     <title><span translate="no">Label-round</span> Node</title>
 405
 406     <p>A <code translate="no">Label-round</code> node describes the dimensions
 407       of a simple round label (not a CD).</p>
 408
 409     <table frame="all" rules="rows">
 410       <tr>
 411         <td><p>Property</p></td>  <td><p>Description</p></td>
 412       </tr>
 413       <tr>
 414         <td><p/></td>  <td><p/></td>
 415       </tr>
 416       <tr>
 417         <td><p><code translate="no">id</code></p></td>
 418         <td><p>Reserved for future use.  Should always be 0.</p></td>
 419       </tr>
 420       <tr>
 421         <td><p><code translate="no">radius</code></p></td>
 422         <td><p>Radius (1/2 diameter) of label</p></td>
 423       </tr>
 424       <tr>
 425         <td><p><code translate="no">waste</code></p></td>
 426         <td><p>Amount of waste (over-print) to allow.  This is useful
 427                 for minimizing alignment problems when using non-white
 428                 backgrounds (e.g. images).</p></td>
 429       </tr>
 430     </table>
 431
 432     <!-- ==== Figure ==== -->
 433     <figure>
 434       <desc><span translate="no">Label-ellipse</span> parameters</desc>
 435       <media type="image" src="figures/glabels-template-circle-label.png" mime="image/png" style="right">
 436         <p><span translate="no">Label-ellipse</span> parameters</p>
 437       </media>
 438     </figure>
 439     <!-- ==== End of Figure ==== -->
 440
 441   </section>
 442   <!-- ********************** -->
 443   <!-- END Label-round Node   -->
 444   <!-- ********************** -->
 445
 446
 447   <!-- ******************* -->
 448   <!-- BEGIN Label-cd Node -->
 449   <!-- ******************* -->
 450   <section id="template-label-cd-node">
 451     <title><span translate="no">Label-cd</span> Node</title>
 452
 453     <p>A <code translate="no">Label-cd</code> node describes the dimensions
 454       of a CD, DVD, or business card CD.</p>
 455
 456     <table frame="all" rules="rows">
 457       <tr>
 458         <td><p>Property</p></td>  <td><p>Description</p></td>
 459       </tr>
 460       <tr>
 461         <td><p/></td>  <td><p/></td>
 462       </tr>
 463       <tr>
 464         <td><p><code translate="no">id</code></p></td>
 465         <td><p>Reserved for future use.  Should always be 0.</p></td>
 466       </tr>
 467       <tr>
 468         <td><p><code translate="no">radius</code></p></td>
 469         <td><p>Outer radius of label</p></td>
 470       </tr>
 471       <tr>
 472         <td><p><code translate="no">hole</code></p></td>
 473         <td><p>Radius of concentric hole</p></td>
 474       </tr>
 475       <tr>
 476         <td><p><code translate="no">width</code></p></td>
 477         <td><p>If present, the label is clipped to the given width.
 478                       (Useful for "business card CDs").</p></td>
 479       </tr>
 480       <tr>
 481         <td><p><code translate="no">height</code></p></td>
 482         <td><p>If present, the label is clipped to the given height.
 483                       (Useful for "business card CDs").</p></td>
 484       </tr>
 485       <tr>
 486         <td><p><code translate="no">waste</code></p></td>
 487         <td><p>Amount of waste (over-print) to allow.  This is useful
 488                       for minimizing alignment problems when using non-white
 489                       backgrounds (e.g. images).</p></td>
 490       </tr>
 491     </table>
 492
 493     <!-- ==== Figure ==== -->
 494     <figure>
 495       <desc><span translate="no">Label-cd</span> parameters</desc>
 496       <media type="image" src="figures/glabels-template-cd-label.png" mime="image/png" style="right">
 497         <p>CD label parameters</p>
 498       </media>
 499     </figure>
 500     <!-- ==== End of Figure ==== -->
 501
 502   </section>
 503   <!-- ******************* -->
 504   <!-- END Label-cd Node   -->
 505   <!-- ******************* -->
 506
 507
 508   <!-- ***************** -->
 509   <!-- BEGIN Markup Node -->
 510   <!-- ***************** -->
 511   <section id="template-markup">
 512     <title><span translate="no">Markup</span> Nodes</title>
 513
 514     <p>Templates may contain optional markup nodes.  These nodes are used to describe
 515     a simple set of markup lines that are visible in the <app>glabels</app> drawing canvas, but
 516     not visible when printed.  These lines can represent margins, fold lines, center lines,
 517     special areas, or other helpful hints to the user of a template.</p>
 518
 519
 520     <!-- ======================== -->
 521     <!-- BEGIN Markup-margin Node -->
 522     <!-- ======================== -->
 523     <section id="template-markup-margin-node">
 524       <title><span translate="no">Markup-margin</span> Node</title>
 525
 526       <p>A <code translate="no">Markup-margin</code> describes a margin along
 527       all edges of a label.</p>
 528
 529       <table frame="all" rules="rows">
 530         <tr>
 531           <td><p>Property</p></td>  <td><p>Description</p></td>
 532         </tr>
 533         <tr>
 534           <td><p/></td>  <td><p/></td>
 535         </tr>
 536         <tr>
 537           <td><p><code translate="no">size</code></p></td>
 538           <td><p>Size of the margin.  I.e. the distance of the margin
 539                         line from the edge of the card/label.</p></td>
 540         </tr>
 541       </table>
 542     </section>
 543     <!-- ======================== -->
 544     <!-- END Markup-margin Node   -->
 545     <!-- ======================== -->
 546
 547
 548     <!-- ====================== -->
 549     <!-- BEGIN Markup-line Node -->
 550     <!-- ====================== -->
 551     <section id="template-markup-line-node">
 552       <title><span translate="no">Markup-line</span> Node</title>
 553
 554       <p>A <code translate="no">Markup-line</code> node describes a markup line.</p>
 555
 556       <table frame="all" rules="rows">
 557         <tr>
 558           <td><p>Property</p></td>  <td><p>Description</p></td>
 559         </tr>
 560         <tr>
 561           <td><p/></td>  <td><p/></td>
 562         </tr>
 563         <tr>
 564           <td><p><code translate="no">x1</code></p></td>
 565           <td><p>x coordinate of 1st endpoint of the line segment.</p></td>
 566         </tr>
 567         <tr>
 568           <td><p><code translate="no">y1</code></p></td>
 569           <td><p>y coordinate of 1st endpoint of the line segment.</p></td>
 570         </tr>
 571         <tr>
 572           <td><p><code translate="no">x2</code></p></td>
 573           <td><p>x coordinate of 2st endpoint of the line segment.</p></td>
 574         </tr>
 575         <tr>
 576           <td><p><code translate="no">y2</code></p></td>
 577           <td><p>y coordinate of 2st endpoint of the line segment.</p></td>
 578         </tr>
 579       </table>
 580     </section>
 581     <!-- ====================== -->
 582     <!-- END Markup-line Node   -->
 583     <!-- ====================== -->
 584
 585
 586     <!-- ======================== -->
 587     <!-- BEGIN Markup-circle Node -->
 588     <!-- ======================== -->
 589     <section id="template-markup-circle-node">
 590       <title><span translate="no">Markup-circle</span> Node</title>
 591
 592       <p>A <code translate="no">Markup-circle</code> describes a markup circle.</p>
 593
 594       <table frame="all" rules="rows">
 595         <tr>
 596           <td><p>Property</p></td>  <td><p>Description</p></td>
 597         </tr>
 598         <tr>
 599           <td><p/></td>  <td><p/></td>
 600         </tr>
 601         <tr>
 602           <td><p><code translate="no">x0</code></p></td>
 603           <td><p>x coordinate of circle origin (center).</p></td>
 604         </tr>
 605         <tr>
 606           <td><p><code translate="no">y0</code></p></td>
 607           <td><p>y coordinate of circle origin (center).</p></td>
 608         </tr>
 609         <tr>
 610           <td><p><code translate="no">radius</code></p></td>
 611           <td><p>Radius of circle.</p></td>
 612         </tr>
 613       </table>
 614     </section>
 615     <!-- ======================== -->
 616     <!-- END Markup-circle Node   -->
 617     <!-- ======================== -->
 618
 619
 620     <!-- ====================== -->
 621     <!-- BEGIN Markup-rect Node -->
 622     <!-- ====================== -->
 623     <section id="template-markup-rect-node">
 624       <title><span translate="no">Markup-rect</span> Node</title>
 625
 626       <p>A <code translate="no">Markup-rect</code> describes a markup rectangle.</p>
 627
 628       <table frame="all" rules="rows">
 629         <tr>
 630           <td><p>Property</p></td>  <td><p>Description</p></td>
 631         </tr>
 632         <tr>
 633           <td><p/></td>  <td><p/></td>
 634         </tr>
 635         <tr>
 636           <td><p><code translate="no">x1</code></p></td>
 637           <td><p>x coordinate of upper left corner of rectangle.</p></td>
 638         </tr>
 639         <tr>
 640           <td><p><code translate="no">y1</code></p></td>
 641           <td><p>y coordinate of upper left corner of rectangle.</p></td>
 642         </tr>
 643         <tr>
 644           <td><p><code translate="no">w</code></p></td>
 645           <td><p>Width of rectangle.</p></td>
 646         </tr>
 647         <tr>
 648           <td><p><code translate="no">h</code></p></td>
 649           <td><p>Height of rectangle.</p></td>
 650         </tr>
 651         <tr>
 652           <td><p><code translate="no">r</code></p></td>
 653           <td><p>Radius of rounded corners of rectangle.</p></td>
 654         </tr>
 655       </table>
 656     </section>
 657     <!-- ====================== -->
 658     <!-- END Markup-rect Node   -->
 659     <!-- ====================== -->
 660
 661
 662     <!-- ========================= -->
 663     <!-- BEGIN Markup-ellipse Node -->
 664     <!-- ========================= -->
 665     <section id="template-markup-ellipse-node">
 666       <title><span translate="no">Markup-ellipse</span> Node</title>
 667
 668       <p>A <code translate="no">Markup-ellipse</code> describes a markup ellipse.</p>
 669
 670       <table frame="all" rules="rows">
 671         <tr>
 672           <td><p>Property</p></td>  <td><p>Description</p></td>
 673         </tr>
 674         <tr>
 675           <td><p/></td>  <td><p/></td>
 676         </tr>
 677         <tr>
 678           <td><p><code translate="no">x1</code></p></td>
 679           <td><p>x coordinate of upper left corner of ellipse.</p></td>
 680         </tr>
 681         <tr>
 682           <td><p><code translate="no">y1</code></p></td>
 683           <td><p>y coordinate of upper left corner of ellipse.</p></td>
 684         </tr>
 685         <tr>
 686           <td><p><code translate="no">w</code></p></td>
 687           <td><p>Width of ellipse.</p></td>
 688         </tr>
 689         <tr>
 690           <td><p><code translate="no">h</code></p></td>
 691           <td><p>Height of ellipse.</p></td>
 692         </tr>
 693       </table>
 694     </section>
 695     <!-- ========================= -->
 696     <!-- END Markup-ellipse Node   -->
 697     <!-- ========================= -->
 698
 699   </section>
 700   <!-- ***************** -->
 701   <!-- END Markup Node   -->
 702   <!-- ***************** -->
 703
 704
 705   <!-- ***************** -->
 706   <!-- BEGIN Layout Node -->
 707   <!-- ***************** -->
 708   <section id="template-layout-node">
 709     <title><span translate="no">Layout</span> Node</title>
 710
 711     <p>A label node may contain multiple <code translate="no">Layout</code>
 712       children.  If labels are arranged in a simple grid pattern, only
 713       one layout is needed.  However, if labels are arranged in multiple
 714       grids, such as a running bond pattern, multiple
 715       <code translate="no">Layout</code> tags can be used. </p>
 716         <note style="tip">
 717         <p>A single label can always be treated as a grid of one.</p>
 718       </note>
 719
 720     <table frame="all" rules="rows">
 721       <tr>
 722         <td><p>Property</p></td>  <td><p>Description</p></td>
 723       </tr>
 724       <tr>
 725         <td><p/></td>  <td><p/></td>
 726       </tr>
 727       <tr>
 728         <td><p><code translate="no">nx</code></p></td>
 729         <td><p>Number of labels/cards across in the grid (horizontal)</p></td>
 730       </tr>
 731       <tr>
 732         <td><p><code translate="no">ny</code></p></td>
 733         <td><p>Number of labels/cards across in the grid (vertical)</p></td>
 734       </tr>
 735       <tr>
 736         <td><p><code translate="no">x0</code></p></td>
 737         <td><p>Distance from left edge of sheet to the left edge of
 738             the left column of cards/labels in the layout.</p></td>
 739       </tr>
 740       <tr>
 741         <td><p><code translate="no">y0</code></p></td>
 742         <td><p>Distance from the top edge of sheet to the top edge of
 743              the top row of labels/cards in the layout.</p></td>
 744       </tr>
 745       <tr>
 746         <td><p><code translate="no">dx</code></p></td>
 747         <td><p>Horizontal pitch of grid.</p></td>
 748       </tr>
 749       <tr>
 750         <td><p><code translate="no">dy</code></p></td>
 751         <td><p>Vertical pitch of grid.</p></td>
 752       </tr>
 753     </table>
 754
 755     <!-- ==== Figure ==== -->
 756     <figure>
 757       <desc><span translate="no">Layout</span> parameters</desc>
 758       <media type="image" src="figures/glabels-template-layout.png" mime="image/png" style="right">
 759         <p><span translate="no">Layout</span> Parameters</p>
 760       </media>
 761     </figure>
 762     <!-- ==== End of Figure ==== -->
 763
 764   </section>
 765   <!-- ***************** -->
 766   <!-- END Layout Node   -->
 767   <!-- ***************** -->
 768
 769
 770 </page>