Help:MediaWiki basics/Training review - Revision history

Shawndouglas: Minor tweaks

2016-05-19T19:48:03Z

Minor tweaks

← Older revision		Revision as of 19:48, 19 May 2016
Line 38:		Line 38:

	* This is a point I want to make.		* This is a point I want to make.

	* This point may logically follow the previous or it may stand by itself.		* This point may logically follow the previous or it may stand by itself.

	* And while no less important, this point is here on its own.		* And while no less important, this point is here on its own.

Line 47:		Line 45:
	<pre>		<pre>
	* This is a point I want to make.		* This is a point I want to make.

	* This point may logically follow the previous or it may stand by itself.		* This point may logically follow the previous or it may stand by itself.

	* And while no less important, this point is here on its own.		* And while no less important, this point is here on its own.
	</pre>		</pre>

Shawndouglas: Fixed pre tag

2013-10-28T17:32:53Z

Fixed pre tag

← Older revision		Revision as of 17:32, 28 October 2013
Line 153:		Line 153:
	And the code, with all the formatting marks in their full glory...		And the code, with all the formatting marks in their full glory...

	<pre>		<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;">
	<blockquote>		<blockquote>
	'''Once upon a time''' a sleepy sister Sarah ''constantly'' strove to stay awake. She sang a song that went a little something like this...		'''Once upon a time''' a sleepy sister Sarah ''constantly'' strove to stay awake. She sang a song that went a little something like this...

Shawndouglas: Corrected internal link

2013-10-23T19:25:52Z

Corrected internal link

← Older revision		Revision as of 19:25, 23 October 2013
Line 12:		Line 12:
	===The wiki===		===The wiki===

	[[File:Chiodini wiki.jpg\|right\|thumb\|300px]]You learned [[MediaWiki]] is free software licensed under the GNU General Public License (GPL). It's powerful, it's scalable, and it's full of features. It uses [[Help:~~Contents~~\|wikitext format]], a special set of codes to present information in the wiki. When content is edited in MediaWiki, previous versions of the page are retained, allowing easy reverts in case of [[LIMSWiki:Vandalism\|vandalism]] or spamming.		[[File:Chiodini wiki.jpg\|right\|thumb\|300px]]You learned [[MediaWiki]] is free software licensed under the GNU General Public License (GPL). It's powerful, it's scalable, and it's full of features. It uses [[Help:Formatting\|wikitext format]], a special set of codes to present information in the wiki. When content is edited in MediaWiki, previous versions of the page are retained, allowing easy reverts in case of [[LIMSWiki:Vandalism\|vandalism]] or spamming.

	From there you learned about what a wiki actually is. It allows authorized users to do what?		From there you learned about what a wiki actually is. It allows authorized users to do what?

Shawndouglas: /* Creating pages and organizing content */ Added definition list.

2013-10-23T19:03:25Z

Creating pages and organizing content: Added definition list.

← Older revision		Revision as of 19:03, 23 October 2013
Line 33:		Line 33:
	Once the page is started, you begin adding substance to it. If it's a page about say... the [[clinical laboratory]], you'll have plenty to write about: what it is, how it operates, and how it's regulated. That's likely three separate sections right there. You'll want to divide that content, and you do it by using headings and subheadings. You should immediately notice this "Creating pages and organizing content" section is subheaded to "MediaWiki review" for example.		Once the page is started, you begin adding substance to it. If it's a page about say... the [[clinical laboratory]], you'll have plenty to write about: what it is, how it operates, and how it's regulated. That's likely three separate sections right there. You'll want to divide that content, and you do it by using headings and subheadings. You should immediately notice this "Creating pages and organizing content" section is subheaded to "MediaWiki review" for example.

	Aside from creating sections with headers and subheaders, later entering paragraphs of text into those sections, we discussed at least ~~three~~ other ways to organize content on pages:		Aside from creating sections with headers and subheaders, later entering paragraphs of text into those sections, we discussed at least four other ways to organize content on pages:

	'''1.''' With bulleted lists like this...		'''1.''' With bulleted lists like this...
Line 67:		Line 67:
	</pre>		</pre>

	'''3.''' With tables like this...		'''3.''' With definition lists like this...

			;Defined word goes here.
			: Definition one goes here.
			: If you need a second definition, you can add it here.

			...formatted like this:

			<pre>
			;Defined word goes here.
			: Definition one goes here.
			: If you need a second definition, you can add it here.
			</pre>

			'''4.''' With tables like this...

	{\| class="wikitable"		{\| class="wikitable"

Shawndouglas: /* User functions */ Fixed sig.

2013-10-23T03:16:13Z

User functions: Fixed sig.

← Older revision		Revision as of 03:16, 23 October 2013
Line 253:		Line 253:
	----		----
	<br />		<br />
	That pretty much covers everything (in review style) discussed in the previous training sections. If you have any comments on this [[:Category:LIMSwiki training\|LIMSwiki training material]], please comment on my [[User talk:Shawndouglas\|user talk page]] and let me know how it can be improved. 23:14, 22 October 2013 (EDT)		That pretty much covers everything (in review style) discussed in the previous training sections. If you have any comments on this [[:Category:LIMSwiki training\|LIMSwiki training material]], please comment on my [[User talk:Shawndouglas\|user talk page]] and let me know how it can be improved. [[User:Shawndouglas\|Shawn Douglas]] 23:16, 22 October 2013 (EDT)

	<!---Place all category tags here-->		<!---Place all category tags here-->
	[[Category:LIMSwiki training]]		[[Category:LIMSwiki training]]

Shawndouglas: /* User functions */ Spacing

2013-10-23T03:15:35Z

User functions: Spacing

← Older revision		Revision as of 03:15, 23 October 2013
Line 250:		Line 250:

	* Watching pages: As you conduct time-consuming and demanding edits on pages, you may feel like you have a vested interest in their quality. You can watch pages and be notified of changes to them so you can provide better quality control of them.		* Watching pages: As you conduct time-consuming and demanding edits on pages, you may feel like you have a vested interest in their quality. You can watch pages and be notified of changes to them so you can provide better quality control of them.
			<br />
	----		----
			<br />
	That pretty much covers everything (in review style) discussed in the previous training sections. If you have any comments on this [[:Category:LIMSwiki training\|LIMSwiki training material]], please comment on my [[User talk:Shawndouglas\|user talk page]] and let me know how it can be improved. 23:14, 22 October 2013 (EDT)		That pretty much covers everything (in review style) discussed in the previous training sections. If you have any comments on this [[:Category:LIMSwiki training\|LIMSwiki training material]], please comment on my [[User talk:Shawndouglas\|user talk page]] and let me know how it can be improved. 23:14, 22 October 2013 (EDT)

	<!---Place all category tags here-->		<!---Place all category tags here-->
	[[Category:LIMSwiki training]]		[[Category:LIMSwiki training]]

Shawndouglas: Finished page.

2013-10-23T03:15:00Z

Finished page.

← Older revision		Revision as of 03:15, 23 October 2013
Line 226:		Line 226:
	===Categorizing pages===		===Categorizing pages===

			Categories are used in LIMSwiki to help readers navigate, sort, find articles, find related articles, and see how information is organized in the wiki. Categories are technically wiki pages that catalog other wiki pages under a common theme. Categories can be created and pages placed into one or more categories.

			You create a category like any other page, but you place it in the "Category:" namespace. For example: [[:Category:Vendor classes]]

			If you want to add a page to one or more categories, go to the bottom of the page and begin by adding this: <code><nowiki><!---Place all category tags here--></nowiki></code>

			Under that you'll begin adding categories using the <code><nowiki>[[Category:CategoryName]]</nowiki></code> format. Using our previous example:

			<pre>
			<!---Place all category tags here-->
			[[Category:Vendor classes]]
			</pre>

			===User functions===

			Finally, we also discussed some of the basic user-related functions of the wiki. Briefly, they were:

			* Creating a user profile: When you create an account, your user profile and user talk page aren't created. Creating these pages and building a sandbox into the user page is a useful way to get started practicing wiki markup.

			* Commenting and signing comments: You can write comments on yours and others' talk pages, as well as the talk pages associated with wiki pages. It's important to sign your comments with four tildes (<code><nowiki>~~~~</nowiki></code>).

			* Setting preferences: You can do ok in the wiki without setting preferences, but there are a few key preferences like selecting "E-mail me when my user talk page is changed" and increasing the size of your editing window that will make your wiki editing life easier.

			* Watching pages: As you conduct time-consuming and demanding edits on pages, you may feel like you have a vested interest in their quality. You can watch pages and be notified of changes to them so you can provide better quality control of them.

			----

			That pretty much covers everything (in review style) discussed in the previous training sections. If you have any comments on this [[:Category:LIMSwiki training\|LIMSwiki training material]], please comment on my [[User talk:Shawndouglas\|user talk page]] and let me know how it can be improved. 23:14, 22 October 2013 (EDT)

	<!---Place all category tags here-->		<!---Place all category tags here-->
	[[Category:LIMSwiki training]]		[[Category:LIMSwiki training]]

Shawndouglas: Added more to page.

2013-10-23T02:54:23Z

Added more to page.

← Older revision		Revision as of 02:54, 23 October 2013
Line 162:		Line 162:
	</blockquote>		</blockquote>
	</pre>		</pre>

			===Linking to other content===

			Both internal and external links help drive the currents of discovery and collaboration within and even outside the wiki. Without links, wiki pages would be much more static and lend themselves less to collaboration and cohesiveness.

			Links provide embedded navigation to other content within the wiki or to content outside the wiki. They are an important part of wiki editing and provide convenient avenues for further user research.

			Let's review link formation methods in MediaWiki:

			* Internal links require a set of double opening and closing square brackets, and the link text can stand alone as both the link to a specific page and as descriptive text: <code><nowiki>[[Informatics]]</nowiki></code> yields... [[Informatics]]

			* You can give internal links a new title by adding a pipe (\|) after the link title and then typing the text you want to appear: <code><nowiki>[[Informatics\|Yo mama (knows informatics)]]</nowiki></code> yields... [[Informatics\|Yo mama (knows informatics)]]

			* External links require a set of single opening and closing square brackets, and the link text can be omitted: <code><nowiki>[https://en.wikipedia.org/]</nowiki></code> yields... [https://en.wikipedia.org/]

			* It's much better to give external links a link title by adding one space and typing the text you want to appear in place of the URL: <code><nowiki>[https://en.wikipedia.org/ Wiki wiki oxenfree!]</nowiki></code> yields... [https://en.wikipedia.org/ Wiki wiki oxenfree!]

			===Adding media===

			We discovered that adding media can dress up a wiki page or even make it more functional. That wiki image at the top? It sure is colorful and adds something to an otherwise monotonous page of white and gray.

			We learned [[commons:Main Page\|Wikimedia Commons]] (WC) is a great starting point for finding public domain and copyright-free images, and LIMSwiki integrates with WC to make it easier for you to include media from there in your wiki content. You add media files using the <code><nowiki>[[File:FileName.format]]</nowiki></code> code format, though additional parameters can be added to better format images, videos, and soundfiles on your wiki pages.

			Here's an image file with most of the common parameters attached:

			[[File:Wiki Wiki Mart (Andjam79).jpg\|thumb\|left\|baseline\|100px\|alt=A grocery sign showing Wiki Wiki Mart\|Wiki Wiki Mart]]

			<br /> <br />

			And the code for that image: <code><nowiki>[[File:Wiki Wiki Mart (Andjam79).jpg\|thumb\|left\|baseline\|100px\|alt=A grocery sign showing Wiki Wiki Mart\|Wiki Wiki Mart]]</nowiki></code>

			<br /> <br /> <br />

			Video and sound files work in a similar fashion. Here's an example of a Wikimedia Commons sound file in .ogg format:

			[[File:Accordion chords-01.ogg\|noicon]] ...using the code <code><nowiki>[[File:Accordion chords-01.ogg\|noicon]]</nowiki></code>

			And here's an example using a Wikimedia Commons video file in .ogg format:

			[[File:Open research.ogg\|thumb\|left\|200px\|Open science]] ...using the code <code><nowiki>[[File:Open research.ogg\|thumb\|left\|200px\|Open science]]</nowiki></code>

			===Templates and citations===

			We mentioned you can also implement sound into a wiki using a thing called a template. What is that again? Oh yeah, a template is essentially a container that holds content you use frequently and need to deploy rapidly in an organized way. It could be a frequently used table, a set of boiler text, or a complicated set of code that calculates something for you. One example is the {{tl\|Ombox productfeature}} template, which appears on every [[:Category:Vendors\|vendor page]] containing product features. Instead of typing all that for every page, or even copy-pasting the code every time, a simple call to the templated content is all that's needed.

			Templates are called using the <code><nowiki>{{Template name}}</nowiki></code> syntax, and they may include modifiable parameters. The parameters will vary from template to template, and most templates have help documentation to assist users. We later went on to explain how the most common templates for the wiki are the citation templates, specifically:

			* {{tl\|Cite web}}: <code><nowiki><ref name="">{{Cite web \|url= \|format= \|title= \|work= \|author= \|publisher= \|date= \|accessdate=}}</ref></nowiki></code>

			* {{tl\|Cite book}}: <code><nowiki><ref name="">{{Cite book \|url= \|chapter= \|title= \|author= \|pages= \|publisher= \|year= \|edition= \|volume= \|isbn= \|accessdate=}}</ref></nowiki></code>

			* {{tl\|Cite journal}}: <code><nowiki><ref name="">{{Cite journal \|url= \|format= \|journal= \|chapter= \|title= \|author= \|year= \|volume= \|issue= \|pages= \|pmid= \|doi= \|accessdate=}}</ref></nowiki></code>

			* {{tl\|Cite news}}: <code><nowiki><ref name="">{{Cite news \|url= \|format= \|title= \|author= \|agency= \|publisher= \|newspaper= \|pages= \|location= \|date= \|accessdate=}}</ref></nowiki></code>

			The code is placed after a statement requiring citation. A unique "ref name" is assigned to the citation; if the citation needs to be used again later, only a call to the "ref name" (like this: <code><nowiki><ref name="UniqueName" /></nowiki></code>) is needed, saving work for the editor. The rest of the parameters in the citation template are completed with the applicable source information. Finally, the following code is required at the bottom of the page to correctly display the citations:

			<pre>
			==References==
			<references />
			</pre>

			===Categorizing pages===


	<!---Place all category tags here-->		<!---Place all category tags here-->
	[[Category:LIMSwiki training]]		[[Category:LIMSwiki training]]

Shawndouglas: Corrected formatting issue

2013-10-23T01:56:17Z

Corrected formatting issue

← Older revision		Revision as of 01:56, 23 October 2013
Line 130:		Line 130:
	what I had left behind.</pre>		what I had left behind.</pre>

	She found she had reached the point of sleepiness<sup>2</sup> afterwards. She fought to keep her eyes open. Yet by the door she also saw a book with the title <tt>True Sleep Is Never Far Away</tt>.		She found she had reached the point of sleepiness<sup>2</sup> afterwards. She fought to keep her eyes open. Yet by the door she also saw a book with the title "<tt>True Sleep Is Never Far Away</tt>".

	She opened to a random page to find the following words: "When <strike>sleep</strike> dreams overtake you, fly freely with the <u>current</u>."		She opened to a random page to find the following words: "When <strike>sleep</strike> dreams overtake you, fly freely with the <u>current</u>."
Line 137:		Line 137:
	</blockquote>		</blockquote>

	And the code...		And the code, with all the formatting marks in their full glory...

	<pre>		<pre>
Line 155:		Line 155:
	what I had left behind.</pre>		what I had left behind.</pre>

	She found she had reached the point of sleepiness~~<~~sup~~>~~2~~<~~/sup~~>~~ afterwards. She fought to keep her eyes open. Yet by the door she also saw a book with the title ~~<~~tt~~>~~True Sleep Is Never Far Away~~<~~/tt~~>~~.		She found she had reached the point of sleepiness<sup>2</sup> afterwards. She fought to keep her eyes open. Yet by the door she also saw a book with the title "<tt>True Sleep Is Never Far Away</tt>".

	She opened to a random page to find the following words: "When <strike>sleep</strike> dreams overtake you, fly freely with the <u>current</u>."		She opened to a random page to find the following words: "When <strike>sleep</strike> dreams overtake you, fly freely with the <u>current</u>."
Line 162:		Line 162:
	</blockquote>		</blockquote>
	</pre>		</pre>


	<!---Place all category tags here-->		<!---Place all category tags here-->
	[[Category:LIMSwiki training]]		[[Category:LIMSwiki training]]
	~~/sup> afterwards. She fought to keep her eyes open. Yet by the door she also saw a book with the title~~

Shawndouglas: Added content. Still have an unresolved error somewhere.

2013-10-23T01:48:47Z

Added content. Still have an unresolved error somewhere.

← Older revision		Revision as of 01:48, 23 October 2013
Line 27:		Line 27:
	# did we mention "collaborate"?		# did we mention "collaborate"?

	===Creating and organizing ~~pages~~===		===Creating pages and organizing content===

	Creating a page involves choosing the right [[Help:Namespaces\|namespace]], [[Main_Page/news#April_18.2C_2011:\|selecting an appropriate title]], entering the title into the search box, selecting "Go", and choosing the option to create the page on the wiki. Of course, namespaces have particular purposes, titles have naming conventions, and page content has particular formatting and organization requirements, at least to meet the standards of LIMSwiki.		Creating a page involves choosing the right [[Help:Namespaces\|namespace]], [[Main_Page/news#April_18.2C_2011:\|selecting an appropriate title]], entering the title into the search box, selecting "Go", and choosing the option to create the page on the wiki. Of course, namespaces have particular purposes, titles have naming conventions, and page content has particular formatting and organization requirements, at least to meet the standards of LIMSwiki.

	Once the page is started, you begin adding substance to it. If it's a page about say... the [[clinical laboratory]], you'll have plenty to write about: what it is, how it operates, and how it's regulated. That's likely three separate sections right there. You'll want to divide that content, and you do it by using headings and subheadings. You should immediately notice this "Creating and organizing ~~pages~~" section is subheaded to "MediaWiki review" for example.		Once the page is started, you begin adding substance to it. If it's a page about say... the [[clinical laboratory]], you'll have plenty to write about: what it is, how it operates, and how it's regulated. That's likely three separate sections right there. You'll want to divide that content, and you do it by using headings and subheadings. You should immediately notice this "Creating pages and organizing content" section is subheaded to "MediaWiki review" for example.

			Aside from creating sections with headers and subheaders, later entering paragraphs of text into those sections, we discussed at least three other ways to organize content on pages:

			'''1.''' With bulleted lists like this...

			* This is a point I want to make.

			* This point may logically follow the previous or it may stand by itself.

			* And while no less important, this point is here on its own.

			...formatted like this:

			<pre>
			* This is a point I want to make.

			* This point may logically follow the previous or it may stand by itself.

			* And while no less important, this point is here on its own.
			</pre>

			'''2.''' With numerical ordered lists like this...

			# Item number one goes here.
			# Item number two goes here.
			# And let's not forget item number three.

			...formatted like this:

			<pre>
			# Item number one goes here.
			# Item number two goes here.
			# And let's not forget item number three.
			</pre>

			'''3.''' With tables like this...

			{\| class="wikitable"
			\|-
			! colspan="3"\| Wonder Books Prices
			\|-
			! style="color:green; background-color:#afafba;" \| Product
			! style="color:green; background-color:#afafba;" \| Student price
			! style="color:green; background-color:#afafba;" \| Commercial price
			\|-
			\| '''Summer Has Gone'''
			\| style="background-color:white;" align="center" \| $12.95
			\| style="background-color:white;" align="center" \| $15.95
			\|-
			\| '''Winter Is Coming'''
			\| style="background-color:white;" align="center" \| $13.49
			\| style="background-color:white;" align="center" \| $16.19
			\|-
			\|}

			...formatted like this:

			<pre>
			{\| class="wikitable"
			\|-
			! colspan="3"\| Wonder Books Prices
			\|-
			! style="color:green; background-color:#afafba;" \| Product
			! style="color:green; background-color:#afafba;" \| Student price
			! style="color:green; background-color:#afafba;" \| Commercial price
			\|-
			\| '''Summer Has Gone'''
			\| style="background-color:white;" align="center" \| $12.95
			\| style="background-color:white;" align="center" \| $15.95
			\|-
			\| '''Winter Is Coming'''
			\| style="background-color:white;" align="center" \| $13.49
			\| style="background-color:white;" align="center" \| $16.19
			\|-
			\|}
			</pre>

			===Formatting textual content===

			We learned there are numerous ways to format the text you enter into the wiki. Some of those methods use built-in MediaWiki code, while others use HTML-based codes to render text a certain way.

			Let's throw all those formatting methods into a piece of text, just for fun. Then we'll show the code used to get the result:

			<blockquote>
			'''Once upon a time''' a sleepy sister Sarah ''constantly'' strove to stay awake. She sang a song that went a little something like this...

			<pre>Slumber grips me
			tight and true.
			Why I fight it
			I can't say.

			Sighing softly
			I climb the stairs,
			open the door,
			and peek inside,
			only to find
			what I had left behind.</pre>

			She found she had reached the point of sleepiness<sup>2</sup> afterwards. She fought to keep her eyes open. Yet by the door she also saw a book with the title <tt>True Sleep Is Never Far Away</tt>.

			She opened to a random page to find the following words: "When <strike>sleep</strike> dreams overtake you, fly freely with the <u>current</u>."

			<code><nowiki>What could this mean?</nowiki></code> she pondered.
			</blockquote>

			And the code...

			<pre>
			<blockquote>
			'''Once upon a time''' a sleepy sister Sarah ''constantly'' strove to stay awake. She sang a song that went a little something like this...

			<pre>Slumber grips me
			tight and true.
			Why I fight it
			I can't say.

			Sighing softly
			I climb the stairs,
			open the door,
			and peek inside,
			only to find
			what I had left behind.</pre>

			She found she had reached the point of sleepiness<sup>2</sup> afterwards. She fought to keep her eyes open. Yet by the door she also saw a book with the title <tt>True Sleep Is Never Far Away</tt>.

			She opened to a random page to find the following words: "When <strike>sleep</strike> dreams overtake you, fly freely with the <u>current</u>."

			<code><nowiki>What could this mean?</nowiki></code> she pondered.
			</blockquote>
			</pre>


	<!---Place all category tags here-->		<!---Place all category tags here-->
	[[Category:LIMSwiki training]]		[[Category:LIMSwiki training]]
			/sup> afterwards. She fought to keep her eyes open. Yet by the door she also saw a book with the title