git.sur5r.net Git - glabels/blob - help/sl/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="sl">
   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>Ustvarite predloge ročno.</desc>
   9     <credit type="author">
  10       <name>Jim Evins</name>
  11       <email>evins@snaught.com</email>
  12     </credit>
  13     <credit type="author">
  14       <name>Mario Blättermann</name>
  15       <email>mariobl@gnome.org</email>
  16     </credit>
  17     <license>
  18       <p>Creative Commons Share Alike 3.0</p>
  19     </license>
  20   </info>
  21
  22   <title>Ročna izdelava novih predlog</title>
  23
  24
  25
  26   <!-- ****************** -->
  27   <!-- BEGIN Introduction -->
  28   <!-- ****************** -->
  29   <p>This page is a reference guide to manually creating <app>gLabels</app> templates.
  30   <app>gLabels</app> templates are defined in simple XML files as described in the DTD:
  31   <link href="http://glabels.org/xmlns/2.3/glabels-2.3.dtd.txt">glabels-2.3.dtd</link>
  32   (this DTD also describes other XML files used by <app>gLabels</app>).</p>
  33
  34   <p>Manually created template files should be placed in the <file>${HOME}/.glabels</file>
  35   and be named with a <file>.template</file> extension.</p>
  36
  37   <note style="advanced">
  38     <p><app>gLabels</app> searches for templates in several other locations as defined here:</p>
  39     <table frame="all" rules="rows">
  40       <tr>
  41         <td><p>Mesto</p></td>
  42         <td><p>Opis</p></td>
  43       </tr>
  44       <tr>
  45         <td><p/></td>
  46         <td><p/></td>
  47       </tr>
  48       <tr>
  49         <td><p><file>${prefix}/share/libglabels-3.0/templates</file></p></td>
  50         <td><p>Vnaprej določene predloge, vključene v <app>gLabels</app>.</p>
  51             <p><file>${prefix}</file> is usually <file>/usr</file> or <file>/usr/local</file>,
  52             depending on where <app>gLabels</app> was installed.</p></td>
  53       </tr>
  54       <tr>
  55         <td><p><file>${XDG_CONFIG_HOME}/libglabels/templates</file></p></td>
  56         <td><p>User defined templates created with the <app>gLabels</app> <gui>Template Designer</gui>.
  57             <em>Do not put manually created templates in this directory.</em></p>
  58             <p>If <file>${XDG_CONFIG_HOME}</file> is not defined, it defaults to
  59             <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>Datoteke predlog</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>Primer predloge</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>Lastnost</p></td>  <td><p>Opis</p></td>
 170       </tr>
 171       <tr>
 172         <td><p/></td>  <td><p/></td>
 173       </tr>
 174       <tr>
 175         <td><p><code translate="no">Znamka</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">Velikost</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">Opis</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">_Opis</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">Širina</code></p></td>
 199         <td><p>Širina strani. Veljavno le, če je velikost="Drugo"</p></td>
 200       </tr>
 201       <tr>
 202         <td><p><code translate="no">Višina</code></p></td>
 203         <td><p>Višina strani. Veljavno le, če je velikost="Drugo"</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>Podvozlišče</p></td>  <td><p>Opis</p></td>
 234       </tr>
 235       <tr>
 236         <td><p/></td>  <td><p/></td>
 237       </tr>
 238       <tr>
 239         <td><p><code translate="no">Kategorija</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">Nalepke</code></p></item>
 252               <item><p><code translate="no">Okrogle nalepke</code></p></item>
 253               <item><p><code translate="no">Eliptične nalepke</code></p></item>
 254               <item><p><code translate="no">Kvadratne nalepke</code></p></item>
 255               <item><p><code translate="no">Pravokotne nalepke</code></p></item>
 256               <item><p><code translate="no">Kartončki</code></p></item>
 257               <item><p><code translate="no">Vizitke</code></p></item>
 258               <item><p><code translate="no">media</code></p></item>
 259               <item><p><code translate="no">Pošta</code></p></item>
 260               <item><p><code translate="no">Zloženka</code></p></item>
 261               <item><p><code translate="no">Fotografija</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>Lastnost</p></td>  <td><p>Opis</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>Rezervirano za kasnejšo uporabo. Naj bo vedno 0.</p></td>
 305       </tr>
 306       <tr>
 307         <td><p><code translate="no">Širina</code></p></td>
 308         <td><p>Širina nalepke/kartončka/vizitke</p></td>
 309       </tr>
 310       <tr>
 311         <td><p><code translate="no">Višina</code></p></td>
 312         <td><p>Višina nalepke/kartončka/vizitke</p></td>
 313       </tr>
 314       <tr>
 315         <td><p><code translate="no">round</code></p></td>
 316         <td><p>Polmer kotov. Pri elementih s pravimi koti (vizitke) mora biti polmer 0.</p></td>
 317       </tr>
 318       <tr>
 319         <td><p><code translate="no">Odpadek x</code></p></td>
 320         <td><p>Amount of horizontal waste (over-print) to allow.  This is useful
 321                       for minimizing alignment problems when using non-white
 322                       backgrounds (e.g. images).</p></td>
 323       </tr>
 324       <tr>
 325         <td><p><code translate="no">Odpadek y</code></p></td>
 326         <td><p>Amount of vertical waste (over-print) to allow.  This is useful
 327                       for minimizing alignment problems when using non-white
 328                       backgrounds (e.g. images).</p></td>
 329       </tr>
 330     </table>
 331
 332     <!-- ==== Figure ==== -->
 333     <figure>
 334       <desc><span translate="no">Label-rectangle</span> parameters</desc>
 335       <media type="image" src="figures/glabels-template-rect-label.png" mime="image/png" style="right">
 336         <p><span translate="no">Label-rectangle</span> parameters</p>
 337       </media>
 338     </figure>
 339     <!-- ==== End of Figure ==== -->
 340
 341   </section>
 342   <!-- ************************** -->
 343   <!-- END Label-rectangle Node   -->
 344   <!-- ************************** -->
 345
 346
 347   <!-- ************************ -->
 348   <!-- BEGIN Label-ellipse Node -->
 349   <!-- ************************ -->
 350   <section id="template-label-ellipse-node">
 351     <title><span translate="no">Label-ellipse</span> Node</title>
 352
 353     <p>A <code translate="no">Label-ellipse</code> node describes the
 354       dimensions of a single label or business card that is elliptic
 355       in shape.</p>
 356
 357     <table frame="all" rules="rows">
 358       <tr>
 359         <td><p>Lastnost</p></td>  <td><p>Opis</p></td>
 360       </tr>
 361       <tr>
 362         <td><p/></td>  <td><p/></td>
 363       </tr>
 364       <tr>
 365         <td><p><code translate="no">id</code></p></td>
 366         <td><p>Rezervirano za kasnejšo uporabo. Naj bo vedno 0.</p></td>
 367       </tr>
 368       <tr>
 369         <td><p><code translate="no">Širina</code></p></td>
 370         <td><p>Širina elipse</p></td>
 371       </tr>
 372       <tr>
 373         <td><p><code translate="no">Višina</code></p></td>
 374         <td><p>Višina elipse</p></td>
 375       </tr>
 376       <tr>
 377         <td><p><code translate="no">Odpadek</code></p></td>
 378         <td><p>Amount of waste (over-print) to allow.  This is useful
 379             for minimizing alignment problems when using non-white
 380             backgrounds (e.g. images).</p></td>
 381       </tr>
 382     </table>
 383
 384     <!-- ==== Figure ==== -->
 385     <figure>
 386       <desc><span translate="no">Label-ellipse</span> parameters</desc>
 387       <media type="image" src="figures/glabels-template-ellipse-label.png" mime="image/png" style="right">
 388         <p><span translate="no">Label-ellipse</span> parameters</p>
 389       </media>
 390     </figure>
 391     <!-- ==== End of Figure ==== -->
 392
 393   </section>
 394   <!-- ************************ -->
 395   <!-- END Label-ellipse Node   -->
 396   <!-- ************************ -->
 397
 398
 399   <!-- ********************** -->
 400   <!-- BEGIN Label-round Node -->
 401   <!-- ********************** -->
 402   <section id="template-label-round-node">
 403     <title><span translate="no">Label-round</span> Node</title>
 404
 405     <p>A <code translate="no">Label-round</code> node describes the dimensions
 406       of a simple round label (not a CD).</p>
 407
 408     <table frame="all" rules="rows">
 409       <tr>
 410         <td><p>Lastnost</p></td>  <td><p>Opis</p></td>
 411       </tr>
 412       <tr>
 413         <td><p/></td>  <td><p/></td>
 414       </tr>
 415       <tr>
 416         <td><p><code translate="no">id</code></p></td>
 417         <td><p>Rezervirano za kasnejšo uporabo. Naj bo vedno 0.</p></td>
 418       </tr>
 419       <tr>
 420         <td><p><code translate="no">Polmer</code></p></td>
 421         <td><p>Polmer (polovica premera) nalepke</p></td>
 422       </tr>
 423       <tr>
 424         <td><p><code translate="no">Odpadek</code></p></td>
 425         <td><p>Amount of waste (over-print) to allow.  This is useful
 426                 for minimizing alignment problems when using non-white
 427                 backgrounds (e.g. images).</p></td>
 428       </tr>
 429     </table>
 430
 431     <!-- ==== Figure ==== -->
 432     <figure>
 433       <desc><span translate="no">Label-ellipse</span> parameters</desc>
 434       <media type="image" src="figures/glabels-template-circle-label.png" mime="image/png" style="right">
 435         <p><span translate="no">Label-ellipse</span> parameters</p>
 436       </media>
 437     </figure>
 438     <!-- ==== End of Figure ==== -->
 439
 440   </section>
 441   <!-- ********************** -->
 442   <!-- END Label-round Node   -->
 443   <!-- ********************** -->
 444
 445
 446   <!-- ******************* -->
 447   <!-- BEGIN Label-cd Node -->
 448   <!-- ******************* -->
 449   <section id="template-label-cd-node">
 450     <title><span translate="no">Label-cd</span> Node</title>
 451
 452     <p>A <code translate="no">Label-cd</code> node describes the dimensions
 453       of a CD, DVD, or business card CD.</p>
 454
 455     <table frame="all" rules="rows">
 456       <tr>
 457         <td><p>Lastnost</p></td>  <td><p>Opis</p></td>
 458       </tr>
 459       <tr>
 460         <td><p/></td>  <td><p/></td>
 461       </tr>
 462       <tr>
 463         <td><p><code translate="no">id</code></p></td>
 464         <td><p>Rezervirano za kasnejšo uporabo. Naj bo vedno 0.</p></td>
 465       </tr>
 466       <tr>
 467         <td><p><code translate="no">Polmer</code></p></td>
 468         <td><p>Zunanji polmer nalepke</p></td>
 469       </tr>
 470       <tr>
 471         <td><p><code translate="no">Luknja</code></p></td>
 472         <td><p>Polmer koncentrične luknje</p></td>
 473       </tr>
 474       <tr>
 475         <td><p><code translate="no">Širina</code></p></td>
 476         <td><p>If present, the label is clipped to the given width.
 477                       (Useful for "business card CDs").</p></td>
 478       </tr>
 479       <tr>
 480         <td><p><code translate="no">Višina</code></p></td>
 481         <td><p>If present, the label is clipped to the given height.
 482                       (Useful for "business card CDs").</p></td>
 483       </tr>
 484       <tr>
 485         <td><p><code translate="no">Odpadek</code></p></td>
 486         <td><p>Amount of waste (over-print) to allow.  This is useful
 487                       for minimizing alignment problems when using non-white
 488                       backgrounds (e.g. images).</p></td>
 489       </tr>
 490     </table>
 491
 492     <!-- ==== Figure ==== -->
 493     <figure>
 494       <desc><span translate="no">Label-cd</span> parameters</desc>
 495       <media type="image" src="figures/glabels-template-cd-label.png" mime="image/png" style="right">
 496         <p>Lastnosti nalepke za zgoščenko</p>
 497       </media>
 498     </figure>
 499     <!-- ==== End of Figure ==== -->
 500
 501   </section>
 502   <!-- ******************* -->
 503   <!-- END Label-cd Node   -->
 504   <!-- ******************* -->
 505
 506
 507   <!-- ***************** -->
 508   <!-- BEGIN Markup Node -->
 509   <!-- ***************** -->
 510   <section id="template-markup">
 511     <title><span translate="no">Markup</span> Nodes</title>
 512
 513     <p>Templates may contain optional markup nodes.  These nodes are used to describe
 514     a simple set of markup lines that are visible in the <app>glabels</app> drawing canvas, but
 515     not visible when printed.  These lines can represent margins, fold lines, center lines,
 516     special areas, or other helpful hints to the user of a template.</p>
 517
 518
 519     <!-- ======================== -->
 520     <!-- BEGIN Markup-margin Node -->
 521     <!-- ======================== -->
 522     <section id="template-markup-margin-node">
 523       <title><span translate="no">Markup-margin</span> Node</title>
 524
 525       <p>A <code translate="no">Markup-margin</code> describes a margin along
 526       all edges of a label.</p>
 527
 528       <table frame="all" rules="rows">
 529         <tr>
 530           <td><p>Lastnost</p></td>  <td><p>Opis</p></td>
 531         </tr>
 532         <tr>
 533           <td><p/></td>  <td><p/></td>
 534         </tr>
 535         <tr>
 536           <td><p><code translate="no">Velikost</code></p></td>
 537           <td><p>Size of the margin.  I.e. the distance of the margin
 538                         line from the edge of the card/label.</p></td>
 539         </tr>
 540       </table>
 541     </section>
 542     <!-- ======================== -->
 543     <!-- END Markup-margin Node   -->
 544     <!-- ======================== -->
 545
 546
 547     <!-- ====================== -->
 548     <!-- BEGIN Markup-line Node -->
 549     <!-- ====================== -->
 550     <section id="template-markup-line-node">
 551       <title><span translate="no">Markup-line</span> Node</title>
 552
 553       <p>A <code translate="no">Markup-line</code> node describes a markup line.</p>
 554
 555       <table frame="all" rules="rows">
 556         <tr>
 557           <td><p>Lastnost</p></td>  <td><p>Opis</p></td>
 558         </tr>
 559         <tr>
 560           <td><p/></td>  <td><p/></td>
 561         </tr>
 562         <tr>
 563           <td><p><code translate="no">x1</code></p></td>
 564           <td><p>Koordinata x prve končne točke odseka črte.</p></td>
 565         </tr>
 566         <tr>
 567           <td><p><code translate="no">y1</code></p></td>
 568           <td><p>Koordinata y prve končne točke odseka črte.</p></td>
 569         </tr>
 570         <tr>
 571           <td><p><code translate="no">x2</code></p></td>
 572           <td><p>Koordinata x druge končne točke odseka črte.</p></td>
 573         </tr>
 574         <tr>
 575           <td><p><code translate="no">y2</code></p></td>
 576           <td><p>Koordinata y druge končne točke odseka črte.</p></td>
 577         </tr>
 578       </table>
 579     </section>
 580     <!-- ====================== -->
 581     <!-- END Markup-line Node   -->
 582     <!-- ====================== -->
 583
 584
 585     <!-- ======================== -->
 586     <!-- BEGIN Markup-circle Node -->
 587     <!-- ======================== -->
 588     <section id="template-markup-circle-node">
 589       <title><span translate="no">Markup-circle</span> Node</title>
 590
 591       <p>A <code translate="no">Markup-circle</code> describes a markup circle.</p>
 592
 593       <table frame="all" rules="rows">
 594         <tr>
 595           <td><p>Lastnost</p></td>  <td><p>Opis</p></td>
 596         </tr>
 597         <tr>
 598           <td><p/></td>  <td><p/></td>
 599         </tr>
 600         <tr>
 601           <td><p><code translate="no">x0</code></p></td>
 602           <td><p>Koordinata x središča kroga.</p></td>
 603         </tr>
 604         <tr>
 605           <td><p><code translate="no">y0</code></p></td>
 606           <td><p>Koordinata y središča kroga.</p></td>
 607         </tr>
 608         <tr>
 609           <td><p><code translate="no">Polmer</code></p></td>
 610           <td><p>Polmer kroga.</p></td>
 611         </tr>
 612       </table>
 613     </section>
 614     <!-- ======================== -->
 615     <!-- END Markup-circle Node   -->
 616     <!-- ======================== -->
 617
 618
 619     <!-- ====================== -->
 620     <!-- BEGIN Markup-rect Node -->
 621     <!-- ====================== -->
 622     <section id="template-markup-rect-node">
 623       <title><span translate="no">Markup-rect</span> Node</title>
 624
 625       <p>A <code translate="no">Markup-rect</code> describes a markup rectangle.</p>
 626
 627       <table frame="all" rules="rows">
 628         <tr>
 629           <td><p>Lastnost</p></td>  <td><p>Opis</p></td>
 630         </tr>
 631         <tr>
 632           <td><p/></td>  <td><p/></td>
 633         </tr>
 634         <tr>
 635           <td><p><code translate="no">x1</code></p></td>
 636           <td><p>Koordinata x levega zgornjega kota pravokotnika.</p></td>
 637         </tr>
 638         <tr>
 639           <td><p><code translate="no">y1</code></p></td>
 640           <td><p>Koordinata y levega zgornjega kota pravokotnika.</p></td>
 641         </tr>
 642         <tr>
 643           <td><p><code translate="no">š</code></p></td>
 644           <td><p>Širina pravokotnika.</p></td>
 645         </tr>
 646         <tr>
 647           <td><p><code translate="no">v</code></p></td>
 648           <td><p>Višina pravokotnika.</p></td>
 649         </tr>
 650         <tr>
 651           <td><p><code translate="no">r</code></p></td>
 652           <td><p>Polmer zaobljenih robov pravokotnika.</p></td>
 653         </tr>
 654       </table>
 655     </section>
 656     <!-- ====================== -->
 657     <!-- END Markup-rect Node   -->
 658     <!-- ====================== -->
 659
 660
 661     <!-- ========================= -->
 662     <!-- BEGIN Markup-ellipse Node -->
 663     <!-- ========================= -->
 664     <section id="template-markup-ellipse-node">
 665       <title><span translate="no">Markup-ellipse</span> Node</title>
 666
 667       <p>A <code translate="no">Markup-ellipse</code> describes a markup ellipse.</p>
 668
 669       <table frame="all" rules="rows">
 670         <tr>
 671           <td><p>Lastnost</p></td>  <td><p>Opis</p></td>
 672         </tr>
 673         <tr>
 674           <td><p/></td>  <td><p/></td>
 675         </tr>
 676         <tr>
 677           <td><p><code translate="no">x1</code></p></td>
 678           <td><p>Koordinata x levega zgornjega kota elipse.</p></td>
 679         </tr>
 680         <tr>
 681           <td><p><code translate="no">y1</code></p></td>
 682           <td><p>Koordinata y levega zgornjega kota elipse.</p></td>
 683         </tr>
 684         <tr>
 685           <td><p><code translate="no">š</code></p></td>
 686           <td><p>Širina elipse.</p></td>
 687         </tr>
 688         <tr>
 689           <td><p><code translate="no">v</code></p></td>
 690           <td><p>Višina elipse.</p></td>
 691         </tr>
 692       </table>
 693     </section>
 694     <!-- ========================= -->
 695     <!-- END Markup-ellipse Node   -->
 696     <!-- ========================= -->
 697
 698   </section>
 699   <!-- ***************** -->
 700   <!-- END Markup Node   -->
 701   <!-- ***************** -->
 702
 703
 704   <!-- ***************** -->
 705   <!-- BEGIN Layout Node -->
 706   <!-- ***************** -->
 707   <section id="template-layout-node">
 708     <title><span translate="no">Layout</span> Node</title>
 709
 710     <p>A label node may contain multiple <code translate="no">Layout</code>
 711       children.  If labels are arranged in a simple grid pattern, only
 712       one layout is needed.  However, if labels are arranged in multiple
 713       grids, such as a running bond pattern, multiple
 714       <code translate="no">Layout</code> tags can be used. </p>
 715     <p>A common example for multiple layouts is a sheet with three
 716        CD labels:</p>
 717
 718     <!-- ==== Figure ==== -->
 719     <figure>
 720       <desc>List nalepk za zgoščenko</desc>
 721       <media type="image" src="figures/layouts-cdlabel.png" mime="image/png" style="right">
 722         <p>List nalepk za zgoščenko</p>
 723       </media>
 724     </figure>
 725     <!-- ==== End of Figure ==== -->
 726
 727     <p>The two labels on the left edge can be assigned to a grid, assuming we
 728        can define the coordinates for the top left label and the distance to
 729        the second label properly. The distance to the left edge is common to
 730        these labels. The third one on the right edge has no common distance
 731        values with the other ones, that's why we have to define a second layout,
 732        with unique coordinates for the top left corner of that label.</p>
 733
 734         <note style="tip">
 735         <p>You can define multiple layouts only if the labels on the sheet
 736         have the same shape. If your sheet contains different shapes, you have
 737         to define each shape in another template seperately. Future versions
 738         of <app>gLabels</app> will probably be able to concatenate such sheets
 739         with different shapes within a single template.</p>
 740       </note>
 741
 742         <note style="tip">
 743         <p>A single label can always be treated as a grid of one.</p>
 744       </note>
 745
 746     <table frame="all" rules="rows">
 747       <tr>
 748         <td><p>Lastnost</p></td>  <td><p>Opis</p></td>
 749       </tr>
 750       <tr>
 751         <td><p/></td>  <td><p/></td>
 752       </tr>
 753       <tr>
 754         <td><p><code translate="no">nx</code></p></td>
 755         <td><p>Število nalepk/kartončkov/vizitk v vrsti (vodoravno)</p></td>
 756       </tr>
 757       <tr>
 758         <td><p><code translate="no">ny</code></p></td>
 759         <td><p>Število nalepk/kartončkov/vizitk v vrsti (navpično)</p></td>
 760       </tr>
 761       <tr>
 762         <td><p><code translate="no">x0</code></p></td>
 763         <td><p>Distance from left edge of sheet to the left edge of
 764             the left column of cards/labels in the layout.</p></td>
 765       </tr>
 766       <tr>
 767         <td><p><code translate="no">y0</code></p></td>
 768         <td><p>Distance from the top edge of sheet to the top edge of
 769              the top row of labels/cards in the layout.</p></td>
 770       </tr>
 771       <tr>
 772         <td><p><code translate="no">dx</code></p></td>
 773         <td><p>Vodoravna razdalja mreže</p></td>
 774       </tr>
 775       <tr>
 776         <td><p><code translate="no">dy</code></p></td>
 777         <td><p>Navpična razdalja mreže</p></td>
 778       </tr>
 779     </table>
 780
 781     <!-- ==== Figure ==== -->
 782     <figure>
 783       <desc><span translate="no">Layout</span> parameters</desc>
 784       <media type="image" src="figures/glabels-template-layout.png" mime="image/png" style="right">
 785         <p><span translate="no">Layout</span> Parameters</p>
 786       </media>
 787     </figure>
 788     <!-- ==== End of Figure ==== -->
 789
 790   </section>
 791   <!-- ***************** -->
 792   <!-- END Layout Node   -->
 793   <!-- ***************** -->
 794
 795
 796 </page>