How to handle files (uploading and using files) - advanced users

From dermoscopedia

5.00
(1 vote)

 Authored by: Ralph P. Braun     ·  Karsten Hoffmeyer

 Keywords:   how to · uploading files · inserting files
Annotations
Description This page explains the basic handling on how toGives basic instructions and directions to someone on the methods for doing or making something. upload filesThis glossary term has not yet been described. to dermoscopediaDermoscopedia is the name of this website and is providing state of knowledge information concerning dermoscopy - a non invasive diagnostic method. and how to insert them into pages.
Author(s) Karsten Hoffmeyer · Ralph P. Braun
Owner Karsten Hoffmeyer→ send e-mail
Status released
Status update September 15, 2017
Status by Ralph P. Braun


User=

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 browseThis glossary term has not yet been described. 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 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 computeris a device that can be instructed to carry out arbitrary sequences of arithmetic or logical operations automatically. The ability of computers to follow generalized sets of operations, called programs, enables them to perform an extremely wide range of tasks.. 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 iconThis glossary term has not yet been described. 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 toGives basic instructions and directions to someone on the methods for doing or making something. 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

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
  • BrowseThis glossary term has not yet been described. to the page to which you would like to add the image.
  • Click on the "Embedded files" button in the editEditing refers to changing the content of a page. 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

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
Figure 1

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
2017-01 TADA updated.jpg
Syntax - display with credit
{{FileCredited|BCCThis glossary term has not yet been described. 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
Created by Natalia Jaimes
File created by Natalia Jaimes.

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.