User:Daxle0pard/Image Guide

From Blaseball Wiki

Images can be in the body of the page text, in galleries, or in infoboxes. Just like editing wiki pages, adding images and galleries can be done with both the visual editor and the source editor. Adding to the infobox can only be done through the source editor, which this guide will explain.

Uploading

See the main article on this topic: w:Help:Uploading_files

The first step to adding an image is uploading it to the wiki; this can be done while in edit mode, through the Special:Upload or Special:Images pages, or through the navigation bar (via the three dots next to the new page/recent changes buttons).

Uploading via edit mode has the added benefit of inserting the image at the same time. The add image button in the edit toolbar brings up a pop-up menu with two tabs: Search and Upload. The upload tab will give you the option to either drag and drop or browse for a file.

After agreeing to the image policy and terms of use, there is the option to rename the file. This is important - it is how the file can be found to insert later. Something like "Workman Gloom Tlopps Card" is much more helpful than "image1" or "asdlajafka". Please add artist credit to the image description, ideally a social media handle so that it can be linked. Please get permission from the artist first if you are not uploading your own art!

The other upload methods work similarly, with the added step of choosing the license under which the image is being used.

Inserting an image

See the main article on this topic: w:Help:Adding_images

Visual Editor

In the pop up menu used for uploading, images already on the wiki can be searched for by file name. After choosing an image and confirming it, there is the option to add a caption. Please add any artist credit, with a link if possible, and a brief description. There is also an option to add alt text for screenreaders.

Under advanced settings there are options to wrap text, change the alignment of the image, image type, and dimensions. For images inline with text, the most appropriate type is usually thumbnail. frameless does not show the caption, while frame and basic will display the image full-size.

Once the image is inserted it can be dragged around to reposition and edited to change the caption or pick a different image.

Source Editor

See the main article on this topic: Editing 101/Wikitext#Source Editor

The format for images in source text is as follows: [[File:File_Name.png|250px|alignment|Link=Editing_101|appearance|alt=Alt text|Image description with artist credit]]

  • The image must start with File: or Image:, followed by the exact name of the file. Note that this is case sensitive: Tlopps_Card.png and tlopps_card.png are considered different files.
  • If only the link is specified, the image will be added at base resolution, inline with text. To customize the image, the following arguments can be added, separated by a pipe | symbol:
    • Size, in pixels. 250px would display the image at 250 pixels wide.
    • Alignment on the page. left and right will align to the left and right respectively with text flowing around the image, while center will align to the middle of the page with no text flowing around it.
    • Appearance. Adding thumb will display the image as a thumbnail at default width unless specified otherwise. This will also display the description below it. It is highly recommended to do this, especially with high resolution artwork.
    • Link, which will cause clicking on the image to open a link instead of its description.
    • Alternative text, specified with alt= which will display on mouseover, for screenreaders, or if the image does not load.
    • Description, which will be displayed below the image if it is a thumbnail. Any text not recognized as one of the above arguments will be displayed in this way. Links can be added to the description using link formatting as normal.

These arguments do not have to be in a specific order, although it is good practice to be consistent.

Infoboxes

To add an image in an infobox, use the formatting of source editor in the image1 field. The customization arguments are not needed, just the file location. Captions can be added in the caption section. To add more than one image, see the tabber section below.

Galleries

See the main article on this topic: w:Help:Galleries, Slideshows, and Sliders

Galleries are a way to display multiple images, often seen at the bottom of a player or team page.

Adding to a pre-existing gallery

If a page already has a gallery, images can be added without entering edit mode via the Add a photo to this gallery button. This will bring up the existing images in the gallery, with an add a photo button at the bottom. Recently added images will be displayed in a grid, otherwise an image can be searched for or a new one can be uploaded.

Creating a new gallery

Visual Editor

Under the Insert drop down menu is the option to add a gallery. This brings up a pop up box with the option to search for images to add; any new images must be uploaded beforehand. Again, captions with credit should be added to each page.

Source Editor

A gallery can be created using the <gallery></gallery> tags. Each image can be added using File:Image_Name.png without square brackets, and must be separated by a new line. A description can be added after a pipe | and can use wikitext such as links. For example, the gallery for Workman Gloom's Tlopps Cards would appear as:

<gallery>
File:Workman_Gloom_Card.png|[[Workman Gloom]] as a Shoe Thief by [https://twitter.com/shenaniglenn|Shenaniglenn]
File:Gloom.jpg|Workman Gloom as a Moist Talker by Shenaniglenn
</gallery>

The image width (default 200px) can be changed by adding to the gallery tag: <gallery widths=250px>

Tabber

See the main article on this topic: w:Help:Tabber

More than one image can be added to the infobox using the Tabber extension, which is also how the Records/Rumours tabs are implemented. This can only be added in Source mode.

The code structure for tabber is

<tabber>First tab title=[[File:Image Name.png]]
|-|Second tab title=[[File:Second image name.png]]
|-|Third Tab title=[[File:third image name.png]]
</tabber>

This code should be added after image1= in the infobox section at the very top of the page. Be sure to add a pipe | between this and the next argument. Note that the caption field will not work with the tabber.

The tabber sometimes does not display correctly, both on desktop and mobile. A common issue is a trailing pipe | at the end of the infobox code. If this is not the issue, a gallery (see above) can be used in the infobox in place of a tabber.