Template:Infobox software

From TSG Doc
Revision as of 12:26, 4 August 2015 by E.vandenberge (talk | contribs)
Jump to navigation Jump to search

[[Category:Infobox templates|Template:Remove first word]]

Template documentation[view] [edit] [history] [purge]

Usage

{{Infobox software
| name                   = 
| title                  = 
| logo                   = <!-- Image name is enough -->
| logo caption           = 
| logo size              = 
| logo alt               = 
| screenshot             = <!-- Image name is enough -->
| caption                = 
| screenshot size        = 
| screenshot alt         = 
| collapsible            = 
| author                 = 
| developer              = 
| released               = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} -->
| discontinued           = 
| latest release version = 
| latest release date    = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} -->
| latest preview version = 
| latest preview date    = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} -->
| installed version      = 
| installed version date = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} -->
| status                 = 
| programming language   = 
| operating system       = 
| platform               = 
| size                   = 
| language               = 
| language count         = <!-- Number only -->
| language footnote      = 
| genre                  = <!-- Software type/genre -->
| license                = 
| website                = 
| standard               = 
| resources              = <!-- Used for Template:Infobox_resources instance -->
}}

Example

Placeholder
Placeholder.png
Placeholder.png
Placeholder image on the TSG wiki
Original author(s)Erik van den Berge
Developer(s)Technical Support Group
Initial releaseSeptember 1987; 37 years ago (1987-09)
Discontinued1.1.0 / 1 July 2015; 9 years ago (2015-07-01)
Installed version1.1.0
Development statusAbandoned
Written inPython
Operating systemMicrosoft Windows
PlatformMediawiki
Available inEnglish
TypeImage
LicenseCreative Commons Attribution-ShareAlike 4.0
WebsiteMain Page
Manuals
[[Category:Infobox templates|Template:Remove first word]]
[[Category:Infobox templates|Template:Remove first word]]
{{Infobox software
| name                   = Placeholder
| logo                   = placeholder.png
| logo caption           = 
| screenshot             = placeholder.png
| caption                = Placeholder image on the TSG wiki
| collapsible            = 
| author                 = [[Erik van den Berge]]
| developer              = Technical Support Group
| released               = {{Start date and age|1987|09|df=yes}}
| discontinued           = yes
| latest release version = 1.1.0
| latest release date    = {{Start date and age|2015|07|01|df=yes}}
| latest preview version = 
| latest preview date    =
| installed version      = 1.1.0
| installed version date = 
| status                 = Abandoned
| programming language   = [[wikipedia:Python_(programming_language)|Python]]
| operating system       = [[wikipedia:Microsoft Windows|Microsoft Windows]]
| platform               = Mediawiki
| size                   = 
| language               = English
| genre                  = Image
| license                = [http://creativecommons.org/licenses/by-sa/4.0/ Creative Commons Attribution-ShareAlike 4.0]
| website                = [[Main Page]]
| resources              = 
  {{Infobox tsg
    | child              = yes 
    | manuals          = {{bulleted list
        | [[Main Page|Documentation]]
    }}
  }}
}}

Parameters

All parameters are optional.

name
Name of the infobox. Can affect the title of the infobox but its primary use is to help retrieve release data from outside the article. In such cases, if you want to edit the title at the top of the infobox, use the |title= parameter instead.
Attention: Please do not include a wikilink, hyperlink or image in this parameter. This parameter should be composed of pure text.
bodystyle
CSS styling for the infobox as a whole
title
Name of the software product as displayed above the infobox. When not specified, contents of |name= parameter will be displayed instead.
Important note: Please do not include an image in this field.
logo
Code for a small image to be displayed as software product's logo or computer icon. You may specify a full image syntax or just a file name, with or without namespace prefix. In other words, the following examples are all acceptable:
placeholder.png
File:placeholder.png
Image:placeholder.png
[[File:placeholder.png|64px]]
[[Image:placeholder.png|64px]]
logo size
Size of the logo. Defaults to 64px.
logo caption
Caption of the logo that appears below it. Should not be used to provide trivial captions, such as "This is the logo of X", which is automatically assumed. Reserved for special cases when a description beyond telling the obvious is needed.
logo alt
Alternative text of the logo; very important.
screenshot
Code for an image to be displayed as software product's screenshot. You may specify a full image syntax or just a file name, with or without namespace prefix. In other words, the following examples are all acceptable:
placeholder.png
File:placeholder.png
Image:placeholder.png
[[File:placeholder.png|300px]]
[[Image:placeholder.png|300px]]
caption
A caption for screenshot that appears below it. Please include this parameter only when there is an image to display.
screenshot size
Size of the screenshot. Defaults to 300px.
screenshot alt
Alternative text of the screenshot; very important. Defaults to image caption.
collapsible
Whether this screenshot is by default hidden and is only shown when user clicks on a minuscule "Expand" button. Can be set to "yes". Especially useful in case of long vertical screenshot
author
Name of the original author(s) or publisher(s) of the software product. It can be either an individual or an organization/business. Most of the times, it only needs to be specified when |developer= field is populated.
developer
Name of the current developer of the software product. It can be either an individual or an organization/business.
released
The date in which version 1.0 (or closely-matching release) of the software product in question reaches its "release to manufacturing" (RTM) stage.
The content of this field should look like the following:
{{Start date and age|year|month|day|df=yes}}
In case the article uses MDY as date format, use this code instead:
{{Start date and age|year|month|day|df=no}}
discontinued
Whether this product is no longer being developed, thus changing the phrase "Latest release" in the infobox to "Discontinued". For technical reasons, anything for this parameter has the same effect, be it "yes", "no" or anything else. To nullify the effect of this parameter, you need to omit it.
latest release version
The version number of the latest release of the software product. Please observe the following examples:
Example #1: If the article is about a product called Example Software whose latest version is 1.5, specify:
v1.5
Example #2: If the article is about a product called Example Software whose latest release is called Example Software 2008 and whose latest version number is 12.2, specify:
2008 (v12.2)
Example #3: If the article is about Famous Example Software 2010, which is a significant release of a product called Famous Example Software and whose latest version number is 14.0.0.25, just specify:
v14.0.0.25
Example #4: If the article is about Famous Example Software 2010 for which no update is released since its initial release-to-manufacturing (RTM), please omit this parameter unless there is an evidence that it is necessary for the reader to know this number. One reason would be the presence of preview releases of the software product which can only be distinguished from the RTM by their version number.
latest release date depends on this parameter.
latest release date
The release date of the latest released version. If no update is released for the software since its initial release, please omit this field; filling in the released field would be enough. :The content of this field should look like the following:
{{Start date and age|year|month|day|df=yes}}
In case the article uses MDY as date format, use this code instead:
{{Start date and age|year|month|day|df=no}}
This parameter only works when a latest release version is present.
latest preview version
The version number of the latest preview version or development branch. Should only be specified when development of a new version of the software product in question (newer than one specified in latest release version) is in progress. Please consult descriptions for latest release version provided above for best practices of specifying this parameter.
latest preview date
Specifies the release date of the latest preview version or development branch. Should only be specified when development of a new version of the software product in question (newer than one specified in latest release version) is in progress. Please consult descriptions for latest release date provided above for best practices of specifying this parameter.
installed version
The version number of the software as part of the current image installed on the lab computers, as selected by the Technical Support Group. This may differ from the latest release version.
installed version date
Specifies the release date of the installed version, if relevant. Please consult descriptions for latest release date provided above for best practices of specifying this parameter.
status
The development status of the computer program, such as: Planned, Active, Unmaintained, Discontinued, Stalled or Abandonware
programming language
The programming language of that subject of the article. If the program language of the software product has a corresponding article in Wikipedia, please link to it. Here is an example:
Code: [[wikipedia:C++|C++]] and [[wikipedia:C Sharp (programming language)|C#]]
Result: C++ and C#
operating system
The operating system on which the given software product works. Please be as accurate as possible but also be mindful of the length and avoid specifying vague phrases such as Cross-platform, Multi-platform, all or none. If the project is a web app or if only an OS-agnostic source code is released, ignore. Please consider these examples:
  • If the software product works on all incarnations of Unix, Linux and derived operating systems, please specify:
    • [[wikipedia:Unix-like|Unix-like]]
  • If the software works unconditionally on ALL incarnations of Microsoft Windows, please specify:
    • [[wikipedia:Microsoft Windows|Microsoft Windows]] or [[wikipedia:Windows|Windows]]
  • If the software product works only on Windows XP and all subsequent releases of Microsoft Windows, please specify:
    • [[wikipedia:Windows XP|Windows XP]] and later
  • If the software product works only on Windows XP and all subsequent releases of consumers versions of Microsoft Windows, please specify:
    • [[wikipedia:Windows XP|Windows XP]], [[wikipedia:Windows Vista|Windows Vista]], [[wikipedia:Windows 7|Windows 7]] and [[wikipedia:Windows 8|Windows 8]]
      (Add newer OS versions as they come out)
  • If the software product is released for various families of different operating systems, (such as specific versions of BSD, Linux, Mac OS and Microsoft Windows) so that listing them in the infobox gives it undue length, please leave the details to article body and specify:
    • [[wikipedia:BSD|BSD]], [[wikipedia:Linux|Linux]], [[wikipedia:Mac OS|Mac OS]] and [[wikipedia:Microsoft Windows|Microsoft Windows]]
platform
The computing platform on which the product runs. You might like to include the following information:
  • Processor architecture: Some software products run on a certain processor architecture such as IA-32 (also known as x86 an i386), x86-64 (also known as x64, AMD64 and EM64T), Itanium, ARM and MIPS architecture. Please avoid common mistakes highlighted in Wikipedia:Manual of Style/Computing § Avoid common mistakes.
  • Software frameworks: Some software products run on Java platform, .NET Framework, Adobe Flash, Adobe AIR, Microsoft Silverlight or XUL without regard to the processor architecture. If so, you may ignore processor architecture and instead specify the framework.
Please avoid specifying vague phrases such as "cross-platform" unless the following conditions meet:
  1. The software product has been released for numerous different platforms, so much so that including all of them causes the infobox size to grow unduly large.
  2. The article body lists the platforms under which the product runs.
If the above do not meet, then specifying such a vague phrase is the same as not specifying it.
size
Size of the installer package. Only applies to software products that are available via download. For products distributed physically in boxes or other packages, ignore this parameter. Do not forget to include your unit of measurements (i.e. Kilobytes, megabytes or gigabytes).
Note: Use a non-breaking space ("&nbsp;") to prevent numbers and units of measurements from separating when "word wrapping" occurs. You can also use {{Nowrap}} template to produce the same effect.
Observe the following examples:
  • 760&nbsp;KB → 760 KB
  • 32&nbsp;MB → 32 MB
  • {{Nowrap|842 KB}}842 KB
  • {{Nowrap|48.5 MB}}48.5 MB
language
Lists the natural languages in which the software product user interface can interact with user. Please do not supply "Multilingual" or such vague phrases which do not add to the knowledge of the reader. Also please do not wikilink the name of languages: Readers are most likely unwilling to read about those languages. For a comprehensive list of items that should not be generally linked to, see Wikipedia:Manual of Style/Linking § What generally should not be linked. A large list of languages can disrupt the natural flow of the article. When the list of languages grows large, consider one of the following measures:
  • Use |language count= parameter in conjunction with this parameter. This will allow the list of languages to be hidden and revealed with the click of a mouse. This method is not printer-friendly: A collapsed list does not appear on print and an expanded list may disrupt the natural flow of the article.
  • Add a link to a section of the article which lists languages. Please keep the link printer-friendly. For example, instead of "[[#Localization|Click here to see the list of languages]]", consider "35 languages; see [[#Localization|§ Localization]]". This solution is useful when the inclusion of a list of languages is important or when the localization of the subject of the article is discussed.
  • Ignore this parameter and use |language count= and |language footnote= instead. This approach is useful when the article is short and inclusion of the list of languages is unwanted or contested.
language count
Number of natural languages in which the software product user interface can interact with user. Please supply a number only. Don't use this parameter if the list of languages includes less than five entries. (Please see: Wikipedia:Manual of Style/Dates and numbers § Numbers)
If both |language= and |language count= parameters are present, the value of |language= will be collapsed under "List of languages" title.
language footnote
Use this parameter to supply citation on available translations, especially when |language= is not specified. Use of this parameter is not mandatory, as long as appropriate citation information is attached to the text. For instance, citation information may be attached to text itself in the article body or |language=, especially when there are more than one source for it information given. (E.g. when one source includes full translations and another includes partial translations; or when one source specifies the translations of one given version and another discusses what is added to that version after an update.) As a general rule, avoid citing automatically generated reports, statements about development versions or other sources of time-sensitive information.
genre
Type of program. Should be wikilinked to an article such as Vector Graphics Editor. For more information, consult wikipedia:List of software categories. Please do not use this field to briefly describe the role and function of the subject of the article. For example, instead of "SVG creator, editor and converter", consider using "Vector Graphics Editor". Instead of "PDF creator, editor, converter and viewer", consider using "Desktop publishing software".
license
Type of the software license under which the consumer is allowed to use the product. You may specify it in two forms:
  • You may specify a type of well-known license. For example:
    • Proprietary Commercial Software ([[wikipedia:Proprietary software|Proprietary]] [[wikipedia:commercial software|Commercial Software]]): Software products which are licensed for use for a price.
    • Trialware/Shareware: Same as proprietary commercial, but the user may try the product for limited time. Most software today are published under this license type.
    • Freemium: Software products that are provided in both freeware and commercial versions, with the free version being usable without the need for any compulsory payment, but lacking certain features.
    • Freeware: Software products which are licensed for use (and sometimes redistribution) but free of charge.
    • GNU GPL, GNU LGPL: two forms of open-source software.
Please avoid specifying phrases that makes no sense to the unfamiliar reader such as "Microsoft EULA", "Adobe End-User License Agreement" or "Symantec Terms of License", etc. (Always bear in mind that you are writing the article for those who do not know about the subject and come to the article to gain knowledge. You are not writing Wikipedia articles for your fellow contributors or editors who already know.)
Note: For consistency sake, only the American English spelling of license is made available. The Commonwealth English spelling licence cannot be used.
website
The web site URL of the software package. This URL must be readable in print. Therefore, you should use {{URL}} template like this: "{{URL|http://www.example.com}}". Avoid using printer-hostile forms like "[http://www.example.com Example website]".
Note: The {{URL}} template is currently not working on this wiki. DO NOT USE IT, resort to the "printer-hostile" method instead.
standard
Technical standard of the subject of the article adheres. Usually won't apply.
resources
Place to put optional template {{Infobox_tsg}}.