Editing Basics

From CellBiology
Jump to: navigation, search

Introduction

Need to write a wiki project page but you don't know where to start?

Firstly, you have to be a current student or staff to have an account, be able to log in on that account and edit this wiki. Once logged in you will also have your own page on this wiki, accessed by clicking your login name at the top of the screen. Note that this is your personal page and is different from your project page.

If you are not a student and would like to contribute Cell Biology content to this wiki, please contact e-mail me

To edit any wiki page, click the little 'edit' tab at the top of the page. (You should see in a row: Page, Discussion, Read, Edit, History, move, watch.) Edit the content, then scroll down to click the Save button. Before clicking on 'Save', be sure to give a brief reason for your changes in the Summary box. This helps others to quickly tell what has been changed and allows Cell Biology Wiki admin to track changes more easily.

We're going to concentrate on this third factor for now, as your own page is an excellent place to play around with coding and get you used to it. Here, all the factors that come into editing a page can come into play, from emboldening or italicising text to creating headers and also adding in links to other pages (otherwise how would we get to see your works?). So let's get started!

If you would prefer, print out this linked One page Wiki Reference Card and use it when editing your project page. This was also a handout in the first laboratory.


Links: Project Referencing | Image Tutorial | Copyright Tutorial | One page Wiki Reference Card | Page PDF

Headers

Creating headers is a very simple way of separating your page into different sections. If you're like me, you'll want your own page to have a section for your individual project, comments on the Cell Biology course, and any other information you would like to appear on your own page. Separating each of these sections into headed sections gives three fine advantages:

  1. Each section can be found easily
  2. Each section becomes editable separately by clicking on the 'Edit' link at the right-hand side of the header, so you can edit each part of the page without worrying about messing-up the other parts (the page as a whole can still be edited with the 'Edit' tab at the top of the page, however).
  3. You get a nice 'Contents' list at the top of your page.

So how do we set up a header? It's simple, really. Headers have to be added on a line all to themselves, so if you're doing your project, a header called 'Project Title' would be on one line and the project introduction on the following lines. Headers are formatted by having two equals signs followed by a space, then the text you want in the header, then a space, then two equals signs. Sub headers can be added to pages by adding more equals signs around the header and these will also be displayed in the contents list a the top of your page. The difference between headers and sub-headers is that headers get an edit button and sub-headers don't, so you'd have to edit those from inside the initial header, or by editing the page as a whole.

So, for headers and sub-headers, we have the following coding:

== Example Header ==
=== Example Sub-Header ===
==== Example Sub-Sub-Header ===
and so on.

Indentations

Paragraphs can be indented by placing a colon (':') at the start of a paragraph. To indent a paragraph twice, use two colons, and so forth.

Emphasis

Emphasis can be placed on words and phrases by putting a certain number of apostrophes (') around the word or phrase to be emphasised. The amount of apostrophes determines the particular emphasis placed on the word/phrase. You'll need the same amount of apostrophes at the start as at the end, or the emphasis won't work.

  • Italics require two apostrophes
  • Bold text requires three apostrophes

Putting single apostrophes around something will simply display that something with apostrophes around it.

Links

Links work in two ways on MediaWiki, depending on whether you're linking to another page on the Wiki or another page on the Internet. We'll cover both types of link here.

Wiki Links

These are links only to other pages on the same Wiki, not other Wikis on the Internet. Basically, using this method of linking, anyone can add a link to anywhere else on this wiki.

Wiki Links are coded using double square brackets ('[[') and the contents of the brackets will be the page name being linked to, so a link to a page called 'Example' would be created by putting 'Example' between double square brackets. If you want to link to 'Example' but call the link 'An Example', you'd do this by putting 'Example | An Example' between square brackets. The pipe ('|') indicated to MediaWiki that the bit on the left is the Wiki Link and the bit on the right is the text to be displayed on the page.

So we have:

[[Example]] links to another page on the Wiki that is called Example.
[[Example | An Example]] does the same but calls the link 'An Example'.

Internet Links

For when you absolutely, positively, have to link to somewhere else on the Internet, you'll only need one set of brackets. Internet Links function in a similar way to Wiki Links but are differentiated on MediaWiki sites by using only one bracket at the start and end and not requiring a pipe. So, a link to UNSW Cell Biology can be made by entering a bracket, the url, a space, the text to be displayed as a link and then another bracket:

[http://cellbiology.med.unsw.edu.au UNSW Cell Biology] links to http://cellbiology.med.unsw.edu.au with the link text 'UNSW Cell Biology'.

It's worth noting at this point that Internet links must begin with http:// or MediaWiki will throw a fit and try to link to a page on the Wiki instead. Internet links can also be used to create e-mail links, by using the mailto tag instead of http: so a link to example@someplace.com with a link as 'e-mail me!' would be created by entering:

[mailto:example@someplace.com e-mail me!]

Lists

There are two main forms of list on a MediaWiki: numbered and unordered. Both work in exactly the same way and are simply designated with a hash (#) or asterisk (*) at the start of each line. Hashes provide numbered lists, asterisks provide unordered lists. They look like this:

This bit of text would be displayed as a standard paragraph on the page.
# This is the first line of a numbered list
# This is the second line of a numbered list
And this text is displayed as a standard paragraph, below the list.

The above text, when put into a MediaWiki page, would display as follows:

This bit of text would be displayed as a standard paragraph on the page.

  1. This is the first line of a numbered list
  2. This is the second line of a numbered list

And this text is displayed as a standard paragraph, below the list.

That's all there is to lists.

Images

Cell Biology Wiki supports the ability to include images in its wiki pages, see also Cell Biology - Image Tutorial. You should use images to allow pages to avoid complex, confusing descriptions or to show something simply when it would take a long time to describe in text. Your group project must contain at least one student drawn image. Remember that this site can be seen by anyone with an internet connection (including children).

Please note that this site contains student submitted materials for course project work. Anyone finding any image, text or content on the Cell Biology Wiki which infringes on another's copyright should immediately contact the website author (Dr Mark Hill) by email, identifying the materials location on the website and the original source material. All such identified content will be removed immediately.

Inserting an Image

Remember all student project image files uploaded must be renamed to start with a z.

To insert an image into a page on Cell Biology Wiki use the [[File:zfilename]] command, where zfilename is the name of the file as it exists on the wiki; e.g. [[File:zexample.png]] to link to an image called zexample.png. You can also add caption text, set the image as a thumbnail (smaller version) and set its alignment on the page using the extended image code: [[File:zfilename|thumb|alignment|caption]]. The pipes ('|') are used to separate each piece of information in the code in the same way as they do in links.

A thumbnail for the B35 Cells test image, with caption.

Adding 'thumb' sets the image as a thumbnail (smaller version) of the full image and allows a caption to be added to the image. Adding a caption will display text below the image. Please use captions as a synopsis of the image so screen readers and text-only browsers don't loose out. Remember: captions will not display unless the image link contains the 'thumb' command. Clicking on the image will take you to a full-size version of the image.

The alignment option can take the form of 'left', 'right' and 'center' to determine the image's position on the screen. If using 'center', please be aware that it only works with the American English spelling.

Uploading an Image

The easiest way to upload an image to the wiki is to use the Upload file option (located under the 'toolbox' header, below the search bar) on the main menu. This will take you to a page that allows you to select a file to upload from your system, set the filename to be used for it on the wiki and also to add a description of the file that people will see if they browse to it.

  • Remember the image can be renamed at this point before uploading and the name should be describe what the image is showing, and the new name must begin with a z.
  • Avoid non-descriptive or generic names, for example: zfigure1.jpg, zfig1.jpg, zimage1.jpg, zmyimage1.jpg, zproject1.jpg, etc.
    • If you must use multiple words for the image name, you can preferably separate the words by an underscore '_' or alternatively concatenate the words together.
  • If someone else has already uploaded an image with the same name you have selected, the previously uploaded image will also appear at the bottom of the upload screen.
    • Do not simply replace the pre-existing file, unless it is your own, as it may well be an entirely different image used for another student or group project.
    • Rename the file you intend to upload.

Once uploaded, the file will become accessible for use in pages on Cell Biology Wiki. Please ensure that any files uploaded to Cell Biology Wiki are files you can actually use; i.e., you own the copyright or the file is in the public domain/released under GNU/etc.

Image Information

You can either add the image information when you are uploading, or open the image and add the images information in edit mode in the text box beneath the image. Uploaded images may differ in the associated information depending upon source.

Remember the Course Handout information Academic Honesty and Plagiarism

"For the purposes of this policy, submitting an assessment item that has already been submitted for academic credit elsewhere may be considered plagiarism. Knowingly permitting your work to be copied by another student may also be considered to be plagiarism. The inclusion of the thoughts or work of another with attribution appropriate to the academic discipline does not amount to plagiarism." (extract from UNSW statement on Academic Honesty and Plagiarism)

If the full size image appears on your project page, you must also include the reference/copyright information in the legend. All uploaded images must contain the following information in the associated text box.

Journal Images

Project images must be from journals that allow image reuse from articles or reviews. See also ANAT3231_References

  1. Include the original image legend text.
  2. A link to the original image URL (internet link).
  3. The full Pubmed Reference with a link to the article URL in Pubmed.
  4. If available, the direct journal link.
  5. Copyright information as shown within the article or review.
  6. Copyright policy of the journal.

You may also include any other relevant comments or information you feel appropriate.

Project Referencing this page will give specific information on how to insert references on your Wiki page

Internet Images

Do not assume that because an image is on the internet that you can simply reuse in your project. If you cannot find copyright information for the site, do not use the image.

  • Do not simply google search and cite "Google" as the source.
  • Some images from some government sites (USA, NZ) can be reused.
  • Most Wikipedia images can be reused, but you should check their origin as well.
  • Some educational sites may allow image reuse.

In all cases you must include:

  1. Any legend associated with the image.
  2. The image URL (internet link).
  3. The page URL (internet link) where the image appears in its original context.
  4. The author of the original image.
  5. The copyright conditions that allow you to reuse this image. If you cannot find this, you cannot reuse.

Your Images

Remember the Course Handout information Academic Honesty and Plagiarism. Your group project must include at least one self-drawn image (drawing, flow diagram, etc) and you may include any other images you have drawn that you think are relevant. Do not simply redraw an identical copy of an existing image you have found, there must be something of your own in the figure. Copyright law grants copyright owners the exclusive right to control modifications of their works. If you add a new layer of material to a previously existing work, you have created a derivative work. If done without permission of the copyright owner you, may have violated the owner's copyright. Uploading your own image to the website is releasing your image as creative commons after publication and will allow reuse by others.

  1. A figure title.
  2. A full legend describing the image.
  3. If the image is based upon another's work (journal, internet) include the text "Based upon......" and include the information shown above for journal and internet images.
  4. Your identity (student number will suffice) but you may use your own name.
  5. A copyright statement:

"Beginning six months after publication, I (student number) grant the public the non-exclusive right to copy, distribute, or display the Work under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported license, as described at http://creativecommons.org/licenses/by-nc-sa/3.0/ and http://creativecommons.org/licenses/by-nc-sa/3.0/legalcode."

(MH - This 6 month delay means that no other current students may reuse your work)

Textbook Images

You cannot copy images from the online cell biology textbooks (Molecular Biology of the Cell, Molecular Cell Biology or The Cell- A Molecular Approach) to your project.

  • You can include the content as an external link.
  • Use an abbreviation of the journal title (MBoC, MBC, Cell) separated by a hyphen "-" and the figure title.
[http://www.ncbi.nlm.nih.gov/books/bv.fcgi?&rid=mboc4.figgrp.432]

Table Background Colours

In general use pale backgrounds for ease of access and readability. Use darker variant of same colour for headings. Do not "mix n match" colours as this all becomes confusing and remember your red-green colourblind audience.


Within a table you can insert the following code

|-bgcolor=

and then the appropriate colour as for the text above or the 6 letter/digit codes in the last column of the table below


text "FAF5FF"
dark green "A3BFB1"
light green "F5FFFA"
light grey "FCFCFC"
light grey "FCFCFC"
light blue "F5FAFF"
dark blue "CEDFF2"
dark purple "DDCEF2"
light purple "FAF5FF"
yellow "FFCC00"


For More Information

This page is designed to cover the basics of coding for any other site running on MediaWiki. If everything you really, really want to do isn't covered here you can always have a look at the MediaWiki Handbook, which explains all the codes you can use, but doesn't do it in quite as conversational a manner.

Finally

Remember: your pages are yours; do with them what you want and display them in a manner that suits the article that you're writing. Enjoy coding; it can be fun!

Text on this page modified from Editing MediaWiki For Beginners.