390 likes | 575 Views
Introducing: wiki.leveragingtechnology.com. Keith Crossley; June 2010. Goal (and rough agenda). What’s a wiki? Why do we need (have) one? Who uses it; updates it; controls it? How do we use it? The parts & features of the wiki Editing: authoring, formatting linking
E N D
Introducing: wiki.leveragingtechnology.com Keith Crossley; June 2010
Goal (and rough agenda) • What’s a wiki? • Why do we need (have) one? • Who uses it; updates it; controls it? • How do we use it? • The parts & features of the wiki • Editing: • authoring, formatting • linking • Files, media, images • “Tagging” – categories, properties, queries • How do I…?
A Word… • Except for Main Page – all the content in our wiki is behind a user ID / password • You cannot break it. • All versions of every revision of content are kept. You can undo anything. • Have fun. Be creative.
What’s a wiki? • A central place to create, store, reference and share information. • Instead of • Share drives & hard drives • Saved Emails, etc • A central place to find and access information • A central place to collaborate on building information.
What’s a wiki? Information as “data” Information: “articles” Links blue(page exists) red (page not there yet) Taxonomy
Why do we need (have) one? • Information • More and more information that we need to know • Diverse, and often dispersed, team that needs to collaborate • Capture, organize, share, find, discuss • Wiki • Truly shared. It’s our wiki • Add, update, fix, improve • Act independently; act collaboratively
Discuss discussion tab Edit the discussion sign & date --~~~
Share Share the information link; not an attachment; not an Email
Creating wiki Articles • New articles can be created • From a Search (not found) • From the browser address bar • From a link • Encouraged • Reduces chances of “orphans”
Creating a new article From Search From browser
Text editor – with simple markup Heading (like H1) Content Controls
Text editor – with simple markup Preview
Creating a link A simple link in the wiki is created by using double brackets around one or more words.
Headings and Lists generates See navigation > Help in the side menu for details on markup
Some More Links Actual page name Reads as http link Reads as
Uploading Files generates
Files referenced on a wiki page generates Note: links to things like Word or PDF documents should substitute “Media” for “File” in the link.
Slightly more advanced topics(these are concepts and features we’ll use from the beginning; just like any other technology, you can see the idea here then look at example code to see how to make it work)
Categorizing & “Semantic Markup” of Pages • Effective categorization and markup make a huge difference in the power, ease of use and simple ability to find stuff in the wiki. • There are two techniques: • Categorization • the basic wiki feature out of the box • Articles can be in multiple categories / subcategories • Semantic MediaWiki (“SMW”) • An extension to MediaWiki • Works with Categorization • Text in an article becomes “data”
Categorization When we save the article with the Category markup the categories are displayed as links Clicking the link takes us to the Category page where all articles in the category are listed.
Semantics Standard MediaWiki way
Semantic MediaWiki Way Link to the New York page
Semantic Query Selection by category &/or property &/or value Properties to display Generates
LT Templates Templates are a very useful mechanism in MediaWiki – a sort of “macro” capability that can mask complex or repetitive code. We can create our own. An example of template use : Creates LT Templates have been created for a number of purposes (e.g. Education). They are documented in the Help section.
Some Current LT Templates EducPageList EducCourse Draft Stub Needs Classification EducCert Glossary Knowledge Lists courses & certifications for the current (subject) page title Usage: {{EducPageList}} Applies properties to a page about a course Usage: {{EducCourse|Subject=LotusForms|Certification=Sales Mastery}} Categorizes the article as a draft, stub or needs classification Usage: {{Draft}} {{Stub}} {{Needs Classification}} Applies properties to a page about a certification Usage: {{EducCert|Subject=LotusForms}} Define the meaning of a term (the page name) to display on the Glossary Usage: {{Glossary|what it means}} Identifies an article or file as part of Knowledge base, with properties Usage: {{Knowledge|Domain=Architecture|Issue=…..}} * * Note – a template may have keywords or may be positional, like {{Glossary}}.
Some Current LT Properties Certification Domain Subject Issue Company Client Meaning Name of a Certification Knowledge area Subject of a Course Knowledge area Associates the article with a company Associates the article (e.g. about a project) with a client (perhaps should be combined with Company) Glossary entry
Rather more advanced topics(there’s no need to master these, but it’s good to be aware; it would have saved me a lot of aggravation if I’d known about these things earlier than I did)
Special Pages • Special • There are regular wiki articles and then there are “Special Pages” that you have occasion to use, including: • Category • File • Template • Property • User • You will recognize these in the browser’s address box http://wiki.leveragingtechnology.com/ltwiki/index.php?title=User:Keith_Crossley
User Pages • Everyone gets one: User:Your_Login • Everyone is encouraged to build theirs (good wiki practice). • Note that if you create a link to [[Keith Crossley]] that’s a different place from[[User:Keith Crossley]] • The following page shows ways to resolve that.
Linking to a Special Page this generates this So you can do something like this This probably seems a bit obscure right now, but it can be handy to know. And it can apply to other things like Category pages.
Redirect If you searched or linked to simply [[Websphere]] on Wikipedia the following page comes up (note the title): This happens because there actually is a page [[Websphere]], that “Redirects” to [[IBM WebSphere]]. It looks like this: This can be handy for situations like the example, and when you have a regular page and special page with the same name.
More? • Use Help links to MediaWiki.org and Semantic-MediaWiki.org • Look for examples on LT wiki or Wikipedia • Ask • Experiment