Jump to content

Template:Infobox Wikipedia user script/doc

From Wikipedia, the free encyclopedia

Usage

[edit]

This infobox is intended to be used on user script description/documentation pages.

{{{name}}}
[[File:{{{logo}}}|{{{logosize}}}|alt={{{logoalt}}}|upright={{{logoupright}}}]]
[[File:{{{screenshot}}}|{{{screenshotsize}}}|alt={{{screenshotalt}}}|upright={{{screenshotupright}}}]]
{{{screenshot-caption}}}
Description{{{desc}}}
Author(s){{{author}}}
Maintainer(s){{{maintainer}}}
Status{{{status}}}
First released{{{released}}}
Version{{{version}}}
Updated{{{updated}}}
Browsers{{{browsers}}}
Skins{{{skins}}}
Source{{{source}}}
GitHub repository{{{github}}}

Full syntax

[edit]
{{infobox Wikipedia user script
|styled             = 
|bodystyle          = 
|install-target     = 
|name               = 
|logo               = 
|logosize           = 
|logoupright        = 
|logoalt            = 
|logo-caption       = 
|screenshot         = 
|screenshotsize     = 
|screenshotupright  = 
|screenshotalt      = 
|screenshot-caption = 
|desc               = 
|author             = 
|maintainer         = 
|status             = 
|released           = 
|version            = 
|updated            = 
|browsers           = 
|skins              = 
|source             = <!-- or " |mainsource = " or " |beta = " -->
|github             = 
|categorize         = <!-- or " |cat = " -->
}}

Example

[edit]
MyScript
MyScript in action
DescriptionDoes something useful
Author(s)Username
StatusStable
First releasedJuly 7, 2008; 16 years ago (2008-07-07)
Version2.1.0
UpdatedMarch 3, 2013; 12 years ago (2013-03-03)
BrowsersFirefox, Chrome
SkinsVector
SourceUser:Username/Example.js
{{infobox user script
 | name = MyScript
 | desc = Does something useful
 | author = [[User:Username|Username]]
 | updated = {{start date and age|2013|03|03}}
 | status = Stable
 | released = {{start date and age|2008|07|07}}
 | version = 2.1.0
 | source = [[User:Username/Example.js]]
 | skins = Vector
 | browsers = [[Firefox]], [[Google Chrome|Chrome]]
 | logo = [[File:Wikimedia-logo.svg|50px]]
 | screenshot = [[File:Floater script screenshot.png|300px]]
 | screenshot-caption = MyScript in action
}}
  • Add |styled = yes for an alternate colored version (see second example):
User script
MyScript
DescriptionDoes something useful
Author(s)Username
StatusStable
First releasedJuly 7, 2008; 16 years ago (2008-07-07)
Version2.1.0
UpdatedMarch 3, 2013; 12 years ago (2013-03-03)
BrowsersFirefox, Chrome
SkinsVector
SourceUser:Username/Example.js
{{infobox user script
 | name = MyScript
 | desc = Does something useful
 | author = [[User:Username|Username]]
 | updated = {{start date and age|2013|03|03}}
 | released = {{start date and age|2008|07|07}}
 | status = Stable
 | version = 2.1.0
 | source = [[User:Username/Example.js]]
 | skins = Vector
 | browsers = [[Firefox]], [[Google Chrome|Chrome]]
 | styled = yes
}}

Parameters

[edit]
  • name: The name of the script. Defaults to page name.
  • desc: A short description of what the script does.
  • author: The script author's user name.
  • released: When the script was first released.
  • updated: The date of last update. Use {{start date and age}} to automatically display time since the last update.
  • status: Script's development status. You may describe this any way you like, such as alpha/beta/release, or stable/experimental/inactive.
  • source: The source code page.
  • skins: Supported skins.
  • browsers: Supported web browser(s).
  • github: The script's repository on GitHub, as input to the {{github}} template.
  • logo: Image file address for logo
  • logoupright: See Module:InfoboxImage: upright=yes displays image at 75% of default size, upright=value with values under 1 scaling the image down (0.9 = 90%) and values greater than 1 scaling the image up (1.15 = 115%).
  • logosize: Logo size in pixels. Use of logoupright is recommended as pixels can vary in size depending on display used.
  • screenshot: Image file address for screenshot
  • screenshotupright: See logoupright.
  • screenshotsize: See logosize.
  • screenshot-caption: Text caption for screenshot
  • styled: Set to yes for an alternate colored version (see example above)
  • categorize: Set to no to prevent categorizing the page into Category:Wikipedia scripts

The following parameters can aid in automatic installation:

  • mainsource: The main source file, which is to be loaded from the user's custom script.
  • install-target: The preferred page on which the script should be included. The default is common.js.

Templatedata

[edit]

This infobox is intended to be used on user script description/documentation pages.

Template parameters

This template prefers block formatting of parameters.

ParameterDescriptionTypeStatus
Namename

The name of the script. Defaults to page name.

Stringoptional
Logologo

Image file address for logo

Fileoptional
Logo Uprightlogoupright

See Module:InfoboxImage: upright=yes displays image at 75% of default size, upright=value with values under 1 scaling the image down (0.9 = 90%) and values greater than 1 scaling the image up (1.15 = 115%).

Numberoptional
Logo Sizelogosize

Logo size in pixels. Use of logoupright is recommended as pixels can vary in size depending on display used.

Stringoptional
logoaltlogoalt

no description

Stringoptional
logo-captionlogo-caption

no description

Unknownoptional
Screenshotscreenshot

Image file address for screenshot

Fileoptional
screenshotsizescreenshotsize

no description

Stringoptional
screenshotaltscreenshotalt

no description

Stringoptional
Screenshot Captionscreenshot-caption

Text caption for screenshot

Stringoptional
screenshotuprightscreenshotupright

no description

Numberoptional
Descriptiondesc

A short description of what the script does.

Stringoptional
Authorauthor

The script author's user name.

Useroptional
Maintainer(s)maintainer

no description

Stringoptional
Statusstatus

Script's development status. You may describe this any way you like, such as alpha/beta/release, or stable/experimental/inactive.

Stringoptional
Releasedreleased

When the script was first released.

Dateoptional
Versionversion

The version of the script.

Stringoptional
Updatedupdated

The date of last update. Use {{start date and age}} to automatically display time since the last update.

Stringoptional
Browsersbrowsers

Supported web browser(s).

Unknownoptional
Skinsskins

Supported skins.

Stringoptional
Beta?beta

Marks the source as being in beta. Set to any value to enable.

Auto value
yes
Stringoptional
Sourcesource

The source code page.

Page nameoptional
bodystylebodystyle

no description

Unknownoptional
GitHub repositorygithub

The script's repository on GitHub, as input to the {{github}} template.

Stringoptional
Styled?styled

Set to yes for an alternate colored version (see example on template page)

Auto value
yes
Stringoptional
Categorize?categorize cat

Set to no to prevent categorizing the page into Category:Wikipedia scripts

Auto value
no
Stringoptional
Main Sourcemainsource

The main source file, which is to be loaded from the user's custom script.

Page nameoptional
Install Targetinstall-target

The preferred page on which the script should be included. The default is common.js.

Stringoptional