Βοήθεια:TemplateData
 |
Σημείωση: Όταν επεξεργάζεστε αυτή τη σελίδα, συμφωνείτε να απελευθερώσετε τη συνεισφορά σας υπό την CC0. Δείτε τις Σελίδες Βοήθειας για το Κοινό Κτήμα για περισσότερες πληροφορίες. | |
Το TemplateData είναι μια επέκταση που αποθηκεύει πληροφορίες και παραμέτρους που σχετίζονται με ένα πρότυπο wikitext και το καθιστά διαθέσιμο σε μια διεπαφή επεξεργασίας που μπορεί να το ανακτήσει και να το παρουσιάσει σε ένα πρόγραμμα επεξεργασίας προτύπων -- όλα αυτά βοηθούν τους χρήστες να προσθέτουν και να επεξεργάζονται πρότυπα σε σελίδες.
Από τον Απρίλιο του 2019, η λειτουργία δεδομένων πρότυπου αποτελεί μέρος της προεπιλεγμένης εμπειρίας χρήστη για όλους τους χρήστες σε όλα τα wiki του Wikimedia όταν προσθέτουν πρότυπο, ακόμη και μη εγγεγραμμένους χρήστες. Τόσο η προεπιλεγμένη πηγή όσο και οι οπτικοί επεξεργαστές το ενσωματώνουν με κάποιο τρόπο, όπως και πολλά scripts, εργαλεία και gadget. Αν θέλετε αυτή τη λειτουργία στο δικό σας wiki, εγκαταστήστε το Extension:TemplateData.
Η προσθήκη δεδομένων προτύπου σε ένα πρότυπο για χρήση αυτής της επέκτασης περιλαμβάνει την εισαγωγή ενός μικρού, απλού μπλοκ JSON(εξηγείται παρακάτω) στη σελίδα τεκμηρίωσης του προτύπου. Μπορείτε να το κάνετε αυτό χειροκίνητα ή με τον επεξεργαστή δεδομένων πρότυπου, μια γραφική διεπαφή χρήστη που μπορείτε να έχετε πρόσβαση στις σελίδες "Επεξεργασία"/"Επεξεργασία κώδικα" ενός πρότυπου σε wiki με εγκατεστημένη την επέκταση TemplateData. Το JSON περιέχει κατάλογο των παραμέτρων του προτύπου και πληροφορίες σχετικά με αυτές τους παράμετρους και σχετικά με το πρότυπο στο σύνολό του (βλέπε παρακάτω για λεπτομέρειες).
Τα πρότυπα που περιέχουν δεδομένα πρότυπου εμφανίζουν αυτές τις πληροφορίες στην διεπαφή χρήστη όταν ένας χρήστης προσθέτει το πρότυπο. Σε ορισμένες περιπτώσεις, θα αλλάξει τον τρόπο συμπεριφοράς του επεξεργαστή όταν το χρησιμοποιείτε για την επεξεργασία ή την εισαγωγή ενός συγκεκριμένου πρότυπου, καθιστώντας πολύ ευκολότερο για τους χρήστες να εκτελούν τα βήματα που απαιτούνται για την προσθήκη ενός συγκεκριμένου προτύπου.
Ιστορικό
Τα δεδομένα του πρότυπου αναπτύχθηκαν αρχικά στις αρχές του 2013 με το VisualEditor στο μυαλό, το οποίο ήταν στα στάδια δοκιμής στο MediaWiki εκείνη την εποχή. Ο οπτικός συντάκτης είναι η κύρια οπτική επεξεργασία διεπαφής για τις wiki του Wikimedia, και τα δεδομένα πρότυπου του επιτρέπουν να έχει μια πιο χρήσιμη διεπαφή κατά την προσθήκη προτύπων. Υποστηρίχθηκε επίσημα από τον οπτικό επεξεργαστή αμέσως. Καθώς ο οπτικός συντάκτης κυκλοφόρησε στα διάφορα μεγάλα wiki του Wikimedia ως προεπιλεγμένο χαρακτηριστικό από το 2013 έως το 2016, τα δεδομένα πρότυπου έγιναν μέρος τους επίσης.
Τον Δεκέμβριο του 2016, η διεπαφή οπτικού επεξεργαστή έγινε διαθέσιμη για επεξεργασία του κώδικα wiki ως χαρακτηριστικό beta. Αυτό ονομάστηκε το 2017 wikitext editor. Αυτό έφερε τα χαρακτηριστικά των δεδομένων του πρότυπου στην επεξεργασία κώδικα για πρώτη φορά.
Τον Μάρτιο του 2018, ο Sam Wilson ανέπτυξε το TemplateWizard, μια GUI επέκταση επεξεργασίας προτύπων για τον προεπιλεγμένο Wikimedia επεξεργαστή κώδικα, WikiEditor (αλλιώς γνωστός ως επεξεργαστής wikitext 2010), που έχει σχεδιαστεί για να διευκολύνει τη διαδικασία προσθήκης προτύπων χρησιμοποιώντας πληροφορίες από δεδομένα προτύπων. Τον Απρίλιο του 2019, το TemplateWizard έγινε προεπιλεγμένο μέρος του επεξεργαστή wikitext 2010 σε όλα τα wiki του Wikimedia. Αυτό σήμαινε ότι τα δεδομένα πρότυπου ήταν τώρα ένα προεπιλεγμένο μέρος τόσο του οπτικού συντάκτη όσο και του συντάκτη κώδικα στα wiki του Wikimedia.
Προσθήκη ή επεξεργασία δεδομένων προτύπου
Για να προσθέσετε ή να επεξεργαστείτε δεδομένα προτύπου, μεταβείτε πρώτα στη σελίδα ενός προτύπου, που βρίσκεται στο "/Template:Templatename".
Έλεγχος της τρέχουσας κατάστασης
Πριν προσθέσετε ή επεξεργαστείτε δεδομένα προτύπου, ελέγξτε εάν το πρότυπο έχει υποσελίδα τεκμηρίωσης. Στη συνέχεια, ελέγξτε εάν το πρότυπο περιέχει ήδη δεδομένα προτύπου και, εάν ναι, εάν βρίσκεται στη σελίδα προτύπου ή στην υποσελίδα τεκμηρίωσης.
Υποσελίδες τεκμηρίωσης
Υπάρχουν δύο βασικοί τρόποι με τους οποίους τα πρότυπα στα περισσότερα wiki του Wikimedia αποθηκεύουν τις σημειώσεις χρήσης τους και άλλα δεδομένα που δεν πρέπει να περιλαμβάνονται στο ίδιο το πραγματικό πρότυπο, όπως κατηγορίες στις οποίες πρέπει να περιέχεται το πρότυπο:
- Η συντριπτική πλειονότητα των προτύπων διατηρεί σημειώσεις χρήσης και άλλα δεδομένα που δεν ανήκουν στην ίδια τη σελίδα προτύπου σε μια υποσελίδα τεκμηρίωσης: "/Template:Templatename/doc". Σε σελίδες όπως αυτή, το πρότυπο {{Documentation}} ενσωματώνει όλο το περιεχόμενο της σελίδας /doc στη σελίδα προτύπου, διατηρώντας τον πηγαίο κώδικα του προτύπου πολύ πιο καθαρό.
- Σε πρότυπα με υποσελίδες τεκμηρίωσης, η επικεφαλίδα «
Τεκμηρίωση προτύπου» θα ακολουθείται από συνδέσμους όπως [προβολή], [επεξεργασία], [ιστορικό] και [εκκαθάριση].
- Σε πρότυπα με υποσελίδες τεκμηρίωσης, η επικεφαλίδα «
- Μερικές σελίδες πρότυπου έχουν διατηρήσει αυτές τις πληροφορίες στην κύρια σελίδα του πρότυπου. Μπορείτε να το εντοπίσετε σε αυτές τις σελίδες αναζητώντας μια εμφάνιση
{{Documentation|content=ανάμεσα στις ετικέτες<noinclude>.
Διαφορετικά wiki μπορεί να παρουσιάζουν όλα αυτά διαφορετικά.
Σπάνια, οι κύριες σελίδες πρότυπου μπορεί να περιέχουν ακόμα τεκμηρίωση ακόμη και όταν έχετε ελέγξει όλα τα παραπάνω.
Εδώ, ένας χρήστης θα έχει προσθέσει έναν προσαρμοσμένο τίτλο σελίδας /doc μεταξύ «{{Documentation|» και «|content=» και στη συνέχεια θα έχει προσθέσει περιεχόμενο μετά το «|content=».
Μπορείτε επίσης να αναζητήσετε μια ειδοποίηση στο κάτω μέρος της σελίδας παρόμοια με αυτήν: «Η παραπάνω τεκμηρίωση μεταφέρεται από το Template:Templatename/doc».
Πρότυπα χωρίς υποσελίδες τεκμηρίωσης
Εάν ένα πρότυπο δεν έχει υποσελίδα τεκμηρίωσης, δημιουργήστε το και μετακινήστε εκεί την τεκμηρίωση του πρότυπου (ή προσωρινή καταχώρηση για αυτή). Στη συνέχεια μπορείτε να προσθέσετε δεδομένα πρότυπου στην υποσελίδα της τεκμηρίωσης.
Δημιουργία υποσελίδας και μετακίνηση της τεκμηρίωσης
Για να δημιουργήσετε την υποσελίδα τεκμηρίωσης, κάντε κλικ στο «Επεξεργασία»/«Επεξεργασία κώδικα» στη κύρια σελίδα πρότυπου. Ψάξτε για τις ετικέτες <noinclude> και το περιεχόμενό τους (συνήθως στο κάτω μέρος).
Θα πρέπει να μοιάζει κάπως έτσι:
<noinclude>
{{Documentation|content=
== Χρήση ==
Πληροφορίες σχετικά με τη χρήση.
== Περισσότερες επικεφαλίδες παραδειγμάτων ==
Περισσότερα περιεχόμενα παραδείγματος
[[Category:Παράδειγμα κατηγορίας]]
[[Category:Παράδειγμα κατηγορίας 2]]
}}
</noinclude>
Μπορεί επίσης να διαπιστώσετε ότι ήδη περιέχει δεδομένα προτύπου. Αν ναι, θα μοιάζει κάπως έτσι:
<noinclude>
{{Documentation|content=
...
<templatedata>
{
"description": "",
"params": {
"1": {
"label": "Παράδειγμα παραμέτρου",
"description": "Παραδείγματος περιγραφής παραμέτρου",
"type": "string"
}
}
}
</templatedata>
</noinclude>
Επιλέξτε τα πάντα μετά το «|content=» και πριν το «</noinclude>» και κόψτε τα στο πρόχειρό σας ή αποθηκεύστε τα σε ένα προσωρινό έγγραφο. Διαγράψτε το «|content=» αφήνοντας μόνο τα ακόλουθα:
<noinclude>
{{Documentation}}
</noinclude>
Αποθηκεύστε τη σελίδα προτύπου.
Τώρα, για να δημιουργήσετε τη νέα υποσελίδα, δείτε τη γραμμή διευθύνσεων του προγράμματος περιήγησής σας και προσθέστε /doc στο τέλος του URL. Πατήστε ↵ Enter, και μετά επιλέξτε την επιλογή δημιουργίας μιας νέας σελίδας.
Εάν αυτό το wiki έχει ένα πρότυπο ειδοποίησης {{Documentation subpage}}, προσθέστε το στην κορυφή της νέας σελίδας. Μπορείτε επίσης να θέλετε να προσθέσετε άλλα πρότυπα, όπως ένα {{Purge button}} ή σύνδεσμο {{Purge}} (αν υποστηρίζεται από το σχετικό wiki).
Εισαγάγετε το κείμενο που κόψατε ή αποθηκεύσατε στο προηγούμενο κείμενο (κάτω από το πρότυπο ειδοποίησης, εάν υπάρχει).
Τυλίξτε οποιεσδήποτε κατηγορίες σε ετικέτες <includeonly>, ώστε να ισχύουν μόνο στην κύρια σελίδα του προτύπου:
<includeonly>
[[Category:Example category]]
[[Category:Example category 2]]
</includeonly>
Πολλές wikis έχουν ένα πρότυπο {{Sandbox other}}.
Use this template here if it's likely that the template you're editing exists in a sandbox version (located at "Template:Templatename/sandbox") in order to prevent the categories from applying to the sandbox page:
<includeonly>{{sandbox other||
[[Category:Example category]]
[[Category:Example category 2]]
}}</includeonly>
Τέλος, δημοσιεύστε τη σελίδα.
Τώρα μπορείτε να προσθέσετε και να επεξεργαστείτε τα δεδομένα προτύπου στην υποσελίδα τεκμηρίωσης χρησιμοποιώντας τις οδηγίες που περιγράφονται στο #Μέθοδοι.
Προσθήκη και επεξεργασία δεδομένων προτύπου στην κύρια σελίδα προτύπου¶
Εάν δεν μπορείτε να δημιουργήσετε τη σελίδα /doc, μπορείτε να προσθέσετε και να επεξεργαστείτε δεδομένα προτύπου στην κύρια σελίδα του προτύπου ακολουθώντας τις οδηγίες στο#Μέθοδοι.
Εάν ένα πρότυπο έχει υποσελίδα τεκμηρίωσης, ελέγξτε τόσο την κύρια σελίδα όσο και την υποσελίδα τεκμηρίωσης για την παρουσία δεδομένων προτύπου (την ετικέτα <templatedata> ακολουθούμενη από έναν πίνακα μέσα σε σγουρές αγκύλες: {}).
Εναλλακτικά, η επέκταση TemplateData μπορεί να εκτελέσει αυτό το έλεγχο για εσάς. Κάντε κλικ στο «Επεξεργασία» ή στο «Επεξεργασία κώδικα» σε οποιαδήποτε σελίδα. Εάν το πρότυπο έχει ήδη δεδομένα πρότυπου σε οποιαδήποτε σελίδα, θα δείτε μια κίτρινη ειδοποίηση στην κορυφή της σελίδας που λέει είτε:
- Σημείωση: υπάρχει ήδη ένα μπλοκ TemplateData στη σχετική σελίδα «Template:Templatename/doc».
ή
- Σημείωση: υπάρχει ήδη ένα μπλοκ TemplateData στη σχετική σελίδα «Template:Templatename».
Εάν το πρότυπο έχει δεδομένα προτύπου στην υποσελίδα τεκμηρίωσής του
Εάν το πρότυπο έχει δεδομένα πρότυπου στην υποσελίδα τεκμηρίωσής του, αυτή είναι η σελίδα που πρέπει να επεξεργαστείτε.
Μπορείτε να το κάνετε κάνοντας κλικ στο «[επεξεργασία]» που βρίσκεται μετά την επικεφαλίδα «.svg){kind=icon}
Τεκμηρίωση προτύπου» (ή παρόμοια), ή, εάν βρίσκεστε ήδη στη σελίδα /doc, κάνοντας κλικ στο «Επεξεργασία» ή «Επεξεργασία κώδικα» στο επάνω μέρος .
Ακολουθήστε τις οδηγίες στο #Μέθοδοι για να προσθέσετε ή να επεξεργαστείτε τα δεδομένα προτύπου.
Εάν το πρότυπο έχει δεδομένα προτύπου στην κύρια σελίδα του
Εάν το πρότυπο έχει δεδομένα πρότυπου στην κύρια σελίδα του, έχετε και πάλι δύο επιλογές:
- Μπορείτε είτε να τα μετακινήσετε στην υποσελίδα τεκμηρίωσής του. Αυτή είναι η προτιμώμενη επιλογή.
- Ή, μπορείτε να το επεξεργαστείτε στη κύρια σελίδα πρότυπου.
Μετακίνηση δεδομένων προτύπου στην υποσελίδα τεκμηρίωσης
Για να το κάνετε αυτό, κάντε κλικ στο «Επεξεργασία»/«Επεξεργασία κώδικα» στην κύρια σελίδα του προτύπου και αναζητήστε τις ετικέτες <templatedata> που περικλείονται μέσα σε ετικέτες <noinclude>.
Θα πρέπει να μοιάζει κάπως έτσι:
<noinclude>
{{Documentation}}
<templatedata>
{
"description": "",
"params": {
"1": {
"label": "Παράδειγμα παραμέτρου",
"description": "Παράδειγμα περιγραφής παραμέτρου",
"type": "string"
}
}
}
</templatedata>
</noinclude>
Κόψτε μόνο τις ετικέτες <templatedata> και το περιεχόμενό τους από τον κώδικα και, στη συνέχεια, αποθηκεύστε τη σελίδα.
Στη συνέχεια, επεξεργαστείτε την υποσελίδα τεκμηρίωσης κάνοντας κλικ στο «[επεξεργασία]» που βρίσκεται μετά την επικεφαλίδα « Τεκμηρίωση προτύπου» (ή παρόμοια).
Πληκτρολογήστε μια επικεφαλίδα, όπως "Δεδομένα προτύπου" και, στη συνέχεια, επικολλήστε τα δεδομένα προτύπου κάτω από αυτήν.
Τώρα μπορείτε να επεξεργαστείτε τα δεδομένα προτύπου με βάση τις οδηγίες στο #Μέθοδοι.
Επεξεργασία δεδομένων προτύπου στην κύρια σελίδα προτύπου
Εάν δεν θέλετε να μεταφέρετε τα δεδομένα του πρότυπου στη σελίδα /doc, μπορείτε να τα επεξεργαστείτε στη κύρια σελίδα του πρότυπού. Δείτε #Μέθοδοι για τον τρόπο επεξεργασίας δεδομένων προτύπου.
Εάν το πρότυπο δεν έχει ακόμη δεδομένα προτύπου αλλά έχει υποσελίδα doc
Εάν το πρότυπο δεν διαθέτει ακόμη δεδομένα του πρότυπου, θα πρέπει να το προσθέσετε στην υποσελίδα τεκμηρίωσης.
Do this by clicking the "[edit]" located after the heading " Template documentation" (or similar), or, if you are already on the /doc page, by clicking "Επεξεργασία" or "Επεξεργασία κώδικα" at the top.
Type a heading, like "Template data", then add it beneath this heading.
The section #Methods explains how to add template data.
Μέθοδοι
Μέθοδος επεξεργαστή δεδομένων προτύπου
Αυτός είναι ένας απλός τρόπος για να προσθέσετε ή να επεξεργαστείτε δεδομένα προτύπου, που συνιστάται για λιγότερο έμπειρους χρήστες.
Ο επεξεργαστής δεδομένων προτύπου είναι μια γραφική διεπαφή χρήστη για την προσθήκη και επεξεργασία δεδομένων προτύπου. Είναι μέρος της επέκτασης TemplateData, διαθέσιμη σε οποιαδήποτε σελίδα πρότυπου (ή υποσελίδα τεκμηρίωσης) με κλικ στο «Επεξεργασία»" ή «Επεξεργασία κώδικα».
Αφού κάνετε κλικ στο «Επεξεργασία» ή στο «Επεξεργασία κώδικα» θα δείτε ένα κουμπί πάνω από την περιοχή επεξεργασίας και τον τίτλο της σελίδας που λέει «Διαχείριση TemplateData».
Κάνοντας κλικ σε αυτό το κουμπί θα μεταφερθείτε στον επεξεργαστή δεδομένων προτύπου. Εάν η σελίδα που βρίσκεστε ήδη περιέχει δεδομένα προτύπου, αυτόματα θα εμφανιστεί εδώ.
Χαρακτηριστικά στο παραπάνω παράθυρο:
- Το επάνω στοιχείο επιλέγει τη γλώσσα του κειμένου της διεπαφής. Σας επιτρέπει να εισάγετε περιεχόμενο κειμένου σε πολλές γλώσσες, που εμφανίζεται στους χρήστες με βάση τις ρυθμίσεις τους στις Προτιμήσεις και όχι με βάση τη γλώσσα του wiki. διαφορετικά wiki έχουν εντελώς διαφορετικές βάσεις δεδομένων προτύπων. Εάν δεν υπάρχουν γλωσσικά δεδομένα πρότυπου, η διεπαφή θα προσφέρει μόνο τη γλώσσα του wiki στους χρήστες, αλλά οι χρήστες μπορούν να κάνουν κλικ στο «Προσθήκη γλώσσας» για να προσθέσουν περισσότερα στοιχεία. Ο κωδικός γλώσσας εμφανίζεται σε αγκύλες δίπλα στις παραμέτρους στις οποίες μπορεί να εφαρμοστεί, όπως περιγραφές και ετικέτες.
- Το επόμενο στοιχείο είναι η περιγραφή του προτύπου. Αυτή είναι η περιγραφή του προτύπου στο σύνολό του. εμφανίζεται στους χρήστες σε πολλά σημεία στους επεξεργαστές προτύπων ενώ προσθέτουν ένα πρότυπο. Αυτή #Descriptionη παράμετρος και τα αποτελέσματά της τεκμηριώνονται παρακάτω.
- Το τρίτο στοιχείο ελέγχει τη μορφοποίηση wikitext του προτύπου. Αυτή η παράμετρος καθορίζει τον τρόπο με τον οποίο θα τοποθετηθεί το wikitext όταν ο χρήστης κάνει κλικ στο «Εφαρμογή», οι δύο κύριοι τύποι είναι
"inline"(σε μία γραμμή) και"block"(σε νέες γραμμές). Αυτή η παράμετρος και τα αποτελέσματά της τεκμηριώνονται παρακάτω.
- Εάν ο χρήστης επιλέξει «Προσαρμογή», μπορεί να εισαγάγει wikitext στην περιοχή «Συμβολοσειρά προσαρμοσμένη μορφής» σύμφωνα με τους κανόνες προσαρμοσμένων μορφών που τεκμηριώνονται παρακάτω, προκειμένου να δημιουργήσει μια προσαρμοσμένη διάταξη για το πρότυπο όταν ο χρήστης κάνει κλικ στο «Εφαρμογή».
- Το τέταρτο στοιχείο ρυθμίζει τις παραμέτρους ενός πρότυπου. Εάν οι παράμετροι έχουν ήδη καθοριστεί στα δεδομένα του πρότυπου, η περιοχή αυτή τα εμφανίζει σε κατάλογο. Εάν ο πηγαίος κώδικας του προτύπου καθορίζει παραμέτρους για τους οποίους δεν υπάρχουν δεδομένα προτύπου, μπορεί να δείτε ένα κουμπί με την ετικέτα «Προσθήκη 2 συνιστώμενων παραμέτρων». Ο επεξεργαστής βγάζει αυτές τις προτάσεις από τον πηγαίο κώδικα του προτύπου αναζητώντας
{{{parametername}}}ή{{{parametername|}}}. Αν κάνετε κλικ στο «Προσθήκη 2 συνιστώμενων παραμέτρων» θα προστεθούν αυτές οι παράμετροι χρησιμοποιώντας τα ονόματά τους όπως ορίζονται στον πηγαίο κώδικα. Θα εμφανιστεί επίσης μια πράσινη σημείωση στο επάνω μέρος, για παράδειγμα, «2 νέες παράμετροι εισήχθηκαν: ονόματα παραμέτρων. - Στο κάτω μέρος του παράθυρου βλέπετε ένα κουμπί «Προσθήκη παραμέτρου». Αυτό σας επιτρέπει να προσθέσετε μια παράμετρο χειροκίνητα με ένα προσαρμοσμένο όνομα.
Συνεχίστε στο επόμενο βήμα κάνοντας κλικ σε οποιαδήποτε από τις παραμέτρους στη λίστα. Αυτό θα σας επιτρέψει να επεξεργαστείτε τις πληροφορίες της παραμέτρου.
Όλες αυτές οι δυνατότητες και τα αποτελέσματά τους περιγράφονται στην ενότητα #Μέσα στο όνομα μιας παραμέτρου
- Κάνοντας κλικ στο «Απομάκρυνση πληροφοριών παραμέτρου» θα διαγραφεί η παράμετρος και όλες οι πληροφορίες της από τα δεδομένα του προτύπου. Δεν μπορείτε να ανακτήσετε ή να αναιρέσετε αυτό στα δεδομένα προτύπου, εκτός εάν κάνετε κλικ στο «X» στη συνέχεια. Μπορείτε να αναιρέσετε τυχόν αλλαγές που έγιναν αφού κάνετε κλικ στο «Εφαρμογή» πατώντας Ctrl+Z.
- Η έξοδος από τον επεξεργαστή δεδομένων υποδείγματος μετά την πραγματοποίηση αλλαγών σας ζητεί να επιβεβαιώσετε ότι θέλετε να απορρίψετε τις αλλαγές σας.
Όταν τελειώσετε, κάντε κλικ στο «Εφαρμογή».
Αυτό θα εισαγάγει αυτόματα τα δεδομένα του πρότυπου στο κάτω μέρος της σελίδας πριν από την ετικέτα </noinclude> ή, εάν υπάρχουν ήδη, θα ενημερωθεί με τις νέες πληροφορίες χωρίς να αλλάξει τη θέση του.
Το κείμενο των δεδομένων του προτύπου θα επιλεγεί επίσης όταν κάνετε κλικ στο «Εφαρμογή».
Ο επεξεργαστής δεδομένων προτύπου δημιουργεί παράμετρο "paramOrder" στο κάτω μέρος των δεδομένων προτύπου (ή την ενημερώνει εάν ήδη υπάρχει).
Το "paramOrder" περιέχει τις τρέχουσες παραμέτρους δεδομένων προτύπου κατά την σειρά στην οποία εμφανίστηκαν από τον επεξεργαστή δεδομένων προτύπου.
Μπορείτε να αλλάξετε το "paramOrder" τραβώντας τις παραμέτρους προς τα πάνω και προς τα κάτω στον επεξεργαστή δεδομένων πρότυπου χρησιμοποιώντας τις τρεις οριζόντιες γραμμές στα αριστερά.
Το "paramOrder" και τα αποτελέσματά του τεκμηριώνονται παρακάτω.
Μετά από αυτό, κάντε κλικ στο «Αποθήκευση» για να αποθηκεύσετε την αναθεώρηση της σελίδας.
Χειροκίνητη μέθοδος
Μπορείτε επίσης να προσθέσετε ή να επεξεργαστείτε δεδομένα προτύπου χειροκίνητα.
Τα δεδομένα προτύπου γράφονται σε JSON, αλλά δεν χρειάζεται να μάθετε JSON για να μάθετε πώς να δημιουργείτε δεδομένα προτύπου.
Τα δεδομένα του πρότυπου ακολουθούν λίγους πολύ απλούς κανόνες και αποδέχεται μόνο μερικές δεκάδες πιθανές προκαθορισμένες παραμέτρους και τιμές, συνήθως ακολουθώντας τη μορφή "parameter": "value".
Χειροκίνητη προσθήκη δεδομένων προτύπου
Σημειώσεις:
- Εάν προσθέτετε δεδομένα προτύπου στην υποσελίδα τεκμηρίωσης ενός προτύπου (συνιστάται), μπορείτε να τα προσθέσετε οπουδήποτε στη σελίδα. ελέγξτε για να δείτε εάν η Βικιπαίδεια της γλώσσας σας έχει μια προτιμώμενη τοποθεσία για αυτήν. Για παράδειγμα, στην αγγλική Βικιπαίδεια, τα δεδομένα προτύπου βρίσκονται συνήθως κοντά στο κάτω μέρος της σελίδας τεκμηρίωσης. στη γερμανική Βικιπαίδεια, είναι συνήθως στην κορυφή.
- Εάν προσθέτετε δεδομένα προτύπου στην κύρια σελίδα ενός προτύπου (δεν συνιστάται, ανατρέξτε στην ενότητα #Προηγούμενοι έλεγχοι), πρέπει να φροντίσετε να τα τοποθετήσετε μέσα στις ετικέτες
<noinclude>...</noinclude>.
Κάντε κλικ στο «Επεξεργασία» ή «Επεξεργασία κώδικα» στη αντίστοιχη σελίδα, και μετά μετακινηθείτε στο σημείο της σελίδας όπου σκοπεύετε να προσθέσετε δεδομένα προτύπου και γράψτε ένα τίτλο: "Δεδομένα προτύπου".
Πολλα wiki έχουν ένα πρότυπο {{TemplateData header}} που προσθέτει μια σύντομη ειδοποίηση σχετικά με τα δεδομένα του πρότυπου. Αν το wiki σας το κάνει, προσθέστε το μετά την επικεφαλίδα.
Για να αρχίσετε να προσθέτετε δεδομένα προτύπου, πληκτρολογήστε μια ετικέτα ανοίγματος και κλεισίματος <templatedata> και ένα ζευγάρι σγουρές αγκύλες σε νέες γραμμές, με μια κενή γραμμή ανάμεσά τους:
<templatedata>
{
}
</templatedata>
Στη συνέχεια, προσθέστε μια εσοχή στην κενή γραμμή ανάμεσα στις δύο σγουρές αγκύλες και αρχίστε να προσθέτετε παραμέτρους. Μπορείτε να βρείτε λεπτομέρειες για τις παραμέτρους στο #Παράμετροι δεδομένων προτύπου. Τα περισσότερα είναι προαιρετικά. μερικά συνιστώνται ανεπιφύλακτα.
Οι παράμετροι μπορούν να είναι σε οποιαδήποτε σειρά, αλλά η παρακάτω σειρά είναι η καλύτερη που συμμορφώνεται με την τεκμηρίωση δεδομένων πρότυπου και καθιστά το περιεχόμενο πιο εύκολο στη χρήση για τους συντάκτες:
<templatedata>
{
"description": "",
"format": "",
"params": {
"parameter1": {
"aliases": ["",""]
"label": "",
"description": "",
"type": ""
}
},
"paramOrder": [
""
]
}
</templatedata>
Βεβαιωθείτε ότι οι παράμετροι, για παράδειγμα, στο αντικείμενο "params", παραμένουν μέσα σε αυτό το αντικείμενο. Αλλιώς θα ενεργοποιήσετε ένα σφάλμα «Μη αναμενόμενη ιδιότητα «propertyname».» κατά την προσπάθεια αποθήκευσης.
Παράδειγμα
Ακολουθούν μερικά παραδείγματα δεδομένων προτύπου για ένα υποθετικό πρότυπο εκκαθάρισης. Ένα τέτοιο πρότυπο θα εμφανίζει μια ειδοποίηση και θα τοποθετεί τη σελίδα σε μια χρονολογημένη κατηγορία με βάση τον μήνα και το έτος που εισάγεται. Η ανακοίνωση μπορεί επίσης να περιέχει ένα σύνδεσμο σε μια ενότητα συζήτησης. Τα δεδομένα του πρότυπου θα έμοιαζαν κάπως έτσι:
<templatedata>
{
"description": "Χρησιμοποιήστε αυτό το πρότυπο για να υποδείξετε ότι ένα λήμμα χρειάζεται καθαρισμό.",
"format": "inline",
"params": {
"date": {
"label": "Μήνας και έτος",
"description": "Ο μήνας και το έτος που προστέθηκε το πρότυπο",
"type": "string",
"autovalue": "{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}",
"example": "Ιανουάριος 2022",
"suggested": true
},
"reason": {
"aliases": ["1"],
"label": "Αιτία",
"description": "Η αιτία που το λήμμα χρειάζεται καθαρισμό",
"type": "string"
},
"talk": {
"aliases": ["talksection"],
"label": "Ενότητα σελίδας συζήτησης",
"description": "Το τμήμα της σελίδας συζήτησης που περιέχει σχετική συζήτηση",
"type": "string"
}
},
"paramOrder": [
"date",
"reason",
"talk"
]
}
</templatedata>
Η αντίστοιχη τεκμηρίωση δεδομένων τύπου θα εμφανίζεται ως εξής:
Χρησιμοποιήστε αυτό το πρότυπο για να υποδείξετε ότι ένα λήμμα χρειάζεται καθαρισμό.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Μήνας και έτος | date | Ο μήνας και το έτος που προστέθηκε το πρότυπο
| String | suggested |
| Αιτία | reason 1 | Η αιτία που το λήμμα χρειάζεται καθαρισμό | String | optional |
| Ενότητα σελίδας συζήτησης | talk talksection | Το τμήμα της σελίδας συζήτησης που περιέχει σχετική συζήτηση | String | optional |
Παράμετροι δεδομένων προτύπου
Όλες οι διαθέσιμες παραμέτροι δεδομένων πρότυπου (δηλαδή εκείνες μεταξύ των ετικετών <templatedata>...</templatedata> του κώδικα wiki) παρατίθενται παρακάτω με περιγραφή και παράδειγμα.
Αναφέρονται επίσης με περισσότερες τεχνικές λεπτομέρειες στο Extension:TemplateData#Format.
- Αυτές οι πληροφορίες είναι ενημερωμένες από τον Νοέμβριο του 2021 και ενδέχεται να αλλάξουν εάν προστεθούν νέες παράμετροι ή εάν οι διεπαφές επεξεργασίας προτύπων λαμβάνουν ενημερώσεις για να υποστηρίζουν υπάρχουσες παραμέτρους ή να αντιμετωπίζουν με διαφορετικό τρόπο ορισμένες παραμέτρους.
- Ο κώδικας wiki δεν θα λειτουργεί σε περιγραφές ή ετικέτες. Είναι αυστηρά απλές συμβολοσειρές κειμένου.
- Νέες γραμμές ("
\n") στις περιγραφές, τις ετικέτες, τα παραδείγματα ή τα προεπιλογήματα δεν θα εμφανίζονται σε κανένα από τους κύριους επεξεργαστές (TemplateWizard, ο οπτικός επεξεργαστής ή ο επεξεργαστής wikitext του 2017), παρόλο που εμφανίζονται στην τεκμηρίωση δεδομένων προτύπου που δημιουργείται αυτόματα. Αντικαθίστανται από μια μηδενική συμβολοσειρά στις φόρμες εισόδου και από ένα διάστημα αλλού.
| Παράμετρος | Περιγραφή | Παράδειγμα |
|---|---|---|
| description |
Η παράμετρος Επιπτώσεις Στην σελίδα τεκμηρίωσης του πρότυπου, η περιγραφή θα εμφανίζεται σε απλό κείμενο κάτω από τον υπότιτλο «Δεδομένα προτύπου για [όνομα προτύπου]». Σε όλους τους κύριους επεξεργαστές (VisualEditor, το 2017 wikitext editor και το WikiEditor με TemplateWizard)), η περιγραφή εμφανίζεται σε δύο κύριες περιπτώσεις:
Στο οπτικό επεξεργαστή και στον επεξεργάστη wikitext του 2017, η περιγραφή μειώνεται σε περίπου 50 χαρακτήρες κάτω από κάθε πρόταση αναζήτησης, ακολουθούμενη από ένα «...», αλλά ολόκληρη η περιγραφή εμφανίζεται στο κύριο παράθυρο επεξεργαστή πρότυπου. Και τα δύο εμφανίζονται σε γκρίζο κείμενο. Στο κύριο παράθυρο επεξεργαστή πρότυπου, οι περιγραφές μεγαλύτερες από τέσσερις γραμμές (περίπου 540 χαρακτήρες) παρέχονται σε ξεχωριστή γραμμή κύλισης, και εμφανίζονται σε μαύρο κείμενο. Αν δεν προσδιορίζεται Εάν η παράμετρος περιγραφής δεν υπάρχει ή δεν καθορίζεται, το κείμενο «Χωρίς περιγραφή» θα εμφανίζεται στην τεκμηρίωση δεδομένων του προτύπου κάτω από τον υπότιτλο "Δεδομένα προτύπου για [όνομα προτύπου]". Επιπλέον:
|
"description": "Ένα πρότυπο για σύνδεση σε μια κατηγορία στο commons",
|
| format |
Η παράμετρος Η παράμετρος αυτή δεν είναι απαραίτητη, αλλά συνιστάται. The default behavior when this parameter is not provided is preserving the existing formatting for existing parameters, or inline formatting for newly added parameters and templates. Επιπτώσεις Inline: ( When inserted, the template will lay its wikitext out on a single line with no white space between elements, like so:
Block: ( When inserted, the template will distribute its parameters each on a new line, with single spaces between each element, like so: {{Foo
| bar = baz
| longparameter = quux
}}
Custom formatting: Alternatively, if the parameter is set to a custom string of wikitext, as per the rules listed at #Custom formats, the template will lay its wikitext out as per the given wikitext. |
"format": "inline"
|
| params |
The It should contain the name of each parameter followed by a set of template data sub-parameters listed in #Within a parameter's name. If there are multiple parameters, place a comma between each parameter object, but do not add one after the last curly bracket (see example). |
"params": {
"parameter1": {
... // parameter info
}, // comma here
"parameter2": {
... // parameter info
}, // and here
"parameter3": {
... // parameter info
} // but not here
}
|
| paramOrder |
The How to use Add the parameter The parameters need not be on new lines (they may be written as We recommend you place You must include every parameter mentioned in the template data; otherwise a "Δεν βρέθηκε η απαραίτητη ιδιότητα "propertyname"" error will show. If not specified Without With other parameters In the 2010 wikitext editor with TemplateWizard:
In the visual editor and the 2017 wikitext editor, |
"paramOrder": [
"date",
"reason",
"talk"
]
|
Within params
| Parameter | Description | Example |
|---|---|---|
| Όνομα παραμέτρου |
The only first-level item of the For example, in a template's source code, You may also see parameters named
Note: a user can still force the use of How to use Each of these "Όνομα παραμέτρου" objects should contain all of the information about the parameter, in the form of more template data parameters. These are listed in the following section, Within a parameter's name. |
"1": { // name of the parameter
... // information about the parameter goes here
}
|
Within the parameter's name
| Parameter | Description | Example |
|---|---|---|
| aliases |
The optional
or
This means that if the user inserts either of these parameters with a value, they will perform the same function. Literally, it translates to, "Value of parameter1. If parameter1 doesn't exist or have a value: value of parameter2." In the second case, it also means, "If parameter2 doesn't exist or have a value: no value." To insert the |
"aliases": ["1", "talk", "talksection"],
|
| inherits |
To use this parameter, type |
"params": {
"topic1": {
"label": "Topic",
"description": "A topic mentioned on this disambiguation page",
"type": "string"
},
"topic2": {
"inherits": "topic1"
},
"topic3": {
"inherits": "topic1",
"label" : "A different label"
}
}
|
| label |
The |
"label": "Month and year",
|
| description |
Here, |
"description": "The month and year that the template was inserted",
|
| type |
See the #Type parameter section. |
|
| default |
Some template parameters have a default value; the value is used unless overridden by the user.
The Effects In all main editors (the visual editor, the 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), the With other parameters In all main editors (the visual editor, the 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), if |
"default": "Category:CommonsRoot",
|
| autovalue |
A parameter can be assigned an This value can be overwritten by the user in the template editor. With other parameters In all main editors (the visual editor, the 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), |
"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}"
|
| example |
The Effects In all main editors (the visual editor, the 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), this property is displayed below the parameter description (and below the With other parameters In all main editors (the visual editor, the 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), |
"example": "January 2013",
|
| suggested values |
The parameter property
Other types (file, page, template, user, date, boolean, URL) are not currently supported because they have special functionalities in the visual editor already, such as autocomplete, which would interfere with the drop-down menu for suggested values in the visual editor. Editing template data as JSON in wikitext To add suggested values to any parameter type, add the new property "suggestedvalues" to the parameter in JSON. The “suggestedvalues” attribute must be a list of strings. Editing template data with the template data editor
Effects Once the values have been added to template data, the visual editor will display them in a combo box (a dropdown into which users can also enter a custom value) for the parameter types listed above. The user selects the desired value by clicking on it. If the list of values is long -- for example, a list of a country’s states -- the user can begin typing in the field, whereupon the list will be filtered to show only values containing the typed text. To change an entered value, the user must simply clear the field, and the full dropdown list will appear again. If the user needs a value not included in the list (for example, "message in a bottle") they can type it in manually. |
"suggestedvalues": [
"Journal",
"Book",
"Newspaper",
"Magazine"
]
|
| Status option | Description | Example |
|---|---|---|
| required |
The It determines whether filling in the given parameter is mandatory for the template. Effects This status has several effects in the visual editor and the 2017 wikitext editor:
In the WikiEditor with Extension:TemplateWizard, as in the other editors, it displays the parameter automatically when a user inserts the template, but the parameter cannot be removed using this or any editor. It also does not display "Το πεδίο απαιτείται." in the parameter description; rather, it lists the parameter on the side under "Απαιτούμενες παράμετροι". Other than this, it generally behaves the same as in the other editors, except that the prompt says that the input doesn't "match the expected format". With other parameters In the visual editor and the 2017 wikitext editor, the |
"required": true
|
| suggested |
The Use Effects In the visual editor and the 2017 wikitext editor, it causes the parameter to automatically show up when a user inserts a template. If the parameter has an autovalue set, this will also automatically be in the parameter's input box. It has no other effect and doesn't show any additional text or warnings. In the WikiEditor with TemplateWizard, it does not place the parameter in the template automatically but instead causes it to be listed on the side under "Προτεινόμενες παράμετροι". The user can then click a "+" next to the parameter to add it to the template. With other parameters The |
"suggested": true
|
| deprecated |
Finally, there is This is a status for parameters that should not be used any more but still exist for the time being. This could be because uses of the template are being moved from one set of parameters to another. Effects The effect of this parameter in the visual editor and the 2017 wikitext editor is that a grey exclamation mark shows next to the parameter's label when it is inserted, and in the parameter's information tooltip, the grey, italic text "Το πεδίο έχει καταργηθεί.deprecation reason" is shown below the parameter description. It does not affect the functionality or usability of the parameter or show any additional warnings. Despite the fact that it can take a string, as of January 2020 none of the main editors (the visual editor, the 2017 wikitext editor or the 2010 wikitext editor) display the contents of the string anywhere to users.
Inputting a string has the same effect as In the 2010 wikitext editor with TemplateWizard, setting this value as With other parameters If you set both this and If you set both this and In the 2010 wikitext editor with TemplateWizard, |
"deprecated": "Please use 'publicationDate' instead."
|
Note: if neither "required", "suggested" nor "deprecated" are set as true for a parameter, its status will show as "optional" in the template data documentation.
Once you're done, hit "Αποθήκευση". If you've made errors, it will not let you save (which is disruptive but means you can't break anything). Should you run into errors, explain on the feedback page what you were trying to do, and we will be happy to help.
Note that if you are abusing a hack template to dynamically generate template data, it cannot be checked for errors before saving.
Note that each item of information is enclosed in quotation marks (except for true and false) and separated from the next item by a comma (unless it's the last one).
Type parameter
The "type" parameter is meant to signal to a template editor the nature of a parameter's value.
In some cases, template editors have been programmed to modify the user interface for a certain parameter according to this template data value, such as to only allow the user to enter valid values that match the specified type.
This parameter does not have any functional effect on the template parameter or its value; it merely controls how template editors see and treat the parameter in editing mode.
How to use
It is used by adding the "type" parameter, followed by a colon and a space, then adding any of the values listed in the table below in quotation marks.
Example:
"type": "string",
Effects
As of February 2020, only 5 of the 13 type values have visible effects in VisualEditor and the 2017 wikitext editor, while 8 have visible effects in TemplateWizard.
The effects of certain values are likely to change as the template editors get updates to support them. One such effort for VisualEditor and the 2017 wikitext editor is tracked in the Phabricator task T55613. A similar effort to get TemplateWizard to support the boolean value is tracked in T200664.
The currently known effects are listed as follows.
| Value | Description | |
|---|---|---|
| unknown |
The Effects In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), | |
| string |
The Effects In all main editors (the visual editor, the 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), | |
| line |
The Effects
| |
| content |
The Effects
| |
| unbalanced-wikitext |
The Effects
| |
| wiki-page-name |
The Effects In all main editors (the visual editor, the 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), | |
| wiki-file-name |
The Effects
| |
| wiki-template-name |
The Effects In all main editors (the visual editor, the 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), | |
| wiki-user-name |
The Effects In all main editors (the visual editor, the 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), | |
| number |
The Effects
With other parameters
| |
| boolean |
The Effects As of February 2020, none of the main Wikimedia editors (the visual editor, the 2017 wikitext editor or the 2010 wikitext editor with TemplateWizard) make use of this value. It has no visible effects. With the | |
| date |
The Effects
With other parameters
| |
| url |
The Effects
required" setting, but it does not warn the user if they attempt to insert the template without a valid URL. It also occurs with any status setting (such as "suggested"" or "deprecated").
With other parameters
| |
Custom formats
When editing the "format" value, you create custom formats by inputting a set of wikitext symbols using some predefined rules.
{{- start of the template_- content (e.g., string, integer or parameter). This underscore serves to indicate the minimum length of a value in characters and can be repeated, like_______. If this length is not reached, it fills the remaining characters with spaces. This can be used to align all equals signs to a specific position after a parameter (if used with\nfor new lines).|- pipe (separates parameters)=- equals sign (precedes the value of a parameter)\nor pressing the enter key - new line (this will display as↵in the entry field)\nto indent new lines)}}- end of the template
The wikitext should at least meet the minimum of {{_|_=_}}, otherwise there will be an invalid format string error.
| Objective | Format string | Output |
|---|---|---|
| Inline formatting | {{_|_=_}} inline
|
{{Foo|bar=baz|longparameter=quux}}{{Bar}}
|
| Block formatting | {{_\n| _ = _\n}} block
|
{{Foo
| bar = baz
| longparameter = quux
}}{{Bar}}
|
| No space before the parameter name, each template on its own line | \n{{_\n|_ = _\n}}\n
|
{{Foo
|bar = baz
|longparameter = quux
}}
{{Bar}}
|
| Indent each parameter | {{_\n |_ = _\n}}
|
{{Foo
|bar = baz
|longparameter = quux
}}{{Bar}}
|
| Align all parameter names to a given length | {{_\n|_______________ = _\n}}\n |
{{Foo
|bar = baz
|longparameter = quux
|veryverylongparameter = bat
}}
{{Bar}}
|
| Pipe characters at the end of the previous line | {{_|\n _______________ = _}}
|
{{Foo|
bar = baz|
longparameter = quux}}{{Bar}}
|
| Inline style with more spaces, must be at start of line | \n{{_ | _ = _}}
|
{{Foo | bar = baz | longparameter = quux}}
{{Bar }}
|
| Template at the start of a line, indent-aligned parameters, pipe beforehand | \n{{_ |\n _______________ = _}}
|
{{Foo |
bar = baz |
longparameter = quux}}
{{Bar}}
|
Blank boilerplate
You can copy the blank boilerplate below to add new template data to a template. Only the most common tags are included.
<templatedata>
{
"description": "",
"params": {
"1": {
"label": "",
"description": "",
"type": ""
},
"2": {
"label": "",
"description": "",
"type": ""
}
}
}
</templatedata>
Errors
Συντακτικά λάθη στη JSON. / Bad JSON format
These errors occur when saving template data, usually manually edited, with invalid JSON code (duplicate keys/parameters, trailing or missing commas, etc.) in the visual editor or the 2017 wikitext editor.
"Συντακτικά λάθη στη JSON." appears in the visual editor and the 2017 wikitext editor; "Bad JSON format" appears when editing in the template data GUI editor.
These errors can be difficult to detect and come in too many forms to list. The best way to avoid them is to edit template data exclusively with the template data editor; the best way to detect them once they've occurred is to use an external JSON validator, such as JSONLint, which will highlight errors and aid in fixing them.
The 2010 wikitext editor does not check for invalid JSON thanks to an old, unfixed bug (task T128029). Pages that contain invalid JSON may throw alarming "Εσωτερικό σφάλμα" messages. To fix these errors, your best bet is to use a JSON validator (see above).
Δεν βρέθηκε η απαραίτητη ιδιότητα "paramOrder[number]"
This error occurs if you state a parameter in "params" that is not stated in "paramOrder".
The number in the square brackets refers to the parameter in "paramOrder" that is missing. It refers to its order in the sequence, but it is one less than its actual position, since "paramOrder" is an array; 0 is the first one, 1 is the second, etc.
"params": {
"date": { ...
},
"reason": { ...
},
"talk": { ... // <-- This parameter is not stated in "paramOrder", but it should be.
}
},
"paramOrder": [
"date",
"reason"
]
// Error: Required property "paramOrder[2]" not found.
To fix this, make sure all parameters stated in "params" are listed in "paramOrder".
Alternatively, you can remove the "paramOrder" object to remove this error.
Μη έγκυρη τιμή για την ιδιότητα "paramOrder[number]".
This error occurs if you state a parameter in "paramOrder" that is not stated in "params".
The number in the square brackets refers to the parameter in "paramOrder" that shouldn't be there. It refers to its order in the sequence, but it is one less than its actual position, since "paramOrder" is an array; 0 is the first one, 1 is the second, etc.
"params": {
"date": { ...
},
"talk": { ...
}
},
"paramOrder": [
"date",
"reason", // <-- This parameter is not stated in "params", but it should be.
"talk"
]
// Error: Invalid value for property "paramOrder[1]".
To fix this, make sure all parameters stated in "paramOrder" are listed in "params".
Alternatively, you can remove the "paramOrder" object to remove this error.
Η ιδιότητα "params.parametername.required" αναμένεται να είναι του τύπου "boolean".
"suggested": "true" // <-- These quotation marks shouldn't be here.
These are boolean values, not strings, therefore they require no quotation marks.
To fix this, remove any quotation marks around the values true or false for these parameters.
Property "format" is expected to be ...
If the "format" parameter exists but its value is not "inline", "block" or a valid format string, you will see the error message "Η ιδιότητα "format" αναμένεται να είναι "inline", "block", ή μία έγκυρη συμβολοσειρά μορφοποίησης.".
"format": "notinline"
// Error : Property "format" is expected to be "inline", "block", or a valid format string.
To fix this, make sure the value after "format": equals "inline" or "block" and that there no spelling mistakes. Alternatively, if it's wikitext, make sure it contains a minimum of {{_|_=_}} and that there are no mistakes in the syntax that would normally cause a template to fail, such as duplicate equals signs or missing/duplicate curly brackets; see the section #Custom formats for the syntax for custom formats.
Alternatively, you can remove the "format" parameter to remove this error.
Μη αναμενόμενη ιδιότητα «parametername».
This error occurs if you state a parameter that is unknown in template data. This is probably due to spelling mistakes or the use of uppercase letters instead of lowercase.
<templatedata>
{
"description": "",
"format": "inline",
"params": {
"1": {
"label": "",
"descriptino": "", // <-- spelling mistake
"type": ""
}
}
}
</templatedata>
It also occurs if you state a parameter in any template data object that is not a parameter of that object. This may be due to spelling mistakes, or you may have written the parameter of one template data object under another object that it doesn't belong to.
For example, you might have written the parameter "label" under the root template data object instead of inside "params":
<templatedata>
{
"description": "",
"format": "inline",
"label": "", // <-- incorrectly placed parameter
"params": {
"1": { // ↓ it should be in here
"description": "",
"type": ""
}
}
}
</templatedata>
Alternatively, if the unexpected parameter is under a template parameter inside "params", you'll see its name after "params.parametername." in the error.
To fix this, make sure there aren't any spelling mistakes in the parameter names, and make sure your parameters are in their correct location. Additionally, make sure you don't state any parameters that don't exist for a template data object. You can check which parameters exist for an object in the section #Template data parameters.
Δεν βρέθηκε η απαραίτητη ιδιότητα "params"
This error occurs if there is no "params" object in the template data.
This is a necessary object, as it contains all the details of each parameter, so to fix this error, make sure it's added and that there are no spelling mistakes.
See the section above on how to add the "params" parameter.
Limitations and feedback
- Missing features – Template data is an example of a tool that was made available with few features, in hope that users would help to guide development of features that they desired. If you'd like to request new features for template data, please let us know.
- Delays in showing in templates – After adding template data to a template, the metadata should be visible immediately when the template is opened in the visual editor. However, it is possible that it will take several hours before the metadata will show. You can force an update by making a null edit to the template page itself (not the documentation subpage). To perform a null edit, open the template page for editing, and save the page without making any change and without adding any edit summary.
- Current issues – A list of current bugs and feature requests is available in the Wikimedia bug tracker.
Άλλα εργαλεία
- Help:Extension:TemplateWizard
- A toolbar dialog window for entering template wikitext via an form built from template data.
- TemplateData Wizard
- A tool that generates template data through an interactive interface.
- Skeleton TemplateData generator
- A tool that reads the source wikicode of a template, tries to find all the parameters used and outputs a skeleton document with the parameters listed.
- JSONLint
- A tool that allows you to validate manually-written JSON to help find errors in the syntax.
- Κατάλογος όλων των προτύπων με TemplateData σε αυτό το wiki
- With dewiki template template data: template data is shown in a box, and the template is added to a category of templates with template data
- https://query.wikidata.org/ and Query Helper