Help:Images

Photos displayed on Antwiki webpages are image files that are stored on the Antwiki server. To be able to display your own image on a page you must first upload the file. Uploaded images are shown on a page using some relatively easy to learn, but quite specific, syntax. This help page explains all that you need to know in order to upload and work with images.

You must have link this to page to be created about getting user accounts to upload files or add an image to a page.

Introduction
Image management in Antwiki follows Mediawiki standards. Some of the information on this page is copied from Mediawiki Image Help and Images and other uploaded files. You can find additional information than is found here, and links to other image help, at both of those pages.

File Attributes
Prior to uploading a file you should consider the following details about Antwiki images.

File Formats
Antwiki can accept and show the following 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 other considerations to keep in mind.


 * Images can be resized when they are placed into an Antwiki page. There is no need to load different sizes of an image.
 * Your image probably does not need to be any larger than what can be shown on a large monitor. A default “largest size” others use, even for montage images that may be used to display fine details, are no wider or longer than a maximum of 2000 pixels. In most cases the largest width or length can be much smaller, such as 1500, 1000 or even 800 pixels.
 * Most images will be shown on a page at a size that is considerably smaller than the original uploaded size. Any image on a page can be seen at higher resolution and size by simply clicking on the image.

File Names
It can be helpful to have a filename that provides some indication about the image itself. IMG_03597.jpg, for example, is not as informative as Anoplolepis-gracilipes-foraging.jpg. Even so there are no requirements concerning file names.

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 apply a new Antwiki Image File name, e.g., Anoplolepis-gracilipes-foraging.jpg, as part of the uploading process. You can also leave the file name the same as the original.

File Uploading
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. This can include details like the person who took the photograph, where it was taken, and more. What follows is fairly involved so if you are trying to get a general overview of the Image Uploading process, you may want to skip down to the next section and come revisit this section later.

There are templates that allow you to easily and consistently present your image description information. This includes an information template and two geolocation templates. You can also add categories to your images here. This can be done to help you to organize your images for you own use and to make it easier for others to locate your photos.

Image Information Template
The information template has the form: {{Information |date=
 * description=
 * source=
 * author=
 * permission=
 * other_fields=

and displays its fields like this:

{{Information }}
 * description= Nest entrance: base of Ephedra plant.
 * date= 30 July 2011
 * source= Specimen: Museum of Comparative Zoology Collection ; Image Copyright: The President and Fellows of Harvard College.
 * author=Gary D. Alpert
 * permission={{DCCL}}

Instructions for using this template are found here.

-

The Information Template has the following form:

{{Information |date=
 * description=
 * source=
 * author=
 * permission=
 * other_fields=

In general:
 * 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}} 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:

{{Information }}
 * description=
 * date=
 * source={{own}}
 * author=your name here
 * permission={{DCCL}}

This image:



was uploaded with the following entered in the information template fields:

{{Information }}
 * description= Nest entrance: base of Ephedra plant.
 * date= 30 July 2011
 * source= {{MCZown}}.
 * author=Gary D. Alpert
 * permission={{DCCL}}

and yields: {{Information }}
 * description= Nest entrance: base of Ephedra plant.
 * date= 30 July 2011
 * source= {{MCZown}}.
 * author=Gary D. Alpert
 * permission={{DCCL}}

This image:



was uploaded with the following entered in the information template fields:

{{Information
 * description=Dolichoderus tricolor

Subfamily: Dolichoderinae

Locality: Australian Region: New Caledonia: Mt. Yate

Collector(s):

Collection Date:

Accession No.: ANIC32-014988

View: Montage of top

This is a type specimen.

}}
 * date=2011-8-16
 * source={{ANICown}}
 * author=Steve Shattuck, Canberra, Australia
 * permission={{Cc-by-sa}}
 * other_fields={{Information field|name=ANIC Accession No.|value=32-014988}}

This yields:

{{Information
 * description=Dolichoderus tricolor

Subfamily: Dolichoderinae

Locality: Australian Region: New Caledonia: Mt. Yate

Collector(s):

Collection Date:

Accession No.: ANIC32-014988

View: Montage of top

This is a type specimen.

}}
 * date=2011-8-16
 * source={{ANICown}}
 * author=Steve Shattuck, Canberra, Australia
 * permission={{Cc-by-sa}}
 * other_fields={{Information field|name=ANIC Accession No.|value=32-014988}}

-

Geolocation
Latitude and Longitude can be added as regular text where ever you like to do so. There are also two templates you can use that will show coordinates as a link to a map of the specified lat/long. These templates can be added to the image file page and can also be included on any other Antwiki page.

The first method creates its own boxed presentation of the lat/long and always displays degrees, minutes and seconds. The second method simply adds a link to the textual representation of the lat/long. It also is more flexible in that it shows the coordinates in the format that you input them.

Geolocation
Geolocation information, with a link to a variety of mapping options to show the image location, can easily be added to a file image page.

Method One - Template:Location
The lat/long information is included as part of the "location" Template. Lat/long information can be added to the image file information page using the following format:

This text added to an image page (and this will work on any Antwiki page) produces the following:

Decimal degrees can also be used.....

but the location is always shown in degrees, minutes and seconds:

Additional details and instructions about this template can be found at the Template:Location doc.

Method Two - Template:Inline coordinates
If you want to include geocoordinates without the box created by the location template you can use the template "inline coordinates." This will also display lat/long information in the format and with the precision entered.

produces:

produces:

produces:

produces:

Additional details and instructions about this template can be found at the Template:Inline coordinates doc.

Categories
The categories are whatever you want to add. xxxxxxxxxxxxxxxxxxx Check out this for an example Category:Aphaenogaster or Category:Aphaenogaster barbara.

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.). Alternatively, you can declare a copyright license in the summary (see previous section) and ignore this part of the Upload file form.

Upload!
Most folks ignore the “Upload options” checkboxes.

You can now click the “Upload file” button at the bottom of the page. Provided you have not done anything wrong the file will be uploaded and, once completed, you will see an Image File page.

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:" Hence an uploaded image file “ants.jpg” would have a page name: “File:ants.jpg”

The important elements of the File page (each is set in place during ) :
 * The Image. The image shown on the file page is typically of lesser quality and smaller size than the original uploaded file.
 * 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 itself) will load the image in its original form.
 * Image Description. This is information you add to the page that provides details about the image: the photographer, the location where it was taken, etc.
 * Licensing. The copyright that is assigned to the Image File.
 * File Links. This shows what Antwiki pages reference this image (either by showing the image on that page or by linking to the Image File page.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

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

Image management within Antwiki follows the protocols of Mediawiki. See Mediawiki for details (or Images and other uploaded files for a more general discussion).

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.

Image Uploading
Image files can be uploaded in a few steps Help:File upload. The more involved aspect of uploading is in the preparation of the file and organizing information for the file description page.

File Requirements
Antwiki accepts png, gif, jpg, and jpeg files. You should try to limit the file size to under 2 MB. The dimensions of the image can be reduced when it is shown on a page so your upload can be larger than how it will be displayed. Clicking on an image that is included on a page will take you to the file description page. Clicking on the image on the file description page will open the full sized version of the file. This allows others to easily access larger versions of your file while eliminating the need to upload files with different dimensions for showing unique sized renderings of this file on different pages.

Permissions and Copyright
You can only upload images that you have permission to use. In adding files to Antwiki you are agreeing to abide by Antwiki Copyright, |Attribution and  |Sharing Policies. More about this can be found on this page: Help:Copyright Permissions and Fair Use

You must assign a copyright to the file upload. For your own images you are free to choose among a number of sharing copyrights (see below for this list). If you wish to retain exclusive control of an image you own do not share it on Antwiki.

Images that are already shared using an appropriate Creative Commons or other Shared Copyright agreement may be uploaded to Antwiki but you must add those images in accordance with their licensing requirements.

WE NEED TO DECIDE ON USING ONE OR THE OTHER OF THE FOLLOWING

If you do not select a copyright/permissions option the default Antwiki copyright will be applied. This default is permission to use the image in any manner provided there is attribution given to the author and Antwiki.

or

You must select a copyright license when you upload an image.

You can attach a copyright during the uploading process via the drop-down list under the Summary field (at the bottom of the Upload file page). You can also include a copyright using the information fields, as is described below.

Adding Information to an Image File
Every uploaded file becomes part of an newly created File Description Page. An example of this is found here File:Aphaenogaster_kimberleyensis_ANIC32-017982_side_25-web.jpg. Page names take the form: File:filename.xxx

The filename is whatever is included in the Descriptive Filename section during upload or, if this is left blank, the name of the original source file. The end of this name - xxx - is the file extension (pdf, jpg, etc.).

Most information is added to an the image via the summary box on the upload page. You must include a few basic pieces of information with any file you upload and all of these can be included here.

Information Template Fields
The following set of information fields are managed via a single template, which allows these fields to be shown in the following way:

This may be important to know if you want to edit this information after creating the page. The steps for doing this editing are in another section, found below, Help:Images.

Description
Describe the image in plain text. This does not need to be extensive but it can be as long as you like. Text added here can be useful in providing additional context to the image and for searching Antwiki. There is no need to repeat information already included elsewhere (e.g., the data or author)

Date
This should be the date the image was taken or created, not the upload date. This field can interpret many different forms of the date. You can see if the form you use is acceptable by uploading an image and examining the file description page. If it does not render the date correctly edit the page and modify your entry using a different format.

Source
In most cases the file is your own work or is the same as the author. If you add Own work here this field will show the text "." Other sources can be included here including links.

Author
The photographer or creator of the image file.

Permission
The following list has entries for each of the available licenses you can use. Each entry begins with an abbreviated name, the full name of the license, and a link to more information about the license. Simply add the abbreviated name, enclosed in double brackets (e.g., ), for any one of the the following:


 * Cc-by - Creative Commons Attribution License - Template:Cc-by
 * Cc-by-sa - should this be changed to Antwiki creative commons attribution default as given here Template:DCCL) Creative Commons Attribution-Share Alike License - Template:Cc-by-sa
 * Cc-by-nd - Creative Commons Attribution-No Derivatives License - Template:Cc-by-nd
 * Cc-by-nc - Creative Commons Attribution-Non Commercial License - Template:Cc-by-nc
 * Cc-by-nc-sa - Creative Commons Attribution-Non Commercial-Share Alike License - Template:Cc-by-nc-sa
 * Cc-by-sa-nd - Creative Commons Attribution-Non Commercial-No Derivatives License - Template:Cc-by-nc-nd
 * Cc-zero - Creative Commons Universal Public Domain Dedication - Template:Cc-zero
 * CC-pd - Public Domain Statement - Template:Cc-pd

You can also leave this field blank and instead choose a copyright license from the drop-down list under the Summary field (at the bottom of the Upload file page).

Categories
Add whatever categories seem sensible. Categorizing your image can be a bit of extra work but it does help others to find all the great photos you contribute to Antwiki. Every category listed on an image page creates, or adds to, a gallery-of-images page for that category. For example adding an to an image would add the image to this gallery: Category:Automontage image. This can be a bit tricky for some genera since the images come after all the other text on the page. If you go to Category:Aphaenogaster, for example, you would have to go to the second page in this category since there are over 200 names (the limit for a category page is to list no more than 200 items).

We strongly suggest that any image of an ant include a category for the genus and for the full species name or, if not identified to species, a genus category. For example, the following image is placed in these three categories:



You can look at each of these category pages to see how these get sorted out with similarly categorized pages and files.
 * Category:Aphaenogaster
 * Category:Aphaenogaster kimberleyensis
 * Category:automontage image

If you want to keep track of all the images you upload, you could also add a category for yourself

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.

Editing the Image Description Page
Here is an example of a summary box entry:

The image below was uploaded using the text above. You can see the image page and how this information is rendered here: or by clicking on the image (a default behavior for any image that is shown on an Antwiki webpage).



There are four main parts to entering image information.

The template includes the following fields: * Description * Source * Date * Author * Permission

The data/information is entered by adding text after the = sign in this form (the information template):

The permission field can be left blank if you want to use the default Antwiki permissions (see below):

You can add specimen data by including another line to the information template, like the example shown below, and replacing "xxxxx" with your specimen information:

You can find more information about each of these fields at the Template:Information/doc page.

other stuff and snippets... http://en.wikipedia.org/wiki/Wikipedia:Image_use_policy Generally avoid uploading non-free images; fully describe images' sources and copyright details on their description pages, and try to make images as useful and reusable as possible.

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.