Help:Adding images

From Wikisource
Jump to: navigation, search
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 at upload images.

File types[edit]

  • Djvu: a file containing an machine read text-layer and a scan of the source. Frequently used in side-by-side proof-reading 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, proof-reading, and verification of works at Wikisource. These files are optimised for print, greatly compressing the file size, and includes 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 archive.org
  2. Scan quality is occasionally poor. Use an online viewer to sample the scanned pages or check the text version at the site.
  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, eg. 2—123

Illustrations[edit]

Sites often provide scans of documents in a variety of file types. The Internet Archive and others have a selection of files that provide sources for images, some better than others.

Online viewer[edit]

The online viewer at the Internet Archive site uses JP2 data to display JPG images. If a work contains several illustrations you can obtain good versions from this viewer.

  1. Locate the source of the scan. A DjVu file's information should note this as source =
  2. Navigate to the Internet Archive's "details" page.
  3. Select the online viewer (flipbook) using the "Read online" link.
  4. Set view to a single page.
  5. Navigate to the image.
    1. Using the page number.
    2. Using the .djvu index number with the prefix "n".
  6. Zoom the image to "100%" (important, otherwise you will lose a lot of detail).
  7. Choose a title (See Image naming).
  8. Right click on the image and select "Save as...".
  9. Prepare the image as above.

Automatic processing with Imagemagick[edit]

If you have Imagemagick (all operating systems), you can remove a paper texture automatically from a black-and-white image by adjusting the colour levels as follows:

convert foo.jpg -level-colors 'rgb(40,40,40),rgb(180,180,160)' -type Grayscale foo2.jpg

or

convert foo.jpg -level 49% -type Grayscale foo2.png
Scanned image with paper texture.jpg Scanned image without paper texture.jpg
Original image cropped from a page scan Image processed with Imagemagick

If you need a transparent background (for example for a drop initial over a coloured background), you can then use the following command:

convert foo2.jpg -negate -background transparent -alpha Shape foo.png;

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.

Adding to Wikisource[edit]


This image is shown using {{img float}}. It doesn't have a frame, but is 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' will allow the text 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.