Modul:grammar-table/dok
Syfte
Modulens syfte är att generera wikitabellkod som ska användas som byggstenar i grammatiktabeller. Med hjälp av modulen kan grammatikmoduler skapa grammatiktabeller på ett mer läsbart och överskådligt sätt.
Användning
- Den här modulen bör bara användas av grammatikmoduler, inte av mallar eller andra moduler.
local gt = require("Modul:grammar-table")
local lang_code = "sv"
local part_of_speech = "adj"
local number_of_columns = 3
local has_warning = "false"
local str = gt.getStart(number_of_columns, lang_code, part_of_speech, has_warning)
.. gt.getRow({"!", "Rubrik"}, "böjningsform")
.. gt.getRow({"!", "Rubrik"}, "böjningsform")
.. gt.getEnd(number_of_columns, "Kommentar", "förled")
Specifikation
- getStart
- Denna funktion används för att skapa den övre delen av grammatiktabellen.
- getRow
- Denna funktion används för att skapa en tabellrad. Den tar ett löpande antal icke namngivna argument.
- 1=, 2=, 3=, osv. Ett argument bestående av {"cellmeta", "cellinnehåll", type="css-klass"} alternativt "cellinnehåll" för varje cell.
- 1= (obligatorisk) "cellmeta": typiskt ! eller |, eventuellt följt av class, rowspan och/eller colspan i wikisyntax:
!,|,|class="min",|rowspan="2",|class="min" colspan="3"- På Wiktionary:Stilguide/Grammatik/Skapa en mall finns en mer ingående beskrivning av grammatiktabellens delar, layout och css-klasser.
- 2= "cellinnehåll": Detta är själva textinnehållet i rutan, vanligtvis rubriknamnet eller böjningsformen.
- Parametern kan utelämnas helt och får då " " som defaultvärde. Utan " " skulle tabellrutan bli helt tom och försvinna eftersom den skulle sakna innehåll.
- type= länktyp som används för att ange en css-klass i en omgivande span-tagg runt länken:
<span class="infl">]</span> - Om ingen länk finns, skapas heller ingen span-tagg.
- infl är defaultvärdet och används normalt för alla rutor med böjningsformer. För defaultvärdet kan parametern helt utelämnas.
- no-link Det normala är att orden länkas automatiskt, om det är möjligt. Med värdet "no-link" undertrycks länkningen.
- link-only Det normala är att texten både länkas och omsluts med en span-tagg. Med värdet "link-only" skapas länken som vanligt, men span-taggen undertrycks.
- adv, perfpart, prespart och eventuellt andra värden används likt "infl" som klassnamn och kan användas av css och javascript för annan funktionalitet.
- Rubrikrutor påverkas inte av type-parametern och länkas därför inte heller automatiskt. Om en rubrikruta avses länkas, bör länkklamrar skickas med i cellinnehållet.
- Om strängvarianten används så ges 1= defaultvärdet "|" och type= ges defaultvärdet "infl". Detta är det normala för alla böjningsformer som endast fyller en enstaka cell.
- getEnd
- Denna funktion används för att skapa den undre delen av grammatiktabellen.
Tester
20 tests failed. (refresh)
| Text | Expected | Actual | |
|---|---|---|---|
 |
mut.getRow({"!", "rubrik", '|rowspan="2"'}, "form1", "form2", "form3") | |-
!|rubrik |rowspan="2"|<span class="infl">]</span> ||<span class="infl">]</span> ||<span class="infl">]</span> || |- !|rubrik |rowspan="2"|<span data-grammar-link="infl">]</span> ||<span data-grammar-link="infl">]</span> ||<span data-grammar-link="infl">]</span> | |
|
mut.getRow({"|", "], ]", type="adv"}, "], ]") | |-
||<span class="adv">]</span>, <span class="adv">]</span> ||<span class="infl">]</span>, <span class="infl">]</span> || |- ||<span data-grammar-link="adv">]</span>, <span data-grammar-link="adv">]</span> ||<span data-grammar-link="infl">]</span>, <span data-grammar-link="infl">]</span> | |
|
mut.getRow("form1, form2") | |-
||<span class="infl">]</span>, <span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span>, <span data-grammar-link="infl">]</span> |
| Text | Expected | Actual | |
|---|---|---|---|
|
mut.getRow("form1", "form2", "form3") | |-
||<span class="infl">]</span> ||<span class="infl">]</span> ||<span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span> ||<span data-grammar-link="infl">]</span> ||<span data-grammar-link="infl">]</span> |
| Text | Expected | Actual | |
|---|---|---|---|
 |
mut.getRow({"!"}, {"|rowspan=2"}, {'|class="min"'}) | |-
!| |rowspan="2"| ] |class="min"| ] || |- !| |rowspan="2"| ] |class="min"| ] |
| Text | Expected | Actual | |
|---|---|---|---|
|
mut.getRow({"!", type="no-link"}, {'|rowspan="2"', type="no-link"}) | |-
!| |rowspan="2"| ] || |- !| |rowspan="2"| ] |
| Text | Expected | Actual | |
|---|---|---|---|
|
mut.getRow("], form2") | |-
||<span class="infl">]</span>, <span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span>, <span data-grammar-link="infl">]</span> | |
|
mut.getRow("]<sup>1</sup>") | |-
||<span class="infl">]</span><sup>1</sup> || |- ||<span data-grammar-link="infl">]</span><sup>1</sup> | |
|
mut.getRow("], vard. ]") | |-
||<span class="infl">]</span>, vard. <span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span>, vard. <span data-grammar-link="infl">]</span> | |
|
mut.getRow("(])") | |-
||'''('''<span class="infl">]</span>''')''' || |- ||'''('''<span data-grammar-link="infl">]</span>''')''' | |
|
mut.getRow("]") | |-
||<span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span> | |
|
mut.getRow("<nowiki/>form1, form2") Med nowiki i modul |
|-
||<nowiki/>form1, <span class="infl">]</span> || |- ||<nowiki/>form1, <span data-grammar-link="infl">]</span> | |
|
mut.getRow("<nowiki/>form1, form2") Med nowiki i mall |
|-
||"`UNIQ--nowiki-00000001-QINU`"'form1, <span class="infl">]</span> || |- ||"`UNIQ--nowiki-00000001-QINU`"'form1, <span data-grammar-link="infl">]</span> |
| Text | Expected | Actual | |
|---|---|---|---|
|
mut.getRow("ord1 ord2") | |-
||ord1 ord2 || |- ||ord1 ord2 |
| Text | Expected | Actual | |
|---|---|---|---|
|
mut.getRow(nil) | |- | |- |
|
mut.getRow("") | |-
|| ] || |- || ] | |
|
mut.getRow("-") | |-
||– || |- ||– | |
|
mut.getRow("?") | |-
||? || |- ||? | |
|
", type="no-link"})) | |-
|| ] || |- || ] | |
|
", "", type="no-link"})) | |-
|| ] || |- || ] | |
|
", "-", type="no-link"})) | |-
||– || |- ||– | |
|
", "?", type="no-link"})) | |-
||? || |- ||? |
| Text | Expected | Actual | |
|---|---|---|---|
|
mut.getRow("e-post") | |-
||<span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span> | |
|
mut.getRow("word's") | |-
||<span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span> | |
|
mut.getRow("words'") | |-
||<span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span> | |
|
mut.getRow("tv:n") | |-
||<span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span> | |
|
mut.getRow("]") | |-
||<span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span> | |
|
mut.getRow("'']''") | |-
||''<span class="infl">]</span>'' || |- ||''<span data-grammar-link="infl">]</span>'' |
| Text | Expected | Actual | |
|---|---|---|---|
|
mut.setLanguage("de") | (nil) | (nil) |
|
mut.getRow({"!", "rubrik", '|rowspan="2"'}, "form1", "form2", "form3") | |-
!|rubrik |rowspan="2"|<span class="infl">]</span> ||<span class="infl">]</span> ||<span class="infl">]</span> || |- !|rubrik |rowspan="2"|<span data-grammar-link="infl">]</span> ||<span data-grammar-link="infl">]</span> ||<span data-grammar-link="infl">]</span> | |
|
mut.getRow({"|", "], ]", type="adv"}, "], ]") | |-
||<span class="adv">]</span>, <span class="adv">]</span> ||<span class="infl">]</span>, <span class="infl">]</span> || |- ||<span data-grammar-link="adv">]</span>, <span data-grammar-link="adv">]</span> ||<span data-grammar-link="infl">]</span>, <span data-grammar-link="infl">]</span> | |
|
mut.getRow("form1, form2") | |-
||<span class="infl">]</span>, <span class="infl">]</span> || |- ||<span data-grammar-link="infl">]</span>, <span data-grammar-link="infl">]</span> |