CSC/ECE 517 Fall 2011/WIKI Features: Difference between revisions

From Expertiza_Wiki
Jump to navigation Jump to search
 
(17 intermediate revisions by the same user not shown)
Line 29: Line 29:
<p>To mark text as '''bold''', you enclose the text in a set of triple apostrophe characters:  <nowiki>'''your bold text goes here'''</nowiki></p>
<p>To mark text as '''bold''', you enclose the text in a set of triple apostrophe characters:  <nowiki>'''your bold text goes here'''</nowiki></p>


<p>While editing your article, a tool bar will be displayed at the top of the screen.  You can use the '''B''' icon to create the bold stub.</p>
<p>While editing your article, a tool bar will be displayed at the top of the screen.  You can use the '''B''' icon to create the bold stub.  You can optionally use the <b>&lt;b&gt; &lt;/b&gt;</b> HTML tags to bold text.</p>


== Escaping Wiki Formatting ==
== Escaping Wiki Formatting ==
Line 70: Line 70:
</ul>
</ul>
<p></p>
<p></p>
<p>Tables are also supported:</p>
<p>HTML Tables are also supported:</p>
<table border="1">
<table border="1">
<tr><th>Column 1</th><th>Column 2</th><th>Column 3</th></tr>
<tr><th>Column 1</th><th>Column 2</th><th>Column 3</th></tr>
Line 81: Line 81:


<p>To ''italicize text'', include the text in a double set of apostrophes:  <nowiki>''your italicized text goes here''</nowiki>.  Please note this isn't the use of the quote (") character but the double use of the apostrophe (') character.</p>
<p>To ''italicize text'', include the text in a double set of apostrophes:  <nowiki>''your italicized text goes here''</nowiki>.  Please note this isn't the use of the quote (") character but the double use of the apostrophe (') character.</p>
<p>A stub for italicized text can be created using the <b><i>I</i></b> icon button on the toolbar while editing your article.</p>
<p>A stub for italicized text can be created using the <b><i>I</i></b> icon button on the toolbar while editing your article.  Optionally you can use the <b>&lt;i&gt; &lt;/i&gt;</b> HTML tags to italicize text.</p>
 
== Additional Formatting Help ==
 
<p>This WIKI is based on [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] and additional help on formatting can be found on the [http://www.mediawiki.org/wiki/Help:Formatting MediaWiki Help:Formatting] page.</p>
 
<p>Additional help, including Advanced Editing can be found on the [http://www.mediawiki.org/wiki/Help:Contents MediaWiki Help:Contents] page.</p>
 
<p>Wikipedia also has information on [http://en.wikipedia.org/wiki/MediaWiki MediaWiki]<ref>[http://en.wikipedia.org/wiki/MediaWiki Wikipedia's MediaWiki Page]</ref>.</p>


= Creating Hyperlinks =
= Creating Hyperlinks =
Line 93: Line 101:


<p>While editing your article, a tool bar will be displayed at the top of the screen.  You can use the world icon to create the hyperlink stub.</p>
<p>While editing your article, a tool bar will be displayed at the top of the screen.  You can use the world icon to create the hyperlink stub.</p>
<p>Another feature is to link relative to the web site and server, using <b><nowiki>[[ ]]</nowiki></b>.  For example, the following link links to Subsection Level 4 above:</p>
<p>[[CSC/ECE_517_Fall_2011/WIKI_Features#Level_4]]</p>
<p>and was created using:</p>
<blockquote>
<b>
<nowiki>
[[CSC/ECE_517_Fall_2011/WIKI_Features#Level_4]]
</nowiki>
</b>
</blockquote>


= References =
= References =
Line 132: Line 153:
<p>A table of contents can be created for you automatically by using headings and sub-headings as described in the [http://expertiza.csc.ncsu.edu/wiki/index.php?title=CSC/ECE_517_Fall_2011/WIKI_Features&action=submit#Indentation_Levels Indentation Levels] section of this article.</p>
<p>A table of contents can be created for you automatically by using headings and sub-headings as described in the [http://expertiza.csc.ncsu.edu/wiki/index.php?title=CSC/ECE_517_Fall_2011/WIKI_Features&action=submit#Indentation_Levels Indentation Levels] section of this article.</p>


----
= Tables =
<p>This WIKI supports a custom table construct:</p>
<blockquote>
<pre><nowiki>
{| class="wikitable" border="1"
|-
!
! Col 2
! Col 3
! Col 4
! Col 5
! col 6
|-
|  Row 1
|  R1 C2
|  R1 C3
|  R1 C6
|  R1 C5
|  R1 C8
|-
|  Row 2
|  R2 C2
|  R2 C3
|  R2 C6
|  R2 C5
|  R2 C8
|}
</nowiki></pre>
</blockquote>
<p>This construct generates this table:</p>
{| class="wikitable" border="1"
|-
!
! Col 2
! Col 3
! Col 4
! Col 5
! col 6
|-
|  Row 1
|  R1 C2
|  R1 C3
|  R1 C6
|  R1 C5
|  R1 C8
|-
|  Row 2
|  R2 C2
|  R2 C3
|  R2 C6
|  R2 C5
|  R2 C8
|}
 
= Unordered Lists =
<p>Unordered lists can be created using an asterisk (*) at the beginning of a line.  For example:</p>
*Line 1
*Line 2
*Line 3
<p>Which was created using:</p>
<blockquote>
<pre><nowiki>
*Line 1
*Line 2
*Line 3
</nowiki></pre>
</blockquote>
 
<p>See also [http://expertiza.csc.ncsu.edu/wiki/index.php/CSC/ECE_517_Fall_2011/WIKI_Features#HTML HTML subsection] above.</p>
 
= Upload File =
<p>The WIKI supports a feature so that you can upload supporting files and reference them.  These include images.  To upload a file to your article space, follow these directions:</p>
<ol>
<li>Click on the <b>Upload file</b> [http://expertiza.csc.ncsu.edu/wiki/index.php/Special:Upload link] on the left hand side of the page located in the <b>toolbox</b> section.
<li>Browse for your file, fill in the form details.
<li>Click on the <b>Upload File</b> button to upload the file.
</ol>
 
<p>To include a file in a page, use a link in one of the following forms:<ref>[http://expertiza.csc.ncsu.edu/wiki/index.php/Special:Upload: WIKI File Upload Tool]</ref>
</p>
 
<ul><li> <b><tt><nowiki>[[File:File.jpg]]</nowiki></tt></b> to use the full version of the file
</li><li> <b><tt><nowiki>[[File:File.png|200px|thumb|left|alt text]]</nowiki></tt></b> to use a 200 pixel wide rendition in a box in the left margin with 'alt text' as description
</li><li> <b><tt><nowiki>[[Media:File.ogg]]</nowiki></tt></b> for directly linking to the file without displaying the file
</li></ul>
 
= Using an uploaded image =
 
== Image to the right, with citations ==
 
[[File:V&b-toward-earth.jpg|200px|thumb|right|Verrnack & Blupirk<ref>[http://vbcomic.com Verrnack & Blupirk]</ref>]]
<p>This is an example of placing an image on the right hand side of your subsection.</p>
<p>The image was placed there using this WIKI formatting text:</p>
<blockquote>
<b>
<nowiki>
[[File:V&b-toward-earth.jpg|200px|thumb|right|Verrnack & Blupirk<ref>[http://vbcomic.com Verrnack & Blupirk]</ref>]]
</nowiki>
</b>
</blockquote>
<p>Strange formatting issues can occur if you don't have sufficient text to offset the height of the graphic you're displaying.</p>
<p>These formatting issues can be overlapping sections or subsections.</p>
<p>This strange formatting will be shown until the text of the current or subsequent sections pass the vertical height of the graphic.</p>
<p>This is easily demonstrated with the section directly below.  Notice how the subsection separator stops next to the image and doesn't go across the entire page.</p>
 
== Image to the left, with citations ==
[[File:V&b-toward-earth.jpg|200px|thumb|left|Verrnack & Blupirk<ref>[http://vbcomic.com Verrnack & Blupirk]</ref>]]
<p>This is an example of placing an image on the right hand side of your subsection.</p>
<p>The image was placed there using this WIKI formatting text:</p>
<blockquote>
<b>
<nowiki>
[[File:V&b-toward-earth.jpg|200px|thumb|left|Verrnack & Blupirk<ref>[http://vbcomic.com Verrnack & Blupirk]</ref>]]
</nowiki>
</b>
</blockquote>
<p>Strange formatting issues can occur if you don't have sufficient text to offset the height of the graphic you're displaying.</p>
<p>These formatting issues can be overlapping sections or subsections.</p>
<p>This strange formatting will be shown until the text of the current or subsequent sections pass the vertical height of the graphic.</p>
<p>This is easily demonstrated with the section directly above.</p>
<p>To prevent the next section from being messed up by this subsection, this additional text is being added.  It may not be sufficient for browsers that have a pixel width of greater than 1920.</p>
 
= Example References =
= Example References =
<references />
<references />

Latest revision as of 21:51, 4 December 2011

Indentation Levels

Indentation levels, 1 and 2, demonstrated below, automatically put a separator line below the heading. When you create Headings, a table of contents is automatically created and placed at the top of your WIKI article.

Level 1

To create a Level 1 heading, you enclose your heading in between a single pair of text equal signs, like this:

= Level 1 =

Level 2

To create a Level 2 heading, you enclose your heading in between a single pair of text double equal signs, like this:

== Level 2 ==

For subsequent levels you increase the indentation by increasing the number of equal signs that surround the heading text.

Level 3

Level 4

Level 5
Level 6

Formatting Text

Bold Text

To mark text as bold, you enclose the text in a set of triple apostrophe characters: '''your bold text goes here'''

While editing your article, a tool bar will be displayed at the top of the screen. You can use the B icon to create the bold stub. You can optionally use the <b> </b> HTML tags to bold text.

Escaping Wiki Formatting

You may find it necessary to escape WIKI formatting so that you can use it literally in your article. Like this article does. To do this you use the <nowiki> and </nowiki> formatting tags.

For example: <nowiki>=== Level 3 ===</nowiki> disables rendering the text as a Level 3 heading and prevents it from showing up in the table of contents.

HTML

Occasionally you may need to mark up text using traditional HTML. This wiki does support use of HTML, but may not support every feature.

For example, if you need to created a bold italicized word or set of words, you can accomplish this using:

<b><i>text you want bold and italicized</i></b>

Additional HTML formatting tags that works are <p> </p> for paragraph formatting, <blockquote> </blockquote> for block quoting, and <pre> </pre> for showing formatted text. Formatted text is shown next.

1
  2
    3

Formatted text gets shown in an enclosing box.

Additionally formatting such as ordered, <ol> </ol>, and unordered,<ul> </ul>, lists are supported:

  1. Line 1
  2. Line 2
  3. etc.

  • Line 1
  • Line 2
  • Line 3

HTML Tables are also supported:

Column 1Column 2Column 3
Data 1Data 2Data 3

This is not an exhaustive list of HTML that can be used here. If you need other HTML formatting that isn't described here you should try it.

Italicized Text

To italicize text, include the text in a double set of apostrophes: ''your italicized text goes here''. Please note this isn't the use of the quote (") character but the double use of the apostrophe (') character.

A stub for italicized text can be created using the I icon button on the toolbar while editing your article. Optionally you can use the <i> </i> HTML tags to italicize text.

Additional Formatting Help

This WIKI is based on MediaWiki and additional help on formatting can be found on the MediaWiki Help:Formatting page.

Additional help, including Advanced Editing can be found on the MediaWiki Help:Contents page.

Wikipedia also has information on MediaWiki<ref>Wikipedia's MediaWiki Page</ref>.

Creating Hyperlinks

Perhaps you need to refer the reader to the definition of a word or an acronym. You can do this using a hyperlink to the definition. For example, suppose you want to define the term IDE, you can do that using this construct:

[http://en.wikipedia.org/wiki/Integrated_development_environment IDE]

While editing your article, a tool bar will be displayed at the top of the screen. You can use the world icon to create the hyperlink stub.

Another feature is to link relative to the web site and server, using [[ ]]. For example, the following link links to Subsection Level 4 above:

CSC/ECE_517_Fall_2011/WIKI_Features#Level_4

and was created using:

[[CSC/ECE_517_Fall_2011/WIKI_Features#Level_4]]

References

When writing an article for this WIKI, it is important to reference, or cite, quoted material you've used for creation of your article. Inline citations are supported by using the <ref> </ref> WIKI tags. For example, here's an inline citation<ref>This is an inline citation, or reference</ref> and was created using:

<ref>This is an inline citation, or reference</ref>

References or inline citations are automatically numbered for you<ref>This is another inline citation</ref> and was created using:

<ref>This is another inline citation</ref>

References can contain hyperlinks<ref>Wikipedia's HTML Definition</ref> which was created using:

<ref>[http://en.wikipedia.org/wiki/HTML Wikipedia's HTML Definition]</ref>


After using inline citation, you can use this WIKI tag to automatically create your formatted references list within your article:

<references />

See Example References below to see how these citations or references are formatted and displayed automatically.

Separator Line

To create a separator line, you place ---- (four dashes) at the beginning of line, and on a line by itself.


Table Of Contents

A table of contents can be created for you automatically by using headings and sub-headings as described in the Indentation Levels section of this article.

Tables

This WIKI supports a custom table construct:

{| class="wikitable" border="1"
|-
!
! Col 2
! Col 3
! Col 4
! Col 5
! col 6
|-
|  Row 1
|  R1 C2
|  R1 C3
|  R1 C6
|  R1 C5
|  R1 C8
|-
|  Row 2
|  R2 C2
|  R2 C3
|  R2 C6
|  R2 C5
|  R2 C8
|}

This construct generates this table:

Col 2 Col 3 Col 4 Col 5 col 6
Row 1 R1 C2 R1 C3 R1 C6 R1 C5 R1 C8
Row 2 R2 C2 R2 C3 R2 C6 R2 C5 R2 C8

Unordered Lists

Unordered lists can be created using an asterisk (*) at the beginning of a line. For example:

  • Line 1
  • Line 2
  • Line 3

Which was created using:

*Line 1
*Line 2
*Line 3

See also HTML subsection above.

Upload File

The WIKI supports a feature so that you can upload supporting files and reference them. These include images. To upload a file to your article space, follow these directions:

  1. Click on the Upload file link on the left hand side of the page located in the toolbox section.
  2. Browse for your file, fill in the form details.
  3. Click on the Upload File button to upload the file.

To include a file in a page, use a link in one of the following forms:<ref>WIKI File Upload Tool</ref>

  • [[File:File.jpg]] to use the full version of the file
  • [[File:File.png|200px|thumb|left|alt text]] to use a 200 pixel wide rendition in a box in the left margin with 'alt text' as description
  • [[Media:File.ogg]] for directly linking to the file without displaying the file

Using an uploaded image

Image to the right, with citations

Verrnack & Blupirk<ref>Verrnack & Blupirk</ref>

This is an example of placing an image on the right hand side of your subsection.

The image was placed there using this WIKI formatting text:

[[File:V&b-toward-earth.jpg|200px|thumb|right|Verrnack & Blupirk<ref>[http://vbcomic.com Verrnack & Blupirk]</ref>]]

Strange formatting issues can occur if you don't have sufficient text to offset the height of the graphic you're displaying.

These formatting issues can be overlapping sections or subsections.

This strange formatting will be shown until the text of the current or subsequent sections pass the vertical height of the graphic.

This is easily demonstrated with the section directly below. Notice how the subsection separator stops next to the image and doesn't go across the entire page.

Image to the left, with citations

Verrnack & Blupirk<ref>Verrnack & Blupirk</ref>

This is an example of placing an image on the right hand side of your subsection.

The image was placed there using this WIKI formatting text:

[[File:V&b-toward-earth.jpg|200px|thumb|left|Verrnack & Blupirk<ref>[http://vbcomic.com Verrnack & Blupirk]</ref>]]

Strange formatting issues can occur if you don't have sufficient text to offset the height of the graphic you're displaying.

These formatting issues can be overlapping sections or subsections.

This strange formatting will be shown until the text of the current or subsequent sections pass the vertical height of the graphic.

This is easily demonstrated with the section directly above.

To prevent the next section from being messed up by this subsection, this additional text is being added. It may not be sufficient for browsers that have a pixel width of greater than 1920.

Example References

<references />