Jump to content

Template:Infobox bot/doc

From Guzmer Wiki
Revision as of 19:40, 1 October 2020 by Worm-9340 (talk | contribs) (Add template doc)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Usage

The following is the base code required to generate an infobox. One can copy and paste the base code into an article and insert relevant information in front of the "=" signs. Removing HTML comments ("<!--", "-->" and anything between these two) is optional. To avoid accidental misuse, this base code does not have a handful of parameters that must be handled with absolute care and are not normally needed, such as {{{bodystyle}}}.

Infobox bot/doc
[[File:{{{logo}}}|300x64px|alt={{{logo alt}}}|{{{logo caption}}}]]
{{{logo caption}}}
[[File:{{{screenshot}}}|{{{screenshot size}}}|alt={{{screenshot alt}}}|{{{caption}}}]]
{{{caption}}}
Other names{{{other_names}}}
Original author(s){{{author}}}
Developer(s){{{developer}}}
Initial release{{{released}}}
Written in{{{programming language}}}
Predecessor{{{replaces}}}
Successor{{{replaced_by}}}
License{{{license}}}
Repository{{{repo}}}
Website{{{website}}}
{{Infobox bot
| name = 
| logo = <!-- Image name is enough. -->
| logo alt = 
| logo caption = 
| screenshot = <!-- Image name is enough. -->
| screenshot size =
| screenshot alt = 
| caption = 
| collapsible = <!-- Any text here will collapse the screenshot. -->
| other_names = 
| author = 
| developer = 
| released = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} -->
| Software = <!-- if the bot is an instance of some piece of software. -->
| programming language = 
| library = 
| replaces = 
| replaced_by = 
| license = 
| repository = <!-- {{URL|example.org}} -->
| website = <!-- {{URL|example.org}} -->
}}

Example

Infobox bot/doc
Developer(s)Cory
Initial releaseSeptember 19, 2016; 8 years ago (2016-09-19)
Written inNode.js
Librarydiscord.js
LicenseGPLv3+
Repositorygithub.com/CorySanin/tauntbot.git
Websitetaunt.bot
{{Infobox bot
| name                 = Taunt Bot
| logo                 = Taunt Bot logo.svg
| developer            = [[Cory]]
| released             = {{Start date and age|2016|9|19}}
| programming_language = [[Wikipedia:Node.js|Node.js]]
| library              = discord.js
| license              = [[Wikipedia:GNU General Public License#Version 3|GPLv3+]]
| repository           = {{URL|https://github.com/CorySanin/tauntbot.git}}
| website              = {{URL|https://taunt.bot}}
}}

Conditional formatting parameters

The following shows the effect of three parameters which change the formatting of certain infobox fields: |collapsible=.

Infobox bot/doc
Developer(s)Cory
Initial releaseSeptember 19, 2016; 8 years ago (2016-09-19)
Written inNode.js
Librarydiscord.js
LicenseGPLv3+
Repositorygithub.com/CorySanin/tauntbot.git
Websitetaunt.bot
{{Infobox bot
| name                 = Taunt Bot
| logo                 = Taunt Bot logo.svg
| collapsible          = yes
| developer            = [[Cory]]
| released             = {{Start date and age|2016|9|19}}
| programming_language = [[Wikipedia:Node.js|Node.js]]
| library              = discord.js
| license              = [[Wikipedia:GNU General Public License#Version 3|GPLv3+]]
| repository           = {{URL|https://github.com/CorySanin/tauntbot.git}}
| website              = {{URL|https://taunt.bot}}
}}

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. Wikipedia accessibility requirements mandates that this field should contain text that can be read by screen readers.
logo
Code for a small image to be displayed as bot's Wikipedia:logo. You may specify a file name, with or without namespace prefix. In other words, the following examples are all acceptable:
The GIMP icon - gnome.svg
File:The GIMP icon - gnome.svg
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, or for inserting {{ffdc}} or {{deletable image-caption}}.
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 file name, with or without namespace prefix. In other words, the following examples are all acceptable:
GIMP screenshot.png
File:GIMP screenshot.png
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 an individual or organization. Most of the time, it only needs to be specified when |developer= field is populated.
developer
Name of the current developer of the software product. It can be an individual or organization.
released
The date the bot went live
The content of this field should look like the following:
{{Start date and age|year|month|day}}
In case the article uses DMY as date format, use this code instead:
{{Start date and age|year|month|day|df=yes}}
If you are unsure which date format to use, please consult WP:MOSDATES.
software
If this bot is an instance of some other piece of software, provide the name of that software here.
programming language
The Wikipedia: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++]] and [[Wikipedia:C Sharp (programming language)|C#]]
Result: Wikipedia:C++ and C#
library
Library used to interface with the Discord API
license
The software license under which the consumer is allowed to use the product. You may specify a specific license or the more general category of license to which it belongs. See Category:Software licenses. For example:
repo
The online source code repository, if available. For example, the sourceforge or github project page. As with the website parameter, this should use the {{URL}} template. In the absence of this parameter, infobox attempts to acquire the repository link from Wikidata. This parameter overrides the Wikidata link.
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]". In absence of this parameter, infobox attempts to acquire the website link from Wikidata. This parameter overrides the Wikidata link. (It is useful when a second infobox for something different is defined on a page.) In addition, the special value "hide" suppresses this field, even in presence of a Wikidata link. This is useful for articles with several infoboxes, to avoid repeating one Wikidata link.