From d086e015fc2e516ac10bcf2915e36164acf03afa Mon Sep 17 00:00:00 2001 From: =?utf8?q?Mario=20Bl=C3=A4ttermann?= Date: Sat, 4 Dec 2010 15:26:37 +0100 Subject: [PATCH] Added markup for non-translatable items --- help/C/mancreate.page | 269 ++++++++++++++++++++++++++---------------- 1 file changed, 166 insertions(+), 103 deletions(-) diff --git a/help/C/mancreate.page b/help/C/mancreate.page index 272cb6d3..06eba5be 100644 --- a/help/C/mancreate.page +++ b/help/C/mancreate.page @@ -89,12 +89,13 @@
- Template Node + <span translate="no">Template</span> Node -

A Template node describes a single stationary - product. It must contain one instance of any type of Label node - (Label-rectangle, - Label-round, or Label-cd).

+

A Template node describes a single + stationery product. It must contain one instance of any type of Label node + (Label-rectangle, + Label-round, or + Label-cd).

@@ -104,38 +105,52 @@ - + + - + + - + + - + + - + + - + + - + + - + +

brand

Brand or manufacturer of stationary product. E.g. "Avery"

brand

Brand or manufacturer of stationery product. E.g. "Avery"

part

Part number or name of stationary product. E.g. "8160"

part

Part number or name of stationery product. E.g. "8160"

size

Size of sheet. E.g., "US-Letter," "A4", ...

size

Size of sheet. E.g., "US-Letter," "A4", ...

description

Description of stationary product. E.g, "Mailing Labels."

description

Description of stationery product. E.g, "Mailing Labels."

_description

Translatable description of stationary product. E.g, "Mailing Labels." (Only useful for predefined templates)

_description

Translatable description of stationery product. E.g, "Mailing Labels." + (Only useful for predefined templates)

width

Page width. Only valid if size="Other"

width

Page width. Only valid if size="Other"

height

Page height. Only valid if size="Other"

height

Page height. Only valid if size="Other"

equiv

Equivalent part number. If this property is present, the template is a clone of another template of the same brand. The template will inherit all properties, except brand and name from the other template. This equiv property must refer to a previously defined template -- libglabels does not currently support forward references.

equiv

Equivalent part number. If this property is present, the template + is a clone of another template of the same brand. The template will + inherit all properties, except brand and name from the other template. + This equiv property must refer to a previously defined template -- + libglabels does not currently support forward references.
- Meta Node + <span translate="no">Meta</span> Node -

A Meta node contains some additional properties of that product. - This node may appear more than once, with a subnode each.

+

A Meta node contains some additional + properties of that product. This node may appear more than once, with a + subnode each.

@@ -145,23 +160,24 @@ - + - +

category

The category which this product is assigned to. The value +

category

The category which this product is assigned to. The value of this category is used by the gLabels' template chooser to filter the view to display only mailing labels, or labels in common and suppress any other products which the user don't want to find.

One product can be assigned to several categories. You may choose from the following categories:

-

label

 -

round-label

 -

elliptical-label

 -

square-label

 -

rectangle-label

 -

card

 -

business-card

 -

media

 -

mail

 -

foldable

 +

label

 +

round-label

 +

elliptical-label

 +

square-label

 +

rectangle-label

 +

card

 +

business-card

 +

media

 +

mail

 +

foldable

If you have any ideas for new categories, please send your suggestions to the developer's mailing list @@ -170,7 +186,8 @@

product_url

This address points to the vendor's website. Ideally, +

product_url

This address points to the vendor's website. Ideally, the link shows the URL of that certain product, if available.
@@ -178,9 +195,9 @@
- Label-rectangle Node + <span translate="no">Label-rectangle</span> Node -

A Label-rectangle node describes the +

A Label-rectangle node describes the dimensions of a single label or business card that is rectangular in shape (may have rounded edges).

@@ -192,24 +209,31 @@

-

id

Reserved for future use. Should always be 0.

+

id

+

Reserved for future use. Should always be 0.

-

width

Width of label/card

+

width

+

Width of label/card

-

height

Heigth of label/card

+

height

+

Heigth of label/card

-

round

Radius of corners. For items with square edges (business cards), the radius should be 0.

+

round

+

Radius of corners. For items with square edges (business cards), + the radius should be 0.

-

x_waste

Amount of horizontal waste (over-print) to allow. This is useful +

x_waste

+

Amount of horizontal waste (over-print) to allow. This is useful for minimizing alignment problems when using non-white backgrounds (e.g. images).

-

y_waste

Amount of vertical waste (over-print) to allow. This is useful +

y_waste

+

Amount of vertical waste (over-print) to allow. This is useful for minimizing alignment problems when using non-white backgrounds (e.g. images).

@@ -217,18 +241,18 @@
- Label-rectangle parameters + Label-rectangle parameters -

Label-rectangle parameters

+

Label-rectangle parameters
- Label-ellipse Node + <span translate="no">Label-ellipse</span> Node -

A Label-ellipse node describes the +

A Label-ellipse node describes the dimensions of a single label or business card that is elliptic in shape.

@@ -240,16 +264,20 @@

-

id

Reserved for future use. Should always be 0.

+

id

+

Reserved for future use. Should always be 0.

-

width

Width of the ellipse

+

width

+

Width of the ellipse

-

height

Heigth of the ellipse

+

height

+

Heigth of the ellipse

-

waste

Amount of waste (over-print) to allow. This is useful +

waste

+

Amount of waste (over-print) to allow. This is useful for minimizing alignment problems when using non-white backgrounds (e.g. images).

@@ -257,17 +285,18 @@
- Label-ellipse parameters + Label-ellipse parameters +

Label-ellipse parameters
- Label-round Node + <span translate="no">Label-round</span> Node -

A Label-round node describes the dimensions +

A Label-round node describes the dimensions of a simple round label (not a CD).

@@ -278,13 +307,16 @@ - + + - + + - + @@ -292,18 +324,18 @@
- Label-ellipse parameters + Label-ellipse parameters -

Label-ellipse parameters

+

Label-ellipse parameters
- Label-cd Node + <span translate="no">Label-cd</span> Node -

A Label-cd node describes the dimensions +

A Label-cd node describes the dimensions of a CD, DVD, or business card CD.

id

Reserved for future use. Should always be 0.

id

Reserved for future use. Should always be 0.

radius

Radius (1/2 diameter) of label

radius

Radius (1/2 diameter) of label

waste

Amount of waste (over-print) to allow. This is useful +

waste

Amount of waste (over-print) to allow. This is useful for minimizing alignment problems when using non-white backgrounds (e.g. images).
@@ -314,22 +346,30 @@ - + + - + + - + + - + - - + + + - - + + + @@ -337,7 +377,7 @@
- Label-cd parameters + Label-cd parameters

CD label parameters

 @@ -346,7 +386,7 @@
- Markup Nodes + <span translate="no">Markup</span> Nodes

Templates may contain optional markup nodes. These nodes are used to describe a simple set of markup lines that are visible in the glabels drawing canvas, but @@ -354,9 +394,9 @@ special areas, or other helpful hints to the user of a template.

- Markup-margin Node + <span translate="no">Markup-margin</span> Node -

A Markup-margin describes a margin along +

A Markup-margin describes a margin along all edges of a label.

id

Reserved for future use. Should always be 0.

id

Reserved for future use. Should always be 0.

radius

Outer radius of label

radius

Outer radius of label

hole

Radius of concentric hole

hole

Radius of concentric hole

width

If present, the label is clipped to the given width. +

width

If present, the label is clipped to the given width. (Useful for "business card CDs").

height

If present, the label is clipped to the given height. +

height

If present, the label is clipped to the given height. (Useful for "business card CDs").

waste

Amount of waste (over-print) to allow. This is useful +

waste

Amount of waste (over-print) to allow. This is useful for minimizing alignment problems when using non-white backgrounds (e.g. images).
@@ -367,16 +407,17 @@ - +

size

Size of the margin. I.e. the distance of the margin +

size

Size of the margin. I.e. the distance of the margin line from the edge of the card/label.
- Markup-line Node + <span translate="no">Markup-line</span> Node -

A Markup-line describes a markup line.

+

A Markup-line node describes a markup line.

@@ -386,24 +427,28 @@ - + + - + + - + + - + +

x1

x coordinate of 1st endpoint of the line segment.

x1

x coordinate of 1st endpoint of the line segment.

y1

y coordinate of 1st endpoint of the line segment.

y1

y coordinate of 1st endpoint of the line segment.

x2

x coordinate of 2st endpoint of the line segment.

x2

x coordinate of 2st endpoint of the line segment.

y2

y coordinate of 2st endpoint of the line segment.

y2

y coordinate of 2st endpoint of the line segment.
- Markup-circle Node + <span translate="no">Markup-circle</span> Node -

A Markup-circle describes a markup circle.

+

A Markup-circle describes a markup circle.

@@ -413,21 +458,24 @@ - + + - + + - + +

x0

x coordinate of circle origin (center).

x0

x coordinate of circle origin (center).

y0

y coordinate of circle origin (center).

y0

y coordinate of circle origin (center).

radius

Radius of circle.

radius

Radius of circle.
- Markup-rect Node + <span translate="no">Markup-rect</span> Node -

A Markup-rect describes a markup rectangle.

+

A Markup-rect describes a markup rectangle.

@@ -437,27 +485,32 @@ - + + - + + - + + - + + - + +

x1

x coordinate of upper left corner of rectangle.

x1

x coordinate of upper left corner of rectangle.

y1

y coordinate of upper left corner of rectangle.

y1

y coordinate of upper left corner of rectangle.

w

Width of rectangle.

w

Width of rectangle.

h

Height of rectangle.

h

Height of rectangle.

r

Radius of rounded corners of rectangle.

r

Radius of rounded corners of rectangle.
- Markup-ellipse Node + <span translate="no">Markup-ellipse</span> Node -

A Markup-ellipse describes a markup ellipse.

+

A Markup-ellipse describes a markup ellipse.

@@ -467,16 +520,20 @@ - + + - + + - + + - + +

x1

x coordinate of upper left corner of ellipse.

x1

x coordinate of upper left corner of ellipse.

y1

y coordinate of upper left corner of ellipse.

y1

y coordinate of upper left corner of ellipse.

w

Width of ellipse.

w

Width of ellipse.

h

Height of ellipse.

h

Height of ellipse.
@@ -484,14 +541,14 @@
- Layout Node + <span translate="no">Layout</span> Node -

A label node may contain multiple Layout +

A label node may contain multiple Layout children. If labels are arranged in a simple grid pattern, only one layout is needed. However, if labels are arranged in multiple grids, such as a running bond pattern, multiple - layout tags can be used. Note: a single label - can always be treated as a grid of one.

+ Layout tags can be used. + Note: a single label can always be treated as a grid of one.

@@ -501,32 +558,38 @@ - + + - + + - + - + - + + - + +

nx

Number of labels/cards across in the grid (horizontal)

nx

Number of labels/cards across in the grid (horizontal)

ny

Number of labels/cards across in the grid (vertical)

ny

Number of labels/cards across in the grid (vertical)

x0

Distance from left edge of sheet to the left edge of +

x0

Distance from left edge of sheet to the left edge of the left column of cards/labels in the layout.

y0

Distance from the top edge of sheet to the top edge of +

y0

Distance from the top edge of sheet to the top edge of the top row of labels/cards in the layout.

dx

Horizontal pitch of grid.

dx

Horizontal pitch of grid.

dy

Vertical pitch of grid.

dy

Vertical pitch of grid.
- Layout parameters + Layout parameters -

Layout Parameters

+

Layout Parameters
-- 2.39.5