Snið:Prufudæmi

Upplýsingaskjölun sniðsskoðabreytasagahreinsa

Nánari upplýsingar eru á Ensku síðunni: Template:Test case

Til að sjá prufudæmin í notkun, skoðið þá prufudæmin

Þetta sniðmát býr til tvö eða fleirri prufudæmi fyrir snið (enska: template). Hvert og eitt prufudæmi nota sömu breyturnar, og hægt er að birta hvert dæmi fyrri sig á mismunandi hátt. Sjálfgefin notkun á þessu er til þess að bera saman snið við sandkassaútgáfur í prufum.

Allar breytur sem notaðar eru í þessu sniði fara í gegnum prufudæma snið, fyrir utan breytur sem byrja með lágstriki („_“), sem eru frátekin fyrir innri notkun. Aðrar breytur eru áframsendar inn í sniðið sem verið er að prófa.

Ef engin snið eru tiltekin sérstaklega, þá notar skriftan grunnsíðuna á núverandi síðu sem fyrsta sniðið, og sandkassa undirsíðan sem seinna sniðið. Ef einungis eitt snið er tilgreint, þá verður sandkassa undirsíðan notuð sem seinna sniðið. Sandkassar á sniðum eru tilraunarútgáfur af því sniði, en ekki tilraunir að nota sniðið. Svo það er t.d. notað til að þróa nýja útgáfu af tilteknu sniði án þess að brjóta núverandi snið.

Notkun

Almenn notkun

Eftirfarandi valkostir virka allar gerðir af prufudæmum.

{{Prufudæmi
| _format      =
| _output      =
| _collapsible =
| _resetRefs   =
| _code        =
| _showcode    =

| _template  =
| _template1 =
| _heading1  =
| _template2 =
| _heading2  =
| _template3 =
| _heading3  =
...

| [breyta1] = [gildi1]
| [breyta2] = [gildi2]
| [breyta3] = [gildi3]
...
}}

Samfellanleg prufudæmi

Ef _collapsible er stillt á „y“ eða „yes“, þá er hægt að fella saman dæmin. Hér er listi af aukalegum breytum fyrir samfellanleg prufudæmi:

Breytur sem virka bara með samfellanlegum sýnidæmum

Breyta	Lýsing
_title	Notið _title til að birta valkvæman titil fyrir samfellanlegu prufudæmin
_titlecode	Notið _titlecode=yes til að birta sniðkóðann sem titil samfellanlega prufudæmisins
_notcollapsed	Ef stillt á y eða yes, þá eru samfellanlegu prufudæmin opin þegar síðan hleður. Ef stillt á n eða no, þá eru prufudæmin felld saman þegar síðan hleður. Þetta yfirskrifar sjálfgefna virkni í sýnidæmunum sem eru samanfelldar nema tvö eða fleirri úttök eru ólík.

Sniðmátsgögn

Þetta snið setur upp 2 eða fleirri prufudæmi, það er hægt að bæta ótal mörgum (ekki bara þau 3 sem eru í sniðmátsgögnunum), bætið bara hærri tölum því fleirri dæmi eru.

Sniðmátsbreytur[Breyta sniðmátsgögnum]

Breyta		Lýsing	Gerð	Staða
Uppsetning	_format	Uppsetningin sem er notuð til að birta prufudæmin. Þetta geta verið „dálkar“, „raðir“ eða „tablerows“ (dálkar og raðir) Tillögur um gildi tablerows columns rows	Innihald	valfrjáls
Nowiki úttak	_output	Leyfir breytingar á hvernig úttak sniðmáts birtist. Sjálfgefið úttak er birt þegar _output breytan er ekki tilgreind eða þegar hún er stillt á eitthvað ógilt gildi. Nowiki útgáfa af úttaki sniðsins er birt þegar gildi breytunnar er _output=nowiki; þetta er gagnlegt þegar það er munur á undirlyggjandi wikitexta sem er ekki sýnilegur í venjulegru úttaki. Bæði sjálfgefið úttak og nowiki útgáfur eru birtar þegar _output=nowiki+ er notað. Tillögur um gildi nowiki nowiki+	Innihald	valfrjáls
Samfellanlegt	_collapsible	Ef stillt á „y“ eða „yes“, þá er hægt að fella saman prufudæmið, þ.e.a.s. fela það. Prufudæmið er felanlegt og fær græna fyrirsögn ef öll úttök sniðsins eru þau sömu. Ef eitthvað af úttökum sniðs eru öðruvísi, þá er sýnilegt með gulri fyrisögn. Tillögur um gildi y yes	Innihald	valfrjáls
Sýna sniðkóða	_showcode	Birta sniðkóðann sem var notaður til að framkalla prufudæmið. Ef köllunaraðferð er tilgreind með _code breytunni, þá er það notað. Annars er nálgun framkallað útfrá gefnu viðfangi. Þessi nálgun er ekki fullkomin - allir bilstafir í gefnum viðföngum tapast, og afrituð viðföng eru hunsuð - en það ætti að vera í góðu lagi fyrir sniðkóða sem er allur á einni línu án eyðna á milli breytna.	Strengur	valfrjáls
Texti á undan úttaki sýnidæma	_before	Valkvæmur texti sem birtist á undan úttaki á hverju sniði fyrir sig.	Strengur	valfrjáls
Texti á eftir úttaki sýnidæma	_after	Valkvæmur texti sem birtist á eftir úttaki á hverju sniði fyrir sig.	Óþekkt	valfrjáls
Birta fyrirsagnir	_showheader	Ef þetta er stillt á „n“ eða „no“, þá eru engar fyrirsagnir birtar. Tillögur um gildi n no	Innihald	valfrjáls
Endurstilla fyrirmyndir	_resetRefs	Ef stillt á „y“ eða „yes“, þá endurstillast allar fyrirmyndir notaðar af sniðinu í hvert sinn sem sniðið er birt (t.d. ef það var falið). Tillögur um gildi y yes	Innihald	valfrjáls
Kóði	_code	Notað til að tilgreina sniðkóða innan nowiki merkja. Þetta er notað með _showcase valkostinum til að birta sniðs tilköllunina með upphaflegu bilstöfunum. Þú verður að nota töfraorðið __TEMPLATENAME__ í staðinn fyrir nafn sniðsins. T.d.: _code = <nowiki>{{__TEMPLATENAME__|first|second|foo=bar}}</nowiki>. Ef þú endar á því að nota þennan valkost oft, þá vilt þú kannski athuga {{prufudæmi nowiki}} í staðinn, það leyfir þér að framkall heilu prufudæmin af sniðkóða í nowiki merkjum, sem sparar þér heilmikinn tíma frá því að þurfa skrifa öll viðföngin tvisvar. ATH: vegna þess hvernig nowiki merki virka, þá meðhöndlar sniðin HTML eigindin &lt;, &gt; og &quot; eins og það séu bókstaflega <, > og " þegar það er notað með þessari breytu.	Strengur	valfrjáls
Snið1	_template1 _template	Nöfn sniðanna sem unnið er með. Sjálfgefið gildi _template1 er grunnsíðan á þáverandi síðu. Ef _template1 er tilgreint, þá er sjálfgefið gildi fyrir _template2 verður þá /sandkassi undirsíðan; Ef ekki, þá er sjálfgefið gildi fyrir _template2 undirsíðan /sandkassi grunnsíðu þáverandi síðu. Nöfn á sniðum þurfa að vera tilgreind á sama hátt og þú notar þau þegar kallað er á sniðið í venjulegum aðstæðum, t.d. „3x“, en ekki „Snið:3x“. Ef þú þarft að prófa síðu í aðalnafnrými þá getur þú notað tvípunkt forskeytið, t.d. „:nafn greinar“.	Strengur	nauðsynleg
Snið2	_template2	Sjá lýsingu á Snið1 Sjálfgefið Birtir snið frá /sandkassi viðkomandi sniðs	Strengur	valfrjáls
Snið3	_template3	Sjá lýsingu á Snið1	Strengur	valfrjáls
Úttak1	_showtemplate1	Ef þetta er stillt á „no“, þá verður ekkert úttak birt fyrir það snið. Þetta er ganglegt þegar þú vilt sýna aðal sniðið, eða ef þú vilt bara sýna sandkassa sniðið. Tillögur um gildi no	Innihald	valfrjáls
Úttak2	_showtemplate2	Sjá lýsingu á Úttak1	Innihald	valfrjáls
Úttak3	_showtemplate3	Sjá lýsingu á Úttak1	Innihald	valfrjáls
Fyrirsögn1	_heading1	Valkvæm fyrirsögn fyrir prufudæmið	Strengur	valfrjáls
Fyrirsögn2	_heading2	Valkvæm fyrirsögn fyrir prufudæmið	Strengur	valfrjáls
Fyrirsögn3	_heading3	Valkvæm fyrirsögn fyrir prufudæmið	Strengur	valfrjáls

Tæknilegar takmarkanir

• Það mun upp villa ef öll síðan tekur lengur en 10 sekúndur að hlaða. Þetta eru takmörk sem Scribunto viðbótin setur af ásettu ráði. Ef prufudæmi taka meira en 10 sekúndur að hlaða þá þarftu líklegast að brjóta þau niður í mismunandi síður.
• Þegar verið er að nota sniðkallanir inn í nowiki merkjum með _code= breytunni, þá umbreytir það HTML eigindum eins og <, > and " sjálfkrafa í <, > and ". Þetta er tengt því hvernig nowiki merkingar virka.

Tengt efni

• Snið:Sýnidæmi - sýnir kóðann og sýnidæmi hvað kóðinn framkallar

Fleirri gerðir af prufudæmum

• Snið:Prufudæmi - prufdæmið sem getur allt hér fyrir neðan
• Snið:Prufudæmi raðir - fyrir töflur af sýnidæmum í röðum
• Snið:Prufudæmi tafla - fyrir töflu af sýnidæmum í dálkum
• Snið:Prufudæmi nowiki - fyrir sýnidæmi af sniðum þar sem sniðkallið er inn í nowiki merkjum
• Snið:Prufudæmi inline - fyrir sýnidæmi með litla sniðköllun og lítið úttak
• Snið:Prufudæmi samfellanlegt - fyrir samfellanleg sýnidæmi ef niðurstöður eru þær sömu
• Snið:Prufudæmi samfellanlegt 2
• Snið:Prufudæmi nowiki demo - fyrir notkun í sniðmátsupplýsingum

Upplýsingarnar hér fyrir ofan eru innleiddar frá Snið:Prufudæmi/doc. (breyta | saga)
Notendur geta prófað sig áfram í sandkassa (breyta | samanburður) og prufudæmi (breyta) sniðsins.
Bættu við flokkum á /doc undirsíðunni. Undirssíður sniðsins.