none
[openafs-wiki.git] / TWiki / TWikiSystemRequirements.mdwn
1 <div>
2   <ul>
3     <li><a href="#TWiki System Requirements"> TWiki System Requirements</a><ul>
4         <li><a href="#Server Requirements"> Server Requirements</a></li>
5         <li><a href="#Client Requirements"> Client Requirements</a></li>
6         <li><a href="#Known Issues"> Known Issues</a></li>
7       </ul>
8     </li>
9   </ul>
10 </div>
11
12 # <a name="TWiki System Requirements"></a> TWiki System Requirements
13
14 _Server and client requirements for TWiki 01-Dec-2001_
15
16 Low client and server requirements are core features that keep TWiki widely deployable, particularly across a range of browser platforms and versions.
17
18 ## <a name="Server Requirements"></a> Server Requirements
19
20 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.
21
22 <table border="1" cellpadding="0" cellspacing="0">
23   <tr>
24     <th bgcolor="#99CCCC" colspan="3"><strong> Required Server Environment </strong></th>
25   </tr>
26   <tr>
27     <th bgcolor="#99CCCC"><strong> Resource </strong></th>
28     <th bgcolor="#99CCCC"><strong> Unix </strong></th>
29     <th bgcolor="#99CCCC"><strong> Windows* </strong></th>
30   </tr>
31   <tr>
32     <td> Perl </td>
33     <td align="center" colspan="2"> 5.005_03 or higher </td>
34   </tr>
35   <tr>
36     <td> Non-standard Perl modules </td>
37     <td align="center"><code>Net::SMTP</code> (or <code>sendmail</code>) </td>
38     <td align="center"><code>Net::SMTP</code>, <code>MIME::Base64</code>, <code>Digest::SHA1</code></td>
39   </tr>
40   <tr>
41     <td> RCS </td>
42     <td align="center" colspan="2"> 5.7 or higher </td>
43   </tr>
44   <tr>
45     <td> Other external programs </td>
46     <td align="center" colspan="2"><code>ls, fgrep, egrep</code></td>
47   </tr>
48   <tr>
49     <td> Web server </td>
50     <td align="right" colspan="2"> Apache; others (with CGI support, authentication, extended path) </td>
51   </tr>
52 </table>
53
54 %X% **\*** _Current documentation covers Linux/Apache only. See TWiki:Codev/TWikiOnWindows for work-to-date on a Windows installation guide._
55
56 <a name="ClientRequirements"></a>
57
58 ## <a name="Client Requirements"></a> Client Requirements
59
60 The TWiki [[standard installation|Main/TWikiInstallationGuide]] has extremely low browser requirements:
61
62 - HTML 3.2 compliant
63 - generates XHTML 1.0 pages that are compatible with HTML 3.2
64 - minimal use of JavaScript in the user interface (degrades gracefully)
65 - no cookies
66 - no CSS
67
68 You can easily add functionality, by customizing [[TWikiTemplates]], for one, while tailoring the browser requirements to your situation.
69
70 ## <a name="Known Issues"></a> Known Issues
71
72 - The new [[TWikiPlugins]] feature currently does not have compatibility guidelines for developers. Plugins can require just about anything - browser-specific functions, stylesheets (CSS), Java applets, cookies, specific Perl modules,... - check the individual Plugin specs.
73   - %H% Plugins included in the TWiki distribution do not add requirements.
74
75 -- [[MikeMannix]] - 12 Jan 2002