Mall:Tlc/dok

Den här sidan ger den fullständiga dokumentationen för {{tlc}}, {{tld}}, {{tlf}}.

Syfte och namngivning

När ett mallnamn med klammerparenteser ska visas i dokumentation, måste dessa fly på något sätt så att det inte blir en faktisk anrop till mallen. Istället för att använda <nowiki></nowiki>-taggar kan du skriva det mer enkelt och kortfattat med hjälp av {{tlc}}, {{tld}} eller {{tlf}}-mallarna.

Dessa mallar fungerar på liknande sätt som {{tl}} och {{tlx}} men gör inte mallnamnet till en länk. När du skriver dokumentation kanske du vill undvika en massa onödiga länkar, eftersom de kan minska läsbarheten. Så på den första förekomsten av ett mallnamn, använd {{tl}} eller {{tlx}} och använd sen {{tlc}}, {{tld}} eller {{tlf}} därefter.

Mall	Mnemoteknik	Formatdifferentiering
{{tlc}}	Template link code	Använder <code>...</code>-taggar avsedda för visande av programmeringskod. Väsentligen den ickelänkade ekvivalenten till {{tlx}}.
{{tld}}	Template link dialup-host
{{tlf}}	Template link format-normal	Använder ett typsnitt med proportionellt radavstånd som är normalt för vanlig text i stället för en monospace-typsnitt som normalt används med programmeringskod. Väsentligen den ickelänkade ekvivalenten till {{tlp}}.

De tre namnen var baserade på {{tl}} template link, trots det faktum att, till skillnad från den faktiska {{tl}}-mallen, inkluderar dessa tre inte en faktisk länk. De mnemotekniska {{tld}} och {{tlf}} uppfanns eftersom mallskaparen använde de enskilda bokstäverna som fortfarande finns tillgängliga snarare än den föredragna {{tlt}} (med användning av <tt>) och {{tln}} (med användning av "normala", icke-kodade textstil) monikers.

Grundläggande användning

Här är hur dessa mallar ser ut. Koden är till vänster; faktisk rendering till höger:

{{tlc|namn|parametrar}} = {{namn|parametrar}}

{{tld|namn|parametrar}} = {{namn|parametrar}}

{{tlf|namn|parametrar}} = {{namn|parametrar}}

Dokumentation

Funktionella detaljer

• Denna mall tar ett annan mallnamn och vissa tillhörande pipe-tricked (numrerade) parametrar (eller 'pass parameters'), och visar dem som en 'exempeldemonstration' av hur mallnamn-mallen kan kodas. Den används främst i instruktion och dokumentation.
• Specifikation här???
• Egenskaper för {{tlc}}, {{tld}} och {{tlf}}:
  • De visar ett mallnamn och upp till åtta parametrar.
  • De visar också tomma parametrar. (Se exempel nedan.)
  • De förhindrar radbrytning i deras output.

Användning

{{Tlc|Mall|första_parametern|andra|tredje|fjärde|...|åttonde}} → {{Mall|första_parametern|andra|tredje|fjärde|femte|sjätte|sjunde|åttonde}}

{{Tld|Mall|första_parametern|andra|tredje|fjärde|...|åttonde}} → {{Mall|första_parametern|andra|tredje|fjärde|femte|sjätte|sjunde|åttonde}}

{{Tlf|Mall|första_parametern|andra|tredje|fjärde|...|åttonde}} → {{Mall|första_parametern|andra|tredje|fjärde|femte|sjätte|sjunde|åttonde}}

Exempel

Notera: Wikitabeller gör <code></code>-taggar transparenta, tyvärr, så fattas "code colouring" i dessa exempel.

Code	Result	Comment
{{tlc}}	{{[[Mall:{{{1}}}|{{{1}}}]]}}	Visar dess egen syntax.
{{tlc|namn}}	{{namn}}
{{tlc|namn|en}}	{{namn|en}}
{{tlc|namn|en|två}}	{{namn|en|två}}
{{tlc|namn|a|b|c|d|e|f|g|h|i|j}}	{{namn|a|b|c|d|e|f|g|h|i}}	Visar upp till åtta parametrar. Resten släpps.
{{tlc|namn|||tre|fyra}}	{{namn|||tre|fyra}}	Visar också tomma parametrar.
{{tlc|namn|||tre||}}	{{namn|||tre||}}	Visar även tomma parametrar som kommer i slutet.
{{tlc|namn|en=a|två=b}}	{{namn}}	Användningen av likhetstecken är ett problem, men det finns en fix; se nästa rad.
{{tlc|namn|en{{=}}a|två{{=}}b}}	{{namn|en=a|två=b}}	Använd {{=}} i stället för ett likhetstecken, så att det renderas på rätt sätt.
{{tlc|namn|{{IPA|/tʃ/}}|två}}	{{tlc|namn|/tʃ/|två}}	Inkapslad mall orsakar också problem...
{{tlc|namn|{{tlf|IPA|/tʃ/}}|två}}	{{tlc|namn|{{IPA|/tʃ/}}|två}}	...men det finns sätt att komma runt det här problemet också.
{{tlc|namn|{{((}}IPA{{!}}/tʃ/{{))}}|två}}	{{tlc|namn|{{IPA|/tʃ/}}|två}}	...ett annat sätt att göra samma sak, med hjälp av {{((}}, {{!}} och {{))}} att infoga {{, | och }}.

Ett alternativ till att använda konstruktioner såsom {{=}} och {{tlf|...}} för att förhindra tecken från att tolkas syntaktiskt är att använda <code><nowiki>...</nowiki></code>, som kommer att förhindra alla tecken från tolkas. Till exempel, i stället för

{{tlc|namn|en{{=}}{{tlf|IPA|/tʃ/}}|två}}

kan du använda

<code><nowiki>{{namn|en={{IPA|/tʃ/}}|två}}</nowiki></code>

Både renderar som

{{namn|en={{IPA|/tʃ/}}|två}}

Om en vertikal display med parametrar på sina egna linjer önskas, kan detta också anges manuellt på detta sätt, eller snabbare gjort med <pre>...</pre>.

Här är koderna för att efterlikna {{tlf}}, {{tld}} och {{tlc}} genom användning av <nowiki>:

Använda mallar:	Användning <nowiki>:	Renderat resultat:
{{tlf|namn|en{{=}}a|två{{=}}b}}	<nowiki>{{namn|en=a|två=b}}</nowiki>	{{namn|en=a|två=b}}
{{tld|namn|en{{=}}a|två{{=}}b}}	<code><nowiki>{{namn|en=a|två=b}}</nowiki></code>	{{namn|en=a|två=b}}
{{tlc|namn|en{{=}}a|två{{=}}b}}	<code><nowiki>{{namn|en=a|två=b}}</nowiki></code>	{{namn|en=a|två=b}}