Template:Guideline/doc

This is a documentation subpage for . It contains usage information, categories and other content that is not part of the original template page.

This template is still in development This template will implement a guideline on a page.

Syntax

{{ Guideline |  <address>  }}

• Current location of page = Guideline
• address = <address>
• common guideline = [[Common/Guideline/<address>]] (Status = no)
• region guideline = [[Guideline/Guideline/<address>]] (Status = no)
• action = Don't display the guideline

<address> could be:
   Segments/Length/Minimum
   Segments/Length/Maximum
   ...

Guideline Address

The guideline is defined by an address. For indexing purposes, the address may consist of different levels, separated with slashes (/). For further explanation, I'll call this the <address>

Roads/Country

Guideline Region

The Region of the guideline is where the guideline is applied. Examples of regions:

Benelux
Belgium
USA
...

There is one special Region that defines the default or general guideline. The name of this Special Region still needs to be defined. For further explanation, I'll call this special region the Common region

How it should work

{{ guideline | <address> }}

The guideline works out on which page it is transcluded. From the page name it will derive the base page name as the region where it is used. For further explanation, I'll call this as <region>

Benelux/Roads/anothersubpage
-> <Region> is here Benelux

The template will try to find the following pages:

[[<Region>/Guidelines/<address>]]
[[Common/Guidelines/<address>]]

If a page is empty (Blanked), the page is considered as not found.

If there is only the Common page (witch should occurs in most of the time), the content of the Common/Guidelines/<address> page is transcluded.

If you want to overwrite the guideline, the page <Region>/Guidelines/<address> is created (contains content). In this case, the content of the Common/Guidelines/<address> page is transcluded in small print and with strike through. Followed by the content of the <Region>/Guidelines/<address> page.

A method of adding content to a guideline is not yet determined. A possible method could be transcluding the Common/Guidelines/<address> page on to the <Region>/Guidelines/<address> page. If this could be detected, it is potentially the best solution. If not, this will result in the content of the Common/Guidelines/<address> page being placed twice, first strike through and then as normal.

Where is this templated used

This template is used on general pages about a <Subject> like roads / highways / Landmarks ...

This pages are located under Common/<Subject> and make use of the Template:Guideline.

Regions can then import these paged by creating a page called: <Region>/<Subject> and the content will be transcluding the Common/<Subject> page.

content of page <Region>/<Subject>:
{{:Common/<Subject>}}

This results in an immediate update on the region pages if the common page is updated so regions will be up to date when new guidelines are added.

Other examples on the web of advanced template useage

Take a look at the sourcecode of one of the following pages:

http://wiki.cyanogenmod.org/w/Hammerhead_Info?setlang=en
http://wiki.cyanogenmod.org/index.php?title=Install_CM_for_hammerhead&action=edit&setlang=en