Difference between revisions of "Template:Intro"

From Audacity Wiki
Jump to: navigation, search
(Suggest lighter grey border since Intro* templates have a darker colour than the other templates. This colour would work with other templates if same colour is a must.)
(edit to match the Manual intro template)
Line 56: Line 56:
 
''Ignore the following, it's only a representation of formatting and a parameter dummy.''
 
''Ignore the following, it's only a representation of formatting and a parameter dummy.''
 
</noinclude>
 
</noinclude>
{| style="background:#EEEEFF;border:1px solid #C9C0BB" cellpadding="10px" width=90% align="center"
+
<div style="margin:24px">
 +
{| style="background:#DFEAF9;border:1px solid black; padding-left:12px; padding-right:12px" width="100%" align="center"
 
|-
 
|-
|{{{1}}}
+
|align="left" valign="top"|{{{1}}}
{| style="margin-left:2em;margin-right:1.2em;background:#EEEEFF;font-style:italic"  cellpadding="5px"
+
{| style="margin-left:2em;margin-right:1.2em;background:#DFEAF9;font-style:italic"  cellpadding="5px"
|{{{2}}}  
+
|{{{2}}}
 
|}
 
|}
 
|}
 
|}
 +
</div>

Revision as of 14:35, 2 May 2012

The Intro Template formats text inside a standard introductory blue header, just like this one.


Note: An alternative variant of this template called Introrel is also available. This additionally places a bulleted, indented list of related articles underneath the blue header.


Purpose

  • This template formats text inside a standardised "introduction" header box with blue background. The text should be placed at the top of the page and should provide a concise summary (preferably in one or two sentences) of the overall content of the page. If a second paragraph is needed, you can use ENTER on the keyboard to create one, just as in normal editing.
  • A subsequent string of text can be added that will be displayed below the first, and emphasised with italicised text indented at left and right margins. This can be useful when any particular point needs to be made, such as explaining what aspects are not covered in the page text.


Usage of Intro Template

General usage:

{{Intro| Text to be displayed standard | Text to be displayed emphasised }}


Alternative:

If all the text is to be displayed without emphasis, you still need to supply the second pipe symbol "|" , so that after your unemphasised text, the template is closed with   :

{{Intro| Text to be displayed standard |}}


Note that if the pipe symbol is missing, only a dummy parameter will be displayed instead of your intended text.


Style and abbreviations

As the introduction is the first thing the reader sees, the header should be written in full English with no abbreviations such as "viz" or "e.g.". If a technical abbreviation is necessary, a link to explanatory text must be provided.

If either the standard or emphasised text must contain the equals sign "=" , then the text after the pipe must be enclosed inside </nowiki> tags:

{{Intro|<nowiki>This page explains why "2 + 2 = 4" is correct.</nowiki>|}}


Similarly, if other essential symbols in the text cause the text to display incorrectly, try enclosing the text inside </nowiki> tags.


Example:

Typing this:

{{Intro|OGG is strictly an open, free container format for digital multimedia, but the term is commonly used to refer to the high-quality lossy compressed audio file format known as OGG Vorbis.|<nowiki>Please note: if encoding at the command line, " filename = %f " must not be used.</nowiki>}}


will produce this:

OGG is strictly an open, free container format for digital multimedia, but the term is commonly used to refer to the high-quality lossy compressed audio file format known as OGG Vorbis.
Please note: if encoding at the command line, " filename = %f " must not be used.

Ignore the following, it's only a representation of formatting and a parameter dummy.

{{{1}}}
{{{2}}}