diff options
| author | Thomas Schwinge <tschwinge@gnu.org> | 2007-08-15 10:15:33 +0200 |
|---|---|---|
| committer | Thomas Schwinge <tschwinge@gnu.org> | 2007-08-15 10:15:33 +0200 |
| commit | a681e1688bb93f1baa2f1646d4f677a4d29f07db (patch) | |
| tree | b1737725e1c42706c991146a166e4300acc5fa5d /TWiki | |
| parent | 1636e576934c7c34c52b4601a92e431ab7cc176f (diff) | |
Weed TWiki/.
Diffstat (limited to 'TWiki')
154 files changed, 0 insertions, 10139 deletions
diff --git a/TWiki/AlWilliams.mdwn b/TWiki/AlWilliams.mdwn deleted file mode 100644 index 6453ce9c..00000000 --- a/TWiki/AlWilliams.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Al Williams is a [[TWikiContributor]]. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/AndreaSterbini.mdwn b/TWiki/AndreaSterbini.mdwn deleted file mode 100644 index 0fc2c274..00000000 --- a/TWiki/AndreaSterbini.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Andrea Sterbini is a [[TWikiContributor]] and a core team member. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/AppendixFileSystem.mdwn b/TWiki/AppendixFileSystem.mdwn deleted file mode 100644 index 02f3c94f..00000000 --- a/TWiki/AppendixFileSystem.mdwn +++ /dev/null @@ -1,829 +0,0 @@ -%TOC% %STARTINCLUDE% <a name="FileSystem"></a> - -# <a name="Appendix_A_TWiki_File_System"> Appendix A: TWiki File System </a> - -_Annotated listings of files included in the 01-Sep-2001 TWiki distribution_ - -## <a name="Overview"> Overview </a> - -This Appendix contains directory and file listings, and individual file descriptions, for the full 01-Sep-2001 TWiki distribution package. - -## <a name="Directory_Structure"> Directory Structure </a> - -You can rename the root TWiki directory - `twiki` - to whatever you like by changing it in the `twiki.cfg` configuration file. However, to keep the current installation and future upgrades simple, you should leave the subdirectory structure intact: - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Directory:</strong></th> - <th bgcolor="#99CCCC"><strong>Files:</strong></th> - <th bgcolor="#99CCCC"><strong>Used for:</strong></th> - </tr> - <tr> - <td><code>twiki</code></td> - <td align="center"> list </td> - <td> Start-up info </td> - </tr> - <tr> - <td><code>twiki/bin</code></td> - <td align="center"> list </td> - <td> Perl scripts </td> - </tr> - <tr> - <td><code>twiki/lib</code></td> - <td align="center"> list </td> - <td> Configuration file, main library, Perl system modules, Plugins </td> - </tr> - <tr> - <td><code>twiki/pub</code></td> - <td align="center"> list </td> - <td> Public files (e.g. images) and [[FileAttachments]] and their RCS histories </td> - </tr> - <tr> - <td><code>twiki/data</code></td> - <td align="center"> list </td> - <td> Topic text (page content) and RCS histories </td> - </tr> - <tr> - <td><code>twiki/templates</code></td> - <td align="center"> list </td> - <td> HTML templates, used by TWiki scripts </td> - </tr> -</table> - -## <a name="File_Descriptions"> File Descriptions </a> - -A rundown of the individual files included in the current 01-Sep-2001 distribution, organized by TWiki root directories. - -<a name="TWikiFiles"></a> - -### <a name="Files_in_twiki_code_"> Files in `twiki` </a> - -Application info and the current reference documentation. _Full file list:_ - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>File:</strong></th> - <th bgcolor="#99CCCC"><strong>Used for:</strong></th> - </tr> - <tr> - <td><code>index.html</code></td> - <td> A page with a link to first launch TWiki after install </td> - </tr> - <tr> - <td><code>license.txt</code></td> - <td> GNU General Public License and TWiki-specific info </td> - </tr> - <tr> - <td><code>readme.txt</code></td> - <td> General TWiki start-up info with relevant URLs </td> - </tr> - <tr> - <td><code>TWikiDocumentation.html</code></td> - <td> All documentation packaged as a single page </td> - </tr> - <tr> - <td><code>TWikiHistory.html</code></td> - <td> TWiki development timeline </td> - </tr> -</table> - -<a name="BinFiles"></a> - -### <a name="Files_in_twiki_bin_code_"> Files in `twiki/bin` </a> - -Perl CGI scripts. _Full file list:_ - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>File:</strong></th> - <th bgcolor="#99CCCC"><strong>Used for:</strong></th> - </tr> - <tr> - <td><code>.htaccess.txt</code></td> - <td> Authentication. Rename to .htaccess and customize if used </td> - </tr> - <tr> - <td><code>attach</code></td> - <td> Script that shows the attach file page ([[FileAttachment]]) </td> - </tr> - <tr> - <td><code>edit</code></td> - <td> Script to edit a topic </td> - </tr> - <tr> - <td><code>geturl</code></td> - <td> Script to fetch URL data </td> - </tr> - <tr> - <td><code>installpasswd</code></td> - <td> Script to install new password by admin </td> - </tr> - <tr> - <td><code>mailnotify</code></td> - <td> Script called by cron job to notify users of changes </td> - </tr> - <tr> - <td><code>oops</code></td> - <td> Script that shows an OK or oops dialog </td> - </tr> - <tr> - <td><code>passwd</code></td> - <td> Script to reset and change password </td> - </tr> - <tr> - <td><code>preview</code></td> - <td> Script to preview topic after edit </td> - </tr> - <tr> - <td><code>rdiff</code></td> - <td> Script to see differences of topics </td> - </tr> - <tr> - <td><code>register</code></td> - <td> Script to register new users </td> - </tr> - <tr> - <td><code>rename</code></td> - <td> Script to rename/move topics and move attachments </td> - </tr> - <tr> - <td><code>save</code></td> - <td> Script that saves a topic, called by preview </td> - </tr> - <tr> - <td><code>search</code></td> - <td> Script that displays search results </td> - </tr> - <tr> - <td><code>statistics</code></td> - <td> Script to create statistics topic </td> - </tr> - <tr> - <td><code>testenv</code></td> - <td> Script to test CGI environment variables </td> - </tr> - <tr> - <td><code>upload</code></td> - <td> Script that does file upload ([[FileAttachment]]) </td> - </tr> - <tr> - <td><code>view</code></td> - <td> Script to view a topic ( <strong>the</strong> script ) </td> - </tr> - <tr> - <td><code>viewfile</code></td> - <td> Script to view a file attachment </td> - </tr> -</table> - -<a name="LibFiles"></a> - -### <a name="Files_under_twiki_lib_code_"> Files under `twiki/lib` </a> - -The new `lib/TWiki/Plugins` directories contain configuration, library and function files, and [[TWikiPlugins]]. _Full file list:_ - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>File:</strong></th> - <th bgcolor="#99CCCC"><strong>Used for:</strong></th> - </tr> - <tr> - <td><code>TWiki.cfg</code></td> - <td> For configuration, used by <code>TWiki.pm</code></td> - </tr> - <tr> - <td><code>TWiki.pm</code></td> - <td> Main TWiki library </td> - </tr> - <tr> - <td><code>TWiki/Access.pm</code></td> - <td> Access control </td> - </tr> - <tr> - <td><code>TWiki/Attach.pm</code></td> - <td> Attachment handling </td> - </tr> - <tr> - <td><code>TWiki/Form.pm</code></td> - <td> Form handling </td> - </tr> - <tr> - <td><code>TWiki/Func.pm</code></td> - <td> Public functions that Plugins may use </td> - </tr> - <tr> - <td><code>TWiki/Meta.pm</code></td> - <td> Meta data in topics </td> - </tr> - <tr> - <td><code>TWiki/Net.pm</code></td> - <td> SMTP mail handling </td> - </tr> - <tr> - <td><code>TWiki/Plugins.pm</code></td> - <td> Plugin handling </td> - </tr> - <tr> - <td><code>TWiki/Prefs.pm</code></td> - <td> Preferences handling </td> - </tr> - <tr> - <td><code>TWiki/Search.pm</code></td> - <td> Search engine, used by wiki.pm </td> - </tr> - <tr> - <td><code>TWiki/Store.pm</code></td> - <td> Back-end storage, <code>*.txt</code> text file and <code>*.txt,v</code> RCS repository file handling </td> - </tr> - <tr> - <td><code>TWiki/Plugins/DefaultPlugin.pm</code></td> - <td> Handles some legacy rules </td> - </tr> - <tr> - <td><code>TWiki/Plugins/EmptyPlugin.pm</code></td> - <td> Empty plugin, use to create your own </td> - </tr> - <tr> - <td><code>TWiki/Plugins/InterwikiPlugin.pm</code></td> - <td> Use aliases as links for predefined URLs </td> - </tr> -</table> - -<a name="PubFiles"></a> - -### <a name="Files_under_twiki_pub_code_"> Files under `twiki/pub` </a> - -The `pub` directory stores data-related files, including images used by TWiki and [[FileAttachments]]. Attachments are stored in sub-directories created with the related topic name. _Partial file list:_ - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>File:</strong></th> - <th bgcolor="#99CCCC"><strong>Used for:</strong></th> - </tr> - <tr> - <td><code>favicon.ico</code></td> - <td> ICO file </td> - </tr> - <tr> - <td><code>twikilogo.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>twikilogo1.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>twikilogo2.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>twikilogo3.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>twikilogo4.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>twikilogo88x31</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>wikiHome.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>icn/_filetypes.txt</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>icn/bat.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>icn/bmp.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <th align="center" bgcolor="#99CCCC"><strong>...</strong></th> - <th align="center" bgcolor="#99CCCC"><strong>...</strong></th> - </tr> - <tr> - <td><code>TWiki/FileAttachment/Sample.txt</code></td> - <td> TEXT file </td> - </tr> - <tr> - <td><code>TWiki/FileAttachment/Smile.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>TWiki/PreviewBackground/blankltgraybg.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>TWiki/PreviewBackground/blankwhitebg.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>TWiki/PreviewBackground/previewbg.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>TWiki/WabiSabi/wabisabi.gif</code></td> - <td> GIF file </td> - </tr> - <tr> - <td><code>Know/IncorrectDllVersionW32PTH10DLL/W32PTH10.DLL</code></td> - <td> DLL file </td> - </tr> -</table> - -<a name="DataFiles"></a> - -### <a name="Files_under_twiki_data_code_"> Files under `twiki/data` </a> - -TWiki page data stored as individual text files. Each active web has its own subdirectory. The TWiki distribution includes four start-up webs - `Main`, `TWiki`, `Know`, `Test` - with documentation and demo content, a `Trash` web, and a `_default` directory containing all topics required to start a new web. _Partial file list:_ - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>File:</strong></th> - <th bgcolor="#99CCCC"><strong>Used for:</strong></th> - </tr> - <tr> - <td><code>.htpasswd</code></td> - <td> Basic Authentication (htaccess) password file </td> - </tr> - <tr> - <td><code>debug.txt</code></td> - <td> Program messages useful for debugging </td> - </tr> - <tr> - <td><code>mime.types</code></td> - <td> Recognized file formats </td> - </tr> - <tr> - <td><code>warning.txt</code></td> - <td> Diagnostic messages for identifying problems </td> - </tr> - <tr> - <td colspan="2"> _default directory can be copied to empty directory when creating new Webs </td> - </tr> - <tr> - <td><code>_default/.changes</code></td> - <td> Web-level record of topic changes </td> - </tr> - <tr> - <td><code>_default/.mailnotify</code></td> - <td> Web-level timstamp of last e-mail notification </td> - </tr> - <tr> - <td><code>_default/WebChanges.txt</code></td> - <td> Display most recent topic changes in web </td> - </tr> - <tr> - <td><code>_default/WebChanges.txt,v</code></td> - <td> Revisions history (RCS) </td> - </tr> - <tr> - <td><code>_default/WebHome.txt</code></td> - <td> Default web home page </td> - </tr> - <tr> - <td><code>_default/WebHome.txt,v</code></td> - <td> Revisions history (RCS) </td> - </tr> - <tr> - <td><code>_default/WebIndex.txt</code></td> - <td> Lists all topics in a web </td> - </tr> - <tr> - <td><code>_default/WebIndex.txt,v</code></td> - <td> Revisions history (RCS) </td> - </tr> - <tr> - <td><code>_default/WebNotify.txt</code></td> - <td> Subscribe/unsubscribe to web changes email alert </td> - </tr> - <tr> - <td><code>_default/WebNotify.txt,v</code></td> - <td> Revisions history (RCS) </td> - </tr> - <tr> - <td><code>_default/WebPreferences.txt</code></td> - <td> Web-level preference settings </td> - </tr> - <tr> - <td><code>_default/WebPreferences.txt,v</code></td> - <td> Revisions history (RCS) </td> - </tr> - <tr> - <td><code>_default/WebSearch.txt</code></td> - <td> Web-level search options </td> - </tr> - <tr> - <td><code>_default/WebSearch.txt,v</code></td> - <td> Revisions history (RCS) </td> - </tr> - <tr> - <td><code>_default/WebStatistics.txt</code></td> - <td> Generates web usage statistics </td> - </tr> - <tr> - <td><code>_default/WebStatistics.txt,v</code></td> - <td> Revisions history (RCS) </td> - </tr> - <tr> - <th align="center" bgcolor="#99CCCC"><strong>...</strong></th> - <th align="center" bgcolor="#99CCCC"><strong>...</strong></th> - </tr> -</table> - -<a name="TemplatesFiles"></a> - -### <a name="Files_in_twiki_templates_code_"> Files in `twiki/templates` </a> - -Templates used to control appearance of all rendered pages. _Full file list:_ - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>File:</strong></th> - <th bgcolor="#99CCCC"><strong>Used for:</strong></th> - </tr> - <tr> - <td><code>attach.tmpl</code></td> - <td> Attach file control screen </td> - </tr> - <tr> - <td><code>attachagain.tmpl</code></td> - <td> Control screen </td> - </tr> - <tr> - <td><code>attachnew.tmpl</code></td> - <td> Control screen </td> - </tr> - <tr> - <td><code>changeform.tmpl</code></td> - <td> Control screen </td> - </tr> - <tr> - <td><code>changes.tmpl</code></td> - <td> Displays [[WebChanges]] list of recently changed topics </td> - </tr> - <tr> - <td><code>edit.iejs.tmpl</code></td> - <td> Edit window with IE specific <nop>JavaScript </nop></td> - </tr> - <tr> - <td><code>edit.tmpl</code></td> - <td> Main edit window </td> - </tr> - <tr> - <td><code>mailnotify.tmpl</code></td> - <td> Email notification </td> - </tr> - <tr> - <td><code>moveattachment.tmpl</code></td> - <td> Control screen </td> - </tr> - <tr> - <td><code>oopsaccesschange.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsaccessgroup.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsaccessrename.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsaccessview.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsauth.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsbadpwformat.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopschangepasswd.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsempty.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopslocked.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopslockedrename.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsmissing.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsmore.tmpl</code></td> - <td> More topic actions message </td> - </tr> - <tr> - <td><code>oopsmoveerr.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsnoformdef.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsnotwikiuser.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsnoweb.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopspreview.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsregexist.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsregpasswd.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsregrequ.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsregthanks.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsregwiki.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsrenameerr.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsresetpasswd.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsrev.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopssave.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopssaveerr.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopssendmailerr.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopstopicexists.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopsupload.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>oopswrongpassword.tmpl</code></td> - <td> Error message </td> - </tr> - <tr> - <td><code>preview.tmpl</code></td> - <td> Preview Changes screen </td> - </tr> - <tr> - <td><code>rdiff.tmpl</code></td> - <td> Displays text changes before &amp; after (Diffs) </td> - </tr> - <tr> - <td><code>register.tmpl</code></td> - <td> Registration page </td> - </tr> - <tr> - <td><code>registernotify.tmpl</code></td> - <td> Registration notification </td> - </tr> - <tr> - <td><code>rename.tmpl</code></td> - <td> Doing a new topic rename, user chooses web &amp; topic </td> - </tr> - <tr> - <td><code>renamebase.tmpl</code></td> - <td> Used by other rename templates </td> - </tr> - <tr> - <td><code>renameconfirm.tmpl</code></td> - <td> Confirms a pre-specified rename, ex: undoing a rename </td> - </tr> - <tr> - <td><code>renamerefs.tmpl</code></td> - <td> Rename done, but some references not changed (topics were locked) </td> - </tr> - <tr> - <td><code>search.tmpl</code></td> - <td> Search screen </td> - </tr> - <tr> - <td><code>searchbookview.tmpl</code></td> - <td> Search results with full topic content </td> - </tr> - <tr> - <td><code>searchmeta.tmpl</code></td> - <td> Search screen </td> - </tr> - <tr> - <td><code>searchrenameview.tmpl</code></td> - <td> Used by <code>rename</code> to list references to topic being renamed </td> - </tr> - <tr> - <td><code>twiki.tmpl</code></td> - <td> Base template definitions used by other templates </td> - </tr> - <tr> - <td><code>view.plain.tmpl</code></td> - <td> Printable topic view with reduced header/footer </td> - </tr> - <tr> - <td><code>view.print.tmpl</code></td> - <td> Topic view without header/footer </td> - </tr> - <tr> - <td><code>view.tmpl</code></td> - <td> Main topic view </td> - </tr> -</table> - -## <a name="TWiki_File_System_Snapshot"> TWiki File System Snapshot </a> - -The following partial directory listings from a Linux installation show typical file permissions and ownership. This is provided for general debugging use only and isn't an exact representation of the current distribution. - -Directory `twiki/bin`: - - drwxrwxr-x 2 twiki twiki 4096 Sep 14 22:45 . - drwxrwxr-x 5 twiki twiki 4096 Aug 3 01:57 .. - -rw-rw-r-- 1 twiki twiki 895 Aug 25 01:32 .htaccess - -rw-rw-r-- 1 twiki twiki 782 Aug 25 01:32 .htaccess.txt - -rw-rwxr-x 1 twiki twiki 4819 Sep 7 01:44 attach - -rwxrwxr-x 1 twiki twiki 3381 Jul 21 18:41 changes - -rw-rwxr-x 1 twiki twiki 8056 Sep 3 22:44 edit - -rwxrwxr-x 1 twiki twiki 1736 Nov 17 2000 geturl - -rwxrwxr-x 1 twiki twiki 4481 Aug 21 19:10 installpasswd - -rwxrwxr-x 1 twiki twiki 5829 Aug 21 22:03 mailnotify - -rwxrwxr-x 1 twiki twiki 4512 Aug 25 22:10 makedistrib - -rw-rwxr-x 1 twiki twiki 2254 Aug 21 19:25 oops - -rwxrwxr-x 1 twiki twiki 6399 Aug 22 18:31 passwd - -rw-rwxr-x 1 twiki twiki 5315 Sep 3 22:45 preview - -rwxrwxr-x 1 twiki twiki 8946 Sep 8 18:35 rdiff - -rw-rwxr-x 1 twiki twiki 9199 Aug 25 21:02 register - -rwxrwxr-x 1 twiki twiki 13481 Sep 7 21:17 rename - -rw-rwxr-x 1 twiki twiki 4645 Sep 7 01:44 save - -rwxrwxr-x 1 twiki twiki 4166 Jul 21 18:45 search - -rw-rwxr-x 1 twiki twiki 10006 Sep 7 01:42 statistics - -rwxrwxr-x 1 twiki twiki 9356 Aug 31 10:04 testenv - -rw-rwxr-x 1 twiki twiki 13782 Aug 21 22:17 upload - -rwxrwxr-x 1 twiki twiki 10164 Sep 8 18:24 view - -rw-rwxr-x 1 twiki twiki 2773 Sep 13 17:21 viewfile - -Directory `twiki/templates/`: - - drwxrwxr-x 2 twiki twiki 4096 Sep 8 00:47 . - drwxrwxr-x 4 twiki twiki 4096 Sep 10 23:21 .. - -rw-rw-r-- 1 twiki twiki 2573 Aug 31 13:06 attach.tmpl - -rw-rw-r-- 1 twiki twiki 1604 Aug 3 14:52 attachagain.tmpl - -rw-rw-r-- 1 twiki twiki 449 Aug 3 14:47 attachnew.tmpl - -rw-rw-r-- 1 twiki twiki 1309 Sep 3 22:47 changeform.tmpl - -rw-rw-r-- 1 twiki twiki 1619 Aug 31 13:16 changes.tmpl - -rw-rw-r-- 1 twiki twiki 11842 Sep 10 19:00 edit.iejs.tmpl - -rw-rw-r-- 1 twiki twiki 2603 Sep 3 22:48 edit.tmpl - -rw-rw-r-- 1 twiki twiki 981 May 28 20:14 mailnotify.tmpl - -rw-rw-r-- 1 twiki twiki 1499 Aug 31 13:16 moveattachment.tmpl - -rw-rw-r-- 1 twiki twiki 570 Aug 1 01:24 oopsaccesschange.tmpl - -rw-rw-r-- 1 twiki twiki 586 Aug 1 01:24 oopsaccessgroup.tmpl - -rw-rw-r-- 1 twiki twiki 573 Aug 1 01:47 oopsaccessrename.tmpl - -rw-rw-r-- 1 twiki twiki 573 Aug 1 01:24 oopsaccessview.tmpl - -rw-rw-r-- 1 twiki twiki 1014 Aug 1 01:25 oopsauth.tmpl - -rw-rw-r-- 1 twiki twiki 405 Aug 1 01:49 oopsbadpwformat.tmpl - -rw-rw-r-- 1 twiki twiki 344 Jul 31 10:16 oopschangepasswd.tmpl - -rw-rw-r-- 1 twiki twiki 624 Jul 31 02:09 oopsempty.tmpl - -rw-rw-r-- 1 twiki twiki 918 Jul 31 02:20 oopslocked.tmpl - -rw-rw-r-- 1 twiki twiki 590 Jul 31 10:25 oopslockedrename.tmpl - -rw-rw-r-- 1 twiki twiki 328 Jul 31 10:26 oopsmissing.tmpl - -rw-rw-r-- 1 twiki twiki 2158 Sep 13 02:03 oopsmore.tmpl - -rw-rw-r-- 1 twiki twiki 407 Aug 1 10:22 oopsmoveerr.tmpl - -rw-rw-r-- 1 twiki twiki 1136 Aug 1 01:30 oopsnoformdef.tmpl - -rw-rw-r-- 1 twiki twiki 522 Aug 1 01:31 oopsnotwikiuser.tmpl - -rw-rw-r-- 1 twiki twiki 413 Jul 31 02:07 oopsnoweb.tmpl - -rw-rw-r-- 1 twiki twiki 393 Aug 1 01:32 oopspreview.tmpl - -rw-rw-r-- 1 twiki twiki 462 Aug 1 01:32 oopsregexist.tmpl - -rw-rw-r-- 1 twiki twiki 345 Aug 1 00:52 oopsregpasswd.tmpl - -rw-rw-r-- 1 twiki twiki 356 Aug 1 00:53 oopsregrequ.tmpl - -rw-rw-r-- 1 twiki twiki 540 Aug 1 01:57 oopsregthanks.tmpl - -rw-rw-r-- 1 twiki twiki 679 Aug 1 01:02 oopsregwiki.tmpl - -rw-rw-r-- 1 twiki twiki 411 Aug 1 10:23 oopsrenameerr.tmpl - -rw-rw-r-- 1 twiki twiki 483 Aug 1 01:59 oopsresetpasswd.tmpl - -rw-rw-r-- 1 twiki twiki 921 Sep 7 23:47 oopsrev.tmpl - -rw-rw-r-- 1 twiki twiki 774 Aug 1 01:35 oopssave.tmpl - -rw-rw-r-- 1 twiki twiki 477 Aug 1 02:01 oopssaveerr.tmpl - -rw-rw-r-- 1 twiki twiki 452 Aug 1 01:37 oopssendmailerr.tmpl - -rw-rw-r-- 1 twiki twiki 379 Aug 1 10:23 oopstopicexists.tmpl - -rw-rw-r-- 1 twiki twiki 342 Jul 31 10:09 oopsupload.tmpl - -rw-rw-r-- 1 twiki twiki 364 Aug 1 02:05 oopswrongpassword.tmpl - -rw-rw-r-- 1 twiki twiki 2584 Sep 3 22:49 preview.tmpl - -rw-rw-r-- 1 twiki twiki 1539 Sep 8 18:29 rdiff.tmpl - -rw-rw-r-- 1 twiki twiki 552 Jul 14 19:23 register.tmpl - -rw-rw-r-- 1 twiki twiki 1151 Aug 23 16:38 registernotify.tmpl - -rw-rw-r-- 1 twiki twiki 789 Aug 8 23:32 rename.tmpl - -rw-rw-r-- 1 twiki twiki 2310 Sep 10 14:56 renamebase.tmpl - -rw-rw-r-- 1 twiki twiki 475 Aug 3 16:53 renameconfirm.tmpl - -rw-rw-r-- 1 twiki twiki 589 Aug 8 23:32 renamerefs.tmpl - -rw-rw-r-- 1 twiki twiki 1792 Aug 31 18:38 search.tmpl - -rw-rw-r-- 1 twiki twiki 1650 Aug 31 18:38 searchbookview.tmpl - -rw-rw-r-- 1 twiki twiki 149 Sep 13 02:00 searchmeta.tmpl - -rw-rw-r-- 1 twiki twiki 2044 Aug 31 18:38 searchrenameview.tmpl - -rw-rw-r-- 1 twiki twiki 2246 Aug 31 13:08 twiki.tmpl - -rw-rw-r-- 1 twiki twiki 418 Aug 31 13:07 view.plain.tmpl - -rw-rw-r-- 1 twiki twiki 826 Aug 31 13:08 view.print.tmpl - -rw-rw-r-- 1 twiki twiki 1770 Sep 8 00:32 view.tmpl - -Directory `twiki/data/`: - - drwxrwxr-x 8 nobody nobody 4096 Sep 7 01:04 . - drwxrwxr-x 4 nobody nobody 4096 Sep 10 23:21 .. - -rw-rw-rw- 1 twiki twiki 159 Aug 24 19:49 .htpasswd - drwxrwxr-x 2 nobody nobody 4096 Sep 9 02:45 Know - drwxrwxr-x 2 nobody nobody 4096 Sep 9 02:45 Main - drwxrwxr-x 2 nobody nobody 8192 Sep 14 23:22 TWiki - drwxrwxr-x 2 nobody nobody 4096 Sep 9 02:45 Test - drwxrwxr-x 2 nobody nobody 4096 Sep 14 12:04 Trash - drwxrwxr-x 2 nobody nobody 4096 Sep 9 02:45 _default - -rw-rw-rw-- 1 twiki twiki 0 Jul 1 02:20 debug.txt - -rw-rw-r-- 1 twiki twiki 3419 Aug 13 00:15 mime.types - -rw-rw-rw-- 1 twiki twiki 0 Jul 1 02:19 warning.txt - -Partial file list for `twiki/data/Main`: - - drwxrwxrwx 2 nobody nobody 4096 Aug 19 04:15 . - drwxrwxrwx 6 nobody nobody 4096 Aug 3 01:09 .. - -rw-rw-rw- 1 twiki twiki 3716 Aug 19 02:19 .changes - -rw-rw-rw- 1 twiki twiki 9 Aug 19 02:45 .mailnotify - -rw-r--r-- 1 nobody nobody 358 Aug 18 17:22 OfficeLocations.txt - -r--r--r-- 1 nobody nobody 878 Aug 18 17:22 OfficeLocations.txt,v - -rw-r--r-- 1 nobody nobody 680 Aug 18 17:36 TWikiGuest.txt - -r--r--r-- 1 nobody nobody 1989 Aug 18 17:36 TWikiGuest.txt,v - -rw-r--r-- 1 nobody nobody 459 Aug 18 17:19 TWikiUsers.txt - -r--r--r-- 1 nobody nobody 3840 Aug 18 17:19 TWikiUsers.txt,v - -rw-r--r-- 1 nobody nobody 95 Aug 19 03:06 WebChanges.txt - -r--r--r-- 1 nobody nobody 284 Aug 19 03:06 WebChanges.txt,v - -rw-r--r-- 1 nobody nobody 1853 Aug 18 18:08 WebHome.txt - -r--r--r-- 1 nobody nobody 6523 Aug 18 18:08 WebHome.txt,v - -Directory `twiki/pub/`: - - drwxrwxrwx 6 nobody nobody 4096 Aug 3 01:21 . - drwxrwxr-x 3 twiki twiki 4096 Jun 17 16:35 .. - drwxrwxrwx 3 nobody nobody 4096 Jun 17 16:35 Know - drwxrwxrwx 3 nobody nobody 4096 Aug 3 01:21 TWiki - -rw-rw-r-- 1 twiki twiki 1078 Jan 14 2000 favicon.ico - drwxrwxr-x 2 twiki twiki 4096 Jun 17 16:35 icn - -rw-rw-r-- 1 twiki twiki 3016 Oct 5 1999 twikilogo.gif - -rw-rw-r-- 1 twiki twiki 5320 Oct 5 1999 twikilogo1.gif - -rw-rw-r-- 1 twiki twiki 6125 Oct 5 1999 twikilogo2.gif - -rw-rw-r-- 1 twiki twiki 7218 Oct 5 1999 twikilogo3.gif - -rw-rw-r-- 1 twiki twiki 6710 Oct 5 1999 twikilogo4.gif - -rw-rw-r-- 1 twiki twiki 3501 Sep 14 11:57 twikilogo88x31.gif - -rw-rw-r-- 1 twiki twiki 2877 Jun 7 1999 wikiHome.gif - -Partial file list for `twiki/pub/icn/`: - - drwxrwxr-x 2 twiki twiki 4096 Jun 17 16:35 . - drwxrwxrwx 6 nobody nobody 4096 Aug 3 01:21 .. - -rw-rw-r-- 1 twiki twiki 801 Mar 26 1999 _filetypes.txt - -rw-rw-r-- 1 twiki twiki 143 Mar 9 1999 bat.gif - -rw-rw-r-- 1 twiki twiki 926 Mar 9 1999 bmp.gif - -rw-rw-r-- 1 twiki twiki 141 Mar 25 1999 c.gif - -rw-rw-r-- 1 twiki twiki 144 Mar 9 1999 dll.gif - -rw-rw-r-- 1 twiki twiki 152 Mar 9 1999 doc.gif - --- [[Main/MikeMannix]] - 14 Sep 2001 <br /> -- [[Main/PeterThoeny]] - 14 Sep 2001 <br /> diff --git a/TWiki/BillClinton.mdwn b/TWiki/BillClinton.mdwn deleted file mode 100644 index 2fc53870..00000000 --- a/TWiki/BillClinton.mdwn +++ /dev/null @@ -1 +0,0 @@ -A person who likes cigars. diff --git a/TWiki/BookView.mdwn b/TWiki/BookView.mdwn deleted file mode 100644 index c33a8d3d..00000000 --- a/TWiki/BookView.mdwn +++ /dev/null @@ -1 +0,0 @@ -**BookView** is part of search. It allows you to display the result in book view, e.g. the whole content of topcis is shown instead of a topic summary. This allows you to easily see a whole set of pages, which is useful for printing. diff --git a/TWiki/BumpyWord.mdwn b/TWiki/BumpyWord.mdwn deleted file mode 100644 index 303139b2..00000000 --- a/TWiki/BumpyWord.mdwn +++ /dev/null @@ -1 +0,0 @@ -See %WEB%.WikiWord diff --git a/TWiki/ChangePassword.mdwn b/TWiki/ChangePassword.mdwn deleted file mode 100644 index 9bb5fcc4..00000000 --- a/TWiki/ChangePassword.mdwn +++ /dev/null @@ -1,45 +0,0 @@ -<table align="center" border="true" width="60%"> - <tr> - <td> Terribly sorry about this, but due to the amount of [[WikiSpam]] all automatic password changes, as well as new account creation, has been disabled. Use the [[ResetPassword]] for changing, resetting and creating new passwords for new users. <p> - </p> - <ul> - <li><font size="+1">Use [[ResetPassword]] instead due to [[WikiSpam]]</font></li> - </ul> - <p> Thank you. </p> - <p> -- [[Main/JoachimNilsson]] - 28 Jan 2005 </p> - </td> - </tr> -</table> - -## <a name="Change_password"> Change password </a> - -<form action="%SCRIPTURL%/passwd%SCRIPTSUFFIX%/%MAINWEB%/%HOMETOPIC%" method="post" name="passwd"> - <p> - </p> - <table border="1"> - <tr> - <td align="right">Your %TWIKIWEB%.WikiName: </td> - <td><input name="username" size="40" type="text" value="" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right">Old password </td> - <td><input name="oldpassword" size="40" type="password" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - </tr> - <tr> - <td align="right">New password </td> - <td><input name="password" size="40" type="password" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right">Retype new password </td> - <td><input name="passwordA" size="40" type="password" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right" valign="top"> <input name="TopicName" type="hidden" value="%TOPIC%" /></td> - <td><input name="change" type="hidden" value="on" /> <input type="submit" value=" Request password change " /> (Fields marked <code><font color="red">**</font></code> are required) </td> - </tr> - </table> -</form> - -After submitting this form your password will be changed. %STOPINCLUDE% If you have questions please contact the Wiki webmaster %WIKIWEBMASTER%. diff --git a/TWiki/ChristopheVermeulen.mdwn b/TWiki/ChristopheVermeulen.mdwn deleted file mode 100644 index 83bda2e0..00000000 --- a/TWiki/ChristopheVermeulen.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Christophe Vermeulen is a [[TWikiContributor]]. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/CrisBailiff.mdwn b/TWiki/CrisBailiff.mdwn deleted file mode 100644 index fd10b7ad..00000000 --- a/TWiki/CrisBailiff.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Cris Bailiff is a [[TWikiContributor]]. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/DavidWarman.mdwn b/TWiki/DavidWarman.mdwn deleted file mode 100644 index d02bebc3..00000000 --- a/TWiki/DavidWarman.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -David Warman is a [[TWikiContributor]]. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/DefaultPlugin.mdwn b/TWiki/DefaultPlugin.mdwn deleted file mode 100644 index aae0be36..00000000 --- a/TWiki/DefaultPlugin.mdwn +++ /dev/null @@ -1,71 +0,0 @@ -## <a name="Default_TWiki_Plugin"> Default TWiki Plugin </a> - -The default plugin is used for some deprecated rendering of older TWiki versions and of JosWiki. This plugin can also be used to specify some simple custom rendering rules. **_Note:_** Create a new [[TWIKIWEBTWikiPlugins]] based on [[EmptyPlugin]] if you plan to offer some complex rendering or other functionality. - -### <a name="Syntax_Rules"> Syntax Rules </a> - -Custom rendering rules of the default plugin: - -* Allow old include syntax ( <code>**%INCLUDE:"TopicName"%**</code> ) if Plugin Preferences variable <code>**OLDINCLUDE**</code> is set to <code>**1**</code> -* Render deprecated <code>**\*\_text\_\***</code> as **_bold italic_** text. Test if installed: **\_This is bold italic\_** -* Enable JosWiki rules if JosWiki specific code is uncommented - -Modify file <code>**TWiki/Plugins/DefaultPlugin.pm**</code> to add your own rules or to enable JosWiki rules. - -### <a name="_TOPIC_Settings"> %TOPIC% Settings </a> - -Plugin settings are stored as preferences variables. To reference a plugin setting write <code>**%<plugin>\_<setting>%**</code>, i.e. <code>**%DEFAULTPLUGIN\_SHORTDESCRIPTION%**</code> - -* One line description, is shown in the %TWIKIWEB%.TextFormattingRules topic: - * Set SHORTDESCRIPTION = This plugin can be used to specify some simple custom rendering rules. It also renders deprecated <code>**\*\_text\_\***</code> as **_bold italic_** text. - -* Allow deprecated <code>**%INCLUDE:"TopicName"%**</code> syntax: - * Set OLDINCLUDE = 1 - -* Debug plugin: (See output in `data/debug.txt`) - * Set DEBUG = 0 - -### <a name="Plugin_Installation_Instructions"> Plugin Installation Instructions </a> - -* This plugin is preinstalled, you do not need to install it. - -### <a name="Plugin_Info"> Plugin Info </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <td align="right"> Plugin Author: </td> - <td> %TWIKIWEB%.AndreaSterbini, %TWIKIWEB%.PeterThoeny </td> - </tr> - <tr> - <td align="right"> Plugin Version: </td> - <td> 14 Jul 2001 </td> - </tr> - <tr> - <td align="right"> Change History: </td> - <td> 14 Jul 2001: Changed to plug&amp;play <br /> 27 Feb 2001: Initial version </td> - </tr> - <tr> - <td align="right"> CPAN Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Other Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Perl Version: </td> - <td> 5.0 </td> - </tr> - <tr> - <td align="right"> Plugin Home: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td> - </tr> - <tr> - <td align="right"> Feedback: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td> - </tr> -</table> - -**_Related Topics:_** %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins, [[EmptyPlugin]] - --- %TWIKIWEB%.AndreaSterbini - 27 Feb 2001 <br /> -- %TWIKIWEB%.PeterThoeny - 14 Jul 2001 <br /> diff --git a/TWiki/DeleteOrRenameATopic.mdwn b/TWiki/DeleteOrRenameATopic.mdwn deleted file mode 100644 index f2140cc6..00000000 --- a/TWiki/DeleteOrRenameATopic.mdwn +++ /dev/null @@ -1,17 +0,0 @@ -## <a name="FAQ_"> </a> FAQ: - -How do I delete or rename a topic? - -## <a name="Answer_"> Answer: </a> - -New to the 01-Sep-2001 version of TWiki, you can rename, move and delete topics directly from your browser (previously, these operations could only be done manually, by someone with file-level access to the Web server). - -Moving lets you transfer a topic from one web to another. The soft delete moves a topic to the special <code>**Trash**</code> web, where it's hidden but can be "undeleted" with system administrator access. - -Click <code>**[More]**</code> on the control bar at the bottom of the page you want to change, then choose <code>**[Rename/move]**</code>, and make your changes that screen. There's a link that launches to the [[ManagingTopics]] reference page in a pop-up window. - -**_NOTE:_** The configuration of your site and your own access permissions determine whether you can access these functions. - -**_Back to:_** [[TWikiFAQ]] - --- [[MikeMannix]] - 14 Sep 2001 <br /> diff --git a/TWiki/DontNotify.mdwn b/TWiki/DontNotify.mdwn deleted file mode 100644 index d5b5bb07..00000000 --- a/TWiki/DontNotify.mdwn +++ /dev/null @@ -1,5 +0,0 @@ -Use the "Minor changes, don't notify" checkbox in preview in case you only make a minor change to a topic and you do not want to inform everybody who is on the [[WebNotify]] list of the current web of this change. - -**_Note:_** No new revision is created in case you save the same topic again within a certain time frame (default is one hour). You only need to checkmark the "Minor change, don't notify" checkbox once within this time frame, because subsequent save operations do not notify users. - -**_Note:_** The initial state of the checkbox can be set to on with the `DONTNOTIFYCHECKBOX` preferences variable. See [[TWikiPreferences]] for more. diff --git a/TWiki/EditDoesNotIncreaseTheRevision.mdwn b/TWiki/EditDoesNotIncreaseTheRevision.mdwn deleted file mode 100644 index 637b6fc9..00000000 --- a/TWiki/EditDoesNotIncreaseTheRevision.mdwn +++ /dev/null @@ -1,11 +0,0 @@ -## <a name="FAQ_"> </a> FAQ: - -Why does the topic revision not increase when I edit a topic? - -## <a name="Answer_"> Answer: </a> - -The same topic revision will be used when you save a topic again within a certain time frame (one hour by default). This is to prevent unnecessary topic revisions when you do several edit cycles in a row. Note that a new revision **_is_** created if another person edits the same topic, regardless of the time. - -**_Back to:_** [[TWikiFAQ]] - --- [[Main/PeterThoeny]] - 27 Nov 2000 <br /> diff --git a/TWiki/EmptyPlugin.mdwn b/TWiki/EmptyPlugin.mdwn deleted file mode 100644 index af0e8796..00000000 --- a/TWiki/EmptyPlugin.mdwn +++ /dev/null @@ -1,71 +0,0 @@ -## <a name="Empty_TWiki_Plugin"> Empty TWiki Plugin </a> - -This is an empty plugin you can use as a template to build your own %TWIKIWEB%.TWikiPlugins. This plugin does nothing, but is ready to be used. - -To create your own plugin: - -* Copy file <code>**TWiki/Plugins/EmptyPlugin.pm**</code> to <code>**<name>Plugin.pm**</code> and customize the plugin. -* Create a <code>**<name>Plugin**</code> topic in the %TWIKIWEB% web. Do so by visiting <http://TWiki.org/cgi-bin/view/Plugins/> and starting a new topic to get the default plugin topic text (don't save the topic). Customize your plugin topic to your needs. -* See details in %TWIKIWEB%.TWikiPlugins. - -### <a name="Syntax_Rules"> Syntax Rules </a> - -(none) - -### <a name="_TOPIC_Settings"> %TOPIC% Settings </a> - -Plugin settings are stored as preferences variables. To reference a plugin setting write <code>**%<plugin>\_<setting>%**</code>, i.e. <code>**%EMPTYPLUGIN\_SHORTDESCRIPTION%**</code> - -* One line description, is shown in the %TWIKIWEB%.TextFormattingRules topic: - * Set SHORTDESCRIPTION = This plugin does nothing, but can be used as a template for your own plugins. - -* Your own setting, i.e.: - * Set EXAMPLE = got it! - -* Debug plugin: (See output in `data/debug.txt`) - * Set DEBUG = 0 - -### <a name="Plugin_Installation_Instructions"> Plugin Installation Instructions </a> - -* This plugin is preinstalled, you do not need to install it. - -### <a name="Plugin_Info"> Plugin Info </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <td align="right"> Plugin Author: </td> - <td> %TWIKIWEB%.AndreaSterbini, %TWIKIWEB%.PeterThoeny </td> - </tr> - <tr> - <td align="right"> Plugin Version: </td> - <td> 14 Jul 2001 </td> - </tr> - <tr> - <td align="right"> Change History: </td> - <td> 14 Jul 2001: Changed to plug&amp;play <br /> 27 Feb 2001: Initial version </td> - </tr> - <tr> - <td align="right"> CPAN Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Other Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Perl Version: </td> - <td> 5.0 </td> - </tr> - <tr> - <td align="right"> Plugin Home: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td> - </tr> - <tr> - <td align="right"> Feedback: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td> - </tr> -</table> - -**_Related Topics:_** %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins, [[DefaultPlugin]] - --- %TWIKIWEB%.AndreaSterbini - 27 Feb 2001 <br /> -- %TWIKIWEB%.PeterThoeny - 14 Jul 2001 <br /> diff --git a/TWiki/ExampleTopicTemplate.mdwn b/TWiki/ExampleTopicTemplate.mdwn deleted file mode 100644 index 3f3fe9be..00000000 --- a/TWiki/ExampleTopicTemplate.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -(just an example illustrating how to create a new topic based on a specific template topic. [[TWikiTemplatesVer1]] has more) - --- %WIKIUSERNAME% - %DATE% <br /> diff --git a/TWiki/FileAttachment.mdwn b/TWiki/FileAttachment.mdwn deleted file mode 100644 index 2f414191..00000000 --- a/TWiki/FileAttachment.mdwn +++ /dev/null @@ -1,201 +0,0 @@ -%TOC% %STARTINCLUDE% - -## <a name="File_Attachments"> File Attachments </a> - -Each topic can have files attached to it, similar to an email attachment. Use your browser to upload or download a file. Attachments are stored under revision control, so uploads can never be lost, and files changes can be made with a rollback option that lets you retrieve all previous versions. - -### <a name="What_Are_Attachments_Good_For_"> What Are Attachments Good For? </a> - -File Attachments can be used to create powerful groupware solutions - file sharing, document management - and for speedy Web authoring. - -#### <a name="Document_Management_System"> Document Management System </a> - -* You can use Attachments to store and retrieve documents (in any format, with associated graphics, and other media files); attach documents to specific TWiki topics; collaborate on documents with full revision control; distribute documents on a need-to-know basis using; create a central reference library that's easy to access and manage by an entire user group. - -#### <a name="File_Sharing"> File Sharing </a> - -* For file sharing, [[FileAttachments]] on a series of topics can be used to quickly create a well-documented, categorized digital download center for all types of files: documents; graphics and other media; drivers and patches; applications; anything you can safely upload! - -#### <a name="Web_Authoring"> Web Authoring </a> - -* Through your Web browser, you can easily upload graphics (or sound files, or anything else you want to embed on a page) and place them anywhere in on a single page, or for use across a web, or site-wide. - * **_NOTE:_** You can also add graphics - any files - directly, typically by FTP upload. This requires server access, and may be more convenient if a large number of files, or a particular directory location, is required. These files can't be managed using browser-based Attachment controls. - -### <a name="Uploading_Files"> Uploading Files </a> - -* To upload: Click on the **Attach** link at the bottom of each page. A form is shown where you can browse for a file and upload it. The uploaded file will show up in the File Attachment table. - * Files of any type can be uploaded. Some files that might impose a security risk are renamed, ex: `*.php` files are renamed to `*.php.txt`. - * Currently there is no file size limit besides the disk space on the server. - * The previous upload path is retained for convenience. In case you make some changes to the local file and want to upload it, again you can copy the previous upload path into the Local file field. - -### <a name="Downloading_Files"> Downloading Files </a> - -* To download: Click on the file in the File Attachment table. - -<a name="AttachmentAccess"></a> - -* **_NOTE:_** There is no access control on individual attachments. If you need this type of control, create separate topics and define [[TWikiDocumentation]] per topic. - -### <a name="Moving_Attachment_Files"> Moving Attachment Files </a> - -An attachement can be moved between topics. To do this click **Action** on the attachment to be moved. On the control page, select the new web and topic, the click **Move**. The attachment and its version history are moved. The original location is stored as [[TWikiDocumentation]]. - -### <a name="Deleting_Attachments"> Deleting Attachments </a> - -It is not possible to delete attached files with the current TWiki implementation. However, they can be moved to another topic. You may care to have a topic **Trash.TrashAttachments** - move attachments that are no longer wanted here. - -### <a name="Linking_to_Attached_Files"> Linking to Attached Files </a> - -* Once a file is attached it can be referenced in the topic. Example: - 1. **Attach** file: `Sample.txt` - 2. **Edit** topic and write text: <code>%ATTACHURL%/Sample.txt</code> - 3. **Preview** - <code>%ATTACHURL</code> text appears as: %PUBURL%/%WEB%/%TOPIC%/Sample.txt, a link. - -* To reference an attachment located in another topic, write text: - * <code>%PUBURL%/%WEB%/OtherTopic/Sample.txt</code> (for the same web) - * <code>%PUBURL%/Otherweb/OtherTopic/Sample.txt</code> (for adifferent web) - -* Attached HTML files and text files can be inlined in a topic. Example: - 1. **Attach** file: `Sample.txt` - 2. **Edit** topic and write text: <code>%INCLUDE\{"%ATTACHURL%/Sample.txt"\}%</code> - * Content of attached file is shown inlined. - * Read more in [[IncludeTopicsAndWebPages]]. - -* GIF, JPG and PNG images can be attached and shown embedded in a topic. Example: - 1. **Attach** file: `Smile.gif` - 2. **Edit** topic and write text: <code>%ATTACHURL%/Smile.gif</code> - 3. **Preview** - text appears as %PUBURL%/%WEB%/%TOPIC%/Smile.gif, an image. - -<a name="FileAttachmentTable"></a> - -### <a name="File_Attachment_Contents_Table"> File Attachment Contents Table </a> - -Files attached to a topic are displayed in a directory table, displayed at the bottom of the page, or optionally, hidden and accessed when you click **Attach**. - -> <table border="1" cellpadding="20" cellspacing="0" width="90%"> -> <tr> -> <td> -> <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <th align="center" bgcolor="#99CCCC"><strong><a href="FileAttachment">Attachment</a>:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Action:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Size:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Date:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Who:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Comment:</strong></th> -> </tr> -> <tr> -> <td><img align="top" height="16" src="%PUBURL%/icn/txt.gif" width="16" /> <a href="%SCRIPTURL%/viewfile%SCRIPTSUFFIX%/%WEB%/%TOPIC%?rev=&filename=Sample.txt">Sample.txt</a></td> -> <td><a href="%SCRIPTURL%/attach%SCRIPTSUFFIX%/%WEB%/%TOPIC%?filename=Sample.txt&revInfo=1">action</a></td> -> <td> 30 </td> -> <td> 22 Jul 2000 - 19:37 </td> -> <td><a href="PeterThoeny">PeterThoeny</a></td> -> <td> Just a sample </td> -> </tr> -> <tr> -> <td><img align="top" hight="16" src="%PUBURL%/icn/bmp.gif" width="16" /> <a href="%SCRIPTURL%/viewfile%SCRIPTSUFFIX%/%WEB%/%TOPIC%?rev=&filename=Smile.gif">Smile.gif</a></td> -> <td><a href="%SCRIPTURL%/attach%SCRIPTSUFFIX%/%WEB%/%TOPIC%?filename=Smile.gif&revInfo=1">action</a></td> -> <td> 94 </td> -> <td> 22 Jul 2000 - 19:38 </td> -> <td><a href="PeterThoeny">PeterThoeny</a></td> -> <td> Smiley face </td> -> </tr> -> </table> -> </td> -> </tr> -> </table> - -### <a name="File_Attachment_Controls"> File Attachment Controls </a> - -Clicking on an **Action** link takes you to a new page that looks like this: - -> <form> -> <table border="1" cellpadding="20" cellspacing="0"> -> <tr> -> <td> -> <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <th align="center" bgcolor="#99CCCC"><strong><a href="FileAttachment">Attachment</a>:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Action:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Size:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Date:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Who:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Comment:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong><a href="FileAttribute">Attribute</a>:</strong></th> -> </tr> -> <tr> -> <td><img align="top" height="16" src="%PUBURL%/icn/txt.gif" width="16" /> <a href="%SCRIPTURL%/viewfile%SCRIPTSUFFIX%/TWiki/%WEB%/%TOPIC%?rev=&filename=Sample.txt">Sample.txt</a></td> -> <td><a href="%SCRIPTURL%/attach%SCRIPTSUFFIX%/%WEB%/%TOPIC%?filename=Sample.txt&revInfo=1">action</a></td> -> <td> 30 </td> -> <td> 22 Jul 2000 - 19:37 </td> -> <td><a href="PeterThoeny">PeterThoeny</a></td> -> <td> Just a sample </td> -> <td align="center"> </td> -> </tr> -> <tr> -> <td><img align="top" height="16" src="%PUBURL%/icn/bmp.gif" width="16" /> <a href="%SCRIPTURL%/viewfile%SCRIPTSUFFIX%/%WEB%/%TOPIC%?rev=&filename=Smile.gif">Smile.gif</a></td> -> <td><a href="%SCRIPTURL%/attach%SCRIPTSUFFIX%/%WEB%/%TOPIC%?filename=Smile.gif&revInfo=1">action</a></td> -> <td> 94 </td> -> <td> 22 Jul 2000 - 19:38 </td> -> <td><a href="PeterThoeny">PeterThoeny</a></td> -> <td> Smiley face </td> -> <td align="center"> </td> -> </tr> -> </table> -> <p><nop></nop></p> -> <h2>Update attachment <code>Sample.txt</code></h2> -> <p> -> </p> -> <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <th align="center" bgcolor="#99CCCC"><strong>Version:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Action:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Date:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Who:</strong></th> -> <th align="center" bgcolor="#99CCCC"><strong>Comment:</strong></th> -> </tr> -> <tr> -> <td> 1.1 </td> -> <td><a href="%SCRIPTURL%/viewfile%SCRIPTSUFFIX%/%WEB%/%TOPIC%?rev=1.1&filename=Sample.txt">view</a></td> -> <td> 2001.08.30.09.28.56 </td> -> <td><a href="PeterThoeny">PeterThoeny</a></td> -> <td> </td> -> </tr> -> </table> -> <p> -> </p> -> <table width="100%"> -> <tr> -> <td align="right"> Previous <br /> upload: </td> -> <td><code>C:\DATA\Sample.txt</code> (<a href="PeterThoeny">PeterThoeny</a>) </td> -> </tr> -> <tr> -> <td align="right"> Local file: </td> -> <td><input name="filename" type="hidden" value="Sample.txt" /> <input name="filepath" size="50" type="file" value="C:\DATA\Sample.txt" /></td> -> </tr> -> <tr> -> <td align="right"> Comment: </td> -> <td><input maxlength="50" name="filecomment" size="50" type="text" value="Just a sample" /></td> -> </tr> -> <tr> -> <td align="right"> Link: </td> -> <td><input name="createlink" type="checkbox" /> Create a link to the attached file at the end of the topic. </td> -> </tr> -> <tr> -> <td align="right"> Hide file: </td> -> <td><input name="hidefile" type="checkbox" /> Hide attachment in normal topic view. </td> -> </tr> -> </table><em>Help text ...</em><p> Topic <b>FileAttachment</b> . { </p><input type="submit" value=" Upload file " /> | <input name="changeproperties" type="submit" value="Change properties" /> | <a href="%SCRIPTURLPATH%/rename%SCRIPTSUFFIX%/%WEB%/%TOPIC%?attachment=Sample.txt">Move attachment</a> | <a href="FileAttachment">Cancel</a> } </td> -> </tr> -> </table> -> </form> - -* The first table is a list of all attachments, including their attributes. An `h` means the attachment is hidden, it isn't listed when viewing a topic. - -* The second table is all the versions of the attachment. Click on **View** to see that version. If it's the most recent version, you'll be taken to an URL that always displays the latest version, which is usually what you want. - * **To change the comment** on an attachment, enter a new comment and then click **Change properties**. Note that the comment listed against the specific version will not change, however the comment displayed when viewing the topic does change. - * **To hide/unhide** an attachment, enable the **Hide file** checkbox, then click **Change properties**. - -### <a name="Known_Issues"> Known Issues </a> - -* Unlike topics, attachments are not locked during editing. As a workaround, you can change the comment to indicate an attachment file is being worked on - the comment on the specific version isn't lost, it's there when you list all versions of the attachment. diff --git a/TWiki/FileAttribute.mdwn b/TWiki/FileAttribute.mdwn deleted file mode 100644 index 74a4874c..00000000 --- a/TWiki/FileAttribute.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Each [[FileAttachment]] in a Topic has an attribute string. At present only only the hidden attribute is supported. If the attribute include _h_ then the attachment is considered to be hidden. It is not listed for the topic, but is display when attach page is displayed. - --- [[JohnTalintyre]] - 30 Aug 2001 <br /> diff --git a/TWiki/FindElsewherePlugin.mdwn b/TWiki/FindElsewherePlugin.mdwn deleted file mode 100644 index ff1e77f7..00000000 --- a/TWiki/FindElsewherePlugin.mdwn +++ /dev/null @@ -1,174 +0,0 @@ -## <a name="Find_Elsewhere_Plugin"> Find Elsewhere Plugin </a> - -This plugin will automatically link to another web(s) if a topic isn't found in the current web. - -This is useful for a TWiki site that wants to implement a glossar/dictionary web where common terms are defined and stored. Without this plugin: - -* Each web would need to create their own topic for a common term -* Link to or INCLUDE the topic from where it is defined -* Authors need to remember to put the Web name in front of the topic name, such as [[TWiki/WikiWord]] - -Without this kind of plugin, it's likely that common terms used within an organization will be defined in multiple webs or the common terms will be unlinked wiki words (as if they didn't exist). - -### <a name="Syntax_Rules"> Syntax Rules </a> - -No new rules are introduced. However, new automatic [[TWiki/WikiWord]] linking will occur. - -If a topic is not found in the current web, this plugin will look in the LOOKELSEWHERE web list for that topic. If and when the topic is found as it looks through the webs in their listed order, it will create a link to that page using the [[ ]] syntax. - -<a name="NewFunctionalityTest"></a> New Functionality - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>test case</strong></th> - <th bgcolor="#99CCCC"><strong>input</strong></th> - <th bgcolor="#99CCCC"><strong>output</strong></th> - <th bgcolor="#99CCCC"><strong>expected</strong></th> - </tr> - <tr> - <td> found here </td> - <td><nop>WebHome </nop></td> - <td>[[WebHome]]</td> - <td><nop>WebHome </nop></td> - </tr> - <tr> - <td> found singular here </td> - <td><nop>WebHomes </nop></td> - <td>[[WebHomes]]</td> - <td><nop>WebHomes </nop></td> - </tr> - <tr> - <td> found elsewhere </td> - <td><nop>TWikiAdminGroup </nop></td> - <td>[[TWikiAdminGroup]]</td> - <td><nop>Main.TWikiAdminGroup </nop></td> - </tr> - <tr> - <td> found singular elsewhere </td> - <td><nop>TWikiAdminGroups </nop></td> - <td>[[TWikiAdminGroups]]</td> - <td><nop>Main.TWikiAdminGroups </nop></td> - </tr> -</table> - -Don't break other types of links... - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>input</strong></th> - <th bgcolor="#99CCCC"><strong>output</strong></th> - </tr> - <tr> - <td><nop>%TOPIC%#TopicAnchor </nop></td> - <td> %TOPIC%#NewFunctionalityTest </td> - </tr> - <tr> - <td><nop>TWiki.WebHome </nop></td> - <td>[[TWiki/WebHome]]</td> - </tr> - <tr> - <td><nop>WebHome </nop></td> - <td>[[WebHome]]</td> - </tr> - <tr> - <td> [<nop>[TWiki.WebHome]] </nop></td> - <td>[[TWiki/WebHome]]</td> - </tr> - <tr> - <td> [<nop>[TWiki.WikiWord]] </nop></td> - <td>[[TWiki/WikiWord]]</td> - </tr> - <tr> - <td> [<nop>[TWiki.WikiWords]] </nop></td> - <td>[[TWiki/WikiWords]]</td> - </tr> - <tr> - <td><nop>TWiki.WikiWord </nop></td> - <td>[[TWiki/WikiWord]]</td> - </tr> - <tr> - <td><nop>TWiki.WikiWords </nop></td> - <td>[[TWiki/WikiWords]]</td> - </tr> -</table> - -### <a name="_TOPIC_Settings"> %TOPIC% Settings </a> - -* One line description, is shown in the %TWIKIWEB%.TextFormattingRules topic: - * Set SHORTDESCRIPTION = If a topic isn't found in this web it will look in a predefined list of other webs and attempt to find it there. - -* List other webs in which to look for topics that don't exist - * Set LOOKELSEWHERE = TWiki, Main - -* If the [[TWiki/WikiWord]] is plural but doesn't exist, also look for the singular word. Note this setting is for looking in **other** webs only (plural to singular is still automatically done in the current web). - * Set PLURALTOSINGULAR = 1 - -* Debug plugin: (See output in `data/debug.txt`) - * Set DEBUG = 0 - -### <a name="Plugin_Installation_Instructions"> Plugin Installation Instructions </a> - -* Download the ZIP file from the Plugin web (see below) -* Unzip <code>**%TOPIC%.zip**</code> in your twiki installation directory. Content: - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>File:</strong></th> - <th bgcolor="#99CCCC"><strong>Description:</strong></th> - </tr> - <tr> - <td><code><b>data/TWiki/%TOPIC%.txt</b></code></td> - <td> Plugin topic </td> - </tr> - <tr> - <td><code><b>data/TWiki/%TOPIC%.txt,v</b></code></td> - <td> Plugin topic repository </td> - </tr> - <tr> - <td><code><b>lib/TWiki/Plugins/%TOPIC%.pm</b></code></td> - <td> Plugin Perl module </td> - </tr> -</table> - -* Test if the plugin is correctly installed, by viewing %TOPIC%#NewFunctionalityTest - -### <a name="Plugin_Info"> Plugin Info </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <td align="right"> Plugin Author: </td> - <td>[[Main/MikeBarton]]</td> - </tr> - <tr> - <td align="right"> Plugin Version: </td> - <td> 1 Feb 2002 </td> - </tr> - <tr> - <td align="right"> Change History: </td> - <td> 1 Feb 2002: Initial version </td> - </tr> - <tr> - <td align="right"> CPAN Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Other Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Perl Version: </td> - <td> 5.0 </td> - </tr> - <tr> - <td align="right"> Plugin Home: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td> - </tr> - <tr> - <td align="right"> Feedback: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td> - </tr> -</table> - -**_Related Topics:_** %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins, [[DefaultPlugin]] - --- [[Main/MikeBarton]] - 1 Feb 2002<br /> diff --git a/TWiki/FormattedSearch.mdwn b/TWiki/FormattedSearch.mdwn deleted file mode 100644 index 8cec7728..00000000 --- a/TWiki/FormattedSearch.mdwn +++ /dev/null @@ -1,130 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_Formatted_Search_Results"> TWiki Formatted Search Results </a> - -_Inline search feature allows flexible formatting of search result_ - -## <a name="Overview"> Overview </a> - -By default, the format for displaying a search result is fixed, e.g. a table with rows of topic name and topic summary. Use the `format="..."` parameter to specify a customized format of the search result. The string of the format parameter is typically a bullet list or table row containing variables (i.e. <code>%SEARCH\{ "food" format="| $topic | $summary |" \}%</code>). - -## <a name="Syntax"> Syntax </a> - -Two paramters can be used to specify a customized search result: - -1. `header="..."` parameter - -Use the header paramter to specify the header of a search result. It should correspond to the format of the format parameter. This parameter is optional. I.e. <br /><code>header="| \*Topic:\* | \*Summary:\* |"</code> - -2. `format="..."` parameter - -Use the format paramter to specify the format of one search hit. I.e. <br />`format="| $topic | $summary |"` - -Variables that can be used in the format string: - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Name:</strong></th> - <th bgcolor="#99CCCC"><strong>Expands To:</strong></th> - </tr> - <tr> - <td><code>$n</code></td> - <td> New line </td> - </tr> - <tr> - <td><code>$web</code></td> - <td> Name of the web </td> - </tr> - <tr> - <td><code>$topic</code></td> - <td> Topic name </td> - </tr> - <tr> - <td><code>$locked</code></td> - <td> LOCKED flag (if any) </td> - </tr> - <tr> - <td><code>$date</code></td> - <td> Time stamp of last topic update, i.e. <code>%GMTIME{"$day $mon $year - $hour:$min"}%</code></td> - </tr> - <tr> - <td><code>$isodate</code></td> - <td> Time stamp of last topic update, i.e. <code>%GMTIME{"$year-$mo-$dayT$hour:$minZ"}%</code></td> - </tr> - <tr> - <td><code>$rev</code></td> - <td> Number of last topic revision, i.e. <code>1.4</code></td> - </tr> - <tr> - <td><code>$wikiusername</code></td> - <td> Wiki user name of last topic update, i.e. <code>%MAINWEB%.<nop>JohnSmith</nop></code></td> - </tr> - <tr> - <td><code>$username</code></td> - <td> User name of last topic update, i.e. <code><nop>JohnSmith</nop></code></td> - </tr> - <tr> - <td><code>$summary</code></td> - <td> Topic summary </td> - </tr> - <tr> - <td><code>$formfield(name)</code></td> - <td> The field value of a form field, i.e. <code>$formfield(<nop>TopicClassification)</nop></code> would get expanded to <code>PublicFAQ</code>. This applies only to topics that have a [[TWikiForms]]</td> - </tr> - <tr> - <td><code>$pattern(reg-exp)</code></td> - <td> A regular expression pattern to extract some text from a topic, i.e. <code>$pattern(.*?\*.*?Email\:\s*([^\n\r]+).*)</code> extracts the email address from a bullet of format <code>* Email: ...</code>. </td> - </tr> -</table> - -**_Note:_** For `$pattern(reg-exp)`, specify a [[RegularExpression]] that scans from start to end and contains the text you want to keep in parenthesis, i.e. `$pattern(.*?(from here.*?to here).*)`. You need to make sure that the integrity of a web page is not compromised, i.e. if you include a table make sure to include everything including the table end tag. - -## <a name="Examples"> Examples </a> - -### <a name="Bullet_list_showing_topic_name_a"> Bullet list showing topic name and summary </a> - -Write this: - -<code>%SEARCH\{ "FAQ" scope="topic" nosearch="on" nototal="on" header=" \* \*Topic: Summary:\*" format=" \* [[$topic]]: $summary" \}%</code> - -To get this: - -%SEARCH\{ "FAQ" scope="topic" nosearch="on" nototal="on" header=" \* \*Topic: Summary:\*" format=" \* [[Topic]]: $summary" \}% - -### <a name="Table_showing_form_field_values_"> Table showing form field values of topics with a form </a> - -Write this in the Know web: - -<code>| \*Topic:\* | \*OperatingSystem:\* | \*OsVersion:\* |</code><br /><code>%SEARCH\{ "[T]opicClassification.\*?value=\\"[P]ublicFAQ\\"" scope="text" regex="on" nosearch="on" nototal="on" format="| [[$topic]] | $formfield(OperatingSystem) | $formfield(OsVersion) |" \}%</code> - -To get this: - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Topic:</strong></th> - <th bgcolor="#99CCCC"><strong>OperatingSystem:</strong></th> - <th bgcolor="#99CCCC"><strong>OsVersion:</strong></th> - </tr> - <tr> - <td><a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/Know/IncorrectDllVersionW32PTH10DLL">IncorrectDllVersionW32PTH10DLL</a></td> - <td><a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/Know/OsWin">OsWin</a></td> - <td> 95/98 </td> - </tr> - <tr> - <td><a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/Know/WinDoze95Crash">WinDoze95Crash</a></td> - <td><a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/Know/OsWin">OsWin</a></td> - <td> 95 </td> - </tr> -</table> - -### <a name="Extract_some_text_from_a_topic_u"> Extract some text from a topic using regular expression </a> - -Write this: - -<code>%SEARCH\{ "\_\_Back to\\:\_\_ TWikiFAQ" scope="text" regex="on" nosearch="on" nototal="on" header="TWiki FAQs:" format=" \* $pattern(.\*?FAQ\\:[\\n\\r]\*([^\\n\\r]+).\*) [[$topic]\[Answer...]]" \}%</code> - -To get this: - -%SEARCH\{ "\_\_Back to\\:\_\_ [[TWikiFAQ]]" scope="text" regex="on" nosearch="on" nototal="on" header="TWiki FAQs:" format=" \* $pattern(.\*?FAQ\\:[\\n\\r]\*([^\\n\\r]+).\*) [[Topic]]" \}% - --- [[Main/PeterThoeny]] - 28 Nov 2001 <br /> diff --git a/TWiki/FreeBSD.mdwn b/TWiki/FreeBSD.mdwn deleted file mode 100644 index 9d1bee49..00000000 --- a/TWiki/FreeBSD.mdwn +++ /dev/null @@ -1,7 +0,0 @@ -Another [[Hurd/OpenSource]] kernel effort, under the BSDLicense. - -Actually, there are more of them, the BSD's. To get a full listing visit - -<http://www.bsd.org> - --- [[Main/JoachimNilsson]] - 11 May 2002 diff --git a/TWiki/GnuFansBlogDiscuss.mdwn b/TWiki/GnuFansBlogDiscuss.mdwn deleted file mode 100644 index 7e95673a..00000000 --- a/TWiki/GnuFansBlogDiscuss.mdwn +++ /dev/null @@ -1,9 +0,0 @@ -Why? What is this about? - -OK, this clearly doesn't exist today. However there is some discussion on the TWiki: website. - -I'm interested in this area because I am in addition to my work here running the TWiki:Codev/TWikiIRC channel. In there I have implemented a Chump IRC -> XML blogging robot. I'm having fun with it too even if I need to script the XML conversion and have put it off for much too long. - -I think there will one day be a reorganization of the way that TWiki does notifications for email and the RSS feeds, combining them into a flexible channel. Blogs are one outlet (or maybe just an inlet) for collaborative information sharing. I'll keep my eye on this area for now. - --- [[Main/GrantBow]] - 17 Jan 2003 diff --git a/TWiki/GnuFansEmailDiscuss.mdwn b/TWiki/GnuFansEmailDiscuss.mdwn deleted file mode 100644 index d916bf89..00000000 --- a/TWiki/GnuFansEmailDiscuss.mdwn +++ /dev/null @@ -1,17 +0,0 @@ -OK, here'a a place to discuss the Hurd community email lists. - -_Problem:_ - -Right now serious discussions are held via email. There are several email lists as demonstrated in [[Hurd/MailLists]]. This keeps some folks from bothering to use the Hurd wiki. - -_Solution:_ - -Integrate email better with hurd.gnufans.org. There are lots of ways this is possible. For now I plan to brainstorm in this topic. - -I have already collected some links to topics about this at TWiki:Main/GrantBow. - -_Result:_ - -Quicker adoption within the Hurd Community. Secondary benefit is that TWiki is weak in this area. - --- [[Main/GrantBow]] - 17 Jan 2003 diff --git a/TWiki/GnuFansHelpHurdProject.mdwn b/TWiki/GnuFansHelpHurdProject.mdwn deleted file mode 100644 index 6c5c5a85..00000000 --- a/TWiki/GnuFansHelpHurdProject.mdwn +++ /dev/null @@ -1,9 +0,0 @@ -I was discussing the current community situation with a few choice people. We agreed that the Hurd project runs on alot of email. It's the primary method. This is good for interactivity, but not good for knowledge management - even if an email has a URL we can point to in the archive it's of limited use since you can't append to it. It's relatively fleeting feedback and very static. - -In theory this site can provide a supplement for those seeking help with the Hurd. A functional if not very clearly organized example exists on the TWiki:Support web. - -There have also been discussions about Email integration with Hurd in different ways. We have a unique situation in that the mail list and archives already exist. - -This topic is for discussion about what might be possible to provide for the benefit of the Hurd community. - --- [[Main/GrantBow]] - 18 Jan 2003 diff --git a/TWiki/GnuFansIRCDiscuss.mdwn b/TWiki/GnuFansIRCDiscuss.mdwn deleted file mode 100644 index be9dbbd2..00000000 --- a/TWiki/GnuFansIRCDiscuss.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -It's wonderful that [[Hurd/HurdIRC]] has resulted in a directory of some of the resources related to IRC like the Perl IRC Statistics Generator (PISG) output processing. I think more interesting stuff is possible. This is a place to discuss it. - --- [[Main/GrantBow]] - 17 Jan 2003 diff --git a/TWiki/GnuFansW3mTips.mdwn b/TWiki/GnuFansW3mTips.mdwn deleted file mode 100644 index d8c9ca54..00000000 --- a/TWiki/GnuFansW3mTips.mdwn +++ /dev/null @@ -1,26 +0,0 @@ -I'm so excited to be working with w3m and my favorite editor right now editing this topic! - -When Debian installs w3m I also chose to install some enhancements. - -<dl> - <dt> w3m</dt> - <dd> (from .../archives/w3m_0.3.1-3_i386.deb) - the main package </dd> - <dt> libgc6</dt> - <dd> (from .../libgc6_1%3a6.0+6.1alpha4-3_i386.deb) - a needed library </dd> - <dt> w3m-ssl</dt> - <dd> (from .../w3m-ssl_0.3-2_i386.deb) - ssl support, I haven't tried this yet. </dd> - <dt> w3m-el</dt> - <dd> (from .../w3m-el_1.3.3-2_all.deb) - emacs integration </dd> - <dt> w3m-img</dt> - <dd> (from .../w3m-img_0.3.1-3_i386.deb) - image support </dd> -</dl> - -I have not fully explored it yet, but the image support is not too bad! I'm using a kconsole xterm and the images are rendered (somehow) over the top. The rendering leaves behind artifacts, the images pop on and off as I scroll through the document, but this is wonderful! - -Another trick I used so that the key mappings were something I am familiar with is described in /usr/share/doc/w3m/README.Debian. I changed to use the lynx keyboard commands. I simply ran this command to make it work like my fingers already know how to operate pretty well: - -`cp /usr/share/doc/w3m/examples/keymap.lynx ~/.w3m/keymap` - -Whala!! A text based browser with image support that edits <http://hurd.gnufans.org> pages with your favorite curses-based editor. - --- [[Main/GrantBow]] - 17 Jan 2003 diff --git a/TWiki/GnuGeneralPublicLicense.mdwn b/TWiki/GnuGeneralPublicLicense.mdwn deleted file mode 100644 index d5f90654..00000000 --- a/TWiki/GnuGeneralPublicLicense.mdwn +++ /dev/null @@ -1,17 +0,0 @@ -## <a name="FAQ_"> </a> FAQ: - -TWiki has a GPL (GNU General Public License). What is GPL? - -## <a name="Answer_"> Answer: </a> - -TWiki is distributed under the GNU General Public License, see [[TWikiDownload]]. GPL is one of the free software licenses that protects the copyright holder, and at the same time allows users to redistribute the software under the terms of the license. Extract: - -* This program is open source software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. -* This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. -* See the GNU General Public License for more details, published at <http://www.gnu.ai.mit.edu/copyleft/gpl.html> - -Please note that TWiki is not distributed under the LGPL (Lesser General Public Licence), which implies TWiki can only be used with software that is licensed under conditions compliant with the GPL. Embedding in proprietary software requires an alternative license. Contact the author for details. - -**_Back to:_** [[TWikiFAQ]] - --- [[Main/PeterThoeny]] - 27 Nov 2000 <br /> diff --git a/TWiki/GnuSkin.mdwn b/TWiki/GnuSkin.mdwn deleted file mode 100644 index 762e1258..00000000 --- a/TWiki/GnuSkin.mdwn +++ /dev/null @@ -1,39 +0,0 @@ -### <a name="Welcome_to_the_GnuSkin"> </a> Welcome to the [[GnuSkin]] - -So named because of the hidden Gnu head and, of course, its simplistic design. It was originally designed for [the GNU Hurd](http://hurd.gnufans.org/) wiki, but is now easily available to other people as well. See the historic notes, below, for more trivia. - -The [[GnuSkin]] is conceived to be simple and functional, providiing a basic, yet useful environment suitable for production use. It uses the [[WebMenu]] concept, first introduced by the [[TigerSkin]], and reintroduces the WEBLOGO idea making it possible to completely tailor fit the looks of the TWiki. - -See it in action on the [[HurdWiki]]:Hurd/ - -**_Features:_** - -* Top menubar including the main features of the TWiki - -* Per-web configurable navigation bar on the left hand side, content on the right - -* Per web configurable logotypes. - -**_Installation:_** - -See [[GnuSkinInstall]] for details of download and installation instructions. - -**_Plugins:_** - -The [[GnuSkin]] comes with a plugin - see [[GnuSkinPlugin]] - which acts as a kind of engine. It inserts items such as the left hand menu by reading the [[WebMenu]] topic. - -The [[GnuSkin]] can also be used with the [[SessionPlugin]] - it then allows logon and session management. - -## <a name="History"> History </a> - -Originally the idea of using a skin different from the original TWiki look was born on [the Hurd wiki](http://vmlinux.org/twiki/bin/view/Hurd/). Unfortunately the available skins and plugins where either too bloated or only designed for one type of user agent in mind. - -The idea of the [[GnuSkin]] was born. It started out as a rip off the famous [[TigerSkin]]. Since then almost all of the templates have been remade, leaving only the Perl plugin part relativly unchanged. - -The design was inteded to more like a general [GNU](http://www.gnu.org) web page with a lean & simple interface, yet still good looking and stylish. At the time [the Hurd website](http://hurd.gnu.org) modeled for the looks and on top of that a few bells and whistles from TWiki was added. - -## <a name="Contact_Information"> Contact Information </a> - -For help and advice, please email %MAINWEB%.JoachimNilsson, or make use of the [[GnuSkinPluginDev]] public forum. - -To see what is being working on and what is planned for upcoming releases, see [[GnuSkinTodo]]. diff --git a/TWiki/GnuSkin/GnuSkin-2002_06_04_094442_shot.jpg b/TWiki/GnuSkin/GnuSkin-2002_06_04_094442_shot.jpg Binary files differdeleted file mode 100644 index 19f4d4e9..00000000 --- a/TWiki/GnuSkin/GnuSkin-2002_06_04_094442_shot.jpg +++ /dev/null diff --git a/TWiki/GnuSkin/RCS/menuscript.js b/TWiki/GnuSkin/RCS/menuscript.js deleted file mode 100644 index 6b30f176..00000000 --- a/TWiki/GnuSkin/RCS/menuscript.js +++ /dev/null @@ -1,289 +0,0 @@ -// Determine browser type (Netscape 6 or IE 5.5).
-
-
-var isIE5 = (navigator.userAgent.indexOf("MSIE 5.5") > 0) ? 1 : 0;
-var isIE5 = (navigator.userAgent.indexOf("MSIE 5") > 0) ? 1 : 0;
-var isNS6 = (navigator.userAgent.indexOf("Gecko") > 0) ? 1 : 0;
-var isNS4 = ((navigator.appName.indexOf("Netscape")==0)
- &&(navigator.userAgent.indexOf("Mozilla/4") == 0)) ? 1 : 0;
-
-//if (isNS4==0)
-// alert("This skin has been designed for Netscape 4.x.");
-
-// For IE, adjust menu bar styling.
-
-if (isIE5) {
- document.styleSheets[document.styleSheets.length - 1].addRule("#menuBar", "padding-top:3px");
- document.styleSheets[document.styleSheets.length - 1].addRule("#menuBar", "padding-bottom:3px");
-}
-
-// Global variable for tracking the currently active button.
-
-var activeButton = null;
-
-if (isIE5)
- document.onmousedown = pageMousedown;
-if (isNS6)
- document.addEventListener("mousedown", pageMousedown, true);
-
-function pageMousedown(event) {
-
- var className;
-
- // If the object clicked on was not a menu button or item, close any active
- // menu.
-
- if (isIE5)
- className = window.event.srcElement.className;
- if (isNS6)
- className = (event.target.className ?
- event.target.className : event.target.parentNode.className);
-
- //Top menu mouseover
- if (className != "menuButton" && className != "menuItem" && className != "menuItemDiff" && activeButton)
- resetButton(activeButton);
-
-
- //Left menu show hide
- var eSrc = window.event.srcElement;
- window.event.cancelBubble = true;
- if ("clsShowHide" == eSrc.className) return contentsHeading_click(eSrc);
-
- //Original version of this (with frames support)
- //while ("BODY" != eSrc.tagName) {
- // if ("clsItem" == eSrc.className || "clsItemSelect" == eSrc.className) return contentsItem_click(eSrc);
- // else if ("clsShowHide" == eSrc.className || "clsHeading" == eSrc.className) return contentsHeading_click(eSrc);
- // eSrc = eSrc.parentElement;
- //}
-}
-
-function buttonClick(button, menuName) {
-
- // Blur focus from the link to remove that annoying outline.
-
- if (!isNS4)
- button.blur();
-
- // Associate the named menu to this button if not already done.
-
- if (!button.menu)
- {
- if (isNS4)
- button.menu = document.layers[menuName];
- else
- button.menu = document.getElementById(menuName);
- }
-
-
- // Reset the currently active button, if any.
-
- if (activeButton && activeButton != button)
- resetButton(activeButton);
-
- // Toggle the button's state.
-
- if (button.isDepressed)
- resetButton(button);
- else
- depressButton(button);
-
- return false;
-}
-
-function buttonMouseover(button, menuName) {
-
- // If any other button menu is active, deactivate it and activate this one.
- // Note: if this button has no menu, leave the active menu alone.
-
- if (activeButton) {
- if (activeButton != button) {
- resetButton(activeButton);
- if (menuName)
- buttonClick(button, menuName);
- }
- else {
- }
- }
- else {
- if (menuName)
- buttonClick(button, menuName);
- }
-}
-
-function depressButton(button) {
-
- // Save current style values so they can be restored later.
- // Only needs to be done once.
-
- if (!button.oldBackgroundColor) {
- button.oldBackgroundColor = button.style.backgroundColor;
- button.oldBorderBottomColor = button.style.borderBottomColor;
- button.oldBorderRightColor = button.style.borderRightColor;
- button.oldBorderTopColor = button.style.borderTopColor;
- button.oldBorderLeftColor = button.style.borderLeftColor;
- button.oldColor = button.style.color;
- button.oldLeft = button.style.left;
- button.oldPosition = button.style.position;
- button.oldTop = button.style.top;
- }
-
- // Change style value to make the button looks like it's
- // depressed.
-
- button.style.backgroundColor = "#99CC99";
- button.style.borderBottomColor = "#99CC99";
- button.style.borderRightColor = "#99CC99";
- button.style.borderTopColor = "#99CC99";
- button.style.borderLeftColor = "#99CC99";
- button.style.color = "#E9E9E9";
- button.style.left = "0px";
- button.style.position = "relative";
- button.style.top = "0px";
-
- // For IE, force first menu item to the width of the parent menu,
- // this causes mouseovers work for all items even when cursor is
- // not over the link text.
-
- if (isIE5 && !button.menu.firstChild.style.width)
- button.menu.firstChild.style.width =
- button.menu.offsetWidth + "px";
-
-if (isNS4)
-{
- button.menu.left = (window.innerWidth-100);
- button.menu.top = 0;
- button.menu.visibility = "show";
-}
-else
-{
-
-
- // Position the associated drop down menu under the button and
- // show it. Note that the position must be adjusted according to
- // browser, styling and positioning.
-
- //x = getPageOffsetLeft(button);
- x = getPageOffsetLeft(button);
- y = getPageOffsetTop(button) + button.offsetHeight;
- if (isIE5)
- y += 2;
- if (isNS6) {
- x--;
- y--;
- }
- x -= 20;
- y -= 10;
- button.menu.style.left = x + "px";
- button.menu.style.top = y + "px";
- button.menu.style.visibility = "visible";
-}
-
- // Set button state and let the world know which button is
- // active.
-
- button.isDepressed = true;
- activeButton = button;
-}
-
-function resetButton(button) {
-
- // Restore the button's style settings.
-
- button.style.backgroundColor = button.oldBackgroundColor;
- button.style.borderBottomColor = button.oldBorderBottomColor;
- button.style.borderRightColor = button.oldBorderRightColor;
- button.style.borderTopColor = button.oldBorderTopColor;
- button.style.borderLeftColor = button.oldBorderLeftColor;
- button.style.color = button.oldColor;
- button.style.left = button.oldLeft;
- button.style.position = button.oldPosition;
- button.style.top = button.oldTop;
-
- // Hide the button's menu.
-
- if (button.menu)
- {
- if (isNS4)
- button.menu.visibility = "hide";
- else
- button.menu.style.visibility = "hidden";
-
- }
-
-
- // Set button state and clear active menu global.
-
- button.isDepressed = false;
- activeButton = null;
-}
-
-function getPageOffsetLeft(el) {
-
- // Return the true x coordinate of an element relative to the page.
-
- return el.offsetLeft + (el.offsetParent ? getPageOffsetLeft(el.offsetParent) : 0);
-}
-
-
-function getPageOffsetTop(el) {
-
- // Return the true y coordinate of an element relative to the page.
-
- return el.offsetTop + (el.offsetParent ? getPageOffsetTop(el.offsetParent) : 0);
-}
-
-
-// Swap background colour
-function bgcolour(obj, Colour) {
- obj.style.backgroundColor=Colour
-}
-
-//Pop up window
-function MM_openBrWindow(theURL,winName,features) { //v2.0
- window.open(theURL,winName,features);
-}
-
-function MM_findObj(n, d) { //v3.0
- var p,i,x; if(!d) d=document; if((p=n.indexOf("?"))>0&&parent.frames.length) {
- d=parent.frames[n.substring(p+1)].document; n=n.substring(0,p);}
- if(!(x=d[n])&&d.all) x=d.all[n]; for (i=0;!x&&i<d.forms.length;i++) x=d.forms[i][n];
- for(i=0;!x&&d.layers&&i<d.layers.length;i++) x=MM_findObj(n,d.layers[i].document); return x;
-}
-/* Functions that swaps %PUBURLPATH%/skins/tiger. */
-function MM_swapImage() { //v3.0
- var i,j=0,x,a=MM_swapImage.arguments; document.MM_sr=new Array; for(i=0;i<(a.length-2);i+=3)
- if ((x=MM_findObj(a[i]))!=null){document.MM_sr[j++]=x; if(!x.oSrc) x.oSrc=x.src; x.src=a[i+2];}
-}
-
-//Left menu folders
-var eSelected = null;
-function contentsHeading_click(eSrc) {
- if ("clsShowHide" == eSrc.className) eSrc = document.all[eSrc.sourceIndex + 1];
- var iNumElements = document.all.length;
- for (var i=eSrc.sourceIndex+1;i<iNumElements;i++) {
- var eTemp = document.all[i];
- if ("clsHeading" == eTemp.className) return;
- else if ("clsItemsHide" == eTemp.className) {
- eTemp.className = "clsItemsShow";
- //No image url in .js - not subject to wiki vars
- //eSrc.style.listStyleImage = "url('images/blueminus.gif')";
- return eSrc.blur();
- }
- else if("clsItemsShow" == eTemp.className) {
- eTemp.className = "clsItemsHide";
- //No image url in .js - not subject to wiki vars
- //eSrc.style.listStyleImage = "url('images/blueplus.gif')";
- return eSrc.blur();
- }
- }
-}
-function contentsItem_click(eSrc) {
- if (document.all["styleView"]) eSrc.target = document.all["styleView"].checked ? "_blank" : "TEXT";
- else if ("" == eSrc.target) eSrc.target = "TEXT"
- if(null != eSelected) eSelected.className = "clsItem";
- eSrc.className = "clsItemSelect";
- eSelected = eSrc;
-}
-
-
-
diff --git a/TWiki/GnuSkinInstall.mdwn b/TWiki/GnuSkinInstall.mdwn deleted file mode 100644 index fbfe2751..00000000 --- a/TWiki/GnuSkinInstall.mdwn +++ /dev/null @@ -1,140 +0,0 @@ -## <a name="GnuSkin_Download_amp_Installatio"> GnuSkin Download & Installation Instructions </a> - -Visit <http://twiki.org/cgi-bin/view/Plugins/GnuSkinInstall> on <http://twiki.org> for the latest and greatest. Both updated installation instructions and the latest ZIP files. - -**_Briefly:_** - -* Download the ZIP file from the Plugin web (see below) -* Unzip <code>**GnuSkin-1.0.0.zip**</code> in your twiki installation directory. Content: - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>File:</strong></th> - <th bgcolor="#99CCCC"><strong>Description:</strong></th> - </tr> - <tr> - <td><code><b>data/TWiki/GnuSkin.txt</b></code></td> - <td> Skin description </td> - </tr> - <tr> - <td><code><b>data/TWiki/GnuSkinPlugin.txt</b></code></td> - <td> Plugin description </td> - </tr> - <tr> - <td><code><b>data/TWiki/GnuSkinPluginDev.txt</b></code></td> - <td> Development notes &amp; discus </td> - </tr> - <tr> - <td><code><b>data/TWiki/GnuSkinInstall.txt</b></code></td> - <td> Installation notes </td> - </tr> - <tr> - <td><code><b>lib/TWiki/Plugins/GnuSkinPlugin.pm</b></code></td> - <td> Plugin Perl module </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/add-attachment.png</b></code></td> - <td> Attachment icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/bubble-LL.png</b></code></td> - <td> Lower left round edege icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/bubble-LR.png</b></code></td> - <td> Lower right round edege icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/bubble-UL.png</b></code></td> - <td> Upper left round edege icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/bubble-UR.png</b></code></td> - <td> Upper right round edege icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/edit.png</b></code></td> - <td> Edit topic icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/folder.png</b></code></td> - <td> Folder (more) icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/logo.png</b></code></td> - <td> Default web logotype icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/page.png</b></code></td> - <td> View topic icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/print.png</b></code></td> - <td> View printable icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/rcs_diff.png</b></code></td> - <td> View diffs icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/search.png</b></code></td> - <td> Search topics icon </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/twiki.css</b></code></td> - <td> Style Sheet, blue </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/twikiblue.css</b></code></td> - <td> Default style </td> - </tr> - <tr> - <td><code><b>pub/TWiki/GnuSkin/twikigreen.css</b></code></td> - <td> Green style </td> - </tr> - <tr> - <td><code><b>templates/edit.gnu.tmpl</b></code></td> - <td> Edit topic template </td> - </tr> - <tr> - <td><code><b>templates/preview.gnu.tmpl</b></code></td> - <td> Topic preview template </td> - </tr> - <tr> - <td><code><b>templates/rdiff.gnu.tmpl</b></code></td> - <td> Topic diffs template </td> - </tr> - <tr> - <td><code><b>templates/twiki.gnu.tmpl</b></code></td> - <td> Snippets for genric templates </td> - </tr> - <tr> - <td><code><b>templates/view.gnu.tmpl</b></code></td> - <td> View topic template </td> - </tr> -</table> - -* Check any of the topics, e.g., the [[GnuSkin]] topic to verify installation. -* Test if the plugin is correctly installed: - * Make sure the SKINHANDLER is set to Gnu and the - * SKIN variable is set to gnu. - -**_Comprehensively:_** - -* Download the [[GnuSkin]]-X.Y.Z.zip, or gnuskin-X.Y.Z.tgz, archive from the list of attachments at the bottom of this page. (X.Y.Z is the version number). - -* Unpack the archive inside your TWiki installation directory. (All the [[GnuSkin]] files have a Gnu substring embedded to ensure you do not overwrite any of TWik's original files.) - -* In case you do not have the [[TigerSkin]] installed you also need to download and install the [[WebMenu]] package in the same directory. The [[GnuSkin]] and the [[TigerSkin]] shares the [[WebMenu]] format.(The WebMenu format is unlikely to change, and even if it does it will require a major version upgrade.) - -* Edit the %TWIKIWEB%.WebMenu topic to set the contents of the menu bar. See the %TWIKIWEB%.WebMenuFormat for details. - -* Add the following line to %TWIKIWEB%.TWikiPreferences or to any [[WebPreferences]] topic. Remember, six spaces an asterisk and the <code>**Set**</code> keyword to specify an option. - - * Set SKIN = gnu - -* If using multiple skin handlers then the following line needs to be included in %TWIKIWEB%.TWikiPreferences to set the TWiki wide default or in a specific [[WebPreferences]] topic to use the Gnu Skin handler only for that Web. - - * Set SKINHANDLER = Gnu - -* **Note:** If this is the first (and only) skin handler the TWiki skin handler defaults to procssing the SKIN unless SKINHANDLER is set to some value besides Gnu. diff --git a/TWiki/GnuSkinPlugin.mdwn b/TWiki/GnuSkinPlugin.mdwn deleted file mode 100644 index ae20183d..00000000 --- a/TWiki/GnuSkinPlugin.mdwn +++ /dev/null @@ -1,68 +0,0 @@ -## <a name="Welcome_to_the_TOPIC_"> Welcome to the %TOPIC% </a> - -This is the supplemental plugin for the [[GnuSkin]]. It provides a small Perl engine for handling dynamic, user configurable, content. For more information see the [[GnuSkin]] page. - -**_Installation:_** - -See [[GnuSkinInstall]] for details of download and installation instructions. - -### <a name="_TOPIC_Default_Settings"> %TOPIC% Default Settings </a> - -Plugin settings are stored as preferences variables. To reference a plugin setting write <code>**%<plugin>\_<setting>%**</code>, i.e. <code>**%EMPTYPLUGIN\_SHORTDESCRIPTION%**</code> - -* One line description, is shown in the %TWIKIWEB%.TextFormattingRules topic: - * Set SHORTDESCRIPTION = Supplements the bare bones [[GnuSkin]] theme for TWiki - -* Debug plugin: (See output in `data/debug.txt`) - * Set DEBUG = 0 - -An example logo, named `logo.png`, is provided in the [[GnuSkin]] library. To provide your own web-specific logo, attach a file named `logo.png` to any [[WebPreferences]] page, or set the WEBLOGO variable on the same page to use a logo with a different name. - -> * <code>**Set WEBLOGO = %PUBURL%/%MAINWEB%/LogoTopic/my\_project\_logo.png**</code> - -For non-graphical user agents the `alt` attribute of the WEBLOGO is hard coded to be the ASCII representation of our favourite animal supplemented with the name of the currently displayed wiki web. - -* A configurable left hand menu bar - the contents can be set in an editable [[WebMenu]] topic - one for the %TWIKIWEB% web and optionally one for other webs. See [[WebMenuFormat]] for details. , supplied one cover TWiki, Main and Test Webs - -## <a name="Plugin_Info"> Plugin Info </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <td align="center"> Plugin Author: </td> - <td>[[Main/JoachimNilsson]]</td> - </tr> - <tr> - <td align="center"> Plugin Version: </td> - <td> 28 May 2002 </td> - </tr> - <tr> - <td align="center"> Change History: </td> - <td> </td> - </tr> - <tr> - <td align="center"> 28 May 2002: </td> - <td> Project started </td> - </tr> - <tr> - <td align="center"> CPAN Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Other Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="center"> Perl Version: </td> - <td> 5.005 </td> - </tr> - <tr> - <td align="center"> Plugin Home: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td> - </tr> - <tr> - <td align="center"> Feedback: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td> - </tr> -</table> - -**_Related Topics:_** %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins diff --git a/TWiki/GnuSkinPluginDev.mdwn b/TWiki/GnuSkinPluginDev.mdwn deleted file mode 100644 index 883b969e..00000000 --- a/TWiki/GnuSkinPluginDev.mdwn +++ /dev/null @@ -1,46 +0,0 @@ -## <a name="Development_Information"> Development Information </a> - -The [[GnuSkinPluginDev]] provides a public forum for discussion regarding the [[GnuSkin]] and its plugin. - -**_Primary goals include:_** - -Issues the current release, v1.0, will address. - -* Basic skin compatible with most browsers: Mozilla 4.xx-6.xx, Lynx, W3M, Links, (X)Emacs/W3 and maybe even Internet Explorer. -* Looks, "skin deep" design � la [The Hurd](http://hurd.gnu.org) web pages. -* User configurable everything, as far as possible. Therefore the TigerSkin's WebMenu parser is integrated. - -**_Secondary goals:_** - -These design goals will go into the v2.0 series of the Gnuskin. - -* Quicker. -* Lesser files. -* Smaller. -* Extended configurability - Edit **all** of the webmenu, change topmenu, etc. - -## <a name="Syntax_Rules"> Syntax Rules </a> - -* WebMenuFormat for details on how to write a WebMenu - -## <a name="ToDo"> ToDo </a> - -* Simplify, simplify, simplify! - -# <a name="Forum"> Forum </a> - -Public Forum opened. - --- [[Main/JoachimNilsson]] - 28 May 2002 - -There was no attachment on [[Plugins/GnuSkinPlugin]]..... - --- [[Main/ThomasWeigert]] - 28 Jun 2002 - -Coming, public beta release has been delayed due to the author being dismissed from his current employment. Please stay tuned for more information later this coming week. - --- [[Main/JoachimNilsson]] - 04 Jul 2002 - -Packaging in progress. Just need to find out what files to distribute ... as well as check them into CVS. - --- [[Main/JoachimNilsson]] - 10 Jul 2002 diff --git a/TWiki/GnuSkinReleaseNotes.mdwn b/TWiki/GnuSkinReleaseNotes.mdwn deleted file mode 100644 index de4e1026..00000000 --- a/TWiki/GnuSkinReleaseNotes.mdwn +++ /dev/null @@ -1,63 +0,0 @@ -<div> - <center> [ [[GnuSkin]] | [[GnuSkin]] | [[GnuSkinPlugin]] | [[GnuSkinTodo]] | <nop>GnuSkinReleaseNotes | <a href="http://savannah.gnu.org/projects/twiki-skins" target="_top">CVS</a> ] </nop></center> -</div> - -## <a name="Release_Notes_for_the_GnuSkin"> </a> Release Notes for the [[GnuSkin]] - -Here are the release notes for the [[GnuSkin]]. Latest releases first. - -For current development efforts, see [[GnuSkinTodo]] - -**_Credits To:_** - -* TWiki:Main/EstebanManchado for the TWiki:Codev/PhotonSearch - -* TWiki:Main/ColasNahaboo for the TWiki:Codev/SavemultiCgiScript - -* All the countless users who keep helping tracking down bugs and gaving me useful and encouraging comments. - -### <a name="Release_1_2"> Release 1.2 </a> - -The current 1.x branch for the TWiki:Codev/AthensRelease of TWiki. This is currently HEAD of the CVS tree, but after the 1.2 release it will go into its own 1.x branch for separate maintenance. - -* Documentation - * Cleaned up the documentation - more useful information, less non-sense. - * Documented all settings affecting [[GnuSkin]] beahviour. - -* Added more "empty" templates that include the style sheet. - -* Displays mouse-over help on Go/Search button. - -* CSS fixes: - * Visited links should not have the same color as non-visited links. <br /> Reported by TWiki:Main/PeterMasiar - 15 Jan 2003 - -* Implemented a better TWiki:Codev/GoIsSearch for the search field. - * Used a modified version of TWiki:Codev/PhotonSearch by TWiki:Main/EstebanManchado - -* Reintroduce the preview - people seem to want it back. - * Uses the TWiki:Codev/SavemultiCgiScript by TWiki:Main/ColasNahaboo - -* Fixed messed up PNG's that IE cannot display correctly. - * IE looks better after this fix - NS4 however, is not affected. Perhaps supply a separate GIF patch for sites with lot of old NS4 clients? - -* Display problem in NS 4.79 solved. Was caused by HTML being mangled resulting in a lost close tag for TD. <br /> Reported by TWiki:Main/StefanLindmark - 21 Feb 2003 - -* The [[SmiliesPlugin]] detects an emoticon in the hidden Gnu head and replaces it with an image, breaking the HTML. - * FIXED, similar fix checked in. <br /> Reported by TWiki:Main/StefanLindmark - 21 Feb 2003 - -* The LINK directive is parsed wrong in the Perl module. - * FIXED. Reported by TWiki:Main/ChrisWinters - 25 Jan 2003 - -* Moved the "Topic parents:" to the bottom of the page again. The default skin keeps it there and it messes up the look of 1.1 anyhow. This one will probably make a lot of people a bit upset - tough. This is GPL'ed code so fork away if you care or provide a patch to make it site/user configurable. - -* "Cancel Edit" missing. - * FIXED. Reported by TWiki:Main/JohnRouillard - 17 Dec 2002 - -* The disturbing JavaScript stuff from the edit template is finally removed. <br /> Reported by TWiki:Main/JohnRouillard - 17 Dec 2002 - -* Batched diffs, revisions to show when using "View Diffs". - * IMPLEMENTED. Wished by various people: <br />Twiki:Main/GrantBow - 29 Dec 2002<br />TWiki:Main/JohnRouillard - 30 Dec 2002 - * To set a different amount in your home topic prefix the variable with GNUSKINPLUGIN\_ - * Set <code>**NUMREVISIONS = 2**</code> in the [[GnuSkinPlugin]] topic. - --- [[Main/JoachimNilsson]] - 02 Mar 2003 diff --git a/TWiki/GnuSkinTodo.mdwn b/TWiki/GnuSkinTodo.mdwn deleted file mode 100644 index 14dd2fba..00000000 --- a/TWiki/GnuSkinTodo.mdwn +++ /dev/null @@ -1,92 +0,0 @@ -<div> - <center> [ [[GnuSkin]] | [[GnuSkin]] | [[GnuSkinPlugin]] | <nop>GnuSkinTodo | [[GnuSkinReleaseNotes]] | <a href="http://savannah.gnu.org/projects/twiki-skins" target="_top">CVS</a> ] </nop></center> -</div> - -## <a name="Small_ToDo_list_for_the_GnuSkin"> </a> Small ToDo list for the [[GnuSkin]] - -**_Introduction:_** - -Please use the TWiki:Plugins/GnuSkinPluginDev topic for discussions regarding the GNUskin. - -The leading theme for all my work was given to me by my English teacher at university. He said; "Writers always do too much. The beauty lies in short concise sentences." To make it easier for us to understand he paced the lecture hall and repeatedly stated: - -_Simplify, simplify, simplify!_ - -There is a book written on this emphasizing my point even further. The book is brief and straight to the point. If you don't believe me, read [Elements of Style](http://www.amazon.com/exec/obidos/ASIN/0205191584/paradigmonlinewr/102-3410829-5714537) by William Strunk & E. B. White. - ----- - -**_Latest News:_** - -2003-03-02: [[GnuSkin]] 1.2 is released! Download from TWiki:Plugins/GnuSkinInstall - -CVS available from Savannah, <http://savannah.gnu.org/projects/twiki-skins> - -Development is progressing smoothly. If you would like to see the latest [[GnuSkin]] you can visit my personal web below. I do not make any promises on user experience or even if the site is up and running w/o bugs ... beware of bleeding edge! - -* <http://joachim.vmlinux.org/twiki/bin/view/> - -Use the sandbox for tests and fooling around. - -### <a name="Branch_1_x"> Branch 1.x </a> - -Oups, some bugs and suggestions for improvement just arrived. - -* In IE: Go back in preview after changing something in a topic. The changes are lost. -* The link to [[WebSearch]] was lost from the Go/Search field. - --- [[Main/JoachimNilsson]] - 19 Mar 2003 - -### <a name="Branch_2_x"> Branch 2.x </a> - -Before I start working on this I must upgrade my home TWiki installation... - -The new 2.x branch (becomes head after release of 1.2) intended for TWiki:Codev/BeijingRelease will contain mostly the same code as the 1.2 release. With a few small additions: - -**_Pending:_** - -* I18N fixes for the 2.0 release. The Beijing release prompts this, see TWiki:Plugins/InternationalisingYourSkin. Stefan has supplied a patch below! :-) - -* _Roll back to topic revision X_ - * Perhaps delay this after 2.0? - -* Other adaptations for the Beijing release of TWiki? - * Read up on TWiki.org - -* Enable checkpoint save from preferences setting. - -**_Fixed:_** - -* Another bug related to 01Feb2003 release. EDITBOXSTYLE is not supported by [[GnuSkin]]. Modify edit.gnu.tmpl and add style="%EDITBOXSTYLE%" to the textarea tag and it will work with automatic edit area just as the TWiki skin. Same HTML as in `edit.tmpl`. - * FIXED. <br />Reported by TWiki:Main.StefanLindmark - 24 Feb 2003 - -* Add option to turn preview mode off. - * Perhaps delay this after 2.0? - * Added to 1.2 using the savemulti scipt by Colas. The user can now select either to preview or directly save any changes made, or cancel them altogether. - -* Blue and Green skin style is available - add other complementary colors as well. This is useful to contrast with the web colors! - -### <a name="Future_releases"> Future releases </a> - -* Separate the side bar, the [[WebMenu]], from the [[GnuSkinPlugin]]. - * After 2.0! - -* Look at some neat DHTML scripts for the [[WebMenu]] and the More button. - * Disable per default - document howto include them. - * Consider enabling these through a preferences variable. - -* Parametrisize more. - * User configurable everything, as far as possible. - * The top logo could perhaps be removed altogether, and/or be more user customizable. - * Fix the CSS stuff - one should be able to use a style sheet that "matches" the chosen web color better. (matches/complements/whatever). - * Use customizable menu. Be able to use the standard TWiki menus? - -### <a name="Comments_and_User_Supplied_Patch"> Comments and User Supplied Patches </a> - -This brainstorm topic for the [[GnuSkin]] was mostly for myselft, but has proved probably useful to others as well. - --- [[Main/JoachimNilsson]] - 17 Feb 2003 - -I18N modifications required to use new I18N features in TWiki incorporated into templates. Please see attached diff file for diffs againt [[GnuSkin]] CVS 2003-02-18. - --- TWiki:Main.StefanLindmark - 21 Feb 2003 diff --git a/TWiki/GnuSkinTodo/gnuskin-comment-bug.diff b/TWiki/GnuSkinTodo/gnuskin-comment-bug.diff deleted file mode 100644 index a1afb5e2..00000000 --- a/TWiki/GnuSkinTodo/gnuskin-comment-bug.diff +++ /dev/null @@ -1,4 +0,0 @@ -34c34 -< %TMPL:P{"parents"}%<!-- %WEBTOPICLIST% --> </td> ---- -> %TMPL:P{"parents"}%<!--%WEBTOPICLIST%--></td> diff --git a/TWiki/GnuSkinTodo/gnuskin-i18n-diffs b/TWiki/GnuSkinTodo/gnuskin-i18n-diffs deleted file mode 100644 index c0b26cbb..00000000 --- a/TWiki/GnuSkinTodo/gnuskin-i18n-diffs +++ /dev/null @@ -1,66 +0,0 @@ -========= changeform.gnu.tmpl -5c5 -< <meta http-equiv="Content-Type" content="text/html; charset=%CHARSET%" /> ---- -> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -11c11 -< <form name="main" action="%SCRIPTURLPATH%/edit%SCRIPTSUFFIX%/%INTURLENCODE{"%WEB%/%TOPIC%"}%" method="post"> ---- -> <form name="main" action="%SCRIPTURLPATH%/edit%SCRIPTSUFFIX%/%WEB%/%TOPIC%" method="post"> -========= edit.gnu.tmpl -6c6 -< <meta http-equiv="Content-Type" content="text/html; charset=%CHARSET%" /> ---- -> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -12c12 -< <form name="main" action="%SCRIPTURLPATH%/save%SCRIPTSUFFIX%/%INTURLENCODE{"%WEB%/%TOPIC%"}%" method="post"> ---- -> <form name="main" action="%SCRIPTURLPATH%/save%SCRIPTSUFFIX%/%WEB%/%TOPIC%" method="post"> -========= preview.gnu.tmpl -6c6 -< <meta http-equiv="Content-Type" content="text/html; charset=%CHARSET%" /> ---- -> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -26c26 -< <form name="main" action="%SCRIPTURLPATH%/save%SCRIPTSUFFIX%/%INTURLENCODE{"%WEB%/%TOPIC%"}%" method="post"> ---- -> <form name="main" action="%SCRIPTURLPATH%/save%SCRIPTSUFFIX%/%WEB%/%TOPIC%" method="post"> -========= rdiff.gnu.tmpl -6c6 -< <meta http-equiv="Content-Type" content="text/html; charset=%CHARSET%" /> ---- -> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -========= search.gnu.tmpl -6c6 -< <meta http-equiv="Content-Type" content="text/html; charset=%CHARSET%" /> ---- -> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -========= searchbookview.gnu.tmpl -6c6 -< <meta http-equiv="Content-Type" content="text/html; charset=%CHARSET%" /> ---- -> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -========= searchformat.gnu.tmpl -6c6 -< <meta http-equiv="Content-Type" content="text/html; charset=%CHARSET%" /> ---- -> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -========= searchrenameview.gnu.tmpl -6c6 -< <meta http-equiv="Content-Type" content="text/html; charset=%CHARSET%" /> ---- -> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -========= twiki.gnu.tmpl -23c23 -< ); ;( ---- -> ): :( -226c226 -< <meta http-equiv="Content-Type" content="text/html; charset=%CHARSET%" /> ---- -> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -========= view.gnu.tmpl -6c6 -< <meta http-equiv="Content-Type" content="text/html; charset=%CHARSET%" />
---- -> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
diff --git a/TWiki/GnuSkinTodo/gnuskin-icon-problem.png b/TWiki/GnuSkinTodo/gnuskin-icon-problem.png Binary files differdeleted file mode 100644 index 971192a5..00000000 --- a/TWiki/GnuSkinTodo/gnuskin-icon-problem.png +++ /dev/null diff --git a/TWiki/GoodStyle.mdwn b/TWiki/GoodStyle.mdwn deleted file mode 100644 index b1584ec3..00000000 --- a/TWiki/GoodStyle.mdwn +++ /dev/null @@ -1,35 +0,0 @@ -# <a name="GoodStyle_Collaboration_Tips"> GoodStyle Collaboration Tips </a> - -* TWiki has a very simple **[[TWikiShorthand]]**. In any case, you won't go wrong if you simply: - * start each line without spaces - * separate paragraphs with a blank line - -* Run together capitalized words to form **[[WikiWords]]:** - * [[WikiWords]] automatically appear as hyperlinks - * make up meaningful, reasonably brief Wiki names - it can be a challenge (it'll sharpen you up!) - * [[WikiWords]] has name-creation tips that may help - -* If a **discussion** is going on: - * separate each follow-up with a space - * add your [[WikiName]] and the date at the end - * OR, by all means, insert your comment where it seems to fit best: - * you may want to insert it with a bullet and/or _set it in italics_ so it's clear (always sign and date) - * if a sub-topic develops, separate it with a horizontal rule at beginning and end - -* A good format for a **new topic** is "dissertation followed by discussion": - * start with a brief, factual introduction, followed by double horizontal rules - * let the discussion begin - -* When a discussion dies down and the page becomes static, if you're clear on your course, feel free to **refactor mercilessly**: - * fearlessly edit down to capture the key points - * reduce the noise without losing the facts or the flavor - * if you merge or delete comments, group credit `Contributors:` at the end of the page - * _This is how Wiki content matures and grows in value over time._ - -* For **external site links**, you can type URLs directly into the text - `http://etcete.ra/...` - it'll clear to anyone where they're headed on click. - -* TWiki is intended for world-wide use, and an international **standard date format** like 01 Sep 2001 is preferred. It's universally understood, and clearer than the xx/xx/xx format, where a date like 9/1/01 can mean either Jan or Sep, depending on the local conventions of the readers. For months, use the first three letters: Jan, Feb, Mar, Apr,... - -* **TIP:** Check the source when you want to find out how something is formatted: click <code>**Edit**</code> on the lower toolbar. To see earlier versions, click <code>**More**</code>, then check <code>**Raw text format**</code> and click <code>**View revision**</code>. A bit of HTML experience can't hurt, but you'll soon see with [[TWikiShorthand]] how far that is from necessary. - --- [[Main/MikeMannix]] - 01 Dec 2001 diff --git a/TWiki/HaroldGottschalk.mdwn b/TWiki/HaroldGottschalk.mdwn deleted file mode 100644 index 7f494d09..00000000 --- a/TWiki/HaroldGottschalk.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Harold Gottschalk is a [[TWikiContributor]]. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/Hey.mdwn b/TWiki/Hey.mdwn deleted file mode 100644 index 81952564..00000000 --- a/TWiki/Hey.mdwn +++ /dev/null @@ -1,9 +0,0 @@ -# <a name="HEY_"> </a> HEY! - -We asked you to **not click any question mark links!** - -Good thing we faked that one! - -You can use your browser's back button or key to get back to the tutorial. - -> **`:-)`** diff --git a/TWiki/HiddenAttachment.mdwn b/TWiki/HiddenAttachment.mdwn deleted file mode 100644 index d28af65e..00000000 --- a/TWiki/HiddenAttachment.mdwn +++ /dev/null @@ -1,9 +0,0 @@ -# <a name="Hide_Unhide_Attachments"> Hide/Unhide Attachments </a> - -You can hide/unhide file attachments. - -* In the [[FileAttachment]] table, click on an **action** link, -* enable the **Hide file** checkbox, -* then click **Change properties** - --- [[Main/PeterThoeny]] - 13 Nov 2001 diff --git a/TWiki/IncludeTopicsAndWebPages.mdwn b/TWiki/IncludeTopicsAndWebPages.mdwn deleted file mode 100644 index 1390fce6..00000000 --- a/TWiki/IncludeTopicsAndWebPages.mdwn +++ /dev/null @@ -1,54 +0,0 @@ -**Include Topics and Web Pages Using <code>**%INCLUDE\{...\}%**</code> Variable** - -Use the <code>**%INCLUDE\{...\}%**</code> variable to embed the content of another topic or web page inside a %WIKITOOLNAME% topic. The whole content or only parts of a page can be included. - -%TOC% - -## <a name="Syntax"> Syntax </a> - -<code>**%INCLUDE\{"page" pattern="reg-exp"\}%**</code> - -* <code>**"page"**</code>: <br /> The nameless parameter specifies the page to include. It is - * The name of a topic located in the current web, i.e. <code>**%INCLUDE\{"WebNotify"\}%**</code> - * A `Web.Topic` name specifying a topic in another web, i.e. <code>**%INCLUDE\{"%TWIKIWEB%.TWikiWebsTable"\}%**</code> - * A full qualified URL with <code>**http**</code> protocol, domain name and optional port number, i.e. <code>**%INCLUDE\{"http://twiki.org:80/index.html"\}%**</code>. Supported content types are <code>**text/html**</code> and <code>**text/plain**</code>. The full page is included by default, but the HTML header and scripts are stripped in case it is a web page. - -* <code>**pattern="reg-exp"**</code>: <br /> The **pattern** parameter is optional and allows you to extract some parts of a web page. Specify a %TWIKIWEB%.RegularExpression that scans from start (`'^'`) to end and contains the text you want to keep in parenthesis, i.e. <code>**pattern="^.\*?(from here.\*?to here).\*"**</code>. You need to make sure that the integrity of a web page is not compromised, i.e. if you include a table make sure to include everything including the table end tag. - -**_Note:_** All text of a topic is included unless you specify <code>**%STARTINCLUDE%**</code>, <code>**%STOPINCLUDE%**</code> and/or a **pattern** parameter. - -## <a name="Usage_Examples"> Usage Examples </a> - -### <a name="1_Display_regression_test_result"> 1. Display regression test results in a TWiki page </a> - -<pre> - &lt;pre&gt; - %<nop>INCLUDEURL{"http://domain/~qa/v1.1/REDTest.log.txt"}% - &lt;/pre&gt; -</nop></pre> - -### <a name="2_Display_Yahoo_s_robot_txt_file"> 2. Display Yahoo's robot.txt file </a> - -* You type: - * <code>**%INCLUDE\{"http://www.yahoo.com/robots.txt"\}%**</code><br /> -* You get: - - %INCLUDE{"http://www.yahoo.com/robots.txt"}% - -### <a name="3_Display_the_SUNW_stock_quote_i"> </a> 3. Display the SUNW stock quote in a TWiki page - -* You type: - * <code>**SUNW: %INCLUDE\{"http://finance.yahoo.com/q?s=SUNW&d=v1&o=t" pattern="^.\*?>SUNW</a>[^<]+(.\*?)\\s+\\S+\\s+<small.\*"\}%**</code><br /> -* You get: - * SUNW: %INCLUDE\{"http://finance.yahoo.com/q?s=SUNW&d=v1&o=t" pattern="^.\*?>SUNW[^<]+(.\*?)\\s+\\S+\\s+<small.\*"\}% - -### <a name="4_Display_the_temperature_in_San"> 4. Display the temperature in San Francisco </a> - -* You type: - * <code>**San Francisco: %INCLUDE\{"http://weather.yahoo.com/forecast/San\_Francisco\_CA\_US\_f.html" pattern="^.\*?([0-9]+\\&ordm\\;F).\*"\}%**</code><br /> -* You get: - * San Francisco: %INCLUDE\{"http://weather.yahoo.com/forecast/San\_Francisco\_CA\_US\_f.html" pattern="^.\*?([0-9]+\\&ordm\\;F).\*"\}% - -See also other [[TWikiVariables]]. - --- [[Main/PeterThoeny]] - 25 Jun 2001 <br /> diff --git a/TWiki/InterWikis.mdwn b/TWiki/InterWikis.mdwn deleted file mode 100644 index 7cf474db..00000000 --- a/TWiki/InterWikis.mdwn +++ /dev/null @@ -1,204 +0,0 @@ -## <a name="Inter_Wiki_Link_Rules_or_Links_t"> Inter-Wiki Link Rules (or Links to other Sites) </a> - -This topic lists all aliases needed to map Inter-Site links to external wikis/sites. - -Whenever you write <code>**ExternalSite:Page**</code> it will be linked automatically to the page on the external site. The link points to the URL corresponding to the <code>**ExternalSite**</code> alias below, concatenated to the <code>**Page**</code> you choose. Example: Type <code>**Wiki:RecentChanges**</code> to get [Wiki:RecentChanges](http://c2.com/cgi/wiki?RecentChanges), the RecentChanges page at the original Wiki site. - -### <a name="How_to_define_Inter_Site_links"> How to define Inter-Site links </a> - -* Inter-Site links are defined in the tables below. -* Each entry must be of format: <br /><code>**| External site alias | URL | Tooltip help text |**</code>. -* The URL and Tooltip Text may contain optional <code>**$page**</code> variables; the variable gets expanded to the page name. -* **_Note:_** The Tooltip Text must not contain any HTML tags (including <code>**<nop>**</code> escape code), no internal %TWIKIWEB%.WikiWord links, and no external links. Hint: Escape <code>**'WikiWords'**</code> and <code>**'$page'**</code>. - -### <a name="Inter_Wiki_Links"> Inter-Wiki Links </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Alias:</strong></th> - <th bgcolor="#99CCCC"><strong>URL:</strong></th> - <th bgcolor="#99CCCC"><strong>Tooltip Text:</strong></th> - </tr> - <tr> - <td> Wiki </td> - <td><a href="http://c2.com/cgi/wiki" target="_top">http://c2.com/cgi/wiki</a>? </td> - <td> '$page' on the original 'WikiWikiWeb' site </td> - </tr> - <tr> - <td> PPR </td> - <td><a href="http://c2.com/cgi/wiki" target="_top">http://c2.com/cgi/wiki</a>? </td> - <td> '$page' on the original 'PortlandPatternRepository' site </td> - </tr> - <tr> - <td> C2find </td> - <td><a href="http://c2.com/cgi/wiki?FindPage&value=" target="_top">http://c2.com/cgi/wiki?FindPage&amp;value=</a></td> - <td> Search '$page' on the original 'WikiWikiWeb' site </td> - </tr> - <tr> - <td> ZWiki </td> - <td><a href="http://joyful.com/zwiki/" target="_top">http://joyful.com/zwiki/</a></td> - <td> '$page' on Zope's Wiki </td> - </tr> - <tr> - <td>[[OrgPatterns]]</td> - <td><a href="http://www.bell-labs.com/cgi-user/OrgPatterns/OrgPatterns" target="_top">http://www.bell-labs.com/cgi-user/OrgPatterns/OrgPatterns</a></td> - <td> '$page' on Organizational Patterns site </td> - </tr> - <tr> - <td>[[FoxWiki]]</td> - <td><a href="http://fox.wikis.com/wc.dll?Wiki~" target="_top">http://fox.wikis.com/wc.dll?Wiki~</a></td> - <td> '$page' on Fox Wiki site </td> - </tr> - <tr> - <td>[[PhpWiki]]</td> - <td><a href="http://phpwiki.sourceforge.net/phpwiki/index.php3" target="_top">http://phpwiki.sourceforge.net/phpwiki/index.php3</a>? </td> - <td> '$page' on Wiki site written in PHP </td> - </tr> - <tr> - <td>[[MuWeb]]</td> - <td><a href="http://www.dunstable.com/scripts/MuWebWeb" target="_top">http://www.dunstable.com/scripts/MuWebWeb</a>? </td> - <td> '$page' on 'MuWeb' site </td> - </tr> - <tr> - <td>[[PyWiki]]</td> - <td><a href="http://www.voght.com/cgi-bin/pywiki" target="_top">http://www.voght.com/cgi-bin/pywiki</a>? </td> - <td> '$page' on Wiki site written in Python </td> - </tr> - <tr> - <td> Squeak </td> - <td><a href="http://minnow.cc.gatech.edu/squeak/" target="_top">http://minnow.cc.gatech.edu/squeak/</a></td> - <td> '$page' on Squeak Smalltalk Wiki </td> - </tr> - <tr> - <td>[[UseMod]]</td> - <td><a href="http://www.usemod.com/cgi-bin/wiki.pl" target="_top">http://www.usemod.com/cgi-bin/wiki.pl</a>? </td> - <td> '$page' on 'UseMod' Wiki site </td> - </tr> - <tr> - <td>[[MeatBall]]</td> - <td><a href="http://www.usemod.com/cgi-bin/mb.pl" target="_top">http://www.usemod.com/cgi-bin/mb.pl</a>? </td> - <td> '$page' on 'MeatBall' site, a 'UseMod' Wiki variant </td> - </tr> - <tr> - <td>[[MbTest]]</td> - <td><a href="http://www.usemod.com/cgi-bin/mbtest.pl" target="_top">http://www.usemod.com/cgi-bin/mbtest.pl</a>? </td> - <td> '$page' on 'UseMod' Wiki variant </td> - </tr> - <tr> - <td>[[HammondWiki]]</td> - <td><a href="http://www.dairiki.org/HammondWiki/index.php3" target="_top">http://www.dairiki.org/HammondWiki/index.php3</a>? </td> - <td> '$page' on 'HammondWiki' site </td> - </tr> - <tr> - <td> Advogato </td> - <td><a href="http://www.advogato.org/" target="_top">http://www.advogato.org/</a></td> - <td> '$page' on Advogato community site (with peer review) </td> - </tr> - <tr> - <td>[[MoinMoin]]</td> - <td><a href="http://moin.sourceforge.net/cgi-bin/moin/moin/" target="_top">http://moin.sourceforge.net/cgi-bin/moin/moin/</a></td> - <td> '$page' on 'MoinMoin' Wiki site </td> - </tr> - <tr> - <td>[[EfnetPythonWiki]]</td> - <td><a href="http://www.encrypted.net/~jh/python-wiki/moin.cgi/" target="_top">http://www.encrypted.net/~jh/python-wiki/moin.cgi/</a></td> - <td> '$page' on 'EfnetPythonWiki' site </td> - </tr> - <tr> - <td>[[EfnetCppWiki]]</td> - <td><a href="http://www.encrypted.net/~jh/cpp-wiki/moin.cgi/" target="_top">http://www.encrypted.net/~jh/cpp-wiki/moin.cgi/</a></td> - <td> '$page' on Efnet Cpp Wiki site </td> - </tr> - <tr> - <td>[[EfnetXmlWiki]]</td> - <td><a href="http://www.encrypted.net/~jh/xml-wiki/moin.cgi/" target="_top">http://www.encrypted.net/~jh/xml-wiki/moin.cgi/</a></td> - <td> '$page' on Efnet XML Wiki site </td> - </tr> - <tr> - <td>[[PolitizenWiki]]</td> - <td><a href="http://www.politizen.com/wiki.asp" target="_top">http://www.politizen.com/wiki.asp</a>? </td> - <td> '$page' on 'PolitizenWiki' site </td> - </tr> - <tr> - <td>[[DolphinWiki]]</td> - <td><a href="http://www.object-arts.com/wiki/html/Dolphin/" target="_top">http://www.object-arts.com/wiki/html/Dolphin/</a></td> - <td> '$page' on Dolphin Wiki site </td> - </tr> - <tr> - <td>[[LegoWiki]]</td> - <td><a href="http://www.object-arts.com/wiki/html/Lego-Robotics/" target="_top">http://www.object-arts.com/wiki/html/Lego-Robotics/</a></td> - <td> '$page' on 'LegoWiki' site </td> - </tr> - <tr> - <td> TWiki </td> - <td><a href="http://twiki.org/cgi-bin/view/" target="_top">http://twiki.org/cgi-bin/view/</a></td> - <td> '$page' on TWiki site, we know it! </td> - </tr> - <tr> - <td>[[VisualWorks]]</td> - <td><a href="http://wiki.cs.uiuc.edu/VisualWorks/" target="_top">http://wiki.cs.uiuc.edu/VisualWorks/</a></td> - <td> '$page' on 'VisualWorks' site </td> - </tr> - <tr> - <td>[[HurdWiki]]</td> - <td><a href="http://hurd.gnufans.org/bin/view/" target="_top">http://hurd.gnufans.org/bin/view/</a></td> - <td> '$page' on 'HurdWiki' site </td> - </tr> -</table> - -### <a name="Miscellaneous_Inter_Site_Links"> Miscellaneous Inter-Site Links </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Alias:</strong></th> - <th bgcolor="#99CCCC"><strong>URL:</strong></th> - <th bgcolor="#99CCCC"><strong>Tooltip Text:</strong></th> - </tr> - <tr> - <td> Acronym </td> - <td><a href="http://www.acronymfinder.com/af-query.asp?Acronym=$page&String=exact" target="_top">http://www.acronymfinder.com/af-query.asp?Acronym=$page&amp;String=exact</a></td> - <td> Look up $page on Acronym Finder site </td> - </tr> - <tr> - <td>[[DebianBug]]</td> - <td><a href="http://bugs.debian.org/" target="_top">http://bugs.debian.org/</a></td> - <td> Debian Bug '$page' by number or package name </td> - </tr> - <tr> - <td> BTS </td> - <td><a href="http://bugs.debian.org/" target="_top">http://bugs.debian.org/</a></td> - <td> Debian Bug '$page' by number or package name </td> - </tr> - <tr> - <td>[[DebianList]]</td> - <td><a href="http://lists.debian.org/" target="_top">http://lists.debian.org/</a></td> - <td> Debian List '$page' </td> - </tr> - <tr> - <td>[[DebianPackage]]</td> - <td><a href="http://packages.debian.org/" target="_top">http://packages.debian.org/</a></td> - <td> Debian Package '$page' </td> - </tr> - <tr> - <td> PTS </td> - <td><a href="http://packages.qa.debian.org/" target="_top">http://packages.qa.debian.org/</a></td> - <td> Debian Package '$page' </td> - </tr> - <tr> - <td>[[DejaNews]]</td> - <td><a href="http://www.deja.com/=dnc/getdoc.xp?AN=" target="_top">http://www.deja.com/=dnc/getdoc.xp?AN=</a></td> - <td> '$page' on Net News </td> - </tr> - <tr> - <td> ISBN </td> - <td><a href="http://service.bfast.com/bfast/click?bfmid=2181&sourceid=38704253&bfpid=" target="_top">http://service.bfast.com/bfast/click?bfmid=2181&amp;sourceid=38704253&amp;bfpid=</a></td> - <td> Book with ISBN#$page (One click patent? Say no to Amazon!) </td> - </tr> - <tr> - <td> RFC </td> - <td><a href="http://www.faqs.org/rfcs/rfc$page.html" target="_top">http://www.faqs.org/rfcs/rfc$page.html</a></td> - <td> IETF RFC #$page </td> - </tr> -</table> - -**_Note:_** This topic is powered by the [[InterwikiPlugin]]. diff --git a/TWiki/InterwikiPlugin.mdwn b/TWiki/InterwikiPlugin.mdwn deleted file mode 100644 index 35d967eb..00000000 --- a/TWiki/InterwikiPlugin.mdwn +++ /dev/null @@ -1,95 +0,0 @@ -# <a name="_TOPIC_"> %TOPIC% </a> - -The %TOPIC% links <code>**ExternalSite:Page**</code> text to external sites based on aliases defined in the %TWIKIWEB%.InterWikis topic. This plugin is inspired by UseMod Wiki's inter-wiki links, <http://www.usemod.com/cgi-bin/wiki.pl?InterWiki>. - -%TOC% - -## <a name="Syntax_Rules"> Syntax Rules </a> - -* Enter <code>**ExternalSite:Page**</code> to create a link that points to the <code>**Page**</code> on the <code>**ExternalSite**</code> server. -* All <code>**ExternalSite**</code> aliases are defined in the %TWIKIWEB%.InterWikis topic. -* Add and edit aliases in %TWIKIWEB%.InterWikis. -* %H% For TWiki sites, both the **web** and the **topic** have to be specified: <code>**TWikisite:Webname/SomePage**</code> - * TWiki:Plugins/InterwikiPlugin - -## <a name="_TOPIC_Settings"> %TOPIC% Settings </a> - -Plugin settings are stored as Preferences variables. To reference a plugin setting write <code>**%<plugin>\_<setting>%**</code>, i.e. <code>**%INTERWIKIPLUGIN\_SHORTDESCRIPTION%**</code> - -* One-line description is shown in the %TWIKIWEB%.TextFormattingRules topic: - * Set SHORTDESCRIPTION = Link <code>**ExternalSite:Page**</code> text to external sites based on aliases defined in the [[InterWikis]] topic. - -* Link rules topic name: (default is %TWIKIWEB%.InterWikis) - * Set RULESTOPIC = - -* Suppress tooltip help for links: (<code>****</code> or <code>**1**</code>, default is <code>****</code>) - * Set SUPPRESSTOOLTIP = 0 - -* Debug plugin: (See output in `data/debug.txt`) - * Set DEBUG = 0 - -## <a name="Plugin_Installation_Instructions"> Plugin Installation Instructions </a> - -%X% **NOTE:** This Plugin is included in the TWiki distribution package. You do not need to install it unless you want to upgrade to a newer version. - -* **Download** the ZIP file from the TWiki:Plugins web (see below) -* **Unzip** <code>**%TOPIC%.zip**</code> in your TWiki installation directory. Content: <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>File:</strong></th> - <th bgcolor="#99CCCC"><strong>Description:</strong></th> - </tr> - <tr> - <td><code><b>data/TWiki/%TOPIC%.txt</b></code></td> - <td> Plugin topic </td> - </tr> - <tr> - <td><code><b>data/TWiki/InterWikis.txt</b></code></td> - <td> Link rules topic for inter-site links </td> - </tr> - <tr> - <td><code><b>lib/TWiki/Plugins/%TOPIC%.pm</b></code></td> - <td> Plugin Perl module </td> - </tr> -</table> -* **Test:** If the Plugin is correctly installed, this Wiki:InterWiki link should point to <http://c2.com/cgi/wiki?InterWiki> topic - try it out. - -## <a name="Plugin_Info"> Plugin Info </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <td align="right"> Plugin Author: </td> - <td> %TWIKIWEB%.AndreaSterbini, %TWIKIWEB%.PeterThoeny </td> - </tr> - <tr> - <td align="right"> Plugin Version: </td> - <td> 1.0.2 </td> - </tr> - <tr> - <td align="right"> Change History: </td> - <td> 27 Jul 2001 Allow numbers in site name <br /> 26 Jul 2001 Fixed alternating missed link bug due to greedy $postfixPattern (fix by Richard Donkin) <br /> 14 Jul 2001 Changed to plug &amp; play <br /> 16 Jun 2001: Made tooltips optional; prevent <code><b>Module::Sub</b></code> type of link <br /> 12 Jun 2001: Added optional tool tips (IE only); added the link rules topic name variable; added flexible link patterns; optional <code><b>$page</b></code> in URL <br /> 10 Jun 2001: Changed rules topic to table-based syntax <br /> 20 Feb 2001: Initial version </td> - </tr> - <tr> - <td align="right"> CPAN Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Other Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Perl Version: </td> - <td> 5.0 </td> - </tr> - <tr> - <td align="right"> Plugin Home: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a> (TWiki:Plugins/%TOPIC%) </td> - </tr> - <tr> - <td align="right"> Feedback: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a> (TWiki:Plugins/%TOPIC%Dev) </td> - </tr> -</table> - -**_Related Topics:_** %TWIKIWEB%.InterWikis, %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins - --- %TWIKIWEB%.AndreaSterbini - 20 Oct 2000 <br /> -- %TWIKIWEB%.PeterThoeny - 27 Jul 2001 <br /> -- %TWIKIWEB%.MikeMannix - 01 Oct 2001 <br /> diff --git a/TWiki/JohnAltstadt.mdwn b/TWiki/JohnAltstadt.mdwn deleted file mode 100644 index e0e5397f..00000000 --- a/TWiki/JohnAltstadt.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -John Altstadt is a [[TWikiContributor]]. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/JohnTalintyre.mdwn b/TWiki/JohnTalintyre.mdwn deleted file mode 100644 index 409c6e2b..00000000 --- a/TWiki/JohnTalintyre.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -John Talintyre is a [[TWikiContributor]]. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/KevinKinnell.mdwn b/TWiki/KevinKinnell.mdwn deleted file mode 100644 index 25b8e708..00000000 --- a/TWiki/KevinKinnell.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Kevin Kinnell is a [[TWikiContributor]] and a core team member. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/KlausWriessnegger.mdwn b/TWiki/KlausWriessnegger.mdwn deleted file mode 100644 index 95575056..00000000 --- a/TWiki/KlausWriessnegger.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -[[KlausWriessnegger]] is a [[TWikiContributor]]. - -See <http://TWiki.org/cgi-bin/view/%MAINWEB%/%TOPIC%> diff --git a/TWiki/ManagingTopics.mdwn b/TWiki/ManagingTopics.mdwn deleted file mode 100644 index dddab2ac..00000000 --- a/TWiki/ManagingTopics.mdwn +++ /dev/null @@ -1,68 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="Managing_Topics"> Managing Topics </a> - -_Browser-based rename, move, and delete for individual topics_ - -## <a name="Overview"> Overview </a> - -Use browser controls while viewing a topic, to change its name, move it to another TWiki web, or delete it to a hidden `Trash` web. - -## <a name="How_to_Rename_Move_Delete_a_Topi"> How to Rename/Move/Delete a Topic </a> - -1. **Click** on <code>**[More]**</code> (bottom right of page) on the topic to be changed, then, in the new screen, on <code>**[Rename/move]**</code>. -2. **Select** target web if other than the current web - chose `Trash` to delete a topic -3. **Enter** the new topic name - default is current name <br />**_NOTE:_** You will be warned if there are locks or if there is a name conflict. -4. **Select** from the list of referring links any topics NOT to be updated with the new name (by default, all referring links will be updated). -5. **Click** on <code>**[Rename/Move]**</code>: the topic will be renamed and links to the topic updated as requested. - * If any of the referring pages are locked then they will be listed. - * You can correct these later by again pressing <code>**[Rename/Move]**</code>. - -### <a name="Referring_Topics"> Referring Topics </a> - -Referring topics are found using the the %SEARCH% variable, see the template `searchrenameview.tmpl`. First, matching topics in the current Web are listed - matches are to _topic_. Next, all Webs (including the current one) are listed that match _web.topic_. Because %SEARCH% is used, Webs marked in [[WebPreferences]] as NOSEARCHALL will not show up in the search for refernces to the _topic_ being changed. - -Changed references are kept are as short as possible, ex: _topic_ is used in preference to _web.topic_. - -<a name="DeleteTopic"></a> - -### <a name="About_Deleting_a_Topic"> About Deleting a Topic </a> - -Deleted topics are moved to the `Trash` web - NOT physically erased from the server. All webs share `Trash` - in case of a name conflict with a topic already `Trash`, the user is alerted and asked to choose a new name. - -## <a name="Clearing_the_Trash"> Clearing the Trash </a> - -The `Trash` web should be be cleared periodically, by archiving the contents if required (recommended), then deleting the files from the `Trash` directory. - -## <a name="Redirecting_from_an_Old_Topic"> Redirecting from an Old Topic </a> - -You can use [[TWikiMetaData]] to place a command in %TWIKIWEB%.WebTopicViewTemplate and %TWIKIWEB%.WebTopicNonWikiTemplate that will show if a topic has moved by searching for the tag %META:TOPICMOVED\{...\}%. Customize something like this: - -> %<nop>METASEARCH{type="topicmoved" web="%WEB%" topic="%TOPIC%" -> title="This topic used to exist and was moved to: "}% - -## <a name="Effect_of_Access_Settings"> Effect of Access Settings </a> - -Permissions affect the rename function in various ways. To rename a topic, you need both change and rename permissions. To alter refer4ing topics, you need change permission. See [[TWikiAccessControl]] for information on setting up access permissions. - -## <a name="How_Rename_move_Works"> How Rename/move Works </a> - -1. %SEARCH%, with a special template, finds and displays all occurrences of the topic name in other topics, site-wide. These referring links are by default automatically changed to the new topic and/or web name. This includes relevant [[TWikiMetaData]] definitions. - * User can omit one or more topics from the update list. - * `<pre>` and `<verbatim>` are honoured - no changes are made to text within these areas. -2. The topic is moved (if locks allow). -3. References are changed (locks and permissions permitting). -4. Any referring topics that can't be changed due to locks are listed - user can change them at another time. - -## <a name="Known_Limitations"> Known Limitations </a> - -**Rename/move** in is fairly complicated due to the dynamic generation of links. Ideally, it would be possible to run the required part of rendering in a way that would allow identification of the text to be changed. Unfortunately, these hooks don't exist in TWiki at present. Instead, %SEARCH% is used with a special template to show the text to be changed, and the selected topics are then altered. One drawback is that `search` can show matches that will not be updated because of case differences. Other mismatches to actual rendered output are also possible as the approaches are so different. - -The following shows some limitations of square bracket processing. - -> [[Old Topic]] => [[NewTopic][Old Topic]] -> [[old topic]] => [[NewTopic][old topic]] -> [[old t opic]] => not changed -> [[OldTopic]] => [[NewTopic]] - --- [[MikeMannix]] - 15 Sep 2001 <br /> diff --git a/TWiki/ManagingWebs.mdwn b/TWiki/ManagingWebs.mdwn deleted file mode 100644 index e59542bd..00000000 --- a/TWiki/ManagingWebs.mdwn +++ /dev/null @@ -1,34 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="Managing_Webs"> Managing Webs </a> - -_Adding, renaming and deleting webs are manual operations done directly on the server_ - -## <a name="Overview"> Overview </a> - -Managing TWiki webs requires direct access to the installation files on the host server. There are currently no browser-based equivalents of the Rename/move/delete topic tools for working with webs. - -## <a name="Adding_a_New_Web"> Adding a New Web </a> - -Adding new webs is quick and easy - you can have a basic web up and running in a couple of minutes: - -1. **Create** a new directory under `twiki/data/`, ex: `twiki/data/Newweb`<br /> - * the name has to start with a capital and _cannot_ be a [[WikiWord]] -2. **Copy** in the contents of `twiki/data/_default`. - -For detailed instructions, see [[TWikiInstallationGuide]]. - -## <a name="Renaming_or_Deleting_a_Web"> Renaming or Deleting a Web </a> - -**NOTE:** If you plan to rename the %WIKITOOLNAME%.%MAINWEB% web, remember that TWiki stores user and group topics in <code>%MAINWEB%</code>, default named `Main`. That means, every [[WikiName]] signature - <code>Main.SomeUserName</code> - points to it and would need updating (unless the variable, <code>%MAINWEB%.SomeUserName</code>, is used throughout). - -1. Prepare your site: Search each web for links to the target web, searching topic text for `Oldwebname.`, including the dot so you'll find references like `Oldwebname.SomeTopic`. - * Make changes as required, to `Newwebname.SomeTopic` or better yet, to <code>%MAINWEB%.SomeTopic</code>. -2. Edit the %WIKIPREFSTOPIC% topic: Rename or delete the web from the `WIKIWEBLIST` variable. -3. Edit the [[TWikiWebsTable]] topic: Rename or delete the web from the table. -4. Login to the %WIKITOOLNAME% server, via Telnet or FTP. -5. Go to `twiki/data` and rename or remove the web directory. -6. Go to `twiki/templates` and rename or remove the web directory if present. -7. Go to `twiki/pub` and rename or remove the web directory if present. - --- [[MikeMannix]] - 14 Sep 2001 <br /> diff --git a/TWiki/ManpreetSingh.mdwn b/TWiki/ManpreetSingh.mdwn deleted file mode 100644 index b557b688..00000000 --- a/TWiki/ManpreetSingh.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Manpreet Singh is a [[TWikiContributor]]. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/MetaDataDefinition.mdwn b/TWiki/MetaDataDefinition.mdwn deleted file mode 100644 index 59c09d4e..00000000 --- a/TWiki/MetaDataDefinition.mdwn +++ /dev/null @@ -1 +0,0 @@ -#### <a name="Merged_into_TWikiMetaData_this_t"> </a> Merged into [[TWikiMetaData]] - this topic to be rolled back. diff --git a/TWiki/MetaDataRendering.mdwn b/TWiki/MetaDataRendering.mdwn deleted file mode 100644 index 08838cfc..00000000 --- a/TWiki/MetaDataRendering.mdwn +++ /dev/null @@ -1,65 +0,0 @@ -%STARTINCLUDE% - -## <a name="Meta_Data_Rendering"> Meta Data Rendering </a> - -Various meta data can be stored in topics - [[MetaDataDefinition]] - -This is rendered using the %META% variable. This is mostly used in the `view`, `preview` and `edit` scripts. - -At present support is fairly basic: - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Variable usage:</strong></th> - <th bgcolor="#99CCCC"><strong>Comment:</strong></th> - </tr> - <tr> - <td> %<nop>META{"form"}% </nop></td> - <td> Show form data, see [[TWikiDocumentation]]</td> - </tr> - <tr> - <td> %<nop>META{"attachments"}% </nop></td> - <td> Show attachments, excluding hidden ones </td> - </tr> - <tr> - <td> options for attachments: </td> - </tr> - <tr> - <td> all="on" </td> - <td> Show all attachments i.e. including hidden ones </td> - </tr> - <tr> - <td> %<nop>META{"moved"}% </nop></td> - <td> Details of any topic moves </td> - </tr> - <tr> - <td> %<nop>META{"parent [options]"}% </nop></td> - <td> Show topic parent </td> - </tr> - <tr> - <td> options for parent: </td> - </tr> - <tr> - <td> dontrecurse="on" </td> - <td> By default recurses up tree, this has some cost </td> - </tr> - <tr> - <td> prefix="..." </td> - <td> Prefix that goes before parents, but only if there are parents, default "" </td> - </tr> - <tr> - <td> suffix="..." </td> - <td> Suffix, only appears if there are parents, default "" </td> - </tr> - <tr> - <td> seperator="..." </td> - <td> Seperator between parents, default is " &gt; " </td> - </tr> -</table> - -Possible future additions: - -* Rendering of form data to alternate formats e.g. bullet lists -* Specify a template to be used for rendering - -%STOPINCLUDE% -- [[JohnTalintyre]] - 29 Aug 2001 <br /> diff --git a/TWiki/MikeMannix.mdwn b/TWiki/MikeMannix.mdwn deleted file mode 100644 index ae1f2ad2..00000000 --- a/TWiki/MikeMannix.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Mike Mannix is a [[TWikiContributor]]. - -See TWiki:Main/MikeMannix diff --git a/TWiki/MoveTopic.mdwn b/TWiki/MoveTopic.mdwn deleted file mode 100644 index 4580acb1..00000000 --- a/TWiki/MoveTopic.mdwn +++ /dev/null @@ -1 +0,0 @@ -[[ManagingTopics]] can be used to move a topic from one Web to another. One specialised use of this is [[DeleteWeb]]. diff --git a/TWiki/NicholasLee.mdwn b/TWiki/NicholasLee.mdwn deleted file mode 100644 index 4971386f..00000000 --- a/TWiki/NicholasLee.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Nicholas Lee is a [[TWikiContributor]] and a core team member. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/PeterFokkinga.mdwn b/TWiki/PeterFokkinga.mdwn deleted file mode 100644 index 9479b532..00000000 --- a/TWiki/PeterFokkinga.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Peter Fokkinga is a [[TWikiContributor]]. - -See <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/PeterThoeny.mdwn b/TWiki/PeterThoeny.mdwn deleted file mode 100644 index 1dfd24be..00000000 --- a/TWiki/PeterThoeny.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Peter Thoeny is the author of TWiki and therefore a [[TWikiContributor]] and a core team member. - -See [[Main/PeterThoeny]] and <http://TWiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/PreviewBackground.mdwn b/TWiki/PreviewBackground.mdwn deleted file mode 100644 index 092b20a1..00000000 --- a/TWiki/PreviewBackground.mdwn +++ /dev/null @@ -1,70 +0,0 @@ -**Background Image for Preview** - -Preview looks like the real page, but the links leed to an oops dialog warning users of not yet saved topics. In addition, a background with a "PREVIEW" watermark is shown to have visual clue that you are previewing a topic. You can change the background image by specifying the name of an attached background image file in the PREVIEWBGIMAGE variable in the %WIKIPREFSTOPIC%. - -Remarks: - -* You also could attach a new image file to this topic. -* You can override the PREVIEWBGIMAGE preference variable in your personal home page. - --- [[Main/PeterThoeny]] - 02 Oct 2000 <br /> - -<table border="0" cellpadding="0" cellspacing="4"> - <tr bgcolor="#99CCCC"> - <th> %TWIKIWEB%.FileAttachment: </th> - <th> Action: </th> - <th> Size: </th> - <th> Date: </th> - <th> Who: </th> - <th> Comment: </th> - </tr> - <tr> - <td><twknextitem> </twknextitem></td> - </tr> - <tr> - <td valign="top"><twkfileicon><img align="top" hight="16" src="%PUBURLPATH%/icn/bmp.gif" width="16" /></twkfileicon> <a href="%PUBURLPATH%/%WEB%/%TOPIC%/blankltgraybg.gif"><twkfilename>blankltgraybg.gif</twkfilename></a> <twkfilepath> <twkdata value="D:\Data\Temp\blankltgraybg.gif"> </twkdata></twkfilepath></td> - <td valign="top"><twkaction><a href="%SCRIPTURLPATH%/viewfile%SCRIPTSUFFIX%/%WEB%/%TOPIC%?filename=blankltgraybg.gif">view</a> <a href="%SCRIPTURLPATH%/attach%SCRIPTSUFFIX%/%WEB%/%TOPIC%?filename=blankltgraybg.gif">update</a></twkaction></td> - <td align="right" valign="top"><twkfilesize>878</twkfilesize></td> - <td valign="top"><twkfiledate>03 Oct 2000 - 00:48</twkfiledate></td> - <td valign="top"><twkfileuser> [[Main/PeterThoeny]]</twkfileuser></td> - <td valign="top"><twkfilecomment>Blank white background</twkfilecomment></td> - </tr> - <tr> - <td><twknextitem> </twknextitem></td> - </tr> - <tr> - <td valign="top"><twkfileicon><img align="top" hight="16" src="%PUBURLPATH%/icn/bmp.gif" width="16" /></twkfileicon> <a href="%PUBURLPATH%/%WEB%/%TOPIC%/blankwhitebg.gif"><twkfilename>blankwhitebg.gif</twkfilename></a> <twkfilepath> <twkdata value="D:\Data\Temp\blankwhitebg.gif"> </twkdata></twkfilepath></td> - <td valign="top"><twkaction><a href="%SCRIPTURLPATH%/viewfile%SCRIPTSUFFIX%/%WEB%/%TOPIC%?filename=blankwhitebg.gif">view</a> <a href="%SCRIPTURLPATH%/attach%SCRIPTSUFFIX%/%WEB%/%TOPIC%?filename=blankwhitebg.gif">update</a></twkaction></td> - <td align="right" valign="top"><twkfilesize>878</twkfilesize></td> - <td valign="top"><twkfiledate>03 Oct 2000 - 00:48</twkfiledate></td> - <td valign="top"><twkfileuser> [[Main/PeterThoeny]]</twkfileuser></td> - <td valign="top"><twkfilecomment>Blank white background</twkfilecomment></td> - </tr> - <tr> - <td><twknextitem> </twknextitem></td> - </tr> - <tr> - <td valign="top"><twkfileicon><img align="top" hight="16" src="%PUBURLPATH%/icn/bmp.gif" width="16" /></twkfileicon> <a href="%PUBURLPATH%/%WEB%/%TOPIC%/previewbg.gif"><twkfilename>previewbg.gif</twkfilename></a> <twkfilepath> <twkdata value="D:\Data\Temp\previewbg.gif"> </twkdata></twkfilepath></td> - <td valign="top"><twkaction><a href="%SCRIPTURLPATH%/viewfile%SCRIPTSUFFIX%/%WEB%/%TOPIC%?filename=previewbg.gif">view</a> <a href="%SCRIPTURLPATH%/attach%SCRIPTSUFFIX%/%WEB%/%TOPIC%?filename=previewbg.gif">update</a></twkaction></td> - <td align="right" valign="top"><twkfilesize>1821</twkfilesize></td> - <td valign="top"><twkfiledate>03 Oct 2000 - 00:46</twkfiledate></td> - <td valign="top"><twkfileuser> [[Main/PeterThoeny]]</twkfileuser></td> - <td valign="top"><twkfilecomment>Slanted PREVIEW watermark</twkfilecomment></td> - </tr> - <tr> - <td><twknextitem> </twknextitem></td> - </tr> - <tr> - <td valign="top"> - </td> - <td valign="top"><twkaction><a href="%SCRIPTURLPATH%/attach%SCRIPTSUFFIX%/%WEB%/%TOPIC%">add</a><twkaction> </twkaction></twkaction></td> - <td align="right" valign="top"> - </td> - <td valign="top"> - </td> - <td valign="top"> - </td> - <td valign="top"> - </td> - </tr> -</table> diff --git a/TWiki/PreviewButton.mdwn b/TWiki/PreviewButton.mdwn deleted file mode 100644 index 9e129862..00000000 --- a/TWiki/PreviewButton.mdwn +++ /dev/null @@ -1,23 +0,0 @@ -## <a name="Where_is_the_Preview_button_"> Where is the Preview button? </a> - -It used to be on this Wiki and is found on many other Wikis. - -_In fact this wiki used to have **only** preview button IIRC. You had to preview and save from preview page which could be annoing for frequent users._ - -## <a name="Answer_"> Answer: </a> - -The preview process has been redone in the [[GnuSkin]] due to popular request from other site users. This [[GnuSkin]] installation is just like any other and so the change also affects it. - -In the future it might be possible to have different levels of configuration of the [[GnuSkin]], even on user level. However, that is so far into the future it might not be the present author who takes it on. I might alter things in the next major release of the [[GnuSkin]] - plans are to integrate the preview and save page so that one could preview **OR** save directly. - -In the case there are users who don't like this and want the preview back the only possible solution is to change to another skin. Vmlinux.org has the [[SessionPlugin]] installed and thus the user can simply click on the "Skin" link in the top right corner. Available right now is the default TWiki skin and the Tiger skin (also in its blue theme). - -**_Back to:_** [[TWikiFAQ]] - -Ok, it should not be in this FAQ if it has no answer, but I wonder how it is removed. - --- [[Main/MichalSuchanek]] - 18 Sep 2002 <br /> - -Added the answer. - --- [[Main/JoachimNilsson]] - 18 Sep 2002 diff --git a/TWiki/RandyKramer.mdwn b/TWiki/RandyKramer.mdwn deleted file mode 100644 index cd5e3fd4..00000000 --- a/TWiki/RandyKramer.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Rand Kramer is a [[TWikiContributor]]. - -See <http://twiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/RegularExpression.mdwn b/TWiki/RegularExpression.mdwn deleted file mode 100644 index f450744c..00000000 --- a/TWiki/RegularExpression.mdwn +++ /dev/null @@ -1,143 +0,0 @@ -Regular expressions (REs), unlike simple queries, allow you to search for text which matches a particular pattern. - -REs are similar to (but more poweful than) the "wildcards" used in the command-line interfaces found in operating systems such as Unix and MS-DOS. REs are used by sophisticated search engines, as well as by many Unix-based languages and tools ( e.g., `awk`, `grep`, `lex`, `perl`, and `sed` ). - -**Examples** - -<table> - <tr> - <td> compan(y|ies) </td> - <td> Search for <em>company</em> , <em>companies</em></td> - </tr> - <tr> - <td> (peter|paul) </td> - <td> Search for <em>peter</em> , <em>paul</em></td> - </tr> - <tr> - <td> bug* </td> - <td> Search for <em>bug</em> , <em>bugs</em> , <em>bugfix</em></td> - </tr> - <tr> - <td> [Bb]ag </td> - <td> Search for <em>Bag</em> , <em>bag</em></td> - </tr> - <tr> - <td> b[aiueo]g </td> - <td> Second letter is a vowel. Matches <em>bag</em> , <em>bug</em> , <em>big</em></td> - </tr> - <tr> - <td> b.g </td> - <td> Second letter is any letter. Matches also <em>b&amp;g</em></td> - </tr> - <tr> - <td> [a-zA-Z] </td> - <td> Matches any one letter (not a number and a symbol) </td> - </tr> - <tr> - <td> [^0-9a-zA-Z] </td> - <td> Matches any symbol (not a number or a letter) </td> - </tr> - <tr> - <td> [A-Z][A-Z]* </td> - <td> Matches one or more uppercase letters </td> - </tr> - <tr> - <td> [0-9][0-9][0-9]-[0-9][0-9]- <br /> [0-9][0-9][0-9][0-9] </td> - <td valign="top"> US social security number, e.g. 123-45-6789 </td> - </tr> -</table> - -Here is stuff for our UNIX freaks: <br /> (copied from 'man grep') - - \c A backslash (\) followed by any special character is a - one-character regular expression that matches the spe- - cial character itself. The special characters are: - - + `.', `*', `[', and `\' (period, asterisk, - left square bracket, and backslash, respec- - tively), which are always special, except - when they appear within square brackets ([]). - - + `^' (caret or circumflex), which is special - at the beginning of an entire regular expres- - sion, or when it immediately follows the left - of a pair of square brackets ([]). - - + $ (currency symbol), which is special at the - end of an entire regular expression. - - . A `.' (period) is a one-character regular expression - that matches any character except NEWLINE. - - [string] - A non-empty string of characters enclosed in square - brackets is a one-character regular expression that - matches any one character in that string. If, however, - the first character of the string is a `^' (a circum- - flex or caret), the one-character regular expression - matches any character except NEWLINE and the remaining - characters in the string. The `^' has this special - meaning only if it occurs first in the string. The `-' - (minus) may be used to indicate a range of consecutive - ASCII characters; for example, [0-9] is equivalent to - [0123456789]. The `-' loses this special meaning if it - occurs first (after an initial `^', if any) or last in - the string. The `]' (right square bracket) does not - terminate such a string when it is the first character - within it (after an initial `^', if any); that is, - []a-f] matches either `]' (a right square bracket ) or - one of the letters a through f inclusive. The four - characters `.', `*', `[', and `\' stand for themselves - within such a string of characters. - - The following rules may be used to construct regular expres- - sions: - - * A one-character regular expression followed by `*' (an - asterisk) is a regular expression that matches zero or - more occurrences of the one-character regular expres- - sion. If there is any choice, the longest leftmost - string that permits a match is chosen. - - ^ A circumflex or caret (^) at the beginning of an entire - regular expression constrains that regular expression - to match an initial segment of a line. - - $ A currency symbol ($) at the end of an entire regular - expression constrains that regular expression to match - a final segment of a line. - - * A regular expression (not just a one- - character regular expression) followed by `*' - (an asterisk) is a regular expression that - matches zero or more occurrences of the one- - character regular expression. If there is - any choice, the longest leftmost string that - permits a match is chosen. - - + A regular expression followed by `+' (a plus - sign) is a regular expression that matches - one or more occurrences of the one-character - regular expression. If there is any choice, - the longest leftmost string that permits a - match is chosen. - - ? A regular expression followed by `?' (a ques- - tion mark) is a regular expression that - matches zero or one occurrences of the one- - character regular expression. If there is - any choice, the longest leftmost string that - permits a match is chosen. - - | Alternation: two regular expressions - separated by `|' or NEWLINE match either a - match for the first or a match for the - second. - - () A regular expression enclosed in parentheses - matches a match for the regular expression. - - The order of precedence of operators at the same parenthesis - level is `[ ]' (character classes), then `*' `+' `?' - (closures),then concatenation, then `|' (alternation)and - NEWLINE. diff --git a/TWiki/ResetPassword.mdwn b/TWiki/ResetPassword.mdwn deleted file mode 100644 index b2781713..00000000 --- a/TWiki/ResetPassword.mdwn +++ /dev/null @@ -1,28 +0,0 @@ -<font>Request for reset of password</font><br /> - -Please only use this **ResetPassword** form in case you really forgot your password. Otherwise just change it using [[ChangePassword]]. Thank you. - -<form action="%SCRIPTURL%/passwd%SCRIPTSUFFIX%/%MAINWEB%/%HOMETOPIC%" method="post" name="passwd"> - <p> - </p> - <table border="1"> - <tr> - <td align="right">Your %TWIKIWEB%.WikiName: </td> - <td><input name="username" size="40" type="text" value="" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right">New password </td> - <td><input name="password" size="40" type="password" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right">Retype new password </td> - <td><input name="passwordA" size="40" type="password" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right" valign="top"> <input name="TopicName" type="hidden" value="%TOPIC%" /></td> - <td><input type="submit" value=" Request password reset " /> (Fields marked <code><font color="red">**</font></code> are required) </td> - </tr> - </table> -</form> - -After submitting this form you will receive a page with yor **new password** appearing **encrypted**. %STOPINCLUDE% You will have to send this information to the Wiki webmaster %WIKIWEBMASTER% by email. diff --git a/TWiki/SearchDoesNotWork.mdwn b/TWiki/SearchDoesNotWork.mdwn deleted file mode 100644 index 0725994d..00000000 --- a/TWiki/SearchDoesNotWork.mdwn +++ /dev/null @@ -1,11 +0,0 @@ -## <a name="FAQ_"> </a> FAQ: - -I've problems with the WebSearch. There is no Search Result on any inquiry. By clicking the Index topic it's the same problem. - -## <a name="Answer_"> Answer: </a> - -That is an indication that %WIKITOOLNAME% can't find the `egrep` and `fgrep` commands on your system. Check the `$egrepCmd` and `$fgrepCmd` variables in `twiki/lib/TWiki.cfg`. - -**_Back to:_** [[TWikiFAQ]] - --- [[Main/PeterThoeny]] - 26 Jan 2001 <br /> diff --git a/TWiki/SelectSkin.mdwn b/TWiki/SelectSkin.mdwn deleted file mode 100644 index 606687ec..00000000 --- a/TWiki/SelectSkin.mdwn +++ /dev/null @@ -1,18 +0,0 @@ -Allows you to select a new skin. - -<form action="%SCRIPTURL%/view%SCRIPTSUFFIX%/%URLPARAM{" fromweb"}%/%urlparam{"fromtopic"}%"="fromweb"}%/%URLPARAM{"fromtopic"}%"" method="get"> - <p> - </p> - <dl> - <dt> Skin</dt> - <dd> %SKINSELECT% <input type="submit" value="Go" /></dd> - </dl> - <p> - </p> -</form> - -Notes: - -* this will only persist for your session -* this will work because the [[SessionPlugin]] is installed on this TWiki server -* this page will not work correctly if you came to it directly diff --git a/TWiki/SessionPlugin.mdwn b/TWiki/SessionPlugin.mdwn deleted file mode 100644 index f69dbd18..00000000 --- a/TWiki/SessionPlugin.mdwn +++ /dev/null @@ -1,19 +0,0 @@ -This Plugin allows session information to be retained whilst a browser is running. It does this by storing a small session cookie in the browser. This contains an identification string that TWiki uses to extract session information on the server. - -Notes: - -* The cookie is not persistant - -* The session information is stored in files under `data/.sessions/` - -* Old session files should be deleted by a cron job - -* The identification string used for a session is: - -* * time (second resolution) + random number - -* If url parameter `stickskin` is present, its value sets the session value for `SKIN` i.e. you then stick on this skin. Get back to defalt skin with _stickskin=._ - -* Set SHORTDESCRIPTION = Holds session information on server, session identified from sessionId stored in non-persistant cookie - -* Set DEBUG = 1 diff --git a/TWiki/SimultaneousEdits.mdwn b/TWiki/SimultaneousEdits.mdwn deleted file mode 100644 index f640c1d2..00000000 --- a/TWiki/SimultaneousEdits.mdwn +++ /dev/null @@ -1,11 +0,0 @@ -## <a name="FAQ_"> </a> FAQ: - -What happens if two of us try to edit the same topic simultaneously? - -## <a name="Answer_"> Answer: </a> - -The second person gets a warning that the topic is currently being edited by another user. A topic gets locked automatically for some time (default is one hour) when you edit, preview or save the topic. If you get the lock warning you should wait until the lock is gone or contact the other person to ask if you can go ahead and break the lock. See also [[UnlockTopic]]. - -**_Back to:_** [[TWikiFAQ]] - --- [[Main/PeterThoeny]] - 27 Nov 2000 <br /> diff --git a/TWiki/SiteUsageStatistics.mdwn b/TWiki/SiteUsageStatistics.mdwn deleted file mode 100644 index 091f503d..00000000 --- a/TWiki/SiteUsageStatistics.mdwn +++ /dev/null @@ -1,22 +0,0 @@ -%TOC% %STARTINCLUDE% - -## <a name="Site_Usage_Statistics"> Site Usage Statistics </a> - -* You can automatically generate usage statistics for all webs. To enable this: - * Make sure variable `$doLogTopicView, $doLogTopicSave and $doLogTopicUpload` in `wikicfg.pm` are set. This will generate log entries in file `twiki/data/log<date>.txt` . - * Topic [[WebStatistics]] must be present in all webs where you want to have statistics. You can use the topic in the Main web as a template. - * Call the `twiki/bin/statistics` script from a cron job, once a day is recommended. This will update the [[WebStatistics]] topics in all webs. - * **_Attention:_** The script must run as the same user as the CGI scripts are running, which is user `nobody` on most systems. Example crontab entry: <br />`0 0 * * * (cd /path/to/TWiki/bin; ./statistics >/dev/null 2>&1)` - * There is a workaround in case you can't run the script as user `nobody` : Run the utility `twiki/bin/geturl` in your cron job and specify the URL of the `twiki/bin/statistics` script as a parameter. Example: <br />`0 0 * * * (cd /path/to/TWiki/bin; ./geturl mydomain.com /urlpath/to/TWiki/bin/statistics >/dev/null 2>&1)` - * The `twiki/bin/statistics` script can also be executed as a CGI script, just enter the URL in your browser. Examples: - * Update current month for all webs: <br />`http://mydomain.com/twiki/bin/statistics` - * Update current month for Main web only: <br />`http://mydomain.com/twiki/bin/statistics/Main` - * Update January 2000 for Main web: <br />`http://mydomain.com/twiki/bin/statistics/Main?logdate=200001` - --- [[MikeMannix]] - 01 Sep 2001 - -## <a name="GnuFans_org"> </a> [[GnuFans]].org - -We also have [[TWiki/TWikiChanges]] and <http://hurd.gnufans.org/webalizer/> running on our site. - --- [[Main/GrantBow]] - 17 Jan 2003 diff --git a/TWiki/SmiliesPlugin.mdwn b/TWiki/SmiliesPlugin.mdwn deleted file mode 100644 index 8a7c0ee0..00000000 --- a/TWiki/SmiliesPlugin.mdwn +++ /dev/null @@ -1,185 +0,0 @@ -# <a name="The_Smilies_Plugin"> The Smilies Plugin </a> - -Smilies are common in e-mail messages and bulletin board posts. They are used to convey an emotion, such as a smile :-) or a frown :-( . This plugin automatically converts certain smilies to a nice small icon. - -Here is the list of smilies supported by this plugin. To add others, attach new icons to this topic and tweak the table below. - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>You type</strong></th> - <th bgcolor="#99CCCC"><strong>You see</strong></th> - <th bgcolor="#99CCCC"><strong>Emotion</strong></th> - </tr> - <tr> - <td><nop>:-) </nop></td> - <td> %ATTACHURL%/smile.gif </td> - <td> "smile" </td> - </tr> - <tr> - <td><nop>:) </nop></td> - <td> %ATTACHURL%/smile.gif </td> - <td> "smile" </td> - </tr> - <tr> - <td><nop>:cool: </nop></td> - <td> %ATTACHURL%/cool.gif </td> - <td> "cool!" </td> - </tr> - <tr> - <td><nop>:( </nop></td> - <td> %ATTACHURL%/frown.gif </td> - <td> "frown" </td> - </tr> - <tr> - <td><nop>:-( </nop></td> - <td> %ATTACHURL%/frown.gif </td> - <td> "frown" </td> - </tr> - <tr> - <td><nop>:o </nop></td> - <td> %ATTACHURL%/redface.gif </td> - <td> "embarrassment" </td> - </tr> - <tr> - <td><nop>:D </nop></td> - <td> %ATTACHURL%/biggrin.gif </td> - <td> "big grin" </td> - </tr> - <tr> - <td><nop>;) </nop></td> - <td> %ATTACHURL%/wink.gif </td> - <td> "wink" </td> - </tr> - <tr> - <td><nop>;-) </nop></td> - <td> %ATTACHURL%/wink.gif </td> - <td> "wink" </td> - </tr> - <tr> - <td><nop>:p </nop></td> - <td> %ATTACHURL%/tongue.gif </td> - <td> "razz (stick out tongue)" </td> - </tr> - <tr> - <td><nop>:rolleyes: </nop></td> - <td> %ATTACHURL%/rolleyes.gif </td> - <td> "roll eyes (sarcastic)" </td> - </tr> - <tr> - <td><nop>:mad: </nop></td> - <td> %ATTACHURL%/mad.gif </td> - <td> "mad!" </td> - </tr> - <tr> - <td><nop>:eek: </nop></td> - <td> %ATTACHURL%/eek.gif </td> - <td> "eek!" </td> - </tr> - <tr> - <td><nop>:confused: </nop></td> - <td> %ATTACHURL%/confused.gif </td> - <td> "confused" </td> - </tr> -</table> - -## <a name="_TOPIC_Global_Settings"> %TOPIC% Global Settings </a> - -Plugin settings are stored as preferences variables. To reference a plugin setting write <code>**%<plugin>\_<setting>%**</code>, for example, <code>**%INTERWIKIPLUGIN\_SHORTDESCRIPTION%**</code> - -* One line description, shown in the %TWIKIWEB%.TextFormattingRules topic: - * Set SHORTDESCRIPTION = Render smilies as icons, like ` :-)` for :-) or ` :cool:` for :cool: - -* Set DEBUG to 1 to get debug messages in `data/debug.txt`. Default: `0` - * Set DEBUG = 0 - -* The name of the topic containig your Smilies. Default: <code>**%WEB%.SmiliesPlugin**</code> - * #Set TOPIC = [[TWiki/SmiliesPlugin]] - -* The way the _emoticon_ is displayed. You can use <code>**$emoticon**</code> (e.g. <code>:D</code>), <code>**$url**</code> (e.g. <code>%ATTACHURL%/biggrin.gif</code>) and <code>**$tooltip**</code> (e.g. `"big grin"`). Default: <code>**<img src="$url" alt="$tooltip" />**</code> - - * #Set FORMAT = <img src="$url" alt="$emoticon" /> - -## <a name="Plugin_Installation_Instructions"> Plugin Installation Instructions </a> - -* Download the ZIP file from the Plugin web (see below) -* Unzip <code>**%TOPIC%.zip**</code> in your twiki installation directory. Content: <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>File:</strong></th> - <th bgcolor="#99CCCC"><strong>Description:</strong></th> - </tr> - <tr> - <td><code><b>data/TWiki/%TOPIC%.txt</b></code></td> - <td> Plugin topic </td> - </tr> - <tr> - <td><code><b>data/TWiki/%TOPIC%.txt,v</b></code></td> - <td> Plugin topic repository </td> - </tr> - <tr> - <td><code><b>lib/TWiki/Plugins/%TOPIC%.pm</b></code></td> - <td> Plugin Perl module </td> - </tr> - <tr> - <td><code><b>pub/TWiki/%TOPIC%/*.gif</b></code></td> - <td> Plugin icon files </td> - </tr> -</table> -* Test if the plugin is correctly installed: - * You will see a series of icons on next line: <br /> :-) :) :cool: :( :o :D ;) :p :rolleyes: :mad: :eek: :confused: - -## <a name="Plugin_Info"> Plugin Info </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <td align="right"> Plugin Author: </td> - <td> %TWIKIWEB%.AndreaSterbini </td> - </tr> - <tr> - <td align="right"> Plugin Version: </td> - <td> 20 Apr 2002 </td> - </tr> - <tr> - <td align="right"> Change History: </td> - <td> </td> - </tr> - <tr> - <td align="right"> 20 Apr 2002 </td> - <td> Improved performance; removed non-standard Plugin API dependencies; added standard plugin topic content -- %TWIKIWEB%.PeterThoeny </td> - </tr> - <tr> - <td align="right"> 23 Nov 2001 </td> - <td> Added TOPIC and FORMAT setting </td> - </tr> - <tr> - <td align="right"> 10 Jun 2001 </td> - <td> Packaged into ZIP </td> - </tr> - <tr> - <td align="right"> 28 Feb 2001 </td> - <td> Initial version </td> - </tr> - <tr> - <td align="right"> CPAN Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Other Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Perl Version: </td> - <td> 5.0 </td> - </tr> - <tr> - <td align="right"> Plugin Home: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td> - </tr> - <tr> - <td align="right"> Feedback: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td> - </tr> -</table> - -**_Related Topics:_** %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins - --- %TWIKIWEB%.AndreaSterbini - 28 Dec 2000 <br /> -- %TWIKIWEB%.PeterThoeny - 20 Apr 2002 diff --git a/TWiki/SmiliesPlugin/biggrin.gif b/TWiki/SmiliesPlugin/biggrin.gif Binary files differdeleted file mode 100644 index c1509e17..00000000 --- a/TWiki/SmiliesPlugin/biggrin.gif +++ /dev/null diff --git a/TWiki/SmiliesPlugin/confused.gif b/TWiki/SmiliesPlugin/confused.gif Binary files differdeleted file mode 100644 index 684b51c9..00000000 --- a/TWiki/SmiliesPlugin/confused.gif +++ /dev/null diff --git a/TWiki/SmiliesPlugin/cool.gif b/TWiki/SmiliesPlugin/cool.gif Binary files differdeleted file mode 100644 index b2c0b8c6..00000000 --- a/TWiki/SmiliesPlugin/cool.gif +++ /dev/null diff --git a/TWiki/SmiliesPlugin/eek.gif b/TWiki/SmiliesPlugin/eek.gif Binary files differdeleted file mode 100644 index 43cf2125..00000000 --- a/TWiki/SmiliesPlugin/eek.gif +++ /dev/null diff --git a/TWiki/SmiliesPlugin/frown.gif b/TWiki/SmiliesPlugin/frown.gif Binary files differdeleted file mode 100644 index e3086d11..00000000 --- a/TWiki/SmiliesPlugin/frown.gif +++ /dev/null diff --git a/TWiki/SmiliesPlugin/mad.gif b/TWiki/SmiliesPlugin/mad.gif Binary files differdeleted file mode 100644 index a38492bf..00000000 --- a/TWiki/SmiliesPlugin/mad.gif +++ /dev/null diff --git a/TWiki/SmiliesPlugin/redface.gif b/TWiki/SmiliesPlugin/redface.gif Binary files differdeleted file mode 100644 index 44cd75a8..00000000 --- a/TWiki/SmiliesPlugin/redface.gif +++ /dev/null diff --git a/TWiki/SmiliesPlugin/rolleyes.gif b/TWiki/SmiliesPlugin/rolleyes.gif Binary files differdeleted file mode 100644 index d5e29f52..00000000 --- a/TWiki/SmiliesPlugin/rolleyes.gif +++ /dev/null diff --git a/TWiki/SmiliesPlugin/smile.gif b/TWiki/SmiliesPlugin/smile.gif Binary files differdeleted file mode 100644 index 603ddddb..00000000 --- a/TWiki/SmiliesPlugin/smile.gif +++ /dev/null diff --git a/TWiki/SmiliesPlugin/tongue.gif b/TWiki/SmiliesPlugin/tongue.gif Binary files differdeleted file mode 100644 index 1b36c3d0..00000000 --- a/TWiki/SmiliesPlugin/tongue.gif +++ /dev/null diff --git a/TWiki/SmiliesPlugin/wink.gif b/TWiki/SmiliesPlugin/wink.gif Binary files differdeleted file mode 100644 index 077383e1..00000000 --- a/TWiki/SmiliesPlugin/wink.gif +++ /dev/null diff --git a/TWiki/SpacedWikiWordPlugin.mdwn b/TWiki/SpacedWikiWordPlugin.mdwn deleted file mode 100644 index 9f622139..00000000 --- a/TWiki/SpacedWikiWordPlugin.mdwn +++ /dev/null @@ -1,99 +0,0 @@ -## <a name="Spaced_Out_TWiki_Word_Plugin"> Spaced Out TWiki Word Plugin </a> - -Causes wiki words to be displayed with spaces between capitals. - -See also TWiki:Support.CanIRenderWikiWordsSpacedOut - -Regexes shamelessly stolen from TWiki:Codev.SpacedOutTWikiWords - -NB. Needs TWiki:Codev.CairoRelease or alphas after 12 Apr 2004 - -### <a name="Syntax_Rules"> Syntax Rules </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>If you write</strong></th> - <th bgcolor="#99CCCC"><strong>You should see</strong></th> - <th bgcolor="#99CCCC"><strong>Test</strong></th> - </tr> - <tr> - <td> !BSFLeaders </td> - <td> BSF Leaders </td> - <td> BSFLeaders </td> - </tr> - <tr> - <td> !DogWalkers </td> - <td> Dog Walkers </td> - <td>[[DogWalkers]]</td> - </tr> - <tr> - <td> !Lotus123 </td> - <td> Lotus 123 </td> - <td> Lotus123 </td> - </tr> - <tr> - <td> !ILikeTWiki </td> - <td> I Like T Wiki </td> - <td>[[ILikeTWiki]]</td> - </tr> -</table> - -### <a name="_TOPIC_Settings"> %TOPIC% Settings </a> - -Plugin settings are stored as preferences variables. - -* One line description, shown in the %TWIKIWEB%.TextFormattingRules topic: - * Set SHORTDESCRIPTION = Causes wiki words to be displayed with spaces between capitals. - -* * Set DEBUG = 0 - -### <a name="Plugin_Installation_Instructions"> Plugin Installation Instructions </a> - -To install plugin: - -* Unzip the archive to the top of your directory - -### <a name="Plugin_Info"> Plugin Info </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <td align="right"> Plugin Author: </td> - <td>[[Main/MartinCleaver]]</td> - </tr> - <tr> - <td align="right"> Plugin Version: </td> - <td> 12 Apr 2004 </td> - </tr> - <tr> - <td align="right"> Change History: </td> - <td> 14 Apr 2002 Initial version </td> - </tr> - <tr> - <td align="right"> Change History: </td> - <td> 12 Apr 2004 Updated for TWiki:Codev.CairoRelease </td> - </tr> - <tr> - <td align="right"> CPAN Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Other Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Perl Version: </td> - <td> 5.0 </td> - </tr> - <tr> - <td align="right"> Plugin Home: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a> ( TWiki:Plugins/%TOPIC% ) </td> - </tr> - <tr> - <td align="right"> Feedback: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a> ( TWiki:Plugins/%TOPIC%Dev ) </td> - </tr> -</table> - -**_Related Topics:_** %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins, [[DefaultPlugin]] - --- [[Main/MartinCleaver]] - 27 Feb 2001 <br /> diff --git a/TWiki/StandardColors.mdwn b/TWiki/StandardColors.mdwn deleted file mode 100644 index efccff92..00000000 --- a/TWiki/StandardColors.mdwn +++ /dev/null @@ -1,306 +0,0 @@ -**The 256 Standard Colors** - -This table can be used to choose a color in %WEBPREFSTOPIC% of each web. (Note newer TWiki releases come with a colorized version of this table. TWiki:TWiki.StandardColors) - -<table width="100%"> - <tr> - <td bgcolor="000000"> 000000 </td> - <td bgcolor="000033"> 000033 </td> - <td bgcolor="000066"> 000066 </td> - <td bgcolor="000099"> 000099 </td> - <td bgcolor="0000CC"> 0000CC </td> - <td bgcolor="0000FF"> 0000FF </td> - </tr> - <tr> - <td bgcolor="003300"> 003300 </td> - <td bgcolor="003333"> 003333 </td> - <td bgcolor="003366"> 003366 </td> - <td bgcolor="003399"> 003399 </td> - <td bgcolor="0033CC"> 0033CC </td> - <td bgcolor="0033FF"> 0033FF </td> - </tr> - <tr> - <td bgcolor="006600"> 006600 </td> - <td bgcolor="006633"> 006633 </td> - <td bgcolor="006666"> 006666 </td> - <td bgcolor="006699"> 006699 </td> - <td bgcolor="0066CC"> 0066CC </td> - <td bgcolor="0066FF"> 0066FF </td> - </tr> - <tr> - <td bgcolor="009900"> 009900 </td> - <td bgcolor="009933"> 009933 </td> - <td bgcolor="009966"> 009966 </td> - <td bgcolor="009999"> 009999 </td> - <td bgcolor="0099CC"> 0099CC </td> - <td bgcolor="0099FF"> 0099FF </td> - </tr> - <tr> - <td bgcolor="00CC00"> 00CC00 </td> - <td bgcolor="00CC33"> 00CC33 </td> - <td bgcolor="00CC66"> 00CC66 </td> - <td bgcolor="00CC99"> 00CC99 </td> - <td bgcolor="00CCCC"> 00CCCC </td> - <td bgcolor="00CCFF"> 00CCFF </td> - </tr> - <tr> - <td bgcolor="00FF00"> 00FF00 </td> - <td bgcolor="00FF33"> 00FF33 </td> - <td bgcolor="00FF66"> 00FF66 </td> - <td bgcolor="00FF99"> 00FF99 </td> - <td bgcolor="00FFCC"> 00FFCC </td> - <td bgcolor="00FFFF"> 00FFFF </td> - </tr> -</table> -<table width="100%"> - <tr> - <td bgcolor="330000"> 330000 </td> - <td bgcolor="330033"> 330033 </td> - <td bgcolor="330066"> 330066 </td> - <td bgcolor="330099"> 330099 </td> - <td bgcolor="3300CC"> 3300CC </td> - <td bgcolor="3300FF"> 3300FF </td> - </tr> - <tr> - <td bgcolor="333300"> 333300 </td> - <td bgcolor="333333"> 333333 </td> - <td bgcolor="333366"> 333366 </td> - <td bgcolor="333399"> 333399 </td> - <td bgcolor="3333CC"> 3333CC </td> - <td bgcolor="3333FF"> 3333FF </td> - </tr> - <tr> - <td bgcolor="336600"> 336600 </td> - <td bgcolor="336633"> 336633 </td> - <td bgcolor="336666"> 336666 </td> - <td bgcolor="336699"> 336699 </td> - <td bgcolor="3366CC"> 3366CC </td> - <td bgcolor="3366FF"> 3366FF </td> - </tr> - <tr> - <td bgcolor="339900"> 339900 </td> - <td bgcolor="339933"> 339933 </td> - <td bgcolor="339966"> 339966 </td> - <td bgcolor="339999"> 339999 </td> - <td bgcolor="3399CC"> 3399CC </td> - <td bgcolor="3399FF"> 3399FF </td> - </tr> - <tr> - <td bgcolor="33CC00"> 33CC00 </td> - <td bgcolor="33CC33"> 33CC33 </td> - <td bgcolor="33CC66"> 33CC66 </td> - <td bgcolor="33CC99"> 33CC99 </td> - <td bgcolor="33CCCC"> 33CCCC </td> - <td bgcolor="33CCFF"> 33CCFF </td> - </tr> - <tr> - <td bgcolor="33FF00"> 33FF00 </td> - <td bgcolor="33FF33"> 33FF33 </td> - <td bgcolor="33FF66"> 33FF66 </td> - <td bgcolor="33FF99"> 33FF99 </td> - <td bgcolor="33FFCC"> 33FFCC </td> - <td bgcolor="33FFFF"> 33FFFF </td> - </tr> -</table> -<table width="100%"> - <tr> - <td bgcolor="660000"> 660000 </td> - <td bgcolor="660033"> 660033 </td> - <td bgcolor="660066"> 660066 </td> - <td bgcolor="660099"> 660099 </td> - <td bgcolor="6600CC"> 6600CC </td> - <td bgcolor="6600FF"> 6600FF </td> - </tr> - <tr> - <td bgcolor="663300"> 663300 </td> - <td bgcolor="663333"> 663333 </td> - <td bgcolor="663366"> 663366 </td> - <td bgcolor="663399"> 663399 </td> - <td bgcolor="6633CC"> 6633CC </td> - <td bgcolor="6633FF"> 6633FF </td> - </tr> - <tr> - <td bgcolor="666600"> 666600 </td> - <td bgcolor="666633"> 666633 </td> - <td bgcolor="666666"> 666666 </td> - <td bgcolor="666699"> 666699 </td> - <td bgcolor="6666CC"> 6666CC </td> - <td bgcolor="6666FF"> 6666FF </td> - </tr> - <tr> - <td bgcolor="669900"> 669900 </td> - <td bgcolor="669933"> 669933 </td> - <td bgcolor="669966"> 669966 </td> - <td bgcolor="669999"> 669999 </td> - <td bgcolor="6699CC"> 6699CC </td> - <td bgcolor="6699FF"> 6699FF </td> - </tr> - <tr> - <td bgcolor="66CC00"> 66CC00 </td> - <td bgcolor="66CC33"> 66CC33 </td> - <td bgcolor="66CC66"> 66CC66 </td> - <td bgcolor="66CC99"> 66CC99 </td> - <td bgcolor="66CCCC"> 66CCCC </td> - <td bgcolor="66CCFF"> 66CCFF </td> - </tr> - <tr> - <td bgcolor="66FF00"> 66FF00 </td> - <td bgcolor="66FF33"> 66FF33 </td> - <td bgcolor="66FF66"> 66FF66 </td> - <td bgcolor="66FF99"> 66FF99 </td> - <td bgcolor="66FFCC"> 66FFCC </td> - <td bgcolor="66FFFF"> 66FFFF </td> - </tr> -</table> -<table width="100%"> - <tr> - <td bgcolor="990000"> 990000 </td> - <td bgcolor="990033"> 990033 </td> - <td bgcolor="990066"> 990066 </td> - <td bgcolor="990099"> 990099 </td> - <td bgcolor="9900CC"> 9900CC </td> - <td bgcolor="9900FF"> 9900FF </td> - </tr> - <tr> - <td bgcolor="993300"> 993300 </td> - <td bgcolor="993333"> 993333 </td> - <td bgcolor="993366"> 993366 </td> - <td bgcolor="993399"> 993399 </td> - <td bgcolor="9933CC"> 9933CC </td> - <td bgcolor="9933FF"> 9933FF </td> - </tr> - <tr> - <td bgcolor="996600"> 996600 </td> - <td bgcolor="996633"> 996633 </td> - <td bgcolor="996666"> 996666 </td> - <td bgcolor="996699"> 996699 </td> - <td bgcolor="9966CC"> 9966CC </td> - <td bgcolor="9966FF"> 9966FF </td> - </tr> - <tr> - <td bgcolor="999900"> 999900 </td> - <td bgcolor="999933"> 999933 </td> - <td bgcolor="999966"> 999966 </td> - <td bgcolor="999999"> 999999 </td> - <td bgcolor="9999CC"> 9999CC </td> - <td bgcolor="9999FF"> 9999FF </td> - </tr> - <tr> - <td bgcolor="99CC00"> 99CC00 </td> - <td bgcolor="99CC33"> 99CC33 </td> - <td bgcolor="99CC66"> 99CC66 </td> - <td bgcolor="99CC99"> 99CC99 </td> - <td bgcolor="99CCCC"> 99CCCC </td> - <td bgcolor="99CCFF"> 99CCFF </td> - </tr> - <tr> - <td bgcolor="99FF00"> 99FF00 </td> - <td bgcolor="99FF33"> 99FF33 </td> - <td bgcolor="99FF66"> 99FF66 </td> - <td bgcolor="99FF99"> 99FF99 </td> - <td bgcolor="99FFCC"> 99FFCC </td> - <td bgcolor="99FFFF"> 99FFFF </td> - </tr> -</table> -<table width="100%"> - <tr> - <td bgcolor="CC0000"> CC0000 </td> - <td bgcolor="CC0033"> CC0033 </td> - <td bgcolor="CC0066"> CC0066 </td> - <td bgcolor="CC0099"> CC0099 </td> - <td bgcolor="CC00CC"> CC00CC </td> - <td bgcolor="CC00FF"> CC00FF </td> - </tr> - <tr> - <td bgcolor="CC3300"> CC3300 </td> - <td bgcolor="CC3333"> CC3333 </td> - <td bgcolor="CC3366"> CC3366 </td> - <td bgcolor="CC3399"> CC3399 </td> - <td bgcolor="CC33CC"> CC33CC </td> - <td bgcolor="CC33FF"> CC33FF </td> - </tr> - <tr> - <td bgcolor="CC6600"> CC6600 </td> - <td bgcolor="CC6633"> CC6633 </td> - <td bgcolor="CC6666"> CC6666 </td> - <td bgcolor="CC6699"> CC6699 </td> - <td bgcolor="CC66CC"> CC66CC </td> - <td bgcolor="CC66FF"> CC66FF </td> - </tr> - <tr> - <td bgcolor="CC9900"> CC9900 </td> - <td bgcolor="CC9933"> CC9933 </td> - <td bgcolor="CC9966"> CC9966 </td> - <td bgcolor="CC9999"> CC9999 </td> - <td bgcolor="CC99CC"> CC99CC </td> - <td bgcolor="CC99FF"> CC99FF </td> - </tr> - <tr> - <td bgcolor="CCCC00"> CCCC00 </td> - <td bgcolor="CCCC33"> CCCC33 </td> - <td bgcolor="CCCC66"> CCCC66 </td> - <td bgcolor="CCCC99"> CCCC99 </td> - <td bgcolor="CCCCCC"> CCCCCC </td> - <td bgcolor="CCCCFF"> CCCCFF </td> - </tr> - <tr> - <td bgcolor="CCFF00"> CCFF00 </td> - <td bgcolor="CCFF33"> CCFF33 </td> - <td bgcolor="CCFF66"> CCFF66 </td> - <td bgcolor="CCFF99"> CCFF99 </td> - <td bgcolor="CCFFCC"> CCFFCC </td> - <td bgcolor="CCFFFF"> CCFFFF </td> - </tr> -</table> -<table width="100%"> - <tr> - <td bgcolor="FF0000"> FF0000 </td> - <td bgcolor="FF0033"> FF0033 </td> - <td bgcolor="FF0066"> FF0066 </td> - <td bgcolor="FF0099"> FF0099 </td> - <td bgcolor="FF00CC"> FF00CC </td> - <td bgcolor="FF00FF"> FF00FF </td> - </tr> - <tr> - <td bgcolor="FF3300"> FF3300 </td> - <td bgcolor="FF3333"> FF3333 </td> - <td bgcolor="FF3366"> FF3366 </td> - <td bgcolor="FF3399"> FF3399 </td> - <td bgcolor="FF33CC"> FF33CC </td> - <td bgcolor="FF33FF"> FF33FF </td> - </tr> - <tr> - <td bgcolor="FF6600"> FF6600 </td> - <td bgcolor="FF6633"> FF6633 </td> - <td bgcolor="FF6666"> FF6666 </td> - <td bgcolor="FF6699"> FF6699 </td> - <td bgcolor="FF66CC"> FF66CC </td> - <td bgcolor="FF66FF"> FF66FF </td> - </tr> - <tr> - <td bgcolor="FF9900"> FF9900 </td> - <td bgcolor="FF9933"> FF9933 </td> - <td bgcolor="FF9966"> FF9966 </td> - <td bgcolor="FF9999"> FF9999 </td> - <td bgcolor="FF99CC"> FF99CC </td> - <td bgcolor="FF99FF"> FF99FF </td> - </tr> - <tr> - <td bgcolor="FFCC00"> FFCC00 </td> - <td bgcolor="FFCC33"> FFCC33 </td> - <td bgcolor="FFCC66"> FFCC66 </td> - <td bgcolor="FFCC99"> FFCC99 </td> - <td bgcolor="FFCCCC"> FFCCCC </td> - <td bgcolor="FFCCFF"> FFCCFF </td> - </tr> - <tr> - <td bgcolor="FFFF00"> FFFF00 </td> - <td bgcolor="FFFF33"> FFFF33 </td> - <td bgcolor="FFFF66"> FFFF66 </td> - <td bgcolor="FFFF99"> FFFF99 </td> - <td bgcolor="FFFFCC"> FFFFCC </td> - <td bgcolor="FFFFFF"> FFFFFF </td> - </tr> -</table> - --- [[Main/PeterThoeny]] - 07 Nov 2000 <br /> diff --git a/TWiki/StanleyKnutson.mdwn b/TWiki/StanleyKnutson.mdwn deleted file mode 100644 index 4be7ad0c..00000000 --- a/TWiki/StanleyKnutson.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Stanley Knutson is a [[TWikiContributor]]. - -See <http://twiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/StartingPoints.mdwn b/TWiki/StartingPoints.mdwn deleted file mode 100644 index dfd917b5..00000000 --- a/TWiki/StartingPoints.mdwn +++ /dev/null @@ -1,35 +0,0 @@ -## <a name="TWiki_Starting_Points"> TWiki Starting Points </a> - -**%WIKITOOLNAME%.%MAINWEB% Web:** - -* ** %MAINWEB%.%WIKIUSERSTOPIC%: ** List of users of this %WIKITOOLNAME% web. -* %MAINWEB%.TWikiGroups: List of groups. - -<form action="%SCRIPTURLPATH%/search%SCRIPTSUFFIX%/%WEB%/"> - <ul> - <li> %MAINWEB%.WebSearch: Full text search of the %WIKITOOLNAME%.%MAINWEB% web. </li> - <li><input name="search" size="32" type="text" /> <input type="submit" value="Search" /> (More options in [[WebSearch]]) </li> - <li> %MAINWEB%.WebChanges: Find out recent modifications to the %WIKITOOLNAME%.%MAINWEB% web. </li> - <li> %MAINWEB%.WebIndex: Display all %WIKITOOLNAME%.%MAINWEB% topics in alphabetical order. See also the faster %MAINWEB%.WebTopicList </li> - <li> %MAINWEB%.%NOTIFYTOPIC%: Subscribe to be automatically notified when something changes in the %WIKITOOLNAME%.%MAINWEB% web. </li> - <li> %MAINWEB%.%STATISTICSTOPIC%: View access statistics of the %WIKITOOLNAME%.%MAINWEB% web. </li> - <li> %MAINWEB%.%WEBPREFSTOPIC%: Preferences of the %WIKITOOLNAME%.%MAINWEB% web. </li> - </ul> -</form> - -**%WIKITOOLNAME%.%TWIKIWEB% Web:** - -* ** %TWIKIWEB%.WelcomeGuest: ** Look here first to get you rolling on %WIKITOOLNAME%. -* %TWIKIWEB%.TWikiSite: Explains what a %WIKITOOLNAME% site is. -* %TWIKIWEB%.TWikiRegistration: Create your account in order to edit topics. -* %TWIKIWEB%.ChangePassword: Change your account password. -* %TWIKIWEB%.ResetPassword: Forgot your password? -* Documentation: - * %TWIKIWEB%.TWikiFAQ has a list of frequently asked questions. - * %TWIKIWEB%.TWikiDocumentation is the implementation documentation of TWiki. - * %TWIKIWEB%.TWikiHistory shows TWiki's implementation history. -* How to edit text: - * %TWIKIWEB%.GoodStyle: Things to consider when changing text. - * %TWIKIWEB%.TextFormattingRules: Easy to learn rules for editing text. - * %TWIKIWEB%.TextFormattingFAQ: Answers to frequently asked questions about text formatting. -* %TWIKIWEB%.%WIKIPREFSTOPIC%: %WIKITOOLNAME% site-level preferences diff --git a/TWiki/SvenDowideit.mdwn b/TWiki/SvenDowideit.mdwn deleted file mode 100644 index 8bd9b65c..00000000 --- a/TWiki/SvenDowideit.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -Sven Dowideit is a [[TWikiContributor]]. - -See <http://twiki.org/cgi-bin/view/Main/%TOPIC%> diff --git a/TWiki/TWikiAccessControl.mdwn b/TWiki/TWikiAccessControl.mdwn deleted file mode 100644 index 878658f2..00000000 --- a/TWiki/TWikiAccessControl.mdwn +++ /dev/null @@ -1,164 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_Access_Control"> TWiki Access Control </a> - -_Restricting read and write access to topics and webs, by users and groups_ - -## <a name="Overview"> Overview </a> - -[[TWikiAccessControl]] allows you restrict access to single topics and entire webs, by individual user and by user groups, in three main areas: view; edit & attach; and rename/move/delete. These controls, combined with [[TWikiUserAuthentication]], let you easily create and manage an extremely flexible, fine-grained privilege system. - -## <a name="An_Important_Control_Considerati"> An Important Control Consideration </a> - -Open, freeform editing is the essence of the [[WikiCulture]] - it's what makes TWiki different and often more effective than other collaboration tools. So, it is strongly recommended that decisions to restrict read or write access to a web or a topic are made with care. Experience shows that _unrestricted write access_ works very well because: - -* Peer influence is enough to ensure that only relevant content is posted. - -* Peer editing - the ability to rearrange anything on a page - keeps topics focussed. - -* All content is preserved under revision control. - * Edits can be undone by the %MAINWEB%.TWikiAdminGroup (the default administrators group; see #ManagingGroups). - * Users are encouraged to edit and refactor (condense a long topic), since there's a safety net. - -As a collaboration guideline: - -* Create broad groups (more and varied input), and... -* Avoid creating view-only users (if you can read it, you can contribute to it). - -## <a name="Users_and_Groups"> Users and Groups </a> - -Access control is based on users and groups. Users are defined by their [[WikiNames]], an then organized into unlimited combinations under different user groups. - -### <a name="Managing_Users"> Managing Users </a> - -A user is created by with the [[TWikiRegistration]] form. The process generates a topic in the %MAINWEB% web in the new user's [[WikiName]]. The default visitor name is %MAINWEB%.TWikiGuest. - -* Users can be authenticated using Basic Authentication or SSL. [[TWikiUserAuthentication]] is required in order to track user identities. - -<a name="ManagingGroups"></a> - -### <a name="Managing_Groups"> Managing Groups </a> - -Groups are defined by group topics in the <code>**%MAINWEB%**</code> web, like the %MAINWEB%.TWikiAdminGroup. To start a new group: - -1. **Create** a new topic with A name that ends in **Group**, <code>SomeGroup</code> -2. **Define** two variables: - * Set GROUP = < list of users and groups > - * Set ALLOWTOPICCHANGE = < list of users and groups > - -* GROUP is a comma-separated list of users and of other groups:<br /><code>** Set GROUP = %MAINWEB%.SomeUser, %MAINWEB%.OtherUser, %MAINWEB%.SomeOtherGroup**</code> - -* ALLOWTOPICCHANGE defines who is allowed to change the group topic; it is a comma delimited list of users and groups. You typically want to restrict that to the members of the group itself, so it should contain the name of the topic,<br /><code>** Set ALLOWTOPICCHANGE = %MAINWEB%.TWikiAdminGroup**</code><br /> for the TWikiAdminGroup topic. (This prevents users not in the group from editing the topic and from gaining unauthorized membership to the group.) - -## <a name="Restricting_Write_Access"> Restricting Write Access </a> - -You can define who is allowed to make changes to a web or a topic. - -### <a name="Deny_Editing_by_Topic"> Deny Editing by Topic </a> - -Denying editing of a topic also restricts attaching files to it; both privileges are assigned together. - -* Define one or both of these variables in a topic, preferably at the end of the page: - * Set DENYTOPICCHANGE = < list of users and groups > - * Set ALLOWTOPICCHANGE = < list of users and groups > - -* DENYTOPICCHANGE defines users or groups that **are not** allowed to make changes to the topic. It is a comma delimited list of users and groups. Example: <br /><code> \* Set DENYTOPICCHANGE = %MAINWEB%.SomeBadBoy, %MAINWEB%.SomeBadGirl, %MAINWEB%.SomeHackerGroup</code> - -* ALLOWTOPICCHANGE defines users or groups that **are** allowed to make changes to the topic. It is a comma delimited list of users and groups. Example: <br /><code> \* Set ALLOWTOPICCHANGE = %MAINWEB%.SomeGoodGuy, %MAINWEB%.SomeGoodGirl, %MAINWEB%.TWikiAdminGroup</code> - -* DENYTOPICCHANGE is evaluated before ALLOWTOPICCHANGE. Access is denied if the authenticated person is in the DENYTOPICCHANGE list, or not in the ALLOWTOPICCHANGE list. Access is granted in case DENYTOPICCHANGE and ALLOWTOPICCHANGE is not defined. - -### <a name="Deny_Editing_by_Web"> Deny Editing by Web </a> - -Restricting web-level editing blocks creating new topics, changing topics or attaching files. - -* Define one or both of these variable in the %WEBPREFSTOPIC% topic: - * Set DENYWEBCHANGE = < list of users and groups > - * Set ALLOWWEBCHANGE = < list of users and groups > - -The same rules apply as for restricting topics, with these additions: - -* DENYTOPICCHANGE (in topic) overrides DENYWEBCHANGE (in %WEBPREFSTOPIC%) -* ALLOWTOPICCHANGE (in topic) overrides ALLOWWEBCHANGE (in %WEBPREFSTOPIC%) - -## <a name="Restricting_Rename_Access"> Restricting Rename Access </a> - -You can define who is allowed to rename, move or delete a topic, or rename a web. - -### <a name="Deny_Renaming_by_Topic"> Deny Renaming by Topic </a> - -To allow a user to rename, move or delete a topic, they also need write (editing) permission. They also need write access to change references in referring topics. - -* Define one or both of these variables in a topic, preferably at the end of the topic: - * Set DENYTOPICRENAME = < list of users and groups > - * Set ALLOWTOPICRENAME = < list of users and groups > - -* DENYTOPICCRENAME defines users or groups that **are not** allowed to rename the topic. It is a comma delimited list of users and groups. Example: <br /><code> \* Set DENYTOPICRENAME = %MAINWEB%.SomeBadBoy, %MAINWEB%.SomeBadGirl, %MAINWEB%.SomeHackerGroup</code> - -* ALLOWTOPICRENAME defines users or groups that **are** allowed to rename the topic. It is a comma delimited list of users and groups. Example: <br /><code> \* Set ALLOWTOPICRENAME = %MAINWEB%.SomeGoodGuy, %MAINWEB%.SomeGoodGirl, %MAINWEB%.TWikiAdminGroup</code> - -* DENYTOPICRENAME is evaluated before ALLOWTOPICRENAME. Access is denied if the authenticated person is in the DENYTOPICRENAME list, or not in the ALLOWTOPICRENAME list. Access is granted in case DENYTOPICRENAME and ALLOWTOPICRENAME is not defined. - -### <a name="Deny_Renaming_by_Web"> Deny Renaming by Web </a> - -You can define restrictions of who is allowed to rename a %WIKITOOLNAME% web. - -* Define one or both of these variable in the %WEBPREFSTOPIC% topic: - * Set DENYWEBRENAME = < list of users and groups > - * Set ALLOWWEBRENAME = < list of users and groups > - -The same rules apply as for topics, with these additions: - -* DENYTOPICRENAME (in topic) overrides DENYWEBRENAME (in %WEBPREFSTOPIC%) -* ALLOWTOPICRENAME (in topic) overrides ALLOWWEBRENAME (in %WEBPREFSTOPIC%) - -## <a name="Restricting_Read_Access"> Restricting Read Access </a> - -You can define restrictions of who is allowed to view a %WIKITOOLNAME% web. - -* Define one or both of these variable in the %WEBPREFSTOPIC% topic: - * Set DENYWEBVIEW = < list of users and groups > - * Set ALLOWWEBVIEW = < list of users and groups > - -### <a name="Known_Issues"> Known Issues </a> - -* The view restriction is not suitable for very sensitive content since there is a way to circumvent the read access restriction. -* Read access restriction only works if the view script is authenticated, that means that users need to log on also just to read topics. [[TWikiInstallationGuide]] has more on Basic Authentication based on the <code>**.htaccess**</code> file. - -#### <a name="Selective_Unrestricted_Web_Acces"> Selective Unrestricted Web Access </a> - -* There is a workaround if you prefer to have unrestricted access to view topics located in normal webs, and to authenticate users only for webs where view restriction is enabled: - 1. **Omit** the <code>**view**</code> script from the `.htaccess` file. - 2. **Enable** the <code>**$doRememberRemoteUser**</code> flag in <code>**lib/TWiki.cfg**</code> as described in [[TWikiUserAuthentication]]. %WIKITOOLNAME% will now remember the IP address of an authenticated user. - 3. **Copy** the <code>**view**</code> script to <code>**viewauth**</code> (or better, create a symbolic link) - 4. **Add** <code>**viewauth**</code> to the list of authenticated scripts in the .htaccess file. - * When a user accesses a web where you enabled view restriction, %WIKITOOLNAME% will redirect from the `view` script to the `viewauth` script once (this happens only if the user has never edited a topic). Doing so will ask for authentication. The `viewauth` script shows the requested topic if the user could log on and if the user is authorized to see that web. - * If you enable view restriction for a web, it is recommended to restrict search "all webs" from searching this web. Enable this restriction with the <code>**NOSEARCHALL**</code> variable in its [[WebPreferences]], like: - * Set NOSEARCHALL = on - * It is not recommended to restrict view access to individual topics since all content is searchable _within_ a web. - -## <a name="Hiding_Control_Settings"> Hiding Control Settings </a> - -* %T% To hide access control settings from normal browser viewing, place them in comment markers. - -> <!-- -> -> <br /> -> -> Set -> -> DENYTOPICCHANGE = Main.SomeGroup<br /> --> - -<a name="SuperAdminGroup"></a> - -## <a name="The_SuperAdminGroup"> The SuperAdminGroup </a> - -By mistyping a user or group name in the ALLOWTOPICCHANGE setting, it's possible to lock a topic so that it no-one can edit it from a browser. To avoid this: - -* Set the `$superAdminGroup` variable in `lib/TWiki.cfg` to the name of a group of users that are always allowed to edit/view topics. - -> $superAdminGroup = "TWikiAdminGroup"; - -* The default setting is not to have superusers. - --- [[Main/MikeMannix]] - 02 Dec 2001 diff --git a/TWiki/TWikiBigDiff.mdwn b/TWiki/TWikiBigDiff.mdwn deleted file mode 100644 index f1b292b4..00000000 --- a/TWiki/TWikiBigDiff.mdwn +++ /dev/null @@ -1,33 +0,0 @@ -I would like to see only the difference between two revisions from the [[WebChanges]] page. - --- [[Main/JamesAMorrison]] - 16 Jan 2003 - -Congratulations on your first Wiki page. I'll see what I can do! This would have to be some kind of nested search. - -You can also hack a URL to a non-existing page. It will prompt to create it and you just click create. I should have told you that way to create a page as well but I forgot about it. :-) - --- [[Main/GrantBow]] - 16 Jan 2003 - -Maybe you're a bit confused, James. The [[WebChanges]] topic lists what topics in a web that have been changed recently (maybe the "recently" needs a bit of modification?). I think you're after the "View Diffs" function, which currently shows diffs from the 5 last revisions of a selected topic. This can, of course, be changed with the GNUskin. - -If you check out my home topic, | [[Main/JoachimNilsson]] | [[WIKIHOMEURLMainJoachimNilssonrawon]] |, you can see how I used a preference variable to change the displayed number of revisions to 2. Personal settings can always be made in the home topic like this. For **inspiration** you can look at the [[WebPreferences]] and the [[TWikiPreferences]]. - --- [[Main/JoachimNilsson]] - 16 Jan 2003 - -I don't think he's confused, it's just a new feature. Our discussion also generated the [[TWikiChanges]] topic. We talked about this on IRC a bit. Perhaps TWiki:Codev/GlobalChangesList might be of help. - --- [[Main/GrantBow]] - 16 Jan 2003 - -I don't understand, but I'll start reading again to see what it is you two are talking about ... - -... is it that James wants to see _"the changes to the Wiki since I last looked"_? - --- [[Main/JoachimNilsson]] - 16 Jan 2003 - -Sorry, I need to read more closely. He asked me for a page that has the diffs for the entire website. I created a 7x [[WebChanges]] file in [[TWikiChanges]] (still sorted by web). Then we talked about a page that had the actual diffs for each page in one big page, a global diff file for the site. RSS might be the right answer for that kind of thing. It was a short IRC discussion and I'm probably (unduly) filling in the blanks. - -What James wrote was "only the difference between two revisions from the [[WebChanges]] page" which is indeed confusing. I don't think James understands that the [[WebChanges]] page is the result of a real-time search. If the [[WebChanges]] page had revisions, then it might give a global diff for the website. - -James, so now I don't know what you really wanted. Can you please clarify? - --- [[Main/GrantBow]] - 17 Jan 2003 diff --git a/TWiki/TWikiCategoryTable.mdwn b/TWiki/TWikiCategoryTable.mdwn deleted file mode 100644 index b7628f9d..00000000 --- a/TWiki/TWikiCategoryTable.mdwn +++ /dev/null @@ -1 +0,0 @@ -**_Note:_** This feature has been replaced by: [[TWikiForms]] diff --git a/TWiki/TWikiChanges.mdwn b/TWiki/TWikiChanges.mdwn deleted file mode 100644 index b6d4020f..00000000 --- a/TWiki/TWikiChanges.mdwn +++ /dev/null @@ -1 +0,0 @@ -%SEARCH\{".\*" web="ALL" regex="on" nosearch="on" order="modified" reverse="on" limit="50"\}% diff --git a/TWiki/TWikiContributor.mdwn b/TWiki/TWikiContributor.mdwn deleted file mode 100644 index 2cc59cdb..00000000 --- a/TWiki/TWikiContributor.mdwn +++ /dev/null @@ -1,20 +0,0 @@ -# <a name="TWiki_Contributor"> TWiki Contributor </a> - -A TWiki contributor is a person devoting his/her time to contribute on the development of the Open Source project TWiki, hosted at <http://TWiki.org/> . It is defined as a person who: - -* has contributed code that was accepted into the TWiki distribution, or -* has considerably contributed to the TWiki documentation. - -I would like to take this opportunity to express my appreciation to all who contributed ideas, code, fixes and documentation. - -## <a name="List_of_contributors"> List of contributors </a> - -%SEARCH\{"TWiki+Contributor" regex="on" nosummary="on" nosearch="on" \}% - -**_Note:_** Please contact a TWiki:Codev.CoreTeam member in case you contributed to TWiki and your name is not on this list! - -## <a name="List_of_contributions"> List of contributions </a> - -* See [[TWikiHistory]] - --- [[PeterThoeny]] diff --git a/TWiki/TWikiDiscuss.mdwn b/TWiki/TWikiDiscuss.mdwn deleted file mode 100644 index 0555f0bc..00000000 --- a/TWiki/TWikiDiscuss.mdwn +++ /dev/null @@ -1,28 +0,0 @@ -# <a name="Wiki_Meta_Discussions"> Wiki Meta Discussions </a> - -Old discussions: [[WIKIHOMEURLTWikiTWikiDiscussrev120]] | [[WIKIHOMEURLTWikiTWikiDiscussrev144]] | [[WIKIHOMEURLTWikiTWikiDiscussrev161]] - -This is an area to talk about how the Hurd Wiki pages are put together, edited and arranged. Without organization the navigation of the site could become unusable. - -If you need anything server related done just send me, [[Main/JoachimNilsson]], an email. I'm available almost every waken hour. - -Please add your comments below and then your signature, Blog style. - -One thing though. Refactor _mercilessly_! :-) [Yes! [[Main/GrantBow]]] - --- [[Main/JoachimNilsson]] - 13 May 2002 - ----- - -Upgraded the Hurd Wiki to the latest [[GnuSkin]], 1.2. New features include: - -* Preview back. -* Better support for Interner Explorer (tested on 5.5 and 6.0) -* CSS updates - different color for visited links. -* and more ... - --- [[Main/JoachimNilsson]] - 02 Mar 2003 - -I just found TWiki:Plugins/TreePlugin which might be very useful in certain circumstances. I saw it used as an alternate view for [[WebIndex]] which makes total sense! I hope it can be installed someday when there is extra time. - --- [[Main/GrantBow]] - 01 May 2004 diff --git a/TWiki/TWikiDocGraphics.mdwn b/TWiki/TWikiDocGraphics.mdwn deleted file mode 100644 index 52c0f5a7..00000000 --- a/TWiki/TWikiDocGraphics.mdwn +++ /dev/null @@ -1,13 +0,0 @@ -# <a name="TWiki_Documentation_Graphics"> TWiki Documentation Graphics </a> - -> <img src="%ATTACHURLPATH%/8831.gif" width="88" height="31" alt="8831.gif" /> -> -> Temporary: standard 88x31px logo ID button: - -* Help: <br /><img src="%ATTACHURLPATH%/help.gif" width="16" height="16" alt="help.gif" /> - -* Tip: <br /><img src="%ATTACHURLPATH%/tip.gif" width="16" height="16" alt="tip.gif" /> - -* Warning: <br /><img src="%ATTACHURLPATH%/warning.gif" width="16" height="16" alt="warning.gif" /> - -<img src="%ATTACHURLPATH%/warning.gif" width="16" height="16" alt="warning.gif" /><img src="%ATTACHURLPATH%/tip.gif" width="16" height="16" alt="tip.gif" /><img src="%ATTACHURLPATH%/help.gif" width="16" height="16" alt="help.gif" /> diff --git a/TWiki/TWikiDocGraphics/8831.gif b/TWiki/TWikiDocGraphics/8831.gif Binary files differdeleted file mode 100644 index 08d0b23e..00000000 --- a/TWiki/TWikiDocGraphics/8831.gif +++ /dev/null diff --git a/TWiki/TWikiDocGraphics/help.gif b/TWiki/TWikiDocGraphics/help.gif Binary files differdeleted file mode 100644 index be8659e1..00000000 --- a/TWiki/TWikiDocGraphics/help.gif +++ /dev/null diff --git a/TWiki/TWikiDocGraphics/tip.gif b/TWiki/TWikiDocGraphics/tip.gif Binary files differdeleted file mode 100644 index 0705fe35..00000000 --- a/TWiki/TWikiDocGraphics/tip.gif +++ /dev/null diff --git a/TWiki/TWikiDocGraphics/warning.gif b/TWiki/TWikiDocGraphics/warning.gif Binary files differdeleted file mode 100644 index dad469ac..00000000 --- a/TWiki/TWikiDocGraphics/warning.gif +++ /dev/null diff --git a/TWiki/TWikiDocumentation.mdwn b/TWiki/TWikiDocumentation.mdwn deleted file mode 100644 index dab31872..00000000 --- a/TWiki/TWikiDocumentation.mdwn +++ /dev/null @@ -1,85 +0,0 @@ -<font>TWiki Reference Manual</font><font> (01-Dec-2001)</font> - -This page contains all documentation topics as one long, complete reference sheet.<br />**_Doubleclick anywhere_** to return to the top of the page. - -%TOC\{depth="5"\}% - -**_Note:_** Read the most up to date version of this document at <http://TWiki.org/cgi-bin/view/TWiki/TWikiDocumentation> - -**_Related Topics:_** [[TWikiSite]], [[TWikiHistory]], [[TWikiPlannedFeatures]], [[TWikiEnhancementRequests]] - ----- - -%INCLUDE\{"TWikiImplementationNotes"\}% - ----- - -%INCLUDE\{"TWikiInstallationGuide"\}% - ----- - -%INCLUDE\{"TWikiUpgradeGuide"\}% - ----- - -%INCLUDE\{"TWikiUserAuthentication"\}% - ----- - -%INCLUDE\{"TWikiAccessControl"\}% - ----- - -%INCLUDE\{"TextFormattingRules"\}% - ----- - -%INCLUDE\{"TWikiVariables"\}% - ----- - -%INCLUDE\{"FileAttachment"\}% - ----- - -%INCLUDE\{"TWikiForms"\}% - ----- - -%INCLUDE\{"TWikiTemplates"\}% - ----- - -%INCLUDE\{"TWikiSkins"\}% - ----- - -%INCLUDE\{"FormattedSearch"\}% - ----- - -%INCLUDE\{"TWikiMetaData"\}% - ----- - -%INCLUDE\{"TWikiPlugins"\}% - ----- - -%INCLUDE\{"TWikiSiteTools"\}% - ----- - -%INCLUDE\{"ManagingTopics"\}% - ----- - -%INCLUDE\{"ManagingWebs"\}% - ----- - -%INCLUDE\{"AppendixFileSystem"\}% - ----- - -%INCLUDE\{"TWikiHistory"\}% diff --git a/TWiki/TWikiDownload.mdwn b/TWiki/TWikiDownload.mdwn deleted file mode 100644 index f16ac0b1..00000000 --- a/TWiki/TWikiDownload.mdwn +++ /dev/null @@ -1,11 +0,0 @@ -## <a name="FAQ_"> </a> FAQ: - -I would like to install TWiki on my server. Can I get the source? - -## <a name="Answer_"> Answer: </a> - -TWiki is distributed under the [[GnuGeneralPublicLicense]]. You can request the source from <http://TWiki.org/download.html>. - -**_Back to:_** [[TWikiFAQ]] - --- [[Main/PeterThoeny]] - 27 Nov 2000 <br /> diff --git a/TWiki/TWikiEnhancementRequests.mdwn b/TWiki/TWikiEnhancementRequests.mdwn deleted file mode 100644 index a6c4a308..00000000 --- a/TWiki/TWikiEnhancementRequests.mdwn +++ /dev/null @@ -1,9 +0,0 @@ -* Please add enhancement request at the TWiki home at <http://TWiki.org/cgi-bin/view/Codev/FeatureEnhancementRequest> - -**Related Topics** - -* [[TWikiHistory]] has a list of added features in TWiki. -* [[TWikiPlannedFeatures]] has a list of planned features. -* [[TWikiDocumentation]] is the implementation documentation. - --- [[Main/PeterThoeny]] - 12 May 2000 <br /> diff --git a/TWiki/TWikiFAQ.mdwn b/TWiki/TWikiFAQ.mdwn deleted file mode 100644 index 00602ac6..00000000 --- a/TWiki/TWikiFAQ.mdwn +++ /dev/null @@ -1,26 +0,0 @@ -# <a name="Frequently_Asked_Questions_About"> Frequently Asked Questions About %WIKITOOLNAME% </a> - -This is a real FAQ, and also a demo of one easily implemented knowledge base solution. See how it's done, click <code>**[Edit]**</code>. - -%SEARCH\{ "Back to\\:\_\_ [[TWikiFAQ]]" casesensitive="on" regex="on" nosearch="on" nototal="on"\}% - -**_NOTE:_** The most recent version of this FAQ is at TWiki:TWiki/TWikiFAQ. - -## <a name="Submit_a_new_FAQ"> </a> Submit a new FAQ - -Please ask support questions in the TWiki:Support web. The FAQs are here for frequently asked questions **_including_** answers. - -<form action="%SCRIPTURLPATH%/edit%SCRIPTSUFFIX%/%WEB%/"> New FAQ topic: (Use a name in [[TWiki/WikiNotation]]) <br /><input name="topic" size="32" type="text" /> <input name="onlywikiname" type="hidden" value="on" /> <input name="templatetopic" type="hidden" value="TWikiFaqTemplate" /> <input type="submit" value="Create Topic" /><br /><strong><em>NOTE:</em></strong> New FAQ topics are based on the [[TWikiFaqTemplate]]</form> - -## <a name="More_sources_"> More sources... </a> - -Other places where you can find answers to your questions: - -* [[TWikiDocumentation]]: All you need to know to install and configure %WIKITOOLNAME% -* [[TWikiTutorial]]: Get a jump start on using TWiki -* [[GoodStyle]]: Things to consider when changing text -* [[WikiSyntax]], [[TextFormattingRules]]: A quick one-two guide to TWiki shorthand basics -* [[TextFormattingFAQ]]: Answers to frequently asked questions about text styling in TWiki -* If you can't find an answer, ask a question - post it in the TWiki:Support web - --- [[PeterThoeny]] - 26 Nov 2000 <br /> -- [[MikeMannix]] - 13 Sep 2001 <br /> diff --git a/TWiki/TWikiFaqTemplate.mdwn b/TWiki/TWikiFaqTemplate.mdwn deleted file mode 100644 index ff525cfd..00000000 --- a/TWiki/TWikiFaqTemplate.mdwn +++ /dev/null @@ -1,7 +0,0 @@ -## <a name="FAQ_"> </a> FAQ: - -## <a name="Answer_"> Answer: </a> - -**_Back to:%NOP%_** [[TWikiFAQ]] - --- %WIKIUSERNAME% - %DATE% <br /> diff --git a/TWiki/TWikiForms.mdwn b/TWiki/TWikiForms.mdwn deleted file mode 100644 index 0fe0b122..00000000 --- a/TWiki/TWikiForms.mdwn +++ /dev/null @@ -1,223 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_Forms"> TWiki Forms </a> - -_Form-based input in topics, with name/value pairs stored as Meta Data variables; multiple forms per web & topic_ - -## <a name="Overview"> Overview </a> - -By adding form-based input to free-form content, you can structure topics with unlimited, easily searchable categories. When forms are enabled for a web and selected in a topic, the form appears in edit mode, and the contents are rendered as a table when viewing the actual page. When editing, can switch forms, if more than one is defined, or remove forms entirely. Form input values are stored as [[TWikiMetaData]]; all data is saved. - -Form Templates replace TWikiCategory Tables from the 01-Dec-2000 version of TWiki. - -<a name="FormsVsCategoryTables"></a> - -## <a name="Main_Changes_from_Category_Table"> Main Changes from Category Tables </a> - -Form Templates more powerful, flexible replacement for the original TWikiCategoryTable. Data from existing category tables can be imported directly. - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th align="center" bgcolor="#99CCCC"><strong>Form Templates</strong></th> - <th align="center" bgcolor="#99CCCC"><strong>Category Tables</strong></th> - </tr> - <tr> - <td align="center"> defined in topics </td> - <td align="center"> defined in templates </td> - </tr> - <tr> - <td align="center"> many forms per web </td> - <td align="center"> one table per web </td> - </tr> - <tr> - <td align="center"> saved as Meta Data </td> - <td align="center"> saved as HTML </td> - </tr> - <tr> - <td align="center"><strong>Change</strong> &amp; <strong>Add Form</strong> buttons </td> - <td align="center"><strong><nop>UseCategory</nop></strong> radio button </td> - </tr> -</table> - -### <a name="Importing_Category_Table_Data"> Importing Category Table Data </a> - -On upgrading from the previous TWiki, a Form Template topic has to be built for each web that used a Category Table, recreating the fields and values from the old <code>**twikicatitems.tmpl**</code>. The replacement Form Template must be set as the first item in the [[WebPreferences]] variable `WEBFORMS`. If missing, pages will display, but attempting to edit results in an error message. - -The new Form Template system should work with old Category Table data with no special conversion. Data is assigned to Meta variables the first time an imported topic is edited and saved in the new system. - -**_NOTE:_** If things aren't working correctly, there may be useful entries in `data/warning.txt`. - -## <a name="Defining_a_Form_Template"> Defining a Form Template </a> - -A Form Template is simply a page containing your form, defined in a table where each row is one form field. - -### <a name="Form_Template_Elements"> Form Template Elements </a> - -* **form template** - a set of fields defining a form (replaces _category table definition_) - * A web can use one or more form templates. -* **form** - A topic containing additional meta-data (besides the free form TEXTAREA) which categorizes the content. (replaces _category table_) - * A topic has zero or one of the defined forms. So there are topics with a form or without. -* **form field** - a named item in a form (replaces _category item name_) -* **field type** - selects the INPUT type: - * **select** - drop-down menu or scrollable box - * **checkbox** - one or more checkboxes - * **checkbox+buttons** - one or more checkboxes, plus **Set** and **Clear** buttons - * **radio** - one or more radio buttons - * **text** - a one-line text field - * **textarea** - a text box; size is 40x10 (columns x rows) -* **field value** - one or more values from a fixed set (select, checkbox, radio type) or free-form (text). (replaces _category item value_) - -### <a name="Defining_a_Form_in_One_Topic"> Defining a Form in One Topic </a> - -1. Create a new topic with your Form name: MyForm, ExpenseReport, InfoCategory, RecordReview, whatever you need. -2. Create a TWiki table, with each column representing one element of an entry field: Name, Type, Size, Values, and Tooltip msessage (see sample below). -3. For each field, fill in a new line; for the type of field, select from the list. -4. Save the topic. - -> **Example: WebForm from the TWiki.Know web** -> -> | *Name* | *Type* | *Size* | *Values* | *Tooltip message* | -> | Know.TopicClassification | select | 1 | Know.NoDisclosure, -> Know.PublicSupported, Know.PublicFAQ | blah blah... | -> | Know.OperatingSystem | checkbox | 3 | Know.OsHPUX, Know.OsLinux, -> Know.OsSolaris, Know.OsWin | blah blah... | -> | Know.OsVersion | text | 16 | | blah blah... | -> -> <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <th bgcolor="#99CCCC"><strong>Name</strong></th> -> <th bgcolor="#99CCCC"><strong>Type</strong></th> -> <th bgcolor="#99CCCC"><strong>Size</strong></th> -> <th bgcolor="#99CCCC"><strong>Values</strong></th> -> <th bgcolor="#99CCCC"><strong>Tooltip message</strong></th> -> </tr> -> <tr> -> <td>[[Know/TopicClassification]]</td> -> <td> select </td> -> <td align="center"> 1 </td> -> <td>[[Know/NoDisclosure]], [[Know/PublicSupported]], [[Know/PublicFAQ]]</td> -> <td> blah blah... </td> -> </tr> -> <tr> -> <td>[[Know/OperatingSystem]]</td> -> <td> checkbox </td> -> <td align="center"> 3 </td> -> <td>[[Know/OsHPUX]], [[Know/OsLinux]], [[Know/OsSolaris]], [[Know/OsWin]]</td> -> <td> blah blah... </td> -> </tr> -> <tr> -> <td>[[Know/OsVersion]]</td> -> <td> text </td> -> <td align="center"> 16 </td> -> <td> </td> -> <td> blah blah... </td> -> </tr> -> </table> - -### <a name="Defining_a_Form_with_Multiple_To"> Defining a Form with Multiple Topics </a> - -The Form Template can also be defined in an alternative way by using more then one topic: - -* A Form Template topic defines the Form. -* Fields that have more then one value - radio, select, checkbox - can be defined in individual field value topics. - -> **Example: WebFormTemplate** -> -> * Know.WebFormTemplate Form main definition: <br /> <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <th bgcolor="#99CCCC"><strong>Name</strong></th> -> <th bgcolor="#99CCCC"><strong>Type</strong></th> -> <th bgcolor="#99CCCC"><strong>Size</strong></th> -> <th bgcolor="#99CCCC"><strong>Values</strong></th> -> <th bgcolor="#99CCCC"><strong>Tooltip message</strong></th> -> </tr> -> <tr> -> <td>[[Know/TopicClassification]]</td> -> <td> select </td> -> <td> 1 </td> -> <td align="center"> ... </td> -> <td> blah blah... </td> -> </tr> -> <tr> -> <td>[[Know/OperatingSystem]]</td> -> <td> checkbox </td> -> <td> 3 </td> -> <td align="center"> ... </td> -> <td> blah blah... </td> -> </tr> -> <tr> -> <td>[[Know/OsVersion]]</td> -> <td> text </td> -> <td> 16 </td> -> <td align="center"> ... </td> -> <td> blah blah... </td> -> </tr> -> </table> -> -> * Know.TopicClassification field value definition: <br /> <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <th bgcolor="#99CCCC"><strong>Name</strong></th> -> <th bgcolor="#99CCCC"><strong>Type</strong></th> -> <th bgcolor="#99CCCC"><strong>Tooltip message</strong></th> -> </tr> -> <tr> -> <td>[[Know/NoDisclosure]]</td> -> <td> option </td> -> <td> blah blah... </td> -> </tr> -> <tr> -> <td>[[Know/PublicSupported]]</td> -> <td> option </td> -> <td> blah blah... </td> -> </tr> -> <tr> -> <td>[[Know/PublicFAQ]]</td> -> <td> option </td> -> <td> blah blah... </td> -> </tr> -> </table> - -* **Implementation Notes:** This format allows you to define field items with or without [[TWiki/WikiNames]], depending on your needs. - * The topic can be protected in the usual manner so that not everybody can change the form template - see [[TWikiAccessControl]] - * <code>[[...]]</code> links can be used for force a link, at present <code>[[...]\[...]]</code> format is not supported. - * The "Tooltip message" column is used as a tool tip for the field name (only if field name is a [[TWiki/WikiName]]) - you only see the tooltip on edit. - * The first item in the list is the default item. Alternative initial values can be given in a topic template such as `WebTopicEditTemplate` or using field=value or for checkboxes field=1. - * The topic definition is not read when a topic is viewed. - -## <a name="Enabling_Forms_by_Web"> Enabling Forms by Web </a> - -Forms are enabled on a per web basis. The <code>**WEBFORMS**</code> variable in [[WebPreferences]] is optional and defines a list of possible Form Templates. Example: - -* Set WEBFORMS = BugForm, FeatureForm, BookLoanForm - -* With `WEBFORMS` enabled, an extra button is added to the edit view. If the topic doesn't have a Form, an **Add Form** button appears at the end of the topic. If a Form is present, a **Change** button appears in the top row of the Form. The buttons open a screen that enables selection of a form specified in `WEBFORMS`, or the **No form** option. - -* A default Form Template (new topics get this default form) can be provided by creating the `WebTopicEditTemplate` topic in a web and adding a form to it. Initial Form values can be set there. - -* Additionally a new topic can be given a Form using the `formtemplate` parameter in the URL. Initial values can then be provided in the URLs or as form values: - * other than checkboxes: `name`, ex: `?BugPriority=1` - * checkbox: `namevalue=1`, ex: `?ColourRed=1`. <br /> Boxes with a tick must be specified. - -## <a name="Including_Forms_in_New_Topics"> Including Forms in New Topics </a> - -When you create a new topic in a web that has the WEBFORMS Preferences variable set, an **Add Form** button appears at the bottom of the page. You can start all new topics with forms enabled, and pre-select a form if there's more than one available: - -1. **Edit** the [[WebTopicEditTemplate]] topic, adding the name of an available Form. -2. **Create** a new topic to check - the Form should appear with values set. - * Click **Change** to switch or remove Forms. - -A form embedded in a topic also appears in a new topic. This is done by specifying the `formtemplate` parameter in the URL. - -## <a name="Setting_Up_Multiple_Form_Options"> Setting Up Multiple Form Options </a> - -* The optional <code>**WEBFORMS**</code> variable defines alternative Form Templates that can be selected by pressing **Change** in edit mode. - -* A Template topic can use any Form Template. - -* New topics with a Form are created by simple HTML forms asking for a topic name. For example, you can have a <code>SubmitExpenseReport</code> topic where you can create new expense reports - a <code>SubmitVacationRequest</code> topic and so on. These can specify the required template topic with its associated Form. - -## <a name="Form_Template_Data_Storage"> Form Template Data Storage </a> - -The Form Template topic name, fields and values are stored as [[TWikiMetaData]]. The order of field/value pairs in the Meta Data is the same as in the Template. - --- [[JohnTalintyre]] - 16 Aug 2001 <br /> -- [[Main/MikeMannix]] - 03 Dec 2001 diff --git a/TWiki/TWikiGlossary.mdwn b/TWiki/TWikiGlossary.mdwn deleted file mode 100644 index 3c658f48..00000000 --- a/TWiki/TWikiGlossary.mdwn +++ /dev/null @@ -1,31 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_Glossary"> TWiki Glossary </a> - -TWiki uses a handful of general computer and Internet terms in a TWiki-specific way. This _could_ get confusing, but it actually works out fine in use. The TWikiGlossary is also a quick way to get familiar with the overall TWiki set-up... - -**_(Under...construction: this is a rough draft)_** - -**Attachment** _aka_ **File Attachment** - upload files by browser and attach them to any page, where they can be viewed, edited, downloaded; accessed by clicking **Attach** at page bottom (%TWIKIWEB%.FileAttachments) - -**Plugin** - a TWiki feature add-on; a Perl module that enhances TWiki, through the Plugin API spec; named `<_>Plugin.pm`, ex: `SomePlugin.pm` ([[TWikiDocumentation]]) - -**Plugin API** - specs for building TWiki Plugins with Perl modules ([[TWikiDocumentation]]) - -**Preference** - a customizable TWiki parameter; settings site-wide, by the web, by the topic on %TWIKIWEB%.TWikiPreferences and [[WebPreferences]] pages, also on Plugins, user and regular topic pages. - -**site** - a TWiki installation consisting of one or more TWiki _webs_ - -<a name="TWikiTopic"></a> **topic** _aka_ **WikiTopic** - a single TWiki page, it has a %TWIKIWEB%.WikiName that's unique within its home _web_ - -**TWiki** - based on "Wiki", from the original WikiWikiWeb, first OF this style of edit-anything-anywhere Web environment; by chance, also the name of a robot (as in, the robo-head in the TWiki logo) in the old _Buck Rogers_ TV series (%TWIKIWEB%.TWikiSite) - -**TWiki.org (twiki.org)** - official home site, center of all development, housed on SourceForge.com - -**variable** - text-strings of the form `%VARIABLE%` that are expanded on the fly into text, image, or any other type of embedded content; predefined variables are coded into the main TWiki package, Plugins variables, and user-specified variables are created in [[TWiki/TWikiPreferences]], [[WebPreferences]], or single topics - -<a name="TWikiWeb"></a> **web** - with a small "w", as opposed to the Web, World Wide; a collection of TWiki topics under a common name; topics share Preference settings, disk file structure, and are handled as a group by search - -**WikiTopic** - _see: topic_ - --- [[Main/MikeMannix]] - 09 Sep 2001 <br /> diff --git a/TWiki/TWikiHistory.mdwn b/TWiki/TWikiHistory.mdwn deleted file mode 100644 index 2a435019..00000000 --- a/TWiki/TWikiHistory.mdwn +++ /dev/null @@ -1,267 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="Appendix_B_TWiki_Development_Tim"> Appendix B: TWiki Development Timeline </a> - -## <a name="01_Dec_2001_Release_Athens_"> 01-Dec-2001 Release (Athens) </a> - -* **25 Oct 2001** - [[PeterThoeny]] - * Added [[FormattedSearch]] to <code>%SEARCH\{\}%</code> variable for database like reporting. - -## <a name="01_Sep_2001_Release"> 01-Sep-2001 Release </a> - -* **30 Aug 2001** - [[JohnTalintyre]] - * Easier install for Windows, including auto detection in `TWiki.cfg` -* **30 Aug 2001** - [[JohnTalintyre]] - * Ability to move attachments between topics, see [[FileAttachments]] -* **21 Aug 2001** - [[PeterThoeny]] - * Convert to XHTML 1.0 function: first step to XHTML-ifying TWiki -* **26 Jun 2001** - [[JohnTalintyre]] - * Category information to forms using the [[TWikiMetaData]] format, see [[TWikiForms]] -* **07 Jun 2001** - [[PeterThoeny]] - * New topic templates as topics instead of templates. Customize by editing the topic. Retired `notedited.tmpl`, `notext.tmpl` and `notwiki.tmpl` templates. More in [[TWikiTemplates]]. -* **07 Jun 2001** - [[PeterThoeny]] - * New <code>%TOPICLIST\{"format"\}%</code> and <code>%WEBLIST\{"format"\}%</code> variables to get a formatted topic index and web index, respectively. More in [[TWikiVariables]]. -* **01 Jun 2001** - [[PeterThoeny]] - * New <code>%URLPARAM\{"name"\}%</code> variable to query URL parameters. More in [[TWikiVariables]]. -* **01 Jun 2001** - [[AndreaSterbini]] - * API to extend TWiki, see [[TWikiPlugins]] -* **01 Jun 2001** - [[KlausWriessnegger]], [[AndreaSterbini]] - * Forms to change/reset/install passwords, see [[ChangePassword]] & [[ResetPassword]] -* **01 May 2001** - [[AndreaSterbini]] - * The %MAINWEB%.TWikiAdminGroup (or other group) can be enabled as a [[TWikiAccessControl]]. Members have browser edit access to _all_ locked topics. -* **01 May 2001** - [[JohnTalintyre]] - * Meta information format, see [[TWikiMetaData]] -* **01 May 2001** - [[JohnTalintyre]] - * Attachment under revision control See [[FileAttachment]] -* **01 May 2001** - [[JohnTalintyre]] - * Ability to rename/move topics, [[ManagingTopics]] -* **27 Mar 2001** - [[PeterThoeny]] - * The table syntax has been enhanced to (i) render <code>**| \*bold\* |**</code> cells as table headers, (ii) render space padded cells <code>**| center aligned |**</code> and <code>**| right aligned |**</code>, (iii) span multiple columns using <code>**| empty cells |||**</code>. More in [[TextFormattingRules]]. -* **25 Mar 2001** - [[PeterThoeny]] - * Security fix Questionable files like PHP scripts (executables) and <code>**.htaccess**</code> files that are attached to a topic get a <code>**.txt**</code> suffix appended to the file name. See also TWiki:Codev/FileAttachmentFilterSecurityAlert -* **28 Feb 2001** - [[AndreaSterbini]], [[PeterThoeny]] - * New Wiki rule for headings, i.e. `---++ My Title`; and new <code>%TOC%</code> variable to build a table of content from headings in a topic. More in [[TWikiVariables]]. -* **28 Feb 2001** - [[PeterThoeny]] - * New Wiki rule to specify arbitrary text for external links (i.e. <code>[[http://TWki.org]\[TWiki]]</code>) and internal links (i.e <code>[[WikiSyntax]\[syntax]]</code>). More in [[TWikiVariables]]. -* **28 Feb 2001** - [[PeterThoeny]] - * New Wiki rule for named anchors, e.g. links within a topic. Define a named anchor with `#MyAnchor` at the beginning of a line, and link to it with <code>[[#MyAnchor]]</code>. More in [[TWikiVariables]]. -* **25 Feb 2001** - [[NicholasLee]], [[PeterThoeny]] - * Use `Net::SMTP` module instead of `sendmail` if installed. -* **01 Feb 2001** - [[PeterThoeny]] - * Added `<verbatim>` ... `</verbatim>` tags to show source code "as is". Unlike the `<pre>` ... `</pre>` tags, it also shows `<`, `>`, `&` characters "as is". -* **01 Feb 2001** - [[PeterThoeny]] - * Fixed TWiki:Codev/CreateLinkToAttachedFileBug. -* **21 Jan 2001** - [[PeterThoeny]] - * Added a "Minor change, don't notify" checkbox in preview. More in [[DontNotify]]. -* **21 Jan 2001** - [[PeterThoeny]] - * Added Bold Fixed formatting using double-equal signs, e.g. write <code>==Bold Fixed==</code> to get <code>**Bold Fixed**</code>. -* **20 Jan 2001** - [[PeterThoeny]] - * Format changed of <code>%GMTIME\{"..."\}%</code> and <code>%SERVERTIME\{"..."\}%</code> variables. Format is now `"$hour:$min"` instead of `"hour:min"`. More in [[TWikiVariables]]. **_Attention:_** Check your existing topics when you upgrade TWiki! -* **18 Jan 2001** - [[PeterThoeny]] - * [[WebChanges]], [[WebSearch]] and e-mail notification indicate also the revision number of a topic (i.e. <u>18 Jan 2001 16:43 r1.5</u>), or NEW for a new topic (i.e. i.e. <u>18 Jan 2001 16:43 **NEW**</u>). -* **16 Jan 2001** - [[PeterThoeny]] - * New variable <code>%STARTINCLUDE%</code> and <code>%STOPINCLUDE%</code> variables to control what gets included of a topic. More in [[TWikiVariables]]. -* **16 Jan 2001** - [[PeterThoeny]] - * TWiki skins Define a different page layout with a customized header and footer layout, i.e. a `print` skin for a printable view of a topic. More in [[TWikiSkins]] and TWiki:Codev/TWikiSkins. -* **07 Jan 2001** - [[StanleyKnutson]] - * Better error handling when saving a topic. -* **05 Jan 2001** - [[PeterThoeny]] - * View authorization based on groups. Define who is allowed to see a TWiki web. More in [[TWikiAccessControl]] and TWiki:Codev/AuthenticationBasedOnGroups. -* **05 Dec 2000** - [[PeterThoeny]] - * Improved include handling. Infinite recursion of includes are prevented; new variables <code>%BASEWEB%</code>, <code>%INCLUDINGWEB%</code>, <code>%BASETOPIC%</code> and <code>%INCLUDINGTOPIC%</code> to have more control over include handling. More in [[TWikiVariables]] and TWiki:Codev/IncludeHandlingImprovements. -* **03 Dec 2000** - [[PeterThoeny]] - * New `noheader="on"` switch in <code>%SEARCH\{...\}%</code> to suppress table header. More in [[TWikiVariables]]. - -## <a name="01_Dec_2000_Release"> 01-Dec-2000 Release </a> - -* **03 Nov 2000** - [[PeterThoeny]] - * Flag `$doHidePasswdInRegistration` in `wikicfg.pm` to hide plain text password in registration email. -* **01 Nov 2000** - [[PeterThoeny]] - * New variable <code>%VAR\{"NAME" web="Web"\}%</code> to get web specific preferences. More in [[TWikiVariables]]. -* **01 Nov 2000** - [[PeterThoeny]] - * Added a "Cancel" link in edit that releases the edit lock. -* **23 Oct 2000** - [[PeterThoeny]] - * Authorization based on groups. Define fine graned control who is allowed to change or create topics. More in [[TWikiAccessControl]] and TWiki:Codev/AuthenticationBasedOnGroups. -* **05 Oct 2000** - [[PeterThoeny]] - * Remember user by IP address so that `view` "knows" the user once authenticated in `edit`. More in [[TWikiUserAuthentication]]. -* **26 Sep 2000** - [[AlWilliams]], [[PeterThoeny]] - * Fixed TWiki:Codev/UppercaseAttachments bug and added `png` image support. -* **26 Sep 2000** - [[HaroldGottschalk]], [[AndreaSterbini]], [[PeterThoeny]] - * Allow nesting of variables, i.e. <code>%INCLUDE\{"%TWIKIWEB%.TWikiWebsTable"\}%</code>. More in TWiki:Codev/BetterTWikiTagTemplateProcessing. -* **20 Sep 2000** - [[ManpreetSingh]] - * New -q switch in `mailnotify` to suppress all normal output. -* **19 Sep 2000** - [[PeterThoeny]] - * Fixed TWiki:Codev/AttachedNotificationLinksBug. -* **18 Sep 2000** - [[ManpreetSingh]], [[PeterThoeny]] - * Added forced internal links. Write <code>[[text formatting FAQ]]</code> to get the link [[TextFormattingFAQ]] that points to topic [[TextFormattingFAQ]]. -* **19 Aug 2000** - [[PeterThoeny]] - * Ref-By link searches all webs (not just the current web.) -* **16 Aug 2000** - [[PeterThoeny]] - * New [[TWikiPreferences]] variables <code>%HTTP\_EQUIV\_ON\_VIEW%</code> , <code>%HTTP\_EQUIV\_ON\_EDIT%</code> and <code>%HTTP\_EQUIV\_ON\_PREVIEW%</code> that define the `<meta http-equiv="...">` meta tags for the TWiki templates. This can be used for example to set a document expiration time. -* **29 Jul 2000** - [[PeterThoeny]] - * New variables <code>%GMTIME\{"..."\}%</code> and <code>%SERVERTIME\{"..."\}%</code> . More in [[TWikiVariables]]. -* **23 Jul 2000** - [[PeterThoeny]] - * Changed include syntax from <code>%INCLUDE\{"Web/TopicName.txt"\}%</code> to <code>%INCLUDE\{"Web.TopicName"\}%</code> . Legacy syntax still supported. -* **23 Jul 2000** - [[PeterThoeny]] - * [[BookView]] search allows you show a set of topics for easy printing. -* **22 Jul 2000** - [[PeterThoeny]] - * More forgiving syntax for <code>\*bold\*, _italic_, \_\_bold italic\_\_</code> and <code>**fixed**</code> , where it is not necessary anymore to have a trailing space before `.,;:?!` characters. -* **22 Jul 2000** - [[PeterThoeny]] - * Split the TWiki.Main web into TWiki.Main (users, company data) and TWiki.TWiki (TWiki related documentation, registration) -* **07 Jul 2000** - [[PeterThoeny]] - * Added an "Release edit lock" checkbox in preview to let other people edit the topic immediately without the one hour lock. -* **07 Jul 2000** - [[PeterThoeny]] - * Fixed problem of losing carriage returns when editing topics with KDE KFM browser or W3M browser. -* **21 Jun 2000** - [[PeterThoeny]] - * Fixed problem that a page redirect on some server environments is not working (host name is needed in URL). -* **21 Jun 2000** - [[CrisBailiff]], [[PeterThoeny]] - * Fixed security issue to prevent a server side <code>%INCLUDE%</code> of arbitrary files. -* **29 May 2000** - [[PeterThoeny]] - * New <code>%GMTIME%</code> variable that shows the current GM time. -* **28 May 2000** - [[PeterThoeny]] - * Lock warning shows remaining lock time in minutes. -* **15 May 2000** - [[PeterFokkinga]] - * Each topic can have its own template file. [[TWikiTemplatesVer1]] has more. -* **02 May 2000** - [[KevinKinnell]], [[PeterThoeny]] - * Advanced search features like search multiple webs; sort by topic name / modified time / author; limit the number of results returned. More in [[TWikiVariables]]. - -## <a name="01_May_2000_Release"> 01-May-2000 Release </a> - -* **21 Apr 2000** - [[PeterThoeny]] - * New [[TWikiVariables]] <code>%HTTP\_HOST%</code> , <code>%REMOTE\_ADDR%</code> , <code>%REMOTE\_PORT%</code> and <code>%REMOTE\_USER%</code> . -* **21 Apr 2000** - [[JohnAltstadt]], [[PeterThoeny]] - * [[TWikiRegistration]] is done separately for Intranet use (depends on remote\_user) or Internet use (depends on .htpasswd file). -* **20 Mar 2000** - [[PeterThoeny]] - * Uploading a file (topic file attachment) will optionally create a link to the uploaded file at the end of the topic. The preference variable <code>%ATTACHLINKBOX%</code> controls the default state of the **_link_** check box in the attach file page. -* **11 Mar 2000** - [[PeterThoeny]] - * Better security with taint checking ( `Perl -T` option ) -* **25 Feb 2000** - [[PeterThoeny]] - * New preference variables <code>%EDITBOXWIDTH%</code> and <code>%EDITBOXHEIGHT%</code> to specify the edit box size. -* **25 Feb 2000** - [[PeterThoeny]] - * Edit preferences topics to set TWiki variables. There are three level of preferences Site-level ([[TWikiPreferences]]), web-level ([[WebPreferences]] in each web) and user-level preferences (for each of the [[Main/TWikiUsers]]). With this, discontinue use of server side include of `wikiwebs.inc` , `wikiwebtable.inc` , `weblist.inc` , `webcopyright.inc` and `webcolors.inc` files. -* **11 Feb 2000** - [[PeterThoeny]] - * New variable <code>%SCRIPTSUFFIX%</code> / $scriptSuffix containing an optional file extension of the TWiki Perl script. Templates have been changed to use this variable. This allows you to rename the Perl script files to have a file extension like for example ".cgi". -* **11 Feb 2000** - [[PeterThoeny]] - * New variable <code>%SCRIPTURLPATH%</code> / $scriptUrlPath containing the script URL without the domain name. Templates have been changed to use this variable instead of <code>%SCRIPTURL%</code> . This is for performance reasons. -* **07 Feb 2000** - [[PeterThoeny]] - * Changed the syntax for server side include variable from <code>%INCLUDE:"filename.ext"%</code> to <code>%INCLUDE\{"filename.ext"\}%</code> . (Previous syntax still supported. Change was done because of inline search syntax) -* **07 Feb 2000** - [[PeterThoeny]] - * Inline search. New variable <code>%SEARCH\{"str" ...\}%</code> to show a search result embedded in a topic text. [[TWikiVariables]] has more on the syntax. Inline search combined with the category table feature can be used for example to create a simple bug tracking system. -* **04 Feb 2000** - [[PeterThoeny]] - * Access statistics. Each web has a [[WebStatistics]] topic that shows monthy statistics with number of topic views and changes, most popular topics, and top contributors. (It needs to be enabled, [[TWikiDocumentation]] has more.) -* **29 Jan 2000** - [[PeterThoeny]] - * Fixed bug where TWiki would not initialize correctly under certain circumstances, i.e. when running it under mod\_perl. Sub `initialize` in `wiki.pm` did not handle `$thePathInfo` correctly. -* **24 Jan 2000** - [[PeterThoeny]] - * Fixed bug where an email address starting with a [[WikiName]] was rendered as an internal Wiki link instead of an email address, i.e. <SomeWikiName@somewhereNOSPAM.test> . -* **10 Jan 2000** - [[PeterThoeny]] - * No more escaping for '%' percent characters. (Number of consecutive '%' entered and displayed is identical.) -* **03 Oct 1999** - [[PeterThoeny]] - * Limit the number of revisions shown at the bottom of the topic. Example <br /> Topic %TOPIC% . \{ ..... [Diffs](../../rdiff/%WEB%/%TOPIC%) r1.10 [>](../../rdiff/%WEB%/%TOPIC%?rev1=1.10&rev2=1.9) [r1.9](../../view/%WEB%/%TOPIC%?rev=1.9) [>](../../rdiff/%WEB%/%TOPIC%?rev1=1.9&rev2=1.8) [r1.8](../../view/%WEB%/%TOPIC%?rev=1.8) [>](../../rdiff/%WEB%/%TOPIC%?rev1=1.8&rev2=1.7) [r1.7](../../view/%WEB%/%TOPIC%?rev=1.7) [>...](../../oops/%WEB%/%TOPIC%?template=oopsrev¶m1=1.10) \} <br /> Additional revisions can be selected by pressing the `>...` link. - -## <a name="01_Sep_1999_Release"> 01-Sep-1999 Release </a> - -* **31 Aug 1999** - [[PeterThoeny]] - * Fixed Y2K bug. (Date in year 2000 had wrong format.) -* **08 Aug 1999** - [[PeterThoeny]] - * New text formatting rule for creating tables. Text gets rendered as a table if enclosed in " " vertical bars. Example line as it is written and how it shows up -* **03 Aug 1999** - [[PeterThoeny]] - * Online registration of new user using web form in [[TWikiRegistration]]. Authentication of users. -* **22 Jul 1999** - [[PeterThoeny]] - * Flags `$doLogTopic*` in wikicfg.pm to selectively log topic view, edit, save, rdiff, attach, search and changes to monthly log file. -* **21 Jul 1999** - [[PeterThoeny]] - * Flag `$doRemovePortNumber` in wikicfg.pm to optionally remove the port number from the TWiki URL. Example `www.some.domain:1234/twiki` gets `www.some.domain/twiki` . -* **15 Jul 1999** - [[PeterThoeny]] - * Search path for include files in <code>%INCLUDE:"file.inc"%</code> variable. Search first in the current web, then in parent data directory. Useful to overload default include text in the data directory by web-specific text, like for example `webcopyright.inc` text. -* **07 Jul 1999** - [[ChristopheVermeulen]] - * Link a plural topic to a singular topic in case the plural topic does not exist. Example `TestVersion` / `TestVersions` , `TestPolicy` / `TestPolicies` , `TestAddress` / `TestAddresses` , `TestBox` / `TestBoxes` . - -## <a name="01_Jul_1999_Release"> 01-Jul-1999 Release </a> - -* **23 Jun 1999** - [[PeterThoeny]] - * New [[TextFormattingRules]] to write **_bold italic_** text by enclosing words with double underline characters. -* **23 Jun 1999** - [[PeterThoeny]] - * Separate wiki.pm into configuration (wikicfg.pm) and TWiki core (wiki.pm) . This is to ease the upgrade of TWiki installations, it also allows customized extensions to TWiki without affecting the TWiki core. -* **21 May 1999** - [[DavidWarman]] - * Externalize copyright text at the bottom of every page into a web-specific `webcopyright.inc` file. This is to easily customize the copyright text. -* **20 May 1999** - [[PeterThoeny]] - * Added meta tag so that robots index only /view/ of topics, not /edit/, /attach/ e.t.c. Tag <META NAME="ROBOTS" CONTENT="NOINDEX"> -* **20 May 1999** - [[PeterThoeny]] - * New variables <code>%WIKIHOMEURL%</code> (link when pressing the icon on the upper left corner) and <code>%WIKITOOLNAME%</code> (the name of the wiki tool `%WIKITOOLNAME%` ). -* **15 Apr 1999** - [[PeterThoeny]] - * Topic locking Warn user if a topic has been edited by an _other_ person within _one_ hour. This is to prevent contention, e.g. simultaneous topic updates. -* **26 Mar 1999** - [[PeterThoeny]] - * File attachments Upload and download any file as a topic attachment by using the browser. [[FileAttachment]] has more. -* **26 Mar 1999** - [[PeterThoeny]] - * New variables <code>%PUBURL%</code> (Public directory URL) and <code>%ATTACHURL%</code> (URL of topic file attachment). -* **09 Feb 1999** - [[PeterThoeny]] - * New text formatting rule for creating `fixed font text` . Words get showns in `fixed font` by enclosing them in "=" equal signs. Example Writing =fixed font= will show up as `fixed font` . -* **09 Feb 1999** - [[PeterThoeny]] - * No new topic revision is created if the _same_ person saves a topic again within _one_ hour. -* **03 Feb 1999** - [[PeterThoeny]] - * Possible to view complete revision history of a topic on one page. Access at the linked date in the Changes page, or the `Diffs` link at the bottom of each topic, e.g. <br /><code> Topic TWikiHistory . \{ Edit Ref-By Diffs r1.3 > r1.2 > r1.1 \} <br /> Revision r1.3 1998/11/10 01:34 by PeterThoeny </code> -* **04 Jan 1999** - [[PeterThoeny]] - * Fixed bug when viewing differences between topic revisions that include HTML table tags like <table>, <tr>, <td>. - -## <a name="1998_Releases"> 1998 Releases </a> - -* **08 Dec 1998** - [[PeterThoeny]] - * Signature is shown below the text area when editing a topic. Use this to easily copy & paste your signature into the text. -* **07 Dec 1998** - [[PeterThoeny]] - * Possible to add a category table to a TWiki topic. This permits storing and searching for more structured information. Editing a topic shows a HTML form with the usual text area and a table with selectors, checkboxes, radio buttons and text fields. [[TWikiDocumentation]] has more on setup. The TWiki.Know web uses this category table to set classification, platform and OS version. -* **18 Nov 1998** - [[PeterThoeny]] - * Internal log of topic save actions to the file `data/logYYYYMM.txt`, where `YYYYMM` the year and month in numeric format is. Intended for auditing only, not accessible from the web. -* **10 Nov 1998** - [[PeterThoeny]] - * The email notification and the Changes topic have now a topic date that is linked. Clicking on the link will show the difference between the two most recent topic revisions. -* **10 Nov 1998** - [[PeterThoeny]] - * View differences between topic revisions. Each topic has a list of revisions (e.g. `r1.3`) and differences thereof (e.g. `>`) at the bottom <br /><code> Topic TWikiHistory . \{ Edit Ref-By r1.3 > r1.2 > r1.1 \} <br /> Revision r1.3 1998/11/10 01:34 by [[PeterThoeny]] </code> -* **26 Oct 1998** - [[PeterThoeny]] - * Added preview of topic changes before saving the topic. This was necessary to prevent unneeded revisions. -* **26 Oct 1998** - [[PeterThoeny]] - * Added revision control using RCS. Each topic has now a list of revisions at the bottom and a revision info, e.g. <br /><code> Topic TWikiHistory . \{ Edit Ref-By r1.3 r1.2 r1.1 \} <br /> Revision r1.3 1998/10/26 01:34:00 by [[PeterThoeny]] </code> -* **14 Oct 1998** - [[PeterThoeny]] - * Refered-By Find out which topics have a link to the current topic. Each topic has a Ref-By link for that. Note Only references from the current web are shown, not references from other webs. -* **13 Oct 1998** - [[PeterThoeny]] - * Alphabetical topic index in [[WebSearch]]. -* **24 Sep 1998** - [[PeterThoeny]] - * Corrected templates for automatic email notification so that MS Outlook can display attachment as an HTML file. -* **13 Aug 1998** - [[PeterThoeny]] - * [[WikiNotation]] allows also numbers after the `AaA` sequence, e.g. `AaA1` is a valid [[WikiTopic]] name, but not `Aa1`. -* **07 Aug 1998** - [[PeterThoeny]] - * Automatic email notification when something has changed in a TWiki web. Each web has a topic [[WebNotify]] where one can subscribe and unsubscribe. -* **06 Aug 1998** - [[PeterThoeny]] - * Added server side include of files. Syntax is <code>%INCLUDE:"filename.ext"%</code> -* **05 Aug 1998** - [[PeterThoeny]] - * Signature and date is inserted automatically when creating a new topic. -* **04 Aug 1998** - [[PeterThoeny]] - * Separate templates for text of non existing topic and default text of new topic. (template file templates/Web/notedited.tmpl) -* **04 Aug 1998** - [[PeterThoeny]] - * Warn user if new topic name is not a valid Wiki name. (template file templates/Web/notwiki.tmpl) -* **31 Jul 1998** - [[PeterThoeny]] - * Support for quoted text with a '>' at the beginning of the line. -* **28 Jul 1998** - [[PeterThoeny]] - * Added TWiki variables, enclosed in % signs <code>%TOPIC%</code> (Topic name), <code>%WEB%</code> (web name), <code>%SCRIPTURL%</code> (script URL), <code>%DATE%</code> (current date), <code>%WIKIWEBMASTER%</code> (Wiki webmaster address), <code>%WIKIVERSION%</code> (Wiki version), <code>%USERNAME%</code> (user name), <code>%WIKIUSERNAME%</code> (Wiki user name). -* **28 Jul 1998** - [[PeterThoeny]] - * Topic [[WebChanges]] shows Wiki username instead of Intranet username, e.g. `PeterThoeny` instead of `thoeny` in case the Wiki username exists. Implementation Automatic lookup of Wiki username in topic [[Main/TWikiUsers]]. -* **28 Jul 1998** - [[PeterThoeny]] - * Topic index. (Technically speaking a simple '.\*' search on topic names.) -* **28 Jul 1998** - [[PeterThoeny]] - * Topic [[WebSearch]] allows full text search and and topic search with/without regular expressions. -* **27 Jul 1998** - [[PeterThoeny]] - * Added automatic links to topics in other TWiki webs by specifying <web name>.<topic name>, e.g. `Know.WebSeach` . -* **23 Jul 1998** - [[PeterThoeny]] - * Installed initial version, based on the JOS Wiki. See [[WikiWikiClones]] for details. - -## <a name="Dev_Flow"> Dev Flow </a> - -The typical TWiki development flow... - -* TWiki:Codev/FeatureBrainstorming: open forum for new ideas -* TWiki:Codev/TWikiEnhancementRequests: specific detailed request -* TWiki:Codev/TWikiPlannedFeatures: accepted for future development -* TWiki:Codev/FeatureToDo: prioritized to up-next dev status -* TWiki:Codev/FeatureUnderConstruction: currently in development -* TWiki:Codev/FeatureDone: completed and implemented -* TWiki:Codev/DocRequest: request for documentation -* TWiki:Codev/DocsToDo: feature documentation pending -* TWiki:Codev/FeatureDocumented: documented feature -* [[TWikiDocumentation]]: reference manual for the latest TWiki diff --git a/TWiki/TWikiImplementationNotes.mdwn b/TWiki/TWikiImplementationNotes.mdwn deleted file mode 100644 index 33b74cd1..00000000 --- a/TWiki/TWikiImplementationNotes.mdwn +++ /dev/null @@ -1,65 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_System_Requirements"> TWiki System Requirements </a> - -_Server and client system requirements for TWiki 01-Sep-2001_ - -## <a name="Overview"> Overview </a> - -Maintaining minimum client and server requirements is necessary to keep TWiki deployment as broad as possible. - -## <a name="Server_Requirements"> Server Requirements </a> - -TWiki is written in Perl 5, uses a number of shell commands, and requires [RCS (Revision Control System)](http://www.gnu.org/software/rcs/rcs.html), a GNU Free Software package. TWiki is developed in a basic Linux/Apache environment. It also works with Microsoft Windows, and should have no problem on any other platform that meets the requirements: - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC" colspan="3"><strong>Required Server Environment</strong></th> - </tr> - <tr> - <th bgcolor="#99CCCC"><strong>Resource</strong></th> - <th bgcolor="#99CCCC"><strong>Unix</strong></th> - <th bgcolor="#99CCCC"><strong>Windows</strong></th> - </tr> - <tr> - <td> Perl </td> - <td align="center" colspan="2"> 5.005_03 or higher </td> - </tr> - <tr> - <td> Non standard Perl modules </td> - <td align="center"><code>Net::SMTP</code> (or <code>sendmail</code>) </td> - <td align="center"><code>Net::SMTP</code>, <code>MIME::Base64</code>, <code>Digest::SHA1</code></td> - </tr> - <tr> - <td> RCS </td> - <td align="center" colspan="2"> 5.7 or higher </td> - </tr> - <tr> - <td> Other external programs </td> - <td align="center" colspan="2"><code>ls, fgrep, egrep</code></td> - </tr> - <tr> - <td> Web server </td> - <td align="center" colspan="2"> Apache; others (with support for CGI, authentication, extended path) <strong>*</strong></td> - </tr> -</table> - -Current documentation covers Linux only. A [TWikiOnWindows](http://twiki.org/cgi-bin/view/Codev/TWikiOnWindows) installation guide is next. - -## <a name="Client_Requirements"> Client Requirements </a> - -The TWiki [[TWikiInstallationGuide]] has extremely low browser requirements: - -* HTML 3.2 compliant -* generates XHTML 1.0 pages that are compatible with HTML 3.2 -* minimal use of JavaScript in the user interface (degrades gracefully) -* no cookies -* no CSS - -You can easily add capabilities, through customizing the templates, for one, while tailoring the browser requirements to your situation. - -## <a name="Known_Issues"> Known Issues </a> - -* The new [[TWikiPlugins]] feature currently does not have compatibility guidelines for developers. Plugins can require just about anything: browser-specific functions, stylesheets (CSS), DHTML, Java applets, cookies. - --- [[MikeMannix]] - 15 Sep 2001 <br /> diff --git a/TWiki/TWikiInstallationGuide.mdwn b/TWiki/TWikiInstallationGuide.mdwn deleted file mode 100644 index d617826b..00000000 --- a/TWiki/TWikiInstallationGuide.mdwn +++ /dev/null @@ -1,187 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_Installation_Guide"> TWiki Installation Guide </a> - -_Installation instructions for the TWiki 01-Sep-2001 production release_ - -## <a name="Overview"> Overview </a> - -These installation steps are based on the Apache Web server on Linux. TWiki runs on other Web servers and Unix systems, and should be fine with any OS and server that meet the [[TWikiImplementationNotes]]. Documentation for other platforms is currently limited. For Windows, check TWiki:Codev/TWikiOnWindows. Search the TWiki:Codev web for other intallation notes. - -<a name="StandardInstallation"></a> - -## <a name="Standard_Installation"> Standard Installation </a> - -Request and download the TWiki 01-Sep-2001 distribution in Unix ZIP format from <http://TWiki.org/download.html>. _(To install TWiki on SourceForge, for use on a software development project, read TWiki:Codev/SourceForgeHowTo.)_ - -### <a name="Step_1_Create_amp_Configure_the_"> Step 1: Create & Configure the Directories </a> - -**_NOTE:_** _If you don't have access to your Web server configuration files - for example, if you're installing on an ISP-hosted account - use the alternative Step 1 instead._ - -* Create directory `/home/httpd/twiki` and unzip the TWiki distribution into this directory. -* The `twiki/bin` directory of TWiki must be set as a cgi-bin directory. Add `/home/httpd/twiki/bin` to file `/etc/httpd/httpd.conf` with only `ExecCGI` option. -* The `twiki/pub` directory of TWiki must be set so that it is visible as a URL. Add `/home/httpd/twiki` to file `httpd.conf` with normal access options (copy from `/home/httpd/html` ). -* Now add `ScriptAlias` for `/twiki/bin` and `Alias` for `/twiki` to file `httpd.conf` . <br />**_NOTE:_** The `ScriptAlias` **_must_** come before the `Alias`, otherwise, Apache will fail to correctly set up `/twiki/bin/`, by treating it as just another subdirectory of the `/twiki/` alias. - -> **Example `httpd.conf` entries:** -> -> <pre> Script<nop>Alias /twiki/bin/ "/home/httpd/twiki/bin/" -> Alias /twiki/ "/home/httpd/twiki/" -> &lt;Directory "/home/httpd/twiki/bin"&gt; -> Options +ExecCGI -> Set<nop>Handler cgi-script -> AllowOverride all -> Allow from all -> &lt;/Directory&gt; -> &lt;Directory "/home/httpd/twiki/pub"&gt; -> Options Follow<nop>Sym<nop>Links +Includes -> Allow<nop>Override None -> Allow from all -> &lt;/Directory&gt;</nop></nop></nop></nop></nop></pre> - -* Restart Apache by `/etc/rc.d/rc5.d/S85httpd restart` . -* Test that the `twiki/bin` directory is CGI-enabled by trying visiting it in your browser: - * Enter the URL for the `bin` directory, `http://yourdomain.com/twiki/bin/`. - * Your settings are OK if you get a message like `"Forbidden. You don't have permission to access /twiki/bin/ on this server"`. - * Settings are NOT correct if you get something like `"Index of /twiki/bin"` - recheck your `httpd.conf` file. - -* _Go directly to Step 2..._ - -<a name="StepOneB"></a> - -#### <a name="Step_1_for_Non_Root_Accounts"> Step 1 for Non-Root Accounts </a> - -To install TWiki on a system where you don't have server administrator privileges, for example, on a hosted Web account: - -* Download and unzip TWiki on your local PC -* Using the table below, create a directory structure on your host server -* Upload the TWiki files by FTP (transfer as _text_ except for the image files in `pub`) - -> <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <th bgcolor="#99CCCC"><strong>TWiki dir:</strong></th> -> <th bgcolor="#99CCCC"><strong>What it is:</strong></th> -> <th bgcolor="#99CCCC"><strong>Where to copy:</strong></th> -> <th bgcolor="#99CCCC"><strong>Example:</strong></th> -> </tr> -> <tr> -> <td><code>twiki/bin</code></td> -> <td> CGI bin </td> -> <td> cgi-enabled dir </td> -> <td><code>/home/smith/public_html/cgi-bin</code></td> -> </tr> -> <tr> -> <td><code>twiki/lib</code></td> -> <td> library files </td> -> <td> same level as <code>twiki/bin</code></td> -> <td><code>/home/smith/public_html/lib</code></td> -> </tr> -> <tr> -> <td><code>twiki/pub</code></td> -> <td> public files </td> -> <td> htdoc enabled dir </td> -> <td><code>/home/smith/public_html/pub</code></td> -> </tr> -> <tr> -> <td><code>twiki/data</code></td> -> <td> topic data </td> -> <td> outside of htdoc tree (for security) </td> -> <td><code>/home/smith/twiki/data</code></td> -> </tr> -> <tr> -> <td><code>twiki/templates</code></td> -> <td> web templates </td> -> <td> outside of htdoc tree (for security) </td> -> <td><code>/home/smith/twiki/templates</code></td> -> </tr> -> </table> - -<a name="StepTwo"></a> - -### <a name="Step_2_Set_File_Permissions"> Step 2: Set File Permissions </a> - -* Make sure Perl 5 and the Perl CGI library are installed on your system. The default location of Perl is `/usr/bin/perl`. If it's elsewhere, change the path to Perl in the first line of each script in the `twiki/bin` directory, or create a symbolic link from `/usr/bin/perl`. - * **IMPORTANT:** On ISP-hosted accounts, Perl CGI scripts usually require a `.cgi` extension to run. Some systems need `.pl`, the regular Perl extension. Modify all `twiki/bin` script filenames if necessary. -* Set the file permission of all Perl scripts in the `twiki/bin` directory as executable to `-rwxr-xr-x` (755). -* To be able to edit the Perl scripts and `.tmpl` files it is necessary to `chown` and `chgrp -R twiki` so all the files have the owner you want. -* **_NOTE:_** This Guide assumes user `nobody` ownership for all files manipulated by the CGI scripts (executed by the Web server), and user `twiki` for all other files. You can: - * replace `nobody` with another user if your server executes scripts under a different name (ex: default for Debian is `www-data`). - * **HINT:** Run the `testenv` script from your browser: `http://yourdomain.com/twiki/bin/testenv`. It will show you the user name of the CGI scripts, a table listing all CGI environment variables, and a test of your `twiki/lib/TWiki.cfg` configuration file (you'll configure that in a minute). - * replace user `twiki` with your own username -* Set the permission of all files below `twiki/data` so that they are writable by user `nobody`. A simple way is to `chmod` them to `-rw-rw-r--` (664) and to `chown` them to `nobody`. -* Set the permission of the `twiki/data` directory and its subdirectories so that files in there are writable by user `nobody`. A simple way is to chmod them to `drwxrwxr-x` (775) and to `chown` them to `nobody`. -* Set the permission of the `twiki/pub` directory and all its subdirectories so that files in there are writable by user `nobody`. A simple way is to `chmod` them to `drwxrwxr-x` (775) and to `chown` them to `nobody`. -* **_NOTE:_** The `twiki/data/*/*.txt,v` RCS repository files in the installation package are locked by user `nobody`. If your CGI scripts are **_not_** running as user `nobody`, it's not possible to check in files (you'll see that the revision number won't increase after saving a topic). In this case, you need to unlock all repository files (check the RCS man pages) and lock them with a different user, ex `www-data`, or delete them all - new files will be automatically created the first time each topic is edited. A simple way to change ownership is with a search-and-replace in all files; for example, using sed: <br />`for f in *,v; do sed 's/nobody\:/www-data\:/' $f > x; mv x $f; done` - -### <a name="Step_3_Set_the_Main_Configuratio"> Step 3: Set the Main Configuration File </a> - -* Edit the file `twiki/lib/TWiki.cfg`, setting the variables to your needs. - * Set the file extension in the `$scriptSuffix` variable to `cgi` or `pl` if required. - * Make sure RCS is installed. Set `$rcsDir` in `twiki/lib/TWiki.cfg` to mach the location of your RCS binaries. -* **Security issue:** Directories `twiki/data` , `twiki/templates` and all its subdirectories should be set so that they are **_not_** visible as a URL. (Alternatively, move the directories to a place where they are not visible, and change the variables in `twiki/lib/TWiki.cfg` accordingly) -* Test your settings by running the `testenv` script from your browser: `http://yourdomain.com/twiki/bin/testenv`. Check if your `twiki/lib/TWiki.cfg` configuration file settings are correct. - -### <a name="Step_4_Finish_Up_from_Your_Brows"> Step 4: Finish Up from Your Browser </a> - -* Point your Web browser at `http://yourdomain.com/twiki/bin/view` and start TWiki-ing away! -* Edit the [[TWikiPreferences]] topic in the TWiki:%TWIKIWEB% web to set the `WIKIWEBMASTER` email address, and other preferences. -* Edit the [[WebPreferences]] topic in each web, if necessary: set individual `WEBCOPYRIGHT` messages, and other preferences. -* Enable email notification of topic changes, [[TWikiSiteTools]] has more. -* Edit the [[WebNotify]] topic in all webs and add the users you want to notify. -* Add the TWiki:Main/PoweredByTWikiLogo to your %MAINWEB%.WebHome topic. -* You can add new <code>%VARIABLES%</code>. Define site-level variables in the [[TWikiPreferences]] topic. See also: [[TWikiVariables]]. - -That's it for the standard virgin installation of TWiki. Read on for server-level customization options. - -## <a name="Additional_Server_Level_Options"> Additional Server-Level Options </a> - -With your new TWiki installation up and running, you can manage most aspects of your site from the browser interface. Only a few functions require access to the server file system, via Telnet or FTP. You can make these server-level changes during installation, and at any time afterwards. - -### <a name="Enabling_Authentication_of_Users"> Enabling Authentication of Users </a> - -* If TWiki is installed on a non-authenticated server - not using SSL - and you'd like to authenticate users: - 1. **Rename** file `.htaccess.txt` in the `twiki/bin` directory to `.htaccess` and change it to your needs. For details, consult the HTTP server documentation (for Apache server: [[1]](http://www.apache.org/docs/mod/directives.html), [[2]](http://www.mcs.kent.edu/system/web_help/htaccess/introduction.html)). In particular, the following <font>red</font> part needs to be configured correctly: <br /><code>Redirect <font>/urlpath/to/TWiki/index.html</font> http://<font>your.domain.com/urlpath/to/TWiki/bin/</font>view</code><br /><code>AuthUserFile <font>/filepath/to/TWiki/data/</font>.htpasswd</code><br /><code>ErrorDocument 401 <font>/urlpath/to/TWiki/bin/</font>oops/TWiki/TWikiRegistration?template=oopsauth</code> - * **_NOTE:_** In case you renamed the CGI script files to have a file extension you need to reflect that in the `edit`, `view`, `preview`, etc entries in `.htaccess`. - * **_NOTE:_** The browser should ask for login name and password when you click on the <u>Edit</u> link. In case `.htaccess` does not have the desired effect you need to enable it: Add "AllowOverride All" to the Directory section of `access.conf` for your `twiki/bin` directory. - 2. **Copy** the [[TWikiRegistrationPub]] topic to [[TWikiRegistration]]. Do that by either editing the topics in the%TWIKIWEB% web, or by renaming the `.txt` and `.txt,v` files in the `twiki/data/%TWIKIWEB%` directory. - * **_HINT:_** You can customize the registration form by deleting or adding input tags. The `name=""` parameter of the input tags must start with: `"Twk0..."` (if this is an optional entry), or `"Twk1..."` (if this is a required entry). This ensures that the fields are processed correctly. -* Register yourself in the [[TWikiRegistration]] topic. - * **_NOTE:_** When a user registers, a new line with the username and encrypted password is added to the `data/.htpasswd` file. The `.htpasswd` file that comes with the TWiki installation includes user accounts for TWiki core team members that are used for testing on TWiki.org. You can edit the file and delete those lines. -* Create a new topic to check if authentication works. -* Edit the %MAINWEB%.TWikiAdminGroup topic in the TWiki:%MAINWEB% web to include users with system administrator status. -* Edit the [[TWikiPreferences]] topic in the TWiki:%TWIKIWEB% web to set access privileges. -* Edit the [[WebPreferences]] topic in each web, if necessary: set access priviliges. - -<a name="CreateWeb"></a> - -### <a name="Adding_a_New_Web"> Adding a New Web </a> - -To create a new web: - -1. **Create** a new web data directory under `twiki/data` and check the file permission of the directory. - * Use a name starting with characters `A..Z`, followed by `a..z` and/or `0..9` characters, but **_not_** a [[WikiWord]]. -2. **Copy** all files from the `twiki/data/_default` directory to the new data directory, preserving the original files' owner, group and permissions (on Unix, use `cp -p`). The data files must be writable by the owner the CGI scripts are running on (usually, `nobody`). - * **_HINT:_** You can set permissions of `.txt` and `.txt,v` files to `-rw-rw-rw-` (666) and then edit the topic using your browser; RCS will restore the file permissions correctly when saving the topic. -3. **Add** the new web to the web list (visible in the upper right corner of each topic) by editing the site-level preferences, %TWIKIWEB%.%WIKIPREFSTOPIC%: - * Add the new web to the <code>%WIKIWEBLIST%</code> variable. -4. **Update** the web settings by editing the WebPreferences topic of the new web: - * Customize the <code>%WEBTOPICLIST%</code> variable to contain the web-specific links you prefer. - * Set the WEBBGCOLOR variable to a color. The number represents the unique color for the web. - * Set Plugins, access privileges, custom variables, other web-level options (ex: <code>%WEBCOPYRIGHT%</code> can be set for an individual web). -5. **Add** the new web to the color-coded web directory table by editing the %TWIKIWEB%.TWikiWebsTable topic. -6. **Test** the new web: view pages, create a new page. - -That's it for a basic new web set-up! - -Optionally, you can also: - -* Create custom web-specific templates in a new `twiki/templates/Someweb` directory (otherwise, templates are inherited from `twiki/templates`). -* Add [[TWikiForms]] for form-based page input that's stored separately from the main free-form topic text. - -**_NOTE:_** User home topics are located in the %WIKITOOLNAME%.%MAINWEB% web - don't try to move them or create them in other webs. From any other web, user signatures have to point to %WIKITOOLNAME%.%MAINWEB% web, using a <code>%MAINWEB%.UserName</code> or <code>%MAINWEB%.UserName</code> format. (The <code>%MAINWEB%</code> variable is an advantage if you ever change the %MAINWEB% web name, but the standard <code>%MAINWEB%.UserName</code> is easier for users to enter, which is the bottom line! - -## <a name="TWiki_File_System_Info"> TWiki File System Info </a> - -See [[AppendixFileSystem]] for an installed system snapshot and descriptions of all files in the TWiki 01-Sep-2001 distribution. - --- [[PeterThoeny]] - 13 Sep 2001 <br /> -- [[MikeMannix]] - 03 Dec 2001 diff --git a/TWiki/TWikiMetaData.mdwn b/TWiki/TWikiMetaData.mdwn deleted file mode 100644 index dc035ff6..00000000 --- a/TWiki/TWikiMetaData.mdwn +++ /dev/null @@ -1,299 +0,0 @@ -%TOC% %STARTINCLUDE% <a name="MetaDataDefinition"></a> - -# <a name="TWiki_Meta_Data"> TWiki Meta Data </a> - -_Additional topic data, program-generated or from [[TWikiForms]], is stored in `META` variable name/value pairs_ - -## <a name="Overview"> Overview </a> - -[[TWikiMetaData]] uses `META` variables to store topic data that's separate from the main free-form content. This includes program-generated info like [[FileAttachment]] and topic movement data, and user-defined [[TWikiForms]] info. Use `META` variables to format and display Meta Data. - -## <a name="Meta_Data_Syntax"> Meta Data Syntax </a> - -* Format is the same as in [[TWikiVariables]], except all fields have a key. - * <code>%META:<type>\{key1="value1" key2="value2" ...\}%</code> - -* Order of fields within the meta variables is not defined, except that if there is a field with key `name`, this appears first for easier searching (note the order of the variables themselves is defined). - -* Each meta variable is on one line. - -* `\n` (new line) is represented in values by <code>%\_N\_</code> and `"` (double-quotes) by <code>%\_Q\_%</code>. - -> **Example of Format** -> -> <pre> -> %<nop>META:TOPICINFO{version="1.6" date="976762663" author="PeterThoeny" format="1.0"}% -> text of the topic -> %<nop>META:TOPICMOVED{from="Codev.OldName" to="Codev.NewName" -> by="JohnTalintyre" date="976762680"}% -> %<nop>META:TOPICPARENT{name="NavigationByTopicContext"}% -> %<nop>META:FILEATTACHMENT{name="Sample.txt" version="1.3" ... }% -> %<nop>META:FILEATTACHMENT{name="Smile.gif" version="1.1" ... }% -> %<nop>META:FORM{name="WebFormTemplate"}% -> %<nop>META:FIELD{name="OperatingSystem" value="OsWin"}% -> %<nop>META:FIELD{name="TopicClassification" value="PublicFAQ"}% -> </nop></nop></nop></nop></nop></nop></nop></nop></pre> - -## <a name="Meta_Data_Specifications"> Meta Data Specifications </a> - -The current version of Meta Data is 1.0, with support for the following variables. - -### <a name="META_TOPICINFO"> </a> META:TOPICINFO - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th align="center" bgcolor="#99CCCC"><strong>Key</strong></th> - <th align="center" bgcolor="#99CCCC"><strong>Comment</strong></th> - </tr> - <tr> - <td> version </td> - <td> Same as RCS version </td> - </tr> - <tr> - <td> date </td> - <td> integer, unx time, seconds since start 1970 </td> - </tr> - <tr> - <td> author </td> - <td> last to change topic, is the REMOTE_USER </td> - </tr> - <tr> - <td> format </td> - <td> Format of this topic, will be used for automatic format conversion </td> - </tr> -</table> - -### <a name="META_TOPICMOVED"> </a> META:TOPICMOVED - -This is optional, exists if topic has ever been moved. If a topic is moved more than once, only the most recent META:TOPICMOVED meta variable exists in the topic, older ones are to be found in the rcs history. - -<code>%META:TOPICMOVED\{from="Codev.OldName" to="Codev.NewName" by="talintj" date="976762680"\}%</code> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th align="center" bgcolor="#99CCCC"><strong>Key</strong></th> - <th align="center" bgcolor="#99CCCC"><strong>Comment</strong></th> - </tr> - <tr> - <td> from </td> - <td> Full name i.e. web.topic </td> - </tr> - <tr> - <td> to </td> - <td> Full name i.e. web.topic </td> - </tr> - <tr> - <td> by </td> - <td> Who did it, is the REMOTE_USER, not <nop>WikiName </nop></td> - </tr> - <tr> - <td> date </td> - <td> integer, unx time, seconds since start 1970 </td> - </tr> -</table> - -Notes: - -* at present version number is not supported directly, it can be inferred from the RCS history. -* there is only one META:TOPICMOVED in a topic, older move information can be found in the RCS history. - -### <a name="META_TOPICPARENT"> </a> META:TOPICPARENT - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Key</strong></th> - <th bgcolor="#99CCCC"><strong>Comment</strong></th> - </tr> - <tr> - <td> name </td> - <td> The topic from which this was created, [[WebHome]] if done from <code>Go</code>, othewise topic where <code>?</code> or form used. Normally just topic, but is full web.topic format if parent is in a different Web. Renaming a Web will then only break a few of these references or they can be scanned and fixed. </td> - </tr> -</table> - -### <a name="META_FILEATTACHMENT"> </a> META:FILEATTACHMENT - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Key</strong></th> - <th bgcolor="#99CCCC"><strong>Comment</strong></th> - </tr> - <tr> - <td> name </td> - <td> Name of file, no path. Must be unique within topic </td> - </tr> - <tr> - <td> version </td> - <td> Same as RCS revision </td> - </tr> - <tr> - <td> path </td> - <td> Full path file was loaded from </td> - </tr> - <tr> - <td> size </td> - <td> In bytes </td> - </tr> - <tr> - <td> date </td> - <td> integer, unx time, seconds since start 1970 </td> - </tr> - <tr> - <td> user </td> - <td> the REMOTE_USER, not <nop>WikiName </nop></td> - </tr> - <tr> - <td> comment </td> - <td> As supplied when file uploaded </td> - </tr> - <tr> - <td> attr </td> - <td><code>h</code> if hidden, optional </td> - </tr> -</table> - -Extra fields that are added if an attachment is moved: - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Key</strong></th> - <th bgcolor="#99CCCC"><strong>Comment</strong></th> - </tr> - <tr> - <td> movedfrom </td> - <td> full topic name - web.topic </td> - </tr> - <tr> - <td> movedby </td> - <td> the REMOTE_USER, not <nop>WikiName </nop></td> - </tr> - <tr> - <td> movedto </td> - <td> full topic name - web.topic </td> - </tr> - <tr> - <td> moveddate </td> - <td> integer, unx time, seconds since start 1970 </td> - </tr> -</table> - -### <a name="META_FORM"> </a> META:FORM - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Key</strong></th> - <th bgcolor="#99CCCC"><strong>Comment</strong></th> - </tr> - <tr> - <td> name </td> - <td> A topic name - the topic represents one of the [[TWikiForms]]. Can optionally include the web name i.e. web.topic, but doesn't normally </td> - </tr> -</table> - -### <a name="META_FIELD"> </a> META:FIELD - -Should only be present if there is a META:FORM entry. Note that this data is used when viewing a topic, the form template definition is not read. - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Key</strong></th> - <th bgcolor="#99CCCC"><strong>Name</strong></th> - </tr> - <tr> - <td> name </td> - <td> Ties to entry in [[TWikiForms]] template, is title with all bar alphanumerics and . removed </td> - </tr> - <tr> - <td> title </td> - <td> Full text from [[TWikiForms]] template </td> - </tr> - <tr> - <td> value </td> - <td> Value user has supplied via form </td> - </tr> -</table> - -### <a name="Recommended_Sequence"> Recommended Sequence </a> - -There is no absolute need for Meta Data variables to be listed in a specific order within a topic, but it makes sense to do so a couple of good reasons: - -* form fields remain in the order they are defined -* the `diff` function output appears in a logical order - -The recommended sequence is: - -* META:TOPICINFO -* `text of topic` -* META:TOPICMOVED (optional) -* META:TOPICPARENT (optional) -* META:FILEATTACHMENT (0 or more entries) -* META:FORM (optional) -* META:FIELD (0 or more entries; FORM required) - -## <a name="Viewing_Meta_Data_in_Page_Source"> Viewing Meta Data in Page Source </a> - -When viewing a topic the <code>**Raw Text**</code> link can be clicked to show the text of a topic (ie: as seen when editing). This is done by adding `raw=on` to URL. `raw=debug` shows the meta data as well as the topic data, ex: [debug view for this topic](%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?raw=debug) - -<a name="MetaDataRendering"></a> - -## <a name="Rendering_Meta_Data"> Rendering Meta Data </a> - -Meta Data is rendered with the %META% variable. This is mostly used in the `view`, `preview` and `edit` scripts. - -Current support covers: - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Variable usage:</strong></th> - <th bgcolor="#99CCCC"><strong>Comment:</strong></th> - </tr> - <tr> - <td> %<nop>META{"form"}% </nop></td> - <td> Show form data, see [[TWikiForms]]</td> - </tr> - <tr> - <td> %<nop>META{"attachments"}% </nop></td> - <td> Show attachments, exclude hidden </td> - </tr> - <tr> - <td> Options for [[FileAttachments]]: </td> - <td> </td> - </tr> - <tr> - <td> all="on" </td> - <td> Show ALL attachments (including hidden) </td> - </tr> - <tr> - <td> %<nop>META{"moved"}% </nop></td> - <td> Details of any topic moves </td> - </tr> - <tr> - <td> %<nop>META{"parent [options]"}% </nop></td> - <td> Show topic parent </td> - </tr> - <tr> - <td> Options for parent: </td> - <td> </td> - </tr> - <tr> - <td> dontrecurse="on" </td> - <td> By default recurses up tree, at some cost </td> - </tr> - <tr> - <td> prefix="..." </td> - <td> Prefix for parents, only if there are parents; default "" </td> - </tr> - <tr> - <td> suffix="..." </td> - <td> Suffix, only appears if there are parents; default "" </td> - </tr> - <tr> - <td> separator="..." </td> - <td> Separator between parents, default is " &gt; " </td> - </tr> -</table> - -## <a name="Known_Issues"> Known Issues </a> - -At present, there is no Meta Data support for Plugins. However, the format is readily extendable and the `Meta.pm` code that supports the format needs only minor alteration. - --- [[JohnTalintyre]] - 29 Aug 2001 <br /> -- [[MikeMannix]] - 03 Dec 2001 diff --git a/TWiki/TWikiPages.mdwn b/TWiki/TWikiPages.mdwn deleted file mode 100644 index a41e2774..00000000 --- a/TWiki/TWikiPages.mdwn +++ /dev/null @@ -1,91 +0,0 @@ -%INCLUDE\{"DocsUserNote"\}% - -# <a name="TWiki_Pages"> TWiki Pages </a> - -%TOC% - -Each page in a TWiki web is called a **_topic_**, defined by its meaningful, descriptive %TWIKIWEB%.WikiWord title. - -## <a name="Page_Features"> Page Features </a> - -A TWiki topic is a self-contained information unit rich in features: - -* a [[WikiWord]] title that lets you: - * instantly identify what the page is about - * automatically link to it from other pages -* an edit-anywhere collaboration area where you can: - * enter plain or fully-HTML formatted text - * work with simple TWiki editing shorthand (that includes HTML mark-up and special TWiki functions) - * include Web links, images, anything else you can put on a Web page -* an extra [[TWIKIWEBTWikiForms]] option: - * store structured info alongside the free-form page content - * use text fields and boxes, radio buttons, pulldown selector menus, checkboxes - * select from one or many different input forms, with all data preserved -* a [[FileAttachment]] feature that lets you: - * upload files through your browser to the TWiki server - * attach any type of file (documents, images, applications) for viewing or downloading - * make changes and update existing files -* [[TWIKIWEBTWikiSkins]] to customize the look of headers and footers: - * apply skins across an entire TWiki web level, or to a single page -* browser-based controls for renaming, moving, and deleting pages: - * rename a page and automatically update all the references to it, site-wide - * move a page from one TWiki web to another - * safely delete a topic to a special Trash web (invisible, but accessible to the TWiki administrators if needed) -* flexible [[TWIKIWEBTWikiAccessControl]]: - * independently determine who can see, edit, rename, move or delete topics - * set permissions by individual users and user groups -* revision control automatically saves topic changes: - * uses the established standard RCS (Revision Control System) - * efficiently stores every change made to the original version - * allows comparison of changes between any two versions, and review of any version, as formatted or raw text -* referred-by searches that list all topics in a web or site wide that link to a particular page -* hierarchical parent-child topic navigation: - * automatically links a new page as the "child" of the page it was created from - * allows manual assignment of parent page from a list of all topics in the local web - * offers navigation displays, by topic parent, or by related topic - -The configuration of your TWiki site and your own user account determine which of these features you can use. - -<a name="EditingPages"></a> - -## <a name="How_to_create_and_edit_a_page"> How to create and edit a page </a> - -Adding and editing information on existing pages, and creating new pages, is TWiki's main function. - -* To modify a topic, click the <code>**[Edit]**</code> link at the bottom left of every page. An editing window appears. Type away. Use the [[GoodStyle]] and [[TextFormattingRules]] links to get pop-up window help. - * Click <code>**[Preview Changes]**</code> to see how your edit looks. - * Click <code>**[Save Changes]**</code> to save. - -* To add a new page, the simplest way is to type a new [[WikiName]] on an existing page. When the page is saved, the new name will appear highlighted, with a **?** at the end: click the **?** and a new edit window appears. Enter, preview and save as usual. The new page now exists. - -<a name="OtherFeatures"></a> - -## <a name="How_to_attach_files_and_use_othe"> How to attach files and use other features </a> - -The color-coded control strip at the bottom of every page displays a series of links, including <code>**[Attach]**</code> (for attachments), <code>**[Ref-by]**</code> (to display referring pages), and <code>**[More]**</code>, which opens a new screen of additional controls). - -* Most controls are self-explanatory, and also include explanatory text and help links. -* Experiment. You can always cancel or go Back whenever you like. -* Get in-depth info from the [[TWIKIWEBHOMETOPIC]], including the User's Guide and Reference Manual. - -<a name="RenamingTopics"></a> - -## <a name="How_to_rename_move_or_delete_a_p"> How to rename, move or delete a page </a> - -You can now rename, move and delete individual topics from your browser. All three options are available by clicking **More** on the control strip at the bottom of every page. The access settings for a topic, web or entire site may be disabled for one or more of the three options. In any case, all three are similar and extremely self-explanatory. - -1. On the topic you want to change, click **More** > **Rename/move** -2. To move or delete: select the target web (`Trash` for delete)from the pull-down menu; otherwise, leave on the current web -3. To rename: fill in a new [[WikiName]] (otherwise, leave the current topic name) -4. To update occurrences of the topic name on other pages: From the list of pages that link to the topic, check or uncheck each entry as you desire - only checked links will be updated; -5. Click **Rename/move**: the topic will be renamed and links to the topic updated. - * Any problems are listed ; you can change them later. - * If a referring page can't be update because it's locked (ex: someone's editing), it appears on an alert. You can missed pages later by again pressing **Rename/move**. - -%H% Deleting means moving the topic to the Trash web. Since all webs share the one Trash, name conflicts may come up. - -%X% **NOTE:** Keep in mind that moving a topic from a view-restricted web to a public web or the Trash web will compromise security. - -See: [[TWikiDocumentation]] for more details. - -_Last updated: [[Main/MikeMannix]] - 30 Oct 2001_<br /> diff --git a/TWiki/TWikiPlannedFeatures.mdwn b/TWiki/TWikiPlannedFeatures.mdwn deleted file mode 100644 index 2d320d8e..00000000 --- a/TWiki/TWikiPlannedFeatures.mdwn +++ /dev/null @@ -1,10 +0,0 @@ -* Planned features are listed up at the TWiki home at <http://TWiki.org/cgi-bin/view/Codev/FeatureToDo> -* Features currently under construction are at <http://TWiki.org/cgi-bin/view/Codev/FeatureUnderConstruction> - -**Related Topics** - -* [[TWikiHistory]] has a list of added features in TWiki. -* [[TWikiDocumentation]] is the implementation documentation. -* [[TWikiEnhancementRequests]] is the place where you can add your enhancement requests. - --- [[Main/PeterThoeny]] - 12 May 2000 <br /> diff --git a/TWiki/TWikiPlugins.mdwn b/TWiki/TWikiPlugins.mdwn deleted file mode 100644 index bcd94275..00000000 --- a/TWiki/TWikiPlugins.mdwn +++ /dev/null @@ -1,221 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_Plugins"> TWiki Plugins </a> - -_Plug-in enhanced feature add-ons, with a Plugin API for developers_ - -## <a name="Overview"> Overview </a> - -You can add Plugins to extend TWiki's functionality, without altering the core program code. A plug-in approach lets you: - -* add virtually unlimited features while keeping the main TWiki code compact and efficient; -* heavily customize an installation and still do clean updates to new versions of TWiki; -* rapidly develop new TWiki functions in Perl using the Plugin API. - -Everything to do with TWiki Plugins - demos, new releases, downloads, development, general discussion - is available at TWiki.org, in the ** TWiki:Plugins ** web. - -## <a name="Preinstalled_Plugins"> Preinstalled Plugins </a> - -TWiki comes with three Plugins as part of the standard installation. - -* **[[TWIKIWEBDefaultPlugin]]** optionally handles some legacy variables from older versions of TWiki. You can control this option from %TWIKIWEB%.TWikiPreferences. (Perl programmers can also add rules for simple custom processing.) - -* **[[TWIKIWEBEmptyPlugin]]** is a fully functional module, minus active code; it does nothing and serves as a template for new Plugin development. - -* **[[TWIKIWEBInterwikiPlugin]]** is preinstalled but can be disabled or removed. Use it for shorthand linking to remote sites, ex: `TWiki:Plugins` expands to TWiki:Plugins on TWiki.org. You can edit the predefined set of of Wiki-related sites, and add your own. - -<a name="InstallPlugin"></a> - -## <a name="Installing_Plugins"> Installing Plugins </a> - -Each TWikiPlugin comes with full documentation: step-by-step installation instructions, a detailed description of any special requirements, version details, and a working example for testing. - -Most Plugins can be installed in three easy steps, with no programming skills required: - -1. **Download** the zip file containing the Plugin, documentation, and any other required files, from TWiki:Plugins. -2. **Distribute** the files to their proper locations - unzip the zip archive in your TWiki installation directory - if have a standard TWiki installation, this will distribute automatically. Otherwise, place the files according to the directory paths listed on the Plugin top in TWiki:Plugins. -3. **Check** the demo example on the Plugin topic: if it's working, the installation was fine! - -**Special Requests:** Some Plugins need certain Perl modules to be preinstalled on the host system. Plugins may also use other resources, like graphics, other modules, applications, templates. In these cases, detailed instructions are in the Plugin documentation. - -Each Plugin has a standard release page, located in the TWiki:Plugins web at TWiki.org. In addition to the documentation topic (`SomePlugin`), there's a separate development page. - -* **Doc page:** Read all available info about the Plugin; download the attached distribution files. -* **Dev page:** Post feature requests, bug reports and general dev comments; topic title ends in `Dev` (`SomePluginDev`). -* **User support:** Post installation, how to use type questions (and answers, if you have them) in the TWiki:Support web. - -<a name="PreTesting"></a> - -### <a name="On_Site_Pretesting"> On-Site Pretesting </a> - -To test new Plugins on your installation before making them public, you may want to use one of these two approaches: - -* **Method 1:** Safely test on-the-fly by creating separate Production and Test branches in your live TWiki installation. - * **Duplicate** the `twiki/bin` and `twiki/lib` directories for the Test version, adjusting the paths in the new `lib/TWiki.cfg`, the `twiki/data`; the `twiki/templates` and `twiki/pub` directories are shared. - * **Test** Plugins and other new features in the Test installation until you're satisfied. - * %X% If you modify topics using the new features, live users will likely see unfamiliar new META tags showing up on their pages - to avoid this, create and edit test-only topics to try out new features. - * **Copy** the modified files to the Production installation. You can update a TWiki installation live and users won't even notice. - -* **Method 2:** List the Plugin under `Test` in the `DISABLEDPLUGINS` variable in %TWIKIWEB%.TWikiPreferences. Redefine the `DISABLEDPLUGINS` variable in the Test web and do the testing there. - -## <a name="Managing_Plugins"> Managing Plugins </a> - -When you finish installing a Plugin, you should be able to read the user instructions and go. In fact, some Plugins require additional settings or offer extra options that you have to select. Also, you may want to make a Plugin available only in certain webs, or temporarily disable it. And may want to list all available Plugins in certain topics. You can handle all of these management tasks with simple procedures. - -### <a name="Setting_Preferences"> Setting Preferences </a> - -Installed Plugins can be **toggled on or off**, site-wide or by web, through TWikiPreferences and individual WebPreferences: - -* All Plugin modules present in the `lib/TWiki/Plugins` directory are activated automatically unless disabled by the `DISABLEDPLUGINS` Preferences variable in TWikiPreferences. You can optionally list the installed Plugins in the `INSTALLEDPLUGINS` Preferences variable. This is useful to define the sequence of Plugin execution, or to specify other webs than the %WIKITOOLNAME% web for the Plugin topics. Settings in %TWIKIWEB%.TWikiPreferences are: - * <code>Set INSTALLEDPLUGINS = DefaultPlugin, ...</code> - * <code>Set DISABLEDPLUGINS = EmptyPlugin, ...</code> - -**Plugin execution order** in TWiki is determined by searching Plugin topics in a specific sequence: First, full `web.topicname` name, if specified in `INSTALLEDPLUGINS`; next, the %TWIKIWEB% web is searched; and finally, the current web. - -**Plugin-specific settings** are done in individual Plugin topics. Two settings are standard for each Plugin: - -1. One line description, used to form the bullets describing the Plugins in the %TWIKIWEB%.TextFormattingRules topic: - * `Set SHORTDESCRIPTION = Blah blah woof woof.` -2. Debug Plugin, output can be seen in `data/debug.txt`. Set to 0=off or 1=on: - * `Set DEBUG = 0` - -* The settings can be retrieved as Preferences variables like `%<pluginname>_<var>%`, ex: <code>%DEFAULTPLUGIN\_SHORTDESCRIPTION%</code> shows the description of the DefaultPlugin. - -### <a name="Listing_Active_Plugins"> Listing Active Plugins </a> - -Plugin status variables let you list all active Plugins wherever needed. There are two list formats: - -* The <code>%ACTIVATEDPLUGINS%</code> variable lists activated Plugins by name. (This variable is displayed in %TWIKIWEB%.TWikiPreferences for debugging use.) -* The <code>%PLUGINDESCRIPTIONS%</code> variable displays a bullet list with a one-line description of each active Plugins. This variable is based on the `%<plugin>_SHORTDESCRIPTION%` Preferences variables of individual topics and is shown in %TWIKIWEB%.TextFormattingRules. - -> **DEMO: Automatically List Active Plugins Using Variables** -> -> Using <code>%ACTIVATEDPLUGINS%</code>:<br /> On this TWiki site, the active Plugins are: %ACTIVATEDPLUGINS%. -> -> Using <code>%PLUGINDESCRIPTIONS%</code>:<br /> You can use any of these active TWiki Plugins: %PLUGINDESCRIPTIONS% - -<a name="PluginAPI"></a> - -## <a name="The_TWiki_Plugin_API"> </a> The TWiki Plugin API - -The Application Programming Interface (API) for TWikiPlugins provides the specifications for hooking into the core TWiki code from your external Perl Plugin module. The Plugin API is new to the Production version of TWiki with the 01-Sep-2001 release. - -### <a name="Available_Core_Functions"> Available Core Functions </a> - -The `lib/TWiki/Func.pm` implements ALL official Plugin functions. Plugins should ONLY use functions published in this module. - -%X% If you use functions not in `Func.pm`, you run the risk of creating security holes. Also, your Plugin will likely break and require updating when you upgrade to a new version of TWiki. - -* For best performance, enable only the functions you really need. NOTE: `outsidePREHandler` and `insidePREHandler` are particularly expensive. - -### <a name="Predefined_Hooks"> Predefined Hooks </a> - -In addition to TWiki core functions, Plugins can use **predefined hooks**, or **call backs**, listed in the `lib/TWiki/Plugins/EmptyPlugin.pm` module. - -* All but the initPlugin are disabled. To enable a call back, remove `DISABLE_` from the function name. - -### <a name="Plugin_Version_Detection"> Plugin Version Detection </a> - -To eliminate the incompatibility problems bound to arise from active open Plugin development, a Plugin versioning system and an API `GetVersion` detection routine are provided for automatic compatibility checking. - -* All modules require a `$VERSION='0.000'` variable, beginning at `1.000`. - -* The `initPlugin` handler should check all dependencies and return TRUE if the initialization is OK or FALSE if something went wrong. - * The Plugin initialization code does not register a Plugin that returns FALSE (or that has no `initPlugin` handler). - -* `$VERSION='1.000'` is the current setting in `TWiki::Plugins.pm` and in the preinstalled system Plugins ([[DefaultPlugin]], [[EmptyPlugin]], [[InterwikiPlugin]]). - -<a name="CreatePlugins"></a> - -## <a name="Creating_Plugins"> Creating Plugins </a> - -With a reasonable knowledge of the Perl scripting language, you can create new Plugins or modify and extend existing ones. Basic plug-in architecture uses an Application Programming Interface (API), a set of software instructions that allow external code to interact with the main program. The TWiki Plugin API Plugins by providing a programming interface for TWiki. - -<a name="DefaultPluginAlt"></a> - -### <a name="The_DefaultPlugin_Alternative"> The DefaultPlugin Alternative </a> - -* **DefaultPlugin** can handle some outdated TWiki variables, found, for example, in sites recently updated from an old version. Settings are in [[DefaultPlugin]] topic. You can also add your own simple custom processing rules here, though in all but very simple cases, writing a new Plugin is preferable. - -### <a name="Anatomy_of_a_Plugin"> Anatomy of a Plugin </a> - -A basic TWiki Plugin consists of two elements: - -* a Perl module, ex: `MyFirstPlugin.pm` -* a documentation topic, ex: `MyFirstPlugin.txt` - -The Perl module can be a block of code that connects with TWiki alone, or it can include other elements, like other Perl modules (including other Plugins), graphics, TWiki templates, external applications (ex: a Java applet), or just about anything else it can call. In particular, files that should be web-accessible (graphics, Java applets ...) are best placed as attachments of the `MyFirstPlugin` topic. Other needed Perl code is best placed in a `lib/TWiki/Plugins/MyFirstPlugin/` directory. - -The Plugin API handles the details of connecting your Perl module with main TWiki code. When you're familiar with the Plugin API, you're ready to develop Plugins. - -### <a name="Creating_the_Perl_Module"> Creating the Perl Module </a> - -Copy file `lib/TWiki/Plugins/EmptyPlugin.pm` to `<name>Plugin.pm`. `EmptyPlugin.pm` contains no executable code, so it does nothing, but it's ready to be used. Customize it. Refer to the Plugin API specs for more information. - -<a name="CreatePluginTopic"></a> - -### <a name="Writing_the_Documentation_Topic"> Writing the Documentation Topic </a> - -The Plugin documentation topic contains usage instructions and version details. It serves the Plugin files as %TWIKIWEB%.FileAttachments for downloading. (The doc topic is also included _in_ the distribution package.) To create a documentation topic: - -1. **Copy** the Plugin topic template from [[EmptyPlugin]]. To copy the text, go to the page and: - * click Edit - * select all in the Edit box & copy - * Cancel the edit - * paste & save as a text file or new topic on your site -2. **Customize** the template for your Plugin; you'll probably want to post a working version on your local TWiki site. -3. **Save** your topic as a text file, for use in packaging and publishing your Plugin. - -> **OUTLINE: Doc Topic Contents** -> -> <br /> -> -> Check -> -> -> -> [[EmptyPlugin]] -> -> on TWiki.org for the latest Plugin doc topic template. Here's a quick overview of what's covered: -> -> **Syntax Rules:** <_Describe any special text formatting that will be rendered._>" -> -> **MyFirstPlugin Settings:** <_Description and settings for custom Plugin %VARIABLES%, and those required by TWiki._>" -> -> * **Plugins Preferences** <_If user settings are needed, explain... Entering valuse works exactly like %TWIKIWEB%.TWikiPreferences and [[WebPreferences]]: six (6) spaces and then:_>" -> * **Set <_EXAMPLE = value added_>** -> -> **How-to Instructions:** <_Step-by-step set-up guide, user help, whatever it takes to install and run, goes here._>" -> -> **Test Example:** <_Include an example of the Plugin in action: if it works, the installation was a success!_>" -> -> **Plugin Info:** <_Version, credits, history, requirements - entered in a form, displayed as a table. Both are automatically generated when you create or edit a page in the TWiki:Plugins web._>" - -<a name="CreatePluginPackage"></a> - -### <a name="Packaging_for_Distribution"> Packaging for Distribution </a> - -A minimum Plugin release consists of a Perl module with a [[WikiName]] that ends in `Plugin`, ex: `MyFirstPlugin.pm`, and a documentation page with the same name(`MyFirstPlugin.txt`). - -1. Distribute the Plugin files in a directory structure that mirrors TWiki. If your Plugin uses additional files, include them ALL: - * `lib/TWiki/Plugins/MyFirstPlugin.pm` - * `data/TWiki/MyFirstPlugin.txt` - * `pub/TWiki/MyFirstPlugin/uparrow.gif` [a required graphic] -2. Create a zip archive with the Plugin name (`MyFirstPlugin.zip`) and add the entire directory structure from Step 1. The archive should look like this: - * `lib/TWiki/Plugins/MyFirstPlugin.pm` - * `data/TWiki/MyFirstPlugin.txt` - * `pub/TWiki/MyFirstPlugin/uparrow.gif` - -<a name="PublishPlugin"></a> - -### <a name="Publishing_for_Public_Use"> Publishing for Public Use </a> - -You can release your tested, packaged Plugin to the TWiki community through the TWiki:Plugins web. All Plugins submitted to TWiki.org are available for download and further development in TWiki:Plugins. Publish your Plugin in three steps: - -1. **Post** the Plugin documentation topic in the TWiki:Plugins web: - * create a new topic using the Plugin name, ex: `MyFirstPlugin.txt` - * paste in the topic text from Creating Plugin Documentation and save -2. **Attach** the distribution zip file to the topic, ex: `MyFirstPlugin.zip` -3. **Link** from the doc page to a new, blank page named after the Plugin, and ending in `Dev`, ex: `MyFirstPluginDev`. This is the discussion page for future development. (User support for Plugins is handled in TWiki:Support.) - --- [[AndreaSterbini]] - 29 May 2001 <br /> -- [[PeterThoeny]] - 14 Sep 2001 <br /> -- [[MikeMannix]] - 03 Dec 2001 diff --git a/TWiki/TWikiPreferences.mdwn b/TWiki/TWikiPreferences.mdwn deleted file mode 100644 index d54e574a..00000000 --- a/TWiki/TWikiPreferences.mdwn +++ /dev/null @@ -1,112 +0,0 @@ -**%WIKITOOLNAME% Site-Level Preferences** - -The following settings are **_site-level preferences_** , e.g. affecting all users in all %WIKITOOLNAME% webs. These preferences can be overwritten by **_web preferences_** (topic %WEBPREFSTOPIC% in each %WIKITOOLNAME% web) and **_user preferences_** (your personal topic, i.e. [[Main/TWikiGuest]] in the %WIKITOOLNAME%.%MAINWEB% web) - -**_Preferences:_** - -* List of %WIKITOOLNAME% webs: (the first line of a topic; to add a web see [[TWikiDocumentation]] and [[TWikiWebsTable]]) - * Set WIKIWEBLIST = [[Hurd/HOMETOPIC]] %SEP% [[Distrib/HOMETOPIC]] %SEP% [[GNU/HOMETOPIC]] %SEP%[[Mach/HOMETOPIC]] %SEP% [[Mig/HOMETOPIC]] %SEP% [[Hug/HOMETOPIC]] %SEP% [[MAINWEBHOMETOPIC]] %SEP% [[TWIKIWEBHOMETOPIC]] - * **_Note:_** To automatically list all non-hidden webs in alphabetical order you can use this variable instead: Set WIKIWEBLIST = %WEBLIST\{"[[NameHOMETOPIC]]" separator=" %SEP% "\}% - -* List of topics of a web: (the second line of a topic, is overwritten by web preferences) - * Set WEBTOPICLIST = [[HOMETOPIC]] %SEP% [[WebChanges]] %SEP% [[WebIndex]] %SEP% [[WebSearch]] %SEP% Go <input name="topic" size="16" type="text" /> - -* Copyright notice: - * Set WEBCOPYRIGHT = <font>Copyright © 2002-2005 the contributing authors. <br />Verbatim copying and distribution of this entire article is permitted in any medium under the terms of the [GNU FDL](http://www.gnu.org/licenses/fdl.html), unless otherwise stated. <br />Ideas, requests, problems regarding the Hurd wiki at %WIKITOOLNAME%? Send [feedback](mailto:%WIKIWEBMASTER%?subject=%WIKITOOLNAME% Feedback). </font> - -* Exclude web from a `web="all"` search: (Set to `on` for hidden webs; is overwritten by web preferences) - * Set NOSEARCHALL = - -* Web specific background color: (is overwritten by web preferences) - * Set WEBBGCOLOR = #C0C0C0 - -* %TWIKIWEB%.PreviewBackground image: - * Set PREVIEWBGIMAGE = %PUBURLPATH%/%TWIKIWEB%/PreviewBackground/previewbg.gif - -* Background color of non existing topic: ( default `cornsilk` or `#FFFFCE` ) - * Set NEWTOPICBGCOLOR = #FFFFCE - -* Font color of non existing topic: ( default `#0000FF` ) - * Set NEWTOPICFONTCOLOR = #0000FF - -* Horizontal size of text edit box: (can be overwritten by user preferences) - * Set EDITBOXWIDTH = 80 - -* Vertical size of text edit box: (can be overwritten by user preferences) - * Set EDITBOXHEIGHT = 43 - -* Default state of the **_Release edit lock_** ([[UnlockTopic]]) check box in preview. Checkbox is initially checked if `Set RELEASEEDITLOCKCHECKBOX = checked="checked"`, or unchecked if empty. If checked, make sure to click on <u>Edit</u> to do more changes; do **not** go back in your browser to the edit page, or you risk that someone else will edit the topic at the same time: (can be overwritten by user preferences) - * Set RELEASEEDITLOCKCHECKBOX = checked - -* Default state of the **_Minor Changes, Don't Notify_** ([[DontNotify]]) check box in preview. Check box is initially checked if `Set DONTNOTIFYCHECKBOX = checked="checked"`, or unchecked if empty: (can be overwritten by user preferences) - * Set DONTNOTIFYCHECKBOX = - -* Default state of the **_link_** check box in the attach file page. Checkbox is initially checked if `Set ATTACHLINKBOX = checked="checked"`, or unchecked if empty (`Set ATTACHLINKBOX =`). If checked, a link is created to the attached file at the end of the topic: (can be overwritten by user preferences) - * Set ATTACHLINKBOX = - -* Format of file link when the **_link_** check box is checked: (can be overwritten by user preferences) - * Set ATTACHEDFILELINKFORMAT = \\t\* [[ATTACHURLname]]: $comment - * **_Note:_** Keyword `$name` gets expanded to filename; `$comment` to comment; `\t` to tab (3 spaces for bullets). - -* Format of images when the **_link_** check box is checked: (can be overwritten by user preferences) - * Set ATTACHEDIMAGEFORMAT = \\t\* $comment: <br /> - * **_Note:_** Above image is shown as broken, it gets expanded correctly when you attach an image. - * **_Note:_** Keyword `$name` gets expanded to filename; `$comment` to comment; `$size` to `width="..." height="..."` attribute of `img` tag; `\t` to tab (3 spaces for bullets). - -* Wiki webmaster ([[Main/JoachimNilsson]]) email address: - * Set WIKIWEBMASTER = <joachim@gnufansNOSPAM.org> - -* Wiki Tool Name: - * Set WIKITOOLNAME = Gnufans - -* Mail host for outgoing mail. This is used for [[WebChangesAlert]] if Perl module <code>**Net::SMTP**</code> is installed. If not, or if `SMTPMAILHOST` is empty, the external sendmail program is used instead (defined by <code>**$mailProgram**</code> in <code>**TWiki.cfg**</code>). Examples: `mail.your.company` or `localhost` - * Set SMTPMAILHOST = - -* Mail domain sending mail. SMTP requires that you identify the TWiki server sending mail. If not set, <code>**Net::SMTP**</code> will guess it for you. Examples: `twiki.your.company` - * Set SMTPSENDERHOST = - -* [[TWikiPlugins]] configuration: All plugin modules that exist in the `lib/TWiki/Plugins` directory are activated automatically unless disabled by DISABLEDPLUGINS. You can optionally list the installed plugins in INSTALLEDPLUGINS. This is useful to define the sequence of plugin execution, or to specify other webs then the %TWIKIWEB% web for the plugin topics. Specify plugins as a comma separated list of topics. - * Set INSTALLEDPLUGINS = [[TWiki/DefaultPlugin]] - * Set DISABLEDPLUGINS = [[EmptyPlugin]] - * Currently activated plugins: %ACTIVATEDPLUGINS% - * **_Note:_** In case you have a rough plugin you can disable all plugins with the <code>**$disableAllPlugins**</code> flag in the `TWiki.cfg` file. - -* http-equiv meta tags for **_view_**, **_rdiff_**, **_attach_**, **_search\*_** scripts: - - * Set HTTP_EQUIV_ON_VIEW = - -* http-equiv meta tags for **_edit_** script. Example to expire immediately: <br /><code>Set HTTP\_EQUIV\_ON\_EDIT = <meta http-equiv="Expires" content="%GMTIME\{"$day $month, $year - $hour:$min:$sec"\}% GMT"></code> - - * Set HTTP_EQUIV_ON_EDIT = - -* http-equiv meta tags for **_preview_** script: - - * Set HTTP_EQUIV_ON_PREVIEW = - -* Users or groups allowed to change or rename this %TOPIC% topic: (I.e. %MAINWEB%.TWikiAdminGroup) - * Set ALLOWTOPICCHANGE = %MAINWEB%.TWikiAdminGroup - * Set ALLOWTOPICRENAME = - -* Site-level preferences that are **not** allowed to be overridden by %WEBPREFSTOPIC% and user preferences: - * Set FINALPREFERENCES = PREVIEWBGIMAGE, WIKIWEBMASTER, SMTPMAILHOST , SMTPSENDERHOST - -* Skin and session plugin settings - * Set SKINHANDLER = Gnu - * Set SKIN = gnu - * Set SKINS = gnu,tiger,blue,cat,plain,print - -**_Notes:_** - -* A preference is defined as: <br />`6 spaces * Set NAME = value`<br /> Example: - * Set WEBBGCOLOR = #FFFFC0 -* Preferences are used as %TWIKIWEB%.TWikiVariables by enclosing the name in percent signs. Example: - * When you write variable <code>%WEBBGCOLOR%</code> , it gets expanded to `%WEBBGCOLOR%` . -* The sequential order of the preference settings is significant. Define preferences that use other preferences first, i.e. set <code>WEBCOPYRIGHT</code> before <code>WIKIWEBMASTER</code> since <code>%WEBCOPYRIGHT%</code> uses the <code>%WIKIWEBMASTER%</code> variable. -* You can introduce new variables and use them in your topics and templates. There is no need to change the %WIKITOOLNAME% engine (Perl scripts). - -**_Related Topics:_** - -* %WEBPREFSTOPIC% has preferences of the %WIKITOOLNAME%.%WEB% web. -* %MAINWEB%.%WIKIUSERSTOPIC% has a list of user topics. User topics can have optional user preferences. -* %TWIKIWEB%.TWikiVariables has a list of common <code>%VARIABLES%</code> . -* %TWIKIWEB%.TWikiAccessControl explains how to restrict access by users or groups. diff --git a/TWiki/TWikiRegistration.mdwn b/TWiki/TWikiRegistration.mdwn deleted file mode 100644 index d4cb76cb..00000000 --- a/TWiki/TWikiRegistration.mdwn +++ /dev/null @@ -1,218 +0,0 @@ -<font> **_Please note:_** Automatic registration is disabled! </font> - -<font> Each application is **_reviewed manually_** --- an email is sent out when your account is activated. </font> - -We very much appreciate you creating your own account and use that in favor of the [[Main/TWikiGuest]] account. _We regret_ that it is no longer fully automatic, but that is what the wonderful world of TWiki:Codev/WikiSpam gives us today. - -An account of your own helps us handle copyright issues with contributed material from unknown people. See the [[HurdWikiCopyrightDiscuss]] topic for more information. NO information from this site will be used for any purposes other than for use on this site -- we will never sell a list of registered users. - -<font> Set Location:HurdUser to speed up your activation. </font> - -<form action="%SCRIPTURL%/register%SCRIPTSUFFIX%/%MAINWEB%/%HOMETOPIC%" method="post"> - <table border="1"> - <tr> - <td align="right"> First &amp; last name: </td> - <td><input name="Twk1Name" onblur="var sIn = this.value; var sOut = ''; var chgUpper = true; for ( var i = 0; i < sIn.length; i++ ) { var ch = sIn.charAt( i ); var ch2 = ''; if((ch=='à')||(ch=='á')||(ch=='â')||(ch=='ã')||(ch=='å') ) { ch = 'a'; } if( (ch=='è')||(ch=='é')||(ch=='ê') ) { ch = 'e'; } if( ch=='ç') { ch = 'c'; } if( ch=='ñ') { ch = 'n'; } if( (ch=='ò')||(ch=='ó')||(ch=='ô') ) { ch = 'o'; } if( ch=='ä') { ch = 'a'; ch2 = 'e'; } if( ch=='ö') { ch = 'o'; ch2 = 'e'; } if( (ch=='ù')||(ch=='ú')||(ch=='û') ) { ch = 'o'; } if( ch=='ü') { ch = 'u'; ch2 = 'e'; } if( ch=='Ä') { ch = 'A'; ch2 = 'e'; } if( ch=='Ö') { ch = 'O'; ch2 = 'e'; } if( ch=='Ü') { ch = 'U'; ch2 = 'e'; } if( ch=='ß') { ch = 's'; ch2 = 's'; } if( ((ch>='a')&&(ch<='z')) || ((ch>='A')&&(ch<='Z')) ) { if( chgUpper ) { ch = ch.toUpperCase(); chgUpper = false; } sOut+=ch; if( ch2!='') { sOut+=ch2; } } else { if( ch==' ' ) { chgUpper = true; } } } this.form.Twk1WikiName.value=sOut;" size="40" type="text" value="" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right"> Your [[WikiName]]: </td> - <td><input name="Twk1WikiName" size="40" type="text" value="" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right"> Email address: </td> - <td><input name="Twk1Email" size="40" type="text" value="" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right"> Your password: </td> - <td><input name="Twk1Password" size="40" type="password" value="" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right"> Retype password: </td> - <td><input name="Twk1Confirm" size="40" type="password" value="" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right"> Company name: </td> - <td><input name="Twk0CompanyName" size="40" type="text" value="" /></td> - </tr> - <tr> - <td align="right"> Company URL: <br /> (or department URL) </td> - <td><input name="Twk0CompanyURL" onblur="if(this.value=='http://') { this.value='' }" onfocus="if(this.value=='') { this.value='http://' }" size="40" type="text" /></td> - </tr> - <tr> - <td align="right"> Location: </td> - <td><select name="Twk1Location" size="1"><option selected value="">Select...</option> - <option>SanJoseOffice</option> - <option>LondonOffice</option> - <option>TokyoOffice</option> - <option>VasterasOffice</option> - <option>VirtualOffice</option> - <option>HurdUser</option> - <option value="(Please specify office location)">Other</option></select> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right"> Country: </td> - <td><select name="Twk1Country" size="1"><option selected value="">Select...</option> - <option>USA</option> - <option>Albania</option> - <option>Algeria</option> - <option>Angola</option> - <option>Argentina</option> - <option>Armenia</option> - <option>Aruba</option> - <option>Australia</option> - <option>Austria</option> - <option>Azerbaijan</option> - <option>Bahrain</option> - <option>Bangladesh</option> - <option>Belgium</option> - <option>Belize</option> - <option>Benin</option> - <option>Bolivia</option> - <option>Bosnia and Hercegovina</option> - <option>Brazil</option> - <option>Bulgaria</option> - <option>Burundi</option> - <option>Cambodia</option> - <option>Cameroon</option> - <option>Canada</option> - <option>Central African Republic</option> - <option>Chile</option> - <option>China</option> - <option>Colombia</option> - <option>Congo</option> - <option>Costa Rica</option> - <option>Croatia</option> - <option>Cyprus</option> - <option>Czech Republic</option> - <option>Denmark</option> - <option>Ecuador</option> - <option>Egypt</option> - <option>El Salvador</option> - <option>Estonia</option> - <option>Ethiopia</option> - <option>Fiji</option> - <option>Finland</option> - <option>France</option> - <option>Georgia</option> - <option>Germany</option> - <option>Gibraltar</option> - <option>Greece</option> - <option>Guam</option> - <option>Guatemala</option> - <option>Haiti</option> - <option>Hong Kong</option> - <option>Hungary</option> - <option>Iceland</option> - <option>India</option> - <option>Indonesia</option> - <option>Iran</option> - <option>Iraq</option> - <option>Ireland</option> - <option>Israel</option> - <option>Italy</option> - <option>Japan</option> - <option>Jordan</option> - <option>Kazakstan</option> - <option>Kenya</option> - <option>Korea</option> - <option>Kuwait</option> - <option>Kyrgyz Rebublic</option> - <option>Laos</option> - <option>Latvia</option> - <option>Lebanon</option> - <option>Liberia</option> - <option>Liechtenstein</option> - <option>Lithuania</option> - <option>Luxembourg</option> - <option>Libya</option> - <option>Macao</option> - <option>Macedonia</option> - <option>Malaysia</option> - <option>Malawi</option> - <option>Malta</option> - <option>Mexico</option> - <option>Monaco</option> - <option>Morocco</option> - <option>Mozambique</option> - <option>Namibia</option> - <option>Nepal</option> - <option>Netherlands</option> - <option>New Zealand</option> - <option>Nicaragua</option> - <option>Nigeria</option> - <option>Norway</option> - <option>Oman</option> - <option>Pakistan</option> - <option>Panama</option> - <option>Paraguay</option> - <option>Peru</option> - <option>Philippines</option> - <option>Poland</option> - <option>Portugal</option> - <option>Romania</option> - <option>Russia</option> - <option>Saudi Arabia</option> - <option>Senegal</option> - <option>Singapore</option> - <option>Slovakia</option> - <option>Slovenia</option> - <option>South Africa</option> - <option>Spain</option> - <option>Sri Lanka</option> - <option>Suriname</option> - <option>Sweden</option> - <option>Switzerland</option> - <option>Syria</option> - <option>Taiwan</option> - <option>Tanzania</option> - <option>Thailand</option> - <option>Tajikistan</option> - <option>Tunisia</option> - <option>Turkey</option> - <option>Turkmenistan</option> - <option>Uganda</option> - <option>Ukraine</option> - <option>United Arab Emirates</option> - <option>United Kingdom</option> - <option>Uruguay</option> - <option>USA</option> - <option>Uzbekistan</option> - <option>Vatican City</option> - <option>Venezuela</option> - <option>Vietnam</option> - <option>Yemen</option> - <option>Yugoslavia</option> - <option>Zaire</option> - <option>Zambia</option> - <option>Zimbabwe</option> - <option value="Other Country">Other Country</option></select> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right" valign="top"> Comments : <br /> (optional) </td> - <td> - <textarea cols="38" name="Twk0Comment" rows="4" wrap="virtual"> - </textarea> - </td> - </tr> - <tr> - <td align="right" valign="top"> <input name="TopicName" type="hidden" value="%TOPIC%" /></td> - <td><input type="submit" value=" Submit " /> (Fields marked <code><font color="red">**</font></code> are required) </td> - </tr> - </table> -</form> - -**_Submitting the form will:_** - -* _Almost_ create an account for you, the Wiki admin will first review your application before **_manually_** enabling your account. -* Create your personal %WIKITOOLNAME% topic using your [[WikiName]] as topic name, and add the data you submitted to the topic. -* Add your name to the list of users in the %MAINWEB%.%WIKIUSERSTOPIC% topic in the %WIKITOOLNAME%.%MAINWEB% web. -* Send you a confirmation of your registration by email. - -**_Remember:_** - -* %TWIKIWEB%.ResetPassword: If you forget your password. -* Be nice. - -If you have any questions about registration, send an email to [%WIKIWEBMASTER%](mailto:%WIKIWEBMASTER%?subject=%TOPIC% Question). - -To edit pages on this %WIKITOOLNAME% Collaborative Web, you must have a registered user name and password. <br />**_Note:_** You can also login anonymously as user <code>TWikiGuest</code> with password `guest` diff --git a/TWiki/TWikiRegistrationNone.mdwn b/TWiki/TWikiRegistrationNone.mdwn deleted file mode 100644 index e7e3917a..00000000 --- a/TWiki/TWikiRegistrationNone.mdwn +++ /dev/null @@ -1,65 +0,0 @@ -To edit pages on this %WIKITOOLNAME% Collaborative Web, you must have a registered user name in [[WikiNotation]]. - -To register as a new user, simply fill out this form: - -<form action="%SCRIPTURL%/register%SCRIPTSUFFIX%/%MAINWEB%/%HOMETOPIC%" method="post"> - <table border="1"> - <tr> - <td align="right"> First &amp; last name: </td> - <td><input name="Twk1Name" onblur="var sIn = this.value; var sOut = ''; var chgUpper = true; for ( var i = 0; i < sIn.length; i++ ) { var ch = sIn.charAt( i ); var ch2 = ''; if((ch=='à')||(ch=='á')||(ch=='â')||(ch=='ã')||(ch=='å') ) { ch = 'a'; } if( (ch=='è')||(ch=='é')||(ch=='ê') ) { ch = 'e'; } if( ch=='ç') { ch = 'c'; } if( ch=='ñ') { ch = 'n'; } if( (ch=='ò')||(ch=='ó')||(ch=='ô') ) { ch = 'o'; } if( ch=='ä') { ch = 'a'; ch2 = 'e'; } if( ch=='ö') { ch = 'o'; ch2 = 'e'; } if( (ch=='ù')||(ch=='ú')||(ch=='û') ) { ch = 'o'; } if( ch=='ü') { ch = 'u'; ch2 = 'e'; } if( ch=='Ä') { ch = 'A'; ch2 = 'e'; } if( ch=='Ö') { ch = 'O'; ch2 = 'e'; } if( ch=='Ü') { ch = 'U'; ch2 = 'e'; } if( ch=='ß') { ch = 's'; ch2 = 's'; } if( ((ch>='a')&&(ch<='z')) || ((ch>='A')&&(ch<='Z')) ) { if( chgUpper ) { ch = ch.toUpperCase(); chgUpper = false; } sOut+=ch; if( ch2!='') { sOut+=ch2; } } else { if( ch==' ' ) { chgUpper = true; } } } this.form.Twk1WikiName.value=sOut;" size="40" type="text" value="" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right"> Your [[WikiName]]: </td> - <td><input name="Twk1WikiName" size="40" type="text" value="" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right"> Intranet login name: </td> - <td><input name="Twk1LoginName" size="40" type="text" value="%REMOTE_USER%" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right"> Email address: </td> - <td><input name="Twk1Email" size="40" type="text" value="" /> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right"> Phone: </td> - <td><input name="Twk0Phone" size="40" type="text" value="" /></td> - </tr> - <tr> - <td align="right"> Department: </td> - <td><input name="Twk0Department" size="40" type="text" value="" /></td> - </tr> - <tr> - <td align="right"> Office location: </td> - <td><select name="Twk1Location" size="1"><option selected value="">Select...</option> - <option>SanJoseOffice</option> - <option>LondonOffice</option> - <option>TokyoOffice</option> - <option>VasterasOffice</option> - <option value="(Please specify office location)">Other</option></select> <code><font color="red">**</font></code></td> - </tr> - <tr> - <td align="right" valign="top"> Comments : <br /> (optional) </td> - <td> - <textarea cols="38" name="Twk0Comment" rows="4" wrap="virtual"> - </textarea> - </td> - </tr> - <tr> - <td align="right" valign="top"> <input name="TopicName" type="hidden" value="%TOPIC%" /></td> - <td><input type="submit" value=" Submit " /> (Fields marked <code><font color="red">**</font></code> are required) </td> - </tr> - </table> -</form> - -**_Submitting the form will automatically:_** - -* Create an account for you, so that you can start editing pages using your [[WikiName]]. -* Create your personal %WIKITOOLNAME% topic using your [[WikiName]] as topic name, and add the data you submitted to the topic. -* Add your name to the list of users in the %MAINWEB%.%WIKIUSERSTOPIC% topic in the %WIKITOOLNAME%.%MAINWEB% web. -* Send you a confirmation of your registration by email. - -Once registered you can login using your [[WikiName]] and password. - -If you have any questions about registration, send an email to [%WIKIWEBMASTER%](mailto:%WIKIWEBMASTER%?subject=%TOPIC% Question). [http://www.shop263.com/i-1/901.htm 丁二酸二甲酯] [http://www.shop263.com/i-1/902.htm 艺雕刻用牛角] [http://www.shop263.com/i-1/903.htm 异丙胺] [http://www.shop263.com/i-1/904.htm 异丙苯] [http://www.shop263.com/i-1/905.htm 异丙醇] [http://www.shop263.com/i-1/906.htm 异丙醇铝] [http://www.shop263.com/i-1/907.htm 异丙基] [http://www.shop263.com/i-1/908.htm 异丙基黄药] [http://www.shop263.com/i-1/909.htm 异丙醚] [http://www.shop263.com/i-1/910.htm 异丁醇] [http://www.shop263.com/i-1/911.htm 异丁基黄药] [http://www.shop263.com/i-1/912.htm 异丁酰氯] [http://www.shop263.com/i-1/913.htm 异庚烷] [http://www.shop263.com/i-1/914.htm 异喹啉] [http://www.shop263.com/i-1/915.htm 异喹啉羧酸] [http://www.shop263.com/i-1/916.htm 异硫氰酸苯酯] [http://www.shop263.com/i-1/917.htm 异氰尿酸] [http://www.shop263.com/i-1/918.htm 异氰酸环已酯] [http://www.shop263.com/i-1/919.htm 异氰酸正丁酯] [http://www.shop263.com/i-1/920.htm 异氰酸酯] [http://www.shop263.com/i-1/921.htm 异戊醇] [http://www.shop263.com/i-1/922.htm 异戊二稀] [http://www.shop263.com/i-1/923.htm 异戊烯醇] [http://www.shop263.com/i-1/924.htm 异辛胺] [http://www.shop263.com/i-1/925.htm 异辛酸钾] [http://www.shop263.com/i-1/926.htm 异辛酸钠] [http://www.shop263.com/i-1/927.htm 异辛烷] [http://www.shop263.com/i-1/928.htm 阴离子型聚丙烯酰胺] [http://www.shop263.com/i-1/929.htm 阴燃增塑剂] [http://www.shop263.com/i-1/930.htm 银粉] [http://www.shop263.com/i-1/931.htm 银杏叶干浸膏] [http://www.shop263.com/i-1/932.htm 吲哚] [http://www.shop263.com/i-1/933.htm 印花布] [http://www.shop263.com/i-1/934.htm 荧光增白剂] [http://www.shop263.com/i-1/935.htm 萤蒽] [http://www.shop263.com/i-1/936.htm 萤光增白剂] [http://www.shop263.com/i-1/937.htm 硬脂酸] [http://www.shop263.com/i-1/938.htm 硬脂酸钡] [http://www.shop263.com/i-1/939.htm 硬脂酸钙] [http://www.shop263.com/i-1/940.htm 硬脂酸镉] [http://www.shop263.com/i-1/941.htm 硬脂酸铝] [http://www.shop263.com/i-1/942.htm 硬脂酸镁] [http://www.shop263.com/i-1/943.htm 硬脂酸铅] [http://www.shop263.com/i-1/944.htm 硬脂酸双铝] [http://www.shop263.com/i-1/945.htm 硬脂酸系列] [http://www.shop263.com/i-1/946.htm 硬脂酸锌] [http://www.shop263.com/i-1/947.htm 硬脂酸盐] [http://www.shop263.com/i-1/948.htm 硬质聚氨酯泡沫] [http://www.shop263.com/i-1/949.htm 油剂聚醚] [http://www.shop263.com/i-1/950.htm 油墨清洗剂] [http://www.shop263.com/i-1/951.htm 油漆] [http://www.shop263.com/i-1/952.htm 油漆工业用溶剂油] [http://www.shop263.com/i-1/953.htm 油酸] [http://www.shop263.com/i-1/954.htm 油酸酰胺] [http://www.shop263.com/i-1/955.htm 油田杀菌剂] [http://www.shop263.com/i-1/956.htm 油田钻井液] [http://www.shop263.com/i-1/957.htm 有机氟] [http://www.shop263.com/i-1/958.htm 有机氟化盐] [http://www.shop263.com/i-1/959.htm 有机硅] [http://www.shop263.com/i-1/960.htm 有机硅乳液] [http://www.shop263.com/i-1/961.htm 有机硅微乳] [http://www.shop263.com/i-1/962.htm 有机硅消泡剂] [http://www.shop263.com/i-1/963.htm 有机硅粘接剂] [http://www.shop263.com/i-1/964.htm 有机过氧化物引发剂] [http://www.shop263.com/i-1/965.htm 有机合成] [http://www.shop263.com/i-1/966.htm 有机磷肥] [http://www.shop263.com/i-1/967.htm 有机卤化物] [http://www.shop263.com/i-1/968.htm 有机膜涂料] [http://www.shop263.com/i-1/969.htm 有机酸] [http://www.shop263.com/i-1/970.htm 有机烷基磷酸酯类增塑剂] [http://www.shop263.com/i-1/971.htm 有机溴阻燃剂] [http://www.shop263.com/i-1/972.htm 有机颜料] [http://www.shop263.com/i-1/973.htm 有机液体] [http://www.shop263.com/i-1/974.htm 有磷氮] [http://www.shop263.com/i-1/975.htm 三氯乙烯] [http://www.shop263.com/i-1/976.htm 梭织机桨料] [http://www.shop263.com/i-1/977.htm 釉用色料] [http://www.shop263.com/i-1/978.htm 玉米淀粉] [http://www.shop263.com/i-1/979.htm 浴液基料] [http://www.shop263.com/i-1/980.htm 愈创木酚] [http://www.shop263.com/i-1/981.htm 愈创木酚磺酸钾] [http://www.shop263.com/i-1/982.htm 园艺喷洒油] [http://www.shop263.com/i-1/983.htm 原甲酸三甲酯] [http://www.shop263.com/i-1/984.htm 原甲酸三乙酯] [http://www.shop263.com/i-1/985.htm 原盐] [http://www.shop263.com/i-1/986.htm 原乙酸三甲酯] [http://www.shop263.com/i-1/987.htm 月桂氮酮] [http://www.shop263.com/i-1/988.htm 云母钛珠光颜料] [http://www.shop263.com/i-1/989.htm 匀染剂] [http://www.shop263.com/i-1/990.htm 杂环] [http://www.shop263.com/i-1/991.htm 皂粒] [http://www.shop263.com/i-1/992.htm 皂片] [http://www.shop263.com/i-1/993.htm 皂用脂肪酸] [http://www.shop263.com/i-1/994.htm 造纸助剂] [http://www.shop263.com/i-1/995.htm 增白剂] [http://www.shop263.com/i-1/996.htm 增稠剂] [http://www.shop263.com/i-1/997.htm 增塑剂] [http://www.shop263.com/i-1/998.htm 增炭剂] [http://www.shop263.com/i-1/999.htm 渣油阻垢剂] [http://www.shop263.com/i-1/1000.htm 粘合剂] [http://www.shop263.com/i-1/1001.htm 樟脑粉] [http://www.shop263.com/i-1/1002.htm 蔗糖八乙酸] [http://www.shop263.com/i-1/1003.htm 蔗糖脂肪酸酯] [http://www.shop263.com/i-1/1004.htm 蔗糖酯] [http://www.shop263.com/i-1/1005.htm 珍珠魚卵革] [http://www.shop263.com/i-1/1006.htm 真皮絨] [http://www.shop263.com/i-1/1007.htm 正丁醇] [http://www.shop263.com/i-1/1008.htm 正庚酸] [http://www.shop263.com/i-1/1009.htm 正庚烷] [http://www.shop263.com/i-1/1010.htm 正己烷] [http://www.shop263.com/i-1/1011.htm 正钛酸四丁酯] [http://www.shop263.com/i-1/1012.htm 正戊酸] [http://www.shop263.com/i-1/1013.htm 正戊烷] [http://www.shop263.com/i-1/1014.htm 正戊酰氯] [http://www.shop263.com/i-1/1015.htm 正辛胺] [http://www.shop263.com/i-1/1016.htm 正已烷] [http://www.shop263.com/i-1/1017.htm 织物阻燃] [http://www.shop263.com/i-1/1018.htm 脂肪胺] [http://www.shop263.com/i-1/1019.htm 脂肪醇硫酸钠] [http://www.shop263.com/i-1/1020.htm 脂肪酸] [http://www.shop263.com/i-1/1021.htm 植物脂肪酸] [http://www.shop263.com/i-1/1022.htm 纸浆脱墨漂白剂] [http://www.shop263.com/i-1/1023.htm 纸张磨光油] [http://www.shop263.com/i-1/1024.htm 中络黄] [http://www.shop263.com/i-1/1025.htm 中温沥青] [http://www.shop263.com/i-1/1026.htm 种子包衣剂] [http://www.shop263.com/i-1/1027.htm 仲辛醇] [http://www.shop263.com/i-1/1028.htm 重溶剂油] [http://www.shop263.com/i-1/1029.htm 轴承机械油] [http://www.shop263.com/i-1/1030.htm 轴承清洗剂] [http://www.shop263.com/i-1/1031.htm 助留助滤剂] [http://www.shop263.com/i-1/1032.htm 注射葡萄糖] [http://www.shop263.com/i-1/1033.htm 柱层层析硅胶] [http://www.shop263.com/i-1/1034.htm 筑路油] [http://www.shop263.com/i-1/1035.htm 铸造焦] [http://www.shop263.com/i-1/1036.htm 铸造蜡] [http://www.shop263.com/i-1/1037.htm 铸造用呋] [http://www.shop263.com/i-1/1038.htm 铸造用膨润土] [http://www.shop263.com/i-1/1039.htm 铸造用粘结剂] [http://www.shop263.com/i-1/1040.htm 装饰涂料] [http://www.shop263.com/i-1/1041.htm 装修漆] [http://www.shop263.com/i-1/1042.htm 紫外线吸收剂] [http://www.shop263.com/i-1/1043.htm 自粘性保护膜] [http://www.shop263.com/i-1/1044.htm 棕刚玉] [http://www.shop263.com/i-1/1045.htm 棕榈酸] [http://www.shop263.com/i-1/1046.htm 棕榈酸异丙酯] [http://www.shop263.com/i-1/1047.htm 棕榈酸酯] [http://www.shop263.com/i-1/1048.htm 阻燃剂] [http://www.shop263.com/i-1/1049.htm 阻燃母料] [http://www.shop263.com/i-1/1050.htm 组合聚醚] [http://www.shop263.com/i-1/1051.htm 钻井泥浆土木工程用膨润土] [http://www.shop263.com/i-1/1052.htm 左氟羧酸] [http://www.shop263.com/i-1/1053.htm 左旋酒石酸] [http://www.shop263.com/i-1/1054.htm 左旋氧氟沙星环合酯] [http://www.shop263.com/i-1/1055.htm 舒他西林] [http://www.shop263.com/i-1/1056.htm 舒他西林游离碱] [http://www.shop263.com/i-1/1057.htm 树脂粉] [http://www.shop263.com/i-1/1058.htm 树脂油] [http://www.shop263.com/i-1/1059.htm 双苯基脲] [http://www.shop263.com/i-1/1060.htm 双酚A树脂单体] [http://www.shop263.com/i-1/1061.htm 双甘膦] [http://www.shop263.com/i-1/1062.htm 双光气] [http://www.shop263.com/i-1/1063.htm 双环戊二烯] [http://www.shop263.com/i-1/1064.htm 双磺酸] [http://www.shop263.com/i-1/1065.htm 双磺酸钠盐] [http://www.shop263.com/i-1/1066.htm 双氰胺] [http://www.shop263.com/i-1/1067.htm 双三甲基硅脲] [http://www.shop263.com/i-1/1068.htm 双烷基封端聚醚类] [http://www.shop263.com/i-1/1069.htm 双戊二烯树脂] [http://www.shop263.com/i-1/1070.htm 双戊环二烯] [http://www.shop263.com/i-1/1071.htm 双氧水] [http://www.shop263.com/i-1/1072.htm 双氧水催化剂] [http://www.shop263.com/i-1/1073.htm 双乙酸钠] [http://www.shop263.com/i-1/1074.htm 双乙烯酮] [http://www.shop263.com/i-1/1075.htm 双组份阴极电泳漆] [http://www.shop263.com/i-1/1076.htm 霜霉威四氢糠醇] [http://www.shop263.com/i-1/1077.htm 四溴苯酐] [http://www.shop263.com/i-1/1078.htm 阿奇霉素] [http://www.shop263.com/i-1/1079.htm 阿散酸] [http://www.shop263.com/i-1/1070.htm 阿司匹林] [http://www.shop263.com/i-1/1081.htm 阿斯巴甜] [http://www.shop263.com/i-1/1082.htm 安息香双甲醚] [http://www.shop263.com/i-1/1083.htm 桉叶油] [http://www.shop263.com/i-1/1084.htm 氨化] [http://www.shop263.com/i-1/1085.htm 氨基] [http://www.shop263.com/i-1/1086.htm 氨基C酸] [http://www.shop263.com/i-1/1087.htm 氨基苯甲酸] [http://www.shop263.com/i-1/1088.htm 氨基吡啶] [http://www.shop263.com/i-1/1089.htm 氨基丙醇] [http://www.shop263.com/i-1/1090.htm 氨基丙酸] [http://www.shop263.com/i-1/1091.htm 氨基蒽醌] [http://www.shop263.com/i-1/1092.htm 氨基二苯醚] [http://www.shop263.com/i-1/1093.htm 氨基胍硫酸盐] [http://www.shop263.com/i-1/1094.htm 氨基胍碳酸氢盐] [http://www.shop263.com/i-1/1095.htm 氨基胍碳酸盐] [http://www.shop263.com/i-1/1096.htm 氨基胍重碳酸盐] [http://www.shop263.com/i-1/1097.htm 氨基官能团硅烷] [http://www.shop263.com/i-1/1098.htm 氨基磺酸] [http://www.shop263.com/i-1/1099.htm 氨基磺酸铵] [http://www.shop263.com/i-1/1100.htm 氨基磺酸胍] [http://www.shop263.com/i-1/1101.htm 氨基磺酸镍] [http://www.shop263.com/i-1/1102.htm 氨基甲酸甲酯] [http://www.shop263.com/i-1/1103.htm 氨基甲酸乙酯] [http://www.shop263.com/i-1/1104.htm 氨基介酸] [http://www.shop263.com/i-1/1105.htm 氨基烤漆] [http://www.shop263.com/i-1/1106.htm 氨基模塑料] [http://www.shop263.com/i-1/1107.htm 氨基葡萄糖盐酸盐] [http://www.shop263.com/i-1/1108.htm 氨基树脂] [http://www.shop263.com/i-1/1109.htm 氨基乙腈硫酸] [http://www.shop263.com/i-1/1110.htm 氨基乙酸] [http://www.shop263.com/i-1/1111.htm 氨基有机硅] [http://www.shop263.com/i-1/1112.htm 氨甲苯酸] [http://www.shop263.com/i-1/1113.htm 氨甲环酸] [http://www.shop263.com/i-1/1114.htm 氨甲基] [http://www.shop263.com/i-1/1115.htm 氨酪酸] [http://www.shop263.com/i-1/1116.htm 氨力农] [http://www.shop263.com/i-1/1117.htm 铵明矾] [http://www.shop263.com/i-1/1118.htm 螯合铁] [http://www.shop263.com/i-1/1119.htm 奥美普林] [http://www.shop263.com/i-1/1120.htm 八水氢氧化锶] [http://www.shop263.com/i-1/1121.htm 八溴醚] [http://www.shop263.com/i-1/1122.htm 钯碳] [http://www.shop263.com/i-1/1123.htm 白电油] [http://www.shop263.com/i-1/1124.htm 白蜂蜡] [http://www.shop263.com/i-1/1125.htm 白糊精] [http://www.shop263.com/i-1/1126.htm 白蒺藜提取物] [http://www.shop263.com/i-1/1127.htm 白矿油] [http://www.shop263.com/i-1/1128.htm 白藜芦醇] [http://www.shop263.com/i-1/1129.htm 白炭黑] [http://www.shop263.com/i-1/1130.htm 柏木油] [http://www.shop263.com/i-1/1131.htm 半胱胺酸] [http://www.shop263.com/i-1/1132.htm 钡镉膏稳定剂] [http://www.shop263.com/i-1/1133.htm 钡锶盐] [http://www.shop263.com/i-1/1134.htm 倍硫磷] [http://www.shop263.com/i-1/1135.htm 贲亭酸甲酯] [http://www.shop263.com/i-1/1136.htm 苯胺] [http://www.shop263.com/i-1/1137.htm 苯胺甲基三乙氧基硅烷] [http://www.shop263.com/i-1/1138.htm 苯丙酮] [http://www.shop263.com/i-1/1139.htm 苯并环庚酮] [http://www.shop263.com/i-1/1140.htm 苯并噻唑] [http://www.shop263.com/i-1/1141.htm 苯对甲基苯甲醚] [http://www.shop263.com/i-1/1142.htm 苯甘氨酸对钾盐] [http://www.shop263.com/i-1/1143.htm 苯磺酰胺] [http://www.shop263.com/i-1/1144.htm 苯磺酰氯] [http://www.shop263.com/i-1/1145.htm 苯基] [http://www.shop263.com/i-1/1146.htm 苯基丙酰氯] [http://www.shop263.com/i-1/1147.htm 苯甲基硅油] [http://www.shop263.com/i-1/1148.htm 苯甲醛] [http://www.shop263.com/i-1/1149.htm 苯甲酸] [http://www.shop263.com/i-1/1150.htm 苯甲酸钠] [http://www.shop263.com/i-1/1151.htm 苯甲酰酒石酸] [http://www.shop263.com/i-1/1152.htm 苯甲酰氯] [http://www.shop263.com/i-1/1153.htm 苯钾酸钠] [http://www.shop263.com/i-1/1154.htm 苯偶酰] [http://www.shop263.com/i-1/1155.htm 苯偶姻] [http://www.shop263.com/i-1/1156.htm 苯骈三氮唑] [http://www.shop263.com/i-1/1157.htm 苯三甲酸酐] [http://www.shop263.com/i-1/1158.htm 苯亚磺酸钠] [http://www.shop263.com/i-1/1159.htm 苯氧基苯胺] [http://www.shop263.com/i-1/1160.htm 苯氧基四溴双酚] [http://www.shop263.com/i-1/1161.htm 苯乙腈] [http://www.shop263.com/i-1/1162.htm 苯乙酸] [http://www.shop263.com/i-1/1163.htm 苯乙酮] [http://www.shop263.com/i-1/1164.htm 苯乙烯] [http://www.shop263.com/i-1/1165.htm 苯乙烯化苯酚] [http://www.shop263.com/i-1/1166.htm 苯乙烯脱氢催化剂] [http://www.shop263.com/i-1/1167.htm 苯乙酰氯] [http://www.shop263.com/i-1/1168.htm 苯已酮] [http://www.shop263.com/i-1/1169.htm 笨乙腈] [http://www.shop263.com/i-1/1170.htm 笨乙酸] [http://www.shop263.com/i-1/1171.htm 比赛可灵] [http://www.shop263.com/i-1/1172.htm 吡虫啉原药] [http://www.shop263.com/i-1/1173.htm 吡啶甲酸铬] [http://www.shop263.com/i-1/1174.htm 吡啶醇酯] [http://www.shop263.com/i-1/1175.htm 吡啶羧酸铬] [http://www.shop263.com/i-1/1176.htm 吡啶盐酸盐] [http://www.shop263.com/i-1/1177.htm 吡啶乙酸盐酸盐] [http://www.shop263.com/i-1/1178.htm 吡喹酮] [http://www.shop263.com/i-1/1179.htm 吡咯酮] [http://www.shop263.com/i-1/1180.htm 吡咯烷酮] [http://www.shop263.com/i-1/1181.htm 吡咯烷酮羧酸钾] [http://www.shop263.com/i-1/1182.htm 吡咯烷酮羧酸钠] [http://www.shop263.com/i-1/1183.htm 吡咯烷酮装置] [http://www.shop263.com/i-1/1184.htm 必性硅油] [http://www.shop263.com/i-1/1185.htm 铋盐] [http://www.shop263.com/i-1/1186.htm 避蚊胺] [http://www.shop263.com/i-1/1187.htm 苄叉丙酮] [http://www.shop263.com/i-1/1188.htm 苄基三甲基氯化胺] [http://www.shop263.com/i-1/1189.htm 苄基三乙基氯化铵] [http://www.shop263.com/i-1/1190.htm 变性淀粉] [http://www.shop263.com/i-1/1191.htm 别嘌醇] [http://www.shop263.com/i-1/1192.htm 冰醋酸] [http://www.shop263.com/i-1/1193.htm 丙氨酸] [http://www.shop263.com/i-1/1194.htm 丙胺] [http://www.shop263.com/i-1/1195.htm 丙二醇] [http://www.shop263.com/i-1/1196.htm 丙二腈] [http://www.shop263.com/i-1/1197.htm 丙二酸酯类] [http://www.shop263.com/i-1/1198.htm 丙基] [http://www.shop263.com/i-1/1199.htm 丙基咪唑二羧酸] [http://www.shop263.com/i-1/1200.htm 丙基咪唑二羧酸二乙酯] - -[http://www.haishun.net 门禁] [http://www.haishun.net 监控] [http://www.genset-sh.com 发电机] [http://www.haishun.net/p\_mjds.htm 门禁] [http://www.haishun.net/p\_mjds\_dmmj.htm 门禁] [http://www.haishun.net/p\_mjds\_lwmj.htm 门禁] [http://www.haishun.net/p\_mjds\_yjs.htm 门禁] [http://www.haishun.net/cctv.htm 监控] [http://www.haishun.net/p\_cctv\_jk.htm 监控] [http://www.haishun.net/p\_cctv\_jk\_sxj.htm 监控] [http://www.haishun.net/p\_cctv\_jk\_xsq.htm 监控] [http://www.haishun.net/p\_cctv\_jk\_yplxj.htm 监控] [http://www.haishun.net/p\_cctv\_jk\_yt.htm 监控] [http://www.haishun.net/p\_cctv\_jk\_zj.htm 监控] [http://www.7766888.com 虚拟主机] [http://www.7766888.com/introcom.htm asp虚拟主机] [http://www.7766888.com/introcn.htm php虚拟主机] [http://www.7766888.com/u\_puji.htm unix虚拟主机] [http://www.7766888.com/mysql.htm windows虚拟主机] [http://www.7766888.com/u\_jingji.htm 纯空间虚拟主机] [http://www.7766888.com/u\_biaozhun.htm 虚拟主机] [http://www.7766888.com/u\_zhiqiang.htm 虚拟主机] [http://www.7766888.com/w\_jingji.htm 虚拟主机] [http://www.7766888.com/w\_biaozhun.htm 虚拟主机] [http://www.asp169.com/marketingsoft1.htm 空压机] [http://www.asp169.com/marketingsoft2.htm 压缩机] [http://www.asp169.com/zhaoguan.htm 消毒剂] [http://www.asp169.com/crm.htm 化妆品] [http://www.asp169.com/marketingsoft3.htm 战略咨询] [http://www.asp169.com/marketingsoft4.htm 武夷山] [http://www.asp169.com/marketingsoft5.htm 数据恢复] [http://haishun11.51.net 虚拟主机] [http://decorate.51.net 装修] [http://decorate.51.net 团购] [http://www.xsjby.cn 化工泵] [http://www.asp169.com/zhaoguan2.htm 二氧化氯] [http://www.fm360.net 网址大全] [http://www.fm360.net/page/001.html 网址大全] [http://www.fm360.net/page/game.htm 网址大全] [http://www.fm360.net/page/software.htm 网址大全] [http://www.fm360.net/page/jinshi.htm 网址大全] [http://www.fm360.net/page/music.htm 网址大全] [http://www.fm360.net/page/053.html 网址大全] [http://www.fm360.net/page/flash.htm 网址大全] [http://www.fm360.net/page/newsweek.htm 网址大全] [http://www.fm360.net/page/club.htm 网址大全] [http://www.fm360.net/page/stock.htm 网址大全] [http://www.fm360.net/page/love.htm 网址大全] [http://www.fm360.net/page/netcard.htm 网址大全] [http://www.fm360.net/page/025.html 网址大全] [http://www.fm360.net/page/hardware.htm 网址大全] [http://www.fm360.net/page/sport.htm 网址大全] [http://www.fm360.net/page/shouji.htm 网址大全] [http://www.fm360.net/page/ym.htm 网址大全] [http://www.fm360.net/page/ylbj.htm 网址大全] [http://www.fm360.net/page/car.htm 网址大全] [http://www.jifamark.com 线号机] [http://www.jifamark.com/xhj.htm 线号机] [http://www.jifamark.com 打号机] [http://www.funasia.cn 装修] [http://www.funasia.cn 团购] [http://www.funasia.cn/pinpai.asp 装修] [http://www.funasia.cn/client/gb\_list.asp 装修] [http://www.funasia.cn/design/index.asp 装修] [http://www.funasia.cn/funasiaHome/index.asp 装修] [http://www.funasia.cn/jiancai.asp 装修] [http://www.funasia.cn/shishang.asp 装修] [http://www.funasia.cn/mall/AboutOur.htm 团购] [http://www.genset-sh.com/cai.asp 发电机] [http://www.genset-sh.com/tancu.asp 发电机] [http://www.genset-sh.com/xi3.asp 发电机] [http://www.genset-sh.com/lan.asp 发电机] [http://www.genset-sh.com/leng.asp 发电机] [http://www.genset-sh.com/jiyou.asp 发电机] [http://www.genset-sh.com/ranyou.asp 发电机] [http://www.genset-sh.com/kuongqi.asp 发电机] [http://www.genset-sh.com/ssss.asp 发电机] [http://www.zj-df.com 减速机] [http://www.xhhj.com.cn 离心机] [http://www.hdfix.com.cn 数据恢复] diff --git a/TWiki/TWikiShorthand.mdwn b/TWiki/TWikiShorthand.mdwn deleted file mode 100644 index 1d7f2be2..00000000 --- a/TWiki/TWikiShorthand.mdwn +++ /dev/null @@ -1,302 +0,0 @@ -%TOC\{depth="4"\}% %STARTINCLUDE% - -# <a name="TWiki_Shorthand"> TWiki Shorthand </a> - -Working in TWiki is as easy as typing in text - exactly like email. You don't need to know HTML, though you can use it if you prefer. Links to topics are created automatically when you enter [[WikiWords]]. And [[TWikiShorthand]] gives you all the power of HTML with a simple coding system that takes little time to learn. It's all layed out below - refer back to this table in a pop-up window from the **Edit** screen. - -<table bgcolor="#000000" border="0" cellpadding="3" cellspacing="1"> - <tr bgcolor="#ffffff"> - <td><strong>Formatting Command:</strong></td> - <td><strong>Example: You write:</strong></td> - <td><strong>You get:</strong></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Paragraphs:</strong><br /> Blank lines will create new paragraphs. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -1st paragraph - -2nd paragraph -</pre> </font></span></td> - <td valign="top"> 1st paragraph <p> 2nd paragraph </p> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Headings:</strong><br /> At least three dashes at the beginning of a line, followed by plus signs and the heading text. One plus creates a level 1 heading (most important), two pluses a level 2 heading; the maximum is level 6. <strong><em>Note:</em></strong> A Table of Content can be created automatically with the <code>%<nop>TOC%</nop></code> variable, see [[TWikiVariables]]. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -<nop>---++ Sushi - -<nop>---+++ Maguro -</nop></nop></pre> </font></span></td> - <td valign="top"> - <h2>Sushi</h2> - <p> - </p> - <h3>Maguro</h3> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Bold Text:</strong><br /> Words get <strong>bold</strong> by enclosing them in <code>*</code> asterisks. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -*Bold* -</pre> </font></span></td> - <td valign="top"><strong>Bold</strong></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Italic Text:</strong><br /> Words get <em>italic</em> by enclosing them in <code>_</code> underscores. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -_Italic_ -</pre> </font></span></td> - <td valign="top"><em>Italic</em></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Bold Italic:</strong><br /> Words get <em>_bold italic</em> by enclosing them in <code>_</code> double-underscores. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -__Bold italic__ -</pre> </font></span></td> - <td valign="top"><strong><em>Bold italic</em></strong></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Fixed Font:</strong><br /> Words get shown in <code>fixed font</code> by enclosing them in <code><nop>=<nop></nop></nop></code> equal signs. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -=Fixed font= -</pre> </font></span></td> - <td valign="top"><code>Fixed font</code></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Bold Fixed Font:</strong><br /> Words get shown in <code><b>bold fixed font</b></code> by enclosing them in <code><b><nop></nop></b></code> double equal signs. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -==Bold fixed== -</pre> </font></span></td> - <td valign="top"><code><b>Bold fixed</b></code></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong><em>Note:</em></strong> Make sure to "stick" the <code>* _ = <nop>==<nop></nop></nop></code> signs to the words, e.g. take away spaces. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -_This works_, -_this not _ -</pre> </font></span></td> - <td valign="top"><em>This works</em>, _this not _ </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Verbatim Mode:</strong><br /> Surround code excerpts and other formatted text with <code>&lt;verbatim&gt;</code> and <code>&lt;/verbatim&gt;</code> tags. <br /><strong><em>Note:</em></strong> Use <code>&lt;pre&gt;</code> and <code>&lt;/pre&gt;</code> tags instead if you want HTML code to be interpreted. <br /><strong><em>Note:</em></strong> Each tag must be on a line by itself. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -&lt;verbatim&gt; -class CatAnimal { - void purr() { - &lt;code here&gt; - } -} -&lt;/verbatim&gt; -</pre> </font></span></td> - <td valign="top"><pre> -class CatAnimal { - void purr() { - &lt;code here&gt; - } -} -</pre></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Separator:</strong><br /> At least three dashes at the beginning of a line. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -------- -</pre> </font></span></td> - <td valign="top"> - <hr /> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>List Item:</strong><br /> Three spaces and an asterisk. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> - * bullet item -</pre> </font></span></td> - <td valign="top"> - <ul> - <li> bullet item </li> - </ul> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Nested List Item:</strong><br /> Six, nine, ... spaces and an asterisk. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> - * nested stuff -</pre> </font></span></td> - <td valign="top"> - <ul> - <li> - <ul> - <li> nested stuff </li> - </ul> - </li> - </ul> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Ordered List:</strong><br /> Three spaces and a number. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> - 1 Sushi - 1 Dim Sum -</pre> </font></span></td> - <td valign="top"> - <ol> - <li> Sushi </li> - <li> Dim Sum </li> - </ol> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Definition List:</strong><br /> Three spaces, the term, a colon, a space, followed by the definition. <br /><strong><em>Note:</em></strong> Terms with spaces are not supported. In case you do have a term with more then one word, separate the words with dashes or with the <code>&amp;nbsp;</code> non-breaking-space entity. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> - Sushi: Japan - Dim&amp;nbsp;Sum: S.F. -</pre> </font></span></td> - <td valign="top"> - <dl> - <dt> Sushi</dt> - <dd> Japan </dd> - <dt> Dim Sum</dt> - <dd> S.F. </dd> - </dl> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Table:</strong><br /> Optional spaces followed by the cells enclosed in vertical bars. <br /><strong><em>Note:</em></strong> <code>| <nop>*bold*<nop> |</nop></nop></code> cells are rendered as table headers. <br /><strong><em>Note:</em></strong> <code>| spaced |</code> cells are rendered center aligned. <br /><strong><em>Note:</em></strong> <code>| spaced |</code> cells are rendered right aligned. <br /><strong><em>Note:</em></strong> <code>| 2 colspan ||</code> cells are rendered as multi-span columns. <br /><strong><em>Note:</em></strong> In case you have a long row and you want it to be more readable when you edit the table you can split the row into lines that end with a <code>'\'</code> backslash character. <br /> - </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -| *L* | *C* | *R* | -| A2 | 2 | 2 | -| A3 | 3 | 3 | -| multi span ||| -| A4 \<nop> - | next \<nop> - | next | -</nop></nop></pre> </font></span></td> - <td valign="top"> - <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>L</strong></th> - <th bgcolor="#99CCCC"><strong>C</strong></th> - <th bgcolor="#99CCCC"><strong>R</strong></th> - </tr> - <tr> - <td> A2 </td> - <td align="center"> 2 </td> - <td align="right"> 2 </td> - </tr> - <tr> - <td> A3 </td> - <td align="center"> 3 </td> - <td align="right"> 3 </td> - </tr> - <tr> - <td colspan="3"> multi span </td> - </tr> - <tr> - <td> A4 </td> - <td> next </td> - <td> next </td> - </tr> - </table> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong><nop>WikiWord Links:</nop></strong><br /><nop>CapitalizedWordsStuckTogether (or [[WikiWords]]) will produce a link automatically. <br /><strong><em>Note:</em></strong> In case you want to link to a topic in a different %WIKITOOLNAME% web write <code>Webname.TopicName</code>. </nop></td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -WebNotify - -Know.ReadmeFirst -</pre> </font></span></td> - <td valign="top">[[WebNotify]]<p>[[Know/ReadmeFirst]]</p> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><a name="SquareBrackets"></a> <strong>Forced Links:</strong><br /> You can create a forced internal link by enclosing words in double square brackets. <br /><strong><em>Note:</em></strong> Text within the brackets may contain optional spaces; the topic name is formed by capitalizing the initial letter and by removing the spaces; i.e. <code>[<nop>[text formatting FAQ]]</nop></code> links to topic [[TextFormattingFAQ]]. You can also refer to a different web and use anchors. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -[[wiki syntax]] - -[[%MAINWEB%.TWiki users]] -</pre> </font></span></td> - <td valign="top">[[WikiSyntax]]<p>[[MAINWEBTWikiUsers]]</p> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Specific Links:</strong><br /> Create a link where you can specify the link text and the link reference separately, using nested square brackets like <code>[<nop>[reference][text]]</nop></code>. Internal link references (i.e. [[WikiSyntax]]) and external link references (i.e. <a href="http://TWiki.org/)" target="_top">http://TWiki.org/)</a> are supported. The same <strong><em>Forced Links</em></strong> rules apply for internal link references. Anchor names can be added as well, like <code>[<nop>[WebHome#MyAnchor][go home]]</nop></code> and <code>[<nop>[http://www.yahoo.com/#somewhere][Yahoo!]]</nop></code>. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -[[WikiSyntax][syntax]] - -[[http://gnu.org][GNU]] -</pre> </font></span></td> - <td valign="top">[[WikiSyntax]]<p><a href="http://gnu.org" target="_top">GNU</a></p> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Anchors:</strong><br /> You can define a link reference inside a %WIKITOOLNAME% topic (called an anchor name) and link to that. To <strong><em>define</em></strong> an anchor write <code>#AnchorName</code> at the beginning of a line. The anchor name must be a [[WikiWord]]. To <strong><em>link to</em></strong> an anchor name use the <code>[<nop>[MyTopic#MyAnchor]]</nop></code> syntax. You can omit the topic name if you want to link within the same topic. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -[[WebHome#NotThere]] - -[[#MyAnchor][Jump]] - -#MyAnchor To here -</pre> </font></span></td> - <td valign="top">[[WebHome]]<p> Jump </p> - <p><a name="MyAnchor"></a> To here </p> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Prevent a Link:</strong><br /> Prevent a [[WikiWord]] from being linked by prepending it with the <code>&lt;nop&gt;</code> tag. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -&lt;nop&gt;SunOS -</pre> </font></span></td> - <td valign="top"><nop>SunOS </nop></td> - </tr> -</table> - -## <a name="Using_HTML"> </a> Using HTML - -You can use just about any HTML tag without a problem, HOWEVER, it's recommended NOT to. Using [[TWikiShorthand]], you can do practically anything you'd normally do with HTML, and it keeps the text uncluttered and easy for people to browse edit. - -## <a name="Hyperlinks"> Hyperlinks </a> - -Being able to create links without any formatting required is a core TWiki feature, made possible with [[WikiWords]]. New TWiki linking rules are a simple extension of the syntax that provide a new set of flexible options. - -### <a name="Internal_Links"> Internal Links </a> - -* [[GoodStyle]] is a [[WikiWord]] that links to the GoodStyle topic located in the current %WIKITOOLNAME% web. - -* [[NotExistingYet]] is a topic waiting to be written. Create the topic by clicking on the **?**. (Try clicking, but then, **Cancel** - creating the topic would wreck this example!) - -### <a name="External_Links"> External Links </a> - -* `http://...`, `https://...`, `ftp://...` and `mailto:...@...` are linked automatically. - -* Email addresses like `name@domain.com` are linked automatically. - -* <code>[[Square bracket rules]]</code> let you easily create non-WikiWord links. - -## <a name="TWiki_Variables"> TWiki Variables </a> - -[[TWikiVariables]] are names that are enclosed in percent signs `%` that are expanded on the fly. Using the existing variables, and even creating your own, adds an amazing extra level of content to your posts. For example: - -* <code>%TOC%</code> : Automatically generates a table of contents based on headings in a topic - see the top of this page for an example. - -* <code>%WEB%</code> : The current web, is **%WEB%**. - -* <code>%TOPIC%</code> : The current topic name, is **%TOPIC%**. - -* <code>%ATTACHURL%</code> : The attachment URL of the current topic. Example usage: If you attach a file to a topic you can refer to it as <code>**%ATTACHURL%/image.gif**</code> to show the URL of the file or the image in your text. - -* <code>%INCLUDE\{"SomeTopic"\}%</code> : Server side include, includes another topic. The current %WIKITOOLNAME% web is the default web. Example: <code>**%INCLUDE\{"%TWIKIWEB%.TWikiWebsTable"\}%**</code> - -* There are many more variables, see **[[TWikiVariables]]**. - -## <a name="Common_Editing_Errors"> Common Editing Errors </a> - -TWiki formatting rules are fairly simple to use and quick to type. However, there are some things to watch out for, taken from the [[TextFormattingFAQ]]: - -* **Q:** Text enclosed in angle brackets like `<filename>` is not displayed. How can I show it as it is? - * **A:** The `'<'` and `'>'` characters have a special meaning in HTML, they define HTML tags. You need to escape them, so write `'<'` instead of `'<'`, and `'>'` instead of `'>'`. <br /> Example: Type `'prog <filename>'` to get `'prog <filename>'`. - -* **Q:** Why is the `'&'` character sometimes not displayed? - * **A:** The `'&'` character has a special meaning in HTML, it starts a so called character entity, i.e. `'©'` is the `©` copyright character. You need to escape `'&'` to see it as it is, so write `'&'` instead of `'&'`. <br /> Example: Type `'This & that'` to get `'This & that'`. - --- [[Main/MikeMannix]] - 02 Dec 2001 diff --git a/TWiki/TWikiSite.mdwn b/TWiki/TWikiSite.mdwn deleted file mode 100644 index 48072a83..00000000 --- a/TWiki/TWikiSite.mdwn +++ /dev/null @@ -1,58 +0,0 @@ -## <a name="TWiki_is_a_Web_based_collaborati"> TWiki is a Web-based collaboration platform </a> - -* A TWiki site is an easy-to-use, full-featured, open communication environment: - * people anywhere on the Web or on an intranet can meet - * rich Web text, images, and online multimedia are easily shared - * documents and other files can be uploaded and downloaded - * everything works through a regular Web browser - -### <a name="TWiki_is_a_powerful_Web_enhancem"> TWiki is a powerful Web enhancement... </a> - -* TWiki's parsing engine is written in Perl. It reads a text file, and converts TWiki shorthand into standard HTML, on the fly. The point is to: - * make adding and editing text simple _(How simple? Click on the **Edit** link at the bottom of the page...)_ - * let you find information _fast_ ([[WebSearch]]) - -* TWiki provides an intuitive way to meet and collaborate, that aspires to the Zen ideals known as [[WabiSabi]]. It finds beauty in the imperfect and ephemeral and constantly evolving. When it comes down to it, that's all you need. - -* TWiki is one of many [[WikiWikiClones]], based on Ward Cunningham's original [Wiki Wiki Web](http://c2.com/). - -### <a name="_TWiki_stands_for_"> "TWiki" stands for... </a> - -* _Wiki wiki_ means "quick" in Hawaiian. The shuttle at Honolulu Airport is called the _wiki wiki_ bus, which is where the original Wiki web got its name. -* _TWiki_ is short for _TakeFive Wiki_ from the name of the company where its founder worked. (It was later discovered that _Twiki_ is also the name of an AI robot that co-starred in the [_Buck Rogers..._](http://www.buck-rogers.com/) movie and TV show from 1979 - its head is in the logo.) - -### <a name="Selected_TWiki_Topics_"> Selected TWiki Topics... </a> - -* [[TWikiPages]] tells you how to do administrative things, like renaming topics. -* [[TWikiHistory]] timelines TWiki's development. -* [[TWikiPlannedFeatures]] lists of approved additions to future TWiki versions. -* [[TWikiEnhancementRequests]] is the place to add your new feature requests. -* [[TWikiDocumentation]] is the complete reference manual. -* [[WikiCulture]] looks at the unique type of collaboration Wiki systems offer. -* [[WikiReferences]] links to articles and books about collaboration and Wiki technology. - -> **_NOTE:_** -> -> If you have to log-in to us TWiki, for example, if Twiki is running on an intranet, it automatically signs new pages with your -> -> -> -> [[WikiName]] -> -> . If your TWiki installation doesn't require a log-in, TWiki gives everyone the same username: -> -> -> -> [[Main/TWikiGuest]] -> -> . - -TWiki<sup>TM</sup> is a trademark of [[PeterThoeny]], originator and lead developer. - -* TWiki is developed as Free Software under the [[GnuGeneralPublicLicense]] -* TWiki's home address is <http://twiki.org/>. -* Source code is available upon request: see <http://twiki.org/download.html>. -* [[WelcomeGuest]] is a fast track guide to TWiki. -* This site is powered by TWiki version **%WIKIVERSION%**. - --- [[Main/MikeMannix]] - 01 Dec 2001 diff --git a/TWiki/TWikiSiteTools.mdwn b/TWiki/TWikiSiteTools.mdwn deleted file mode 100644 index adb29435..00000000 --- a/TWiki/TWikiSiteTools.mdwn +++ /dev/null @@ -1,92 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWikiSiteTools"> TWikiSiteTools </a> - -_Utilities for searching, navigation, and monitoring site activity_ - -## <a name="Overview"> Overview </a> - -[[TWikiSiteTools]] include utilities for navigating, searching and keeping up with site activity. Preferences can be configured by web or site-wide. You are currently in the **%TWIKIWEB%** web. In particular, TWiki provides two highly configurable, automated site monitoring tools, **WebNotify**, to email alerts when topics are edited, and **WebStats**, to generate detailed activity reports. - -## <a name="WebNotify_Recent_Changes_Alert"> WebNotify Recent Changes Alert </a> - -Each TWiki web has an automatic email alert service that sends a list of recent changes on a preset schedule, like once a day. Users can subscribe and unsubscribe using %NOTIFYTOPIC% in each web. The Perl script `mailnotify` is called by a deamon in regular intervals. The script sends an automated email to subscribed users if topics were changed in a web within last interval. - -* You can create a [[WebNotify]] using [[TWikiVariables]] with <code>**%NOTIFYTOPIC%**</code> - -### <a name="Configuring_Outgoing_Mail"> Configuring Outgoing Mail </a> - -%WIKITOOLNAME% will use the <code>**Net::SMTP**</code> module if it is installed on your system. Set this with the <code>**SMTPMAILHOST**</code> variable in [[TWikiPreferences]]. - -You can use an external mail program, like <code>**sendmail**</code>, if the `Net::SMTP` module is not installed. Set the program path in <code>**$mailProgram**</code> in <code>**TWiki.cfg**</code>. - -* %H% Net::SMTP can be easily disabled (ex: if there is an installation error) by setting <code>**SMTPMAILHOST**</code> in [[TWikiPreferences]] to an empty value. - -* %T% You can set a separate <code>**SMTPSENDERHOST**</code> variable to define the mail sender host (some SMTP installations require this). - -### <a name="Setting_the_Automatic_Email_Sche"> Setting the Automatic Email Schedule </a> - -**For Unix platforms:** Edit the `cron` table so that `mailnotify` is called in an interval of your choice. Please consult `man crontab` of how to modify the table that schedules program execution at certain intervals. Example: - - % crontab -e - 15,45 * * * * (cd ~twiki/public_html/bin; ./mailnotify -q) - -The above line will call mailnotify at 15 minutes and 45 minutes past every hour. The `-q` switch suppresses all normal output. - -**For ISP installations:** Many ISPs don't allow hosted accounts direct cron access, as it's often used for things that can heavily load the server. Workaround scripts are available. - -**On Windows NT/2000:** You can use a scheduled task if you have administrative privileges. **_Note:_** AT on an NT machine is pretty limited. Microsoft lists several third-party [replacements](http://www.microsoft.com/ntserver/partners/findoffering/serversolutions/Maintnce.asp#cron) (as of 2001-11-20, none of them free). - -## <a name="WebStatistics_Site_Usage_Log"> WebStatistics Site Usage Log </a> - -You can generate a listing manually, or on an automated schedule, of visits to individual pages, on a per web basis. Compiled as a running total on a monthly basis. Includes totals for Topic Views, Topic Saves, Attachment Uploads, Most Popular Topics with number of views, and Top Contributors showing total of saves and attachment uploads. Previous months are saved. - -* You can create a [[WebStatistics]] link using [[TWikiVariables]] with <code>**%STATISTICSTOPIC%**</code> - -### <a name="Configuring_for_Automatic_Operat"> Configuring for Automatic Operation </a> - -* You can automatically generate usage statistics for all webs. To enable this: - * Make sure variable `$doLogTopicView, $doLogTopicSave and $doLogTopicUpload` in `TWiki.cfg` are set. This will generate log entries in file `twiki/data/log<date>.txt` . - * The [[WebStatistics]] topic must be present in all webs where you want to have statistics. You can use the topic in the Main web as a template. - * Call the `twiki/bin/statistics` script from a cron job, once a day is recommended. This will update the [[WebStatistics]] topics in all webs. - * **_Attention:_** The script must run as the same user as the CGI scripts are running, which is user `nobody` on most systems. Example crontab entry: <br />`0 0 * * * (cd /path/to/TWiki/bin; ./statistics >/dev/null 2>&1)` - * There is a workaround in case you can't run the script as user `nobody` : Run the utility `twiki/bin/geturl` in your cron job and specify the URL of the `twiki/bin/statistics` script as a parameter. Example: <br />`0 0 * * * (cd /path/to/TWiki/bin; ./geturl mydomain.com /urlpath/to/TWiki/bin/statistics >/dev/null 2>&1)` - -### <a name="Generating_Statistics_Manually_b"> </a> Generating Statistics Manually by URL - -* The `twiki/bin/statistics` script can also be executed as a CGI script, just enter the URL in your browser. Examples: - * Update current month for all webs: <br />`http://mydomain.com/twiki/bin/statistics` - * Update current month for Main web only: <br />`http://mydomain.com/twiki/bin/statistics/Main` - * Update January 2000 for Main web: <br />`http://mydomain.com/twiki/bin/statistics/Main?logdate=200001` - -## <a name="WebSearch"> WebSearch </a> - -[[WebSearch]] is an extremely fast and flexible search facility, part of the core TWiki feature set. Options include: - -* topic title or full-text search -* regular expressions -* search within web or site-wide -* index-style A-Z alphabetical listing sorted topic title -* many more - -See also: [[TWikiVariables]] for including hard-coded searches in text. - -### <a name="WebChanges"> WebChanges </a> - -To check for the most recently edited topics while on-site, use the [[WebChanges]] link, usually located on the upper toolbar. It lists the most recently modified topics, newest first, along with the first couple of lines of the page content. - -This is simply a preset `SEARCH`. The number of topics listed by the `limit` parameter.: - -> <pre> -> %<nop>SEARCH{".*" web="%INCLUDINGWEB%" regex="on" nosearch="on" order="modified" <br />reverse="on" limit="50"}% -> </nop></pre> - -### <a name="WebIndex"> WebIndex </a> - -[[WebIndex]] lists all web topics in alphabetical order, with the first couple of lines of text. This is simply a preset `SEARCH`: - -> <pre> -> %<nop>SEARCH{"\.*" scope="topic" regex="on" nosearch="on"}% -> </nop></pre> - --- [[Main/MikeMannix]] - 01 Dec 2001 diff --git a/TWiki/TWikiSkins.mdwn b/TWiki/TWikiSkins.mdwn deleted file mode 100644 index e9be3043..00000000 --- a/TWiki/TWikiSkins.mdwn +++ /dev/null @@ -1,28 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_Skins"> TWiki Skins </a> - -_Skins overlay regular templates with alternate header/footer layouts; topic text is not affected_ - -## <a name="Overview"> Overview </a> - -Skins are customized [[TWikiTemplates]] files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example, the layout of the header and footer. Rendered text between header and footer does **_not_** change. You can also use skins to define an alternate view, like a view optimized for printing. - -## <a name="Defining_Skins"> Defining Skins </a> - -Skin files are located in the `twiki/templates` directory and are named with the syntax: <code>**<scriptname>.<skin>.tmpl**</code>. For example, the **Printable** skin for the `view` template is `view.print.tmpl`. - -## <a name="Activating_Skins"> Activating Skins </a> - -A skin can be activated in two ways: - -* Define the `SKIN` Preference variable in [[TWiki/TWikiPreferences]], one of the [[WebPreferences]], or in a user - %WIKIUSERNAME% - topic. - * `Set SKIN = print` - -* Add `?skin=name` to the URL, for this example: - * %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?skin=print (for the print view skin) - * %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?skin=plain (for the plain view skin that has no header and footer) - -The <code>**?skin=name**</code> URL parameter overrides the SKIN Preference value. - --- [[PeterThoeny]] - 14 Jul 2001 <br /> diff --git a/TWiki/TWikiTemplates.mdwn b/TWiki/TWikiTemplates.mdwn deleted file mode 100644 index 9929d8c4..00000000 --- a/TWiki/TWikiTemplates.mdwn +++ /dev/null @@ -1,247 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_Templates"> TWiki Templates </a> - -_Definition of the templates used to render all HTML pages displayed in TWiki_ - -## <a name="Overview"> Overview </a> - -The new modular template system offers flexible, easy control over the layout of all TWiki pages. The master template approach groups parts that are shared by several templates - like headers and footers - in a common file. Special variables allow individual layouts to include parts from a master template - variables are mixed with regular HTML mark-up for template-specific content. Templates are used to define page layout, and also to supplydefault content for new pages. - -## <a name="Major_changes_from_the_previous_"> Major changes from the previous template system </a> - -Where the old templates were each complete HTML documents, the new templates are defined using variables to include template parts from a master file. You can now change one instance of a common element to update all occurrences; previously, every affected template had to be updated. This simplifies the conversion of templates into XHTML format, and provides a more versatile solution for templates and for [[TWikiSkins]]. The new system: - -* separates a set of common template parts into a base template that is included by all of the related templates; -* defines common variables, like a standard separator (ex: "|"), in the base template; -* defines variable text in the individual templates and passes it back to the base template. - -## <a name="Functional_Specifications"> Functional Specifications </a> - -* Special template directives (or preprocessor commands) are embedded in normal templates. -* Use of template directives is optional, templates work without them. -* All template preprocessing is done in `&TWiki::Store::readTemplate()` so that the caller simply gets an expanded template file (the same as before). -* Directives are of the form <code>%TMPL:<key>%</code> and <code>%TMPL:<key>\{"attr"\}%</code>. -* Directives: - * <code>%TMPL:INCLUDE\{"file"\}%</code>: Includes a template file. The template directory of the current web is searched first, then the templates root (`twiki/templates`). - * <code>%TMPL:DEF\{"var"\}%</code>: Define a variable. Text between this and the END directive is not returned, but put into a hash for later use. - * <code>%TMPL:END%</code>: Ends variable definition. - * <code>%TMPL:P\{"var"\}%</code>: Prints a previously defined variable. -* Variables are live in a global name space, there is no parameter passing. -* Two-pass processing, so that you can use a variable before declaring it or after. -* Templates and [[TWikiSkins]] work transparently and interchangeably. For example, you can create a skin that overloads just the `twiki.tmpl`, like `twiki.print.tmpl`, that redefines the header and footer. -* **_NOTE:_** The template directives work only for templates, they do not get processed in topic text. - -## <a name="TWiki_Master_Template"> TWiki Master Template </a> - -All common parts are defined in a master template, <code>**twiki.tmpl**</code>, that all other templates use. - -> <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <th bgcolor="#99CCCC"><strong>Template variable:</strong></th> -> <th bgcolor="#99CCCC"><strong>Defines:</strong></th> -> </tr> -> <tr> -> <td> %<nop>TMPL:DEF{"sep"}% </nop></td> -> <td> "|" separator </td> -> </tr> -> <tr> -> <td> %<nop>TMPL:DEF{"htmldoctype"}% </nop></td> -> <td> Start of all HTML pages </td> -> </tr> -> <tr> -> <td> %<nop>TMPL:DEF{"standardheader"}% </nop></td> -> <td> Standard header (ex: view, index, seach) </td> -> </tr> -> <tr> -> <td> %<nop>TMPL:DEF{"simpleheader"}% </nop></td> -> <td> Simple header with reduced links (ex: edit, attach, oops) </td> -> </tr> -> <tr> -> <td> %<nop>TMPL:DEF{"standardfooter"}% </nop></td> -> <td> Footer, excluding revision and copyright parts </td> -> </tr> -> <tr> -> <td> %<nop>TMPL:DEF{"oops"}% </nop></td> -> <td> Skeleton of oops dialog </td> -> </tr> -> </table> - -## <a name="Types_of_Template"> Types of Template </a> - -There are two types of templates: - -* **HTML Page Templates**: Defines layout of %WIKITOOLNAME% pages -* **Template Topics**: Defines default text when you create a new topic - -<a name="HtmlTemplates"></a> - -### <a name="HTML_Page_Templates"> </a> HTML Page Templates - -%WIKITOOLNAME% uses HTML template files for all actions like topic view, edit, preview and so on. This allows you to change the look and feel of all pages by editing just some template files. - -The template files are in the <code>**twiki/templates**</code> directory. As an example, <code>**twiki/templates/view.tmpl**</code> is the template file for the <code>**twiki/bin/view**</code> script. Templates can be overloaded per web. The following search order applies: - -1. <code>**twiki/templates/$webName/$scriptName.tmpl**</code> -2. <code>**twiki/templates/$scriptName.tmpl**</code> - -**_Note:_** `$webName` is the name of the web (ex: `Main`), and <code>**$scriptName**</code> is the script (ex: `view`). - -**_Note:_** [[TWikiSkins]] can be defined to overload the standard templates. - -Special variables are used in templates, especially in `view`, to display [[TWikiMetaData]]. - -<a name="TemplateTopics"></a> - -### <a name="Template_Topics"> Template Topics </a> - -Template topics define the default text for new topics. There are three types of template topics: - -> <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <th bgcolor="#99CCCC"><strong>Topic Name:</strong></th> -> <th bgcolor="#99CCCC"><strong>What it is:</strong></th> -> </tr> -> <tr> -> <td>[[WebTopicViewTemplate]]</td> -> <td> Help text shown when you view a non existing topic. </td> -> </tr> -> <tr> -> <td>[[WebTopicNonWikiTemplate]]</td> -> <td> Help text shown when you view a non existing topic that has not a [[WikiName]]. </td> -> </tr> -> <tr> -> <td>[[WebTopicEditTemplate]]</td> -> <td> Default text shown when you create a new topic. </td> -> </tr> -> </table> - -All template topics are located in the %TWIKIWEB% web. The [[WebTopicEditTemplate]] can be overloaded. The following search order applies when you create a new topic: - -1. The topic name specified by the `templatetopic` CGI parameter. -2. WebTopicEditTemplate in the current web. -3. WebTopicEditTemplate in the %TWIKIWEB% web. - -#### <a name="Template_Topics_in_Action"> Template Topics in Action </a> - -Here is an example for creating new topics based on a specific template topic: - -<form action="%SCRIPTURLPATH%/edit%SCRIPTSUFFIX%/%WEB%/" name="new"> - <ul> - <li> New example topic: <input name="topic" size="23" type="text" value="ExampleTopic%SERVERTIME{$yearx$mox$day}%" /> <input name="templatetopic" type="hidden" value="ExampleTopicTemplate" /> <input type="submit" value="Create" /> (date format is <nop>YYYYxMMxDD) </nop></li> - </ul> -</form> - -Above form asks for a topic name. A hidden input tag of name "templatetopic" specifies the [[ExampleTopicTemplate]] as the template topic. Here is the HTML source of the form: - -<pre> -&lt;form name="new" action="%<nop>SCRIPTURLPATH%/edit%<nop>SCRIPTSUFFIX%/%<nop>WEB%/"&gt; - * New example topic: - &lt;input type="text" name="topic" value="ExampleTopic%<nop>SERVERTIME{$yearx$mox$day}%" size="23" /&gt; - &lt;input type="hidden" name="templatetopic" value="ExampleTopicTemplate" /&gt; - &lt;input type="hidden" name="onlywikiname" value="on" /&gt; - &lt;input type="submit" value="Create" /&gt; - (date format is &lt;nop&gt;YYYYxMMxDD) -&lt;/form&gt; -</nop></nop></nop></nop></pre> - -The "onlywikiname" parameter enforces [[WikiWords]] for topic names. - -**_Note:_** Use can use the <code>%WIKIUSERNAME%</code> and <code>%DATE%</code> variables in your topic templates as the signature; those variables are expanded when a new topic is created. The standard topic signature is: <br /><code>-- %WIKIUSERNAME% - %DATE%</code> - -## <a name="Templates_by_Example"> Templates by Example </a> - -Attached is an example of an oops base template `oopsbase.tmpl` and a example oops dialog `oopstest.tmpl` which is based on the base template. **_NOTE:_** This isn't the release version, just a quick, simple demo. - -### <a name="Base_template_oopsbase_tmpl"> Base template oopsbase.tmpl </a> - -The first line declares the delimiter variable called "sep", used to separate multiple link items. The variable can be called anywhere by writing <code>%TMPL:P\{"sep"\}%</code> - -> <table bgcolor="#f5f5f5" border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <td><pre> -> %<nop>TMPL:DEF{"sep"}% | %<nop>TMPL:END% -> &lt;html&gt; -> &lt;head&gt; -> &lt;title&gt; %<nop>WIKITOOLNAME% . %<nop>WEB% . %<nop>TOPIC% %.TMPL:P{"titleaction"}%&lt;/title&gt; -> &lt;base href<nop>="%<nop>SCRIPTURL%/view%<nop>SCRIPTSUFFIX%/%<nop>WEB%/%<nop>TOPIC%"&gt; -> &lt;meta name="robots" content="noindex"&gt; -> &lt;/head&gt; -> &lt;body bgcolor="#FFFFFF"&gt; -> &lt;table width="100%" border="0" cellpadding="3" cellspacing="0"&gt; -> &lt;tr&gt; -> &lt;td bgcolor="%<nop>WEBBGCOLOR%" rowspan="2" valign="top" width="1%"&gt; -> &lt;a href<nop>="%<nop>WIKIHOMEURL%"&gt; -> &lt;img src="%<nop>PUBURLPATH%/wikiHome.gif" border="0"&gt;&lt;/a&gt; -> &lt;/td&gt; -> &lt;td&gt; -> &lt;b&gt;%<nop>WIKITOOLNAME% . %<nop>WEB% . &lt;/b&gt;&lt;font size="+2"&gt; -> &lt;B&gt;%<nop>TOPIC%&lt;/b&gt; %<nop>TMPL:P{"titleaction"}%&lt;/font&gt; -> &lt;/td&gt; -> &lt;/tr&gt; -> &lt;tr bgcolor="%<nop>WEBBGCOLOR%"&gt; -> &lt;td colspan="2"&gt; -> %<nop>TMPL:P{"webaction"}% -> &lt;/td&gt; -> &lt;/tr&gt; -> &lt;/table&gt; -> --- ++ %<nop>TMPL:P{"heading"}% -> %<nop>TMPL:P{"message"}% -> &lt;table width="100%" border="0" cellpadding="3" cellspacing="0"&gt; -> &lt;tr bgcolor="%<nop>WEBBGCOLOR%"&gt; -> &lt;td valign="top"&gt; -> Topic &lt;b&gt;%<nop>TOPIC%&lt;/b&gt; . { -> %<nop>TMPL:P{"topicaction"}% -> } -> &lt;/td&gt; -> &lt;/tr&gt; -> &lt;/table&gt; -> &lt;/body&gt; -> </nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></pre></td> -> </tr> -> </table> - -### <a name="Test_template_oopstest_tmpl"> Test template oopstest.tmpl </a> - -Each oops template basically just defines some variables and includes the base template that does the layout work. - -> <table bgcolor="#f5f5f5" border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <td><pre> -> %<nop>TMPL:DEF{"titleaction"}% (test =titleaction=) %<nop>TMPL:END% -> %<nop>TMPL:DEF{"webaction"}% test =webaction= %<nop>TMPL:END% -> %<nop>TMPL:DEF{"heading"}% -> Test heading %<nop>TMPL:END% -> %<nop>TMPL:DEF{"message"}% -> Test =message=. Blah blah blah blah blah blah blah blah blah blah blah... -> -> * Some more blah blah blah blah blah blah blah blah blah blah... -> * Param1: %<nop>PARAM1% -> * Param2: %<nop>PARAM2% -> * Param3: %<nop>PARAM3% -> * Param4: %<nop>PARAM4% -> %<nop>TMPL:END% -> %<nop>TMPL:DEF{"topicaction"}% -> Test =topicaction=: -> [<nop>[%<nop>WEB%.%<nop>TOPIC%][OK]] %<nop>TMPL:P{"sep"}% -> [<nop>[%<nop>TWIKIWEB%.TWikiRegistration][Register]] %<nop>TMPL:END% -> %<nop>TMPL:INCLUDE{"oopsbase"}% -> </nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></nop></pre></td> -> </tr> -> </table> - -### <a name="Sample_screen_shot_of_oopstest_t"> Sample screen shot of oopstest.tmpl </a> - -With URL: <code>**.../bin/oops/Test/TestTopic2?template=oopstest&param1=WebHome&param2=WebNotify**</code> - -> <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <td><img alt="testscreen.gif" height="304" src="%ATTACHURL%/testscreen.gif" width="554" /></td> -> </tr> -> </table> - -## <a name="Known_Issues"> Known Issues </a> - -* A drawback of referring to a master template is that you can only test a template from within TWiki, where the include variables are resolved. In the previous system, each template is a structurally complete HTML document with a `.tmpl` filename extension - it contains unresolved `%VARIABLES%`, but can still be previewed directly in a browser. - --- [[PeterThoeny]] - 23 Jul 2001 <br /> -- [[MikeMannix]] - 14 Sep 2001 <br /> diff --git a/TWiki/TWikiTemplates/testscreen.gif b/TWiki/TWikiTemplates/testscreen.gif Binary files differdeleted file mode 100644 index 179b083d..00000000 --- a/TWiki/TWikiTemplates/testscreen.gif +++ /dev/null diff --git a/TWiki/TWikiTutorial.mdwn b/TWiki/TWikiTutorial.mdwn deleted file mode 100644 index 0a7a2432..00000000 --- a/TWiki/TWikiTutorial.mdwn +++ /dev/null @@ -1,90 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="20_Minute_TWiki"> 20-Minute TWiki </a> - -This step-by-step, hands-on tutorial gets you up to speed with all the [[TWikiSite]] basics, in _mere minutes_... - -> ## <a name="1_Get_set_"> 1. Get set... </a> -> -> Open two browser windows, so that you can follow these steps in one window, while trying things out in the other. -> -> ## <a name="2_Take_a_quick_tour_"> 2. Take a quick tour... </a> -> -> A [[TWikiSite]] is divided into webs; each one usually represents one area of collaboration. You can navigate the webs from the upper right corner of each web page. -> -> * Each web has hyperlinked topics, displayed as pages in your browser. -> * The home page in each web is the %HOMETOPIC% topic. -> * To browse a TWiki web, just click on any highlighted link. These links are called [[WikiWords]] and comprise two or more words with initial capitals, run together. -> * Follow the [[WikiWord]] link and learn what it is. -> * If you know the name of a topic, you can jump directly to it by typing its name into the **Go** field on the top of the page. Type `WebSearch` to jump to the search page. **_Hint:_** Do not confuse the **Go** field with search. -> * You can search each TWiki web. Enter a search string in the %HOMETOPIC% topic or the [[WebSearch]] topic accessible from the `Search` link on each topic. TWiki searches for an exact match; optionally, you can also use [[RegularExpressions]]. -> -> ## <a name="3_Open_a_private_account_"> 3. Open a private account... </a> -> -> To edit topics, you need to have a TWiki account. -> -> * Go to the [[TWikiRegistration]] page to create your TWiki account. Fill in a couple of lines and you're set! -> -> ## <a name="4_Check_out_TWiki_users_groups_o"> 4. Check out TWiki users, groups, offices... </a> -> -> * Go to the %MAINWEB%.%WIKIUSERSTOPIC% topic in the TWiki.%MAINWEB% web; it has a list of all users of TWiki. Your [[WikiName]] will be in this list after you register. -> * Go to the %MAINWEB%.TWikiGroups topic in the TWiki.%MAINWEB% web; it has a list of groups which can be used to define fine grained [[TWikiAccessControl]] in TWiki. -> * Go to the %MAINWEB%.OfficeLocations topic in the TWiki.%MAINWEB% web; it has a sample list of corporate offices. This type of set-up can be used for departments, client companies, or any other type of organizational divisions. -> -> ## <a name="5_Test_the_page_controls_"> 5. Test the page controls... </a> -> -> Go to the bottom of the page to see what you can do. The color-coded control strip has a collection of action links: -> -> * <code>**[Edit]**</code> - add to or edit the topic (discussed later) -> * <code>**[Attach]**</code> - attach files to a topic (discussed later) -> * <code>**[Ref-By]**</code> - find out what other topics link to this topic (reverse link) -> * <code>**[Printable]**</code> - goes to a stripped down version of the page, good for printing -> * <code>**[Diffs]**</code> - topics are under revision control - `[Diffs]` shows you the complete change history of the topic, ex: who changed what and when. -> * <code>**[r1.3 | > | r1.2 | > | r1.1]**</code> - view a previous version of the topic or the difference between two versions. -> * <code>**[More]**</code> - additional controls, like <code>**[Rename/move]**</code>, version control and setting the topic's parent. -> -> ## <a name="6_Change_a_page_and_create_a_new"> 6. Change a page, and create a new one... </a> -> -> Go to the [[Test/HOMETOPIC]]. This is the sandbox web, where you can make changes and try it all out at will. -> -> * Click the <code>**[Edit]**</code> link. You are now in edit mode and you can see the source of the page. (Go to a different topic like [[Test/TestTopic3]] in case you see a "Topic is locked by an other user" warning.) -> * Look at the text in edit mode and compare it with the rendered page (move back and forth in your browser.) -> * Notice how [[WikiWords]] are linked automatically; there is no link if you look at the text in edit mode. -> * Now, create a new topic - your own test page: -> 1. In edit mode, enter a new text with a [[WikiWord]], ex: <br /><code>This is YourOwnSandBox topic.</code> -> 2. Preview and save the topic. The name appears, highlighted, with a linked question mark at the end. This means that the topic doesn't exist yet. -> 3. Click on the question mark. Now you're in edit mode of the new topic. -> 4. Type some text, basically, like you write an email. -> 5. A signature with your name is already entered by default. **_NOTE:_** The `%MAINWEB%.` in front of your name means that you have a link from the current web to your personal topic located in the %MAINWEB% web. -> 6. Preview and save the topic... -> * Learn about text formatting. You can enter text in [[TWikiShorthand]], a very simple markup language. Follow the [[TWikiShorthand]] link to see how, then: -> 1. Go back to your sandbox topic end edit it. -> 2. Enter some text in [[TWikiShorthand]]: **bold** text, _italic_ text, **_bold italic_** text, a bullet list, tables, paragraphs, etc. **_Hint:_** If you need help, click on the [[TextFormattingRules]] link located below the text box in edit mode. -> 3. Preview and save the topic. -> -> ## <a name="7_Use_your_browser_to_upload_fil"> 7. Use your browser to upload files as page attachments... </a> -> -> You can attach _any_ type of file to a topic - documents, images, programs, whatever - where they can be opened, viewed, or downloaded. -> -> * Attaching files is just like including a file with an email. -> 1. Go back to your sandbox topic and click on the <code>**[Attach]**</code> link at the bottom. -> 2. Click <code>**[Browse]**</code> to find a file on your PC that you'd like to attach; enter an optional comment; leave everything else unchecked. -> 3. Click <code>**[Upload file]**</code>, then scroll to the end of the page to see the new attachment listing. -> * Do this again - this time, upload a GIF, JPG or PNG image file. -> * Check the <code>**[Link:]**</code> box to _Create a link to the attached file at the end of the topic_. The image will show up at the bottom of the topic. -> * To move the image, edit the topic and place the last line (containing <code>%ATTACHURL%</code>) anywhere on the page. -> * If you have a GIF, JPG or PNG image of yourself, your cat, your sprawling family estate...why not upload it now to personalize your account page: %MAINWEB%.%USERNAME%? -> -> ## <a name="8_Get_email_alerts_whenever_page"> 8. Get email alerts whenever pages are changed... </a> -> -> %NOTIFYTOPIC% is a subscription service that automatically notifies you by email when topics change in a TWiki web. This is a convenience service - for many people, checking email is easier than checking the Web. -> -> * If you're using TWiki to collaborate on a project, it's important to know when anyone on your team posts an update. If you're following a specific discussion, it's convenient to know when there's new input. -> * Alerts are emailed as links to individual topics that've been changed in a set period: each day, every hour, whatever is configured for your system. -> * It's strongly recommended that you try out the service by subscribing to each TWiki web that's relevant to you. You can subscribe and unsubscribe instantly, on a per web basis using %NOTIFYTOPIC%. - -That's it! You're now equipped with all the TWiki essentials. You are ready to roll. - -**_NOTE:_** When first using TWiki, it will probably seem strange to be able to change other people's postings - we're used to _separating_ individual messages, with email, message boards, non-Wiki collaboration platforms. **_Don't worry about it._** You can't accidentally delete important stuff - you can always check previous versions, and copy-and-paste from them if you want to undo any changes. After a short while, TWiki-style free-form communication becomes second-nature. You'll expect it everywhere! - --- [[Main/MikeMannix]] - 01 Dec 2001 diff --git a/TWiki/TWikiUpgradeGuide.mdwn b/TWiki/TWikiUpgradeGuide.mdwn deleted file mode 100644 index 607f6854..00000000 --- a/TWiki/TWikiUpgradeGuide.mdwn +++ /dev/null @@ -1,302 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_Upgrade_Guide"> TWiki Upgrade Guide </a> - -_Upgrade from TWiki 01-Dec-2000 or TWiki 01-Sep-2001 to TWiki 01-Dec-2001 (previous to new full release)_ - -## <a name="Overview"> Overview </a> - -This guide describes how to upgrade either from TWiki 01-Dec-2000 or TWiki 01-Sep-2001 to TWiki 01-Dec-2001. - -* The latest version of TWiki (01-Dec-2001) is a small incremental release over the 01-Sep-2001 version. -* The 01-Sep-2001 version involves several major new features and numerous enhancements to the last full version (01-Dec-2000). The file system set-up is almost identical, but much of the underlying data structure and processes is new. With all the changes, the upgrade procedure is straightforward, and your existing page data is imported directly. - -## <a name="Upgrade_Requirements"> Upgrade Requirements </a> - -* To upgrade from a 01-Dec-2000 or 01-Sep-2001 standard installation to the latest 01-Dec-2001 TWiki Production Release, follow the instructions below. - -* **_NOTE:_** To upgrade from a **pre-01-Dec-2000** TWiki, start with %TWIKIWEB%.TWikiUpgradeTo01Dec2000. - -* To upgrade from a Beta of the new release, or if you made custom modifications to the application, read through all new reference documentation, then use the procedure below as a guideline. - -## <a name="Major_Changes_from_TWiki_01_Sep_"> Major Changes from TWiki 01-Sep-2001 </a> - -The latest 01-Dec-2001 release includes the following new features and enhancements compared to the 01-Sep-2001 release: - -* **[[TWIKIWEBFormattedSearch]]** - New `format=""` parameter in <code>%SEARCH\{\}%</code> variable for database like reporting. -* Various bug fixes - -## <a name="Major_Changes_from_TWiki_01_Dec_"> Major Changes from TWiki 01-Dec-2000 </a> - -The 01-Sep-2001 release includes the following new features and enhancements compared to the 01-Dec-2000 release: - -* **[[TWIKIWEBTWikiPlugins]]** - Easily install program enhancements using external plug-in modules. Developers can create plug-ins in Perl, with the [[TWIKIWEBTWikiPlugins]]. - * %TWIKIWEB%.InterwikiPlugin (preinstalled) - Link to external sites with text aliases, `SiteAlias:Page`; rules are defined in [[InterWikis]]. (Get more Plugins from the TWiki:Plugins web.) -* **[[TWIKIWEBTWikiTemplates]]** - New, more flexible template system. -* **[[TWIKIWEBTWikiSkins]]** - Overwrite template headers and footers; page content is unaffected. -* **[[TWIKIWEBTWikiMetaData]]** - New data format -* **[[TWIKIWEBTWikiForms]]** - Create multiple input forms per web; data is rendered in HTML tables. -* **[[TWIKIWEBManagingTopics]]** - Individual topics can be renamed, moved and deleted through the browser. Deleted topics are stored in a common Trash web. -* **[[TWIKIWEBTWikiUserAuthentication]]** - Change and reset passwords using forms. -* **[[TWIKIWEBTWikiVariables]]** - <code>%TOC%</code> variable generates a hierarchical table of contents from topic headings: <h1>...<h6>. -* **[[TWIKIWEBTWikiVariables]]** - Text formatting rules to generate automatic links from any combination of words and spaces. -* **[[TWIKIWEBFileAttachment]]** - Changes made to files attached to topics are now saved under revision control (RCS). -* **[[TWIKIWEBTWikiAccessControl]]** - Lets you to make the members of one user group - by default, TWikiAdminGroup - into TWiki superusers, with the ability to overwrite locked topics from the browser interface. (This gets around the problem of topic lockouts, caused by typos in access privilege definitions.) -* **HierarchicalNavigation** uses new [[TWIKIWEBTWikiMetaData]] variables to link hierarchically. -* **Convert to XHTML** - Pages are rendered for display in XHTML 1.0, as far as possible without breaking HTML 3.2 compliance. - -## <a name="TWiki_Directory_Structure_and_Fi"> TWiki Directory Structure and File Names </a> - -The TWiki directory structure remains the same, with one exception, the TWiki configuration file and Perl modules have been moved from the `twiki/bin` directory into it's own `twiki/lib` directory tree. The following files have been renamed and moved: - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>From TWiki 01-Dec-2000:</strong></th> - <th bgcolor="#99CCCC"><strong>To TWiki 01-Dec-2001:</strong></th> - </tr> - <tr> - <td><code>twiki/bin/wikicfg.pm</code></td> - <td><code>twiki/lib/TWiki.cfg</code></td> - </tr> - <tr> - <td><code>twiki/bin/wiki.pm</code></td> - <td><code>twiki/lib/TWiki.pm</code></td> - </tr> - <tr> - <td><code>twiki/bin/wikiaccess.pm</code></td> - <td><code>twiki/lib/TWiki/Access.pm</code></td> - </tr> - <tr> - <td><code>twiki/bin/wikiprefs.pm</code></td> - <td><code>twiki/lib/TWiki/Prefs.pm</code></td> - </tr> - <tr> - <td><code>twiki/bin/wikisearch.pm</code></td> - <td><code>twiki/lib/TWiki/Search.pm</code></td> - </tr> - <tr> - <td><code>twiki/bin/wikistore.pm</code></td> - <td><code>twiki/lib/TWiki/Store.pm</code></td> - </tr> -</table> - -A new `twiki/lib/TWiki/Plugins` directory contains the new Plugin modules. - -## <a name="Standard_Upgrade_Procedure_from_"> Standard Upgrade Procedure from 01-Sep-2001 to 01-Dec-2001 Release </a> - -This incremental update can be performed easily. - -The following steps describe the upgrade assuming that `$TWIKIROOT` is the root of your current 01-Sep-2001 release. - -1. Back up and prepare: - * Back up all existing TWiki directories `$TWIKIROOT/bin`, `$TWIKIROOT/pub`, `$TWIKIROOT/data`, `$TWIKIROOT/templates`. - * Create a temporary directory and unpack the ZIP file there. -2. Update files in TWiki root: - * Overwrite all `*.html` and `*.txt` files in `$TWIKIROOT` with the new ones. -3. Update template files: - * Overwrite all template files in `$TWIKIROOT/templates` with the new ones. -4. Update script files: - * Overwrite all script files in `$TWIKIROOT/bin` with the new ones. -5. Update library files: - * Overwrite the `TWiki.pm` library in `$TWIKIROOT/lib` with the new one. - * Overwrite all `*.pm` library files in `$TWIKIROOT/lib/TWiki` and `$TWIKIROOT/lib/TWiki/Plugins` with the new ones. -6. Update data/TWiki files: (in case you want the updated docs) - * Using your browser, merge the new TWiki.TWikiRegistration topic (or TWiki.TWikiRegistrationPub in case you used that one) into your existing TWiki.TWikiRegistration topic. - * In the temporary `twiki/data/TWiki` directory where you unzipped the installation package: - * Remove the files you do **not** want to upgrade: `TWikiPreferences.*`, `TWikiWebsTable.*`, `WebNotify.*`, `WebPreferences.*`, `WebStatistics.*` and all `WebTopic*` files. - * In case the cgi-scripts are not running as user `nobody`: The `*,v` RCS repository files delivered with the installation package are locked by user nobody and need to be changed the user of your cgi-scripts, i.e. `www-data`. A simple way to switch the locker of the RCS files is to use sed: <br />`for f in *,v; do sed 's/nobody\:/www-data\:/' $f > x; mv x $f; done` - * Move all remaining `*.txt` and `*.txt,v` files from the temporary `data/TWiki` directory to your `$TWIKIROOT/data/TWiki` directory. -7. Update pub/TWiki files: - * Move the new `pub/TWiki/TWikiDocGraphics` directory into your `$TWIKIROOT/pub/TWiki` directory. - -## <a name="Standard_Upgrade_Procedure_from_"> Standard Upgrade Procedure from 01-Dec-2000 to 01-Dec-2001 Release </a> - -The idea is to have the new and old installation work in parallel so that you can test the new installation before switching over. That way you can make the switch on your live TWiki installation within one minute without affecting the users. - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC" colspan="2"><strong>Before Switch:</strong></th> - <th bgcolor="#99CCCC" colspan="2"><strong>After Switch:</strong></th> - </tr> - <tr> - <th bgcolor="#99CCCC"><strong>Current 01-Dec-2000:</strong></th> - <th bgcolor="#99CCCC"><strong>New 01-Dec-2001:</strong></th> - <th bgcolor="#99CCCC"><strong>Obsolete 01-Dec-2000:</strong></th> - <th bgcolor="#99CCCC"><strong>New 01-Dec-2001:</strong></th> - </tr> - <tr> - <td><code>twiki/templates/</code></td> - <td><code>twiki/templates2/</code></td> - <td><code>twiki/templates1/</code></td> - <td><code>twiki/templates/</code></td> - </tr> - <tr> - <td><code>twiki/bin/</code></td> - <td><code>twiki/bin/2/</code></td> - <td> (overwritten) </td> - <td><code>twiki/bin/</code></td> - </tr> - <tr> - <td> (N/A) </td> - <td><code>twiki/bin/lib/</code></td> - <td> (N/A) </td> - <td><code>twiki/lib/</code></td> - </tr> - <tr> - <td><code>twiki/data/TWiki</code></td> - <td><code>twiki/data/TWiki2</code></td> - <td><code>twiki/data/TWiki1</code></td> - <td><code>twiki/data/TWiki</code></td> - </tr> - <tr> - <td colspan="4"> (other directories do not change) </td> - </tr> -</table> - -Alternatively you could move the existing installation away, install the 01-Dec-2001 release into it's place and move your webs and pub files back. - -Follow this step-by-step guide to upgrade from the 01-Dec-2000 TWiki to the 01-Dec-2001 release, importing your original page data and related files: - -### <a name="Pre_Upgrade_Preparation"> Pre-Upgrade Preparation </a> - -Two major areas of TWiki functionality - [[TWikiTemplates]] and [[TWikiForms]] (input forms associated with a topic)- are entirely different in the new TWiki. If you've customized your templates or use Category Tables, read those sections _before_ starting your upgrade. - -The following steps describe the upgrade on Unix. Windows setup is very similar. It's assumed that `$TWIKIROOT` is the root of your current 01-Dec-2000 release, ex: `export TWIKIROOT=/some/dir/` - -### <a name="Step_1_Backup_amp_Unpack"> Step 1: Backup & Unpack </a> - -1. Back up all existing TWiki directories `twiki/bin`, `twiki/pub`, `twiki/data`, `twiki/templates`. -2. Create a temporary directory and unpack the ZIP file there: <br />`mkdir -p ~/tmp/`<br />`cp -p ~/downloads/TWiki20011201.zip ~/tmp/`<br />`cd ~/tmp/`<br />`unzip ~/tmp/TWiki20011201.zip` - -### <a name="Step_2_Upgrade_TWiki_document_fi"> Step 2: Upgrade TWiki document files </a> - -1. Move the document files to your TWiki root ( `twiki` ): <br />`mv ~/tmp/TWiki*.html $TWIKIROOT`<br />`mv ~/tmp/index.html $TWIKIROOT`<br />`mv ~/tmp/readme.txt $TWIKIROOT`<br />`mv ~/tmp/license.txt $TWIKIROOT` - -### <a name="Step_3_Install_new_template_file"> Step 3: Install new template files </a> - -1. Move & rename the template directory to a temporary `twiki/templates2` directory, ex: <br />`mv ~/tmp/templates $TWIKIROOT/templates2` -2. Pay attention to the file and directory permissions (security issue). Set file permissions, ex: <br />`chmod 644 *.cgi` - -### <a name="Step_4_Install_new_data_and_pub_"> Step 4: Install new data and pub files </a> - -1. Move the TWiki web to a temporary TWiki2 `twiki/data/TWiki2` directory. Do the same to files attached to this web, ex: <br />`mv ~/tmp/data/TWiki $TWIKIROOT/data/TWiki2`<br />`mv ~/tmp/pub/TWiki $TWIKIROOT/pub/TWiki2` -2. Move & rename the Know web to a temporary `twiki/data/Know2` directory, ex: <br />`mv ~/tmp/data/Know $TWIKIROOT/data/Know2`<br />`mv ~/tmp/pub/Know $TWIKIROOT/pub/Know2` -3. Move the \_default and Trash web, ex: <br />`mv ~/tmp/data/_default $TWIKIROOT/data`<br />`mv ~/tmp/data/Trash $TWIKIROOT/data` -4. Move the MIME types file, ex: <br />`mv ~/tmp/data/mime.types $TWIKIROOT/data` -5. Move the TWiki logo files, ex: <br />`mv ~/tmp/pub/*.gif $TWIKIROOT/pub` -6. Pay attention to the file permissions of the `TWiki2` and `Know2` directories and its files. The files must be writable by the cgi-scripts (usually user `nobody`). -7. In case the cgi-scripts are not running as user `nobody`: The `*,v` RCS repository files delivered with the installation package are locked by user nobody and need to be changed the user of your cgi-scripts, i.e. `www-data`. A simple way to switch the locker of the RCS files is to use sed: <br />`for f in *,v; do sed 's/nobody\:/www-data\:/' $f > x; mv x $f; done` - -### <a name="Step_5_Install_new_CGI_scripts"> </a> Step 5: Install new CGI scripts - -1. Move & rename the CGI script directory to a temporary `twiki/bin/2` directory, ex: <br />`mv ~/tmp/bin $TWIKIROOT/bin/2` -2. If necessary, change the script names to include the required extension, ex: `.cgi` -3. Copy any additional scripts you might have from the 01-Dec-2000 release, ex: <br />`cp -p $TWIKIROOT/bin/somescript $TWIKIROOT/bin/2` -4. In case you use basic authentication, rename `.htaccess.txt` to `.htaccess` and customize it, ex: <br />`cd $TWIKIROOT/bin/2`<br />`mv .htaccess.txt .htaccess`<br />`diff ../.htaccess .`<br /> and merge the content -5. Pay attention to the file and directory permissions (security issue). Set permissions, ex: <br />`chmod 755 *.cgi` - -### <a name="Step_6_Install_new_Perl_library_"> Step 6: Install new Perl library files </a> - -1. Move the lib directory to a temporary `twiki/bin/lib` directory, ex: <br />`mv ~/tmp/lib $TWIKIROOT/bin` -2. Pay attention to the file and directory permissions (security issue). Set permissions, ex: <br />`chmod 644 *.pm` - -### <a name="Step_7_Set_configurations_and_te"> Step 7: Set configurations and test installation </a> - -1. Merge the content of the old `twiki/bin/wikicfg.pm` into the new `twiki/lib/TWiki.cfg` configuration file. Use the `diff` command to find out the differences, ex: <br />`cd $TWIKIROOT/bin/lib`<br />`diff ../wikicfg.pm TWiki.cfg` -2. Make sure to set the correct temporary location of templates and scripts, ex: <br />`$scriptUrlPath = "/twiki/bin/2";`<br />`$templateDir = "/home/httpd/twiki/templates2";` -3. Do **not** merge the functions `extendHandleCommonTags`, `extendGetRenderedVersionOutsidePRE`, `extendGetRenderedVersionInsidePRE` from the old `twiki/bin/wikicfg.pm`. This is now handled by the Default plugin `twiki/lib/TWiki/Plugins/Default.pm` -4. Test your new TWiki installation to see if you can view topics. Point your browser to the old installation and fix the URL to see the new installation, ex: - * Old URL: `http://localhost/cgi-bin/view` - * New URL: `http://localhost/cgi-bin/2/view` - -### <a name="Step_8_Update_topics"> Step 8: Update topics </a> - -You can do the following changes using your old TWiki 01-Dec-2000 or new TWiki 01-Dec-2001 installation. Pointing your browser to the old installation for edit-copy-edit-paste operations is recommended, so that users don't get surprised by meta data content showing up in topics. - -1. Remember that you now have two TWiki webs: - * The original `TWiki` web. - * The new `TWiki2` web, which gets renamed to `TWiki` when you switch over the installation. -2. In case you customized `TWiki.TWikiRegistration`, merge your changes back into `TWiki2.TWikiRegistration`. -3. Copy `TWiki.TWikiWebsTable` to `TWiki2.TWikiWebsTable`. - * Do the same for any other topics you might have created in the `TWiki` web. -4. In `TWiki2.TWikiPreferences`, merge the old `TWiki.TWikiPreferences` settings and customize it. - * Add your webs to WIKIWEBLIST - * Set the WIKIWEBMASTER - * Set the SMTPMAILHOST -5. In `WebPreferences` of all webs, add or change the following web preferences: (see `TWiki.WebPreferences`) - * Add a NOSEARCHALL in case you want to exclude the web from a `web="all"` search: <br />`* Set NOSEARCHALL = on` - * In WEBTOPICLIST, remove the <code>%WEB% . \{\}</code> decoration from the list (it is now in the templates), ex: <br />`* Set WEBTOPICLIST = <a href="%HOMETOPIC%">Home</a>`<br />` | <a href="WebChanges">Changes</a>`<br />` | <a href="WebIndex">Index</a>`<br />` | <a href="WebSearch">Search</a>`<br />` | Go <input type="text" name="topic" size="16" />` - * Add a these new preferences: <br />`* Set DENYWEBVIEW =`<br />`* Set ALLOWWEBVIEW =`<br />`* Set DENYWEBRENAME =`<br />`* Set ALLOWWEBRENAME =` - * Set the FINALPREFERENCES: <br />`* Set FINALPREFERENCES = WEBTOPICLIST, DENYWEBVIEW, ALLOWWEBVIEW, DENYWEBCHANGE, ALLOWWEBCHANGE, DENYWEBRENAME, ALLOWWEBRENAME` -6. Optional: In `WebSearch` of all webs, replace content with this one line: <br /><code>%INCLUDE\{"%TWIKIWEB%.WebSearch"\}%</code> -7. Optional: In `WebChanges` of all webs, replace content with this one line: <br /><code>%INCLUDE\{"%TWIKIWEB%.WebChanges"\}%</code> - -### <a name="Step_9_Customize_template_files"> Step 9: Customize template files </a> - -**_NOTE:_** Skip this step if you did not customize your template files. - -1. Remember that you have now two template directories: - * The original `twiki/templates`. - * The new `twiki/templates2`, which gets renamed to `twiki/templates` when you switch over the installation. -2. Customized templates and skins need to be upgraded to the new [[TWikiTemplates]]. This isn't difficult, but you have be familiar with the new template set-up before starting the conversion. The safest way is to use the new templates as a base and to merge your changes back. Changes in new templates: - * Templates are now rendered by TWiki. You can use all [[TextFormattingRules]], but you have to escape unwanted ones. Also, remove empty lines unless you want a `=<p />` tag added. - * Added [[TWikiMetaData]] rendering. -3. Form Templates replace the TWikiCategoryTables: - * Create a replacement `WebForm` topic based on `twikicatitems.tmpl` in each web that uses a Category Table. See details in [[TWikiForms]] and compare with the settings in the <code>Know2.WebPreferences</code> topic. <br />**_NOTE:_** Do not remove the `twikicatitems.tmpl` file, it is still used for topics that are of the old format. - * Searches need to be adjusted to deal with format change. It is possible to define a regular expression search that can deal at the same time with topics in the old format and new format. - * **_Example:_** List all topics in the Know web that have a [[Know/TopicClassification]] of [[Know/PublicFAQ]]: <br /><tt>%SEARCH\{ "[T]opicClassification.\*?(td..td|value\\=).\*?[P]ublicFAQ" casesensitive="on" regex="on" nosearch="on" web="Know"\}%</tt><br /> (The `[T]` and `[P]` is done so that search does not find the topic where this search string is located in!) - * **_Example:_** Create a link that lists all topics in the Know web with a [[Know/TopicClassification]] of [[Know/PublicFAQ]]: <br /><tt>[[%SCRIPTURL%/search%SCRIPTSUFFIX%/Know/?scope=text<br />&search=%5BT%5DopicClassification.\*%3F%28td..td%7C<br />value%5C%3D%29.\*%3F%5BP%5DublicFAQ&regex=on]\[All Public FAQ]]</tt><br />[[SCRIPTURLsearchSCRIPTSUFFIXKnowscopetextsearch5BT5DopicClassification3F28tdtd7Cvalue5C3D293F5BP5DublicFAQregexon]] -4. For each web that has a custom <code>**notedited.tmpl**</code> template, create an equivalent [[WebTopicEditTemplate]] to conform with the new [[TWIKIWEBTWikiTemplates]]. The new format replaces the `notedited.tmpl`, `notext.tmpl` and `notwiki.tmpl` templates. - -### <a name="Step_10_Switch_over_to_new_insta"> Step 10: Switch over to new installation </a> - -In this step, you move the working 01-Dec-2001 installation to the old 01-Dec-2000 installation, so that users don't have to change the URL. - -1. Test your new 01-Dec-2001 installation under `twiki/bin/2/view` to make sure everything works as expected. - * **_NOTE:_** Don't worry about the Plugins, they'll work after the switch. -2. Edit `$TWIKIROOT/bin/2/TWiki.cfg` and remove the `/2` from `$scriptUrlPath` and `$templateDir`, ex: <br />`$scriptUrlPath = "/twiki/bin";`<br />`$templateDir = "/home/httpd/twiki/templates";` -3. Rename the `TWiki2` web to `TWiki`, including attachments, ex: <br />`cd $TWIKIROOT/data`<br />`mv TWiki TWiki1`<br />`mv TWiki2 TWiki`<br />`cd $TWIKIROOT/pub`<br />`mv TWiki TWiki1`<br />`mv TWiki2 TWiki` -4. Rename the `templates2` directory to `templates`, ex: <br />`cd $TWIKIROOT`<br />`mv templates templates1`<br />`mv templates2 templates` -5. Move the `lib` directory one level up from `$TWIKIROOT/bin/lib` to `$TWIKIROOT/lib`, ex: <br />`cd $TWIKIROOT`<br />`mv bin/lib .` -6. Copy content of `bin/2` to `bin`, ex: <br />`cd $TWIKIROOT/bin`<br />`cp -p bin/2/* .`<br />`cp -p bin/2/.htaccess .` -7. Point your browser to the original URL and make sure the relocated 01-Dec-2001 installation works as expected: check browsing, searching and user registration. -8. Clean up and remove obsolete directories: - * Remove directory `$TWIKIROOT/bin/2` - * Remove directory `$TWIKIROOT/templates1` - * Remove directory `$TWIKIROOT/data/TWiki1` - * Remove directory `$TWIKIROOT/pub/TWiki1` - * Remove temporary directory, ex: `~/tmp` - -### <a name="Step_11_Test_the_TWiki_Plugins"> Step 11: Test the TWiki Plugins </a> - -1. Test the new [[TWikiPlugins]] by checking the Plugins settings in [[TWikiPreferences]]. - * The <code>EmptyPlugin</code>, <code>DefaultPlugin</code>, and <code>InterwikiPlugin</code> should be preinstalled. To check the %TWIKIWEB%.InterwikiPlugin, go to its page. -2. If you have customized the functions `extendHandleCommonTags`, `extendGetRenderedVersionOutsidePRE` and `extendGetRenderedVersionInsidePRE` in `twiki/bin/wikicfg.pm`: - * Merge those changes back into `twiki/lib/TWiki/Plugins/Default.pm` - -### <a name="General_Format_Changes"> General Format Changes </a> - -* The format of the <code>%GMTIME\{"..."\}%</code> and <code>%SERVERTIME\{"..."\}%</code> variables is now <code>**"$hour:$min"**</code> instead of `"hour:min"`. More in %TWIKIWEB%.TWikiVariables. - -* [[TWikiVariables]]: Enhanced table syntax might have unwanted side effect: <code>| \*bold\* |</code> cells, `| center aligned |` and `| right aligned |` cells, span multiple columns using `| empty cells |||`. More in [[TextFormattingRules]]. - -* Use <code>**Net::SMTP**</code> module instead of `sendmail` if installed. - -* Use <code>**<verbatim> ... </verbatim>**</code> tags instead of `<pre> ... </pre>` tags where appropriate. More in %TWIKIWEB%.TextFormattingRules. - -* New variable <code>**%STARTINCLUDE%**</code> and <code>**%STOPINCLUDE%**</code> variables to control what gets included of a topic. More in %TWIKIWEB%.TWikiVariables. - -* [[FileAttachment]] info is now stored as [[TWikiMetaData]]. - * Upgrading of imported pagess is done automatically after first edit, on save. "In memory" upgrade is done on topic view. - * Attachments are now under revision control: `$attachAsciiPath` in `TWiki.cfg` defines which file types are stored in ASCII, otherwise, binary format is used. This means that the RCS version used should support binary files. - -* Handling for topic-specific templates like `edit.new.tmpl` has been removed and replaced by template topics in the new [[TWikiTemplates]]. - -* A new file `warning.txt` file can appear in the `data` directory. It may contain diagnostic info identifying problems that need fixing. This file could get fairly large if you have a lot of problems your site - you can delete it at any time. - -## <a name="Known_Issues"> Known Issues </a> - -* Check TWiki:Codev/KnownIssuesOfTWiki01Dec2001 for known issues of TWiki 01 Dec 2001 (production release) -* Check TWiki:Codev/KnownIssuesOfTWiki01Sep2001 for known issues of TWiki 01 Sep 2001 (production release) - --- [[JohnTalintyre]] - 18 Jul 2001 <br /> -- [[MikeMannix]] - 12 Sep 2001 <br /> -- [[PeterThoeny]] - 03 Dec 2001 <br /> diff --git a/TWiki/TWikiUpgradeTo01Dec2000.mdwn b/TWiki/TWikiUpgradeTo01Dec2000.mdwn deleted file mode 100644 index c95c62ff..00000000 --- a/TWiki/TWikiUpgradeTo01Dec2000.mdwn +++ /dev/null @@ -1,72 +0,0 @@ -## <a name="TWiki_Upgrade_Notes_for_Version_"> TWiki Upgrade Notes for Version 01 May 2000 </a> - -If you are coming from a version earlier than the 01 May 2000 production release, please see [[TWikiUpgradeTo01May2000]] first. For the latest version read [[TWikiUpgradeGuide]]. - -The 01 Dec 2000 release has these changes that affect the upgrade of the 01 May 2000 version: - -* Improved search, i.e. search multiple webs. -* The `changes` script has been retired (related to new search). -* Reorganization of topics: The TWiki.Main web was split up into TWiki.Main and TWiki.TWiki web. - -This upgrade is somewhat more labor intensive, mainly caused by splitting up the TWiki.Main web. Please note that subsequent updates will be much easier because user related topics (in TWiki.Main web) and TWiki related documents (in TWiki.TWiki web) have been separated. - -These are the steps you need to perform to upgrade the 01 May 2000 version to the 01 Dec 2000 release: [ We assume `export TWIKIROOT=/some/dir/` ] - -* **_Backup_** all existing TWiki directories ( `bin`, `pub`, `data`, `templates` ) - -* **_Unpack the zip file_** into some working directory: <br />`mkdir -p ~/tmp/`<br />`cd ~/tmp`<br />`unzip ~/TWiki20001201.zip` - -* **_Upgrade the TWiki document files_** ( `twiki` ) - * Move the document files to your TWiki root, i.e. <br />`mv ~/tmp/TWiki*.html $TWIKIROOT`<br />`mv ~/tmp/readme.txt $TWIKIROOT` - -* **_Upgrade cgi-bin scripts_** ( `twiki/bin` ) - * Rename your original `twiki/bin` directory, i.e. <br />`mv $TWIKIROOT/bin $TWIKIROOT/bin.old` - * Move the new scripts to your original `twiki/bin` location, i.e. <br />`mv ~/tmp/bin $TWIKIROOT/bin` - * Merge the changes in your current `wikicfg.pm` into the new `wikicfg.pm`. We suggest using `diff -c` to compare the two files if you have made heavy changes to the file, i.e. <br />`diff -c $TWIKIROOT/bin.old/wikicfg.pm $TWIKIROOT/bin/wikicfg.pm | less` - * Restore any additional scripts you might have from the old directory, i.e. <br />`mv $TWIKIROOT/bin.old/somescript $TWIKIROOT/bin/`<br /> (Note that the `changes` script is obsolete.) - * In case you have basic authentication: - * The `TWikiRegistration` topic moved from the TWiki.Main web to the TWiki.TWiki web. Change `.htaccess` to reflect the new location, i.e. <br />`ErrorDocument 401 /cgi-bin/view/TWiki/TWikiRegistration` - * Pay attention to the file and directory permissions (security issue) - * Test your TWiki installation if you can view topics. (Ignore the <code>%HTTP\_EQUIV\_ON\_VIEW%</code> you see on top of the topic; this will disappear after upgrading the template files. - -* **_Upgrade template files_** ( `twiki/templates` ) - * Rename your original `twiki/templates` directory, i.e. <br />`mv $TWIKIROOT/templates $TWIKIROOT/templates.old` - * Move the new templates to your original `twiki/templates` location, i.e. <br />`mv ~/tmp/templates $TWIKIROOT/templates` - * Merge the changes in your current template files into the new template files. To compare two files use <br />`diff -c $TWIKIROOT/templates.old/view.tmpl $TWIKIROOT/templates/view.tmpl | less` - * Restore any additional template subdirectories of your TWiki webs you might have and merge the changes. - * Test your TWiki installation if you can view topics. - -* **_Upgrade public files_** ( `twiki/pub` ) - * Move the new `twiki/pub/TWiki` directory to your installation, i.e. <br />`mv ~/tmp/pub/TWiki $TWIKIROOT/pub/` - * Pay attention to the file permissions of the `TWiki` directory and its subdirectory and files. The files must be writable by the cgi-scripts (usually user "nobody") - * Move the new `twiki/pub/twikilogo*` image files to your installation, i.e. <br />`mv ~/tmp/pub/twikilogo* $TWIKIROOT/pub/` - -* **_Upgrade data files_** ( `twiki/data` ) - * Move the new `twiki/data/TWiki` directory to your installation, i.e. <br />`mv ~/tmp/data/TWiki $TWIKIROOT/data/`<br /> Pay attention to the file permissions of the `TWiki` directory and its files. The files must be writable by the cgi-scripts (usually user "nobody") - * Optionally move the new `twiki/data/Test` directory to your installation, i.e. <br />`mv ~/tmp/data/Test $TWIKIROOT/data/`<br /> (Pay attention to the file permissions) - * Move these new TWiki.Main web topics to your TWiki.Main web: `TWikiGroups`, `TWikiAdminGroup`, and if needed also `OfficeLocations` , i.e. <br />`mv ~/tmp/data/Main/TWikiGroups.* $TWIKIROOT/data/Main`<br /> (Pay attention to the file permissions) - * The following topics in the TWiki.Main web are obsolete and can be deleted: `BillClinton`, `GoodStyle`, `RegularExpression`, `TextFormattingFAQ`, `TextFormattingRules`, `ManagingWebs`, `TWikiCategoryTable`, `TWikiEnhancementRequests`, `TWikiImplementationNotes`, `TWikiInstallationGuide`, `WebNotification`, `TWikiPlannedFeatures`, `TWikiUpgradeTo01May2000`, `TWikiUsernameVsLoginUsername`, `TWikiSite`, `WelcomeGuest`, `WelcomeVisitor`, `WikiName`, `WikiNotation`, `WikiTopic`, `WikiWikiClones`. Sample delete command: <br />`rm -f $TWIKIROOT/data/Main/BillClinton.*` - * The following topics are new and most be copied to all of your TWiki webs: `WebChanges`, `WebIndex`. <br />`cp -p $TWIKIROOT/data/TWiki/WebChanges.txt* $TWIKIROOT/data/Main`<br />`cp -p $TWIKIROOT/data/TWiki/WebIndex.txt* $TWIKIROOT/data/Main`<br /> Repeat this for all your webs. Pay attention to the file permissions. - * `TWikiRegistration` moved from TWiki.Main to TWiki.TWiki. In case you customized `TWikiRegistration` , merge your changes back into `TWiki.TWikiRegistration` , then delete `$TWIKIROOT/data/Main/TWikiRegistration*`. - * `TWikiPreferences` moved from TWiki.Main to TWiki.TWiki. Merge your changes to `TWikiPreferences` into `TWiki.TWikiPreferences`. - * Modify the `WebPreferences` topics in all your webs to reflect the following: - * `WEBTOPICLIST` should use `WebChanges` for `"Changes"`, and `WebIndex` for `"Index"`, i.e. <br />`| <a href="WebChanges">Changes</a>`<br />`| <a href="WebIndex">Index</a>` - * In case you want to exclude a web from a `web="all"` search: Set this new preference <br />`Set NOSEARCHALL = on` - * The `WebSearch` topic has considerable changes. Copy the one from `TWiki.TWiki` into all webs, or merge them if you made changes. To copy, do an edit-copy-edit-paste operation. - * Change the `WebHome` topics in all your webs to reflect these changes: - 1. The "Changes" link should point to `WebChanges`. - 2. The "Topic index" link should point to `WebIndex`. - 3. Change the include of the web table to <code>%INCLUDE\{"%TWIKIWEB%.TWikiWebsTable"\}%</code> - * Merge your `TWikiWebsTable` topic in TWiki.Main with the `TWikiWebsTable` topic in TWiki.TWiki. Note the new variable to query the color of a web. Delete the old `TWikiWebsTable` topic in TWiki.Main after merge is complete. - * The following topics in the TWiki.Main web are deprecated (because they moved to TWiki.TWiki), but still need to be present in TWiki.Main because of existing links to them: `FileAttachment`, `TWikiDocumentation`, `TWikiHistory`, `TWikiPreferences`, `TWikiVariables`. <br /> It is recommended that you edit these topics in TWiki.Main and replace the content with this line: <br /><code>This topic moved to %TWIKIWEB%.%TOPIC% in the %WIKITOOLNAME%.%TWIKIWEB% web.</code> - * In all your webs, change references to topics that moved to the TWiki.TWiki web: - * Change topics: `TWikiUsers` , `WebNotify` , `WebHome` - * With links to: `TWikiPreferences` , `TWikiVariables` , `TWikiUsers` , `TWikiWebsTable` and `WelcomeGuest` - -* **_TWiki Access Control_** - * Read [[TWikiAccessControl]], in case you want to use the new authorization feature based on groups. - -* **_Known Issues_** - * Check <http://TWiki.org/cgi-bin/view/Codev/KnownIssuesOfTWiki01Dec2000> for known issues of TWiki 01 Dec 2000 (production release) - --- [[Main/PeterThoeny]] - 08 Nov 2000 <br /> diff --git a/TWiki/TWikiUpgradeTo01May2000.mdwn b/TWiki/TWikiUpgradeTo01May2000.mdwn deleted file mode 100644 index 1a1e304f..00000000 --- a/TWiki/TWikiUpgradeTo01May2000.mdwn +++ /dev/null @@ -1,20 +0,0 @@ -To upgrade an earlier TWiki version like `01 Sep 1999` to version `01 May 2000` you should do the following things: - -* Back up your system. -* Update the templates in the `/templates` directory (and its subdirs): - * Take the templates of the latest distribution as the base and merge your changes back into it. -* Update the Perl scripts in the `/bin` directory: - * Take the scripts of the latest distribution as the base and merge your changes back into it. Do so also for `wikicfg.pm` because it has important changes as well. -* Update topics: - * Copy the new Main. [[Main/TWikiPreferences]] topic (and `*,v` file) into your TWiki.Main web. Customize the topic to your needs. - * Copy the new Main. [[Main/WebPreferences]], [[Main/WebStatistics]] topics (and `*,v` files) into all your webs. Customize all [[WebPreferences]] topics to your needs (e.g. web color). - * Copy [[WebSearch]] into all your webs, or modify the existing ones. **_Reason:_** Some switches for search changed. - * Copy the TWiki documentation into your Main web: Topics [[TWikiDocumentation]], [[TWikiUsernameVsLoginUsername]], [[TWikiVariables]], [[WebNotification]], [[TWikiCategoryTable]], [[TWikiImplementationNotes]], [[TWikiInstallationGuide]], [[TWikiUpgradeTo01May2000]], [[TextFormattingRules]], [[TWikiHistory]] . - * Copy the registration topic into your Main web: - * In case you are on an Intranet: Copy topic [[TWikiRegistration]] to Main.TWikiRegistration. Customize if needed. - * In case you are on a public server: Copy topic TWikiRegistrationPub to Main.TWikiRegistration. Customize if needed. - * Copy the Main. [[TWikiWebsTable]] topic (and `*,v` file) into your Main web and customize it. **_Reason:_** The new release does not use the `*.inc` include files anymore. - * Optionally: Search for <code>%INCLUDE%'s</code> in all your webs and change them to the new <code>%INCLUDE\{"file.ext"\}%</code> syntax. **_Note:_** Your old <code>%INCLUDE:"file.ext"%</code> syntax still works (the legacy rule is defined in `wikicfg.pm` .) -* Add the [PoweredByTWikiLogo](http://TWiki.org/cgi-bin/view/Main/PoweredByTWikiLogo) to your %WIKITOOLNAME% home page. - --- [[Main/PeterThoeny]] - 28 Apr 2000 <br /> diff --git a/TWiki/TWikiUserAuthentication.mdwn b/TWiki/TWikiUserAuthentication.mdwn deleted file mode 100644 index c62170a8..00000000 --- a/TWiki/TWikiUserAuthentication.mdwn +++ /dev/null @@ -1,85 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_User_Authentication"> TWiki User Authentication </a> - -_TWiki site access control and user activity tracking_ - -## <a name="Overview"> Overview </a> - -TWiki does not authenticate users internally, it depends on the `REMOTE_USER` environment variable. This variable is set when you enable Basic Authentication (.htaccess) or SSL "secure server" authentication (https protocol). - -TWiki uses visitor identification to keep track of who made changes to topics at what time and to manage a wide range of personal site settings. This gives a complete audit trail of changes and activity. - -## <a name="Authentication_Options"> Authentication Options </a> - -No special installation steps are required if the server is already authenticated. If it isn't, you have three standard options for controlling user access: - -1. **Forget about authentication** to make your site completely public - anyone can browse and edit freely, in classic Wiki mode. All visitors are assigned the %MAINWEB%.TWikiGuest default identity, so you can't track individual user activity. <br /> -2. **Use SSL** (Secure Sockets Layer; HTTPS) to authenticate and secure the whole server. <br /> -3. **Use Basic Authentication (.htaccess)** to control access by protecting key scripts: `attach`, `edit=`, `installpasswd`, `preview`, `rename`, `save`, `upload` using the .htaccess file. The [[TWikiInstallationGuide]] has step-by-step instructions. - -### <a name="Partial_Authentication"> Partial Authentication </a> - -**Tracking by IP address** is an experimental feature, enabled in `lib/TWiki.cfg`. It lets you combine open access to some functions, with authentication on others, with full user activity tracking: - -* Normally, the <code>**REMOTE\_USER**</code> environment variable is set for the scripts that are under authentication. If, for example, the <code>**edit**</code>, <code>**save**</code> and <code>**preview**</code> scripts are authenticated, but not <code>**view**</code>, you would get your [[WikiName]] in <code>**preview**</code> for the <code>**%WIKIUSERNAME%**</code> variable, but <code>**view**</code> will show <code>**TWikiGuest**</code> instead of your WikiName. - -* TWiki can be configured to remember the IP address/username pair whenever an authentication happens (edit topic, attach file). Once remembered, the non-authenticated scripts, like <code>**view**</code>, will show the correct username instead of %MAINWEB%.TWikiGuest. - -* Enable this feature by setting the <code>**$doRememberRemoteUser**</code> flag in `TWiki.cfg`. TWiki then persistently stores the IP address/username pairs in the file, `$remoteUserFilename`, which is `"$dataDir/remoteusers.txt"` by default. - -* **_NOTE:_** This approach can fail if the IP address changes due to dynamically assigned IP addresses or proxy servers. - -**Quick Authentication Test** - Use the %WIKIUSERNAME% variable to return your current identity: - -* You are %WIKIUSERNAME% - -## <a name="TWiki_Username_vs_Login_Username"> TWiki Username vs. Login Username </a> - -This section applies only if your %WIKITOOLNAME% is installed on a server that is both **authenticated** and on an **intranet**. - -%WIKITOOLNAME% internally manages two usernames: Login username and TWiki username. - -* **Login username:** When you login to the intranet, you use your existing login username, ex: <code>**pthoeny**</code>. This name is normally passed to %WIKITOOLNAME% by the <code>**REMOTE\_USER**</code> environment variable, and used by internally by %WIKITOOLNAME%. Login usernames are maintained by your system administrator. - -* **TWiki username:** Your name in [[WikiNotation]], ex: <code>**PeterThoeny**</code>, is recorded when you register using [[TWikiRegistration]]; doing so also generates a personal home page in the %MAINWEB% web. - -%WIKITOOLNAME% can automatically map an intranet username to a TWiki username, provided that the username pair exists in the %MAINWEB%.%WIKIUSERSTOPIC% topic. This is also handled automatically when you register. - -> **_NOTE:_** -> -> **To correctly enter a [[WikiName]]** -> -> - your own or someone else's - be sure to include the %MAINWEB% web name in front of the Wiki username, followed by a period, and no spaces. Ex: -> -> <div> -> <center><code><b>%MAINWEB%.<nop>WikiUsername</nop></b></code> or <code><b>%<nop>MAINWEB%.<nop>WikiUsername</nop></nop></b></code></center> -> </div> -> -> This points -> -> <code>**WikiUser**</code> -> -> to the %WIKITOOLNAME%.%MAINWEB% web, where user registration pages are stored, no matter which web it's entered in. Without the web prefix, the name appears as a -> -> -> -> [[NewTopic]] -> -> everywhere but in the %MAINWEB% web. - -<a name="ChangingPasswords"></a> - -## <a name="Changing_Passwords"> Changing Passwords </a> - -Change and reset passwords using forms on regular pages. Use [[TWikiAccessControl]] to restrict use as required. - -* The [[ChangePassword]] form ( <code>**TWiki/ChangePassword**</code> ): - -> %INCLUDE\{"ChangePassword"\}% - -* The [[ResetPassword]] form ( <code>**TWiki/ResetPassword**</code> ): - -> %INCLUDE\{"ResetPassword"\}% - --- [[MikeMannix]] - 29 Aug 2001 diff --git a/TWiki/TWikiUsernameVsLoginUsername.mdwn b/TWiki/TWikiUsernameVsLoginUsername.mdwn deleted file mode 100644 index bcfbc71f..00000000 --- a/TWiki/TWikiUsernameVsLoginUsername.mdwn +++ /dev/null @@ -1,26 +0,0 @@ -## <a name="TWiki_Username_vs_Login_Username"> TWiki Username vs. Login Username </a> - -This section applies only if your %WIKITOOLNAME% is installed on a server that is both **authenticated** and on an **intranet**. - -%WIKITOOLNAME% internally manages two usernames: Login username and TWiki username. - -* **Login username:** When you login to the intranet, you use your existing login username, ex: <code>**pthoeny**</code>. This name is normally passed to %WIKITOOLNAME% by the <code>**REMOTE\_USER**</code> environment variable. %WIKITOOLNAME% uses this name internally to log topic changes. Login usernames are maintained by your system administrator. -* **TWiki username:** This is your name in [[WikiNotation]], ex: <code>**PeterThoeny**</code>, recorded when you register in [[TWikiRegistration]]; doing so also generates your personal home page in the %MAINWEB% web of your TWiki site. - -%WIKITOOLNAME% can map the intranet username to the Wiki username automatically, provided that the Login username and Wiki username pair has been entered in the %MAINWEB%.%WIKIUSERSTOPIC% topic. This happens automatically when you register. - -> **_NOTE:_** -> -> **To correctly enter a [[WikiName]]** -> -> - your own or someone else's - be sure to specify the %MAINWEB% web in front of the Wiki username: write -> -> <code>**%MAINWEB%.WikiUsername**</code> -> -> or -> -> <code>**%MAINWEB%.WikiUsername**</code> -> -> . This assures that the name will be linked automatically to the %WIKITOOLNAME%.%MAINWEB% web, where user registration pages are stored, even if the text is entered in a different %WIKITOOLNAME% web. - --- [[PeterThoeny]] - 16 May 2001 <br /> diff --git a/TWiki/TWikiVariables.mdwn b/TWiki/TWikiVariables.mdwn deleted file mode 100644 index 532e7c66..00000000 --- a/TWiki/TWikiVariables.mdwn +++ /dev/null @@ -1,627 +0,0 @@ -%TOC% %STARTINCLUDE% - -# <a name="TWiki_Variables"> TWiki Variables </a> - -_Text strings expanded on the fly to display data or system info_ - -## <a name="Overview"> Overview </a> - -TWikiVariables are text strings - <code>%VARIABLE%</code> - that expand into content whenever a page is opened. Variables are replaced by their actual values: stored data, or system info (like the date, or the current user). There are predefined variables, and Preference variables that you set. You can also define custom variables, with new names and values. - -## <a name="Predefined_Variables"> Predefined Variables </a> - -Most predefined variables return values that were either defined when TWiki was installed, or taken from server info (like current username, or date and time). Many of the variables let you control how the formatted results appear. - -%WIKITOOLNAME% expands the following variables (enclosed in <code>**%**</code> percent signs): - -<table align="center" border="1" cellpadding="2" cellspacing="0" style="background-color: #f5f5f5" width="90%"> - <tr> - <th width="160"> Variable: </th> - <th> Expanded to: </th> - </tr> - <tr> - <td><code>%<nop>WIKIHOMEURL%</nop></code></td> - <td> The base script URL of %WIKITOOLNAME%, is the link of the Home icon in the upper left corner, is <b>%WIKIHOMEURL%</b></td> - </tr> - <tr> - <td><code>%<nop>SCRIPTURL%</nop></code></td> - <td> The script URL of %WIKITOOLNAME%, is <b>%SCRIPTURL%</b></td> - </tr> - <tr> - <td><code>%<nop>SCRIPTURLPATH%</nop></code></td> - <td> The path of the script URL of %WIKITOOLNAME%, is <b>%SCRIPTURLPATH%</b></td> - </tr> - <tr> - <td><code>%<nop>SCRIPTSUFFIX%</nop></code></td> - <td> The script suffix, ex: <code>.pl</code>, <code>.cgi</code> is <b>%SCRIPTSUFFIX%</b></td> - </tr> - <tr> - <td><code>%<nop>PUBURL%</nop></code></td> - <td> The public URL of TWiki, is <b>%PUBURL%</b></td> - </tr> - <tr> - <td><code>%<nop>PUBURLPATH%</nop></code></td> - <td> The path of the public URL of %WIKITOOLNAME%, is <b>%PUBURLPATH%</b></td> - </tr> - <tr> - <td><code>%<nop>ATTACHURL%</nop></code></td> - <td> The attachment URL of the current topic, is <b>%ATTACHURL%</b><br /> Example: If you attach a file you can refer to it as <code><b>%<nop>ATTACHURL%/image.gif</nop></b></code></td> - </tr> - <tr> - <td><code>%<nop>ATTACHURLPATH%</nop></code></td> - <td> The path of the attachment URL of the current topic, is <b>%ATTACHURLPATH%</b></td> - </tr> - <tr> - <td><code>%<nop>URLPARAM{"name"}%</nop></code></td> - <td> Returns the value of a URL parameter. Ex: <code>%<nop>URLPARAM{"skin"}%</nop></code> returns <b>print</b> for a <code>.../view/%WEB%/%TOPIC%?skin=print</code> URL. Is <b>%URLPARAM{"skin"}%</b></td> - </tr> - <tr> - <td><code>%<nop>WIKITOOLNAME%</nop></code></td> - <td> Name of wiki tool, is <b>%WIKITOOLNAME%</b></td> - </tr> - <tr> - <td><code>%<nop>WIKIVERSION%</nop></code></td> - <td> Wiki tool version is <b>%WIKIVERSION%</b></td> - </tr> - <tr> - <td><code>%<nop>USERNAME%</nop></code></td> - <td> Your login username is <b>%USERNAME%</b></td> - </tr> - <tr> - <td><code>%<nop>WIKINAME%</nop></code></td> - <td> Your Wiki username. Same as %<nop>USERNAME% if not defined in the %MAINWEB%.%WIKIUSERSTOPIC% topic. Is <b>%WIKINAME%</b> </nop></td> - </tr> - <tr> - <td><code>%<nop>WIKIUSERNAME%</nop></code></td> - <td> Your %<nop>WIKINAME% including the %MAINWEB% web name. Usefull for signatures. Is <b>%WIKIUSERNAME%</b> </nop></td> - </tr> - <tr> - <td><code>%<nop>MAINWEB%</nop></code></td> - <td> The Main web containing %MAINWEB%.%WIKIUSERSTOPIC%, %MAINWEB%.OfficeLocations and %MAINWEB%.TWikiGroups. Is <b>%MAINWEB%</b></td> - </tr> - <tr> - <td><code>%<nop>TWIKIWEB%</nop></code></td> - <td> The web containing all documentation and configuration of %WIKITOOLNAME% is <b>%TWIKIWEB%</b></td> - </tr> - <tr> - <td><code>%<nop>WEB%</nop></code></td> - <td> The current web is <b>%WEB%</b></td> - </tr> - <tr> - <td><code>%<nop>BASEWEB%</nop></code></td> - <td> The web name where the includes started, e.g. the web of the first topic of nested includes. Same as <code>%<nop>WEB%</nop></code> in case there is no include. </td> - </tr> - <tr> - <td><code>%<nop>INCLUDINGWEB%</nop></code></td> - <td> The web name of the topic that includes the current topic. Same as <code>%<nop>WEB%</nop></code> in case there is no include. </td> - </tr> - <tr> - <td><code>%<nop>HOMETOPIC%</nop></code></td> - <td> The home topic in each web. Is <b>[[HOMETOPIC]]</b></td> - </tr> - <tr> - <td><code>%<nop>NOTIFYTOPIC%</nop></code></td> - <td> The notify topic in each web. Is <b>[[NOTIFYTOPIC]]</b></td> - </tr> - <tr> - <td><code>%<nop>WIKIUSERSTOPIC%</nop></code></td> - <td> The index topic of all registered users. Is <b>%WIKIUSERSTOPIC%</b></td> - </tr> - <tr> - <td><code>%<nop>WIKIPREFSTOPIC%</nop></code></td> - <td> The web preferences topic. Is <b>%WIKIPREFSTOPIC%</b></td> - </tr> - <tr> - <td><code>%<nop>WEBPREFSTOPIC%</nop></code></td> - <td> The web preferences topic. Is <b>%WEBPREFSTOPIC%</b></td> - </tr> - <tr> - <td><code>%<nop>STATISTICSTOPIC%</nop></code></td> - <td> The web statistics topic. Is <b>%STATISTICSTOPIC%</b></td> - </tr> - <tr> - <td><code>%<nop>TOPIC%</nop></code></td> - <td> The current topic name, is <b>%TOPIC%</b></td> - </tr> - <tr> - <td><code>%<nop>BASETOPIC%</nop></code></td> - <td> The name of the topic where the includes started, e.g. the first topic of nested includes. Same as <code>%<nop>TOPIC%</nop></code> in case there is no include. </td> - </tr> - <tr> - <td><code>%<nop>INCLUDINGTOPIC%</nop></code></td> - <td> The name of the topic that includes the current topic. Same as <code>%<nop>TOPIC%</nop></code> in case there is no include. </td> - </tr> - <tr> - <td><code>%<nop>SPACEDTOPIC%</nop></code></td> - <td> The current topic name with added spaces, for regular expression search of Ref-By, is <b>%SPACEDTOPIC%</b></td> - </tr> - <tr> - <td><code>%<nop>TOPICLIST{"format"}%</nop></code></td> - <td> Topic index of a web. The "format" defines the format of one topic item. It may include variables: The <code>$name</code> variable gets expanded to the topic name; the <code>$web</code> variable gets expanded to the name of the web. Parameters are format, separator and web: <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Parameter:</strong></th> - <th bgcolor="#99CCCC"><strong>Description:</strong></th> - <th bgcolor="#99CCCC"><strong>Default:</strong></th> - </tr> - <tr> - <td><code>"format"</code></td> - <td> Format of one line, may include <code>$name</code> and <code>$web</code> variables </td> - <td><code>"$name"</code></td> - </tr> - <tr> - <td><code>format="format"</code></td> - <td> (Alternative to above) </td> - <td><code>"$name"</code></td> - </tr> - <tr> - <td><code>separator=", "</code></td> - <td> line separator </td> - <td><code>"\n"</code> (new line) </td> - </tr> - <tr> - <td><code>web="Name"</code></td> - <td> Name of web </td> - <td> Current web </td> - </tr> - </table> Examples: <br /><code>%<nop>TOPICLIST{" * $web.$name"}%</nop></code> creates a bullet list of all topics. <br /><code>%<nop>TOPICLIST{separator=", "}%</nop></code> creates a comma separated list of all topics. <br /><code>%<nop>TOPICLIST{" &lt;option&gt;$name&lt;/option&gt;"}%</nop></code> creates an option list (for drop down menus). </td> - </tr> - <tr> - <td><code>%<nop>WEBLIST{"format"}%</nop></code></td> - <td> Web index, e.g. list of all webs. Hidden webs are excluded, e.g. webs with a <code>NOSEARCHALL=on</code> preference variable. The <code>"format"</code> defines the format of one web item. The <code>$name</code> variable gets expanded to the name of the web, <code>$qname</code> gets expanded to double quoted name, <code>$marker</code> to <code>marker</code> where web matches <code>selection</code>. Parameters are format, separator and web: <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Parameter:</strong></th> - <th bgcolor="#99CCCC"><strong>Description:</strong></th> - <th bgcolor="#99CCCC"><strong>Default:</strong></th> - </tr> - <tr> - <td><code>"format"</code></td> - <td> Format of one line, may include <code>$name</code> variable </td> - <td><code>"$name"</code></td> - </tr> - <tr> - <td><code>format="format"</code></td> - <td> (Alternative to above) </td> - <td><code>"$name"</code></td> - </tr> - <tr> - <td><code>separator=", "</code></td> - <td> line separator </td> - <td><code>"\n"</code> (new line) </td> - </tr> - <tr> - <td><code>webs="public"</code></td> - <td> comma sep list of Web, public expands to all non-hidden </td> - <td><code>"public"</code></td> - </tr> - <tr> - <td><code>marker="selected"</code></td> - <td> Text for <code>$marker</code> where item matches <code>selection</code>, otherwise equals <code>""</code></td> - <td><code>"selected"</code></td> - </tr> - <tr> - <td><code>selection="%<nop>WEB%"</nop></code></td> - <td> Current value to be selected in list </td> - <td><code>section="%<nop>WEB%"</nop></code></td> - </tr> - </table> Examples: <br /><code>%<nop>WEBLIST{" * [<nop>[$name.%HOMETOPIC%]]"}%</nop></nop></code> creates a bullet list of all webs. <br /><code>%<nop>WEBLIST{"<select><option $marker="$marker" value="$qname">$name</option>" webs="Trash,public" selection="%WEB%" separator=" "}%</select></nop></code> Dropdown of all public Webs + Trash Web, current Web highlighted. </td> - </tr> - <tr> - <td><code>%<nop>GMTIME%</nop></code></td> - <td> GM time, is <b>%GMTIME%</b></td> - </tr> - <tr> - <td><code>%<nop>GMTIME{"format"}%</nop></code></td> - <td> Formatted GM time based on time variables. <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Variable:</strong></th> - <th bgcolor="#99CCCC"><strong>Unit:</strong></th> - <th bgcolor="#99CCCC"><strong>Example</strong></th> - </tr> - <tr> - <td> $seconds </td> - <td> seconds </td> - <td> 59 </td> - </tr> - <tr> - <td> $minutes </td> - <td> minutes </td> - <td> 59 </td> - </tr> - <tr> - <td> $hours </td> - <td> hours </td> - <td> 23 </td> - </tr> - <tr> - <td> $day </td> - <td> day of month </td> - <td> 31 </td> - </tr> - <tr> - <td> $month </td> - <td> month in ISO format </td> - <td> Dec </td> - </tr> - <tr> - <td> $mo </td> - <td> 2 digit month </td> - <td> 12 </td> - </tr> - <tr> - <td> $year </td> - <td> 4 digit year </td> - <td> 1999 </td> - </tr> - <tr> - <td> $ye </td> - <td> 2 digit year </td> - <td> 99 </td> - </tr> - </table> Variables can be shortened to 3 characters. Example: <br /><code>%<nop>GMTIME{"$day $month, $year - $hour:$min:$sec"}%</nop></code> is <br /><b>%GMTIME{"$day $month, $year - $hour:$min:$sec"}%</b></td> - </tr> - <tr> - <td><code>%<nop>SERVERTIME%</nop></code></td> - <td> Server time, is <b>%SERVERTIME%</b></td> - </tr> - <tr> - <td><code>%<nop>SERVERTIME{"format"}%</nop></code></td> - <td> Formatted server time. <br /> Example: <code>%<nop>SERVERTIME{"$hou:$min"}%</nop></code> is <b>%SERVERTIME{"$hou:$min"}%</b></td> - </tr> - <tr> - <td><code>%<nop>HTTP_HOST%</nop></code></td> - <td> HTTP_HOST environment variable, is <b>%HTTP_HOST%</b></td> - </tr> - <tr> - <td><code>%<nop>REMOTE_ADDR%</nop></code></td> - <td> REMOTE_ADDR environment variable, is <b>%REMOTE_ADDR%</b></td> - </tr> - <tr> - <td><code>%<nop>REMOTE_PORT%</nop></code></td> - <td> REMOTE_PORT environment variable, is <b>%REMOTE_PORT%</b></td> - </tr> - <tr> - <td><code>%<nop>REMOTE_USER%</nop></code></td> - <td> REMOTE_USER environment variable, is <b>%REMOTE_USER%</b></td> - </tr> - <tr> - <td><code>%<nop>INCLUDE{"page" ...}%</nop></code></td> - <td> Server side include to [[IncludeTopicsAndWebPages]]. Parameters are page name, and an optional <code>pattern="(reg-exp)"</code>. The page name is: <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <td><code>"SomeTopic"</code></td> - <td> The name of a topic located in the current web, i.e. <code>%<nop>INCLUDE{"WebNotify"}%</nop></code></td> - </tr> - <tr> - <td><code>"Web.Topic"</code></td> - <td> A topic in another web, i.e. <code>%<nop>INCLUDE{"%TWIKIWEB%.TWikiWebsTable"}%</nop></code></td> - </tr> - <tr> - <td><code>"http://..."</code></td> - <td> A full qualified URL, i.e. <code>%<nop>INCLUDE{"http://twiki.org/"}%</nop></code></td> - </tr> - </table> - </td> - </tr> - <tr> - <td><code>%<nop>STARTINCLUDE%</nop></code></td> - <td> If present in included topic, start to include text from this location up to the end, or up to the location of the <code>%<nop>STOPINCLUDE%</nop></code> variable. A normal view of the topic shows everyting exept the <code>%<nop>STARTINCLUDE%</nop></code> variable itself. </td> - </tr> - <tr> - <td><code>%<nop>STOPINCLUDE%</nop></code></td> - <td> If present in included topic, stop to include text at this location and ignore the remaining text. A normal view of the topic shows everyting exept the <code>%<nop>STOPINCLUDE%</nop></code> variable itself. </td> - </tr> - <tr> - <td><code>%<nop>TOC%</nop></code></td> - <td> Table of Contents of current topic. </td> - </tr> - <tr> - <td><code>%<nop>TOC{"SomeTopic" ...}%</nop></code></td> - <td> Table of Contents. Shows a TOC that is generated automatically based on headings of a topic. Headings in [[WikiSyntax]] (<code>"---++ text"</code>) and HTML (<code>"&lt;h2&gt;text&lt;h2&gt;"</code>) are taken into account. (But not <code>"&lt;H2&gt;text&lt;/H2&gt;"</code>, which can be used to exclude a heading from the TOC.) Parameters are topic name, web and depth: <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Parameter:</strong></th> - <th bgcolor="#99CCCC"><strong>Description:</strong></th> - <th bgcolor="#99CCCC"><strong>Default:</strong></th> - </tr> - <tr> - <td><code>"TopicName"</code></td> - <td> topic name </td> - <td> Current topic </td> - </tr> - <tr> - <td><code>web="Name"</code></td> - <td> Name of web </td> - <td> Current web </td> - </tr> - <tr> - <td><code>depth="2"</code></td> - <td> Limit depth of headings shown in TOC </td> - <td> 6 </td> - </tr> - </table> Examples: <code><b>%<nop>TOC{depth="2"}%</nop></b></code>, <code><b>%<nop>TOC{"TWikiDocumentation" web="%TWIKIWEB%"}%</nop></b></code></td> - </tr> - <tr> - <td><code>%<nop>SEARCH{"text" ...}%</nop></code></td> - <td> Inline search, shows a search result embedded in a topic. Parameters are the search term, web, scope, order and many more: [1] <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Parameter:</strong></th> - <th bgcolor="#99CCCC"><strong>Description:</strong></th> - <th bgcolor="#99CCCC"><strong>Default:</strong></th> - </tr> - <tr> - <td><code>"text"</code></td> - <td> Search term. (Is a regular expression or literal, depending on the <code>regex</code> parameter) </td> - <td> required </td> - </tr> - <tr> - <td><code>search="text"</code></td> - <td> (Alternative to above) </td> - <td> N/A </td> - </tr> - <tr> - <td><code>web="Name"</code><br /><code>web="%MAINWEB% Know"</code><br /><code>web="all"</code></td> - <td> Wiki web to search: A web, a list of webs separated by whitespace, or <code>all</code> webs. [2] </td> - <td> Current web </td> - </tr> - <tr> - <td><code>scope="topic"</code><br /><code>scope="text"</code></td> - <td> Search topic name (title) or in the text (body) of the topic </td> - <td> Topic text (body) </td> - </tr> - <tr> - <td><code>order="topic"</code><br /><code>order="modified"</code><br /><code>order="editby"</code></td> - <td> Sort the results of search by the topic names, last modified time, or last editor </td> - <td> Sort by topic name </td> - </tr> - <tr> - <td><code>limit="all"</code><br /><code>limit="16"</code></td> - <td> Limit the number of results returned </td> - <td> All results </td> - </tr> - <tr> - <td><code>regex="on"</code></td> - <td>[[RegularExpression]] search </td> - <td> Literal search </td> - </tr> - <tr> - <td><code>reverse="on"</code></td> - <td> Reverse the direction of the search </td> - <td> Ascending search </td> - </tr> - <tr> - <td><code>casesensitive="on"</code></td> - <td> Case sensitive search </td> - <td> Ignore case </td> - </tr> - <tr> - <td><code>nosummary="on"</code></td> - <td> Show topic title only </td> - <td> Show topic summary </td> - </tr> - <tr> - <td><code>bookview="on"</code></td> - <td>[[BookView]] search, e.g. show complete topic text </td> - <td> Show topic summary </td> - </tr> - <tr> - <td><code>nosearch="on"</code></td> - <td> Suppress search string </td> - <td> Show search string </td> - </tr> - <tr> - <td><code>noheader="on"</code></td> - <td> Suppress search header <br /><span style="background: #FFB0B0"> <strong>Topics: Changed: By:</strong> </span></td> - <td> Show search header </td> - </tr> - <tr> - <td><code>nototal="on"</code></td> - <td> Do not show number of topics found </td> - <td> Show number </td> - </tr> - <tr> - <td><code><b>format="..."</b></code></td> - <td> Flexible custom result formatting: see <strong>[[FormattedSearch]]</strong> for usage </td> - <td> Results in table </td> - </tr> - </table> Example: <code><b>%<nop>SEARCH{"wiki" web="%MAINWEB%" scope="topic"}%</nop></b></code></td> - </tr> - <tr> - <td><code>%<nop>METASEARCH{...}%</nop></code></td> - <td> Special search of meta data <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Parameter:</strong></th> - <th bgcolor="#99CCCC"><strong>Description:</strong></th> - <th bgcolor="#99CCCC"><strong>Default:</strong></th> - </tr> - <tr> - <td><code>type="topicmoved"</code></td> - <td> What sort of search is required? <br /><code>"topicmoved"</code> if search for a topic that may have been moved <br /><code>"parent"</code> if searcing for topics that have a specific parent i.e. its children </td> - <td> required </td> - </tr> - <tr> - <td><code>web="%<nop>WEB%"</nop></code></td> - <td> Wiki web to search: A web, a list of webs separated by whitespace, or <code>all</code> webs. </td> - <td> required </td> - </tr> - <tr> - <td><code>topic="%<nop>TOPIC%"</nop></code></td> - <td> The topic the search relates to </td> - <td> required </td> - </tr> - <tr> - <td><code>title="Title"</code></td> - <td> Text the is pre-pended to any search results </td> - <td> required </td> - </tr> - </table> Example: <code><b>%<nop>METASEARCH{type="topicmoved" web="%<nop>WEB%" topic="%<nop>TOPIC%" title="This topic used to exist and was moved to: "}%</nop></nop></nop></b></code>, you may want to use this in [[WebTopicViewTemplate]] and [[WebTopicNonWikiTemplate]]<br /><code><b>%<nop>METASEARCH{type="parent" web="%<nop>WEB%" topic="%<nop>TOPIC%" title="Children: "}%</nop></nop></nop></b></code></td> - </tr> - <tr> - <td><code>%<nop>VAR{"NAME" web="Web"}%</nop></code></td> - <td> Get a preference value from a web other then the current one. Example: To get <code>%<nop>WEBBGCOLOR%</nop></code> of the %MAINWEB% web write <code>%<nop>VAR{"WEBBGCOLOR" web="%MAINWEB%"}%</nop></code>, is <code><b>%VAR{"WEBBGCOLOR" web="%MAINWEB%"}%</b></code></td> - </tr> -</table> - -> [1] -> -> **_Note_** -> -> : The search form uses identical names for input fields. -> -> [2] **_Note_**: A web can be excluded from a `web="all"` search if you define a `NOSEARCHALL=on` variable in its %WEBPREFSTOPIC%. - -## <a name="Preferences_Variables"> Preferences Variables </a> - -Additional variables are defined in the preferences ( site-level ( **_SL_** ) in %TWIKIWEB%.%WIKIPREFSTOPIC%, web-level ( **_WL_** ) in %WEBPREFSTOPIC% of each web, and user level ( **_UL_** ) preferences in individual user topics): - -<table align="center" border="1" cellpadding="2" cellspacing="0" style="background-color: #f5f5f5" width="90%"> - <tr> - <th width="160"> Variable: </th> - <th> Level: </th> - <th> What: </th> - </tr> - <tr> - <td><code>%<nop>WIKIWEBMASTER%</nop></code></td> - <td><strong><em>SL</em></strong></td> - <td> Webmaster email address (sender of email notifications) , is <b>%WIKIWEBMASTER%</b></td> - </tr> - <tr> - <td><code>%<nop>WIKIWEBLIST%</nop></code></td> - <td><strong><em>SL</em></strong></td> - <td> List of %WIKITOOLNAME% webs (in upper right corner of topics) </td> - </tr> - <tr> - <td><code>%<nop>WEBTOPICLIST%</nop></code></td> - <td><strong><em>WL</em></strong></td> - <td> Common links of web (second line of topics) </td> - </tr> - <tr> - <td><code>%<nop>WEBCOPYRIGHT%</nop></code></td> - <td><strong><em>SL</em></strong> , <strong><em>WL</em></strong></td> - <td> Copyright notice (bottom right corner of topics) </td> - </tr> - <tr> - <td><code>%<nop>WEBBGCOLOR%</nop></code></td> - <td><strong><em>WL</em></strong></td> - <td> Background color of web </td> - </tr> - <tr> - <td><code>%<nop>NOSEARCHALL%</nop></code></td> - <td><strong><em>WL</em></strong></td> - <td> Exclude web from a <code>web="all"</code> search (set variable to <code>on</code> for hidden webs) </td> - </tr> - <tr> - <td><code>%<nop>NEWTOPICBGCOLOR%</nop></code></td> - <td><strong><em>SL</em></strong> , <em>UL</em></td> - <td> Background color of non existing topic. ( <strong><em>UL</em></strong> needs authentication for topic views ) </td> - </tr> - <tr> - <td><code>%<nop>NEWTOPICFONTCOLOR%</nop></code></td> - <td><strong><em>SL</em></strong> , <em>UL</em></td> - <td> Font color of non existing topic. ( <strong><em>UL</em></strong> needs authentication for topic views ) </td> - </tr> - <tr> - <td><code>%<nop>EDITBOXWIDTH%</nop></code></td> - <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td> - <td> Horizontal size of edit box, is <b> <code>%EDITBOXWIDTH%</code> </b></td> - </tr> - <tr> - <td><code>%<nop>EDITBOXHEIGHT%</nop></code></td> - <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td> - <td> Vertical size of edit box, is <b> <code>%EDITBOXHEIGHT%</code> </b></td> - </tr> - <tr> - <td><code>%<nop>RELEASEEDITLOCKCHECKBOX%</nop></code></td> - <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td> - <td> Default state of the "Release edit lock" ([[UnlockTopic]]) check box in preview. Checkbox is initially checked if <code>Set RELEASEEDITLOCKCHECKBOX = checked="checked"</code>, or unchecked if empty. If checked, make sure to click on <u>Edit</u> to do more changes; do <strong>not</strong> go back in your browser to the edit page, or you risk that someone else will edit the topic at the same time! Value is: <b><code>%RELEASEEDITLOCKCHECKBOX%</code></b></td> - </tr> - <tr> - <td><code>%<nop>DONTNOTIFYCHECKBOX%</nop></code></td> - <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td> - <td> Default state of the "Minor Changes, Don't Notify" ([[DontNotify]]) check box in preview. Check box is initially checked if <code>Set DONTNOTIFYCHECKBOX = checked="checked"</code>, or unchecked if empty. Value is: <b><code>%DONTNOTIFYCHECKBOX%</code></b></td> - </tr> - <tr> - <td><code>%<nop>ATTACHLINKBOX%</nop></code></td> - <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td> - <td> Default state of the link check box in the attach file page. Check box is initially checked if value is set to <code>CHECKED</code> , unchecked if empty. If checked, a link is created to the attached file at the end of the topic. Value is: <b><code>%ATTACHLINKBOX%</code></b></td> - </tr> - <tr> - <td><code>%<nop>HTTP_EQUIV_ON_VIEW%</nop></code></td> - <td><strong><em>SL</em></strong></td> - <td> http-equiv meta tags for view, rdiff, attach, search* scripts. </td> - </tr> - <tr> - <td><code>%<nop>HTTP_EQUIV_ON_EDIT%</nop></code></td> - <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td> - <td> http-equiv meta tags for edit script. </td> - </tr> - <tr> - <td><code>%<nop>HTTP_EQUIV_ON_PREVIEW%</nop></code></td> - <td><strong><em>SL</em></strong> , <strong><em>UL</em></strong></td> - <td> http-equiv meta tags for preview script. </td> - </tr> - <tr> - <td><code>%<nop>DENYWEBCHANGE%</nop></code></td> - <td><strong><em>WL</em></strong></td> - <td> List of users and groups who are <strong>not allowed</strong> to change topics in the %WIKITOOLNAME% web. (More in [[TWikiAccessControl]]) </td> - </tr> - <tr> - <td><code>%<nop>ALLOWWEBCHANGE%</nop></code></td> - <td><strong><em>WL</em></strong></td> - <td> List of users and groups who are <strong>allowed</strong> to change topics in the %WIKITOOLNAME% web. (More in [[TWikiAccessControl]]) </td> - </tr> - <tr> - <td><code>%<nop>DENYTOPICCHANGE%</nop></code></td> - <td><strong><em>(any topic)</em></strong></td> - <td> List of users and groups who are <strong>not allowed</strong> to change the current topic. (More in [[TWikiAccessControl]]) </td> - </tr> - <tr> - <td><code>%<nop>ALLOWTOPICCHANGE%</nop></code></td> - <td><strong><em>(any topic)</em></strong></td> - <td> List of users and groups who are <strong>allowed</strong> to change the current topic. (More in [[TWikiAccessControl]]) </td> - </tr> - <tr> - <td><code>%<nop>DENYWEBRENAME%</nop></code></td> - <td><strong><em>WL</em></strong></td> - <td> List of users and groups who are <strong>not allowed</strong> to rename topics in the %WIKITOOLNAME% web. (More in [[TWikiAccessControl]]) </td> - </tr> - <tr> - <td><code>%<nop>ALLOWWEBRENAME%</nop></code></td> - <td><strong><em>WL</em></strong></td> - <td> List of users and groups who are <strong>allowed</strong> to rename topics in the %WIKITOOLNAME% web. (More in [[TWikiAccessControl]]) </td> - </tr> - <tr> - <td><code>%<nop>DENYTOPICRENAME%</nop></code></td> - <td><strong><em>(any topic)</em></strong></td> - <td> List of users and groups who are <strong>not allowed</strong> to rename the current topic. (More in [[TWikiAccessControl]]) </td> - </tr> - <tr> - <td><code>%<nop>ALLOWTOPICRENAME%</nop></code></td> - <td><strong><em>(any topic)</em></strong></td> - <td> List of users and groups who are <strong>allowed</strong> to rename the current topic. (More in [[TWikiAccessControl]]) </td> - </tr> - <tr> - <td> - <p> - </p> - </td> - <td><code>%<nop>FINALPREFERENCES%</nop></code></td> - <td><strong><em>SL</em></strong> , <strong><em>WL</em></strong></td> - <td> List of preferences that are not allowed to be overridden by next level preferences</td> - </tr> -</table> - -## <a name="Setting_Preferences"> Setting Preferences </a> - -* The syntax for Preferences variables is the same anywhere in TWiki. In Edit mode, from the start of a new line: <br />[6 spaces] \* [space] Set [space] VARIABLENAME [space] = [value] <br />**_Example:_** - * <code>**Set VARIABLENAME = value**</code> - -## <a name="Creating_Custom_Variables"> Creating Custom Variables </a> - -* You can add your own preference variables for an entire site, a single web, or a single topic, using the standard syntax. Whatever you include in your variable will be expanded on display, and treated exactly as if it had been written out. So you can place formatted text, page links, image paths. - -> **Example: Create a custom logo variable** -> -> <br /> -> -> * To place a logo anywhere in a web by typing <code>**%MYLOGO%**</code>, simply define the variable on the web's [[WebPreferences]] page. You also have to upload `logo.gif` - this can be done by [[FileAttachment]] to `LogoTopic` (any topic name you choose): -> * <code>**Set MYLOGO = %PUBURL%/%MAINWEB%/LogoTopic/logo.gif**</code> - --- [[PeterThoeny]] - 13 Sep 2001 <br /> -- [[MikeMannix]] - 30 Nov 2001 diff --git a/TWiki/TWikiVariablesExamples.mdwn b/TWiki/TWikiVariablesExamples.mdwn deleted file mode 100644 index 7ffc8165..00000000 --- a/TWiki/TWikiVariablesExamples.mdwn +++ /dev/null @@ -1,62 +0,0 @@ -%TOC\{depth="4"\}% %STARTINCLUDE% - -# <a name="TWikiVariables_Examples"> TWikiVariables Examples </a> - -## <a name="Bullet_list_showing_topic_name_a"> Bullet list showing topic name and summary </a> - -**Write this:** - -<code>%SEARCH\{ "FAQ" scope="topic" web="TWiki" nosearch="on" nototal="on" header=" \* \*Topic: Summary:\*" format=" \* [[$web.$topic]]: $summary" \}%</code> - -**To get this:** - -%SEARCH\{ "FAQ" scope="topic" web="TWiki" nosearch="on" nototal="on" header=" \* \*Topic: Summary:\*" format=" \* [[Webtopic]]: $summary" \}% - -## <a name="Table_with_form_field_values_of_"> Table with form field values of topics with a form </a> - -**Write this:** - -<code>| \*Topic:\* | \*OperatingSystem:\* | \*OsVersion:\* |</code><br /><code>%SEARCH\{ "[T]opicClassification.\*?value=\\"[P]ublicFAQ\\"" scope="text" regex="on" nosearch="on" nototal="on" format="| [[$topic]] | $formfield([[OperatingSystem]]) | $formfield([[OsVersion]]) |" \}%</code> - -**To get this:** _(simulated)_ - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>Topic:</strong></th> - <th bgcolor="#99CCCC"><strong>OperatingSystem:</strong></th> - <th bgcolor="#99CCCC"><strong>OsVersion:</strong></th> - </tr> - <tr> - <td><a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/Know/IncorrectDllVersionW32PTH10DLL">IncorrectDllVersionW32PTH10DLL</a></td> - <td><a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/Know/OsWin">OsWin</a></td> - <td> 95/98 </td> - </tr> - <tr> - <td><a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/Know/WinDoze95Crash">WinDoze95Crash</a></td> - <td><a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/Know/OsWin">OsWin</a></td> - <td> 95 </td> - </tr> -</table> - -## <a name="Extract_text_from_a_topic_using_"> Extract text from a topic using regular expressions </a> - -**Write this:** - -<code>%SEARCH\{ "\_\_Back to\\:\_\_ TWikiFAQ" scope="text" web="TWiki" regex="on" nosearch="on" nototal="on" header="TWiki FAQs:" format=" \* $pattern(.\*?FAQ\\:[\\n\\r]\*([^\\n\\r]+).\*) [[$web.$topic]\[Answer...]]" \}%</code> - -**To get this:** - -%SEARCH\{ "\_\_Back to\\:\_\_ [[TWikiFAQ]]" scope="text" web="TWiki" regex="on" nosearch="on" nototal="on" header="TWiki FAQs:" format=" \* $pattern(.\*?FAQ\\:[\\n\\r]\*([^\\n\\r]+).\*) [[Webtopic]]" \}% - -## <a name="Creating_Custom_Variables"> Creating Custom Variables </a> - -* You can add your own preference variables for an entire site, a single web, or a single topic, using the standard syntax. Whatever you include in your variable will be expanded on display, and treated exactly as if it had been written out. So you can place formatted text, page links, image paths. - -> **Example: Create a custom logo variable** -> -> <br /> -> -> * To place a logo anywhere in a web by typing <code>**%MYLOGO%**</code>, simply define the variable on the web's [[WebPreferences]] page. You also have to upload `logo.gif` - this can be done by [[FileAttachment]] to `LogoTopic` (any topic name you choose): -> * <code>**Set MYLOGO = %PUBURL%/%MAINWEB%/LogoTopic/logo.gif**</code> - --- [[Main/MikeMannix]] - 23 Nov 2001 diff --git a/TWiki/TWikiWebsTable.mdwn b/TWiki/TWikiWebsTable.mdwn deleted file mode 100644 index b3165bdd..00000000 --- a/TWiki/TWikiWebsTable.mdwn +++ /dev/null @@ -1,54 +0,0 @@ -<table bgcolor="#000000" border="0" cellpadding="3" cellspacing="2" width="100%"> - <tr bgcolor="#99CCCC"> - <th colspan="2"> %WIKITOOLNAME% webs currently online: </th> - <th> Use to: </th> - </tr> - <tr bgcolor="%VAR{" web="Hurd" webbgcolor"="WEBBGCOLOR"" }%"="}%""> - <td><b>%WIKITOOLNAME%.[[Hurd/HOMETOPIC]]</b></td> - <td> The GNU/Hurd area. <font size="-2"> <nobr> [ [[Hurd/WebChanges]] | [[Hurd/WebSearch]] ] </nobr></font></td> - <td> Concerns everything directly related to the Hurd (it was the first section). </td> - </tr> - <tr bgcolor="%VAR{" web="Distrib" webbgcolor"="WEBBGCOLOR"" }%"="}%""> - <td><b>%WIKITOOLNAME%.[[Distrib/HOMETOPIC]]</b></td> - <td> The distribution area. <font size="-2"> <nobr> [ [[Distrib/WebChanges]] | [[Distrib/WebSearch]] ] </nobr></font></td> - <td> Debian GNU/Hurd distribution related information goes here. </td> - </tr> - <tr bgcolor="%VAR{" web="Mach" webbgcolor"="WEBBGCOLOR"" }%"="}%""> - <td><b>%WIKITOOLNAME%.[[Mach/HOMETOPIC]]</b></td> - <td> The Mach area. <font size="-2"> <nobr> [ [[Mach/WebChanges]] | [[Mach/WebSearch]] ] </nobr></font></td> - <td> Topics on the GNU Mach microkernel, and the OSKit based Mach (GNUmach 2). </td> - </tr> - <tr bgcolor="%VAR{" web="GNU" webbgcolor"="WEBBGCOLOR"" }%"="}%""> - <td><b>%WIKITOOLNAME%.[[GNU/HOMETOPIC]]</b></td> - <td> The GNU area. <font size="-2"> <nobr> [ [[GNU/WebChanges]] | [[GNU/WebSearch]] ] </nobr></font></td> - <td> Holds all GNUish related information regarding the Hurd. </td> - </tr> - <tr bgcolor="%VAR{" web="Mig" webbgcolor"="WEBBGCOLOR"" }%"="}%""> - <td><b>%WIKITOOLNAME%.[[Mig/HOMETOPIC]]</b></td> - <td> The MIG area. <font size="-2"> <nobr> [ [[Mig/WebChanges]] | [[Mig/WebSearch]] ] </nobr></font></td> - <td> Thin section on the Mach interface generator, only for developers. </td> - </tr> - <tr bgcolor="%VAR{" web="Hug" webbgcolor"="WEBBGCOLOR"" }%"="}%""> - <td><b>%WIKITOOLNAME%.[[Hug/HOMETOPIC]]</b></td> - <td> Sandbox for users to play in. <font size="-2"> <nobr> [ [[Hug/WebChanges]] | [[Hug/WebSearch]] ] </nobr></font></td> - <td> Here is where you can play freely and practise your Wiki-Fu. Have fun! </td> - </tr> - <tr bgcolor="%VAR{" web="%MAINWEB%" webbgcolor"="WEBBGCOLOR"" }%"="}%""> - <td><b>%WIKITOOLNAME%.[[MAINWEBHOMETOPIC]]</b></td> - <td> This is where all the [[MAINWEBWIKIUSERSTOPIC]] home pages are located, - tour this expandable virtual workspace. <font size="-2"> <nobr> [ [[MAINWEBWebChanges]] | [[MAINWEBWebSearch]] ] </nobr></font></td> - <td> Aquaint yourself with the people lurking here. </td> - </tr> - <tr bgcolor="%VAR{" web="%TWIKIWEB%" webbgcolor"="WEBBGCOLOR"" }%"="}%""> - <td><b>%WIKITOOLNAME%.[[TWIKIWEBHOMETOPIC]]</b></td> - <td> %TWIKIWEB%.TWikiRegistration; TWiki history &amp; Wiki style; FAQs, Quick Starts, User Guide &amp; Reference Manual. All the info... <font size="-2"> <nobr> [ [[TWIKIWEBWebChanges]] | [[TWIKIWEBWebSearch]] ] </nobr></font></td> - <td> Discover TWiki, and how to start your own site. </td> - </tr> - <tr bgcolor="%VAR{" web="Test" webbgcolor"="WEBBGCOLOR"" }%"="}%""> - <td><b>%WIKITOOLNAME%.[[Test/HOMETOPIC]]</b></td> - <td> Sandbox for users to play in. <font size="-2"> <nobr> [ [[Test/WebChanges]] | [[Test/WebSearch]] ] </nobr></font></td> - <td> Here is where you can play freely and practise your Wiki-Fu. Have fun! </td> - </tr> - <tr bgcolor="#ffffff"> - <td colspan="3"><font size="-1">You can use color coding by web for identification and reference. Contact %WIKIWEBMASTER% if you need a separate collaboration web for your team. New TWiki webs can be added easily. To modify this table: </font> <font size="-2">{ <a href="%SCRIPTURLPATH%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%">View</a> | <a href="%SCRIPTURLPATH%/edit%SCRIPTSUFFIX%/%WEB%/%TOPIC%">Edit</a> }</font></td> - </tr> -</table> diff --git a/TWiki/TablePlugin.mdwn b/TWiki/TablePlugin.mdwn deleted file mode 100644 index cc776078..00000000 --- a/TWiki/TablePlugin.mdwn +++ /dev/null @@ -1,3 +0,0 @@ -## <a name="TablePlugin"> TablePlugin </a> - -This optional but recommended Plugin is available at TWiki:Plugins/TablePlugin. diff --git a/TWiki/TextFormattingFAQ.mdwn b/TWiki/TextFormattingFAQ.mdwn deleted file mode 100644 index 2c6e1926..00000000 --- a/TWiki/TextFormattingFAQ.mdwn +++ /dev/null @@ -1,215 +0,0 @@ -<font>**Text Formatting FAQ**</font> - -The most frequently asked questions about text formatting are answered. Also, [[TextFormattingRules]] contains the complete TWiki shorthand system on one quick reference page. - -%TOC% - -> ---- -> -> ### <a name="How_do_I_make_a_separator_"> How do I make a separator? </a> -> -> Create a separator - a horizontal rule - by entering three dashes at the beginning of a blank line: `---`. You can enter more than three if you like, for a more visible separator in edit mode: <br />`--------------` -> -> ---- -> -> ### <a name="How_do_I_create_a_heading_"> How do I create a heading? </a> -> -> You can create six sizes of headings - <h1>...<h6> in HTML - by typing, from the beginning of a line, three dashes (-), from one to six plus signs (+), a space, and your heading text. The FAQ questions on this page are created with: `---+++ Have a question?`. -> -> * You can insert a nested table of contents, generated from headings, by placing <code>%TOC%</code> wherever you like on a page (see %TWIKIWEB%.TWikiVariables for more <code>%TOC%</code> options). -> -> ---- -> -> <a name="TextEnclosed"></a> -> -> ### <a name="Text_enclosed_in_angle_brackets_"> Text enclosed in angle brackets like <filename> is not displayed. How can I show it as it is? </a> -> -> TWiki interprets text as HTML, and the '<' and '>' characters define where HTML commands start and end. Text _inside_ angle brackets is treated as HTML, and ignored if it doesn't actually do anything - either way, the brackets and its contents are not displayed. -> -> If you want to display angle brackets, enter them as HTML codes instead of typing them in directly: -> -> * `<` = `<`<br />`>` = `>` -> -> * **_You enter:_** `(a > 0)` -> **_Result:_** `(a > 0)` -> -> ---- -> -> ### <a name="Some_words_appear_highlighted_wi"> Some words appear highlighted, with a "?" link at the end. How can I prevent that? </a> -> -> A question mark after a word is a link to a topic that doesn't yet exist - click it to create the new page. This is a TWiki feature - typing a [[MeaningfulTitle]] in a comment is an invitation for someone else to add a new branch to the topic. -> -> To prevent auto-linking - say you want to enter a word like JavaScript (the proper spelling!) - prefix the [[WikiStyleWord]] with the special TWiki HTML tag `<nop>`: -> -> * `<nop>WikiStyleWord` displays as WikiStyleWord -> -> ---- -> -> ### <a name="How_can_I_write_fixed_font_text_"> How can I write fixed font text? </a> -> -> The quickest way is to enclose the text in equal signs: -> -> * **_You enter:_** <code>Proportional text, =fixed font=, proportional again.</code> -> **_Result:_** Proportional text, `fixed font`, proportional again. -> -> ---- -> -> ### <a name="Text_I_enter_gets_wrapped_around"> Text I enter gets wrapped around. How can I keep the formatting as it is? </a> -> -> TWiki interprets text as HTML, so you can use the `preformatted` HTML option to keep the new line of text as is. Enclose the text in <pre> </pre>, or in TWiki's own <verbatim> </verbatim> tag: -> -> This text will keep its format as it is: -> <verbatim> -> Unit Price Qty Cost -> ------- ------ --- ------ -> aaa 12.00 3 36.00 -> </verbatim> -> -> The `pre` tag is standard HTML; `verbatim` is a special TWiki tag that forces text to fixed font mode, and also prevents other tags and TWiki shortcuts from being expanded. -> -> ---- -> -> ### <a name="How_do_I_create_tables_"> How do I create tables? </a> -> -> There are three possibilities: -> -> 1. Use Wiki rule with "|" vertical bars. -> 2. Use HTML tables with <table>, <tr>, <td> tags. -> 3. Use preformatted text with <verbatim> tags. -> -> **1\. Use Wiki rule with "|" vertical bars** -> -> * Example text: <br />`| cell A1 | cell B1 | cell C1 |`<br />`| cell A2 | cell B2 | cell C2 |` -> * Example output: <table border="1" cellpadding="1" cellspacing="0"> -> <tr> -> <td> cell A1 </td> -> <td> cell B1 </td> -> <td> cell C1 </td> -> </tr> -> <tr> -> <td> cell A2 </td> -> <td> cell B2 </td> -> <td> cell C2 </td> -> </tr> -> </table> -> -> **2\. Use HTML tables with <table>, <tr>, <td> tags** -> -> This is a manual process using HTML commands. -> -> **_You enter:_** -> -> <table border="1"> -> <tr> -> <th> Head A </th> <th> Head B </th> -> </tr><tr> -> <td> Cell A2 </td> <td> Cell B2 </td> -> </tr><tr> -> <td> Cell A3 </td> <td> Cell B3 </td> -> </tr> -> </table> -> -> **_Result:_** -> -> <table border="1"> -> <tr> -> <th> Head A </th> -> <th> Head B </th> -> </tr> -> <tr> -> <td> Cell A2 </td> -> <td> Cell B2 </td> -> </tr> -> <tr> -> <td> Cell A3 </td> -> <td> Cell B3 </td> -> </tr> -> </table> -> -> **3\. Use preformatted text with <verbatim> tags** -> -> See "Text enclosed..." -> -> ---- -> -> ### <a name="Can_I_include_images_on_a_page_"> Can I include images on a page? </a> -> -> Yes. The easiest way is to [[FileAttachment]] a GIF, JPG or PNG file to a topic and then to place it with: <code>%ATTACHURL%/myImage.gif</code>. This works only for the page that the image is attached to. -> -> To place an image on any page, ther are two ways of including inline images. -> -> **1\. Using URL ending in .gif, .jpg, .jpeg, .png** -> -> This is a simple and automatic way of including inline images. Simply write the URL of the image file, this will create the inline image for you. **_NOTE:_** The images must be accessible as a URL. -> -> * **_You enter:_** <code> TWiki %PUBURL%/wikiHome.gif logo.</code><br />**_Result:_** TWiki %PUBURL%/wikiHome.gif logo. -> -> <a name="ImgUpload"></a> You can upload images directly to your server with FTP access. You can also [[FileAttachment]] image files to a topic - you could even create a dedicated image topic, like `ImageLibrary` - and then link to the images directly: -> -> * Attach `pic.gif` to `Someweb.SomeTopic`<br /> Display with <code>%PUBURL%/Someweb/SomeTopic/pic.gif</code> -> -> **2\. Using <img> tag** -> -> This is a manual process where you have more control over the rendering of the image. Use the <img> tag of HTML to include GIF, JPG and PNG files. **Note:** The display of the topic is faster if you include the `WIDTH` and `HEIGHT` parameters that have the actual image size. <http://www.htmlhelp.com/reference/wilbur/special/img.html> has more on inline images. -> -> * **_You enter:_** `TWiki <img src="%PUBURL%/wikiHome.gif" width="46" height="50" border="0" alt="logo" /> logo.`<br />**_Result:_**<br /> TWiki <img src="%PUBURL%/wikiHome.gif" width="46" height="50" alt="logo" /> logo. -> -> ---- -> -> ### <a name="Can_I_write_colored_text_"> Can I write colored text? </a> -> -> Sure. The quickest way is to go <font color="colorCode">colorize</font> - `font` is an HTML tag that works in any browser, although it's been phased out in the latest HTML specs. -> -> You can also use the up-to-date `style` attribute - ex: `style="color:#ff0000"` - placed in most HTML tags. `span` is an all-purpose choice: "<span style="color:#ff0000">CoLoR</span>. Only old (like 3.x IE & NS) browsers have a problem with `style`. -> -> "colorCode" is the _hexadecimal RGB color code_, which is simply Red, Green and Blue values in hex notation (base 16, 0-F). For pure red, the RGB components are 255-0-0 - full red (255), no green or blue. That's FF-0-0 in hex, or <code>"#ff000=" for Web page purposes. For a basic color selection (you can [[StandardColors]] names instead of hex code in the =font</code> tag only): -> -> <table> -> <tr bgcolor="#e0e0e0"> -> <td><font color="#000000"> <strong>Black:</strong> </font></td> -> <td><code>"#000000"</code></td> -> <td><font color="#008000"> <strong>Green:</strong> </font></td> -> <td><code>"#008000"</code></td> -> <td><font color="#c0c0c0"> <strong>Silver:</strong> </font></td> -> <td><code>"#c0c0c0"</code></td> -> <td><font color="#00ff00"> <strong>Lime:</strong> </font></td> -> <td><code>"#00ff00"</code></td> -> </tr> -> <tr bgcolor="#c0c0c0"> -> <td><font color="#808080"> <strong>Gray:</strong> </font></td> -> <td><code>"#808080"</code></td> -> <td><font color="#808000"> <strong>Olive:</strong> </font></td> -> <td><code>"#808000"</code></td> -> <td><font color="#ffffff"> <strong>White:</strong> </font></td> -> <td><code>"#ffffff"</code></td> -> <td><font color="#ffff00"> <strong>Yellow:</strong> </font></td> -> <td><code>"#ffff00"</code></td> -> </tr> -> <tr bgcolor="#e0e0e0"> -> <td><font color="#800000"> <strong>Maroon:</strong> </font></td> -> <td><code>"#800000"</code></td> -> <td><font color="#000080"> <strong>Navy:</strong> </font></td> -> <td><code>"#000080"</code></td> -> <td><font color="#ff0000"> <strong>Red:</strong> </font></td> -> <td><code>"#ff0000"</code></td> -> <td><font color="#0000ff"> <strong>Blue:</strong> </font></td> -> <td><code>"#0000ff"</code></td> -> </tr> -> <tr bgcolor="#c0c0c0"> -> <td><font color="#800080"> <strong>Purple:</strong> </font></td> -> <td>="#800080"= </td> -> <td><font color="#008080"> <strong>Teal:</strong> </font></td> -> <td><code>"#008080"</code></td> -> <td><font color="#ff00ff"> <strong>Fuchsia:</strong> </font></td> -> <td><code>"#ff00ff"</code></td> -> <td><font color="#00ffff"> <strong>Aqua:</strong> </font></td> -> <td><code>"#00ffff"</code></td> -> </tr> -> </table> -> -> * **_You enter:_** ` <font color="#ff0000"> Red color </font> draws attention. ` -> **_Result:_** <font> Red color </font> draws attention. -> -> ---- - --- [[PeterThoeny]] - 13 Sep 2001 <br /> -- [[MikeMannix]] - 14 Sep 2001 <br /> diff --git a/TWiki/TextFormattingRules.mdwn b/TWiki/TextFormattingRules.mdwn deleted file mode 100644 index 40203834..00000000 --- a/TWiki/TextFormattingRules.mdwn +++ /dev/null @@ -1,303 +0,0 @@ -%TOC\{depth="4"\}% %STARTINCLUDE% - -# <a name="TWiki_Text_Formatting"> TWiki Text Formatting </a> - -Working in TWiki is as easy as typing in text - exactly like email. You don't need to know HTML, though you can use it if you prefer. Links to topics are created automatically when you enter [[WikiWords]]. And TWiki shorthand gives you all the power of HTML with a simple coding system that takes no time to learn. It's all layed out below - refer back to this page in a pop-up window from the **Edit** screen. - -<a name="TWikiShorthand"></a> - -## <a name="TWiki_Editing_Shorthand"> TWiki Editing Shorthand </a> - -<table bgcolor="#000000" border="0" cellpadding="3" cellspacing="1"> - <tr bgcolor="#ffffff"> - <td><strong>Formatting Command:</strong></td> - <td><strong>Example: You write:</strong></td> - <td><strong>You get:</strong></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Paragraphs:</strong><br /> Blank lines will create new paragraphs. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -1st paragraph - -2nd paragraph -</pre> </font></span></td> - <td valign="top"> 1st paragraph <p> 2nd paragraph </p> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Headings:</strong><br /> At least three dashes at the beginning of a line, followed by plus signs and the heading text. One plus creates a level 1 heading (most important), two pluses a level 2 heading; the maximum is level 6. <strong><em>Note:</em></strong> A Table of Content can be created automatically with the <code>%<nop>TOC%</nop></code> variable, see [[TWikiVariables]]. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -<nop>---++ Sushi - -<nop>---+++ Maguro -</nop></nop></pre> </font></span></td> - <td valign="top"> - <h2>Sushi</h2> - <p> - </p> - <h3>Maguro</h3> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Bold Text:</strong><br /> Words get <strong>bold</strong> by enclosing them in <code>*</code> asterisks. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -*Bold* -</pre> </font></span></td> - <td valign="top"><strong>Bold</strong></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Italic Text:</strong><br /> Words get <em>italic</em> by enclosing them in <code>_</code> underscores. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -_Italic_ -</pre> </font></span></td> - <td valign="top"><em>Italic</em></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Bold Italic:</strong><br /> Words get <em>_bold italic</em> by enclosing them in <code>_</code> double-underscores. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -__Bold italic__ -</pre> </font></span></td> - <td valign="top"><strong><em>Bold italic</em></strong></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Fixed Font:</strong><br /> Words get shown in <code>fixed font</code> by enclosing them in <code><nop>=<nop></nop></nop></code> equal signs. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -=Fixed font= -</pre> </font></span></td> - <td valign="top"><code>Fixed font</code></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Bold Fixed Font:</strong><br /> Words get shown in <code><b>bold fixed font</b></code> by enclosing them in <code><b><nop></nop></b></code> double equal signs. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -==Bold fixed== -</pre> </font></span></td> - <td valign="top"><code><b>Bold fixed</b></code></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong><em>Note:</em></strong> Make sure to "stick" the <code>* _ = <nop>==<nop></nop></nop></code> signs to the words, e.g. take away spaces. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -_This works_, -_this not _ -</pre> </font></span></td> - <td valign="top"><em>This works</em>, _this not _ </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Verbatim Mode:</strong><br /> Surround code excerpts and other formatted text with <code>&lt;verbatim&gt;</code> and <code>&lt;/verbatim&gt;</code> tags. <br /><strong><em>Note:</em></strong> Use <code>&lt;pre&gt;</code> and <code>&lt;/pre&gt;</code> tags instead if you want that HTML code is interpreted. <br /><strong><em>Note:</em></strong> Each tag must be on a line by itself. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -&lt;verbatim&gt; -class CatAnimal { - void purr() { - &lt;code here&gt; - } -} -&lt;/verbatim&gt; -</pre> </font></span></td> - <td valign="top"><pre> -class CatAnimal { - void purr() { - &lt;code here&gt; - } -} -</pre></td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Separator:</strong><br /> At least three dashes at the beginning of a line. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -------- -</pre> </font></span></td> - <td valign="top"> - <hr /> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>List Item:</strong><br /> Three spaces and an asterisk. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> - * bullet item -</pre> </font></span></td> - <td valign="top"> - <ul> - <li> bullet item </li> - </ul> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Nested List Item:</strong><br /> Six, nine, ... spaces and an asterisk. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> - * nested stuff -</pre> </font></span></td> - <td valign="top"> - <ul> - <li> - <ul> - <li> nested stuff </li> - </ul> - </li> - </ul> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Ordered List:</strong><br /> Three spaces and a number. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> - 1 Sushi - 1 Dim Sum -</pre> </font></span></td> - <td valign="top"> - <ol> - <li> Sushi </li> - <li> Dim Sum </li> - </ol> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Definition List:</strong><br /> Three spaces, the term, a colon, a space, followed by the definition. <br /><strong><em>Note:</em></strong> Terms with spaces are not supported. In case you do have a term with more then one word, separate the words with dashes or with the <code>&amp;nbsp;</code> non-breaking-space entity. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> - Sushi: Japan - Dim&amp;nbsp;Sum: S.F. -</pre> </font></span></td> - <td valign="top"> - <dl> - <dt> Sushi</dt> - <dd> Japan </dd> - <dt> Dim Sum</dt> - <dd> S.F. </dd> - </dl> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Table:</strong><br /> Optional spaces followed by the cells enclosed in vertical bars. <br /><strong><em>Note:</em></strong> <code>| <nop>*bold*<nop> |</nop></nop></code> cells are rendered as table headers. <br /><strong><em>Note:</em></strong> <code>| spaced |</code> cells are rendered center aligned. <br /><strong><em>Note:</em></strong> <code>| spaced |</code> cells are rendered right aligned. <br /><strong><em>Note:</em></strong> <code>| 2 colspan ||</code> cells are rendered as multi-span columns. <br /><strong><em>Note:</em></strong> In case you have a long row and you want it to be more readable when you edit the table you can split the row into lines that end with a <code>'\'</code> backslash character. <br /> - </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -| *L* | *C* | *R* | -| A2 | 2 | 2 | -| A3 | 3 | 3 | -| multi span ||| -| A4 \<nop> - | next \<nop> - | next | -</nop></nop></pre> </font></span></td> - <td valign="top"> - <table border="1" cellpadding="1" cellspacing="0"> - <tr> - <th bgcolor="#99CCCC"><strong>L</strong></th> - <th bgcolor="#99CCCC"><strong>C</strong></th> - <th bgcolor="#99CCCC"><strong>R</strong></th> - </tr> - <tr> - <td> A2 </td> - <td align="center"> 2 </td> - <td align="right"> 2 </td> - </tr> - <tr> - <td> A3 </td> - <td align="center"> 3 </td> - <td align="right"> 3 </td> - </tr> - <tr> - <td colspan="3"> multi span </td> - </tr> - <tr> - <td> A4 </td> - <td> next </td> - <td> next </td> - </tr> - </table> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong><nop>WikiWord Links:</nop></strong><br /><nop>CapitalizedWordsStuckTogether (or [[WikiWords]]) will produce a link automatically. <br /><strong><em>Note:</em></strong> In case you want to link to a topic in a different %WIKITOOLNAME% web write <code>Webname.TopicName</code>. </nop></td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -WebNotify - -Know.ReadmeFirst -</pre> </font></span></td> - <td valign="top">[[WebNotify]]<p>[[Know/ReadmeFirst]]</p> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top">#SquareBrackets <strong>Forced Links:</strong><br /> You can create a forced internal link by enclosing words in double square brackets. <br /><strong><em>Note:</em></strong> Text within the brackets may contain optional spaces; the topic name is formed by capitalizing the initial letter and by removing the spaces; i.e. <code>[<nop>[text formatting FAQ]]</nop></code> links to topic [[TextFormattingFAQ]]. You can also refer to a different web and use anchors. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -[[wiki syntax]] - -[[%MAINWEB%.TWiki users]] -</pre> </font></span></td> - <td valign="top">[[WikiSyntax]]<p>[[MAINWEBTWikiUsers]]</p> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Specific Links:</strong><br /> Create a link where you can specify the link text and the link reference separately, using nested square brackets like <code>[<nop>[reference][text]]</nop></code>. Internal link references (i.e. [[WikiSyntax]]) and external link references (i.e. <a href="http://TWiki.org/)" target="_top">http://TWiki.org/)</a> are supported. The same <strong><em>Forced Links</em></strong> rules apply for internal link references. Anchor names can be added as well, like <code>[<nop>[WebHome#MyAnchor][go home]]</nop></code> and <code>[<nop>[http://www.yahoo.com/#somewhere][Yahoo!]]</nop></code>. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -[[WikiSyntax][syntax]] - -[[http://gnu.org][GNU]] -</pre> </font></span></td> - <td valign="top">[[WikiSyntax]]<p><a href="http://gnu.org" target="_top">GNU</a></p> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Anchors:</strong><br /> You can define a link reference inside a %WIKITOOLNAME% topic (called an anchor name) and link to that. To <strong><em>define</em></strong> an anchor write <code>#AnchorName</code> at the beginning of a line. The anchor name must be a [[WikiWord]]. To <strong><em>link to</em></strong> an anchor name use the <code>[<nop>[MyTopic#MyAnchor]]</nop></code> syntax. You can omit the topic name if you want to link within the same topic. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -[[WebHome#NotThere]] - -[[#MyAnchor][Jump]] - -#MyAnchor To here -</pre> </font></span></td> - <td valign="top">[[WebHome]]<p> Jump </p> - <p><a name="MyAnchor"></a> To here </p> - </td> - </tr> - <tr bgcolor="#ffffff"> - <td valign="top"><strong>Prevent a Link:</strong><br /> Prevent a [[WikiWord]] from being linked by prepending it with the <code>&lt;nop&gt;</code> tag. </td> - <td valign="top"><span style="background: #FFFFCC"><font color="#990000"> <pre> -&lt;nop&gt;SunOS -</pre> </font></span></td> - <td valign="top"><nop>SunOS </nop></td> - </tr> -</table> - -## <a name="Using_HTML"> </a> Using HTML - -You can use just about any HTML tag without a problem - however, there are a few usability and technical considerations to keep in mind. - -### <a name="HTML_and_TWiki_Usability"> </a> HTML and TWiki Usability - -* On collaboration pages, it's preferable NOT to use HTML, and to use TWiki shorthand instead - this keeps the text uncluttered and easy to edit. -* %X% **NOTE:** TWiki is designed to work with a wide range of browsers and computer platforms, holding to HTML 3.2 compatibility in the standard installation - adding raw HTML, particularly browser-specific tags (or any other mark-up that doesn't degrade well) will reduce compatibility. - -### <a name="TWiki_HTML_Rendering"> </a> TWiki HTML Rendering - -* TWiki converts shorthand notation to XHTML 1.0 for display. To copy a fully marked-up page, simply view source in your browser and save the contents. - * %T% If you need to save HTML frequently, you may want to check out TWiki:Plugins/GenHTMLAddon - it will "generate a directory containing rendered versions of a set of TWiki pages together with any attached files." -* %X% **NOTE:** The opening and closing angle brackets - <code>**<...>**</code> - of an HTML tag **_must be on the same line_**, or the tag will be broken. - * This feature allows you to enter an unclosed angle bracket - as a greater than or less than symbol - and have it automatically rendered as if you had entered its HTML character, `<`, ex: <code>**a > b**</code> - * %T% If you're pasting in preformatted HTML text and notice problems, check the file in a text processor with no text wrap. Also, save without hard line breaks on text wrap, in your HTML editing program. - -## <a name="Hyperlinks"> Hyperlinks </a> - -Being able to create links without any formatting required is a core TWiki feature, made possible with [[WikiWords]]. New TWiki linking rules are a simple extension of the syntax that provide a new set of flexible options. - -### <a name="Internal_Links"> Internal Links </a> - -* [[GoodStyle]] is a [[WikiWord]] that links to the GoodStyle topic located in the current %WIKITOOLNAME% web. - -* [[NotExistingYet]] is a topic waiting to be written. Create the topic by clicking on the **?**. (Try clicking, but then, **Cancel** - creating the topic would wreck this example!) - -### <a name="External_Links"> External Links </a> - -* `http://...`, `https://...`, `ftp://...` and `mailto:...@...` are linked automatically. - -* Email addresses like `name@domain.com` are linked automatically. - -* <code>[[Square bracket rules]]</code> let you easily create non-WikiWord links. - -## <a name="TWikiPlugin_Formatting_Extension"> TWikiPlugin Formatting Extensions </a> - -Plugins provide additional text formatting capabilities and can extend the functionality of %WIKITOOLNAME% into many other areas. For example, the optional [SpreadSheetPlugin](http://twiki.org/cgi-bin/view/Plugins/SpreadSheetPlugin) lets you create a spreadsheet with the same basic notation used in TWiki tables. - -Available Plugins are located in the [Plugins](http://twiki.org/cgi-bin/view/Plugins) web on TWiki.org. Currently enabled plugins on this TWiki installation, as listed by <code>%PLUGINDESCRIPTIONS%</code>: - -%PLUGINDESCRIPTIONS% - -Check on current Plugin status and settings for this site in [[TWikiPreferences]]. - --- [[Main/MikeMannix]] - 02 Dec 2001 diff --git a/TWiki/TigerSkin.mdwn b/TWiki/TigerSkin.mdwn deleted file mode 100644 index b35a5370..00000000 --- a/TWiki/TigerSkin.mdwn +++ /dev/null @@ -1,75 +0,0 @@ -### <a name="Welcome_to_the_TigerSkin"> </a> Welcome to the [[TigerSkin]] - -So named because of the stripes in the background. - -The [[TigerSkin]] is the default skin for the vmlinux.org TWiki. Enjoy! - -This skin provides the following: - -* An attractive design with the expectations of typical web users in mind (ie navbar on the left hand side, content on the right) - -* A top menubar that highlights the main features of TWiki (edit and attach) and conceals the more complex features under a pop up (diffs, create, etc) - -* A configurable left hand menu bar - the contents can be set in an editable [[WebMenu]] topic - one for the %TWIKIWEB% web and optionally one for other webs. See [[WebMenuFormat]] for details. - -* A top left hand icon that may change according to web selection. Add a setting to the [[WebPreferences]] page, the LOGO variable indicates what logo to use. - -> * <code>**Set LOGO = %PUBURL%/%MAINWEB%/LogoTopic/logo.gif**</code> - -* Simple Web.TopicName location status - -* A quick search box - -* Username feedback with a click to personal topics (requires sessions) - -* Cascading style sheet for structured style alterations (however, we do not constrain the font size of TWiki content - use View/Textsize in your browser for this) - -* Javascript to open/close menu folders, etc. - -Installation: - -* Unzip the skin and plugin into your TWiki installation - -* Then edit [[WebMenu]] to set the contents of the menu bar, supplied one cover TWiki, Main and Test Webs - -* Add the following line to %TWIKIWEB%.TWikiPreferences or to any [[WebPreferences]] topic - - * Set SKIN = tiger - -* This version also has support proof-of-concept support for additional skins of the Tiger Skin class. Set skin = blue to see alternative. -* If using multiple skin handlers then the following line needs to be included in %TWIKIWEB%.TWikiPreferences to set the TWiki wide default or in a specific [[WebPreferences]] topic to use the Tiger Skin handler only for that Web. - - * Set SKINHANDLER = Tiger - -* **Note:** As this is the first (and currently only) Skin Handler it defaults to procssing the SKIN unless SKINHANDLER is set to some value besides Tiger. - -The [[TigerSkin]] comes with a plugin - see [[TigerSkinPlugin]] - that inserts items such as the left hand menu. It uses the plugin to read the [[WebMenu]] topic, etc. - -The [[TigerSkin]] can be used (optionally) with the [[SessionPlugin]] - it then allows logon and session management. - -Please note: - -* The [[TigerSkin]] is designed for use with IE 5.0 and 5.5 - not (yet) Netscape compatible. Although this version provides initial integration of the NS - -* The [[TigerSkin]] purposely avoids using different colors for different webs - we think that this is desconcerting to novice users. - -* The [[TigerSkin]] needs a TWiki beta release dated after 27 Jul 2001 - -* The [[TigerSkin]] uses the new <http://twiki.org/cgi-bin/view/Codev/TWikiTemplatingSystem> - -An example logo is attached to this page - just download and edit to make your own logo. It should be named logo.gif. The overall site logo lives as an attachment hereto, individual web logos should be placed in pub/webname/logo.gif. Please be sure to acknowledge TWiki.org appropriately. - -For help and advice, please email %MAINWEB%.SteveRoe or %MAINWEB%.JohnTalintyre - -### <a name="_TOPIC_Settings"> %TOPIC% Settings </a> - -Plugin settings are stored as preferences variables. To reference a plugin setting write <code>**%<plugin>\_<setting>%**</code>, i.e. <code>**%EMPTYPLUGIN\_SHORTDESCRIPTION%**</code> - -* One line description, is shown in the %TWIKIWEB%.TextFormattingRules topic: - * Set SHORTDESCRIPTION = Supports [[TigerSkin]] - -* Max number of revisions to show on drop down menu - * Set NUMREVISIONS = 5 - -* Debug plugin: (See output in `data/debug.txt`) - * Set DEBUG = 0 diff --git a/TWiki/TigerSkin/RCS/menuscript.js b/TWiki/TigerSkin/RCS/menuscript.js deleted file mode 100644 index 6b30f176..00000000 --- a/TWiki/TigerSkin/RCS/menuscript.js +++ /dev/null @@ -1,289 +0,0 @@ -// Determine browser type (Netscape 6 or IE 5.5).
-
-
-var isIE5 = (navigator.userAgent.indexOf("MSIE 5.5") > 0) ? 1 : 0;
-var isIE5 = (navigator.userAgent.indexOf("MSIE 5") > 0) ? 1 : 0;
-var isNS6 = (navigator.userAgent.indexOf("Gecko") > 0) ? 1 : 0;
-var isNS4 = ((navigator.appName.indexOf("Netscape")==0)
- &&(navigator.userAgent.indexOf("Mozilla/4") == 0)) ? 1 : 0;
-
-//if (isNS4==0)
-// alert("This skin has been designed for Netscape 4.x.");
-
-// For IE, adjust menu bar styling.
-
-if (isIE5) {
- document.styleSheets[document.styleSheets.length - 1].addRule("#menuBar", "padding-top:3px");
- document.styleSheets[document.styleSheets.length - 1].addRule("#menuBar", "padding-bottom:3px");
-}
-
-// Global variable for tracking the currently active button.
-
-var activeButton = null;
-
-if (isIE5)
- document.onmousedown = pageMousedown;
-if (isNS6)
- document.addEventListener("mousedown", pageMousedown, true);
-
-function pageMousedown(event) {
-
- var className;
-
- // If the object clicked on was not a menu button or item, close any active
- // menu.
-
- if (isIE5)
- className = window.event.srcElement.className;
- if (isNS6)
- className = (event.target.className ?
- event.target.className : event.target.parentNode.className);
-
- //Top menu mouseover
- if (className != "menuButton" && className != "menuItem" && className != "menuItemDiff" && activeButton)
- resetButton(activeButton);
-
-
- //Left menu show hide
- var eSrc = window.event.srcElement;
- window.event.cancelBubble = true;
- if ("clsShowHide" == eSrc.className) return contentsHeading_click(eSrc);
-
- //Original version of this (with frames support)
- //while ("BODY" != eSrc.tagName) {
- // if ("clsItem" == eSrc.className || "clsItemSelect" == eSrc.className) return contentsItem_click(eSrc);
- // else if ("clsShowHide" == eSrc.className || "clsHeading" == eSrc.className) return contentsHeading_click(eSrc);
- // eSrc = eSrc.parentElement;
- //}
-}
-
-function buttonClick(button, menuName) {
-
- // Blur focus from the link to remove that annoying outline.
-
- if (!isNS4)
- button.blur();
-
- // Associate the named menu to this button if not already done.
-
- if (!button.menu)
- {
- if (isNS4)
- button.menu = document.layers[menuName];
- else
- button.menu = document.getElementById(menuName);
- }
-
-
- // Reset the currently active button, if any.
-
- if (activeButton && activeButton != button)
- resetButton(activeButton);
-
- // Toggle the button's state.
-
- if (button.isDepressed)
- resetButton(button);
- else
- depressButton(button);
-
- return false;
-}
-
-function buttonMouseover(button, menuName) {
-
- // If any other button menu is active, deactivate it and activate this one.
- // Note: if this button has no menu, leave the active menu alone.
-
- if (activeButton) {
- if (activeButton != button) {
- resetButton(activeButton);
- if (menuName)
- buttonClick(button, menuName);
- }
- else {
- }
- }
- else {
- if (menuName)
- buttonClick(button, menuName);
- }
-}
-
-function depressButton(button) {
-
- // Save current style values so they can be restored later.
- // Only needs to be done once.
-
- if (!button.oldBackgroundColor) {
- button.oldBackgroundColor = button.style.backgroundColor;
- button.oldBorderBottomColor = button.style.borderBottomColor;
- button.oldBorderRightColor = button.style.borderRightColor;
- button.oldBorderTopColor = button.style.borderTopColor;
- button.oldBorderLeftColor = button.style.borderLeftColor;
- button.oldColor = button.style.color;
- button.oldLeft = button.style.left;
- button.oldPosition = button.style.position;
- button.oldTop = button.style.top;
- }
-
- // Change style value to make the button looks like it's
- // depressed.
-
- button.style.backgroundColor = "#99CC99";
- button.style.borderBottomColor = "#99CC99";
- button.style.borderRightColor = "#99CC99";
- button.style.borderTopColor = "#99CC99";
- button.style.borderLeftColor = "#99CC99";
- button.style.color = "#E9E9E9";
- button.style.left = "0px";
- button.style.position = "relative";
- button.style.top = "0px";
-
- // For IE, force first menu item to the width of the parent menu,
- // this causes mouseovers work for all items even when cursor is
- // not over the link text.
-
- if (isIE5 && !button.menu.firstChild.style.width)
- button.menu.firstChild.style.width =
- button.menu.offsetWidth + "px";
-
-if (isNS4)
-{
- button.menu.left = (window.innerWidth-100);
- button.menu.top = 0;
- button.menu.visibility = "show";
-}
-else
-{
-
-
- // Position the associated drop down menu under the button and
- // show it. Note that the position must be adjusted according to
- // browser, styling and positioning.
-
- //x = getPageOffsetLeft(button);
- x = getPageOffsetLeft(button);
- y = getPageOffsetTop(button) + button.offsetHeight;
- if (isIE5)
- y += 2;
- if (isNS6) {
- x--;
- y--;
- }
- x -= 20;
- y -= 10;
- button.menu.style.left = x + "px";
- button.menu.style.top = y + "px";
- button.menu.style.visibility = "visible";
-}
-
- // Set button state and let the world know which button is
- // active.
-
- button.isDepressed = true;
- activeButton = button;
-}
-
-function resetButton(button) {
-
- // Restore the button's style settings.
-
- button.style.backgroundColor = button.oldBackgroundColor;
- button.style.borderBottomColor = button.oldBorderBottomColor;
- button.style.borderRightColor = button.oldBorderRightColor;
- button.style.borderTopColor = button.oldBorderTopColor;
- button.style.borderLeftColor = button.oldBorderLeftColor;
- button.style.color = button.oldColor;
- button.style.left = button.oldLeft;
- button.style.position = button.oldPosition;
- button.style.top = button.oldTop;
-
- // Hide the button's menu.
-
- if (button.menu)
- {
- if (isNS4)
- button.menu.visibility = "hide";
- else
- button.menu.style.visibility = "hidden";
-
- }
-
-
- // Set button state and clear active menu global.
-
- button.isDepressed = false;
- activeButton = null;
-}
-
-function getPageOffsetLeft(el) {
-
- // Return the true x coordinate of an element relative to the page.
-
- return el.offsetLeft + (el.offsetParent ? getPageOffsetLeft(el.offsetParent) : 0);
-}
-
-
-function getPageOffsetTop(el) {
-
- // Return the true y coordinate of an element relative to the page.
-
- return el.offsetTop + (el.offsetParent ? getPageOffsetTop(el.offsetParent) : 0);
-}
-
-
-// Swap background colour
-function bgcolour(obj, Colour) {
- obj.style.backgroundColor=Colour
-}
-
-//Pop up window
-function MM_openBrWindow(theURL,winName,features) { //v2.0
- window.open(theURL,winName,features);
-}
-
-function MM_findObj(n, d) { //v3.0
- var p,i,x; if(!d) d=document; if((p=n.indexOf("?"))>0&&parent.frames.length) {
- d=parent.frames[n.substring(p+1)].document; n=n.substring(0,p);}
- if(!(x=d[n])&&d.all) x=d.all[n]; for (i=0;!x&&i<d.forms.length;i++) x=d.forms[i][n];
- for(i=0;!x&&d.layers&&i<d.layers.length;i++) x=MM_findObj(n,d.layers[i].document); return x;
-}
-/* Functions that swaps %PUBURLPATH%/skins/tiger. */
-function MM_swapImage() { //v3.0
- var i,j=0,x,a=MM_swapImage.arguments; document.MM_sr=new Array; for(i=0;i<(a.length-2);i+=3)
- if ((x=MM_findObj(a[i]))!=null){document.MM_sr[j++]=x; if(!x.oSrc) x.oSrc=x.src; x.src=a[i+2];}
-}
-
-//Left menu folders
-var eSelected = null;
-function contentsHeading_click(eSrc) {
- if ("clsShowHide" == eSrc.className) eSrc = document.all[eSrc.sourceIndex + 1];
- var iNumElements = document.all.length;
- for (var i=eSrc.sourceIndex+1;i<iNumElements;i++) {
- var eTemp = document.all[i];
- if ("clsHeading" == eTemp.className) return;
- else if ("clsItemsHide" == eTemp.className) {
- eTemp.className = "clsItemsShow";
- //No image url in .js - not subject to wiki vars
- //eSrc.style.listStyleImage = "url('images/blueminus.gif')";
- return eSrc.blur();
- }
- else if("clsItemsShow" == eTemp.className) {
- eTemp.className = "clsItemsHide";
- //No image url in .js - not subject to wiki vars
- //eSrc.style.listStyleImage = "url('images/blueplus.gif')";
- return eSrc.blur();
- }
- }
-}
-function contentsItem_click(eSrc) {
- if (document.all["styleView"]) eSrc.target = document.all["styleView"].checked ? "_blank" : "TEXT";
- else if ("" == eSrc.target) eSrc.target = "TEXT"
- if(null != eSelected) eSelected.className = "clsItem";
- eSrc.className = "clsItemSelect";
- eSelected = eSrc;
-}
-
-
-
diff --git a/TWiki/TigerSkin/new_logo.gif b/TWiki/TigerSkin/new_logo.gif Binary files differdeleted file mode 100644 index 6f149e1f..00000000 --- a/TWiki/TigerSkin/new_logo.gif +++ /dev/null diff --git a/TWiki/TigerSkinPlugin.mdwn b/TWiki/TigerSkinPlugin.mdwn deleted file mode 100644 index 4c00e0bb..00000000 --- a/TWiki/TigerSkinPlugin.mdwn +++ /dev/null @@ -1,64 +0,0 @@ -## <a name="Tiger_Skin_Plugin"> Tiger Skin Plugin </a> - -This is the [[TigerSkin]] plugin, named after the stripes in the background. - -* See the main site on <http://twiki.org> for plugins, or the local wiki, -* details in %TWIKIWEB%.TWikiPlugins. - -### <a name="_TOPIC_Settings"> %TOPIC% Settings </a> - -Plugin settings are stored as preferences variables. To reference a plugin setting write <code>**%<plugin>\_<setting>%**</code>, i.e. <code>**%EMPTYPLUGIN\_SHORTDESCRIPTION%**</code> - -* One line description, is shown in the %TWIKIWEB%.TextFormattingRules topic: - * Set SHORTDESCRIPTION = Supports [[TigerSkin]] - -* Max number of revisions to show on drop down menu - * Set NUMREVISIONS = 5 - -* Debug plugin: (See output in `data/debug.txt`) - * Set DEBUG = 0 - -### <a name="Plugin_Installation_Instructions"> Plugin Installation Instructions </a> - -* See the [[TigerSkin]] page for information on download and setup. - -### <a name="Plugin_Info"> Plugin Info </a> - -<table border="1" cellpadding="1" cellspacing="0"> - <tr> - <td align="right"> Plugin Author: </td> - <td> Unknown </td> - </tr> - <tr> - <td align="right"> Plugin Version: </td> - <td> 14 Jul 2001 </td> - </tr> - <tr> - <td align="right"> Change History: </td> - <td> 14 Jul 2001: Changed to plug&amp;play <br /> 27 Feb 2001: Initial version </td> - </tr> - <tr> - <td align="right"> CPAN Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Other Dependencies: </td> - <td> none </td> - </tr> - <tr> - <td align="right"> Perl Version: </td> - <td> 5.0 </td> - </tr> - <tr> - <td align="right"> Plugin Home: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td> - </tr> - <tr> - <td align="right"> Feedback: </td> - <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td> - </tr> -</table> - -**_Related Topics:_** %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins, [[DefaultPlugin]] - --- [[JoachimNilsson]] - 11 Jul 2002 <br /> diff --git a/TWiki/UnlockTopic.mdwn b/TWiki/UnlockTopic.mdwn deleted file mode 100644 index 1ae4398f..00000000 --- a/TWiki/UnlockTopic.mdwn +++ /dev/null @@ -1,7 +0,0 @@ -Topics get locked for some time (default is one hour) whenever a user edits, previews or saves a topic. This is to prevent simultaneous topic updates. There is a lock warning if another users tries to edit a topic while the lock is still on. - -You can remove the lock by checking the "Release edit lock" checkbox in preview. This is a way to let other people know that you are done with your editing. **_Note:_** Please remember **not** to go back in your browser in case you checked the box and after that you decide to do more changes to the topic. Instead press the **Edit** link to re-edit your page. - -**_Note:_** The "Cancel edit" link in edit mode lets you cancel out of an edit session without saving any changes. It also releases the edit lock, so that other people don't get the lock warning. - -**_Note:_** The initial state of the checkbox can be set to on with the `RELEASEEDITLOCKCHECKBOX` preferences variable. See [[TWikiPreferences]] for more. diff --git a/TWiki/WabiSabi.mdwn b/TWiki/WabiSabi.mdwn deleted file mode 100644 index 08139c43..00000000 --- a/TWiki/WabiSabi.mdwn +++ /dev/null @@ -1,22 +0,0 @@ -<img src="%ATTACHURLPATH%/wabisabi.gif" width="251" height="79" alt="Wabi Sabi" /> Since wabi-sabi represents a comprehensive Japanese world view or aesthetic system, it is difficult to explain precisely in western terms. According to Leonard Koren, wabi-sabi is the most conspicuous and characteristic feature of what we think of as traditional Japanese beauty and it "occupies roughly the same position in the Japanese pantheon of aesthetic values as do the Greek ideals of beauty and perfection in the West." - -Wabi-sabi is a beauty of things imperfect, impermanent, and incomplete. It is the beauty of things modest and humble. It is the beauty of things unconventional. - -The concepts of wabi-sabi correlate with the concepts of Zen Buddhism, as the first Japanese involved with wabi-sabi were tea masters, priests, and monks who practiced Zen. Zen Buddhism originated in India, traveled to China in the 6th century, and was first introduced in Japan around the 12th century. Zen emphasizes "direct, intuitive insight into transcendental truth beyond all intellectual conception." At the core of wabi- sabi is the importance of transcending ways of looking and thinking about things/existence. - -* All things are impermanent -* All things are imperfect -* All things are incomplete - -Material characteristics of wabi-sabi: - -* Suggestion of natural process -* Irregular -* Intimate -* Unpretentious -* Earthy -* Simple - -For more about wabi-sabi, see <http://www.art.unt.edu/ntieva/artcurr/japan/wabisabi.htm> - -**_Related Topics:_** [[WikiCulture]], [[TWikiSite]] diff --git a/TWiki/WebHome/new_logo.gif b/TWiki/WebHome/new_logo.gif Binary files differdeleted file mode 100644 index 6f149e1f..00000000 --- a/TWiki/WebHome/new_logo.gif +++ /dev/null diff --git a/TWiki/WebPreferences/logo.gif b/TWiki/WebPreferences/logo.gif Binary files differdeleted file mode 100644 index 6f149e1f..00000000 --- a/TWiki/WebPreferences/logo.gif +++ /dev/null diff --git a/TWiki/WelcomeGuest.mdwn b/TWiki/WelcomeGuest.mdwn deleted file mode 100644 index 4ad96810..00000000 --- a/TWiki/WelcomeGuest.mdwn +++ /dev/null @@ -1,56 +0,0 @@ -Welcome %WIKIUSERNAME%, - -You have reached a [[TWikiSite]] (pronounced twee-kee site). TWiki powers meeting places (such as this one) where people collaborate on common interests. Anyone can contribute using a regular Web browser. TWiki looks like a normal Web site, but it allows (and ecourages) everyone to **edit the web pages** and contribute their questions and input. It really is very simple to learn and use, and provides possibly the most powerful way to exchange and develop ideas online, in an open, uncomplicated environment. - -**How TWiki Works** - -1. **Read:** You can treat this site like any other. Browse, and follow interesting links. A couple of hints: - * **web:** A [[TWikiSite]] is divided into webs; each one represents one subject, one area of collaboration. You can reach any web from the links in the upper right corner of every page. - * **topic:** Each web is made up of hyperlinked topics - [[TWikiPages]] that appear in your browser. - * **What's new:** Visit [[WebChanges]] in any TWiki web to see what other people are discussing and what's been added most recently. -2. **Create an Account:** To be able to write new content on this site, you'll need to create an account for yourself. It's simple, and only takes a minute: just visit [[TWikiRegistration]] and fill out the form. This will also create your personal home page. -3. **Write:** If you have something to say, speak your mind! Anyone can change or add to anything they see written in a TWiki topic. You can edit a topic from within your browser, using [[TWikiShorthand]], a very simple markup language (you can also use HTML if you like, but you'll usually find you can get the same results more easily with [[TWikiShorthand]]). To contribute, - * click the `Edit` link at the bottom of the page, edit the text, and then - * click the `[ Preview Changes ]` button at the bottom of the page to see what your topic will look like (use the BACK button on your browser to go back and fix something.), and finally - * click the `[ Save Changes ]` to save what you did. -4. **But this is scary!** Anybody can do anything! The concept at first may seem...strange. Uncontrollable. And yet, collaborating the Wiki way works! Older versions of content are always available. See [[WikiCulture]]. (You can define fine-grained [[TWikiAccessControl]] based on users groups if really necessary, and there's full revision control that retains all changes!) -5. **Experiment:** To get your virtual hands dirty, visit Test.%HOMETOPIC% in the %WIKITOOLNAME%.Test web. -6. **Create a link:** To link to another topic, start by editing an existing topic. - * To create a link to a topic that already exists, type its `JoinCapitalizedWords` name (topics are automatically linked if they are [[WikiWords]], names composed of two or more words with initial capitals, run together). - * To create a link to a page that does not yet exist, make up and enter a `NeverBeforeUsedPhrase`. You are encouraged to include [[WikiWords]] in your content, for others to fill out later. - * When you've saved the topic, and redisplayed it, the references to existing topics will be linked and the references to topics that don't exist will be followed by a linked "<u>?</u>" (question mark). -7. **Create a topic:** - * To write something up for a new topic, click on the "<u>?</u>" (question mark) that follows a [[WikiWord]]. - * To create a free-floating topic - a topic that is not linked from anywhere - type its [[WikiWord]] in the entry field at the top of any page. If the topic already exists you'll then be taken to it. If it doesn't exist, you'll then have the option to create it. -8. **See the history of a topic:** Click the <code>**Diffs**</code> link on the control strip at the bottom of every page to see a complete history of edits for that topic. -9. **Attach files:** Use your browser to upload and attach any type of file to a topic using the <code>**Attach**</code> link at the bottom of the page. -10. **Organize:** Use [[TWikiForms]] to include specific information wiht individual topics - for example, classify pages by subject, status, or date. -11. **Learn more**: [[TWikiTutorial]] takes you on a 20-minute tour of the TWiki essentials. [[WikiReferences]] has links to articles and books about online collaboration and Wiki technology in particular. - -**Main Features of TWiki** - -* Edit existing pages or create new pages by using any Web browser. -* Web pages are automatically linked. You do not need to learn HTML commands to link pages. -* Very simple text formatting. Basically, you write a page the same way you would write an email. -* Fast, full-text search with or without regular expressions. -* All changes to pages and attachments are under revision control. Find out who changed what and when. -* Fine-grained access control based on users and groups. -* Automatic email notification when pages change. -* File attachments: Upload and download any file as an attachment to a page, using your browser. This is similar to email file attachments, but it happens on web pages. -* Topic locking: Users are warned if a page is being edited by another person, to avoid simultaneous page editing. -* Templates and skins: Customize every possible aspect of the look and feel of each TWiki installation, down to the individual page level. -* Plugins: A growing collection of plugins allows you to easily add optional extended functions, or to create your own. -* Support: An active, helpful development community keeps TWiki support and development constantly moving forward. -* **_Read more_** about the TWiki at <http://TWiki.org/> . - -**Starting Points in the %WIKITOOLNAME%.%WEB% web** - -* **[[TWikiTutorial]]**: Familiarize yourself with TWiki before you start editing content. -* %HOMETOPIC%: Entry point of this %WIKITOOLNAME% web. -* [[TWikiSite]]: Explains what a TWiki site is. -* [[GoodStyle]]: Things to consider when changing text. -* [[WikiSyntax]]: Easy to learn rules when editing text. -* [[WebChanges]]: Recent changes to the %WIKITOOLNAME%.%WEB% web. -* [[TWikiRegistration]]: **Before you leave**, add your name here. - -%INCLUDE\{"TWikiWebsTable"\}% diff --git a/TWiki/WhatIsWikiWiki.mdwn b/TWiki/WhatIsWikiWiki.mdwn deleted file mode 100644 index 30b4d390..00000000 --- a/TWiki/WhatIsWikiWiki.mdwn +++ /dev/null @@ -1,11 +0,0 @@ -## <a name="FAQ_"> </a> FAQ: - -So what is this WikiWiki thing exactly? - -## <a name="Answer_"> Answer: </a> - -A set of pages of information that are open and free for anyone to edit as they wish. They are stored on a server and managed using some Perl CGI scripts. The system creates cross-reference hyperlinks between pages automatically. See [[WelcomeGuest]] and [[TWikiSite]] for more information. - -**_Back to:_** [[TWikiFAQ]] - --- [[Main/PeterThoeny]] - 27 Nov 2000 <br /> diff --git a/TWiki/WikiCulture.mdwn b/TWiki/WikiCulture.mdwn deleted file mode 100644 index f1260af0..00000000 --- a/TWiki/WikiCulture.mdwn +++ /dev/null @@ -1,23 +0,0 @@ -## <a name="FAQ_"> </a> FAQ: - -Everybody can edit any page, this is scary. Doesn't that lead to chaos? - -## <a name="Answer_"> Answer: </a> - -%WIKITOOLNAME% is one of many [[WikiWikiClones]], the first one was built by Ward Cummingham. Collaborating the Wiki way is different from other collaboration tools like Usenet. A distinct **_Wiki culture_** forms around these tools: - -* Any and all information can be deleted by anyone. Wiki pages represent nothing but discussion and consensus because it's much easier to delete flames, spam and trivia than to indulge them. What remains is naturally meaningful. - -* Anyone can play. This sounds like a recipe for low signal - surely wiki gets hit by the unwashed masses as often as any other site. But to make any sort of impact on wiki you need to be able to generate content. So anyone can play, but only good players have any desire to keep playing. - -* Wiki is not WYSIWYG. Contra the dumbing down of programming, it's an intelligence test of sorts to be able to edit a wiki page. It's not rocket science, but it doesn't appeal to the TV-watchers. If it doesn't appeal, they don't participate, which leaves those of us who read and write to get on with rational discourse. - -* Wiki is far from real time. Folk have time to think, often days or weeks, before they follow up some wiki page. So what people write is well-considered. - -(quoted from _WhyWikiWorks_ at Ward's original Wiki system, the Portland Pattern Repository, Wiki:WhyWikiWorks) - -**_Related topics:_** [[TWikiSite]], [[WelcomeGuest]], [[GoodStyle]], [[WikiSyntax]], [[TWikiFAQ]], [[WabiSabi]] - -**_Back to:_** [[TWikiFAQ]] - --- %MAINWEB%.PeterThoeny - 27 Nov 2000 <br /> diff --git a/TWiki/WikiName.mdwn b/TWiki/WikiName.mdwn deleted file mode 100644 index adf75dcb..00000000 --- a/TWiki/WikiName.mdwn +++ /dev/null @@ -1,5 +0,0 @@ -Your name in [[WikiNotation]]. Usually your first and last name connected togther. - -For example, Bill Clinton's WikiName is [[BillClinton]]. - -**_Note:_** All users are in the %WIKITOOLNAME%.%MAINWEB% web. Prepend the "%MAINWEB%" name if you write a username in a topic, i.e. write <code>%MAINWEB%.TWikiGuest</code> to link to %MAINWEB%.TWikiGuest. diff --git a/TWiki/WikiNotation.mdwn b/TWiki/WikiNotation.mdwn deleted file mode 100644 index 399b5a66..00000000 --- a/TWiki/WikiNotation.mdwn +++ /dev/null @@ -1 +0,0 @@ -Wiki links topics automatically when you use the [[WikiWord]] notation. diff --git a/TWiki/WikiNotation/XF86Config b/TWiki/WikiNotation/XF86Config deleted file mode 100644 index 08a241df..00000000 --- a/TWiki/WikiNotation/XF86Config +++ /dev/null @@ -1,469 +0,0 @@ -# File generated by xf86config. - -# -# Copyright (c) 1999 by The XFree86 Project, Inc. -# -# Permission is hereby granted, free of charge, to any person obtaining a -# copy of this software and associated documentation files (the "Software"), -# to deal in the Software without restriction, including without limitation -# the rights to use, copy, modify, merge, publish, distribute, sublicense, -# and/or sell copies of the Software, and to permit persons to whom the -# Software is furnished to do so, subject to the following conditions: -# -# The above copyright notice and this permission notice shall be included in -# all copies or substantial portions of the Software. -# -# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -# THE XFREE86 PROJECT BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF -# OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -# SOFTWARE. -# -# Except as contained in this notice, the name of the XFree86 Project shall -# not be used in advertising or otherwise to promote the sale, use or other -# dealings in this Software without prior written authorization from the -# XFree86 Project. -# - -# ********************************************************************** -# Refer to the XF86Config(4/5) man page for details about the format of -# this file. -# ********************************************************************** - -# ********************************************************************** -# Module section -- this section is used to specify -# which dynamically loadable modules to load. -# ********************************************************************** -# -Section "Module" - -# This loads the DBE extension module. - - Load "dbe" # Double buffer extension - -# This loads the miscellaneous extensions module, and disables -# initialisation of the XFree86-DGA extension within that module. - SubSection "extmod" - Option "omit xfree86-dga" # don't initialise the DGA extension - EndSubSection - -# This loads the Type1 and FreeType font modules - Load "type1" - Load "speedo" -# Load "freetype" -# Load "xtt" - -# This loads the GLX module - Load "glx" -# This loads the DRI module -# Load "dri" - -EndSection - -# ********************************************************************** -# Files section. This allows default font and rgb paths to be set -# ********************************************************************** - -Section "Files" - -# The location of the RGB database. Note, this is the name of the -# file minus the extension (like ".txt" or ".db"). There is normally -# no need to change the default. - - RgbPath "/usr/X11R6/lib/X11/rgb" - -# Multiple FontPath entries are allowed (which are concatenated together), -# as well as specifying multiple comma-separated entries in one FontPath -# command (or a combination of both methods) -# -# If you don't have a floating point coprocessor and emacs, Mosaic or other -# programs take long to start up, try moving the Type1 and Speedo directory -# to the end of this list (or comment them out). -# - -# FontPath "/usr/X11R6/lib/X11/fonts/TTF/" - FontPath "/usr/X11R6/lib/X11/fonts/cyrillic/" - FontPath "/usr/X11R6/lib/X11/fonts/local/" - FontPath "/usr/X11R6/lib/X11/fonts/misc/" - FontPath "/usr/X11R6/lib/X11/fonts/75dpi/:unscaled" - FontPath "/usr/X11R6/lib/X11/fonts/100dpi/:unscaled" - FontPath "/usr/X11R6/lib/X11/fonts/Speedo/" - FontPath "/usr/X11R6/lib/X11/fonts/Type1/" -# FontPath "/usr/X11R6/lib/X11/fonts/TrueType/" -# FontPath "/usr/X11R6/lib/X11/fonts/freefont/" - FontPath "/usr/X11R6/lib/X11/fonts/75dpi/" - FontPath "/usr/X11R6/lib/X11/fonts/100dpi/" - -# The module search path. The default path is shown here. - -# ModulePath "/usr/X11R6/lib/modules" - -EndSection - -# ********************************************************************** -# Server flags section. -# ********************************************************************** - -Section "ServerFlags" - -# Uncomment this to cause a core dump at the spot where a signal is -# received. This may leave the console in an unusable state, but may -# provide a better stack trace in the core dump to aid in debugging - -# Option "NoTrapSignals" - -# Uncomment this to disable the <Crtl><Alt><Fn> VT switch sequence -# (where n is 1 through 12). This allows clients to receive these key -# events. - -# Option "DontVTSwitch" - -# Uncomment this to disable the <Crtl><Alt><BS> server abort sequence -# This allows clients to receive this key event. - -# Option "DontZap" - -# Uncomment this to disable the <Crtl><Alt><KP_+>/<KP_-> mode switching -# sequences. This allows clients to receive these key events. - -# Option "Dont Zoom" - -# Uncomment this to disable tuning with the xvidtune client. With -# it the client can still run and fetch card and monitor attributes, -# but it will not be allowed to change them. If it tries it will -# receive a protocol error. - -# Option "DisableVidModeExtension" - -# Uncomment this to enable the use of a non-local xvidtune client. - -# Option "AllowNonLocalXvidtune" - -# Uncomment this to disable dynamically modifying the input device -# (mouse and keyboard) settings. - -# Option "DisableModInDev" - -# Uncomment this to enable the use of a non-local client to -# change the keyboard or mouse settings (currently only xset). - -# Option "AllowNonLocalModInDev" - -EndSection - -# ********************************************************************** -# Input devices -# ********************************************************************** - -# ********************************************************************** -# Core keyboard's InputDevice section -# ********************************************************************** - -Section "InputDevice" - - Identifier "Keyboard1" - Driver "Keyboard" - Option "AutoRepeat" "500 30" - Option "XkbRules" "xfree86" - Option "XkbModel" "pc105" - Option "XkbLayout" "us,ru(winkeys)" - Option "XkbOptions" "grp:alt_shift_toggle,grp_led:scroll" - -# For most OSs the protocol can be omitted (it defaults to "Standard"). -# When using XQUEUE (only for SVR3 and SVR4, but not Solaris), -# uncomment the following line. - -# Option "Protocol" "Xqueue" - -# Option "AutoRepeat" "500 30" - -# Specify which keyboard LEDs can be user-controlled (eg, with xset(1)) -# Option "Xleds" "1 2 3" - -# Option "LeftAlt" "Meta" -# Option "RightAlt" "ModeShift" - -# To customise the XKB settings to suit your keyboard, modify the -# lines below (which are the defaults). For example, for a non-U.S. -# keyboard, you will probably want to use: -# Option "XkbModel" "pc102" -# If you have a US Microsoft Natural keyboard, you can use: -# Option "XkbModel" "microsoft" -# -# Then to change the language, change the Layout setting. -# For example, a german layout can be obtained with: -# Option "XkbLayout" "de" -# or: -# Option "XkbLayout" "de" -# Option "XkbVariant" "nodeadkeys" -# -# If you'd like to switch the positions of your capslock and -# control keys, use: -# Option "XkbOptions" "ctrl:swapcaps" - -# These are the default XKB settings for XFree86 -# Option "XkbRules" "xfree86" -# Option "XkbModel" "pc101" -# Option "XkbLayout" "us" -# Option "XkbVariant" "" -# Option "XkbOptions" "" - -# Option "XkbDisable" - -# Option "XkbRules" "xfree86" -# Option "XkbModel" "pc101" -# Option "XkbLayout" "us" - -EndSection - - -# ********************************************************************** -# Core Pointer's InputDevice section -# ********************************************************************** - -Section "InputDevice" - -# Identifier and driver - - Identifier "Mouse1" - Driver "mouse" - Option "ZAxisMapping" "4 5" - Option "Protocol" "IMPS/2" - Option "Device" "/dev/psaux" - -# Mouse-speed setting for PS/2 mouse. - -# Option "Resolution" "256" - -# When using XQUEUE, comment out the above two lines, and uncomment -# the following line. - -# Option "Protocol" "Xqueue" - -# Baudrate and SampleRate are only for some Logitech mice. In -# almost every case these lines should be omitted. - -# Option "BaudRate" "9600" -# Option "SampleRate" "150" - -# Emulate3Buttons is an option for 2-button Microsoft mice -# Emulate3Timeout is the timeout in milliseconds (default is 50ms) - -# Option "Emulate3Buttons" -# Option "Emulate3Timeout" "50" - -# ChordMiddle is an option for some 3-button Logitech mice - -# Option "ChordMiddle" - -EndSection - - -# ********************************************************************** -# Other input device sections -# this is optional and is required only if you -# are using extended input devices. This is for example only. Refer -# to the XF86Config man page for a description of the options. -# ********************************************************************** -# -# Section "InputDevice" -# Identifier "Mouse2" -# Driver "mouse" -# Option "Protocol" "MouseMan" -# Option "Device" "/dev/mouse2" -# EndSection -# -# Section "InputDevice" -# Identifier "spaceball" -# Driver "magellan" -# Option "Device" "/dev/cua0" -# EndSection -# -# Section "InputDevice" -# Identifier "spaceball2" -# Driver "spaceorb" -# Option "Device" "/dev/cua0" -# EndSection -# -# Section "InputDevice" -# Identifier "touchscreen0" -# Driver "microtouch" -# Option "Device" "/dev/ttyS0" -# Option "MinX" "1412" -# Option "MaxX" "15184" -# Option "MinY" "15372" -# Option "MaxY" "1230" -# Option "ScreenNumber" "0" -# Option "ReportingMode" "Scaled" -# Option "ButtonNumber" "1" -# Option "SendCoreEvents" -# EndSection -# -# Section "InputDevice" -# Identifier "touchscreen1" -# Driver "elo2300" -# Option "Device" "/dev/ttyS0" -# Option "MinX" "231" -# Option "MaxX" "3868" -# Option "MinY" "3858" -# Option "MaxY" "272" -# Option "ScreenNumber" "0" -# Option "ReportingMode" "Scaled" -# Option "ButtonThreshold" "17" -# Option "ButtonNumber" "1" -# Option "SendCoreEvents" -# EndSection - -# ********************************************************************** -# Monitor section -# ********************************************************************** - -# Any number of monitor sections may be present - -Section "Monitor" - - Identifier "My Monitor" - -# HorizSync is in kHz unless units are specified. -# HorizSync may be a comma separated list of discrete values, or a -# comma separated list of ranges of values. -# NOTE: THE VALUES HERE ARE EXAMPLES ONLY. REFER TO YOUR MONITOR'S -# USER MANUAL FOR THE CORRECT NUMBERS. - -# HorizSync 31.5, 35.15, 35.5 - - HorizSync 30-64 # multisync -# HorizSync 31.5, 35.2 # multiple fixed sync frequencies -# HorizSync 15-25, 30-50 # multiple ranges of sync frequencies - -# VertRefresh is in Hz unless units are specified. -# VertRefresh may be a comma separated list of discrete values, or a -# comma separated list of ranges of values. -# NOTE: THE VALUES HERE ARE EXAMPLES ONLY. REFER TO YOUR MONITOR'S -# USER MANUAL FOR THE CORRECT NUMBERS. - - VertRefresh 50-70 - -EndSection - - -# ********************************************************************** -# Graphics device section -# ********************************************************************** - -# Any number of graphics device sections may be present - -# Standard VGA Device: - -Section "Device" - Identifier "Standard VGA" - VendorName "Unknown" - BoardName "Unknown" - -# The chipset line is optional in most cases. It can be used to override -# the driver's chipset detection, and should not normally be specified. - -# Chipset "generic" - -# The Driver line must be present. When using run-time loadable driver -# modules, this line instructs the server to load the specified driver -# module. Even when not using loadable driver modules, this line -# indicates which driver should interpret the information in this section. - - Driver "vga" -# The BusID line is used to specify which of possibly multiple devices -# this section is intended for. When this line isn't present, a device -# section can only match up with the primary video device. For PCI -# devices a line like the following could be used. This line should not -# normally be included unless there is more than one video device -# intalled. - -# BusID "PCI:0:10:0" - -# VideoRam 256 - -# Clocks 25.2 28.3 - -EndSection - -# Device configured by xf86config: - -Section "Device" - Identifier "RIVA TNT" - Driver "nvidia" - #VideoRam 131072 - # Insert Clocks lines here if appropriate -EndSection - - -# ********************************************************************** -# Screen sections -# ********************************************************************** - -# Any number of screen sections may be present. Each describes -# the configuration of a single screen. A single specific screen section -# may be specified from the X server command line with the "-screen" -# option. -Section "Screen" - Identifier "Screen 1" - Device "RIVA TNT" - Monitor "My Monitor" - DefaultDepth 24 - - Subsection "Display" - Depth 8 - Modes "1280x1024" "1024x768" "800x600" "640x480" - ViewPort 0 0 - EndSubsection - Subsection "Display" - Depth 16 - Modes "1280x1024" "1024x768" "800x600" "640x480" - ViewPort 0 0 - EndSubsection - Subsection "Display" - Depth 24 - Modes "1024x768" - ViewPort 0 0 - EndSubsection -EndSection - -# ********************************************************************** -# ServerLayout sections. -# ********************************************************************** - -# Any number of ServerLayout sections may be present. Each describes -# the way multiple screens are organised. A specific ServerLayout -# section may be specified from the X server command line with the -# "-layout" option. In the absence of this, the first section is used. -# When now ServerLayout section is present, the first Screen section -# is used alone. - -Section "ServerLayout" - -# The Identifier line must be present - Identifier "Simple Layout" - -# Each Screen line specifies a Screen section name, and optionally -# the relative position of other screens. The four names after -# primary screen name are the screens to the top, bottom, left and right -# of the primary screen. In this example, screen 2 is located to the -# right of screen 1. - - Screen "Screen 1" - -# Each InputDevice line specifies an InputDevice section name and -# optionally some options to specify the way the device is to be -# used. Those options include "CorePointer", "CoreKeyboard" and -# "SendCoreEvents". - - InputDevice "Mouse1" "CorePointer" - InputDevice "Keyboard1" "CoreKeyboard" - -EndSection - -# Section "DRI" -# Mode 0666 -# EndSection - diff --git a/TWiki/WikiReferences.mdwn b/TWiki/WikiReferences.mdwn deleted file mode 100644 index 9214ca3f..00000000 --- a/TWiki/WikiReferences.mdwn +++ /dev/null @@ -1,33 +0,0 @@ -# <a name="References_on_Wiki_and_Collabora"> References on Wiki and Collaboration </a> - -Some useful articles and books around collaboration and the Wiki technology in particular. - -## <a name="Wiki_Technology_and_TWiki"> Wiki Technology and TWiki </a> - -* Book: The Wiki Way, Quick Collaboration on the Web; by Bo Leuf and Ward Cunningham; Addison-Wesley Pub Co; ISBN:020171499X - -* Article: Corporate Collaboration With TWiki; by Peter Thoeny; Web Techniques Magazine; December 2000; <http://www.webtechniques.com/archives/2000/12/thoeny/> - -* Presentation: TWiki Collaboration Tool - A Mature and Full Featured Platform for building Web Based Groupware Applications; by Peter Thoeny; TWiki:Main/TWikiPlatformPresentation - -* Directory: Google.com &t; Computers &t; Software &t; Groupware &t; Wiki; <http://directory.google.com/Top/Computers/Software/Groupware/Wiki/> - -## <a name="Collaboration_and_Knowledge_Mana"> Collaboration and Knowledge Management </a> - -* Article: Internet Groupware for Scientific Collaboration; Jon Udell; Software Carpentry; <http://software-carpentry.codesourcery.com/Groupware/report.html> - -* Directory: Google.com &t; Reference &t; Knowledge Management; [http://directory.google.com/Top/Reference/Knowledge\_Management/](http://directory.google.com/Top/Reference/Knowledge_Management/) - -* Book: The Knowledge Management Toolkit: Practical Techniques for Building a Knowledge Management System; by Amrit Tiwana; Prentice Hall PTR; ISBN:0130128538 - -* Book: The Knowing-Doing Gap: How Smart Companies Turn Knowledge into Action; by Jeffrey Pfeffer and Robert I. Sutton; Harvard Business School Pr; ISBN:1578511240 - -## <a name="Extreme_Programming"> Extreme Programming </a> - -* Book: Extreme Programming Examined; by Giancarlo Succi and Michele Marchesi; Addison-Wesley Pub Co; ISBN:0201710404 - -* Book: Extreme Programming in Practice; by James W. Newkirk and Robert C. Martin; Addison-Wesley Pub Co; ISBN:0201709376 - -* Book: Extreme Programming Explored; by William C. Wake and Bill Wake; Addison-Wesley Pub Co; ISBN:0201733978 - --- [[Main/PeterThoeny]] - 27 Jul 2001 <br /> diff --git a/TWiki/WikiSpam.mdwn b/TWiki/WikiSpam.mdwn deleted file mode 100644 index fb9a639c..00000000 --- a/TWiki/WikiSpam.mdwn +++ /dev/null @@ -1,23 +0,0 @@ -## <a name="About_Spam_on_TWiki"> About Spam on TWiki </a> - -### <a name="TWiki_Guest_account"> TWiki Guest account </a> - -Spam has been repeatedly posted on the Web Home pages by the [[Main/TWikiGuest]] account. Could the password be changed (assuming the posts are made by a Web robot) or the policies associated with that account be changed? -- [[Main/AaronHawley]] - 18 Apr 2006 - -I'm changing the [[TWikiGuest]] password immediately. I'll email you the new one so you can propagate it to the Hurd community, OK? - --- [[Main/JoachimNilsson]] - 18 Apr 2006 - -### <a name="Account_policy_change"> Account policy change </a> - -There has been an awful lot of spam on the Hurd Wiki the past six months. After having dealt with this manually the maintainer wrote a script to revert affected pages and delete bogus users. Still, this took up too much time and the result is that the site is closed for automatic registration. - -This also affects old accounts in that they cannot use the [[ChangePassword]] page anymore, instead all passwords to be set or changed must go via [[ResetPassword]] and be mailed to yours truly. - -I am sorry for any inconvenice this may cause but the situation had simply become unmanageable. - --- [[Main/JoachimNilsson]] - 28 Jan 2005 - -We put much work into this site, but without active participation the bit rot continues and the value decreases. I wish I had more time and desire to help, but frankly the lack of interest of the Hurd community in this site wasn't encouraging me to spend my time on it. - --- [[Main/GrantBow]] - 28 Jan 2005 diff --git a/TWiki/WikiSyntax.mdwn b/TWiki/WikiSyntax.mdwn deleted file mode 100644 index ee87099f..00000000 --- a/TWiki/WikiSyntax.mdwn +++ /dev/null @@ -1,48 +0,0 @@ -# <a name="TWikiShorthand_Basics"> TWikiShorthand Basics </a> - -If you can enter text, you're ready for TWiki. With a few simple, intuitive [[TWikiShorthand]] rules, you'll be able to use plain text to create well-styled postings, instantly. Here's a fast-track guide to shorthand basics... - -* Separate each **paragraph** with a blank line. - -* To display a word or phrase in **bold type**, put it in asterisks: `*bold type*`. - -* To display a word or phrase in _italic_, put it in underscores: `_italic_`. - -* To display a word or phrase in **_bold italic_**, put it in _double_ underscores: `__bold italic__`. - -* To link to another Wiki topic, type the [[WikiWord]] for that topic. To link to a Wiki topic in another web, type the name of the web, and a dot, first: <code>Test.%HOMETOPIC%</code>. - -* If you enter a [[WikiWord]] for a topic that doesn't exist, it'll appear highlighted, with question mark at the end, prompting you (or someone else) to start off the new topic by clicking the **?** - [[NewTopic]] (click the **?**, but don't save, to preserve the example!). - -* When entering WikiName signatures - like, %USERNAME% - include the %MAINWEB% as a prefix, since all TWiki member pages are in the %MAINWEB% web: `Main.YourName`. - -* For an external link, type the full URL: `http://twiki.org`. - -* To prevent a WikiWord from becoming a link, type `<nop>` first, <code>**<nop>NoLinkPlease**</code>. - -* To indent with a bullet, enter `[space][space][space][asterisk][space]`. - * Use multiples of 3 spaces to start **nested bullets**. - * That's 3-6-9-... - -1. Start items in a **numbered list** with `[space][space][space][1][space]`. -2. The "1" (or **any number**) will be replaced by the correct number, in order. - -* Start **counting spaces** for bullets from the beginning of a new line. - -* To include an image, type its URL. You also can Attach an image to the page and display it with text <br />=%ATTACHURL%/yourimagefilename.jpg=. - -* To display a word or phrase in `MONOSPACED TYPE`, put it in equal signs: <code>=like this=</code>. <br />Use <code>==two==</code> for bold: <code>**bold mono**</code>. - -* Use <code>**<pre>**</code> to enclose code excerpts, filenames, and other unformatted text, with the opening and closing tags on their own separate lines: - -> <pre> -> <b>&lt;pre&gt;</b> -> unformatted text! -> <b>&lt;/pre&gt;</b> -> </pre> - -* Three (or more) consecutive **hyphens** expand into a horizontal rule: `---` - ----- - -* See [[TWikiShorthand]] for the complete set of formatting rules. diff --git a/TWiki/WikiToolNameChange.mdwn b/TWiki/WikiToolNameChange.mdwn deleted file mode 100644 index 1aca18ac..00000000 --- a/TWiki/WikiToolNameChange.mdwn +++ /dev/null @@ -1,28 +0,0 @@ -I got an idea. I just changed the WIKITOOLNAME on the global [[TWiki/TWikiPreferences]] page. Hmmm. I hope this doesn't screw up anything! I think it looks great on the upper left of every page. - --- [[Main/GrantBow]] - 05 Jan 2003 - -It looks great! There are still a lot of things that I need to learn about regarding TWiki, but it's real fun so from here on I'll consider it an educating "ride". - -There where some other minor side effects caused by your change, for insance, take a look at: - -* [[Main/WebHome]] -* [[TWiki/TWikiRegistration]] - -put the <code>**?raw=on**</code> after the URL in the location bar in your browser to see what I mean. Like this: - - http://hurd.gnufans.org/bin/view/Main/WebHome?raw=on - -I don't mind at all, it just looks funny. Search for %WIKITOOLNAME% to find more examples. - --- [[Main/JoachimNilsson]] - 07 Jan 2003 - -It would be useful (for the TWiki community) to document the unintended effects as we find them. - -I just copied these entries from [[TWiki/TWikiDiscuss]]. Hmmm, in thinking about upgrading to the next release, the process to move from a TWiki Alpha release to a TWiki Beta release is to take a CVS checkout and then add (after processing by a special script I think) the Main and TWiki webs from the twiki.org site. If that's the case our customizations we do in these two "webs" might get blown away. Well, this isn't a problem right now but it may become an issue if we want to upgrade our installation. Just a relatively advanced TWiki admin thought to keep in mind. - -I'm glad nothing broke horribly when making the change! - -I know when Peter sees this he might not like it very much, but I think the toolname should be customized per site. It's negative for the TWiki marketing intent, but very positive for personalized site usage, pride of ownership and buy-in to see a familiar name there. Honestly, I kind of get sick seeing the TWiki name plastered all over the code and the configurations. This feels so much nicer now. It's hard to convey the feeling accurately. - --- [[Main/GrantBow]] - 09 Jan 2003 diff --git a/TWiki/WikiTopic.mdwn b/TWiki/WikiTopic.mdwn deleted file mode 100644 index 5b6a97c7..00000000 --- a/TWiki/WikiTopic.mdwn +++ /dev/null @@ -1 +0,0 @@ -A [[WikiTopic]] is one unit of information in the %WIKITOOLNAME% web. It is one web page in your browser. The name of the WikiTopic should be a [[WikiWord]]. diff --git a/TWiki/WikiWikiClones.mdwn b/TWiki/WikiWikiClones.mdwn deleted file mode 100644 index f7cd1697..00000000 --- a/TWiki/WikiWikiClones.mdwn +++ /dev/null @@ -1,5 +0,0 @@ -%WIKITOOLNAME% is a Wiki Wiki clone and has its root in JOS Wiki. - -* TWiki's home is at <http://TWiki.org/> -* TWiki takes a lot of ideas from [Ward Cunningham](http://c2.com/~ward/)'s remarkable [ Wiki Wiki Web](http://c2.com/cgi/wiki?WikiWikiWeb) invention. -* A list of Wiki Wiki clones can be found at <http://c2.com/cgi/wiki?WikiWikiClones> diff --git a/TWiki/WikiWord.mdwn b/TWiki/WikiWord.mdwn deleted file mode 100644 index 5dcf9bff..00000000 --- a/TWiki/WikiWord.mdwn +++ /dev/null @@ -1,43 +0,0 @@ -A WikiWord consists of two or more words with initial capitals, run together. - -When you type a WikiWord, you establish a hyperlink. It's as easy as that. - -WikiWords are styled like this because: - -* It makes Wiki hyperlinks instantly recognizable -* It leads to interesting Wiki topics -* It avoids the need to fiddle with HTML tags -* It avoids over-general topics because at least two words are required - -**Syntax of a WikiWord** - -* Uppercase letter(s) -* Lowercase letter(s) -* Uppercase letter(s) -* Optional lowercase or uppercase letter(s) or number(s) - -**Good examples for WikiWords:** - -* [[WikiWord]] -* [[GoodStyle]] -* [[AVeryLongWikiTopicNameIsAlsoPossible]] -* [[YearTwoThousand]] - -**Bad examples for WikiWords:** - -* Web: Name with no uppercase letter in between -* T5Wiki: Name with number before the first lowercase letter -* Know-How: Name with dashes in between - -**Hints** - -* Insert WikiWords wherever you can. Rich linking helps to make a Wiki successful. -* To stop a WikiWord from being turned into a hyperlink, insert the text `<nop>` immediately before the WikiWord. -* A topic is usually presented in the singular. Plural WikiWords are automatically linked to the singular topic, i.e. the link [[WikiWords]] links to the topic [[WikiWord]]. -* Sometimes you have to be creative to find a good WikiName. Examples: - * To create a topic about the the **Bread Slicer 1.2** product, use `BreadSlicer1dot2` or `BreadSlicer1pt2`, but not `BreadSlicer1.2`. - * To create a topic about **year 2000**, you could go for `YearTwoK` or `YearTwoThousand`, but not `Year2K` or `Y2K` or `Y2000`. -* Turn acronyms into WikiWords, i.e. take `FaqIndex` for a "FAQ index" topic. -* You can create nicer looking links by using double square brackets, i.e. write <code>[[TWiki access control]]</code> to get a link to [[TWikiAccessControl]] that looks like [[TWikiAccessControl]]. - -**_Related Topics:_** [[WikiSyntax]], [[TextFormattingRules]] diff --git a/TWiki/discussion.mdwn b/TWiki/discussion.mdwn deleted file mode 100644 index 0e1be4e6..00000000 --- a/TWiki/discussion.mdwn +++ /dev/null @@ -1,106 +0,0 @@ -# <a name="Meta_Discussion_Topic_for_the_TW"> Meta Discussion Topic for the TWiki Web </a> - -Old discussions: [[WIKIHOMEURLTWikiWebDiscussrev12]] | [[WIKIHOMEURLTWikiWebDiscussrev16]] - -This topic is used for meta discussions regarding the TWiki web. We discuss content, usability features, and other related things. Comment below in blog style. - ----- - -I don't know if [[Main/DerekDavies]] will read this or not, however I know you will, Joachim. Derek changed the [[WebMenu]] for the TWiki web and also (my way of some kind of include) changed the navigation on the front page. <http://hurd.gnufans.org> - -I guess I get sensitive over navigation issues. If a site is to act as one site then there needs to be consistency in the navigation. I also am a firm believer that TWiki in general and newbies in particular overwhelms people new to our site with too much information all at once. This is a public site. I'm trying to keep in mind that we want to be effective in getting across a message to an audience that for the most part are not TWiki fans even if they are somewhat GNU fans by way of their even knowing about and being interestd in the Hurd efforts. - -There's also the balance between encouraging users to participate in the content and keeping a unified site that makes sense to all. To me that indicates some degree of direction/management. - -So before I fly off the handle and change back the [[TWiki/WebMenu]] as well as putting security restrictions on all [[WebMenu]] topics I wanted to get some feedback as a sanity check. - --- [[Main/GrantBow]] - 06 Jan 2003 - -Don't worry Grant, you're still sane. :) - -I completely agree to put certain topics, e.g., [[TWiki/WebMenu]] and [[Main/HurdGnuFansOrg]], under stricter editorial control. - --- [[Main/JoachimNilsson]] - 07 Jan 2003 - -Dilemma: I kinda like the [[WebMenu]] changes if they were isolated to the TWiki web. Hmmm. However I don't like them on the main page. Can you change the Python script to not make those two identical? - -And the right way of making that change would not be a new [[WebMenu]] but a change to a variable, right? Oh, the TWiki one IS the global one, yeah. We should lock a couple topics in any case, but only using GROUPS, not user names. Yes, you and I have over-ride in reality but using group names more clearly conveys who to talk to by if users want to talk to someone. Using the right group names also gives future flexibility if the list of names change. It's The Right Thing To Do (tm). :-) - --- [[Main/GrantBow]] - 09 Jan 2003 - -Hmmm, sure I can fix the Python script. How would you like to have the front page? - -1. [[HurdGnuFansOrg]] plus the menu look of the Main web -2. [[HurdGnuFansOrg]] plus the menu look of some other web - -(**_On a side note:_** I still think we should have [[WebIndex]], [[WebChanges]] and [[WebNotify]] in the menu of all the webs, the DEFAULTITEMS. Named Index, [[ChangeLog]] and Notify Me ...) <br /> - -<div align="right">"Carthago delenda est!" <br />-- Cato</div> - -We always use group names, naturally. :) - --- [[Main/JoachimNilsson]] - 13 Jan 2003 - -We're getting down to usage style, I think. For me I NEVER access the [[WebNotify]] now that it's set. It would be clutter, promoting a one time use that probably most people may not want because they are not as interested in the site as we are. Just a Guess. - -I NEVER use [[WebIndex]], I always search. There's already a search in the upper right of your page. - -[[WebChanges]] is useful, but again if it's on a link from the [[WebHome]] topic anyway... Do you access [[WebChanges]] more than a couple times during a session to a web? Do you think others do as well? - --- [[Main/GrantBow]] - 14 Jan 2003 - -You're probably right, we're talking about usage patterns. Here are my reasons, tainted they may be of my own style: - -* An index page is useful to a person like me, or a beginner, trying to get an overview what types of pages a web contains. I also use it to look fur unmaintained stuff, cruft, that might contain erroneous information - but that's for maintenance, so it doesn't really count. I find the index mostly useful because my brain shuts down quite frequently and finding the correct search words sometimes fail. Scanning through a list helps me such times. And, some topics aren't listed on the webhomes or adjacent pages. - -* [[WebChanges]] I use when I don't want to login to my mail to see what you've been doing lately. It's also very useful tool for infrequent visitors wanting to find out where people work at the moment. Many other wiki implementations have it available at all times. - -* Notify I agree with you that both you and me no longer use. However, beginners or infrequent users, might use it more often to register during periods when they feel thay could spare more time for a wiki - say, during holidays and similar. - -I guess this is wht you call a Mexican Standoff, right? :-) - -I propose we let the matter "sit" for a while - I need to think about your input, and ponder the "usage patterns" idea/concept you've now given me ... - --- [[Main/JoachimNilsson]] - 14 Jan 2003 - -I think you are right. We need to think about this some more and allow some time. Right now I think I have a health problem that prevents me from sleeping as much as I need to and "Doing" too much at times. - -I wouldn't call this a standoff, not yet. ;-) - -Interesting and complex issues come into scope. Perhaps we should talk about [[GnuFansUsers]] and [[GnuFansUsagePatterns]]? Whatever we do we get into discussion of issues that are more than technology, so talking through our assumptions becomes more important. Real information design is a "wicked problem" as defined by some folks like [Conklin](http://www.cognexus.org/id22.htm) and others. - --- [[Main/GrantBow]] - 14 Jan 2003 - -Can one get type in something to get the [[WebTopicList]] pages back as they used to be --- viz: list the topics with no whitespace in them? - -[Basically, fsbot's updating of hurdwiki topics has stopped working because of a lack of index page as it used to be. Plus, making it work is not a simple matter of writing a script to hand-remove the whitespace because, now the script cannot tell the difference between "real wrb topics" and "other junk" like "Search: ...[]" on the index page. Moreover, that script is used to maintain 2 other wikis (which are usemod style etc.) and tweaking it for this particular wiki will break it for others :( . Until now, things were "compatible" amongst the wikis :)] - --- [[Main/DeepakGoel]] - 16 Jan 2003 - -Oups! :-( - -Introducing new features always leads to new bugs. Grant and I have had a discussion at [[TWikiDiscuss]] regarding introducing the [[SpacedWikiWordPlugin]]. I added it to the Hurd Wiki yesterday and now we have problems. - -Grant, are you there? Can you think of an immediate solution/workaround which could help Deego and still let us keep the [[SpacedWikiWordPlugin]]? - --- [[Main/JoachimNilsson]] - 16 Jan 2003 - -Hm, never mind, i have modified my script to work with it :) Thanks for the quick response, Joachim, and sorry to bother you all :) - --- [[Main/DeepakGoel]] - 16 Jan 2003 - -Joachim, when I get a chance I'm going to refactor some of the discussion here, moving it to something like [[WebMenuDiscuss]]. - -Deego, thanks very much for modifying your script. You were quick to reply as well! - -In the meantime, I have an issue within the scope of this web and perhaps others. I've just discoved w3m and _IT ROCKS_! Why, because I am editing this with `vim` right now! It works out of the box unlike a method I tried a few days ago as described on TWiki:Codev/ somewhere. (link forthcoming) And adoption will soar when people don't have to use Xfree under Debain GNU/Hurd to get to the Hurd wiki! I'm ecstatic right now. - -The one problem is that the Hurd logo in ascii isn't showing up right. I've not looked into it too closely yet but I plan to also discuss w3m on twiki.org in the next while. Any suggestions? - --- [[Main/GrantBow]] - 17 Jan 2003 - -W3M is what I always use when I don't have X, it is really good! - -The ASCII logo problem I'm aware of. Currently I've only seen Mozilla and Lynx display it properly (Mozilla when there is something wrong with the WEBLOGO). Almost a year ago when I first developed the [[GnuSkin]] I was also patching w3m to use Lynx's alt tag parser. I worked on it very sporadically and I don't remember if I ever got it working. I could perhaps look into it again, if noone beets me to it. - --- [[Main/JoachimNilsson]] - 17 Jan 2003 |
