forked from github/kensanata.oddmuse
67650e3dc8
All the source files containing non-ASCII characters needed to have utf8 added. This will be necessary for user config files as well! The regular expressions identifying page names had to be changed. UrlEncode translates the string back to bytes before encoding it. Cached RSS files are saved with UTF-8 encoding and therefore need their meta-data changed (using the XML::RSS module to do this correctly didn't work for some of the test files). The CGI object's parameters, keywords and info_path are decoded correctly. File access uses the UTF-8 layer (reading, writing, appending, access to the log of recent changes, running sub processes with grep and diff). The mac compatibility extension will also disable the use of grep if non-ASCII characters are searched for because of an unexplained problem with grep.
This is the README file distributed as part of the simple-install package together with the Oddmuse script. Unzip all the files into a directory served by Apache. Get the current.pl file from here: http://emacswiki.org/scripts/current.pl Your directory should now contain the following files: * README (this file) * .htaccess (information for Apache) * config (a simple config file for you to modify) * wiki.pl (a wrapper script setting the data directory) * current.pl (the main script) * modules (a directory containing modules) * modules/creole.pl (support for the standard wiki markup) The wiki pages will be saved in this directory. Make sure the www user (or whoever Apache runs under) has write access to this directory. In that directory, try chmod o+w . and see if that helps when you get an error message saying that Oddmuse cannot create the temp directory. You need to make sure that your administrator has allowed AllowOverride All in his httpd.conf file for the settings in the .htaccess file provided to have an effect. Running Oddmuse will create more files, eventually. * pages (the directory containing the pages) * keep (the directory containing older versions of pages) * pageidx (a file containing the names of existing pages) * rc.log (the file used to produce RecentChanges) * visitors.log (the file used to log the most recent visitors) * temp (a temporary directory for log files and the like) In order to start your wiki, click on the edit link (the first link below the navigation bar, at the bottom of the page). This will allow you to enter some text for this page. Click the Save button and you are done. To add new pages, edit the homepage and add links to new pages. Links are traditionally formed by ConcatenatingCapitalizedWords. This kind of link pattern is called a wiki word. Alternatively, put links in [[double square brackets]]. This kind of link pattern is called a free link. As long as the new pages don't exist, links to these pages are followed by a clickable question mark. Click on the question mark to create the new page. Enjoy your wiki experience. Visit http://www.oddmuse.org/ to learn more about the translation files and modules that are part of this package. ---------------------------------------------------------------------- Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation. This program is free 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. Both the GNU Free Documentation License, and the GNU General Public License are distributed together with this script. See the files FDL and GPL, respectively.