Adding pictures

Quick start by example

Add a single picture

If a user wants to add a single picture of rappel 5, they would first click the picture icon: This will add the following text to their page:

{{pic|name.jpg ~ caption}}

It is the user's job to replace "name.jpg" and "caption" with reasonable values. In this case, we'll change them to suit the picture we plan to add:

{{pic|rap5.jpg ~ Rappel 5 from the top}}

Now, save the page. When viewing the saved page, there will be a red link that says "Click here to upload picture". Click that link to select a picture to upload. After the picture is uploaded, reload the page to see the picture in the page.

Add multiple consecutive pictures

Note: Use these instructions to add many pictures right next to each other. If you just want multiple pictures in different places on the page, repeat the instructions for a single picture instead.

If a user wants to add a number of pictures of a water hazard, they would first just add the following code to the page:

{{pic}}

Now, save the page. When viewing the saved page, there will be a red + link. Click that link to select a picture to upload. After the picture is uploaded, reload the page to see the picture in the page. Click on the red link to add another picture.

Overview

It is possible to embed pictures in wiki pages. Supported formats are .jpg .gif .png and .pdf Yes! PDFs can be embedded like any other image file.

Instead of the overly complicated [[File:]] system directive, we recommend to use one of the ''pic'' directives below:

Single pictures:

{{pic|NAME.EXT ~ DESCRIPTION}} to display a single picture with an optional description. You must replace NAME with a reasonable file name, EXT with the file extensions, and DESCRIPTION with a description of the picture. For example: {{pic|rappel1.jpg ~ The first rappel of the canyon}}
{{pic|size=X|NAME.EXT ~ DESCRIPTION}} to display a full size image such as Topo, Map, PDF document etc. Again, you must replace NAME, EXT, and DESCRIPTION; see first example above.

Multiple pictures:

{{pic|name.ext ~ DESCRIPTION ; DESCRIPTION2 ; DESCRIPTION3 ; etc. }} to display multiple pictures (pictures named as a group). Again, you must replace NAME, EXT, and DESCRIPTION; see first example above.
{{pic|name.ext ~ DESCRIPTION ; NAME2 ~ DESCRIPTION2 ; NAME3 ~ DESCRIPTION3 ; etc. }} to display multiple pictures (pictures with different names). Again, you must replace NAME, EXT, and DESCRIPTION; see first example above.

Variable number of pictures:

{{pic}} to display an automatic picture gallery, where pictures can be added dynamically

Important info regarding photo naming: When the photo is uploaded through this function, RopeWiki will automatically add the name of the page to the beginning of the filename when it is uploaded. So do not name a photo such as ''Smith_Canyon_Rap1.jpg'' in the upload dialog, or the photo will be saved on the server as ''Smith_Canyon_Smith_Canyon_Rap1.jpg''. Simply name the photo ''Rap1.jpg'' and it will be saved on the server as ''Smith_Canyon_Rap1.jpg''. Likewise, in the {{pic}} tag do not prepend the name of the page, because again RopeWiki will automatically add it when trying to display the photo. With the example here, put the tag as such: {{pic|Rap1.jpg ~ The first rappel of the canyon}}. Finally, note that the file naming is case-sensitive, so what you have in the tag must exactly match the name when uploaded. If there is any doubt about what you called it when uploading, you can go to RopeWiki->Upload file menu in the upper left, and click the link ''list of uploaded files''.

These directives are easy to embed in a page and facilitate uploading and displaying pictures. Just Cut&Paste the example text below into your own page to try it out and see how it works:

The text below will display an automatic picture gallery, clicking on the '+' will add up to 12 pictures:

The text below will display a picture named "R1.jpg" (by default .jpg is assumed) with no description {{pic|R1}}

The text below will display a picture named "map.gif" (this is a GIF rather than a JPG) with description "Canyon Topo" {{pic|size=X|map.gif ~ Canyon Topo}}

The text below will display a picture set (2 pictures) named "waterlevels*.jpg" with descriptions "Normal levels" and "High water": {{pic|waterlevels ~ Normal levels; High water}}

The text below will display multiple pictures named "normal.jpg" and "high.png" (a PNG file rather than JPG) with descriptions "Normal levels" and "High water":

To add pictures to a Wiki page

Insert in the page as many instances of the {{pic|name}} as you need. To add a simple pic gallery just insert {{pic}} in the 'Trip Reports' section.
After saving the changes the page will display square boxes with a Click here to upload File:X link for any picture that needs uploading. Just click on the red links to upload the corresponding pictures.
A + will be displayed for the automatic picture gallery, just click on it to add more pictures to the gallery (up to 12).
Clicking on a red link will open a popup window with a form to upload a file. You may need to use the form buttons Choose file or Upload for some browsers, but most of it will be automated.
If needed, go back to the Wiki text to change descriptions or add or move images around until happy with the results.
If you want to add descriptions to the automatic gallery change the {{pic}} into {{pic|+pics ~ description1 ; description2; etc.}}
If needed, you can upload a new version of any picture just by clicking on the picture square icon in the bottom right corner, then clicking on the link Upload a new version of this file.

Usage & Options

{{pic|size=s|mode=m|link=l|name ~ description ; name2 ~ description2 ; etc }}

ALL the parameters are optional.

s possible sizes: S=Small M=Medium L=Large X=XLarge number=pixel size

The default is Medium (300 pixels), a good size for on screen and printed pages

If not specified, it will preserve the size last specified for any previous pictures

m possible modes: N=Normal L=FloatLeft R=FloatRight A=FloatAuto G=Gallery H=Hybrid Gallery

By default N for single pictures and H for picture sets

A will alternatively float successive images left and right

l: link to go to when image is clicked, can be left blank
name: file name or file set name (by default '+pics')

By default, the name of the page is automatically added to the file name you specify

To convert from [[File:''name'']] simply start name with ':' ie:[[File:MyFile.Jpg]] => {{pic|:MyFile.Jpg}}

To create an automatic gallery add a '+' to the name ie:{{pic|+mypics}}

If no file extension is specified, '.jpg' (lowercase) will be added to the name

description: brief description of the image, can be left blank
etc: you can display one single image or multiple images as a group, just separate them with ';'

If no name is specified for a picture within the set, the last specified name + a counter will be used

If the last name had a number in it then the counting will continue forward from that value

Examples: single pictures

{{pic|R1~R1}} : inserts a pic simply called "R1" with description "R1"
{{pic|mode=R|R5 ~ R5: Last rappel}} : inserts a floating pic on the right called R5 with description "R5: Last rappel"
{{pic|size=X|Topo.gif}} : displays a large GIF called "Topo" with no description

Examples: sets of pictures

{{pic|size=S}} : displays up to 12 small pictures called "pics", "pics2", "pics3", etc. with no descriptions
{{pic|normal ~ Aug2010: Normal levels; high ~ Sep2011: High water, very dangerous!}} : inserts water level pics called "normal" & "high" with descriptions
{{pic|R1~R1: 30' bolt DCR; R2: two stage 120'; R5~R5: very dangerous!; R6: DO NOT JUMP! }} : inserts pics called "R1", "R2" (autoname), "R5" and "R6" (autoname) with descriptions

Examples of Single Pictures

Wiki text:

This is a picture of the area called "The Pipe":

{{pic|R1 ~ R1}} This is an amazing canyon, with crystal clear waters and green mossy polished walls the likes Arizona canyoneers would never believe exist... and if you show them pictures they will claim they are fake. {{pic|mode=R|R5 ~ R5: Last rappel}}You descend the canyon swimming through cold waters for several hours till you reach the final rappel, as seen at right. After this the canyon continues with small slides and nuisance drops that can be downclimbed and are not very interesting. That is why many opt to exit the canyon at this point and get back early for happy hour.

A detailed profile of the descent is provided below:

Results:

This is a picture of the area called "The Pipe":

R1

This is an amazing canyon, with crystal clear waters and green mossy polished walls the likes Arizona canyoneers would never believe exist... and if you show them pictures they will claim they are fake.

R5: Last rappel

You descend the canyon swimming through cold waters for several hours till you reach the final rappel, as seen at right.

After this the canyon continues with small slides and nuisance drops that can be downclimbed and are not very interesting. That is why many opt to exit the canyon at this point and get back early for happy hour.

A detailed profile of the descent is provided below:

Examples of Sets of Pictures

Wiki text:

Small picture gallery (click the '+' to add more): {{pic|size=S}}

At the checkpoint compare the conditions you find with the reference pictures below: {{pic|size=M| normal ~ Aug2010: Normal water levels; high ~ Sep2011: High water, dangerous even for experts! }}

The most dangerous rappels of the canyon are as follows: {{pic| R1~R1: 30' bolt DCR, very wet rappel; R2: two stage 120' from floating log in a pool; R5~R5: very dangerous in high water! In future will install bolts for a high water bypass, just to be safe.; R6: underwater ledge, DO NOT JUMP!!! }}

Results:

Small picture gallery (click the '+' to add more):

+

At the checkpoint compare the conditions you find with the reference pictures below:

Aug2010: Normal water levels
Sep2011: High water, dangerous even for experts!

The most dangerous rappels of the canyon are as follows:

R1: 30' bolt DCR, very wet rappel
R2: two stage 120' from floating log in a pool
R5: very dangerous in high water! In future will install bolts for a high water bypass, just to be safe.
R6: underwater ledge, DO NOT JUMP!!!

Examples of size option

This is S:Small

This is M:Medium

This is L:Large

This is X:XLarge

Examples of Picture Gallery

Pictures that were quickly added using the automatic gallery directive {{pic}} can later be repurposed to display differently by referencing them by their automatically assigned names. The default automatic gallery name is 'pics'. You can use custom names to create more than one gallery. A '+' at the beginning of the name marks the difference between an 'automatic' gallery (variable number of pictures) vs a standard gallery (predefined number of pictures). The number of ';' determines the maximum number of pics that a gallery can have.

Custom automatic gallery (variable number of pictures)

{{pics|+R1}} : displays R1, R2, R3, etc. up to 12 pictures. First pic missing marks the end of the sequence.

+

Custom standard gallery (predefined number of pictures)

{{pics|R1~;;;;;}} : displays R1, R2, R3, etc. up to 6 pictures. Missing pictures are displayed with red links.

Default automatic gallery (variable number of pictures)

{{pic}} : this is the basic version, all versions below produce the same results but are more flexible
{{pics|+pics}} : this version allows to insert descriptions or extend the gallery beyond the 12 max by adding more ';'
{{pics|+pics~;+pics2~;+pics3~;+pics4~;+pics5~;+pics6~;+pics7~;+pics8~;+pics9~;+pics10~;+pics11~;+pics12~}} : this version allows to reorganize, add or delete from the sequence

{{pics|+pics~#1;#2;#3;#4;#5;#6}} : adding descriptions for first 6 pics