మూస:Adjacent communities/doc పేజీ సోర్సు చూడండి

{{Documentation subpage}}
<!--Categories where indicated at the bottom of this page, please; interwikis at Wikidata (see [[Wikipedia:Wikidata]])-->
{{High-use| 23518 | Wikipedia talk:High-risk templates }}
{{Lua|Module:Navbox|Module:Check for unknown parameters}}

== Usage ==
<pre>
{{Adjacent communities
 | Centre    = 
 | North     = 
 | Northeast = 
 | East      = 
 | Southeast = 
 | South     = 
 | Southwest = 
 | West      = 
 | Northwest = 
}}
</pre>

Or:
<pre>
{{Adjacent communities
 | Centre = 
 | N  = 
 | NE = 
 | E  = 
 | SE = 
 | S  = 
 | SW = 
 | W  = 
 | NW = 
}}
</pre>

This template provides for a convenient compass-based navigational aid for articles about communities. It allows you to display the communities surrounding the subject of your article. 

While this template may be useful for cities, it certainly is redundant for continents, countries and other large geographical areas like states, provinces and islands. In the lead paragraphs of those types of articles, all surrounding countries and features are invariably stated and linked and there's usually a map in the infobox too.

The only required field is {{para|Centre}}; the template defaults to an "(enter location)" in the centre of the box message if nothing is entered here (see note below).  The fields {{para|Northwest}} ({{para|NW}}), {{para|North}} ({{para|N}}), {{para|Northeast}} ({{para|NE}}), {{para|West}} ({{para|W}}), {{para|East}} ({{para|E}}), {{para|Southwest}} ({{para|SW}}), {{para|South}} ({{para|S}}), and {{para|Southeast}} ({{para|SE}}) are optional. They will be hidden when not used; when values are entered for the relevant parameters, the fields will automatically appear. (Normal Wiki markup can be used in the fields, such as links, colours, and bold/italics.)

The template is coded to handle the American spelling "center". It first looks for a value in {{para|Centre}}, then in {{para|Center}}; it defaults to the "(enter location)" message if both are left blank.

=== How to use and not use this template ===
In order to ensure consistent usage, the following guidelines apply:
* This template is for {{em|immediately adjacent}} places only.
* Use same-level jurisdictions or equivalent in the directional fields as in the centre. For instance, when using this template for a municipality, show adjacent municipalities; when using it for unincorporated places, show adjacent unincorporated communities; etc.
* When a municipality borders an international, provincial, or state boundary, try to use a municipality in that adjacent jurisdiction rather than the jurisdiction itself.
* Geographical features such as oceans, rivers, lakes, and mountains should be in ''italics'' to differentiate them. But this should only be used sparingly for major defining features, in particular if there is no adjacent jurisdiction (e.g. sea, lake, etc.).
* Avoid cluttering the template with too much detail; it is a navigational guide to provide links to adjacent locations, not a map.
* Don't use flag icons for every link, see [[MOS:INFOBOXFLAG]]. They don't add value and are unnecessarily distracting.

=== Placement in article ===
*[[WP:LAYOUTNAV]] specifies that navboxes, including geography boxes such as this one, are placed after the "External links" section (i.e., immediately before categories; they should also be placed after [[WP:Stub|stub]] templates).

=== Examples ===
Here is an example for [[Ottawa]] (capital of Canada) demonstrating the guidelines above:

<pre>
{{Adjacent communities
 | Centre    = Ottawa
 | North     = [[Pontiac, Quebec|Pontiac]], [[Gatineau]] ([[Quebec]])<br/>''[[Ottawa River]]''
 | Northeast = [[Lochaber-Partie-Ouest, Quebec|Lochaber-Partie-Ouest]] ([[Quebec]])<br/>''[[Ottawa River]]''
 | East      = [[Clarence-Rockland, Ontario|Clarence-Rockland]]
 | Southeast = [[Russell, Ontario|Russell]], [[The Nation, Ontario|The Nation]]
 | South     = [[North Grenville, Ontario|North Grenville]], [[North Dundas, Ontario|North Dundas]]
 | Southwest = [[Merrickville-Wolford, Ontario|Merrickville-Wolford]]
 | West      = [[Mississippi Mills, Ontario|Mississippi Mills]]<br/>[[Beckwith, Ontario|Beckwith]]<br/>[[Montague, Ontario|Montague]]
 | Northwest = [[Arnprior, Ontario|Arnprior]]
}}
</pre>

produces:
{{Adjacent communities
 | Centre    = Ottawa
 | North     = [[Pontiac, Quebec|Pontiac]], [[Gatineau]] ([[Quebec]])<br/>''[[Ottawa River]]''
 | Northeast = [[Lochaber-Partie-Ouest, Quebec|Lochaber-Partie-Ouest]] ([[Quebec]])<br/>''[[Ottawa River]]''
 | East      = [[Clarence-Rockland, Ontario|Clarence-Rockland]]
 | Southeast = [[Russell, Ontario|Russell]], [[The Nation, Ontario|The Nation]]
 | South     = [[North Grenville, Ontario|North Grenville]], [[North Dundas, Ontario|North Dundas]]
 | Southwest = [[Merrickville-Wolford, Ontario|Merrickville-Wolford]]
 | West      = [[Mississippi Mills, Ontario|Mississippi Mills]]<br/>[[Beckwith, Ontario|Beckwith]]<br/>[[Montague, Ontario|Montague]]
 | Northwest = [[Arnprior, Ontario|Arnprior]]
}}


Not all directions necessarily need to be filled.

<pre>
{{Adjacent communities
 | Centre = Knokke-Heist
 | N = ''[[North Sea]]''
 | E = [[Sluis]] ([[Netherlands|NL]]-[[Zeeland|ZE]])
 | S = [[Damme]]
 | W = [[Bruges]]
}}
</pre>

produces:
{{Adjacent communities
 | Centre = Knokke-Heist
 | N = ''[[North Sea]]''
 | E = [[Sluis]] ([[Netherlands|NL]]-[[Zeeland|ZE]])
 | S = [[Damme]]
 | W = [[Bruges]]
}}

== Optional parameters ==
===Title===
The default title is "Places adjacent to <nowiki>{{PAGENAME}}</nowiki>". To override this, an optional title can be added; use {{para|title}}. This is particularly useful where 2 boxes are needed. For example, {{para|title|Eastern part {{nobold|(includes the poblacion)}}}} produces:

{{Adjacent communities
 | title     = Pakil – Eastern part {{nobold|(includes the poblacion)}}
 | Centre    = Pakil
 | North     = [[Pangil, Laguna|Pangil]]
 | East      = [[Real, Quezon]]
 | South     = [[Paete, Laguna|Paete]]
 | West      = ''[[Laguna de Bay]]''
}}
{{Adjacent communities
 | title     = Pakil – Western part {{nobold|(includes barangays Banilan, Kabulusan, Casa Real, Casinsin, Dorado, Matikiw)}}
 | Centre    = Pakil
 | North     = [[Mabitac, Laguna|Mabitac]] / [[Pangil, Laguna|Pangil]]
 | East      = ''[[Laguna de Bay]]''
 | South     = [[Jalajala, Rizal]]
 | West      = [[Jalajala, Rizal]]
 | Northwest = [[Pililla, Rizal]]
}}

=== Width (nesting/floating box) ===
By default, the width of the geographic location box is 100%, and is forced to clear below any left or right floating elements. To allow the box to position next to an infobox, image, or other floating element, enter {{para|width|auto}} on the first line.
{{Infobox
 | above = Example infobox
 | label1 = Label
 | data1 = Data
 | label2 = Label
 | data2 = Data
 | label3 = Label
 | data3 = Data
}}

{{Adjacent communities|width=auto
 | Centre    = Ottawa
 | North     = [[Pontiac, Quebec|Pontiac]], [[Gatineau]] ([[Quebec]])<br/>''[[Ottawa River]]''
 | Northeast = [[Lochaber-Partie-Ouest, Quebec|Lochaber-Partie-Ouest]] ([[Quebec]])<br/>''[[Ottawa River]]''
 | East      = [[Clarence-Rockland, Ontario|Clarence-Rockland]]
 | Southeast = [[Russell, Ontario|Russell]], [[The Nation, Ontario|The Nation]]
 | South     = [[North Grenville, Ontario|North Grenville]], [[North Dundas, Ontario|North Dundas]]
 | Southwest = [[Merrickville-Wolford, Ontario|Merrickville-Wolford]]
 | West      = [[Mississippi Mills, Ontario|Mississippi Mills]]<br/>[[Beckwith, Ontario|Beckwith]]<br/>[[Montague, Ontario|Montague]]
 | Northwest = [[Arnprior, Ontario|Arnprior]]
}}

===Expansion state===
Use {{para|state|expanded}} to force the box to the expanded state, or {{para|state|collapsed}} to hide it.

{{Adjacent communities|width=auto|state=expanded
 | Centre = Self
 | N     = Northern neighbour
 | E     = Eastern neighbour
 | S     = Southern neighbour
 | W     = Western neighbour
}}

== Tracking category ==
* {{clc|Pages using adjacent communities with unknown parameters}}
* {{clc|Pages using adjacent communities with added directions}}

<includeonly>{{Sandbox other||
<!--Categories below this line, please; interwikis at Wikidata-->
[[Category:Geography and place navigational boxes]]
[[Category:Templates that add a tracking category]]
}}</includeonly>