----------------------------------------------------------------------- LEXI V 1.2.2 (2004-02-23) 2002-2004 by Volker Tanger ----------------------------------------------------------------------- LEXI is a multiuser, auto-linking online lexicon - similar to WikiWiki's, but without their need for special WikiWords or [[Word Markup]]. New words or sentences are automatically linked everywhere they appear. ----------------------------------------------------------------------- Requirements: ----------------------------------------------------------------------- To run this installation of LEXI you'll need: - a webserver (usually apache) that can run Perl CGI-BINs anywhere (not just CGI-BIN directory) - Perl 5.something or newer - a filesystem that supports symbolic links (all Unix filesystems do) - or you'll have to copy the corresponding files manually and duplicate the changes each time. Yes, the symlinks have a zero length but should show content when accessed with an editor, etc. If not, your filesystem does not support the needed symlinks. - a filesystem that supports "umlaut" filenames (probably ISO-8859-x due to Perl modules) - this is known problem under Mac OS-X (being worked at) - standard Unix shell and textutils (cat, fgrep, ls, sort, uniq) ----------------------------------------------------------------------- Installation: ----------------------------------------------------------------------- By default the /lexi/ directory is installed in the web server root. Adapt CONFIG.PL according to your setup. All *.PL files shall have executable flags set. The /DATA/ and /DATA/OLD/ directories must be writable by the webserver user, usually "www-data" or "nobody". If your WWW server is running as "root", you have a security problem - check your webserver configuration. Speaking of - CGI-BINs must be executable anywhere, not just in the CGI-BIN directory. Under Apache you should check your /etc/apache/httpd.conf for proper settings like AddHandler cgi-script .pl Options +ExecCGI Protect the ADMIN directory with proper athentication (for Apache webserver see manual pages about the .htaccess file) so only admins can access the files there. It might be a good idea to protect the DATA directory against any direct web server access (dito). With apache you'll probably need to set the "AllowOverride AuthConfig" option within /etc/apache/httpd.conf ----------------------------------------------------------------------- Templates ----------------------------------------------------------------------- Adapt the *.SHTML templates to fit your website design. lexi.shtml admin/edit.shtml admin/lexi.shtml There are only 4 placeholders used §§§TITEL§§§ the title of the webpage §§§ME§§§ the LEXI entry §§§IMG§§§ the image INCLUDING the proper HTML tags §§§BODY§§§ the page text with proper HTML tags ----------------------------------------------------------------------- Usage: ----------------------------------------------------------------------- ----------------------------------------------------------------------- Programming / Contributing ----------------------------------------------------------------------- Please check the website for updates prior to submitting patches! ----------------------------------------------------------------------- KNOWN ISSUES: ----------------------------------------------------------------------- - VIKI description only in German language - problematic "umlaut" filesystem-base (problems under Mac OS-X) - symlinks MUST be supported by filesystem (issue for Mac and Microsoft) Updates will be available at http://www.wyae.de/software/lexi/ Please check there for updates prior to submitting patches! For bug reports and suggestions or if you just want to talk to me please contact me at volker.tanger@wyae.de ----------------------------------------------------------------------- Shortcut: Distributable under GPL ----------------------------------------------------------------------- Copyright (C) 2000-2002 Volker Tanger 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. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. or on their website http://www.gnu.org/copyleft/gpl.html -----------------------------------------------------------------------