I don't need to test my programs. I have an error-correcting modem.

Difference between revisions of "Unreal Wiki:Layout guidelines"

From Unreal Wiki, The Unreal Engine Documentation Site
Jump to: navigation, search
m (1 revision(s))
(all types of pages I can think of right now, most likely incomplete)
Line 1: Line 1:
This page will help you find pages that have been developed enough to warrant them being used as examples for further new pages in the same general category they are in. For example, you would look at [[DM-TrainingDay]] to see the general layout for a map page.
+
This page will help you find pages that have been developed enough to warrant them being used as examples for further new pages in the same general category they are in. For example, you would look at [[Add an Actor]] to see the general layout for a [[basic procedure]] page.
__TOC__
+
 
 
==Game Pages==
 
==Game Pages==
Example game pages: [[Unreal]], [[Unreal Tournament]], [[Unreal Tournament 2004]], [[Unreal Tournament 3]]
+
Example game pages: [[Unreal Tournament]], [[Unreal Tournament 2004]], [[Unreal Tournament 3]]
  
 
Game pages have a very simple layout and flow that we would like to keep consistent. If you need to add additional subsections, place them under a heading that makes the most sense. If you want to add a new section to an already created game page, please post in the Discussion page about it.
 
Game pages have a very simple layout and flow that we would like to keep consistent. If you need to add additional subsections, place them under a heading that makes the most sense. If you want to add a new section to an already created game page, please post in the Discussion page about it.
  
==Map Pages==
+
==Tutorial Pages==
Example map pages: [[DM-TrainingDay]], [[CTF-Maul]], [[DOM-Sepukku]], [[ONS-Torlan]], [[AS-Convoy]]
+
Example tutorial pages: ''TODO''
 
+
Map pages have different layouts depending upon the gametype the apply to. Make sure that you check out one of the example pages for the gametype you are working on before starting a new page for a map in that gametype. In the case where a particular gametype does not have any example maps created, please layout the pages like a gametype that is similar to the one you are creating pages for. For example, the main layout of a [[UT]] [[Domination]] map is going to be very similar to the layout for a [[UT2004]] [[Double Domination|DDOM]] map.
+
 
+
==Single Player Walkthrough Pages==
+
Example pages: [[Vortex Rikers]], [[NyLeve's Falls]]
+
  
Walkthrough pages do not have to follow any specific guidelines as far as page creation goes. They can include images or not, they can be formatted in any way that makes sense. The only guidelines that we have for them is to make sure that links to next and previous map are included (if necessary) such as in the examples above. We also would ask that all walkthrough pages for a particular game are written in a similar format to one another. For example, the [[Rrajigar Mine]] page should not look drastically different from the [[Vortex Rikers]] page, having the translator messages separated from the actual walkthrough.
+
Tutorial pages do not have to follow any specific guidelines as far as page creation goes. They can include images or not, they can be formatted in any way that makes sense. A tutorial page that is part of a series of tutorials should include links to the next and previous tutorial in the series and, if applicable, to the overview page of that tutorial series. All pages of a tutorial series should have a similar format to one another. For example in a tutorial series about creating a Warfare map, the part that covers setting up the power nodes should not look drastically different from the part covering special objectives.
  
==Weapon Pages==
+
==Basic Procedure Pages==
Example weapon pages: [[Bio Rifle]], [[Shock Rifle]]
+
Example basic procedure pages: [[Add an Actor]], [[Create a subclass]]
  
Weapon pages all have a very similar layout. The most important thing to remember on these pages is that the main section headers are always the games in which the weapons appear. For example, the [[Bio Rifle]] page has headers for [[Unreal]], [[Unreal Tournament]], [[UT2003]], [[Unreal Championship]], [[UT2004]] and [[Unreal Championship 2]].
+
Basic procedure pages all have a similar layout. If there are several different ways to do things, the page should contain a main section header for each of them. Also, if procedures differ significantly between games, each game should get its own section.
  
==Gametype Pages==
+
==UnrealScript API Pages==
Example gametype pages: [[Onslaught]], [[Capture The Flag]]
+
Example class pages: [[Actor]], [[Projectile]], [[Light]]
  
Gametype pages always have an inconsistent layout because every gametype is different. If you are adding a new gametype page, please use your best judgment in order to provide a layout that makes sense for the gametype in question.
+
UnrealScript class pages have a mostly similar layout. Class members are grouped by the kind of member, for example variables, functions and states, with members being sorted alphabetically or, in the case of operators, by precedence. If it makes sense, variables and functions may be further divided. For example in classes with lots of variables that are mainly used in the editor, it makes sense to divide variables into their property groups, while in classes that are mainly used by programmers it might make more sense to separate localized, configurable or unmodifiable variables. Similarly it might make sense to separate functions into static functions, native functions, events, and so on.

Revision as of 16:39, 17 February 2008

This page will help you find pages that have been developed enough to warrant them being used as examples for further new pages in the same general category they are in. For example, you would look at Add an Actor to see the general layout for a basic procedure page.

Game Pages

Example game pages: Unreal Tournament, Unreal Tournament 2004, Unreal Tournament 3

Game pages have a very simple layout and flow that we would like to keep consistent. If you need to add additional subsections, place them under a heading that makes the most sense. If you want to add a new section to an already created game page, please post in the Discussion page about it.

Tutorial Pages

Example tutorial pages: TODO

Tutorial pages do not have to follow any specific guidelines as far as page creation goes. They can include images or not, they can be formatted in any way that makes sense. A tutorial page that is part of a series of tutorials should include links to the next and previous tutorial in the series and, if applicable, to the overview page of that tutorial series. All pages of a tutorial series should have a similar format to one another. For example in a tutorial series about creating a Warfare map, the part that covers setting up the power nodes should not look drastically different from the part covering special objectives.

Basic Procedure Pages

Example basic procedure pages: Add an Actor, Create a subclass

Basic procedure pages all have a similar layout. If there are several different ways to do things, the page should contain a main section header for each of them. Also, if procedures differ significantly between games, each game should get its own section.

UnrealScript API Pages

Example class pages: Actor, Projectile, Light

UnrealScript class pages have a mostly similar layout. Class members are grouped by the kind of member, for example variables, functions and states, with members being sorted alphabetically or, in the case of operators, by precedence. If it makes sense, variables and functions may be further divided. For example in classes with lots of variables that are mainly used in the editor, it makes sense to divide variables into their property groups, while in classes that are mainly used by programmers it might make more sense to separate localized, configurable or unmodifiable variables. Similarly it might make sense to separate functions into static functions, native functions, events, and so on.