Template:Designation/doc

From The Galactic Republic
Jump to navigation Jump to search
Edit-copy green.svg This is a documentation

Usage[edit source]

This template is mainly used in conjunction with {{Infobox Historic Site}}, which is under the supervision of WikiProject Historic Sites. This template tells the infobox how to display designations by passing along either a color or some text, which are dependent on the designation. The template is set up, however, so that anyone can use it as a stand-alone template to create tables, lists, and other articles throughout Wikipedia. The following is an explanation of how to use this template as a stand-alone template:

Template syntax

{{Designation|<designation>|<identifier>}}

  • <designation> – tells the template which designation to use. (i.e. "NRHP", "World Heritage Site", "NYCL", etc.) This parameter is case-insensitive, so "world heritage site" will yield the same thing as "WoRlD HeRiTaGe SiTe". All supported designations are listed below.
  • <identifier> – can be either of the following values:
    • colour (or color) – will return a hex code for the official color of <designation>
    • text – will return a link to the article talking about <designation>
    • divbox - will generate a bordered div block element version, consisting of the link to the article talking about <designation> (this is useful in various templates that use the {{Infobox}}}
Examples
  • {{Designation/colour|World Heritage Site}} yields " #FFE978"
  • {{Designation/text|Grade I}} yields "Listed Building – Grade I"
  • {{Designation/divbox|National Historic Site of Canada}} yields:
National Historic Site of Canada

Supported designations[edit source]

Global designations[edit source]

Designation Bordered version Scope Count Valid <designation> values (Callnames)
UNESCO World Heritage Site Global 874 World Heritage Site; WHS
IUCN Category Ia (Strict Nature Reserve) Global ??? IUCN Category Ia; IUCN Ia; Category Ia; Nature Reserve
IUCN Category Ib (Wilderness Area)
IUCN Category Ib (Wilderness Area)
 Global ??? IUCN Category Ib; IUCN Ib; Category Ib; Wilderness Area
IUCN Category II (National Park)
IUCN Category II (National Park)
 Global ??? IUCN Category II; IUCN II; Category II; National Park
IUCN Category III (Natural Monument)
IUCN Category III (Natural Monument)
 Global ??? IUCN Category III; IUCN III; Category III; Natural Monument
IUCN Category IV (Habitat/Species Management Area)
IUCN Category IV (Habitat/Species Management Area)
 Global ??? IUCN Category IV; IUCN IV; Category IV; Habitat Management; Species Management
IUCN Category V (Protected Landscape/Seascape)
IUCN Category V (Protected Landscape/Seascape)
 Global ??? IUCN Category V; IUCN V; Category V; Protected Landscape; Protected Seascape
IUCN Category VI (Managed Resource Protected Area)
IUCN Category VI (Managed Resource Protected Area)
 Global ??? IUCN Category VI; IUCN VI; Category VI; Managed Resource Protected Area
Ramsar Wetland Global ??? Ramsar; Ramsar Wetland; Ramsar Wetland of International Importance

National/regional designations[edit source]

Designation Bordered version Scope Count Valid <designation> values (Callnames)
Cultural Monument of Albania Albania 201 Cultural Monument of Albania; Albanian Cultural Monument; Albania; Monument Kulture
National Historic Monument of Argentina Argentina ~400 National Historic Monument of Argentina; Argentina Historic Monument; Argentina; NHMA
National Historic Heritage of Brazil Brazil 1,047 National Historic Heritage of Brazil; Brazilian Historic Heritage; IPHAN; Brazil; NHHB
National Historic Site of Canada Canada 958 National Historic Site of Canada; Canadian National Historic Site; Canada; NHSC
Heritage Railway Station (Canada) Canada 163 Heritage Railway Station of Canada; Canadian Heritage Railway Station; HRSC
Protected Natural Value of Croatia Croatia 461 Protected Natural Value of Croatia; Croatian Protected Natural Value; Protected area of Croatia; Croatian Protected area; Croatia Natural; Spomenik prirode
Cultural Good of Croatia Croatia ??? Cultural Good of Croatia; Croatian Cultural Good; Croatia Cultural; Spomenik kulture
National Register of Historic Parks and Gardens England ??? National Register of Historic Parks and Gardens; Register of Historic Parks and Gardens; Historic Parks and Gardens; England Historic Park; England Historic Garden; English Historic Park; English Historic Garden
Monument historique France >43,000 Monument historique; France; French
National Monument of Ireland Ireland ~1,000 Irish National Monument; National Monument of Ireland; Ireland Monument in State Care; Irish Monument in State Care; Ireland; Irish
National Treasure of Japan Japan 1079 National Treasure of Japan; Japanese National Treasure; Japan
Rijksmonument Netherlands 55,000+ Rijksmonument; Dutch National Monument; Netherlands National Monument; National Monument of the Netherlands; Netherlands; Dutch
New Zealand Historic Places Trust - Category I New Zealand ??? New Zealand Historic Places Trust Category I; New Zealand Category I; NZ Category I
New Zealand Historic Places Trust - Category II New Zealand ??? New Zealand Historic Places Trust Category II; New Zealand Category II; NZ Category II
Portuguese National Monument Portugal 791 National Monument of Portugal; Portuguese National Monument; Monumento Nacional do Portugal; Portugal; IPPAR
Monument istoric Romania 29,540 National Register of Historic Monuments in Romania; Monument istoric; Romania; Romanian
Cultural Heritage of Serbia Serbia 2,391 Cultural Heritage of Serbia; Serbia; Serbian
Inventory of Gardens and Designed Landscapes in Scotland Scotland ~386 Inventory of Gardens and Designed Landscapes in Scotland; Gardens and Designed Landscapes in Scotland; Inventory of Gardens and Designed Landscapes
National monument of Singapore Singapore ??? National Monument of Singapore; Singapore National Monument; Singapore
Spanish Property of Cultural Interest Spain ~13,000 Spanish Property of Cultural Interest; Bien de Interés Cultural; BIC; Spain; Spanish
Swiss Cultural Property of National Significance Switzerland ??? Swiss Cultural Property of National Significance; Swiss; Switzerland; Swiss Cultural Property
National Monument of Zambia Zambia >3000 National Monument of Zambia; Zambian National Monument; Zambia
United Kingdom[edit source]
Designation Bordered version Scope Count Valid <designation> values (Callnames)
Scheduled monument United Kingdom 19,763 Scheduled Monument; Scheduled Ancient Monument; Ancient Monument; UK Scheduled Monument; UK Ancient Monument; Scheduled Historic Monument; UK Monument in State Care; UK Scheduled Ancient Monument; UK Scheduled Historic Monument
Listed Building United Kingdom >500,000 Listed Building; United Kingdom Listed Building; UK Listed Building
Listed Building – Grade I
Listed Building – Grade I
 England & Wales 9,445 Grade I Listed Building; Grade I; United Kingdom Grade I; UK Grade I
Listed Building – Grade II*
Listed Building – Grade II*
 England & Wales 22,164 Grade II* Listed Building; Grade II*; United Kingdom Grade II*; UK Grade II*
Listed Building – Grade II
Listed Building – Grade II
 England & Wales 345,662 Grade II Listed Building; Grade II; United Kingdom Grade II; UK Grade II
Listed Building – Grade A
Listed Building – Grade A
 Northern Ireland ??? Grade A Listed Building; Grade A; Northern Ireland Grade A
Listed Building – Grade B+
Listed Building – Grade B+
 Northern Ireland ??? Grade B+ Listed Building; Grade B+; Northern Ireland Grade B+
Listed Building – Grade B1
Listed Building – Grade B1
 Northern Ireland ??? Grade B1 Listed Building; Grade B1; Northern Ireland Grade B1
Listed Building – Grade B2
Listed Building – Grade B2
 Northern Ireland ??? Grade B2 Listed Building; Grade B2; Northern Ireland Grade B2
Listed Building – Category A
Listed Building – Category A
 Scotland ??? Category A Listed Building; Category A; Scotland Category A
Listed Building – Category B
Listed Building – Category B
 Scotland ??? Category B Listed Building; Category B; Scotland Category B
Listed Building – Category C(S)
Listed Building – Category C(S)
 Scotland ??? Category C Listed Building; Category C; Scotland Category C
United States[edit source]
Designation Bordered version Scope Count Valid <designation> values (Callnames)
U.S. National Register of Historic Places United States >80,000 National Register of Historic Places; NRHP
U.S. National Historic Landmark United States ~2,450 National Historic Landmark; U.S. National Historic Landmark; US National Historic Landmark; NRHP-NHL; NHL
U.S. Historic district United States ??? United States Historic District; U.S. Historic District; US Historic District; Historic District; NRHP-HD; HD
U.S. Historic district
Contributing property 		United States ??? United States Contributing Property; U.S. Contributing Property; US Contributing Property; Contributing Property; NRHP-CP; CP
U.S. National Historic Landmark District United States ~200 U.S. National Historic Landmark District; US National Historic Landmark District; National Historic Landmark District; NRHP-NHLD; NHLD
U.S. National Monument United States 93 U.S. National Monument; US National Monument; National Monument; NRHP-NMON; NMON
U.S. National Historic Site United States 89 U.S. National Historic Site; US National Historic Site; National Historic Site; NRHP-NHS; NHS
U.S. National Memorial United States 44 U.S. National Memorial; US National Memorial; National Memorial; NRHP-NMEM; NMEM
U.S. National Historical Park United States 42 U.S. National Historical Park; US National Historical Park; National Historical Park; NRHP-NHP; NHP
U.S. National Battlefield United States 11 U.S. National Battlefield; US National Battlefield; National Battlefield; NRHP-NB; NB
U.S. National Military Park United States 9 U.S. National Military Park
U.S. National Natural Landmark United States ??? U.S. National Natural Landmark; US National Natural Landmark; National Natural Landmark; NNL
Alabama Register of Landmarks and Heritage United States – Alabama 1396 Alabama Register; Alabama Landmark; Alabama; USAL; ARLH
California Historical Landmark United States – California >1,000 California Historical Landmark; California; CHISL
Colorado State Register of Historic Properties United States - Colorado >1700 Colorado State Register of Historic Properties; Colorado; CSRHP; USCO
Indiana Register of Historic Sites United States - Indiana ~1900 Indiana Register of Historic Sites and Structures; Indiana; IRHSS; USIN
Michigan State Historic Site United States – Michigan 2730 Michigan State Historic Site; Michigan; MSHS
Mississippi Landmark United States – Mississippi 890 Mississippi Landmark; Mississippi; USMS
Nevada Historical Marker United States - Nevada 266 Nevada Historical Marker; Nevada Marker; Nevada; USNV
N.H. State Register of Historic Places United States - New Hampshire ~200 New Hampshire State Register of Historic Places; New Hampshire State Register; New Hampshire; NHSR; NHSRHP; USNH
New Jersey Register of Historic Places United States - New Jersey ??? New Jersey Register of Historic Places; New Jersey; NJRHP; USNJ
N.M. State Register of Cultural Properties United States - New Mexico ~2000 N.M. State Register of Cultural Properties; New Mexico State Register; New Mexico; NMSRCP; NMSR; USNM
Recorded Texas Historic Landmark United States - Texas ~6300 Recorded Texas Historic Landmark; Texas; RTHL; USTX
Virginia Landmarks Register United States - Virginia ??? Virginia Landmarks Register; Virginia; VLR; USVA
Albuquerque Historic Landmark United States – New Mexico – Albuquerque 20 Albuquerque Historic Landmark; Albuquerque; ALBHL
Berkeley Landmark United States – California – Berkeley ~350 Berkeley Landmark; Berkeley; BERKL
Chicago Landmark United States – Illinois – Chicago ~200 Chicago Landmark; Chicago; CHICL
Dallas Landmark United States – Texas – Dallas 100 Dallas Landmark; Dallas
Davenport Register of Historic Properties United States – Iowa – Davenport ~50 Davenport Register of Historic Properties; Davenport; DRHP
Long Beach Historic Landmark United States – California – Long Beach 114 Long Beach Historic Landmark; Long Beach; LBHL
Los Angeles Historic-Cultural Monument United States – California – Los Angeles 886 Los Angeles Historic-Cultural Monument; Los Angeles Historic Cultural Monument; Los Angeles; LAHCM
New York City Landmark United States – New York – New York City ~23,000 New York City Landmark; NYC Landmark; New York City; NYC; NYCL
Omaha Landmark United States – Nebraska – Omaha ~100 Omaha Landmark; Omaha
Oyster Bay Landmark United States – New York – Oyster Bay 40 Oyster Bay Landmark; Oyster Bay, New York; Oyster Bay, NY; Oyster Bay
Philadelphia Register of Historic Places United States – Pennsylvania – Philadelphia ??? Philadelphia Register of Historic Places; Philadelphia; PRHP
Pittsburgh Landmark — PHLF United States – Pennsylvania – Pittsburgh 66 Pittsburgh Historic Landmark; Pittsburgh Landmark; Pittsburgh; PHLF
Riverside Landmark United States – California – Riverside ~110 Riverside Landmark; Riverside; RIVL
St. Louis Landmark United States – Missouri – St. Louis 121 St. Louis Landmark; St Louis Landmark; St. Louis; St Louis
San Diego Historic Landmark United States – California – San Diego ~870 San Diego Historic Landmark; San Diego; SDHL
San Francisco Designated Landmark United States – California – San Francisco ~250 San Francisco Designated Landmark; San Francisco Landmark; San Francisco; SFDL
Santa Monica Historic Landmark United States – California – Santa Monica ~90 Santa Monica Historic Landmark; Santa Monica; SMHL
Seattle Landmark United States – Washington – Seattle ~450 Seattle Landmark; Seattle

State/provincial/local designations[edit source]

Designation Bordered version Scope Count Valid <designation> values (Callnames)
Alberta Historic Resources Act Canada - Alberta ??? Alberta Historic Resources Act; Alberta; AHRA
New Brunswick Heritage Conservation Act Canada - New Brunswick ??? New Brunswick Heritage Conservation Act; New Brunswick; NBHCA
Nova Scotia Heritage Property Act Canada - Nova Scotia ??? Nova Scotia Heritage Property Act; Nova Scotia; NSHPA
Ontario Heritage Act Canada - Ontario ??? Ontario Heritage Act; Ontario
Prince Edward Island Heritage Place Canada - Prince Edward Island ??? Prince Edward Island; PEI; Heritage Places Protection Act
Patrimoine culturel du Québec Canada - Quebec ??? Repertoire du Patrimoine Culturel du Quebec; Quebec; Cultural Heritage Register of Quebec
Saskatchewan Heritage Property Act Canada - Saskatchewan 800+ Saskatchewan Heritage Property Act; Saskatchewan; SHPA
Declared Monument of Hong Kong China – Hong Kong 92 Declared Monument of Hong Kong; Hong Kong Declared Monument; HK Declared Monument
Hong Kong Graded Building China – Hong Kong 1154 Hong Kong Graded Building; HK Graded Building; Graded Building
Hong Kong Graded Building – Grade I China - Hong Kong 212 Hong Kong Grade I Historic Building; Hong Kong Grade I; HK Grade I
Hong Kong Graded Building – Grade II China - Hong Kong 366 Hong Kong Grade II Historic Building; Hong Kong Grade II; HK Grade II
Hong Kong Graded Building – Grade III China - Hong Kong 576 Hong Kong Grade III Historic Building; Hong Kong Grade III; HK Grade III
Yangon City Landmark Burma – Yangon 188 Yangon City Heritage List; Yangon City Landmark; Yangon Landmark; Yangon City; Yangon

Adding new designations[edit source]

If you've created or contributed to a list-article or individual property articles of a designation or heritage register not listed above, you can suggest its addition to the template. To suggest a new designation for inclusion in this template, raise a question at Wikipedia talk:WikiProject Historic sites.

Requirements[edit source]

In order for a register to be added to this template, there are several criteria that must be met:

  1. The register must be an official designation consisting of a reasonable number of sites. If a designation covers only a small community and contains only a handful of sites, it's probably not necessary to add it to this template.
  2. There must be an article about the register on Wikipedia, and there should be at least an external link to a list of all sites on the register. Ideally, there should be a list article on Wikipedia containing links to all articles about sites on that register.
  3. The register's scope must be identified. What exactly can become listed on this register? Is it confined to a small area such as a city or municipality? Perhaps a state or province? Or maybe even an entire nation or many nations? A designation can be classified as "Global", meaning any site in any nation can qualify, "National/regional", meaning only sites in a particular nation or group of nations (i.e. the United Kingdom or North America) can qualify, "State/provincial", meaning only sites in a particular region of a country (i.e. a state in the United States or an emirate in the United Arab Emirates) may qualify, or "Local", meaning only sites in a specific city, neighborhood, or community may qualify.
  4. Text and a color scheme must be chosen for the designation. This template allows an editor freedom over the background color of the designation's bar in {{Infobox Historic Site}} as well as the text color. The text of the bar will link to the main article of the register in some way, and should contain sufficient information to uniquely identify the register.
  5. Valid callnames must be chosen for the designation. Callnames are valid values for the <designation> parameter described at the top of this page. Callnames are unique to an individual register, so if another similar designation contains callnames that may conflict with the new register, some reconciliation will be needed (i.e. if Switzerland maintains two national designations and one is already in this template using the callname "Switzerland", that callname must be taken out to remove ambiguity before the second designation is added).

Through discussion, determine a color scheme for the designation and which text will appear in the infobox bar. Also, determine callnames, identifying any ambiguities or overlap between designations. Once the text, the color, and the callname(s) have been discussed, the designation can be incorporated into this template. Below are a few guidelines on how to choose these identifiers.

Color selection[edit source]

While it's desirable for the colors to be related to the designation, accessibility is our first concern. Some users of Wikipedia may be fully or partially color blind, and certain color combinations can be hard for them to see. It may be necessary to modify the colors a little to accommodate these users; for more information see Wikipedia:Color.

In general, very light colors are preferred in order to have adequate contrast between the text and the background. The following colors are all acceptable choices:

#FFE978 #DACAA5 #CDE5B2 #BFFFBF #B2E5CD #A5CADA #A8BDEC #FFC0CB

The bordered div box versions (as used on {{Infobox Historic Site}}) do not have these accessibility issues, and thus use a different color palette.

Callname selection[edit source]

In choosing callnames (valid <designation> values), choose names that are generally associated with the designation – not personal preferences (i.e. don't choose "My Hometown," "Family Vacation Spot," etc.). Be sure to include many different variations on word order (If you include "Canadian National Historic Site" then include "National Historic Site of Canada" as well). Callnames are case-insensitive, so there is no need for various capitalization changes.

You may use abbreviations, but use abbreviations that make sense. For Atlanta Landmarks, "AL" wouldn't be good because it may be confused with landmarks in Alabama; something like "ATL" would be better because more potential readers would associate that with Atlanta. For smaller cities it is wise to include country or state names too (such as "Oyster Bay, New York") because people are more likely to use state names than for larger, more well-known cities.

Care must also be taken to avoid overlap or ambiguity in choosing callnames. Common practice in this template's designations is to include the nation, state, or city's name as a potential callname for that designation. If a nation, state, or city maintains more than one historic register, though, things can get messy. When adding a new designation, check first to make sure that no other designations use the callnames you wish to attach to the new designation. If you were adding a new national designation for Switzerland, you would notice that the designation already in the template (Swiss Cultural Properties of National Significance) uses the callname "Switzerland". Since your new designation would also be a national designation of Switzerland, the "Switzerland" callname should be removed from the old designation, making sure to update any articles using that callname, before the new designation is added to the template.

Text selection[edit source]

File:Missing map.svg
Be sure to provide adequate information to uniquely identify the designation.

When selecting the text that will be shown in the infobox bar, be sure to provide enough information to uniquely identify the designation. Many registers in this template are very similar, and some may even overlap in scope (i.e. a single area may be covered by more than one register). Make sure when selecting the text that will display in the designation's bar that enough information is given to remove all ambiguity. If you were adding a register about the National Monuments of Singapore, you couldn't simply choose "National Monument" for the text bar because almost every single country contains its own national monuments. Generally a good idea is to include the nation, region, or area covered by the register in the text. Instead of "State Landmark", the text should read "California Landmark" or something similar.

The list article to which the text will point can be helpful in identifying the register, though it should not be a primary identifier. A reader should be able to read the text of the bar and know immediately which register the infobox is talking about. Secondary information such as intricacies of scope, requirements of addition, and explanations of labels (Grade I, Category C, Type IV, etc.) should be explained in the list article but not the text bar. While adequate information is needed in the text bar, make sure not to be overly descriptive so as not to overwhelm the infobox. If the bar's text takes up more than two lines, you should probably think about shortening it.

Designation incorporation[edit source]

After colors, text, and callnames have been chosen, the designation is ready to be added to the template. You should probably ask someone at WT:HSITES to do this for you, but if you feel up to it, you can dive into template code independently. Before editing anything, you may want to check out Help:Templates.

The template is split up into three major code blocks:

Template:Caution To incorporate the designation's color into the template, find the appropriate scope-level (Global, national/regional, state/provincial, or local) section of the "color" block of code. The section is alphabetized according to scope. Nation's names are in alphabetical order, followed by states or provinces, followed by cities. Find the appropriate location in alphabetic order for your new designation and insert a new line. On this line, list the callname(s) selected for the designation, separated by vertical pipes ("|"). Be sure to add the callname(s) in all caps to remove case sensitivity; if a callname is not entered in all caps, it will not work. General practice is to not allow the callnames to exceed a certain point on a line to preserve readability, so if a designation passes the column of existing equal signs, it should be moved to a new line. At the end of the last line of callnames, add an equal sign and then the HEX value of the color chosen. In order for the wikisoftware to parse the color correctly, "& #35;" (without the space it renders a "#" sign) must be added to the front of the HEX color. Once this is done, repeat the procedure for the alternate colour template.

After the colors are added, you can simply copy/paste that entire line of code including all callnames down into the "text" block of code at the bottom of the template. Be sure to maintain the alphabetical order of the section by pasting into the same location in the text block that you pasted into the color block. After pasting, delete the HEX color and replace it with the text for the infobox bar. This text, as discussed above, should contain a link to the register's main list article. To change the text color of a link, a <span> element is used (See existing designations for examples).

After the colors and text have been added to the template, you are ready to save. Before clicking save, double check to see that nothing else other than what you added was changed (you can use the "Show changes" option if necessary) and save the page with the edit summary "Added _______ designation," inserting the name of the designation you just added.

After the color/text are added to the main template, you can either ask someone at WT:HSITES to update the "Supported designations" page or update it yourself. To add your designation to the page, you'll have to find the correct scope-based subpage. If you want to add a global designation, append "/Global" to the end of the article name (i.e. Template:Designation/Supported designations/Global); for national/regional designations, it's /National; for state/provincial designations, it's /State; and for local/municipal designations, it's /Local. Once you've navigated to the correct subpage, simply click the edit button and add a new table row in the correct alphabetical order based on descending order of scope (So if you were adding New York State Landmarks, and Alabama/Ohio were already there, you would add New York between the two. If there was a Hong Kong landmark, it would be even before Alabama because "China" starts with C and "United States" starts with U). The simplest method of creating a new row is to copy/paste a pre-existing row and edit that. For more information on Wikipedia Tables, see Help:Tables.

Don't change anything in the first column except the designation call. Change the former designation callname to one of your designation's callnames in both the "color" and "text" locations. The next cell is the scope of the designation. Scopes are generally in Country – State/province – City/municipality, etc. form, so for the New York State example, you would not just type "New York"; you would type "United States – New York" and for Hong Kong, you would type "China – Hong Kong." The next column is the approximate count of sites having that designation. No sources are needed on this list since the count will more than likely appear on the main article for that designation, a requirement to be supported by this infobox. The final cell is a list of all callnames that can be used to call that designation. You can copy and paste the callnames from the main template, but be sure to separate them by semicolons instead of leaving the vertical pipes, and make sure not to leave them in all caps. After you have added the new row, save the page with the same edit summary used when you updated the main template.


Retrieved from "https://kobol.shoutwiki.com/w/index.php?title=Template:Designation/doc&oldid=7331"