The look-and-feel is highly configurable, through use of templates
A "plugins" interface eases
customisation
extension
application integration
Slide 3: Applications of basic TWiki
Basic TWiki can be used as:
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
Slide 4: Extended applications
TWiki-with-extensions has been 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!)
Slide 5: Structure of a TWiki page
TWiki 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
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
Slide 6: The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Slide 9: Editing Pages
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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?
Slide 10: What's in a page
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Slide 11: Formatting just makes pages prettier
... and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Slide 12: Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
---+ indicates a heading. Add more +'s for a deeper heading.
[[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 TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURL%/myco.gif to see this:
Slide 20: Wiki Culture
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 TWiki, 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
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"
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
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Slide 25: Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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.
AutoCompletePlugin: Auto-complete for input fields of forms
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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
Slide 26: More plugins
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The look-and-feel is highly configurable, through use of templates
A "plugins" interface eases
customisation
extension
application integration
Slide 4: Applications of basic TWiki
Basic TWiki can be used as:
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
Slide 5: Extended applications
TWiki-with-extensions has been 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!)
Slide 6: Structure of a TWiki page
TWiki 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
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
Slide 7: The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Slide 10: Editing Pages
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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?
Slide 11: What's in a page
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Slide 12: Formatting just makes pages prettier
... and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Slide 13: Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
---+ indicates a heading. Add more +'s for a deeper heading.
[[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 TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURL%/myco.gif to see this:
Slide 21: Wiki Culture
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 TWiki, 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
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"
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
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Slide 26: Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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.
AutoCompletePlugin: Auto-complete for input fields of forms
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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
Slide 27: More plugins
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The look-and-feel is highly configurable, through use of templates
A "plugins" interface eases
customisation
extension
application integration
Applications of basic TWiki
Basic TWiki can be used as:
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
Extended applications
TWiki-with-extensions has been 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!)
Structure of a TWiki page
TWiki 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
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Editing Pages
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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?
What's in a page
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Formatting just makes pages prettier
... and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
---+ indicates a heading. Add more +'s for a deeper heading.
[[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 TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURL%/myco.gif to see this:
Wiki Culture
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 TWiki, 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
DocumentMode
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.
ThreadMode
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"
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
StructuredMode
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.
Other Wiki tricks - Categories
A Wiki trick for grouping pages together
Example: to group together a set of pages all relating to the weather:
Create a page called 'CategoryWeather'
Put a SEARCH that contains the word 'CategoryWeather' into it
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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.
Changed:
< <
ActionTrackerPlugin: Support action tags in topics, with automatic notification of action statuses %ACTION...
> >
AutoCompletePlugin: Auto-complete for input fields of forms
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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
Slide 1: More plugins
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The look-and-feel is highly configurable, through use of templates
A "plugins" interface eases
customisation
extension
application integration
Slide 5: Applications of basic TWiki
Basic TWiki can be used as:
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
Slide 6: Extended applications
TWiki-with-extensions has been 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!)
Slide 7: Structure of a TWiki page
TWiki 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
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
Slide 8: The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Editing Pages
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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?
What's in a page
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Formatting just makes pages prettier
... and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
---+ indicates a heading. Add more +'s for a deeper heading.
[[http://www.google.com/][Google]] appears as Google
Changed:
< <
Use %SEARCH. This is an interface to a sophisticated search engine that embeds the results of the search in your page. See TWikiVariables for full details.
> >
Use %SEARCH. This is an interface to a sophisticated search engine that embeds the results of the search in your page. See TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURL%/myco.gif to see this:
Slide 3: Wiki Culture
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 TWiki, 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
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"
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
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Slide 8: Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
Slide 9: More plugins
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The look-and-feel is highly configurable, through use of templates
A "plugins" interface eases
customisation
extension
application integration
Applications of basic TWiki
Basic TWiki can be used as:
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
Extended applications
TWiki-with-extensions has been 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!)
Structure of a TWiki page
TWiki 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
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Editing Pages
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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?
What's in a page
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Formatting just makes pages prettier
... and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
---+ indicates a heading. Add more +'s for a deeper heading.
[[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 TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURL%/myco.gif to see this:
Wiki Culture
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 TWiki, 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
DocumentMode
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.
ThreadMode
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"
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
StructuredMode
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.
Other Wiki tricks - Categories
A Wiki trick for grouping pages together
Example: to group together a set of pages all relating to the weather:
Create a page called 'CategoryWeather'
Put a SEARCH that contains the word 'CategoryWeather' into it
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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.
Changed:
< <
ActionTrackerPlugin: Support action tags in topics, with automatic notification of action statii %ACTION...
> >
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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
Slide 1: More plugins
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The look-and-feel is highly configurable, through use of templates
Changed:
< <
A "plugins" interface eases
customisation
extension
application integration
> >
A "plugins" interface eases
customisation
extension
application integration
Applications of basic TWiki
Basic TWiki can be used as:
Changed:
< <
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
> >
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
Extended applications
TWiki-with-extensions has been used as:
Changed:
< <
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!)
> >
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!)
Structure of a TWiki page
TWiki pages are usually organised into three parts:
Changed:
< <
A header
A body
A footer
> >
A header
A body
A footer
Changed:
< <
The header and the footer are generated by the system
The body contains the text of the page, as entered by you
> >
The header and the footer are generated by the system
The body contains the text of the page, as entered by you
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Editing Pages
Changed:
< <
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But it doesn't look much like what was on the page before - it's full of strange hieroglyphics!
> >
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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
Changed:
< <
Now what?
> >
Now what?
What's in a page
Changed:
< <
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
> >
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Formatting just makes pages prettier
... and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
Changed:
< <
---+ indicates a heading. Add more +'s for a deeper heading.
[[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 TWikiVariables for full details.
[[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 TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURL%/myco.gif to see this:
> >
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURL%/myco.gif to see this:
Wiki Culture
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:
Changed:
< <
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 TWiki, 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
> >
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 TWiki, 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
DocumentMode
Changed:
< <
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.
> >
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.
ThreadMode
Changed:
< <
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!
> >
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"
Changed:
< <
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
> >
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
StructuredMode
Changed:
< <
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.
> >
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.
Other Wiki tricks - Categories
Changed:
< <
A Wiki trick for grouping pages together
Example: to group together a set of pages all relating to the weather:
Create a page called 'CategoryWeather'
Put a SEARCH that contains the word 'CategoryWeather' into it
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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.
Changed:
< <
ActionTrackerPlugin: Support action tags in topics, with automatic notification of action statii %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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
> >
ActionTrackerPlugin: Support action tags in topics, with automatic notification of action statii %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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
More plugins
Changed:
< <
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
> >
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The look-and-feel is highly configurable, through use of templates
A "plugins" interface eases
customisation
extension
application integration
Changed:
< <
> >
Applications of basic TWiki
Basic TWiki can be used as:
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
Changed:
< <
A chat room
> >
A chat room
Extended applications
TWiki-with-extensions has been 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!)
Structure of a TWiki page
TWiki 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
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Editing Pages
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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?
What's in a page
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Formatting just makes pages prettier
... and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
---+ indicates a heading. Add more +'s for a deeper heading.
[[http://www..google.com][google]] appears as google
> >
[[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 TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Changed:
< <
Write %ATTACHURL%/myco.gif to see this: /pub/TWiki/ATasteOfTWiki/myco.gif
> >
Write %ATTACHURL%/myco.gif to see this:
Wiki Culture
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 TWiki, 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
DocumentMode
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.
ThreadMode
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"
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
StructuredMode
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.
Other Wiki tricks - Categories
A Wiki trick for grouping pages together
Example: to group together a set of pages all relating to the weather:
Create a page called 'CategoryWeather'
Changed:
< <
Put a SEARCH that contain the word 'CategoryWeather' into it
> >
Put a SEARCH that contains the word 'CategoryWeather' into it
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Slide 1: Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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 statii %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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
Slide 2: More plugins
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The look-and-feel is highly configurable, through use of templates
A "plugins" interface eases
customisation
extension
application integration
Slide 5: Applications of basic TWiki
Basic TWiki can be used as:
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
Slide 6: Extended applications
TWiki-with-extensions has been used as:
A Content Management System (CMS) for websites
A presentation development tool
A Blog
A database
A project management system
A tracking tool
Changed:
< <
(truth is, we don't really know it's limits!)
> >
(truth is, we don't really know its limits!)
Structure of a TWiki page
TWiki 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
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Editing Pages
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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?
What's in a page
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Formatting just makes pages prettier
... and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
---+ indicates a heading. Add more +'s for a deeper heading.
[[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 TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURL%/myco.gif to see this: /pub/TWiki/ATasteOfTWiki/myco.gif
Slide 7: Wiki Culture
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 TWiki, 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
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"
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
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Slide 12: Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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 statii %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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
Slide 13: More plugins
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The look-and-feel is highly configurable, through use of templates
A "plugins" interface eases
customisation
extension
application integration
Slide 5: Applications of basic TWiki
Basic TWiki can be used as:
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
Slide 6: Extended applications
TWiki-with-extensions has been 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 it's limits!)
Slide 7: Structure of a TWiki page
TWiki 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
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
Slide 8: The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Slide 11: Editing Pages
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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?
Slide 12: What's in a page
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Slide 13: Formatting just makes pages prettier, and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Slide 14: Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
---+ indicates a heading. Add more +'s for a deeper heading.
[[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 TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURLPATH%/myco.gif to see this: /pub/TWiki/ATasteOfTWiki/myco.gif
Slide 22: Wiki Culture
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 TWiki, they can always recover the old revision and re-instate 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
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"
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
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Slide 27: Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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 statii %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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
Slide 28: More plugins
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The following plugins are installed on this TWiki: The INSTALLEDPLUGINS variable is no longer supported. You can set the Plugins execution order using the configure interface.
There are many other plugins, see http://www.twiki.org/cgi-bin/view/Plugins
Slide 29: Credits and Acknowledgements
> >
This is a short introduction training course for TWiki beginners (newbies).
Slide 1: A Taste of TWiki
The basic function of TWiki is a Wiki (if that helps!)
A Wiki is like a normal web site, except that you can edit the content in your browser
"Wiki" is short for "wiki wiki", the Hawaiian for "Quick"
The look-and-feel is highly configurable, through use of templates
A "plugins" interface eases
customisation
extension
application integration
Slide 5: Applications of basic TWiki
Basic TWiki can be used as:
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
Slide 6: Extended applications
TWiki-with-extensions has been 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 it's limits!)
Slide 7: Structure of a TWiki page
TWiki 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
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
Slide 8: The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Slide 11: Editing Pages
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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?
Slide 12: What's in a page
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Slide 13: Formatting just makes pages prettier
... and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Slide 14: Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
---+ indicates a heading. Add more +'s for a deeper heading.
[[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 TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURL%/myco.gif to see this: /pub/TWiki/ATasteOfTWiki/myco.gif
Slide 22: Wiki Culture
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 TWiki, 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
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"
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
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Slide 27: Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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 statii %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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
Slide 28: More plugins
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The look-and-feel is highly configurable, through use of templates
A "plugins" interface eases
customisation
extension
application integration
Slide 5: Applications of basic TWiki
Basic TWiki can be used as:
A whiteboard
A document repository
A collaborative authoring environment
A notebook / scrapbook
A chat room
Slide 6: Extended applications
TWiki-with-extensions has been 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 it's limits!)
Slide 7: Structure of a TWiki page
TWiki 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
TWiki is very configurable, and the look can change. However the essentials will all be there on the page (somewhere!)
Slide 8: The Page Header
The header of a TWiki 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.
The other links invoke other, more complex, functions, mainly to do with revision tracking - they can safely be ignored for now
Slide 11: Editing Pages
You've read a page, and you disagree with it violently! It says: Everyoneknows that the world is an OblateSpheroid But you know for a fact it is flat!
You've clicked the edit link, and an edit page has appeared. But 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?
Slide 12: What's in a page
The hieroglyphics are what's known as "TWiki 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
TWiki understands pages in plain text just fine.
Actually it is perfectly and absolutely flat
appears as
Actually it is perfectly and absolutely flat
Slide 13: Formatting just makes pages prettier, and easier to read
_Actually_ it is *perfectly* and __absolutely__ flat
The best thing to do is just to type until you get stuck
then follow the link on the edit page to the help.
Slide 14: Commonly used formatting
TWiki understands pages in plain text just fine, but you can jazzthemup using some simple formatting shortcuts. Here are some of the more commonly used ones:
---+ indicates a heading. Add more +'s for a deeper heading.
[[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 TWikiVariables for full details.
Attachments are simply files, in whatever format you want.
TWiki recognises some file formats, notably image files (.gif)
Write %ATTACHURLPATH%/myco.gif to see this: /pub/TWiki/ATasteOfTWiki/myco.gif
Slide 22: Wiki Culture
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 TWiki, they can always recover the old revision and re-instate 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
TWiki doesn't automatically distinguish between these modes; they are purely semantic.
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"
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
Put the BumpyWord 'CategoryWeather' on all the pages relating to the weather (usually at the bottom, below a horizontal bar)
Slide 27: Contributed features
Basic TWiki 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 TWiki. These are classified as either skins (modules that change the look-and-feel) and 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 statii %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 TWiki tables%CHART...
EditTablePlugin: Edit TWiki tables using edit fields and drop down boxes%EDITTABLE...
InterwikiPlugin: Define shortcuts for links to common external sites
Slide 28: More plugins
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 TWiki topics %CALC...
TablePlugin: Control presentation and sorting of tables%TABLE...
TWikiDrawPlugin: Add quick sketches to pages %DRAWING...
The following plugins are installed on this TWiki: The INSTALLEDPLUGINS variable is no longer supported. You can set the Plugins execution order using the configure interface.
There are many other plugins, see http://www.twiki.org/cgi-bin/view/Plugins