Template:Tool

From Openresearch
Revision as of 14:06, 13 August 2008 by Soeren (talk | contribs)
Jump to: navigation, search

This template simplifies the creation of articles about software tools. When inserted in a page, it creates a decorative table with much helpful information. It also takes care of annotating the given data semantically, so that users can easily find it or query it in other articles. Do not try to read this page's source code for learning table syntax – there are far easier ways of creating tables in MediaWiki.

If you use this template, you should also provide a subcategory of Category:Tool to detail the type of tool.

To use this template, insert the following at the beginning of your user page. All fields are strictly optional and should be omitted if no data is given. Note that the licenses are described briefly in seperate articles, and thus should be an existing license (of course new licenses can be added).

{{Tool
 | Name=The full name of the tool, defaults to pagename
 | Field = primary research field of the tool (must be a subcategory of Category:Science), add additional ones via category links
 | Type = one of API, Frontend, Backend or another subcategory of Category:Tool, add additional ones via category links
 | Homepage=URL of the tool's main home page, without "http://"|
 | Homepage label=Short text for homepage, if URL is too long|
 | Affiliation=Some organisation maintaining this tool, if applicable
 | Maintainer=Some person maintaining this tool, if applicable
 | Version=current version number, may also be "ongoing" for very agile projects
 | Release=date when the given version of the tool was released, omit if not applicable
 | License=the license type of the tool, look into Category:License to find existing licenses
 | Status=one of: pre-alpha, alpha, beta, stable, mature, discontinued (default is unknown)
 | Programming language=the primary language the code is written in (see Category:Programming_language)
 | Download=URL for downloading current version
 | Sources=URL for viewing/downloading current source code
 | Documentation=URL for online documentation/handbook
 | Logo=the name of an uploaded logo, such as "WikiPipesLogo.png" (use "Upload file" in the toolbar on the left)
}}

The order of the fields is not relevant. The template should be given as the first thing on a page.