ढाँचा: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 than 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: M 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

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.