टेम्पलेट:Trade designation/doc

{{Trade designation}}, short form {{Tdes}}, displays the trade designation (a.k.a. selling name, marketing name) of a cultivated plant in a different style, as required by the International Code of Nomenclature for Cultivated Plants (ICNCP). This practice has also been adopted by the British Royal Horticultural Society (RHS).

Some of the de facto conventions regularly used for trade designations do not work well in an online encyclopedia. For example, printed texts often use a serif font family for the main text and a sans-serif family for trade designations (or vice-versa). Since readers can set their own browser default fonts, this approach does not work in Wikipedia; many readers view all of Wikipedia in a serif font because they prefer it that way. Even when they don't, MediaWiki's "typography refresh" (from 2014 onward) now uses serif for article headings, so any trade designation appearing in a heading would not be distinguished.

The template shows trade designations, by default, in a monospaced (non-proportional) font that has been kerned for readability and to distinguish it from other uses of monospace. If that particular presentation does't work well in a particular case, it can be changed to something else. This output, using a CSS font stack, works cross-platform, regardless of browser and operating system. It has been tested in Mac OS X, Windows 8, several Linux distributions, OpenBSD Unix, Android, iOS, and ChromeOS.

Examples

Default output

• ''Choisya ternata'' {{trade designation|Goldfingers}} 'Limo', in which {{trade designation|Goldfingers}} is the trade designation

produces:

• Choisya ternata Goldfingers 'Limo', in which Goldfingers is the trade designation

Small capitals

The small caps style used in the ICNCP documentation can be produced by adding a second parameter with the value smallcaps (or small or caps):

• ''Choisya ternata'' {{trade designation|Goldfingers|smallcaps}} 'Limo', in which {{trade designation|Goldfingers|smallcaps}} is the trade designation

produces:

• Choisya ternata Goldfingers 'Limo', in which Goldfingers is the trade designation

Comic Sans

The font Comic Sans, which is supported on most readers' computers, can be produced with a second parameter with the value comicsans (or comic):

• ''Choisya ternata'' {{trade designation|Goldfingers|comicsans}} 'Limo', in which {{trade designation/sandbox|Goldfingers|comicsans}} is the trade designation

produces:

• Choisya ternata Goldfingers 'Limo', in which Goldfingers is the trade designation

Custom style

Add a |style= (a.k.a. |custom= or |css=) parameter with a value containing valid CSS, terminating with a ; (semicolon) character:

Small text

• ''Choisya ternata'' {{trade designation|Goldfingers|style=font-size:90%;}} 'Limo', in which {{trade designation|Goldfingers|style=font-size:90%;}} is the trade designation

produces:

• Choisya ternata Goldfingers 'Limo', in which Goldfingers is the trade designation

Grey text

• ''Choisya ternata'' {{trade designation|Goldfingers|style=color:#696969;}} 'Limo', in which {{trade designation|Goldfingers|style=color:#696969;}} is the trade designation

produces:

• Choisya ternata Goldfingers 'Limo', in which Goldfingers is the trade designation

Please do not use this feature to apply any of the following: serif/roman font (for the reason already given above), italics/oblique (which is for binomials and trinomials); an uncommon font (which will not work on many systems); boldface, underlining, garish color, an excessively large font, or wide letter spacing (all forms of excessive emphasis); or a tiny font (hard to read and thus an accessibility problem).

Note that some CSS3 properties are not well-supported yet. E.g., font-stretch is supported only by one major browser, जुलाई 2015 तक ले , so letter-spacing has to be used for this effect instead, which is how the default output of this template is kerned.

No template-applied style

Plain text can be produced by adding a second parameter with the value plain (or text). This produces no stylistic change.

• ''Choisya ternata'' {{trade designation|Goldfingers}} 'Limo', in which {{trade designation|Goldfingers|plain}} is the trade designation

produces:

• Choisya ternata Goldfingers 'Limo', in which Goldfingers is the trade designation

The only practical use for this is in mid-sentence in frequent later references to the trade designation in the same article, when it is no longer really necessary to typographically distinguish it. The template around the name still makes clear to other editors that the name is a trade designation, and so should not be enclosed in single quotes as if it were a cultivar name.

Overriding with user style

Any logged-in user can override this template's output with a user stylesheet; the template assigns as CSS class of trade_designation to its content. For example, to always display trade designations in small capitals, overriding whatever has been set by the template, add the following line to your Special:Mypage/common.css:

.trade-designation {
  /* override anything the template might do: */
  font-style: inherit !important; 
  font-family: inherit !important;
  font-weight: inherit !important;
  font-size: inherit !important;
  font-stretch: inherit !important;
  letter-spacing: inherit !important;
  word-spacing: inherit !important;
  color: inherit !important;
  /* then use the preferred style: */
  font-variant: small-caps !important;
  }