Help: Adding images

One of a series of quick guides: General introductionReadingEditingAdding new textsAdding imagesOther help

This page outlines how to prepare and include illustrated content at Wikisource.

The image guidelines discuss usage, style, and inclusion criteria.

After an image is prepared, go to Wikimedia Commons and follow the instructions to upload images.

If doing this manually is too difficult, you might want to try the Wikisource Illustrator (which you can enable via a gadget). Extract the image yourself, type in the metadata, and then hit "Upload".

File types edit

  • Djvu: a file containing a machine read text-layer and a scan of the source. Frequently used in side-by-side proofreading via the Page and Index namespaces.
  • JPG, PNG, TIFF, etc., suitable for illustrations, usually available at the same source as a djvu.

Image preparation edit

  1. Obtain a high quality image: see below. Open it in an image editor.
  2. Crop the image to remove the text, including the caption, and any blank space.
  3. Rotate the illustration left or right as required, a finer adjustment can also improve images.
  4. White or transparent backgrounds match Wikisource pages, so consider converting monochrome illustrations
  • convert to grey-scale by applying a 'colour profile' or similar command
  • adjust the black and white points using 'colour correction' or similar.

The result should remove the colour of the background, leaving the 'ink' for display. Colour images require more advanced restoration techniques, assistance with this can be found at Commons.

Image quality edit

Procedure for obtaining page scans and high quality images.

Text images edit

The file type DjVu is available for transcription, proofreading, and verification of works at Wikisource. These files are optimised for print, greatly compressing the file size, and include digitised text for each page. The file type also renders simple diagrams, but is not suitable for compression of colour and fine detail. Their use is discussed at Help:Proofread.

  1. Search for a scan of a work at a site such as
  2. Scan quality is occasionally poor. Use an online viewer to sample the scanned pages or check the text version at the site or manipulate a .jp2 file
  3. Upload as described below, using an appropriate title and disambiguation.
  • Note: It is possible to remove the first page if it contains extraneous content.
  1. Open the file using DjVuLibre or similar
  2. Select 'save as' and adjust the page range, e.g., 2–123

Illustrations edit

Sites often provide scans of documents in a variety of file types. There are instructions for extracting images from these files at Help:Image extraction.

Upload steps edit

To add images to Wikisource use Wikimedia Commons, where they become immediately available for use on Wikisource and elsewhere. Images are not usually uploaded directly to Wikisource.

See also: Commons:First steps
  1. Make sure that the image you would like to upload complies with the copyright rules of Wikimedia Commons.
  2. Use the best quality available and modify the file for inclusion here.
  3. Upload the file and give detailed information about the image, a URL for the source, and the copyright status.
  4. Give the file a name in accordance with the style discussed at image guidelines, and categorize the file at commons.
  5. Note any modifications, such as a crop, removed caption or conversion to black & white. Best practice at Commons is to also upload the unmodified file and link it from other_versions= in the description.

Scans with Wikidata association edit

If the index of your publication has a Wikidata item (some Qnnnn where n is any number of numbers) then you can change the {{Information}} to {{Book}} and add "|wikidata = " and "|Image page =" in the place of the date and the author and the rest of the information will be filled in from Wikidata. In addition, put the page number (scan page not published page) and the template will open the image of the scan to the page of the illustration, negating the need to point to an original file.

Use commons:Special:Upload the Information template can be easily edited, and by using your browsers back button, the previous form will be there. You should only need to give it the location of the next file and edit the page number and/or description.

With Wikidata, the only thing that you are responsible for is the data item number, a sensible category and the permission.

Structured Data edit

Commons files can have Structured Data (SDC) attached for machine-readable processing of image data.

There are instructions for the kinds of SDC and the standard formats applicable to illustrations extracted from books at Commons:Structured data/Modeling/Illustrations.

There is a plug-in at Commons that can be enabled via preferences called "AC/DC" (short for "Add to Commons / Descriptive Claims") which allows for adding structured data to a whole category of images at one time. You will need to know the category and an idea of which properties you wish to add.

At the very least, the addition of Publication Date (P1433) and copyright status (P6216) is encouraged.

For the equivalent structured data (the properties) for the books themselves, see Wikisource:Wikidata.

Adding to Wikisource edit

This image is shown using {{img float}}. It doesn't have a frame, but it still has a caption.

See also: Wikipedia:Picture tutorial
  1. Navigate to the page on Wikisource where you would like to add the image, and then click "edit".
  2. Type [[File:Image Name Here.jpg|frameless]] to add the image. It is also possible to align the image: [[File:Image Name Here.jpg|frameless|center]] will center the image on the page, 'left' or 'right' allows the text to flow around the image.
  3. Image size is a user defined preference. To override the default size, add a value ...|frameless|90px]] to force a relatively smaller size. Note that larger images can affect the rendering of a page and may greatly increase its size.
  4. Save the change, and ensure that the image does not hinder the reading of the text in any way.
  • You can also use a template like {{img float}} to insert an image float to the left or right with a caption, but no frame.