Upload

How to upload files

Most pages in a Wiki server are "standard" pages, whose content can be edited directly on-line. It is also possible to create pages whose content is uploaded from a file on the user's machine. This is mostly useful for non-text files such as images or PDF files.

The Wiki server handles 4 types of uploaded pages according to their contents:

text: the content of the page is an ascii text, e.g. the source code of a program. The page is displayed without any additional formatting except for the Wiki header and footer.
html: the content of the page is an HTML document. The page is displayed as is, except that the Wiki headers and footer are inserted.
image: the content of the page is an image. The page displays the image together with the Wiki header and footer.
file: the content of the page is a file. The page displays a link to the file, which can be traversed or, more probably, downloaded. This type is useful for Postscript or PDF files, for example.

Creating uploaded pages

Uploaded pages are created exactly like normal pages (see create): first an existing page is edited to add a link to the new page to it. Links to uploaded pages have a special form, as explained in the Links page: Either they include the type of the page explicitly, or the type can be inferred from the suffix of the file name:

	[[text:myprog.c]] or [[myprog.c]]
	[[html:fancypage.html]] or [[fancypage.html]]
	[[image:logo.gif]] or [[logo.gif]]
	[[file:something.pdf]] or [[something.pdf]]

The link can also include a text to be displayed as the anchor instead of the file name:

	[[image:logo.gif The Logo]] or [[logo.gif The Logo]]

It is recommended to use this text only for images, since it provides the alternate text of the inlined image:

	[[logo.gif The Logo]], [[myprog.c]]

displays like this:

, myprog.c

(You can click on these links to see the page creation form. Please don't create the pages so the next reader can try them too).

Once the link is inserted into an existing page, click on it. For images, the link anchor will be the "missing image" icon as above. The page creation form appears. It is very similar to the standard page creation form, except that the text area to insert the text of the page is replaced by a text field and a "browse" button to select the file to upload.

To create the page, complete the description, category, etc. as for a normal page (see create) and select a file with the "browse" button. Then click "Preview" to preview the result or "Save" to create the page.

The page creation form has a Page Type menu next to the Save/Preview/Reset/Cancel buttons. The type of the page can be changed with this menu, in case the server guessed the wrong type. If you select an entry in this menu, the page creation form is changed and all its previous contents (if any) is lost. Once the page has been created (i.e. once you have clicked on the "Save" button), the type cannot be changed.

Editing uploaded pages

Editing an uploaded page is like editing a standard page (see edit): When clicking the "Edit" link on an uploaded page, the page edition form appears. It is the same as the page creation form described above (except that the Page Type menu is not present). To upload a new file, click the "Browse" button and proceed as above.

At present, the contents of the successive versions of images and files are not archived, but the contents of the successive versions of text and html pages are archived. Note that in both cases, the history will show all the versions. But in the case of images and files, the contents will be missing.

Version 2, Mon 08 Feb 1999 14:05:47 [mbl] - created Fri 05 Feb 1999 13:36:35 [mbl]