Βοήθεια:TemplateData

Το Extension:TemplateData είναι μια επέκταση που αποθηκεύει πληροφορίες και παραμέτρους που σχετίζονται με ένα πρότυπο wikitext και το καθιστά διαθέσιμο σε μια διεπαφή επεξεργασίας που μπορεί να το ανακτήσει και να το παρουσιάσει σε ένα πρόγραμμα επεξεργασίας προτύπων -- όλα αυτά βοηθούν τους χρήστες να προσθέτουν και να επεξεργάζονται πρότυπα σε σελίδες.

Από τον Απρίλιο του 2019, η λειτουργία δεδομένων πρότυπου αποτελεί μέρος της προεπιλεγμένης εμπειρίας χρήστη για όλους τους χρήστες σε όλα τα wiki του Wikimedia όταν προσθέτουν πρότυπο, ακόμη και μη εγγεγραμμένους χρήστες. Τόσο η προεπιλεγμένη πηγή όσο και οι οπτικοί επεξεργαστές το ενσωματώνουν με κάποιο τρόπο, όπως και πολλά scripts, εργαλεία και gadget.

Η προσθήκη δεδομένων προτύπου σε ένα πρότυπο για χρήση αυτής της επέκτασης περιλαμβάνει την εισαγωγή ενός μικρού, απλού μπλοκ JSON (εξηγείται παρακάτω) στη σελίδα τεκμηρίωσης του προτύπου. Μπορείτε να το κάνετε αυτό χειροκίνητα ή με τον επεξεργαστή δεδομένων πρότυπου, μια γραφική διεπαφή χρήστη που μπορείτε να έχετε πρόσβαση στις σελίδες "Επεξεργασία"/"Επεξεργασία κώδικα" ενός πρότυπου σε wiki με εγκατεστημένη την επέκταση TemplateData. Το JSON περιέχει κατάλογο των παραμέτρων του προτύπου και πληροφορίες σχετικά με αυτές τους παράμετρους και σχετικά με το πρότυπο στο σύνολό του (βλέπε παρακάτω για λεπτομέρειες).

Τα πρότυπα που περιέχουν δεδομένα πρότυπου εμφανίζουν αυτές τις πληροφορίες στην διεπαφή χρήστη όταν ένας χρήστης προσθέτει το πρότυπο. Σε ορισμένες περιπτώσεις, θα αλλάξει τον τρόπο συμπεριφοράς του επεξεργαστή όταν το χρησιμοποιείτε για την επεξεργασία ή την εισαγωγή ενός συγκεκριμένου πρότυπου, καθιστώντας πολύ ευκολότερο για τους χρήστες να εκτελούν τα βήματα που απαιτούνται για την προσθήκη ενός συγκεκριμένου προτύπου.

Προσθήκη ή επεξεργασία δεδομένων προτύπου

Για να προσθέσετε ή να επεξεργαστείτε δεδομένα προτύπου, μεταβείτε πρώτα στη σελίδα ενός προτύπου, που βρίσκεται στο "/Template:Templatename".

Έλεγχος της τρέχουσας κατάστασης

Πριν προσθέσετε ή επεξεργαστείτε δεδομένα προτύπου, ελέγξτε εάν το πρότυπο έχει υποσελίδα τεκμηρίωσης. Στη συνέχεια, ελέγξτε εάν το πρότυπο περιέχει ήδη δεδομένα προτύπου και, εάν ναι, εάν βρίσκεται στη σελίδα προτύπου ή στην υποσελίδα τεκμηρίωσης.

Βεβαιωθείτε ότι υπάρχει υποσελίδα. Εάν προσθέσετε δεδομένα προτύπου στη κύρια σελίδα ενός προτύπου ενώ υπάρχει υποσελίδα με δεδομένα προτύπου, τα δεδομένα προτύπου στην κύρια σελίδα θα υπερισχύσουν τα δεδομένα στην υποσελίδα.

Υποσελίδες τεκμηρίωσης

Υπάρχουν δύο βασικοί τρόποι με τους οποίους τα πρότυπα στα περισσότερα wiki του Wikimedia αποθηκεύουν τις σημειώσεις χρήσης τους και άλλα δεδομένα που δεν πρέπει να περιλαμβάνονται στο ίδιο το πραγματικό πρότυπο, όπως κατηγορίες στις οποίες πρέπει να περιέχεται το πρότυπο:

Η συντριπτική πλειονότητα των προτύπων διατηρεί σημειώσεις χρήσης και άλλα δεδομένα που δεν ανήκουν στην ίδια τη σελίδα προτύπου σε μια υποσελίδα τεκμηρίωσης: "/Template:Templatename/doc". Σε σελίδες όπως αυτή, το πρότυπο {{τεκμηρίωση προτύπου}} συμπεριλαμβάνει όλο το περιεχόμενο της σελίδας /doc στη σελίδα προτύπου, διατηρώντας τον πηγαίο κώδικα του προτύπου πολύ πιο καθαρό.
- Σε πρότυπα με υποσελίδες τεκμηρίωσης, η επικεφαλίδα « Τεκμηρίωση προτύπου» θα ακολουθείται από συνδέσμους όπως [προβολή], [επεξεργασία], [ιστορικό] και [εκκαθάριση].

Μερικές σελίδες πρότυπου έχουν διατηρήσει αυτές τις πληροφορίες στην κύρια σελίδα του πρότυπου. Μπορείτε να το εντοπίσετε σε αυτές τις σελίδες αναζητώντας μια εμφάνιση {{Documentation|content= ανάμεσα στις ετικέτες <noinclude>.

Σπάνια, οι κύριες σελίδες πρότυπου μπορεί να περιέχουν ακόμα τεκμηρίωση ακόμη και όταν έχετε ελέγξει όλα τα παραπάνω. Μπορεί, ένας χρήστης να έχει προσθέσει έναν προσαρμοσμένο τίτλο σελίδας /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>
{{τεκμηρίωση προτύπου}}
</noinclude>

Αποθηκεύστε τη σελίδα προτύπου.

Τώρα, για να δημιουργήσετε τη νέα υποσελίδα, δείτε τη γραμμή διευθύνσεων του προγράμματος περιήγησής σας και προσθέστε /doc στο τέλος του URL. Πατήστε ↵ Enter, και μετά επιλέξτε την επιλογή δημιουργίας μιας νέας σελίδας.

Εάν αυτό το wiki έχει ένα πρότυπο ειδοποίησης {{Υποσελίδα τεκμηρίωσης}}, προσθέστε το στην κορυφή της νέας σελίδας. Μπορείτε επίσης να θέλετε να προσθέσετε άλλα πρότυπα, όπως π.χ. ένα σύνδεσμο {{Purge}}.

Εισαγάγετε το κείμενο που κόψατε ή αποθηκεύσατε στο προηγούμενο κείμενο (κάτω από το πρότυπο ειδοποίησης, εάν υπάρχει).

Τυλίξτε οποιεσδήποτε κατηγορίες σε ετικέτες <includeonly>, ώστε να ισχύουν μόνο στην κύρια σελίδα του προτύπου:

<includeonly>
[[Κατηγορία:Παράδειγμα κατηγορίας]]
[[Κατηγορία:Παράδειγμα κατηγορίας 2]]
</includeonly>

Τώρα μπορείτε να προσθέσετε και να επεξεργαστείτε τα δεδομένα προτύπου στην υποσελίδα τεκμηρίωσης χρησιμοποιώντας τις οδηγίες που περιγράφονται στο #Μέθοδοι.

Προσθήκη και επεξεργασία δεδομένων προτύπου στην κύρια σελίδα προτύπου

Εάν δεν μπορείτε να δημιουργήσετε τη σελίδα /doc, μπορείτε να προσθέσετε και να επεξεργαστείτε δεδομένα προτύπου στην κύρια σελίδα του προτύπου ακολουθώντας τις οδηγίες στο #Μέθοδοι.

Εάν ένα πρότυπο έχει υποσελίδα τεκμηρίωσης, ελέγξτε τόσο την κύρια σελίδα όσο και την υποσελίδα τεκμηρίωσης για την παρουσία δεδομένων προτύπου (την ετικέτα <templatedata> ακολουθούμενη από έναν πίνακα μέσα σε σγουρές αγκύλες: {}).

Εναλλακτικά, η επέκταση TemplateData μπορεί να εκτελέσει αυτό το έλεγχο για εσάς. Κάντε κλικ στο «Επεξεργασία» ή στο «Επεξεργασία κώδικα» σε οποιαδήποτε σελίδα. Εάν το πρότυπο έχει ήδη δεδομένα πρότυπου σε οποιαδήποτε σελίδα, θα δείτε μια κίτρινη ειδοποίηση στην κορυφή της σελίδας που λέει είτε:

Σημείωση: υπάρχει ήδη ένα μπλοκ TemplateData στη σχετική σελίδα «$1».

ή

Σημείωση: υπάρχει ήδη ένα μπλοκ TemplateData στη σχετική σελίδα «$1».

Εάν το πρότυπο έχει δεδομένα προτύπου στην υποσελίδα τεκμηρίωσής του

Εάν το πρότυπο έχει δεδομένα πρότυπου στην υποσελίδα τεκμηρίωσής του, αυτή είναι η σελίδα που πρέπει να επεξεργαστείτε. Μπορείτε να το κάνετε κάνοντας κλικ στο «[επεξεργασία]» που βρίσκεται μετά την επικεφαλίδα « Τεκμηρίωση προτύπου» (ή παρόμοια), ή, εάν βρίσκεστε ήδη στη σελίδα /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.

Κάντε αυτό κάνοντας κλικ στο «[επεξεργασία]» που βρίσκεται μετά την επικεφαλίδα «Τεκμηρίωση προτύπου», ή, εάν βρίσκεστε ήδη στη σελίδα /doc, κάνοντας κλικ στο «Επεξεργασία» ή «Επεξεργασία κώδικα» στο επάνω μέρος. Πληκτρολογήστε μια επικεφαλίδα, όπως «Δεδομένα προτύπου» και, στη συνέχεια, προσθέστε την κάτω από αυτήν την επικεφαλίδα. Η ενότητα #Μέθοδοι εξηγεί πώς να προσθέσετε δεδομένα προτύπου.

Μέθοδοι

Μέθοδος επεξεργαστή δεδομένων προτύπου

Αυτός είναι ένας απλός τρόπος για να προσθέσετε ή να επεξεργαστείτε δεδομένα προτύπου, που συνιστάται για λιγότερο έμπειρους χρήστες.

Ο επεξεργαστής δεδομένων προτύπου είναι μια γραφική διεπαφή χρήστη για την προσθήκη και επεξεργασία δεδομένων προτύπου. Είναι μέρος της επέκτασης TemplateData, διαθέσιμη σε οποιαδήποτε σελίδα πρότυπου (ή υποσελίδα τεκμηρίωσης) με κλικ στο «Επεξεργασία»" ή «Επεξεργασία κώδικα».

Αφού κάνετε κλικ στο «Επεξεργασία» ή στο «Επεξεργασία κώδικα» θα δείτε ένα κουμπί πάνω από την περιοχή επεξεργασίας και τον τίτλο της σελίδας που λέει «Διαχείριση TemplateData».

Κάνοντας κλικ σε αυτό το κουμπί θα μεταφερθείτε στον επεξεργαστή δεδομένων προτύπου. Εάν η σελίδα που βρίσκεστε ήδη περιέχει δεδομένα προτύπου, αυτόματα θα εμφανιστεί εδώ.

Χαρακτηριστικά στο παραπάνω παράθυρο:

Το επάνω στοιχείο επιλέγει τη γλώσσα του κειμένου της διεπαφής. Σας επιτρέπει να εισάγετε περιεχόμενο κειμένου σε πολλές γλώσσες, που εμφανίζεται στους χρήστες με βάση τις ρυθμίσεις τους στις Προτιμήσεις και όχι με βάση τη γλώσσα του wiki. Διαφορετικά wiki έχουν εντελώς διαφορετικές βάσεις δεδομένων προτύπων. Εάν δεν υπάρχουν γλωσσικά δεδομένα πρότυπου, η διεπαφή θα προσφέρει μόνο τη γλώσσα του wiki στους χρήστες, αλλά οι χρήστες μπορούν να κάνουν κλικ στο «Προσθήκη γλώσσας» για να προσθέσουν περισσότερα στοιχεία. Ο κωδικός γλώσσας εμφανίζεται σε αγκύλες δίπλα στις παραμέτρους στις οποίες μπορεί να εφαρμοστεί, όπως περιγραφές και ετικέτες.
Το επόμενο στοιχείο είναι η περιγραφή του προτύπου. Αυτή είναι η περιγραφή του προτύπου στο σύνολό του. εμφανίζεται στους χρήστες σε πολλά σημεία στους επεξεργαστές προτύπων ενώ προσθέτουν ένα πρότυπο. Αυτή #Descriptionη παράμετρος και τα αποτελέσματά της τεκμηριώνονται παρακάτω.
Το τρίτο στοιχείο ελέγχει τη μορφοποίηση wikitext του προτύπου. Αυτή η παράμετρος καθορίζει τον τρόπο με τον οποίο θα τοποθετηθεί το wikitext όταν ο χρήστης κάνει κλικ στο «Εφαρμογή», οι δύο κύριοι τύποι είναι "inline" (σε μία γραμμή) και "block" (σε νέες γραμμές). Αυτή η παράμετρος και τα αποτελέσματά της τεκμηριώνονται παρακάτω.

Εάν ο χρήστης επιλέξει «Προσαρμογή», μπορεί να εισαγάγει wikitext στην περιοχή «Συμβολοσειρά προσαρμοσμένη μορφής» σύμφωνα με τους κανόνες προσαρμοσμένων μορφών που τεκμηριώνονται παρακάτω, προκειμένου να δημιουργήσει μια προσαρμοσμένη διάταξη για το πρότυπο όταν ο χρήστης κάνει κλικ στο «Εφαρμογή».

Το τέταρτο στοιχείο ρυθμίζει τις παραμέτρους ενός πρότυπου. Εάν οι παράμετροι έχουν ήδη καθοριστεί στα δεδομένα του πρότυπου, η περιοχή αυτή τα εμφανίζει σε κατάλογο. Εάν ο πηγαίος κώδικας του προτύπου καθορίζει παραμέτρους για τους οποίους δεν υπάρχουν δεδομένα προτύπου, μπορεί να δείτε ένα κουμπί με την ετικέτα «Προσθήκη $1 συνιστώμενων παραμέτρων». Ο επεξεργαστής βγάζει αυτές τις προτάσεις από τον πηγαίο κώδικα του προτύπου αναζητώντας {{{parametername}}} ή {{{parametername|}}}. Αν κάνετε κλικ στο «Προσθήκη $1 συνιστώμενων παραμέτρων» θα προστεθούν αυτές οι παράμετροι χρησιμοποιώντας τα ονόματά τους όπως ορίζονται στον πηγαίο κώδικα. Θα εμφανιστεί επίσης μια πράσινη σημείωση στο επάνω μέρος, για παράδειγμα, «$1 νέες παράμετροι εισήχθηκαν: $2.
Στο κάτω μέρος του παράθυρου βλέπετε ένα κουμπί «Προσθήκη παραμέτρου». Αυτό σας επιτρέπει να προσθέσετε μια παράμετρο χειροκίνητα με ένα προσαρμοσμένο όνομα.

Συνεχίστε στο επόμενο βήμα κάνοντας κλικ σε οποιαδήποτε από τις παραμέτρους στη λίστα. Αυτό θα σας επιτρέψει να επεξεργαστείτε τις πληροφορίες της παραμέτρου.

Όλες αυτές οι δυνατότητες και τα αποτελέσματά τους περιγράφονται στην ενότητα #Μέσα στο όνομα μιας παραμέτρου

* Ο επεξεργαστής δεδομένων πρότυπου δεν θα σας επιτρέψει να αλλάξετε μια παράμετρο σε κενό «Όνομα». Οι παράμετροι στα δεδομένα προτύπων που κατά κάποιο τρόπο αποκτούν κενές συμβολοσειρές ως ονόματα δεν θα προκαλέσουν προβλήματα στον επεξεργαστή wikitext 2010 με το TemplateWizard, αλλά ούτε ο οπτικός επεξεργαστής ούτε ο επεξεργαστής wikitext 2017 θα τις εμφανίσουν καθόλου. Αυτό είναι το μόνο υποχρεωτικό πεδίο στο πρόγραμμα επεξεργασίας δεδομένων προτύπου.

Κάνοντας κλικ στο «Απομάκρυνση πληροφοριών παραμέτρου» θα διαγραφεί η παράμετρος και όλες οι πληροφορίες της από τα δεδομένα του προτύπου. Δεν μπορείτε να ανακτήσετε ή να αναιρέσετε αυτό στα δεδομένα προτύπου, εκτός εάν κάνετε κλικ στο «X» στη συνέχεια. Μπορείτε να αναιρέσετε τυχόν αλλαγές που έγιναν αφού κάνετε κλικ στο «Εφαρμογή» πατώντας Ctrl+Z.
Η έξοδος από τον επεξεργαστή δεδομένων υποδείγματος μετά την πραγματοποίηση αλλαγών σας ζητεί να επιβεβαιώσετε ότι θέλετε να απορρίψετε τις αλλαγές σας.

Όταν τελειώσετε, κάντε κλικ στο «Εφαρμογή». Αυτό θα εισαγάγει αυτόματα τα δεδομένα του πρότυπου στο κάτω μέρος της σελίδας πριν από την ετικέτα </noinclude> ή, εάν υπάρχουν ήδη, θα ενημερωθεί με τις νέες πληροφορίες χωρίς να αλλάξει τη θέση του. Το κείμενο των δεδομένων του προτύπου θα επιλεγεί επίσης όταν κάνετε κλικ στο «Εφαρμογή».

Ο επεξεργαστής δεδομένων προτύπου δημιουργεί παράμετρο "paramOrder" στο κάτω μέρος των δεδομένων προτύπου (ή την ενημερώνει εάν ήδη υπάρχει). Το "paramOrder" περιέχει τις τρέχουσες παραμέτρους δεδομένων προτύπου κατά την σειρά στην οποία εμφανίστηκαν από τον επεξεργαστή δεδομένων προτύπου. Μπορείτε να αλλάξετε το "paramOrder" τραβώντας τις παραμέτρους προς τα πάνω και προς τα κάτω στον επεξεργαστή δεδομένων πρότυπου χρησιμοποιώντας τις τρεις οριζόντιες γραμμές στα αριστερά. Το "paramOrder" και τα αποτελέσματά του τεκμηριώνονται παρακάτω.

Μετά από αυτό, κάντε κλικ στο «Αποθήκευση» για να αποθηκεύσετε την αναθεώρηση της σελίδας.

Χειροκίνητη μέθοδος

Μπορείτε επίσης να προσθέσετε ή να επεξεργαστείτε δεδομένα προτύπου χειροκίνητα. Τα δεδομένα προτύπου γράφονται σε JSON, αλλά δεν χρειάζεται να μάθετε JSON για να μάθετε πώς να δημιουργείτε δεδομένα προτύπου.

Τα δεδομένα του πρότυπου ακολουθούν λίγους πολύ απλούς κανόνες και αποδέχεται μόνο μερικές δεκάδες πιθανές προκαθορισμένες παραμέτρους και τιμές, συνήθως ακολουθώντας τη μορφή "parameter": "value".

Χειροκίνητη προσθήκη δεδομένων προτύπου

Σημειώσεις:

Εάν προσθέτετε δεδομένα προτύπου στην υποσελίδα τεκμηρίωσης ενός προτύπου (συνιστάται), μπορείτε να τα προσθέσετε στο τέλος της σελίδας.
Εάν προσθέτετε δεδομένα προτύπου στην κύρια σελίδα ενός προτύπου (δεν συνιστάται, ανατρέξτε στην ενότητα #Προηγούμενοι έλεγχοι), πρέπει να φροντίσετε να τα τοποθετήσετε μέσα στις ετικέτες <noinclude>...</noinclude>.

Κάντε κλικ στο «Επεξεργασία» ή «Επεξεργασία κώδικα» στη αντίστοιχη σελίδα, και μετά μετακινηθείτε στο σημείο της σελίδας όπου σκοπεύετε να προσθέσετε δεδομένα προτύπου και γράψτε ένα τίτλο: "Δεδομένα προτύπου".

Το πρότυπο {{TemplateData header}} προσθέτει μια σύντομη ειδοποίηση σχετικά με τα δεδομένα του πρότυπου και μπορείτε να το προσθέσετε μετά την επικεφαλίδα.

Για να αρχίσετε να προσθέτετε δεδομένα προτύπου, πληκτρολογήστε μια ετικέτα ανοίγματος και κλεισίματος <templatedata> και ένα ζευγάρι σγουρές αγκύλες σε νέες γραμμές, με μια κενή γραμμή ανάμεσά τους:

<templatedata>
{

}
</templatedata>

Στη συνέχεια, προσθέστε μια εσοχή στην κενή γραμμή ανάμεσα στις δύο σγουρές αγκύλες και αρχίστε να προσθέτετε παραμέτρους. Μπορείτε να βρείτε λεπτομέρειες για τις παραμέτρους στο #Παράμετροι δεδομένων προτύπου. Τα περισσότερα είναι προαιρετικά. μερικά συνιστώνται ανεπιφύλακτα.

Οι παράμετροι μπορούν να είναι σε οποιαδήποτε σειρά, αλλά η παρακάτω σειρά είναι η καλύτερη που συμμορφώνεται με την τεκμηρίωση δεδομένων πρότυπου και καθιστά το περιεχόμενο πιο εύκολο στη χρήση για τους συντάκτες:

<templatedata>
{
    "description": "",
    "format": "",
    "params": {
        "parameter1": {
            "aliases": ["",""]
            "label": "",
            "description": "",
            "type": ""
        }
    },
    "paramOrder": [
    	""
    ]
}
</templatedata>

Βεβαιωθείτε ότι οι παράμετροι, για παράδειγμα, στο αντικείμενο "params", παραμένουν μέσα σε αυτό το αντικείμενο. Αλλιώς θα ενεργοποιήσετε ένα σφάλμα «Μη αναμενόμενη ιδιότητα «$1».» κατά την προσπάθεια αποθήκευσης.

Παράδειγμα

Ακολουθούν μερικά παραδείγματα δεδομένων προτύπου για ένα υποθετικό πρότυπο εκκαθάρισης. Ένα τέτοιο πρότυπο θα εμφανίζει μια ειδοποίηση και θα τοποθετεί τη σελίδα σε μια χρονολογημένη κατηγορία με βάση τον μήνα και το έτος που εισάγεται. Η ανακοίνωση μπορεί επίσης να περιέχει ένα σύνδεσμο σε μια ενότητα συζήτησης. Τα δεδομένα του πρότυπου θα έμοιαζαν κάπως έτσι:

<templatedata>
{
	"description": "Χρησιμοποιήστε αυτό το πρότυπο για να υποδείξετε ότι ένα λήμμα χρειάζεται καθαρισμό.",
	"format": "inline",
	"params": {
		"ημερομηνία": {
			"label": "Μήνας και έτος",
			"description": "Ο μήνας και το έτος που προστέθηκε το πρότυπο",
			"type": "string",
			"autovalue": "{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}",
			"example": "Ιανουάριος 2022",
			"suggested": true
		},
		"αιτία": {
			"aliases": ["1"],
			"label": "Αιτία",
			"description": "Η αιτία που το λήμμα χρειάζεται καθαρισμό",
			"type": "string"
		},
		"συζήτηση": {
			"aliases": ["talksection"],
			"label": "Ενότητα σελίδας συζήτησης",
			"description": "Το τμήμα της σελίδας συζήτησης που περιέχει σχετική συζήτηση",
			"type": "string"
		}
	},
	"paramOrder": [
		"ημερομηνία",
		"αιτία",
        "συζήτηση"
	]
}
</templatedata>

Η αντίστοιχη τεκμηρίωση δεδομένων τύπου θα εμφανίζεται ως εξής:

Χρησιμοποιήστε αυτό το πρότυπο για να υποδείξετε ότι ένα λήμμα χρειάζεται καθαρισμό.

Παράμετροι προτύπου[Διαχείριση TemplateData]
Αυτό το πρότυπο προτιμά εντός γραμμής μορφοποίηση των παραμέτρων.
Παράμετρος		Περιγραφή	Τύπος	Κατάσταση
Μήνας και έτος	`ημερομηνία`	Ο μήνας και το έτος που προστέθηκε το πρότυπο Παράδειγμα Ιανουάριος 2022 Αυτόματη τιμή `{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}`	Συμβολοσειρά	προτεινόμενο
Αιτία	`αιτία` `1`	Η αιτία που το λήμμα χρειάζεται καθαρισμό	Συμβολοσειρά	προαιρετικό
Ενότητα σελίδας συζήτησης	`συζήτηση` `talksection`	Το τμήμα της σελίδας συζήτησης που περιέχει σχετική συζήτηση	Συμβολοσειρά	προαιρετικό