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