Help:Step-by-step guide to using the populace template

From An Tir Culture Wiki
Jump to navigation Jump to search

Step-by-step guide to using the populace template

This is a guide to using the populace template in it's intended way. That is to say, passing the template parameters as opposed to copying the template / substituting the template into your page.

First, we'll discuss how to use the template via passing parameters, which is a fancy way to say handing off all the data the template wants, piece by piece. After, we'll discuss how copying or substituting the template differs, and advantages/disadvantages to each method.

Standard method of using the Populace template

(this is as of February 2025)

As you might observe if you visit the populace template page, is has it's instructions built in to the template. I'll put them here:

To use this template, you have the template name, and then a series of vertical pipes "|" separating each parameter name, with an equals sign, followed by what you want to pass to that parameter. All of that should be enclosed in double curly brackets. For example:

{{Populace 
| photo = [[File:Your_File_Name_Here.jpg|300px]] 
| photocaption = Your caption for your photo 
| location = where you are located 
| pronouns = your pronuns 
| status = Date you first joined the SCA 
| oplink = url to your OP entry 
| title = Your preferred title(s) 
| offices = Any offices you hold, if none leave blank 
| device = [[File:Your_Devce_File_Name.gif|300px]] 
| devicecaption = Heraldric blazon for your device 
}}


Each part of the template has a keyword, such as "photo", "photocaption", or "location", that tells the template just what part of the template you are about to give ("pass") data to. These keywords must be spelled exactly as used by the template to work.

Next, you will have an equals sign ("=") followed by the data you want to pass to the template. To fill out all the fields, you'll need the following: Your information about yourself / your persona - pronouns, date you started in the SCA, where you play, your titles (if any), names of any offices you hold. You will also need the URL (web link) to your Order of Precedence entry, if you have one. That can be found by searching the online OP.

Note: Ideally you'll want to use4 the direct "clean" link to your OP entry, which you can get by searching for yourself, then clicking in your name to see your individual entry. It should just contain a URL that ends in "who=XXXX", where XXXX is your entry number in the OP database. So, for example, "https://op.antirheralds.org/index.php?with=Start&name=Michelino&chosen=&GO=GO" is the URL I get searching for Michelino, but after I click on my name, I get "https://op.antirheralds.org/index.php?who=6169", which is the direct link to my individual OP entry.

Finally, you will want to have previously uploaded and have the file names to your profile picture, and your registered device (along with it's blazon - heraldic description). Information on how to upload images can be found here. If you have a passed device (arms / heraldry), you can find it, and its blazon, on the An Tir Roll of Arms online.

Filling in the text data

Photo
File:Your File Name Here.jpg
Your caption for your photo
Information
Resides: Barony of Aquaterra
Pronouns: he/him
Date Started: AS XV or AS XXXIV
Awards: [url to your OP entry Order of Precedence]
Prefered Title: Lord/Signore
Offices: Aquaterra Great Book, An Tir Wiki Admin
Heraldry
File:Your Devce File Name.gif
Heraldric blazon for your device

The first and easiest step is to just replace the text in the template fields with the text you actually want to appear. For example:

{{Populace 
| photo = [[File:Your_File_Name_Here.jpg|300px]] 
| photocaption = It's-a me, Michelino! 
| location = Barony of [[Aquaterra]]
| pronouns = he/him 
| status = AS XV or AS XXXIV 
| oplink = url to your OP entry 
| title = Lord/Signore 
| offices = Aquaterra Great Book, An Tir Wiki Admin 
| device = [[File:Your_Devce_File_Name.gif|300px]] 
| devicecaption = Heraldric blazon for your device 
}}

This looks like the example to the right.

Note I added a wiki link in my location field. You don't have to do this, but it's a nice addition so folks can click on the link directly do find out more about where you are located.



Filling in the OP URL



Photo
File:Your File Name Here.jpg
Your caption for your photo
Information
Resides: Barony of Aquaterra
Pronouns: he/him
Date Started: AS XV or AS XXXIV
Awards: Order of Precedence
Prefered Title: Lord/Signore
Offices: Aquaterra Great Book, An Tir Wiki Admin
Heraldry
File:Your Devce File Name.gif
Heraldric blazon for your device

Find the URL (web address) to the individual link to your OP entry, and paste it in here. Just the text of the URL, the template adds the needed square brackets ("[" and "]") automatically so the link will work.

{{Populace 
| photo = [[File:Your_File_Name_Here.jpg|300px]] 
| photocaption = It's-a me, Michelino! 
| location = Barony of [[Aquaterra]]
| pronouns = he/him 
| status = AS XV or AS XXXIV 
| oplink = http://op.antirheralds.org/index.php?who=6169 
| title = Lord/Signore 
| offices = Aquaterra Great Book, An Tir Wiki Admin 
| device = [[File:Your_Devce_File_Name.gif|300px]] 
| devicecaption = Heraldric blazon for your device 
}}

So now we should get the link added in on the right.



Adding the images



Photo

It's-a me, Michelino!
Information
Resides: Barony of Aquaterra
Pronouns: he/him
Date Started: AS XV or AS XXXIV
Awards: Order of Precedence
Prefered Title: Lord/Signore
Offices: Aquaterra Great Book, An Tir Wiki Admin
Heraldry

Per pale wavy Purpure and Or, two chalices in bend countercharged

Find the URL (web address) to the individual link to your OP entry, and paste it in here. Just the text of the URL, the template adds the needed square brackets ("[" and "]") automatically so the link will work.

{{Populace 
| photo = [[File:Michelino di Gino Martini1.jpg|300px]] 
| photocaption = It's-a me, Michelino! 
| location = Barony of [[Aquaterra]]
| pronouns = he/him 
| status = AS XV or AS XXXIV 
| oplink = http://op.antirheralds.org/index.php?who=6169 
| title = Lord/Signore 
| offices = Aquaterra Great Book, An Tir Wiki Admin 
| device = [[File:MichelinodiGinoMartini.gif|300px]] 
| devicecaption = Per pale wavy Purpure and Or, two chalices in bend countercharged 
}}

So now we should get the link added in on the right.