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 {{infobox school}}.

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 {{NCES District ID|<the ID number>|district_name=<District name at NCES site>|access_date={{subst:#time: F j, Y}}}}.
• 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 <ref name="nces_dist" /> and you have them fully cited!
• As with any article using references, remember to add <references /> or {{reflist}} at the bottom of your article.

Parameters

{{NCES District ID|ID|district_name=Name|access_date=Date|do_not_render|do_not_show_link|ref_name=Ref Name}}

• 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.

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:NCES District ID in articles based on its TemplateData.

TemplateData for NCES District ID

No description.

Template parameters

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
NCES District ID	1	Numeric code of the district ID.	Number	required
District name	district_name	Name of the district as listed in the NCES database.	String	required
access date	access_date	Date used in the cite reference.	String	required
do_not_render	do_not_render	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.	Unknown	optional
do_not_show_link	do_not_show_link	If used, will suppress a direct link to the NCES data page. Ignored if do_not_render is in effect.	Unknown	optional
ref name	ref_name	If used, will override the default ref name of "nces_dist" with the supplied text.	String	optional

See also

• Template:NCES School ID