    # McCullough Knowledge Explorer version 6.2
    # Aug/26/2003

# MKE Installation Instructions

## Open Source Agreement

      Open source license:
      GNU GPL

      Legal considerations:
      McCullough Knowledge Explorer (MKE)
      is supplied AS IS, with no warranties
      of any kind.  By using MKE, you take
      total responsibility for any damages
      which may result from its use.

      Report any problems to me:
      Richard H. McCullough
      mailto:rhm@cdepot.net

## Downloads

    http://rhm.cdepot.net/download/kewin.zip		    MKE for Windows
    http://rhm.cdepot.net/download/kelin.zip		    MKE for Linux

    http://unicon.sourceforge.net/dist/setup-unicon.exe         Unicon for Windows
    http://unicon.sourceforge.net/dist/unicon-10.0-1.i386.rpm   Unicon for Linux
    http://unicon.sourceforge.net/dist/uni.zip                  Unicon source code

    http://www.volcano.net/~rhm/download/rebol031.tgz	    Rebol/Core for Windows
    http://www.volcano.net/~rhm/download/rebol042.tgz	    Rebol/Core for Linux
    http://www.volcano.net/~rhm/download/unicon-src.tar.gz	    Parlett XML parser

    http://tap.stanford.edu/tap/download.html		    TAP Java client
    http://sourceforge.net/project/showfiles.php?group_id=27274 OpenCyc Java client
    http://java.sun.com/downloads/index.html		    Sun Java2 SDK

## Directory Structure

    ke (KEHOME)
    	bin		executables
    	data (KBDATA)	TAP RDF files (KBFILE)
    	db   (KEDB)	database files
    	    dmoz	ODP
    	    kt		ODP Kids and Teens
    	    netscape	ODP Netscape
    	    tap		Stanford TAP KB
    	doc		documentation
    	fs (KEFS)	filesystems
    	help		help files
    	homepage	MKE home page files
    	java		MKE/TAP interface: GetData,GetResource,PutData
    	kb		initial knit files
    	kenews		MKE News archive
    	krnews		MKR email group (KR-language@YahooGroups.com)
    	src		MKE source code
    	xml		namespace files
    	view (KEVIEW)	views

    	knowledge
    	    applications
    	        ExpenseRecord
    	        Genealogy
    	        IndexingBooks
    	        Internet
    	        SemanticWeb
    		    DAML
    		    Dublin Core
    		    FOAF
    		    Google
    		    Microsoft
    		    N3
    		    Netscape
    		    OpenDirectoryProject
    		    OpenCyc
    		    OWL
    		    Protege
    		    RDF
    		    RSS
    		    TAP
    	    examples
    	        BookHierarchy
    	        Classification
    	        Definition
    	        English
    	        Ethics
    	        General
    	        Logic
    	    theory
    	        ContextSymposium
    	        CycL
    	        Epistemology
    	        FormalConceptAnalysis
    	        KRdesign
    		NaturalSemanticMetalanguage
    		OWL
    		RDFMT
    	        RebolEquivalent
    	        Sowa
    	        WordNet
    	    tools
    	        cygwin
    	        gnu
    	        java
    	        jena
    		pxp
    	        rebol
    	        unicon

## Executables (KEHOME/bin)

    	ke		Knowledge Explorer
    	ksc		Knowledge Syntax Checker
    	GetData		query Stanford TAP knowledge base
    	GetResource	query Stanford TAP knowledge base
    	PutData		assert in local TAP knowledge base
    	Ask		query OpenCyc knowledge base
    	Tell		assert in local OpenCyc knowledge base

    	icont		Unicon translator
    	iconx		Unicon executor
    	iversion	identify Unicon version & features

    	unicon		execute Unicon O-O package translator
    	jcont		execute Jcon translator (Icon input, Java output)
    	java		execute Sun java command
    	javac		compile java program
    	rebol		execute rebol internet messaging command
    	pxp		Parlett XML parser

## Initial knit files (KEHOME/kb)

    	tabrasa.html	tabula rasa hierarchy
    	tabrasa.def	tabula rasa definitions
    	ke.html		Knowledge Explorer hierarchy
    	ke.def		Knowledge Explorer definitions
    	initial.mkr	initialization script
    	final.mkr	termination script

## Windows Installation

    # KEHOME is installation directory, e.g. C:/home/ke
    0. Install Unicon for Windows
    	if you want to customize MKE
       Install Sun Java2 SDK for Windows
    	if you want to use TAP GetData,PutData commands
       Install Rebol/Core for Windows
    	if you want to use Rebol internet messaging commands
       Install Cygwin
    	if you want to use Linux commands
    1. Install ke files
        for kewin.exe:
    	double-click kewin.exe
    	select KEHOME
    	unzip ke files
        for kewin.zip:  (or use WinZip)
    	mkdir KEHOME
    	copy kewin.zip KEHOME
    	cd KEHOME
    	unzip kewin.zip
        for kewin.tgz:  (or use WinZip)
    	mkdir KEHOME
    	mv kelin.tgz KEHOME
    	cd KEHOME/..
    	gzip -d <KEHOME/kelin.tgz | tar -xf -
    2. Edit autoexec.bat and create MKE shortcut if desired
    	edit KEHOME/doc/autoexec.bat
    		to match your installation
    	insert commands from KEHOME/doc/autoexec.bat
    		into C:/autoexec.bat
    	create ke shortcut by right-clicking on ke.exe
    	copy ke shortcut to any desired location, e.g.,
    		Desktop and/or Start Menu
    	restart Windows
    3. Execute ke using either
    	ke.exe
    	ke shortcut

    x. Uninstall procedure
    	delete KEHOME directory
    	remove edits from C:/autoexec.bat
    	delete any copies of ke shortcut

## Linux Installation

    # KEHOME is installation directory, e.g. /home/ke
    0. Install Unicon for Linux
    	if you want to customize MKE
       Install Sun Java2 SDK for Linux
    	if you want to use TAP GetData,PutData commands
       Install Rebol/Core for Linux
    	if you want to use Rebol internet messaging commands
    1. Install ke files
        for kelin.zip:
    	mkdir KEHOME
    	mv kelin.zip KEHOME
    	cd KEHOME
    	unzip kelin.zip
        for kelin.tgz:
    	mkdir KEHOME
    	mv kelin.tgz KEHOME
    	cd KEHOME/..
    	gzip -d <KEHOME/kelin.tgz | tar -xf -
    2. Edit .profile
    	edit  KEHOME/doc/linux.profile
    		to match your installation
    	insert commands from KEHOME/doc/linux.profile
    		into your HOME/.profile
    	login
    3. Execute ke
    	ke

    x. Uninstall procedure
    	rm -rf KEHOME
    	remove edits from HOME/.profile

MKE home