TonysHints < Main

Tags: view all tags
---++ Tony's TWiki Hints.

Here are few hints on using TWiki.  

Please use [[%SCRIPTURLPATH{"view"}%/%WEB%/%TOPIC%?raw=on][this link]] to view the source of this page in read-only mode.

%TOC%

#IntroAnchor
---+++ %CALC{$SETM(nh,+1)$GET(nh).}%  General Introduction.

A TWiki is a collaboration platform - it provides a Web site which try to make it easy for any (authorized) person to change.  TWiki is a form of a [[http://en.wikipedia.org/wiki/Wiki][Wiki]] - by that I mean it is a set of software which implements 
a "Wiki", a now common style of application.  


TWiki has change control and the ability to [[TWiki.FileAttachment][upload images and other documents]].

[[TWiki.ATasteOfTWiki][Click here]] to get a very quick intro to Twiki.

#DocoAnchor
---+++ %CALC{$SETM(nh,+1)$GET(nh).}% TWiki Documentation

First - Here is the standard set of TWiki Documentation for general users.    Also see the [[TWiki.WebHome][front page of this twiki]].

   * [[TWiki.WelcomeGuest][Welcome Guest]] - another quick intro.
   * [[TWiki.TWikiTutorial][Tutorial]] - 20 minutes TWiki tutorial
   * [[TWiki.TWikiUsersGuide][User's Guide]] - documentation for TWiki users
   * [[TWiki.TWikiFAQ][Frequently Asked Questions]] - about TWiki

#HintsAnchor
---+++ %CALC{$SETM(nh,+1)$GET(nh).}% Tony's Hints

Here are some things that I found myself to be quite useful.

   * When editing - use the *Preview* button often - particularly if you can put the preview into a separate tab.  This will quickly let you see which links work and don't work.
   * Consider using the WYSIWYG button instead of the Edit button.  The WYSIWYG button brings up a "What You See is What You Get" editor.  This will take a little bit of learning but some people may find it a better way to work.  See TWiki.WysiwygPlugin for details on this editor.  *Note* does not work on Safari.  Mac uses can use Mozilla.
   * If you attach images they can appear nicely within the page.

---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}%  Commenting.

You can add quick commenting facilities to your pages.   See TWiki.CommentPlugin and the example below.     Such comments will end up as bullet point entries on the page.  %COMMENT{type="below"}%.
   * this is an another example comment -- Main.IanNoble - 01 Sep 2008 - 11:25

   * this is an example comment. -- Main.TonyFarrell - 05 Dec 2006 - 10:47

---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}%  Smilies.

You can use the standard "Smilies" - such as  :) , :ok: etc.  See TWiki.SmiliesPlugin

---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}%  Tables.

If you are adding tables, use the TWiki.EditTablePlugin.  An example appears below.
 
Also for tables - you can use spreadsheet operations.  See TWiki.SpreadSheetPlugin.  Note that unfortunately, the TWiki.EditTablePlugin and
TWiki.SpreadSheetPlugin plugins don't interact nicely - as the edit table plugin does not see the spreadsheet plugin contents, just the values and will put the wrong values into the table (the results of the spreadsheet table calculations rather then the formular.

Editable table example with summing row.

%EDITTABLE{}%
| *column 1* | *column 2* |
| 1 | 1 |
| 2 | 2 |
| 3 | 3 |
| 2 | 6  |
| 5 | 10 |
| 43 | 4 |

#NewAnchor
---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}%  Generating a table of contents
%N% 
You can enter this tag on a page to generate a table of contents
<verbatim>
%TOC% 
</verbatim>

---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}%  Standard icons and images 
%N% 
TWiki.TWikiDocGraphics provides standard icons etc.

---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}%  Tabbed browsing.
%N%
See Main.TabbedBrowsing for how to implement a form of tabbed browsing.  For example

%CALC{$SET(tabs, TonysHints#IntroAnchor:This page intro, TonysHints#DocoAnchor:Documents, TonysHints#HintsAnchor:These Hints )}%
%INCLUDE{Main.TabbedBrowsing}%

---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}%  Numbered Headings
%N% 
This page is using numbered headers.    A basic numbered header could be done by inserting the following into the header
<verbatim>
%CALC{$SETM(nh,+1)$GET(nh).}%
</verbatim>
Here - =nh= is a variable which is maintaining the number.  So a typical header might look like 
<verbatim>
---+++ %CALC{$SETM(nh,+1)$GET(nh).}% Other things.
</verbatim>
To get other levels of headers, you have to combined multiple of these using different variable, for example
<verbatim>
---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}%  Numbered Headings
</verbatim>
Here =nh2= is the header for the second level.  In this example, you want a different variable for each lower level header, through there is probably a =SET= command you could use to avoid this.

The =%CALC= stuff here is from TWiki.SpreadSheetPlugin.

---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}% Tree Browsing.
%N% 
The TWiki.TreeBrowserPlugin provides alternatives to representing nested bullet lists.  For example:

%TREEBROWSER{"file" title="[[%HOMETOPIC%][%INCLUDINGWEB% Web Home]]" shared="left"}%
   * [[WebChanges][Changes]] 
   * [[WebIndex][Index]]
   * [[WebSearch][Search]]
   * this is a very very very long text
   * Folder
      * Leaf1
      * Subfolder
         * Leaf3
      * Leaf2
   * *Webs*
%WEBLIST{"      * [[$name.%HOMETOPIC%][$name]]"}%
<a href="javascript: left.openAll();">open all</a> | <a href="javascript: left.closeAll();">close all</a>


---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}% Conversions from MS Word/Excel Documents.
%N% 
Some visual basic macros exists which help to convert from MS Word/Excel into TWiki text.  They are not perfect but may do the job you want.

   * [[http://twiki.org/cgi-bin/view/Plugins/MsWordToTWikiMLAddOn][MS Word to TWiki]]
   * [[http://twiki.org/cgi-bin/view/Plugins/ExcelExportTwikiTableAddOn][MS Excel to TWiki]]
   * [[http://twiki.org/cgi-bin/view/Plugins/ExcelImportExportAddOn][Both MS Excel to/from TWiki]]

---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}%  Font colors etc.
%N%
You can %BLUE% Change the color of %ENDCOLOR% text using some standard names.  For example
<verbatim>
%BLUE% this ends up blue %ENDCOLOR% 
</verbatim>
See  TWiki.TWikiPreferences#RenderingShortcuts for details.  You can also use techniques shown here to change other font characteristics - if you now your html.


---++++ %CALC{$GET(nh).}%%CALC{$SETM(nh2,+1)$GET(nh2).}%  Drawing Editor
%ICON{wip}%
* DOES NOT YET WORK *

You you can just upload existing images, there is also a JAVA base Drawing tool - TWiki.TWikiDrawPlugin.  Just drop
<verbatim>
%DRAWING{drawing}%
</verbatim>
Into the text of the page, where =drawing= is a number for your drawing.  For example:
%DRAWING{test_drawing}%



---+++ %CALC{$SETM(nh,+1)$GET(nh).}% Other things.



[[http://www.gritechnologies.com/tools/spider.go][Poggle Predictor]] is a tool which claims to predict how Goggle will see a site and therefore is an interesting test of if Goggle gets through our login prompt.  I'm not sure at the moment (24/Apr/2007) that it is working that well.

---+++ %CALC{$SETM(nh,+1)$GET(nh).}% More examples.

[[http://twiki.org/cgi-bin/view/Sandbox/WebHome#Sample_Applications][This Page]] on the [[http://twiki.org/][TWiki]] home site introduces a lot of examples.  Well worth a look.


Please use [[%SCRIPTURLPATH{"view"}%/%WEB%/%TOPIC%?raw=on][this link]] to view the source of this page in read-only mode.


-- Main.TonyFarrell - 12 Jun 2007
Topic revision: r11 - 2008-09-01 - IanNoble
Main Web