Help:Images

Photos and other visual content displayed on Antwiki are from files stored on the Antwiki webserver. To display an image you have on your computer on an Antwiki webpage you must first upload the file to Antwiki. Uploaded images are displayed on pages using some relatively easy to learn, but quite specific, syntax. This page explains how to upload and display image files.

You must have a user account to upload files or add an image to a page.

Introduction
Image management in Antwiki follows Mediawiki and Mediawiki Commons standards. Much of the information on this page is copied or derived from Mediawiki Image Help and Images and other uploaded files. The purpose of this help page is to provide guidance for common Antwiki-specific image editing. If you want to explore options that go beyond these specifics a good place to begin is to follow the previous two links.

File Attributes
Prior to uploading a file you should be aware of the following details about Antwiki image files.

File Format
Antwiki can accept uploads and display these image file formats:
 * jpeg
 * jpg
 * png
 * gif

File Size
Uploaded files cannot be larger than XXXX MB.

Image Dimensions
The dimensions of the image are limited by the file size. There are a few considerations to keep in mind about the actual width and length of uploaded images.


 * In most cases the largest width or length of an uploaded file does not need to be more than 1,500 pixels.
 * There is no need to load a large and small dimension file of a single image. Images can be scaled down to a smaller size when they are added to an Antwiki webpage.
 * Most images will be shown on a page at a size that is considerably smaller than the original uploaded file. The original image can be viewed in greater detail by clicking on the image on the webpage where it is shown.

File Name
There are no requirements concerning files names but it is helpful to use a name that provides some clue as to what the image is about. IMG_03597.jpg, for example, is not as informative as Anoplolepis-gracilipes-foraging.jpg.

You do not need to rename an image file prior to uploading. The uploading process provides an opportunity to select a file on your computer, e.g., IMG_03597.jpg, and either leave the file name the same or create a new name, e.g., Anoplolepis-gracilipes-foraging.jpg.

File Copyright
Please go the Antwiki Copyright page to learn what files can and cannot be uploaded, and what kind of copyright should be assigned to uploaded files.

Uploading Files
There are three main steps involved in uploading a file:


 * Prepare your file for uploading. The File Attributes section (above) provides details about what you need to consider in preparing your image file for uploading.
 * Go to the Upload File page and fill in the appropriate fields in the entry boxes. There is a link to the upload page on the left side, under the Toolbox heading, on every Antwiki page (you must be logged in to see the Toolbox heading and its associated links.
 * Click on the “Upload File” button at the bottom of the page.

Here is a screenshot of the Upload File Page:



Source Filename
This is the file you are uploading. Click on the “Browse” button and navigate to, and then select, the image file you want to upload.

Destination Filename
Leave this blank if you want the uploaded image to have the same name as the file you are uploading. If you do want to change the filename type the new name here.

Summary
The information entered here will be shown on the The File Page. This can include details like the person who took the photograph, the date it was taken, the geolocation, copyright information and more.

If you only plan to upload a few images and do not need to attach specimen/species information to them, you could leave this section blank. This would apply if, for example, you are uploading a photo of yourself to place on your editor page. If you want to include details about the image there are a few templates that allow you to consistently add and present descriptive information via the summary field. You can also add categories to your images in this field. Categories can help you to organize your images for you own use and to make it easier for others to locate your image files.

Information Template
This template provides a way to present image metadata in a neatly organized way. You can include specimen information, the photographers name, assign and display the copyright for the file and more. See the Information Template Help page to find out more.

Geolocation
Latitude and Longitude coordinates can be entered as part of the description in the Information Template or they can be set off on their own. There are two templates that display GPS coordinates with a link to a map of the location. See the Geolocation Help page for help with these templates.

Categories
Categories is a useful method the software running Antwiki has for organizing content. See the Categories Help page to learn more about how categories work and how Antwiki suggests [[Help:Categories#Images | categorizing the images you upload.

Licensing
You can click on this box to see a list of options that you can apply to your images (Creative Commons copyrights, copyright reserved by author, etc.). Each editor is responsible for insuring the images uploaded to Antwiki can be shared on the website (Antwiki Copyright Guidelines). Alternatively, you can declare a copyright license in the summary field and ignore this part of the Upload file form.

Upload
Most folks skip over the "Upload options” checkboxes. You probably want to do the same, leaving the only remaining step to click on the “Upload file” button at the bottom of the page. The file will be uploaded and, this process is completed, you will see an Image File page. If you made any errors that cause the file upload process to fail the file upload page will reload with a message about the problematic entry.

The File Page
Uploading an image creates a “file page” or “image description page". The page name consists of the file name and extension, prefixed with "File:" An uploaded image file “ants.jpg” would have a page name: “File:ants.jpg” or File:Formica-comata_0195.jpg. The page name is also how the image is referenced when you want to see the image displayed in an Antwiki webpage.

The important elements of the File page:
 * The Image. If the image dimensions are large the displayed image is typically shown at a lesser quality and smaller size than the original uploaded file. To see the original file just click on the image.
 * Image Details. Directly under the image there are some details about the image file (file size, image dimensions, etc.) and a link. Clicking on the link, or the image, will load the image in its original form.
 * Image Description. Details about the image that can be added during upload (photographer, specimen data, etc.)
 * Licensing. The copyright assigned to the Image File.
 * File Links. Lists other Antwiki pages that include this image in their content.
 * Categories. Used to organize images. Clicking on any category name (shown in red or blue lettering) will take you to a page that shows all the images and pages that include the particular category.

The image description, licensing, and categories can be set in place when the file is uploaded or can be edited within the file page anytime after the file has been uploaded. Editing is done by going to the file page and clicking on the edit tab found in the upper right side of the webpage.

Placing Images on Antwiki Pages
Any image you want to place into a webpage must first be uploaded to the Antwiki server (as explained above). You can work with any images found at gallery of images and image file list.

Images are referenced by their Image File Name, which is the same as the File Page name, e.g. "File:Pheidole tuxtlasana Wilson 2003.jpg" or "{000}px"

A few options that are used regularly for displaying Antwiki images are explained in what follows. Links to additional help with display and position syntax is found in the. This includes with a caption, borders, in galleries and more. Details about image display syntax is nicely explained here: Mediawiki Commons Image Help.

Webpage Display
The simplest syntax for displaying an image on a page is:.

Using a real file as an example:



If the width is not specified the image will be displayed in the dimensions it was uploaded. Unless the page you are placing an image on is specifically image oriented, there is generally no need to display images on pages at a very large size. A size of ~ 300 px is typically used and anything greater than > 500 pixels may be to large. The images presentation should be balanced with the display of text. Anyone that wants or needs can click on the image to go to the file page, which allows for viewing the image in its uploaded dimensions.

.

.

.

.

.

.

.

.

.

.

.

.

The old mess of notes and text for this page before current editing (see above)

The gallery of images and image file list show files recently added to Antwiki.

Present Instructions for adding image information
For Gary and Steve:

The following is a simple example of how to add information with an image. All you do is put something like you see below into the summary box on the Special:Upload page when you upload your file.

Entering something like what you see above would result in what you see on this page File:Testing03.jpg

You could add any other information to the summary field, outside of the information and location blocks, that you wanted to include. It will all show up on the file page. Editing this information after uploading is fine too. You could add any of what is included above to any existing image page. Just go to the image file and click on edit. So feel free to play around with all this as you can easily fix anything on a page that does not work the way you thought it would (how nice that you are not messing up a database if you change any of this info!)

We could do other things with this template, in terms of its fields, but what I presented here I think is good enough for us. Steve may want to look into the documentation of this template [] to see if there is anything else we should consider, in terms of information to put in here. Gary too may have a suggestion about another field or two we might want to include here. Most of the tweaking that remains though is to how this is presented (i.e. formatting) but that does not affect the information itself.

Some notes that might be helpful.


 * The information template is set up as given below. You add information to the right of the =


 * The date can be input many different ways; it is pretty good at figuring out various date formats.
 * You can leave the permission field blank or add whatever template for permissions (there is a list of them way down there somewhere on this long page) you want to use here. You could also just use the selection box on the bottom of the Special:Upload page for adding a permissions license.
 * The Own work for the source that I included in my example is a template that is part of the information template set. It fills this field with the text 
 * The "other fields" line can be left out entirely or used for specimen data (in the example entry you could add anything where the "xxxx" is and it will show up in the information box).
 * The "other fields" line is flexible; you could put any text in place of specimen where it has "name=Specimen" and that text will show up as a heading. Also any text can be put in after the value=
 * You can easily create a small text file on your own computer to set up a personalized information template starter. This way you do not have to fill all of this out every time:


 * I would suggest we all use "DCCL" template for now for our image permission. This can serve as our default Antwiki permission. We can adjust and fix what this template says before we launch but it would be good for the many images the site will start out with to have the same default permission. For now this template looks like:

Either of the following geolocation data formats will work. You just need to adjust the numbers and, if you use the second format, the N/S and E/W. This entry is not part of the information template.

The categories are whatever you want to add. I think you will both really like what happens when you add a species or genus category to a photo. Check out this for an example Category:Aphaenogaster or Category:Aphaenogaster barbara. I added categories to some of Steve's file uploads that have the name Aphaenogaster in them. Anyway you can go here for discussion about image categories.

If you have any questions about any of this just ask. There is a lot that can be done here with how all this info is presented and organized. Yet I don't think it will change anything about the basic set of information you will likely include with an image. If there is any tweaking to be done to this, you will figure that out as you begin uploading files and gaining experience with how this works for both of you.

Alright, you can both ignore the rest of this page for now. I have to figure out how all these things work and set up instructions for an editor/contributor.

Bulk Image File Uploads
If you are uploading only a few images then it is best to use the normal image upload page. However, if you have a large number of images to upload then Antwiki management (those with access to the server) can use the maintenance script ImportImages to upload any number of images in a single operation. We can also add metadata (attribution notes, copyright conditions, etc.) at the same time. See ImportImages for instructions on preparing these metadata files.

If you have a large image collection let us known and we'll discuss the details of organising a bulk upload.

InstantCommons
Antwiki has enabled the Mediawiki InstantCommons. This means that all images found in Mediawiki Commons can be accessed in the same way as images uploaded directly into Antwiki. This saves considerable time and effort and minimises duplication.

One caution is that if you try to upload an image that is already found in Mediawiki Commons you will get a "duplicate file found" warning, even though the image hasn't been uploaded to Antwiki. While you can ignore this warning and add this second copy, it would be better to abort the upload and use the Mediawiki Commons copy

Need Revision
There is also an interesting page about adding pictures to a wiki at Quality and Description.

other image related tasks, and other pages to look over, towards the bottom of this page: Sandbox/images

instead.