Installation

Last modification : 2012/07/01 03:00

WiKiss installation

Requirements

The only requirement for WiKiss (in addition to a web server) is PHP5.

For proper management of UTF-8 coding, it is recommended that the module mbstring be built with php.

Download

You can download: Then uncompress the file to a temporary directory.

Configuration

Just edit _config.php and change the values at your convenience. See Configuration for more details.

Remember to change the default password which is test

Installation

Copy all the files on your web server for instance with a ftp client. Depending on the configuration of your provider, the access rights may not be correct. To correct this do a chmod 775 on all files and directories.

Et voila !

Now you can use your WiKiss.

Migration from WiKiss

0.2.1 → 0.3

  1. Save your pages, your historic and your _config.php
  2. Copy the file index.php to your wiki
  3. If you have changed your template, a new tag may be required: RSS, even decorations can be added around certain tags
  4. Else just copy files style.css and template.html
  5. Finally copy the new directory named plugins and its content
  6. No change from your previous _config.php is needed
Note: anchors format on titles has changed. So you might need to modify ones done by hand (tables of contents are not concerned)

Generic Procedure

Before anything else, save your pages, your historic and your _config.php.

If you update from an earlier version of WiKiss you have two options:

Simply copy all files in the old installation. But attention you will lose pages Home, Help, your configuration (_config.php) as well as any customizations to your template. You can then retrieve them via your historic and your backup.

This method is not recommended.

To update with a better granularity, follow these steps:
  1. Save your pages, your historic and your _config.php
  2. Copy the file index.php to your wiki
  3. If you do not have customized your template, also copy style.css and template.html
  4. If necessary (see Changelog) add new parameters needed in _config.php

Migration from TigerWiki

Several inconsistencies are present between TigerWiki 2.2x and WiKiss 0.2:
  • The content is now full UTF-8
  • The names of the pages are now UTF-8
  • Titles syntax has changed (! Is now h1 instead of h3)
An automatic conversion tool is here to help you. Here is the procedure:
  1. Save your pages and historic : copy to a secure place the directories pages/ and historique/
  2. Save your configuration file: _config.php
  3. Install WiKiss by following the above procedure
  4. Include your pages, your history in your new facility
  5. Include your variables from your configuration file (PASSWORD, LANG, LOCAL_HOUR, PAGES_DIR, BACKUP_DIR)
  6. Display the conversion tool by going to http://example.com/your/wikiss/path/tigerwiki2wikiss.php. For a list of all your pages as well as their current encoding displays
  7. Click Do It!
  8. You can also crush your old file Aide.txt with one provided by WiKiss, it contains details of the new syntax
  9. You can now delete the file tigerwiki2wikiss.php