wiki essentials
DESCRIPTION
Wiki Essentials. What you need to know http://wiki.mismo.org. What is a Wiki? Some Common Wikis Important Wiki Concepts Wiki’s Role in MISMO Getting Around Left Menu Search/Quick Navigation Document Tabs Top Menu Getting Setup Creating Wiki pages Editing Pages Two Editor Options - PowerPoint PPT PresentationTRANSCRIPT
![Page 2: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/2.jpg)
2 Table of Contents
Table of Contents• What is a Wiki?• Some Common Wikis• Important Wiki Concepts• Wiki’s Role in MISMO• Getting Around
– Left Menu– Search/Quick Navigation– Document Tabs– Top Menu
• Getting Setup• Creating Wiki pages• Editing Pages
– Two Editor Options– Some Wiki Syntax– Plain Text Editor– Side-by-Side Example– WikiWizard (WYSIWYG Editor)
• Formatting– Page Structure– Bulleted & Numbered Lists– Links Expanded– Tables & Tabs
• Plugins• Customizing & Extending the
Wiki• Best Practices• Most Common Formatting
Rules
![Page 3: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/3.jpg)
3 Table of Contents
What is a Wiki?• “wiki” comes from the Hawaiian word which
means “fast”
• You can see a pretty good definition at Wikipedia, but it is basically a web application that supports collaborative authoring of Web pages. The model is very dynamic and non-hierarchical. Wikis are extremely useful in places where the relationships between web pages are non pre-defined.
![Page 4: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/4.jpg)
4 Table of Contents
Some Common Wikis• There are thousands of Wikis in use today. Wikis can provide a
benefit any time there is a community of people with a shared interest in some subject.
– Wikipedia (http://en.wikipedia.org)• The granddaddy of them all. Wikipedia is an encyclopedia of everything
– LostWiki (http://lostwiki.abc.com)• ABC's Wiki on the TV show "Lost".
– Solar Cooking Site (http://solarcooking.wikia.com)• A site about solar cooking
– Wookieepedia (http://starwars.wikia.com)• Star Wars encyclopedia and all things Wookie.
![Page 5: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/5.jpg)
5 Table of Contents
Important Wiki Concepts• Keyword-based/Topic-based documents
– Documents have an absolute name indicating their topic– Example document names;
• PhotoSynthesis• NamespaceApproach• XmlSchema
– Expectation is that there is single page for a given topic.
• Reuse (References Rather than Embedding)– When one topic needs to reference another, links are used rather than repeating
content• PhotoSynthesis -> Chlorophyll• NamespaceApproach -> LinkingApproach• XmlSchema -> Internationalization
• Linking– Lightweight Approach – links just use the keyword rather than complete URLs– Links can be made in anticipation of content that is not there
![Page 6: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/6.jpg)
6 Table of Contents
Wiki Concepts (cont…)• Flat Repository
– No assumptions about hierarchy and relationships among documents
• Edit in Place– Changing content is easy, is done right in the same browser that is used for
navigating and viewing. – Source Control happens automatically– Pages compared on check-in to make sure no collision occurs
• Lightweight Syntax– Markup is lightweight and text based.– Rendering with different looks and feels done with styles– Can edit with text editor or WSIWYG editor
![Page 7: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/7.jpg)
7 Table of Contents
Wiki's Role in MISMO• For Managing
– I-Guides– Engineering Guidelines– Commonly referenced documentation– Rapidly changing documents like task lists
• Changing the Process– More collaboration– Smaller more manageable topics
• Re-use and Modularity– Lighter-Weight process– More inter-linking
• Why not Sharepoint?– Strict Hierarchy versus web of data– Sharepoint is subscriber-only– Wiki has more comprehensive linking support
![Page 8: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/8.jpg)
8 Table of Contents
Getting AroundLeft Menu Breadcrumbs
Main Content Area
Search/Quick Navigation
Top MenuDocument Tabs
![Page 9: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/9.jpg)
9 Table of Contents
Left Menu
• This is a nod to hierarchy
• Contains common starting points for navigating the Wiki
• Content to be finalized
![Page 10: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/10.jpg)
10 Table of Contents
Search/Quick Navigation
• Allows search on document names and content• In Upper right Corner
Basic Mouse-Over Search for term “Secondary”
![Page 11: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/11.jpg)
11 Table of Contents
Document Tabs
• View Tab– Displays main content of the page & available menus
• Attach Tab– Shows list of existing attachments and allows authenticated
users to upload and manage documents.
![Page 12: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/12.jpg)
12 Table of Contents
Document Tabs: Info Tab
• Version History Sub-Tab– Note: you can link to specific versions
• Incoming Links Sub-Tab• Outgoing Links Sub-Tab
![Page 13: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/13.jpg)
13 Table of Contents
Top Menu
• Home– Link to the MISMO Wiki Home Page
• Edit– Only available if you are logged in
• Comment?– Option to add a comment to a page
• Index– Displays an Alphabetical list of all documents (pages)
• Changes– Displays recent changes for entire MISMO Wiki site, not a particular document
• Prefs– Allows you to change your user preferences
• Login/Logout– Allows you to Login to edit or Logout from the wiki– Login is not required to view pages
![Page 14: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/14.jpg)
14 Table of Contents
Getting Set up• Your Preferences
– Can adjust setting– Most important thing is your “skin”
• Controls look and feel of site
• Logging in– You must be logged into edit content– On the honor system – not tied to formal security– Full names should be used
• “JohnSmith”, not “SurferBoy312”
![Page 15: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/15.jpg)
15 Table of Contents
Creating Wiki Pages• Start with References
– Pages are only useful if people can find them– Is your page related to pages that exist already?– Linking to non-existent page creates a placeholder
• Page Name Standards – Wiki uses MixedCamelCase – For example “MyTopicPage”– Plurals don’t matter
• Create a link in Sandbox page – http://wiki.mismo.org/MISMOWiki/Wiki.jsp?page=Sandbox
• Links take the form [<linktext>] or [<displaytext>|<linktext>]– *[MyTopicPage]– *[My Topic Page]– *[My Topic|MyTopicPage]– *[MyTopicPages]
![Page 16: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/16.jpg)
16 Table of Contents
Editing Pages• Follow “Edit” link in the Top Menu to edit existing
pages (link only appears when logged in).
• Must use Wiki markup. For help when editing a page, a “Help” Document tab appears with the most common formatting rules.
• Complete Syntax Guide in Wiki document TextFormattingRules – http://wiki.mismo.org/MISMOWiki/Wiki.jsp?page=Text
FormattingRules
![Page 17: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/17.jpg)
17 Table of Contents
Two Editor Options
• Plain Text Editor• WikiWizard
![Page 18: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/18.jpg)
18 Table of Contents
Some Wiki Syntax• Formatting Text
• Bold by bracketing with “__”: “__BoldText__”• Italics by bracketing with “’’’”: “’’’ItalicText’’’”• CSS for complex formatting:
• %%(color:red) This text is red. %%
• Embedded Images• Just create a link to them• Example:
• [{Image src='BREWDiagram.jpg' width='900' height='800‘ align='center' }]
![Page 19: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/19.jpg)
19 Table of Contents
Plain Text Editor
• Must learn simple wiki Markup– See sample on next slide
• Screen background will change colors (usually blue)
“Plain” editor is selected
![Page 20: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/20.jpg)
20 Table of Contents
Side By Side Example
• Edit in Place– Changing content is easy, is
done right in the same browser that is used for navigating and viewing.
– Source Control happens automatically
– Pages compared on check-in to make sure no collision occurs
• Lightweight Syntax– Markup is lightweight and text
based.– Rendering with different looks
and feels done with styles– Can edit with text editor or
WYSIWYG editor
*__Edit in Place__**Changing content is easy, is done
right in the same browser that is used for navigating and viewing.
**Source Control happens automatically
**Pages compared on check-in to make sure no collision occurs
*’’Lightweight Syntax’’**Markup is lightweight and text
based.**Rendering with different looks and
feels done with styles**Can edit with text editor or
[WYSIWYG|wikipedia:Wysiwyg] editor
!!!Side By Side Example
![Page 21: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/21.jpg)
21 Table of Contents
WikiWizard
• WYSIWYG (what you see is what you get) editor• Useful when working with tables
“WikiWizard” editor selected
![Page 22: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/22.jpg)
22 Table of Contents
WikiWizard w/ Tables
||Date||Agenda ||Minutes ||Type ||Discussion ||Documents|July 10, 2007|[Agenda|Agenda071007]|[Minutes|Minutes071007]|Conference Call|[Discussion|Meeting071007Discussion]| [Bulk Bid Use Case |https://sharepoint.mismo.org/secondary/Shared%20Documents/3.x%20Work/Pricing/Bulk%20Bid%20Pricing/Bid%20Process%20Business%20Use%20Case%20Draft%2020070709.doc], [Bulk Bid Pricing Worksheet|https://sharepoint.mismo.org/secondary/Shared%20Documents/3.x%20Work/Pricing/Bulk%20Bid%20Pricing/BulkBidPricingWorksheet.xls]|June 19, 2007|[Agenda|Agenda061907]|[Minutes|Minutes061907]|Conference
Equivalent Plain Text Editor
![Page 23: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/23.jpg)
23 Table of Contents
Page Structure
• Headers are used for high level page structure– Headers visually partition a page– Headers create Anchors for direct links to sub-topics– Headers drive the table of contents– Syntax
Wiki Markup What You See• !!!Biggest Header Biggest Header• !!Medium Header Medium Header• !Smaller Header Smaller Header
![Page 24: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/24.jpg)
24 Table of Contents
Bulleted and Numbered Lists
Wiki Markup *Parent Bullet
**Child Bullet***Grandchild Bullet
# Parent Bullet ##Child Bullet 1##Child Bullet 2###Grandchild Bullet
What You See• Parent Bullet
– Child Bullet• Grandchild Bullet
1. Parent Bullet1. Child Bullet 12. Child Bullet 21. Grandchild Bullet
• * and # for bulleted and numbered lists respectively
• Repeat for indentation
![Page 25: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/25.jpg)
25 Table of Contents
Links Expanded• Link to a local wiki page
• Syntax: [<displayname>|<page>] or [<page>]• Example: [Mismo Word Guidelines|ClassWords] Mismo Word Guidelines
• Link to an Attachment• Syntax: [<displayname>|<attachment name>]• Example: [Project Schedule|schedule.xls] Project Schedule
• Page subtopic • Syntax: [<displayname>|<page>#<header>]• Example: [Guideline|Terms#Guideline] Guideline
• Foreign Links• Syntax: [<displayname>|<url>]• Example: [SISAC|http://www.sisac.org/default.html] SISAC
• InterWiki Links• Assumes administrator has set up alias• Syntax: [<displayname>|<wikiname>:<page>]• Example: [Mortgage|wikipedia:Mortgage] Mortgage
What You See
![Page 26: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/26.jpg)
26 Table of Contents
Tables & Tabs• Tables
– Example||Header 1||Header2|Row1Col1|Row1Col2|Row2Col1|Row2Col2
– Will make table sortable by column headers if you enclose within %%sortable %%
– Can be more easily maintained with WikiWizard
• Tabs– Example
%%tabbedSection%%tab-Tab1<Tab 1 content>%%%%tab-Tab2<Tab 2 content>%%
Header 1 Header2Row1Col1 Row1Col2Row2Col1 Row2Col2
![Page 27: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/27.jpg)
27 Table of Contents
Plugins• When using any plugin, the syntax is as follows:
– [{<PluginName>}]
• Some Important Plugins– Table of Contents
• Displays TOC with links to sections. • Based on header names.• [{TableOfContents}]
– InsertPage Plugin• Embeds the content of another page in this one• [{InsertPage page=‘<PageName>'}]
Section Menu
![Page 28: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/28.jpg)
28 Table of Contents
Customizing & Extending the Wiki• We can create custom Plugins
• We can create New Templates and skins
![Page 29: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/29.jpg)
29 Table of Contents
Best Practices• Keep pages small and on-topic
• Create obvious page names
• Don’t re-invent the wheel (look for similar pages before making a new one)
• Compose complex “documents” from small topics
• Don’t hesitate to put drafts out there, Refactor, redo later
• Work the Undefined Pages
• Create Page references for concepts that need to be fleshed out
![Page 30: Wiki Essentials](https://reader036.vdocuments.mx/reader036/viewer/2022062520/56816024550346895dcf2ad2/html5/thumbnails/30.jpg)
30 Table of Contents
Most Common Formatting Rules