Help:TemplateData/da



Hvad er TemplateData?
TemplateData er en måde at opbevare information om en skabelon og dens parametre, så VisualEditor kan hente og vise det i skabelonens editor, og dermed gøre det nemmere at redigere skabeloner.

TemplateData giver brugerne mulighed for at skrive små bidder struktureret data på en skabelonside, eller på en side som skal trækkes ind og vises på en skabelonside (som på en dokumentationsside). Når en skabelon har disse strukturerede data, vises det korrekt i VisualEditor. Selvom det kan lyde kompliceret, er det faktisk meget nemt.



TemplateData-struktur
TemplateData strukturen er bygget op omkring JSON-standarden, og er forholdsvis enkel. Bemærk at alle beskrivelser i TemplateData skal være i almindelig tekst (ingen wikitekst, ingen links, etc.).

Det første der skal gøres, er at skrive et par  tags, hvor som helst på skabelonens dokumentation underside, som her:

Dette fortæller softwaren, at alt mellem de to mærker er TemplateData og skal refereres, når skabelonen anvendes.



Eksempel
Beskrivelserne i TemplateData følger et standard layout, så lad os sige at du har en skabelon kaldet "Commons" der skal linke til en Commons kategori om et emne. Det kræver en obligatorisk parameter: navnet på den pågældende Commons-kategori. TemplateData får da dette udseende:

Det vil i skabelonen blive vist sådan: {       "description": "En skabelon for at linke til en commons kategori om en artikel", "params": { "1": {                       "label": "Commons kategori", "description": "Commons kategorien du vil linke til.", "default": "Category:CommonsRoot", "type": "string", "required": true }       } }



Beskrivelse og parametre
Når man er færdig, så klik "Gem side". Hvis man har gjort noget galt, så får man ikke lov at gemme (hvilket er irriterende, men betyder at man ikke ødelægger noget). Skulle man komme ud for fejl, så forklar på feedback-siden, hvad du prøvede at gøre. Så vil vi med glæde hjælpe dig.

Vær opmærksom på, at hver delinformation er indesluttet i anførselstegn (undtagen for  og  ), og adskilt fra næste del med et komma (undtagen for den sidste del).



Aliasser for parametre
Nogle skabeloner tillader, at samme parameter har flere navne.

For eksempel kunne  også skrives som   eller.

For at føje denne information til TemplateData, så behøver man blot at tilføje aliasserne til parameterens information:



Flere parametre
Hvis der findes flere parametre, så opret blot tilsvarende afsnit for de andre parametre. Bemærk at når en skabelon har flere parametre, så er det nødvendigt at adskille dem med komma på denne måde:



Næsten identiske parametre
Når en skabelon har flere parametre, kan nogle af dem undertiden være af samme slags. I det tilfælde er det kun nødvendigt at angive fuld information for den første parameter, de andre kan "arve" deres information fra den første ved hjælp af ordet "inherits".



Tom tekstskabelon
Man kan kopiere den tomme tekstskabelon nedenfor for at føje ny TemplateData til en skabelon. Kun de mest almindelige tags (mærker) er medtaget.



Begrænsninger og spørgsmål

 * Manglende funktioner — TemplateData er et eksempel på et værktøj som er gjort tilgængeligt med kun få funktioner i det håb, at brugerne ville hjælpe med ideer til nye, ønskede funktioner. Hvis man efterspørger nye funktioner for TemplateData, så kontakt os venligst.
 * Forsinkelse i visning — Efter at have tilføjet TemplateData til en skabelon, så skulle metadata blive synlige med det samme, når skabelonen åbnes i VisualEditor. Dog kan det ske, at det tager timer, inden metadata vises. Man kan fremtvinge en opdatering ved at lave en "nul-redigering" af skabelonen (ikke dokumentationssiden). For at udføre en nul-redigering, så åbn skabelonen for redigering og gem straks siden igen uden at foretage nogen ændinger.
 * Nuværende problemer — En liste over øjeblikkelige fejl og ønskede funktioner er tilgængelig hos bugzilla.



Værktøjer

 * TemplateDataEditor — Et personligt JavaScript, der gør det nemmere at tilføje TemplateData. Det findes i øjeblikket på fransk (indeholder engelsk, italiensk, japansk og koreansk oversættelse), og kan nemt oversættes til andre sprog.
 * TemplateData Wizard — Et værktøj der danner TemplateData ved hjælp af en interaktiv brugerflade.
 * Skeleton TemplateData generator — Et værktøj der læser kildekoden for en skabelon og dernæst forsøger at finde alle parametre for at danne et dokument, hvor alle parametre er oplistet.
 * JSONLint — Et værktøj der muliggør en validering af et manuelt skrevet JSON med hensyn til syntaks-fejl.