User:Ericmc

From Blackboard Wiki
Jump to: navigation, search

Wiki Syntax

To Begin

In order to begin editing, you must click the Edit button at the top right.

This button can also be found to the right of all section titles, and will allow you to edit only that specific section.


Text Formatting

  • Articles and titles within articles are to be done in Title Case.
  • Tool Functions, like Submit, will be emphasized with Bold Text
  • Phrases will be put into italics, to clarify messages that appear or steps that someone needs to complete.
  • E.g. If you see Course website not available ... your professor either is not using a website for this course or has not yet made his/her course website available to students... If you want to upload another file, select Add Another File and repeat Steps 2 through 5 for each file you would like to upload.


Text Formatting
Method Syntax Result Notes
Italics
''This is a test''
This is a test Add two apostrophes on either side of the text
Bold
'''This is a test'''
This is a test Add three apostrophes on either side of text
Italics and Bold
'''''This is a test'''''
This is a test Add two apostrophes, then add the three apostrophes, totaling five apostrophes on either side.
Superscript
x<sup>2</sup>
x2 Self explanatory.
Subscript
x<sub>2</sub>
x2 Self explanatory.
Line break
Hello.<br />This is a test.
Hello.
This is a test.
Self explanatory.
Preformatted Text
<pre>'''''This is a test'''''</pre*>
'''''This is a test'''''
To add preformatted text, which disables formatting in that section, add
<pre>
at the beginning and
</pre*>
at the end. The "*" must be deleted in order to use. This can also be used to apply the same formatting to large sections. For example,
 Hello, this is a test 
.


Lists

If you wish to create a list, there are a few options;

Bullet List:

*This is a test
  • This is a test
  • This is a test
  • This is a test

Add one asterisk at the start of the sentence to convert the line into a bullet point.

Numbered List:

#This is a test
  1. This is a test
  2. This is a test
  3. This is a test

Add one hashtage at the start of the sentence to convert the line into a numbered list. If you insert a line space, the numbering will reset. In order to get around this, view the numbered advanced section.


Numbered List Advanced:

<ol>
<li>This the first step is selected.</li>
</ol>

<ol start="2">
<li>This is the second step</li>
</ol>


  1. This the first step is selected.
  1. This is the second step

This will allow you to describe which number you would like to start on. For example, if you are creating a guide and have described the first step followed by a picture, if you use the "#" syntax you will start back at number one again. This syntax will allow you to continue the list of numbers.


Section Formatting

Placing one equal sign ( = ) before and after your title will designate the largest and most significant section. More equal signs can be added up to five more on either side. The effect of adding additional equal signs is shown below:


In many WIKI pages, you may see banners used for section formatting as well. An example is shown below;

In order to use these colorful section dividers, you must understand how to alter the syntax.

===<div style="background-color:#CEE0F2;font-size:Medium;padding-top:1px; padding-bottom:1px; padding-left:5px"><font color="#000">This is a test</font></div>===
  • Under "background-color:" you can change the color of the banner. The color is described using hex codes. Navigate to this website to find the hex code of any color you would like: https://www.color-hex.com/
  • Under "font-size:", you can change the font size to the following options; Small, Medium, Large, x-Large.
  • Where "This is a test" is located, you can change the text to fit the section title.

How to Add Pictures to Article

1. The file must be uploaded.

2. The picture must be added to the WIKI page. This can be done in a variety of ways.


1. File Upload

  1. Navigate to the column of hyperlinks on the left hand side. The third link from the bottom is labeled "Upload File". Select "Upload File".
  2. In the new window, click "Choose File". Ensure that the screenshot is of proper format. If you cannot see the file extensions at the end of the file name, a guide to enable this feature is below.
  3. After you have selected "Choose File". A new window will appear. Select your file. Right-click your file and select "Rename". You must rename this file to something unique and relevant to the article you are creating. This will make it easier to link later as well as to ensure there will be no files already uploaded with the same name. For example, in this file upload guide, the files have been named from "fileupload1" to "fileupload6".
  4. Select open after selecting and renaming your file.
  5. Scroll to the bottom of the page. Click "Upload File".




2. Adding Pictures to WIKI Page

The order of syntax when displaying an image is as follows;

[[File:Name|Type|Border|Location|Alignment|Size|link=Link|alt=Alt|page=Page|lang=Langtag|Caption]]

There are multiple formatting options when adding a picture to a WIKI page;

NOTE:All images are to contain captions, and alt tags.


Image Formatting
Method Syntax Result Notes
Basic Picture
[[File:Uwin logo.jpg]]
Uwin logo.jpg Basic picture insert.
Thumb
[[File:Uwin logo.jpg|thumb]]
Uwin logo.jpg
Allows image to be enlarged. Sticks to right side of page.
Caption
[[File:Uwin logo.jpg|thumb|Hello]]
Hello
Allows image to be enlarged. Sticks to right side of page.
Alternative Text
[[File:Uwin logo.jpg|alt=University of Windsor Logo]]
University of Windsor Logo This must be included when inserting images. If the image were loaded in a text only browser, or spoken aloud, the purpose of the picture can remain intact, even if one cannot see the picture.
Resize
[[File:Uwin logo.jpg|50 px]]
Uwin logo.jpg Allows the image to be resized.However, all thumb images have the same width and as result do not need to be resized.
Change Image Location
[[File:Uwin logo.jpg|thumb|left]]
University of Windsor Logo
Allows the image to be moved to the left, center/centre, or right of page.
Example with multiple syntax
[[File:Uwin logo.jpg|thumb|center|100 px|alt=University of Windsor Logo|Hello]]
University of Windsor Logo
Hello
Example picture demonstrating order of syntax. For full syntax order, navigate the first paragraph of this section.


For inserting multiple pictures, try using Gallery Mode:


1. Using the Traditional Gallery Mode:

<gallery mode= "traditional" widths=200px heights=150px>
File:Uwindsorlogo.jpg|alt="University of Windsor Logo"|'''Step 1:''' Test <br /> '''Step 2:''' Test 
File:Uwindsorlogo.jpg|alt="University of Windsor Logo"|'''Step 1:''' Test <br /> '''Step 2:''' Test 
</gallery>


2. Nolines Gallery Mode;

<gallery mode= "nolines" widths=200px heights=150px>
File:Uwindsorlogo.jpg|alt="University of Windsor Logo"|'''Step 1:''' Test <br /> '''Step 2:''' Test 
File:Uwindsorlogo.jpg|alt="University of Windsor Logo"|'''Step 1:''' Test <br /> '''Step 2:''' Test 
</gallery>

3. Packed Gallery Mode

<gallery mode= "packed" widths=200px heights=150px>
File:Uwindsorlogo.jpg|alt="University of Windsor Logo"|'''Step 1:''' Test <br /> '''Step 2:''' Test 
File:Uwindsorlogo.jpg|alt="University of Windsor Logo"|'''Step 1:''' Test <br /> '''Step 2:''' Test 
</gallery>

3. Packed-Hover Gallery Mode

<gallery mode= "packed-hover" widths=200px heights=150px>
File:Uwindsorlogo.jpg|alt="University of Windsor Logo"|'''Step 1:''' Test <br /> '''Step 2:''' Test 
File:Uwindsorlogo.jpg|alt="University of Windsor Logo"|'''Step 1:''' Test <br /> '''Step 2:''' Test 
</gallery>



Links

There are many ways to add links to your wiki page. When creating a link to another section of the wiki, note that if the text is red, the article doesn't exist. You should double check that the link your describing exactly matches the wiki page you are trying to navigate to.


Link Formatting
Method Syntax Result Notes
Basic
[[Common Blackboard Browser Issues]]
Common Blackboard Browser Issues Add two square brackets on either side of the title of the page you wish to link.
Custom Link Title
[[Common Blackboard Browser Issues|Browser issues]]
Browser issues Add a vertical line and type the new title.
Link to Another Section in the Current Page
[[#Text Formatting|This will bring you to text formatting]]
This will bring you to text formatting Insert a hashtag and the section title.
Link to Specific Section in Different Page
[[Common Blackboard Browser Issues#Enable Third-Party Cookies|Cookies]]
Cookies By combining two of the formatting options, you will be able to link to a specific section of a different WIKI page.
External Link
[https://www.youtube.com/ Youtube]
Youtube This formatting will allow you to link any pages outside the internal Wiki system.

Tables

Tables are tricky on the Wiki. You can copy and paste the code shown in this section and adjust it as needed.

Basic Table

A basic table is created using this bit of code, and can be used for most purposes;

{| class="wikitable"
|+ Caption text
|-
! Header text !! Header text !! Header text 
|-
| Example || Example || Example
|-
| Example || Example || Example
|-
| Example || Example || Example
|}
Caption text
Header text Header text Header text
Example Example Example
Example Example Example
Example Example Example


In order to alter this code to suit your needs, the first step is to change the title of the table. This is done by altering the text to the right of the + sign, where it says "Caption text". The headers are changed by replacing the "Header text" beside the !. Lastly, the cells can be changed by altering the "Example" inbetween the double vertical lines.

Add Column

If you wish to add more columns, just duplicate the entire right column. It will look like this;


{| class="wikitable"
{| class="wikitable"
|+ Caption text
|-
! Header text !! Header text !! Header text !! Header text
|-
| Example || Example || Example || Example
|-
| Example || Example || Example || Example
|-
| Example || Example || Example || Example
|}
Caption text
Header text Header text Header text Header text
Example Example Example Example
Example Example Example Example
Example Example Example Example

Related Articles

Add this code to the end of your page. Alter the text where Articles that also relate to the Category:Bb Instructors is located. Alter the categories to suit your wiki page.

<!-- Related articles A: A little tricky thanks to MediaWiki's template system.-->
<div class="thumb tleft"><div class="thumbinner" style="width:350px;font-size:80%;text-align:left">
[[Image:600px-Andy Tools Hammer Spanner.png|right|50px]]
<big>'''Articles that also relate to the Category:Bb Instructors'''</big>
<categorytree mode=pages hideroot=on>Bb Instructors</categorytree>
</div></div>

{{Template:Errors or Omissions}}
[[Category:Blackboard]]
[[Category:Bb Instructors]]
[[Category: Bb Students]]
[[Category:Bb Disruptions to Classes]]
[[Category:Coronavirus/COVID-19]]
Amber icons 029 checkmark.png

We are constantly trying to improve the information in this Wiki.
If you notice any errors or omissions with this material, please advise the LMS Team or submit a Service Request at http://www.uwindsor.ca/bbhelp.



Editing Tips

Text Formatting

These are some tips to follow when writing Wiki articles:

  • Articles and titles within articles are to be done in Title Case.
  • Tool Functions, like Submit, will be emphasized with Bold Text
  • Phrases will be put into italics, to clarify messages that appear or steps that someone needs to complete.
  • E.g. If you see Course website not available ... your professor either is not using a website for this course or has not yet made his/her course website available to students... If you want to upload another file, select Add Another File and repeat Steps 2 through 5 for each file you would like to upload.

Tone

  • The tone of your writing should be formal. Encyclopedic writing has a fairly academic approach, while remaining clear and understandable. As is stated in the Wikipedia Tips; "Formal tone means that the article should not be written using slang, colloquialisms, doublespeak, legalese, or jargon that is unintelligible to an average reader; it means that the English language should be used in a businesslike manner."
  • Wordiness does not add credibility to Wikipedia articles. Try to keep your article concise, and if you are stuck between choosing equivalent expressions, choose the more concise option. However, this does not mean to remove important information.
  • State facts that may be obvious to you, but are not necessarily obvious to the reader.

Links

Do not attach links that the reader must click in order to understand what's going in. Instead, add a few words to describe it.

Images

Remember to add alternative text to your images by describing the picture in words. Alternative text (alt text) is used in place of an image on a webpage if the image fails to load on a user's screen. This text helps screen-reading tools describe images to visually impaired readers.

Videos

If you would like to add a video to your article, it is not easy. The only file format currently supported on this wiki is gif files. Here is an example;

[[File:Uwindsorlogovideo.gif]] 

Uwindsorlogovideo.gif


Useful Links

If you have already covered the content in the main article, you can navigate to this cheetsheet to jog your memory and quickly copy and paste what you are looking for.


If you would like to learn more about Wiki syntax, here are some more links with extensive information on each topic:


Last Note

If you learn something that may be useful or found better techniques than described in this wiki, do not hesitate to share this knowledge and request to add it to this page!