How to handle files (uploading and using files)

From Oncopedia

User=

Introduction[edit]

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:Oncopedia (by Verein für Hautkrebsforschung)-How_to_upload_and_insert_files.pdf|download]].

Uploading a file[edit]

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.
Locations of the upload forms
Figure 1 - Where to find and access the upload form

Note that Oncopedia (by Verein für Hautkrebsforschung) offers two forms to upload files. One form is for files for Oncopedia (by Verein für Hautkrebsforschung) use only and the other allows to upload files for Oncopedia (by Verein für Hautkrebsforschung) and ISIC archive use. I case you would like to upload a file for Oncopedia (by Verein für Hautkrebsforschung) 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!
View of the upload form
Figure 2 - How to work with the upload form

Inserting a file[edit]

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[edit]

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!
View of the upload form
Figure 3 - How to insert a file

Using syntax directly[edit]

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[edit]
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[edit]
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

Changing the name of a file[edit]

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.