Калып:Tld

Wikipedia дан
Jump to navigation Jump to search

{{Tld}}

[edit] Documentation


This page provides documentation for {{tlc}}, {{tld}} and {{tlf}}.

Purpose and naming[булагын оңдоо]

When a template name with braces is to be shown in documentation, the braces have to be escaped in some way so it doesn't become an actual call to the template. Instead of using <nowiki></nowiki> tags you can write it more simply and concisely by using the Калып:Tlc, Калып:Tlc, or Калып:Tlc templates.

These templates work similarly to Калып:Tlc and Калып:Tlc, but don't make the template name into a link. When writing documentation you might want to avoid a lot of unnecessary links, since they can decrease readability. So on the first occurrence of a template name use {{tl}} or {{tlx}}, and then use Калып:Tlc, Калып:Tlc or Калып:Tlc thereafter.

Template Mnemonic Format differentiation
Калып:Tlc Template link code Uses the <code>...</code> tags meant for showing programming code. Essentially the non-linking equivalent of {{tlx}}.
Калып:Tlc Template link dialup-host
Калып:Tlc Template link format-normal Uses proportional-spaced font as is normal for regular text rather than a monospace font as typically used with programming code. Essentially the non-linking equivalent of {{tlp}}.

The three names were based on {{tl}} template link, despite the fact that, unlike the actual Калып:Tlc template, these three don't include an actual link. The mnemonics for Калып:Tlc and Калып:Tlc were invented after the fact, since the template creator used the single letters still available rather than the preferred Калып:Tlc (using <tt>) and Калып:Tlc (using "normal", non-coded text style) monikers.

Basic operation[булагын оңдоо]

Here is how these templates look. Code is to the left; actual rendering to the right:

Калып:Tlc = Калып:Tlc
Калып:Tlc = {{name|parameters}}
Калып:Tlc = {{name|parameters}}

Use with editprotected templates[булагын оңдоо]

Most Wikipedia users and even editors will have little or no need for use (or knowledge) of these templates. You will find them of more use if you are a writer or documenter of templates. However, editors may be pointed here when attempting to deal with edit requests on pages which have been protected in some way.

Pages which have been protected can't be edited by every user, but would-be editors can request specific changes on the corresponding Discussion page. An editor requesting a change to a semi-protected page, for example, would add the {{editsemiprotected}} template, followed by their request, to the Talk page. The Калып:Tlc template expands to a texty notice which includes the instruction "Replace the Калып:Tlc template with Калып:Tlc when the request has been accepted or rejected." An empowered editor acting on the request would then change the template per this instruction.

The desired effect is to replace the Калып:Tlc template (with its big, eye-catching box of information) by the name of the template, merely showing that the template had been there, and acted upon. The use of the Калып:Tlc template means that the template should appear in a normal, proportional font-face, as in "{{editsemiprotected}}".

Documentation[булагын оңдоо]

Functional details[булагын оңдоо]

  • This template takes another template-name and some associated pipe-tricked (numbered) parameters (or 'pass parameters'), and displays them as an 'example demonstration' of how the template-name template could be coded, literally. Its primary use is in instruction and documentation.
  • Specifics here???
  • Features of Калып:Tlc, Калып:Tlc and Калып:Tlc:
    • They show a template name and up to eight parameters.
    • They also show empty parameters. (See examples hereafter.)
    • They prevent line wraps in their output.

Usage[булагын оңдоо]

Калып:TlcКалып:Tlc

Калып:Tlc{{Template|first_parameter|second|third|fourth|fifth|sixth|seventh|eighth}}

Калып:Tlc{{Template|first_parameter|second|third|fourth|fifth|sixth|seventh|eighth}}

Examples[булагын оңдоо]

Note: Wikitables make the <code></code> tags transparent, unfortunately, so the "code colouring" is missing in these examples.

CodeResultComment
Калып:Tlc Калып:Tlc Shows its own syntax.
Калып:Tlc Калып:Tlc
Калып:Tlc Калып:Tlc
Калып:Tlc Калып:Tlc
{{tlc|name|a|b|c|d|e|f|g|h|i|j}} Калып:Tlc Shows up to eight parameters. The rest are dropped.
Калып:Tlc Калып:Tlc Also shows empty parameters.
Калып:Tlc Калып:Tlc Even shows empty parameters that come in the end.
Калып:Tlc Калып:Tlc The use of equal signs is a problem, but there is a fix; see next row.
Калып:Tlc Калып:Tlc Use {{=}} in place of an equal sign, so that it gets rendered properly.
Калып:Tlc Калып:Tlc Nested template calls also cause problems ...
{{tlc|name|{{tlf|IPA|/tʃ/}}|two}} Калып:Tlc ... but there are ways to get around this issue, also.
{{tlc|name|{{((}}IPA{{!}}/tʃ/{{))}}|two}} Калып:Tlc ... another way to do the same thing, using {{((}}, {{!}} and {{))}} to insert literal {{, | and }}, respectively.

An alternative to using constructs such as {{=}} and {{tlf|...}} to prevent characters from getting interpreted syntactically is to use <code><nowiki>...</nowiki></code>, which will prevent all characters from being interpreted. For example, in place of

{{tlc|name|one{{=}}{{tlf|IPA|/tʃ/}}|two}}

you can use

<code><nowiki>{{name|one={{IPA|/tʃ/}}|two}}</nowiki></code>

Both render as

{{name|one={{IPA|/tʃ/}}|two}}

If a vertical display with parameters on their own lines is desired, this can also be laid out manually in this manner, or more rapidly done with <pre>...</pre>.

Here are the codes to emulate Калып:Tlc, Калып:Tlc and Калып:Tlc using <nowiki>:

Using templates: Using <nowiki>: Rendered result:
{{tlf|name|one{{=}}a|two{{=}}b}} <nowiki>{{name|one=a|two=b}}</nowiki> {{name|one=a|two=b}}
{{tld|name|one{{=}}a|two{{=}}b}} <code><nowiki>{{name|one=a|two=b}}</nowiki></code> {{name|one=a|two=b}}
{{tlc|name|one{{=}}a|two{{=}}b}} <code><nowiki>{{name|one=a|two=b}}</nowiki></code> {{name|one=a|two=b}}

See also[булагын оңдоо]

Калып:Template-linking templates