Difference between revisions of "StyleGuide"

From GRFSpecs
Jump to navigationJump to search
(more details)
m (→‎Links: typo)
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
Pages in the NewGRF specs wiki should try to follow a common style. Headings are as follows:
 
Pages in the NewGRF specs wiki should try to follow a common style. Headings are as follows:
   
  +
Note: section headings are indicated by == otherwise they have the same size as the page title
= Action0 pages =
 
  +
  +
== Links ==
  +
* Use the "ttwiki:" prefix for interwiki links to [[ttwiki:Main_Page|TT-Wiki]].
  +
* Use the "ottdwiki:" prefix for interwiki links to [[ottdwiki:Main_Page|OpenTTD-Wiki]].
  +
 
== Action0 pages ==
 
<pre>
 
<pre>
=Introduction=
+
==Introduction==
 
One to three sentences for summary.
 
One to three sentences for summary.
   
=Properties=
+
==Properties==
 
{|
 
{|
!Property !!Version !!Size !! Description
+
!Property !!Version !![[GRFActionsDetailed|Size]] !! Description
 
|-
 
|-
 
|01 || ||B ||Short summary 1
 
|01 || ||B ||Short summary 1
Line 19: Line 25:
 
|}
 
|}
   
=Description=
+
==Description==
  +
===Property 1 name (01)===
Detailed description.
 
  +
Detailed Description
  +
  +
===Property 2 name (02)===
 
Detailed description
  +
  +
===Property N name (0xN)===
 
Detailed description
   
=Example=
+
==Example==
General example for the action, not specific to the a single property.
+
General example for the action, not specific to the a single property. Lines are ALL indented by a single space at least
  +
-1 * 0 00 00 \b3 01 \b*2 // \b<number of props to change> \b*<vehicle ID>
  +
09 \w192 // value for speed (192 km/h)
  +
0B \w3800 // value for power (3800 hp)
  +
12 FD // use new graphics
 
</pre>
 
</pre>
   
= VarAction2 pages =
+
== VarAction2 pages ==
 
<pre>
 
<pre>
=Introduction=
+
==Introduction==
 
One to three sentences for summary.
 
One to three sentences for summary.
   
=Variables=
+
==Variables==
 
{|
 
{|
!Variable !!Version !!Size !! Description
+
!Variable !!Version !![[GRFActionsDetailed|Size]] !! Description
 
|-
 
|-
 
|01 || ||B ||Short summary 1
 
|01 || ||B ||Short summary 1
Line 44: Line 61:
 
|}
 
|}
   
=Description=
+
==Description==
  +
===Variable 1 name (01)===
Detailed description.
 
  +
Detailed Description
  +
  +
===Variable 2 name (02)===
  +
Detailed description
  +
  +
===Variable N name (0xN)===
  +
Detailed description
   
=Example=
+
==Example==
 
General example for the action, not specific to the a single variable.
 
General example for the action, not specific to the a single variable.
 
</pre>
 
</pre>
   
= Other pages =
+
== Other pages ==
 
<pre>
 
<pre>
=Introduction=
+
==Introduction==
 
One to three sentences for summary.
 
One to three sentences for summary.
   
=Syntax=
+
==Syntax==
 
Formal syntax definition, including a table with summaries for the variable parts of it.
 
Formal syntax definition, including a table with summaries for the variable parts of it.
   
=Description=
+
==Description==
 
Detailed description.
 
Detailed description.
   
=Example=
+
==Example==
 
General example for the action.
 
General example for the action.
 
</pre>
 
</pre>
  +
  +
== See also == <!-- TTWiki links to be removed when this wiki develops an extended StyleGuide -->
  +
*[[ttwiki:LocalStyleGuide | TTWiki LocalStyleGuide (from TTDPatch Wiki)]]
  +
*[[ttwiki:Manual of Style | TTWiki Manual of Style]]

Latest revision as of 22:11, 22 July 2011

Pages in the NewGRF specs wiki should try to follow a common style. Headings are as follows:

Note: section headings are indicated by == otherwise they have the same size as the page title

Links

  • Use the "ttwiki:" prefix for interwiki links to TT-Wiki.
  • Use the "ottdwiki:" prefix for interwiki links to OpenTTD-Wiki.

Action0 pages

==Introduction==
One to three sentences for summary.

==Properties==
{|
!Property !!Version !![[GRFActionsDetailed|Size]] !! Description
|-
|01 || ||B ||Short summary 1
|-
|02 || ||W ||Short summary 2
|-
|03 || ||D ||Short summary 3
|-
|04 || ||B/B* ||Short summary 4
|}

==Description==
===Property 1 name (01)===
Detailed Description

===Property 2 name (02)===
Detailed description

===Property N name (0xN)===
Detailed description

==Example==
General example for the action, not specific to the a single property. Lines are ALL indented by a single space at least
 -1 * 0 00 00 \b3 01 \b*2 // \b<number of props to change> \b*<vehicle ID>
     09 \w192 // value for speed (192 km/h)
     0B \w3800 // value for power (3800 hp)
     12 FD // use new graphics

VarAction2 pages

==Introduction==
One to three sentences for summary.

==Variables==
{|
!Variable !!Version !![[GRFActionsDetailed|Size]] !! Description
|-
|01 || ||B ||Short summary 1
|-
|02 || ||W ||Short summary 2
|-
|03 || ||D ||Short summary 3
|-
|04 || ||B/B* ||Short summary 4
|}

==Description==
===Variable 1 name (01)===
Detailed Description

===Variable 2 name (02)===
Detailed description

===Variable N name (0xN)===
Detailed description

==Example==
General example for the action, not specific to the a single variable.

Other pages

==Introduction==
One to three sentences for summary.

==Syntax==
Formal syntax definition, including a table with summaries for the variable parts of it.

==Description==
Detailed description.

==Example==
General example for the action.

See also