Template:NCES District ID/doc

This template is designed to allow quick standardized inline references citing the National Center for Education Statistics Common Core of Data (CCD) website to be created for articles containing statistics about school districts in the United States. The CCD website contains enrollment numbers, faculty head-counts and other statistics for most schools in the US. It is envisioned that this data will be particularly suited for use in an.

In its most common usage, this will produce text of the District ID as both a direct hyperlink to the NCES webpage for the district and an inline reference.

Restrictions

 * This should be used ONLY for US schools.
 * DO NOT use subst: with this template! The url created internally could theoretically change. If it does, it is hoped that the url that this template defines can be updated, thus updating the links effortlessly in perhaps thousands of articles. If you use subst, your article will have to be edited by hand or live on with a dead link!
 * By default the reference name is "nces_dist", therefore use this template only once in an article unless you supply different ref_name parameters for additional uses.

Usage
On a page needing the reference:
 * Lookup the school district statistics by going to The NCES CCD District search page. After submitting the search, click on the link for the individual district to get the district's statistics page.
 * Note some information:
 * The "NCES District ID". As of this writing, there are two reference numbers given. Carefully choose only this one.
 * The name of the district as shown at NCES. This is often slightly different from the actual name of the district. The name shown should NOT influence the name you have chosen to use in your article!
 * You may also wish to note any statistics that the NCES site has that would be of interest.
 * In your article, where the id number would go, enter.
 * SAVE the article!
 * Edit the article again.
 * You will now have the ID number with an associated reference called "nces_dist". The reference has been fleshed out to a full web citation for you!
 * Since you now have the named reference, for any of the interesting statistics from the NCES data used in your article, you may simply tag them with and you have them fully cited!
 * As with any article using references, remember to add or at the bottom of your article.

Parameters

 * 1st parameter (unnamed): mandatory is the "NCES District ID" and is mandatory.
 * district_name: mandatory This is the name of the district as listed at the NCES database . This is needed to make the citation correct.
 * access_date: mandatory The date used in the cite reference.
 * do_not_render: If present with a value, will suppress the district ID as the text in front of the reference. If this is done, then your text immediately before the brackets is where the reference will go.
 * do_not_show_link: If present with a value, will suppress the district ID as a direct link to the NCES data page. If do_not_render is in effect, this is ignored.
 * ref_name: If supplied, will override the default of "nces_dist" as the reference name.

{	"params": { "1": {			"label": "NCES District ID", "description": "Numeric code of the district ID.", "type": "number", "required": true },		"do_not_render": { "description": "If used, suppresses the district ID as the text in front of the reference and places the reference at the text immediately before the brackets." },		"do_not_show_link": { "description": "If used, will suppress a direct link to the NCES data page. Ignored if do_not_render is in effect." },		"district_name": { "label": "District name", "description": "Name of the district as listed in the NCES database.", "type": "string", "required": true },		"access_date": { "label": "access date", "description": "Date used in the cite reference.", "type": "string", "required": true },		"ref_name": { "label": "ref name", "description": "If used, will override the default ref name of \"nces_dist\" with the supplied text.", "type": "string" }	},	"paramOrder": [ "1",		"district_name", "access_date", "do_not_render", "do_not_show_link", "ref_name" ],	"format": "inline" }