Documentation:User Templates: Difference between revisions

From FSDeveloper Wiki
Jump to navigationJump to search
mNo edit summary
mNo edit summary
Line 4: Line 4:
Page requires expanding to include Page & Section framework templates.
Page requires expanding to include Page & Section framework templates.


= Page templates =
== Page templates ==
Placeholder text for 'Page templates'.
Placeholder text for 'Page templates'.


= Section templates =
== Section templates ==
Placeholder text for 'Section templates'.
Placeholder text for 'Section templates'.


= Transclusion templates =
== Transclusion templates ==
Transclusion code  is a special link which inserts the entire contents of a page into the calling page.
Transclusion code  is a special link which inserts the entire contents of a page into the calling page.


Line 21: Line 21:
A transclusion can call other transclusions, see the sample [[#Related Transclusion|Related Transclusion]] below.
A transclusion can call other transclusions, see the sample [[#Related Transclusion|Related Transclusion]] below.


== Transclusion templates - Samples ==
=== Transclusion templates - Samples ===
Transclusion templates for use in the Missions category.
Transclusion templates for use in the Missions category.


Line 29: Line 29:


----
----
=== Oneline Transclusion ===
==== Oneline Transclusion ====
Oneline, a single-line explanation of the topic.  
Oneline, a single-line explanation of the topic.  


Line 38: Line 38:
* As the first line in the section above the 'Contents' box.  
* As the first line in the section above the 'Contents' box.  


==== Useage ====
===== Useage =====
Used in the following page types or sections -
Used in the following page types or sections -
* Function Reference (Listing)
* Function Reference (Listing)
Line 45: Line 45:
* Related Internal
* Related Internal


==== Examples ====
===== Examples =====
See examples at -
See examples at -
* [[Transclusion-Missions-Oneline-Actions|Example Source]]
* [[Transclusion-Missions-Oneline-Actions|Example Source]]
Line 52: Line 52:
* [[Triggers#Internal|Example In Use]] - Triggers Related Internal links, first line.
* [[Triggers#Internal|Example In Use]] - Triggers Related Internal links, first line.


==== Code ====
===== Code =====
<pre>
<pre>
<!-- Paste the following line to required location -
<!-- Paste the following line to required location -
Line 61: Line 61:


----
----
=== Overview Transclusion ===
==== Overview Transclusion ====
Overview, a multi-line explanation of the topic.
Overview, a multi-line explanation of the topic.
Includes a 'More about TopicPageName...' link to the full-detail page.
Includes a 'More about TopicPageName...' link to the full-detail page.
Line 68: Line 68:
Should also be preceeded by the 'Oneline' transclusion.
Should also be preceeded by the 'Oneline' transclusion.


==== Useage ====
===== Useage =====
Used in the following page types or sections -
Used in the following page types or sections -
* FunctionType (Detail)
* FunctionType (Detail)
* FunctionName (Detail)
* FunctionName (Detail)


==== Examples ====
===== Examples =====
See examples at -
See examples at -
* [[Example In Use]]
* [[Example In Use]]
* [[Example Source]]
* [[Example Source]]


==== Code ====
===== Code =====
<pre>
<pre>
<!-- Paste the following line to required location -
<!-- Paste the following line to required location -
Line 90: Line 90:


----
----
=== SeeDetail Transclusion ===
==== SeeDetail Transclusion ====
SeeDetail, a user instruction to drill-down to next detail level.  
SeeDetail, a user instruction to drill-down to next detail level.  


Intended for placement as the last line in the section above the 'Contents' box.  
Intended for placement as the last line in the section above the 'Contents' box.  


==== Useage ====
===== Useage =====
Used in the following page types or sections -
Used in the following page types or sections -
* Any overview type page
* Any overview type page


==== Examples ====
===== Examples =====
See examples at -
See examples at -
* [[Example In Use]]
* [[Example In Use]]
* [[Example Source]]
* [[Example Source]]


==== Code ====
===== Code =====
<pre>
<pre>
<!-- Paste the following line to required location -
<!-- Paste the following line to required location -
Line 113: Line 113:


----
----
=== Related Transclusion ===
==== Related Transclusion ====
A transclusion can call other transclusions.
A transclusion can call other transclusions.


Line 128: Line 128:
On creating the transclusions, the list will display correctly.
On creating the transclusions, the list will display correctly.


==== Useage ====
===== Useage =====
Used in the following page sections -
Used in the following page sections -
* Related Internal
* Related Internal


==== Examples ====
===== Examples =====
See examples at -
See examples at -
* [[Transclusion-Missions-Related-Function_Types|Example Source]]
* [[Transclusion-Missions-Related-Function_Types|Example Source]]
* [[Triggers#Internal|Example In Use]] - This listing of related links is generated from multiple '[[#Oneline_Transclusion|Oneline]]' transclusions.
* [[Triggers#Internal|Example In Use]] - This listing of related links is generated from multiple '[[#Oneline_Transclusion|Oneline]]' transclusions.


==== Code ====
===== Code =====
<pre>
<pre>
<!-- Paste the following line to required location -
<!-- Paste the following line to required location -
Line 149: Line 149:
</pre>
</pre>


== Transclusion templates - Creating ==
=== Transclusion templates - Creating ===
Detail here.
Detail here.


Line 158: Line 158:
This allows editors to easily copy & paste the wikicode directly into their required content page.
This allows editors to easily copy & paste the wikicode directly into their required content page.


== Transclusion templates - Applying ==
=== Transclusion templates - Applying ===
As per all wiki internal links, creating a link in a page, then clicking that link will take you to that page, (or editor window).
As per all wiki internal links, creating a link in a page, then clicking that link will take you to that page, (or editor window).


Line 169: Line 169:
{{:Transclusion-Missions-SeeDetail}}
{{:Transclusion-Missions-SeeDetail}}


== Transclusion templates - Editing Content ==
=== Transclusion templates - Editing Content ===
Editing a page containing a transclusion, will not display the content text, just the calling wikicode.
Editing a page containing a transclusion, will not display the content text, just the calling wikicode.
<br>
<br>

Revision as of 18:01, 27 January 2008

This page contains a list of templates available on this site for use in wiki pages.

Page requires expanding to include Page & Section framework templates.

Page templates

Placeholder text for 'Page templates'.

Section templates

Placeholder text for 'Section templates'.

Transclusion templates

Transclusion code is a special link which inserts the entire contents of a page into the calling page.

Transclusions allows use of single-source 'boilerplate text' to be replicated across multiple pages.
Generally these should be standalone, uncategorised, pages, containing just the core text.

Most useful for 'Function Reference' listings pages, and their matching detail pages.

A transclusion can call other transclusions, see the sample Related Transclusion below.

Transclusion templates - Samples

Transclusion templates for use in the Missions category.

NB
TopicPageName, in the code samples below, is a 'placeholder title' for your page's title.


Oneline Transclusion

Oneline, a single-line explanation of the topic.

Has multiple uses, primarily intended for placement wherever the briefest description is required.
e.g.

  • Listings of related pages.
  • As the first line in the section above the 'Contents' box.
Useage

Used in the following page types or sections -

  • Function Reference (Listing)
  • FunctionType (Detail)
  • FunctionName (Detail)
  • Related Internal
Examples

See examples at -

Code
<!-- Paste the following line to required location -
{{:Transclusion-Missions-Oneline-TopicPageName}}
 -->
'''[[TopicPageName]]''' oneline, a single-line explanation of the topic. 

Overview Transclusion

Overview, a multi-line explanation of the topic. Includes a 'More about TopicPageName...' link to the full-detail page.

Intended for placement in section above the 'Contents' box. Should also be preceeded by the 'Oneline' transclusion.

Useage

Used in the following page types or sections -

  • FunctionType (Detail)
  • FunctionName (Detail)
Examples

See examples at -

Code
<!-- Paste the following line to required location -
{{:Transclusion-Missions-Overview-TopicPageName}}
 -->
'''[[TopicPageName]]''' overview, a multi-line explanation of the topic.

More blurb here.
<div style="text-align:right;margin-right:10px;margin-bottom:4px;">'''[[TopicPageName|More about TopicPageName...]]'''</div>

SeeDetail Transclusion

SeeDetail, a user instruction to drill-down to next detail level.

Intended for placement as the last line in the section above the 'Contents' box.

Useage

Used in the following page types or sections -

  • Any overview type page
Examples

See examples at -

Code
<!-- Paste the following line to required location -
{{:Transclusion-Missions-SeeDetail}}
 -->
This is an overview page. For expanded detail click the topic links below.

Related Transclusion

A transclusion can call other transclusions.

Pre-assembled lists of related page 'oneline' transclusions.

For replication across all related pages in a detail 'level'.

NB
When initially created, if the transclusions do not exist yet, the list may appear as a string of links.
Do not double-space the list to force the display.
On creating the transclusions, the list will display correctly.

Useage

Used in the following page sections -

  • Related Internal
Examples

See examples at -

Code
<!-- Paste the following line to required location -
{{:Transclusion-Missions-Related-TopicPageName}}
 -->
{{:Transclusion-Missions-Oneline-TopicPageName}}
{{:Transclusion-Missions-Oneline-TopicPageName}}
{{:Transclusion-Missions-Oneline-TopicPageName}}
{{:Transclusion-Missions-Oneline-TopicPageName}}
{{:Transclusion-Missions-Oneline-TopicPageName}}

Transclusion templates - Creating

Detail here.

Naming convention.

The comment section should always be left in place in the transclusion page.
This allows editors to easily copy & paste the wikicode directly into their required content page.

Transclusion templates - Applying

As per all wiki internal links, creating a link in a page, then clicking that link will take you to that page, (or editor window).

e.g. Pasting the following code into your page -

{{:Transclusion-Missions-SeeDetail}}

Gives the following output -

This is an overview page. For expanded detail click the topic links below.

Transclusion templates - Editing Content

Editing a page containing a transclusion, will not display the content text, just the calling wikicode.
Look beneath the edit window, you'll see a list of links to all the 'templates' called in that page.
Clicking those links allows direct editing of the transclusion's content.
Editing the transclusion page itself, will cause text on every calling page to display the applied changes.