How to handle files (uploading and using files) - advanced users
Introduction
This page explains the basic handling on how to upload files to dermoscopedia and how to insert them into pages. The first step will cover how to upload files to the website via a form and the second step will show how to insert the file on a page. This page is also available for [[Media:dermoscopedia-How_to_upload_and_insert_files.pdf|download]].
Uploading a file
This section shows how to upload a file to the website via a form. Note that the form will allow you to annotate the file, i.e. provide various information or data making it possible to better explore them and consequently to even make them machine readable.
There are several locations allowing you to access the upload form. The following figure 1 (click to enlarge) shows the two most visible places:
- In the main menu at the very top of every page browse to "General → Suggest / upload an image" and click on the selection. The page shown will offer the link to the form.
- On every chapter page you will see a button "Upload a file" to access the form. Note that you must be logged in to see it.
- Figure 1 - Where to find and access the upload form
Note that dermoscopedia offers two forms to upload files. One form is for files for dermoscopedia use only and the other allows to upload files for dermoscopedia and ISIC archive use. I case you would like to upload a file for dermoscopedia and ISIC archive use you have to browse to "General → Suggest / upload an image" to access the respective form. (spot shown on the upper left in figure 1).
After you clicked on the button or link to the upload form you will be presented with the form. The following figure 2 (click to enlarge) shows the view of the form and provides supplemental information on how to work with the form.
- Steps to take
- Click on the button "Upload"
- Select the file on your local computer. Note that it should already have a descriptive name.
- Wait until the file was uploaded to the wiki. If it is an image file a little thumb of the uploaded image or if it is a document file a little file icon will show together with two new buttons called "Change file" and "Remove". Ignore these two buttons and proceed.
- Go to the fields provided and complete them with quality data to the best of your knowledge. Note that if you do not add descriptive information to label, description or keywords in minimum the files will not be explorable.
- Now click on "Save page" at the very bottom.
- Done!
- Figure 2 - How to work with the upload form
Inserting a file
This section shows how to insert a file on a page using a form or by adding it directly using the respective syntax for more information. See also the extended image syntax documented on English Wikipedia.
Using a form (one file)
This section shows how to insert a file on a page via a form. Thus the form will create the code for inserting the image. The following figure 3 (click to enlarge) shows the view of the form and provides supplemental information on how to work with the form.
- Steps to take
- Browse to the page to which you would like to add the image.
- Click on the "Embedded files" button in the edit menu at the top of the text field.
- Add name of the file you uploaded in Step 1 including the file extension, e.g. ".png" (mandatory)
- Add a text for the caption. (optional)
- Add information to the fields of size, alignment and format (optional).
- Click on the "Insert" button.
- Done!
- Figure 3 - How to insert a file
Directly - using wikitext syntax (one file)
There are two approaches for adding the file directly to a page without using a form as described above. One is using the file syntax and the other is using the template syntax.
File syntax
- Syntax
[[File:Name_of_file.jpg|300px|left|Caption for popup on hovering]]
{{Clear}}
file name - display format (thumb) or display size - display alignment (right or left) - file caption - Just replace with the applicable data.
- Example
[[File:CCFigure 1.jpg|300px|left|Figure 1]]
{{Clear}}
- Result
Note the {{Clear}} below the actual syntax which is required to prevent the text following the inserted image from floating around it but to continue below it. If you are using the template syntax there is no need to add {{Clear}} below since this will be done automatically.
Template syntax
- Syntax - regular display
{{File|2017-01 TADA updated.jpg|300px|left}}
file name - display size (1200px maximum) - display alignment (right or left) - Just replace with the applicable data. Note that all parameters are mandatory for this to work.
- Example
{{File|2017-01 TADA updated.jpg|300px|left}}
- Result
- Syntax - display with credit
{{FileCredited|BCC schematics.jpg|300px|left|Natalia Jaimes}}
file name - display size (1200px maximum) - display alignment (right or left) - user name to be credited for file - Just replace with the applicable data. Note that all parameters are mandatory for this to work.
- Example
{{FileCredited|BCC schematics.jpg|300px|left|Natalia Jaimes}}
- Result
 |
| File created by Natalia Jaimes. |
Directly - Using wikitext syntax (two files)
It is also possible to place two files next to each other and provide a short description.
- Example
<gallery heights=325px widths=400px style="text-align: left"> File:Sebaceous hyperplasia dms HF.JPG|Sebaceous hyperplasia in a Hispanic woman. File:Sebaceous hyperplasia dms young HF.JPG|The sebaceous hyperplasia has all the features described above. The darker skin background makes it easy to distinguish the sebaceous hyperplasia from the surrounding skin. </gallery>
- Result
Sebaceous hyperplasia in a Hispanic woman.
The sebaceous hyperplasia has all the features described above. The darker skin background makes it easy to distinguish the sebaceous hyperplasia from the surrounding skin.
Directly - Using HTML syntax (two files)
It is also possible to place two files next to each other and provide a short description.
- Example (50% width of the page)
<ul class="large-block-grid-4"> <li>[[File:Sebaceous hyperplasia dms HF.JPG]]<br><br>Sebaceous hyperplasia in a Hispanic woman.</li> <li>[[File:Sebaceous hyperplasia dms young HF.JPG]]<br><br>The sebaceous hyperplasia has all the features described above. The darker skin background makes it easy to distinguish the sebaceous hyperplasia from the surrounding skin.</li> </ul>
- Result (50% width of the page)
Sebaceous hyperplasia in a Hispanic woman.
The sebaceous hyperplasia has all the features described above. The darker skin background makes it easy to distinguish the sebaceous hyperplasia from the surrounding skin.
- Example (100% width of the page)
<ul class="large-block-grid-2"> <li>[[File:Sebaceous hyperplasia dms HF.JPG]]<br><br>Sebaceous hyperplasia in a Hispanic woman.</li> <li>[[File:Sebaceous hyperplasia dms young HF.JPG]]<br><br>The sebaceous hyperplasia has all the features described above. The darker skin background makes it easy to distinguish the sebaceous hyperplasia from the surrounding skin.</li> </ul>
- Result (100% width of the page)
Sebaceous hyperplasia in a Hispanic woman.
The sebaceous hyperplasia has all the features described above. The darker skin background makes it easy to distinguish the sebaceous hyperplasia from the surrounding skin.
Changing the name of a file
It is also possible to change the name of an uploaded file because e.g. the name was not descriptive enough or you detected a typo, etc. it is possible to rename the file without the need to upload it again. In this case contact the coordinators. Note that all occurrences of the file within the text must me amended accordingly, too. Thus this should be avoided if possible. This is however more preferable than uploading the same file twice with other names.
