This is a short introductory training course for Foswiki beginners.

End Presentation


Foswiki Slide Show A Taste of Foswiki Next

Hula girl The basic function of Foswiki is a Wiki (if that helps!)

A Wiki is like a web site, except that you can edit the content in your browser

  • "Wiki" is short for "wiki wiki", the Hawaiian for "Quick"
  • The idea originates from Macintosh Hypercard, via Ward Cunningham
  • In Ward's words, Wiki is "the simplest online database that could possibly work"
  • A Wiki is basically a shared, online, persistent whiteboard

First slide Previous Next Last slide  Slide 1 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Foswiki Wiki Next

Whiteboard Foswiki implements the basic Wiki idea of a shared whiteboard

  • Anyone can add content
    ... or change what is written
    ... or change the organisation of the content
  • Whatever what you write is
    ... nicely presented
    ... remembered... and never forgotten

Foswiki also acts as an "application platform" to integrate a number of other functions.

Foswiki is an Open-Source development on http://foswiki.org/

  • governed by an association called Foswiki Association
  • with over 100 regular contributors in many countries

First slide Previous Next Last slide  Slide 2 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Foswiki features Next

Foswiki builds on the original Wiki concept and adds a number of features that make it very useful in a business environment.

  • Foswiki pages are fully revision controlled, so a record of every change to every page is kept
    r6 < r5 < r4 < r3 < r2

  • The look-and-feel is highly configurable, through use of templates
  • A "plugins" interface eases
    • customisation
    • extension
    • application integration

First slide Previous Next Last slide  Slide 3 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Applications of basic Foswiki Next

Basic Foswiki can be used as:

  • A whiteboard
  • A document repository
  • A collaborative authoring environment
  • A notebook / scrapbook
  • A chat room

First slide Previous Next Last slide  Slide 4 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Extended applications Next

Foswiki-with-extensions can be used as:

  • A Content Management System (CMS) for websites
  • A presentation development tool
  • A Blog
  • A database
  • A project management system
  • A tracking tool
  • (truth is, we don't really know its limits!)

First slide Previous Next Last slide  Slide 5 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Structure of a Foswiki page Next

Foswiki pages are usually organised into three parts:

  • A header
  • A body
  • A footer

  • The header and the footer are generated by the system
  • The body contains the text of the page, as entered by you
Foswiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)

First slide Previous Next Last slide  Slide 6 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show The page header Next

The header of a Foswiki page is generally highlighted in colour, and will usually contain an icon that gives you an idea of where you are, such as a company logo. It will also usually contain:

  • A Search box that allows you to look for topics or content all over the Foswiki site
  • A Jump box where you can type in the name of a page you already know.

myco.gif

First slide Previous Next Last slide  Slide 7 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show The menu - part 1 Next

The menu, normally located either on the right or the left side of the content, by default includes a toolbox and a web section.

The Toolbox section contains these items

  • Toolbox
  • newtopic Create New Topic - for creating new topics via a menu
  • index Index - an alphabetical listing of all topics in the web
  • searchtopic Search - leads to a more advanced search page
  • changes Changes - shows a list of recently changed topics
  • notify Notifications - allows you to subscribe to receiving emails when topics change
  • feed RSS Feed
  • statistics Statistics - for the activities current web
  • wrench Preferences - settings for the current web

It is common that the administrator simplifies the toolbox so you may not have all these items in your menu bar.

First slide Previous Next Last slide  Slide 8 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show The menu - part 2 Next

The Webs section lists all the webs

  • Webs
  •  Main
  •  Myco
  •  Project
  •  Sandbox
  •  System

A web is a collection of pages that are related closely together

The Main contains all the user home pages. The System contains documentation for Foswiki and all extensions. The Sandbox is a playground area.

The system administrator can add any number of webs to the system.

First slide Previous Next Last slide  Slide 9 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show The menu - part 3 Next

Besides the Tools and Webs sections it it common to add your own links to important places.

These menu points can be different from web to web.

  • Myco
  • Important topic
  • Company philosophy

First slide Previous Next Last slide  Slide 10 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show The page footer Next

Near the footer of the page you find an action bar which looks similar to this

Edit | Attach | Print version | History: r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions

  • The Edit link takes you to an interactive page where you can change the page content using an advanced editor
  • The Attach link lets you attach files
  • Print version shows the page without any menus or top bars - for printing on paper
  • History allows you to see older versions and what changed from version to version
  • Raw View/Edit is for seeing and editing the raw markup
  • Backlinks shows which other pages link to this page
  • More topic actions - takes you to a menu of more advanced features

First slide Previous Next Last slide  Slide 11 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Editing Pages Next

  • You've read a page, and you disagree with it violently! It says:
    Everyone knows that the world is an OblateSpheroid
    But you know for a fact it is flat! wink
  • You've clicked the edit link, and an edit page has appeared.
    • Depending on your site configuration and with some luck, you will see some kind of WYSIWYG-editor and can start writing right away.
    • But it might happen that it doesn't look much like what was on the page before - it's full of strange hieroglyphics!
_Everyone_ *knows* that =the world= is an OblateSpheroid
  • Now what?

First slide Previous Next Last slide  Slide 12 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show What's in a page Next

  • The hieroglyphics are what's known as "Topic Markup" or "formatting"
  • They are a really simple way of telling the browser how you want the page to look
  • You don't have to use them
    • Foswiki understands pages in plain text just fine.

      Actually it is perfectly and absolutely flat

      appears as

      Actually it is perfectly and absolutely flat

First slide Previous Next Last slide  Slide 13 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Formatting just makes pages prettier Next

... and easier to read

_Actually_ it is *perfectly* and __absolutely__ flat

appears as

Actually it is perfectly and absolutely flat

  • A full description of all the formatting can be found in the TextFormattingRules and WikiSyntax
  • The best thing to do is just to type until you get stuck
    • then follow the link on the edit page to the help.

First slide Previous Next Last slide  Slide 14 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Commonly used formatting Next

Foswiki understands pages in plain text just fine, but you can jazz them up using some simple formatting shortcuts. Here are some of the more commonly used ones:

  • ---+ indicates a heading. Add more +'s for a deeper heading.
    You type You see
    ---+ This is a heading

    This is a heading

    ---++ And so is this

    And so is this

  • %TOC% will insert a table of contents

First slide Previous Next Last slide  Slide 15 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show More common formatting Next

  • A blank line gives a paragraph break
  • --- on a line of its own gives a horizontal bar
  • Text in stars *like this* looks like this
  • Text in underscores _like this_ looks like this
  • Text in equals signs =like this= looks like this
  • Bulleted lists use three spaces followed by an asterisk (*) at the start of the line
    • The depth of the bullet is given by the number of spaces, in multiples of three
You type You see
   * Bullet
      * Sub-bullet
  • Bullet
    • Sub-bullet
  • Numbered lists use a number in place of the *. The list is numbered automatically, so you can just use a 1

First slide Previous Next Last slide  Slide 16 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Even more..... Next

  • You can create a table using vertical bars:
     | Cat | Feline |
     | Bear | Ursine |
     | Wolf | Lupine |
  • appears as
    Cat Feline
    Bear Ursine
    Wolf Lupine
  • %RED% .... %ENDCOLOR% will change the colour of the enclosed text. Lots of colours are available (%RED%, %GREEN%, %BLUE% etc)

First slide Previous Next Last slide  Slide 17 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show WikiWords Next

  • One special hieroglyph that is very important is a WikiWord
    • a word that starts with uppercase, then some lowercase, then more uppercase (a.k.a CamelCase)
  • This has a special meaning to Foswiki. If it matches the name of another topic, Foswiki will automatically create a link to that page for you.
  • If there is no such page, then the word is highlighted and has a question mark put after the word, LikeThis?
  • If you click on the question mark, then Foswiki will invite you to create that page.

  • This lets you enter the names of topics you think should exist, but don't yet
    • You, or someone else, can always come along later and click on the question mark!

First slide Previous Next Last slide  Slide 18 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Referencing other pages and URLs Next

  • WikiWords automatically link to the target page
    • You can make these links easier to read using square brackets:
  • An ordinary URL pasted into text will appear as a link - http://www.google.com
    • You can also prettify URLs using square brackets:
      • [[http://www.google.com/][Google]] appears as Google
  • Use %SEARCH. This is an interface to a sophisticated search engine that embeds the results of the search in your page. See System.Macros for full details.

First slide Previous Next Last slide  Slide 19 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show More formatting Next

  • There's lots more formatting available, see TextFormattingRules and WikiSyntax
  • If you are a real masochist, you can even enter raw HTML tags!
  • Important to disable unwanted formatting, use <nop>
    • <nop>_word_ appears as _word_

First slide Previous Next Last slide  Slide 20 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Creating new pages Next

  • Alternative ways:
    • Click on the question mark after a WikiWord
    • Type in the name of the topic in the "Go:" box
    • Type in the name of the topic in the URL
  • Any time you try to visit a page that doesn't exist, Foswiki will invite you to create it.
  • Make sure the names of topics are always WikiWords.

First slide Previous Next Last slide  Slide 21 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Attachments Next

  • Attachments are files which have been uploaded and attached to a Foswiki topic using the [Attach] link in the toolbar.

I Attachment Action Size Date Who Comment
txt Sample.txt manage 0.1 K 22 Jul 2000 - 19:37 ProjectContributor Just a sample
gif Smile.gif manage 0.1 K 22 Jul 2000 - 19:38 ProjectContributor Smiley face

  • Attachments are simply files, in whatever format you want.
  • Foswiki recognises some file formats, notably image files (.gif)
    • Write %ATTACHURL%/myco.gif to see this: myco.gif

First slide Previous Next Last slide  Slide 22 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Wiki Culture Next

Enough about mechanics; how is a wiki actually used ? Well, that's really up to you, but there are a number of tricks that the wiki community has developed for collaborative writing that work pretty well:

  • What can I edit?
    • Anything. But it's good etiquette to sign your contributions
    • If someone doesn't want you to edit a page, it's up to them to say so, clearly, on the page
  • But what if somebody doesn't like my edits?
    • In Foswiki, they can always recover the old revision and re-instantiate it if they really want to
    • Otherwise they should regard your changes as an opportunity for discussion
  • Pages in wiki are (usually) in one of three "modes"
    • DocumentMode
    • ThreadMode
    • StructuredMode
Foswiki doesn't automatically distinguish between these modes; they are purely semantic.

First slide Previous Next Last slide  Slide 23 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show DocumentMode Next

  • A page in DocumentMode usually comprises a contribution which is written in the third person and left unsigned.
  • The piece of text is community property
    • It may have multiple and changing authors as it is updated to reflect the community consensus.

First slide Previous Next Last slide  Slide 24 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show ThreadMode Next

  • Thread mode is a form of discussion where the community holds a conversation
  • The discussion usually starts out with a statement, at the top of the page, that is subsequently discussed
  • The page may be periodically "refactored" (edited) to remove some of the comments
    • As long as the comment is accurately reflected in what replaces it, nobody usually minds.
    • Remember to always maintain a complete list of contributors, though!
You may see a comment box on a page in ThreadMode that makes it easy to quickly add your inputs. Typing in a comment and adding it to a page this way is known as "blogging" wink
  • ThreadMode is rather like an e-mail thread
    • Except that new comments are usually added to the end
  • ThreadMode pages often get refactored into DocumentMode

First slide Previous Next Last slide  Slide 25 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show StructuredMode Next

  • A page in StructuredMode follows some predefined structure for example
    • An agenda
    • A set of meeting minutes
    • A requirement description.
  • Pages in StructuredMode will usually have rules governing how they are edited.

First slide Previous Next Last slide  Slide 26 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Other Wiki tricks - Categories Next

  • A Wiki trick for grouping pages together
  • Example: to group together a set of pages all relating to the weather:
    1. Create a page called 'CategoryWeather'
    2. Put a SEARCH that contains the word 'CategoryWeather' into it
      • %SEARCH{"CategoryWeather" nosearch="on" nosummary="on"}%
    3. Put the WikiWord 'CategoryWeather' on all the pages relating to the weather
      (usually at the bottom, below a horizontal bar)

First slide Previous Next Last slide  Slide 27 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Contributed features Next

Basic Foswiki is rich with features, but is enriched even further by the addition of optional plug-in modules that may (or may not!) be installed in your Foswiki. These are classified as either skins (modules that change the look-and-feel) or plugins (modules that enhance functionality).

Here's a brief description of some of the more common plugins, together with the tags you might expect to see in topics if they are used. You can find out more by visiting the plugin pages.

  • ActionTrackerPlugin: Support action tags in topics, with automatic notification of action statuses %ACTION...
  • CalendarPlugin: Show a monthly calendar with highlighted events %CALENDAR...%
  • CommentPlugin: Support rapid entry of short comments (also known as blogging) %COMMENT...
  • ChartPlugin: Create PNG or GIF charts to visualize data in Foswiki tables %CHART...
  • EditTablePlugin: Edit Foswiki tables using edit fields and drop down boxes %EDITTABLE...
  • InterwikiPlugin: Define shortcuts for links to common external sites

First slide Previous Next Last slide  Slide 28 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show More plugins Next

  • RenderListPlugin: Render bullet lists in a variety of formats %RENDERLIST...
  • SlideShowPlugin: Create web based presentations based on topics with headings %SLIDESHOWSTART...
  • SpreadSheetPlugin: Add spreadsheet calculations like "$SUM( $ABOVE() )" to tables located in Foswiki topics %CALC...
  • TablePlugin: Control presentation and sorting of tables %TABLE...
  • TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The following plugins are installed on this Foswiki: TWikiCompatibilityPlugin, SpreadSheetPlugin, AutoViewTemplatePlugin, BreadCrumbsPlugin, CalendarPlugin, ChartPlugin, CommentPlugin, DBCachePlugin, EditChapterPlugin, EditTablePlugin, ExplicitNumberingPlugin, ExternalLinkPlugin, FilterPlugin, FlexWebListPlugin, GluePlugin, HeadlinesPlugin, IfDefinedPlugin, ImagePlugin, InterwikiPlugin, JQueryLibPlugin, JQueryPlugin, LatexModePlugin, LdapNgPlugin, MathModePlugin, NatEditPlugin, NatSkinPlugin, NewUserPlugin, PreferencesPlugin, RedirectPlugin, RenderListPlugin, RenderPlugin, SendEmailPlugin, SetVariablePlugin, SlideShowPlugin, SmiliesPlugin, SubscribePlugin, SyntaxHighlightingPlugin, TablePlugin, TagMePlugin, TwistyPlugin, UploadPlugin, VarCachePlugin, VotePlugin, ZonePlugin

There are many other plugins, see http://foswiki.org/Extensions/WebHome

First slide Previous Next Last slide  Slide 29 of 30 COPYRIGHT © 2024 by the contributing authors





















Foswiki Slide Show Credits and Acknowledgements Next

First slide Previous Next Last slide  Slide 30 of 30 COPYRIGHT © 2024 by the contributing authors





















First slide Previous End Presentation






























Related topics: WelcomeGuest, WikiCulture, TwentyMinuteTutorial, TopicsAndWebs, WorkingTopics?


This topic: System > CategoryCategory > UserDocumentationCategory > BeginnersStartHere
Topic revision: r1 - 12 Sep 2009 - 04:07:34 - ProjectContributor
This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Wiki? Send feedback