Create account / Log in
Page Discussion History

How to Create a Module Page

From VASSAL

Jump to: navigation, search

Overview

Each VASSAL module has its own page in the Modules namespace here on the VASSAL Wiki. There are four steps to creating a module page:

  1. Start a new page for the module.
  2. Copy the module page template to your new module page.
  3. Fill in the details for your module.
  4. Upload your module.

This tutorial will walk you through each step.

Please note that many of the steps described here require you to be logged in to the site to do them. If you are following the tutorial but are not logged in, log in now.

Start a new page

There are several ways to start a new page; the most straightforward one is to type "Module:", followed by the name of the game for which you are creating a module, in the wiki's search box on the left. Then click the "Go" button. (Note: The "Module:" preceding the name of the game is a namespace. Namespaces help separate types of content in our wiki.)

The search box

This will take you to a "Search results" page. If there really is no page for your module, you'll see the link "create this page", circled in green in the screenshot below.

The "create this page" link

After clicking the link, you will be taken to a page where you can begin editing.

Edit the new page

Proceed to the next section, where we will begin to fill in the module page.

Copy the module page template

All VASSAL module pages follow a set style in order to make it easy for users to locate the information they need and to give our module pages a uniform appearance. Creating a module page from scratch is a fair amount of typing, so we provide a template for you to copy:

{{GameInfo|image=|publisher=|year=|era=|topic=|series=|scale=|players=|length=}}

== Files ==
{{ModuleFilesTable}}
{{ModuleVersion|version=}}
{{ModuleFile|filename=|description=|date=|size=|compatibility=}}
|}

== Module Information ==
{{ModuleContactInfo|maintainer=|contributors=}}

== Comments ==

== Screen Shots ==
<gallery heights=200px widths=300px perrow=3>
</gallery>

== Players ==
<div style="column-count: 4; -moz-column-count: 4; -webkit-column-count: 4">
* {{email|someguy@example.com|Some Guy}}
</div>

__NOTOC__

Select the template text and paste it into the text area on the editing page. Then, click the "Show Preview" button below the editing area.

Show preview button

You should now see a skeletal version of your module page previewed above the editing area. Proceed to the next section, where we will describe what each element in the template does and how to fill in the details for your module.

Fill in Your Module Details

In this section, we will walk you through adding the information for your module to the module page template. We will make frequent use of wiki markup. For more details on wiki markup see Help:Formatting.

Module pages are divided into sections marked by level-2 headings: == Heading ==. (Level-2 headings correspond to the <h2> element in HTML.) If you look at the module page template, you'll see headings for "Files", "Module Information", "Screen Shots", and "Players":

{{GameInfo|image=|publisher=|year=|era=|topic=|series=|scale=|players=|length=}}

== Files ==
{{ModuleFilesTable}}
{{ModuleVersion|version=}}
{{ModuleFile|filename=|description=|date=|size=|compatibility=}}
|}

== Module Information ==
{{ModuleContactInfo|maintainer=|contributors=}}

== Comments ==


== Screen Shots ==
<gallery heights=200px widths=300px perrow=3>

</gallery>

== Players ==
<div style="column-count: 4; -moz-column-count: 4; -webkit-column-count: 4">
* {{email|someguy@example.com|Some Guy}}
</div>

__NOTOC__

These headings divide the module page into sections. Above the "Files" section is the markup which produces an information box for your module.

The Module Information Box

Here we will look at the module information box one piece at a time. The module information box is produced by a MediaWiki template. Templates define text which will be included into a page when it is rendered. The syntax for templates is {{Name|arg1=val1|...|argn=valn}}, where Name is the name of the template, arg1 to argn are named arguments, and val1 to valn are the values of those arguments. Argument-value pairs are separated from the template name and from each other by the pipe character ("|").

The template which produces the module information box is called GameInfo, and takes the following arguments:

image
the name of the image to display, image to be no taller than 150 pixels
publisher
the publisher of the game Current Publisher list
year
the year the game was published
era
the historical era the game covers, if applicable. Defined Era examples
topic
the topic the game covers, if applicable. Defined Topic examples
series
the series the game is part of, if applicable
scale
the scale of the game, if applicable. Defined Scale examples
players
the number of players the game accomodates
length
the minimum length of the game in minutes it takes to play the board game


Now, an example: The module for The Longest Day uses this code

{{GameInfo|image=TLD.jpg|publisher=Avalon Hill|year=1980|era=WWII|topic=Normandy
Invasion|scale=operational|players=2+|length=long}}

which produces this info box:

TLD.jpg
Publisher Avalon Hill]] Era WWII
Year 1980 Topic Western Front
Players 2+ Scale Operational
Length 240 min

Notice that the series isn't specified here; series is an optional argument, since not every game is part of a series. The GameInfo template automatically adds your module page to the Modules category, as well as the categories for the game's publisher, era, and topic.

The Files Section

This section of the module page contains the table listing files available for download. The code for this section consists of four parts, seen here:

{{ModuleFilesTable}}
{{ModuleVersion|version=}}
{{ModuleFile|filename=|description=|date=|size=|compatibility=}}
|}

The parts:

  1. The ModuleFilesTable template creates the table header.
  2. The ModuleVersion template creates a table row which specifies the module version for the files appearing in subsequent rows.
  3. The ModuleFile template creates a row containing information about a file and a link for downloading it.
  4. The final |} ends the table.

An example: The following code

{{ModuleFilesTable}}
{{ModuleVersion|version=1.1}}
{{ModuleFile|filename=battle_of_example-1.1.vmod|description=module|date=2010-08-03|compatibility=3.1}}
{{ModuleVersion|version=1.0}}
{{ModuleFile|filename=battle_of_example-1.0.vmod|description=module|date=2009-10-10|compatibility=3.0}}
{{ModuleFile|filename=battle_of_example-maps-1.0.vmdx|description=extra maps|date=2009-10-10|compatibility=3.0}}
|}

produces this table of files:

Filename Filetype Size Date Compatibility
1.1
battle_of_example-1.1.vmod module "battle_of_example-1.1.vmod" does not exist 2010-08-03 3.1
1.0
battle_of_example-1.0.vmod module "battle_of_example-1.0.vmod" does not exist 2009-10-10 3.0
battle_of_example-maps-1.0.vmdx extra maps "battle_of_example-maps-1.0.vmdx" does not exist 2009-10-10 3.0


The parameters for ModuleFile are described here:

filename
the name of the file
filetype
the type of file or very short description i.e module, extension, help files, rules summary etc..
date
the release date of the file, format is YYYY-MM-DD
size
the size of the file (this is calculated for you)
compatibility
the versions of VASSAL this file is compatible with

If a file is not already uploaded, then you'll see a red link in the row in the file table corresponding to that file. You can use this link to upload your file, as we will see in the final section of this tutorial.

The Module Information Section

This section of the module page contains important contact information about the module. At the top of this section, you will find the ModuleContactInfo template, where the names and email addresses of the module maintainer(s) and contributors are listed. This code

{{ModuleContactInfo|maintainer={{email|tom@example.com|Tom Johnson}}|contributors={{email|richard@example.com|Dick Smith}}, {{email|harold@somewhere.edu|Harry Jones}}}}

produces this listing:

Maintainer Tom Johnson
Contributors Dick Smith, Harry Jones

Email addresses are listed using the email template. The first argument of this template is the email address, while the second (optional) argument is the text to display for the link. The email template ensures that email addresses are shown only to users who are logged in to the wiki.

Below the ModuleContactInfo is an appropriate place to display other important information about the module.

The Comments Section

This section contains longer descriptive information about the various files, module versions, how to play or use the module etc. If the information provided here is very extensive it should be moved to the Module's talk page instead and provide a simple link to the talk page here. Users with comments or questions for the game can also use the Module Talk page that Module Contributors, Maintainers, Designers or Vassal Developers can check for info or answer etc..

FIXME: How to access module talk page and link

The Screen Shots Section

This section contains a gallery of screen shots of the module in action. To add an image to the screen shot gallery, add the name of the image on a new line between the gallery tags, one image name per line:

<gallery heights=200px widths=300px perrow=3>
  Image:Twilight_Struggle_Map.png
  Image:TunisiaScreenshot.jpg
</gallery>

The above code produces this screen shot gallery:

For full details on how image galleries work in this wiki, see the gallery documentation.

For full details on how to upload images see Upload a file.

The Players Section

This section contains a listing of people interested in playing this game. Email addresses are specified as in the the Module Information section. The following code

<div style="column-count: 4; -moz-column-count: 4; -webkit-column-count: 4">
* {{email|someguy@example.com|Some Guy}}
* {{email|s.o.guy@example.com|Some Other Guy}}
* {{email|y.a.guy@example.com|Yet Another Guy}}
</div>

produces this:

  • Some Guy
  • Some Other Guy
  • Yet Another Guy

Each email address is an item in a bullet list.

Upload Your Module

If you've added an entry for your module in the Files section of your module page, then you should see a red link in that row. To upload the file corresponding to that link, simply click the link. Doing so will take you to an upload page where you can upload your file. To see an example of such an upload page, follow this link: DoesNotExist.vmod. Note: Please do not upload a file with this name—that will ruin the example.

If you are uploading a new version of a module, please do not overwrite an existing version. Give your new version its own version number and put that version number in the filename. This will help users tell which version of your module they're using.