Setup › Diff

Showing differences between revision 25 and 24.
+ == Requirements
+ Bikini requires [[http://python.org/|Python]] 2.5+ and Apache 2.x web server.
+
+ == Setup
+ # Copy all the files (including the hidden {{{.htaccess}}} file) in the root of your web site or in a sub-folder (e.g. "notes"). The folder //must// be script-writable;
+ # make sure the file {{{index.cgi}}} is executable. If not, issue a {{{chmod 755 index.cgi}}}.
+ # point your browser to the correct URI (e.g. {{{http://yourserver.tld/notes/}}}).
+
+ If everything has been set up correctly you should see a welcome //FrontPage// page.
+
+ === Troubleshooting
+ If you are experiencing issues on running CGI scripts with Apache please refer to //[[http://httpd.apache.org/docs/2.2/howto/cgi.html|Configuring Apache to permit CGI]]//.
+
+ == Configure
+ See [[Configuration]] for more details.
+
+ == Protect your wiki
+ You can use Apache file-based authentication to protect Bikini pages to be edited from anonymous users.
+
+ The following example uses HTTP Basic Authentication to write-protect site pages. Put these directives in the Bikini {{{.htaccess}}} file:
+ {{{
+ AuthType Basic
+ AuthName "To save changes please log in first."
+ AuthUserFile /path/to/.htpasswd
+ <Limit POST PUT DELETE>
+ Require valid-user
+ </Limit>
+ }}}
+
+ You will need to create that {{{.htpasswd}}} file, please refer to [[http://httpd.apache.org/docs/2.0/howto/auth.html|Apache authentication tutorial]] for further information.
+
+ The article [[http://perishablepress.com/htaccess-password-protection-tricks/|HTAccess Password-Protection Tricks]] contains a lot of tips on how to troubleshoot issues while dealing with password protected sites/folders.
+