MIPM Base: Basis-Paket  -  Version 1.08

Inhalt:
~~~~~~~
1. Lieferumfang
2. Installation
3. Konfiguration
4. Hinweise zur Arbeit mit Klassifikationssystemen
5. Kontakt


1. Lieferumfang:
~~~~~~~~~~~~~~~~
Das Paket MTool-Base-1.08.tar.gz enthaelt folgende Dateien:

Name                        Version
----------------------      -------
README                       1.08
CUSTOMISE
MTool/Base.pm                1.08
MTool/Id.pm                  0.6
MTool/Pagetypes.pm
MIPMGlobalData/
  mipm.css
  mi-logo.jpg
  mi-logo_136x123.jpg
  rdf_metadata_button.40.gif
  valid-xhtml10.png
  vcss.png
  yellow.png
  yelwhiteleftbottom.png
  yelwhitelefttop.png
  yelwhiterightbottom.png
  yelwhiterighttop.png
SchemeDB/
  CCS_EN
  GAMS_EN
  MSC_EN
  PACS_EN
  ZDM_EN
SchemeDB/bin/
  CCS2RDF.pl
  GAMS2RDF.pl
  MSC2RDF.pl
  PACS2RDF.pl
  ZDM2RDF.pl
  RDF2CSV.pl
Examples/
  Pagetypes.pm.mathind
  Pagetypes.pm.ngee


2. Installation:
~~~~~~~~~~~~~~~~
MTool-Base bei Erstinstallation eines M-Tools:

MTool-Base stellt grundlegende Funktionen fuer alle M-Tools
(= MIPMs = Math&Industry Presentation Maker) zur Verfuegung.
Bei der Installation des ersten M-Tools sind 
einige Schritte zu erledigen, die bei der Installation weiterer M-Tools
nicht wiederholt werden brauchen:

   Erstellen Sie das Verzeichnis MTool in einem Verzeichnis, das
   sich im Perl Suchpfad befindet. Kopieren sie die Bibliothek
   Base.pm (und ggf. Id.pm) in dieses Verzeichnis.

   Bei der Installation eines M-Tool muessen Sie den Parameter 'mm_help_url'
   angeben. Kopieren Sie in dieses Verzeichnis das Verzeichnis
   'MIPMGlobalData' aus diesem Paket mit all seinen enthaltenen Dateien.

   Es werden die Perl-Module CGI (mind. Version 2.69), und ggf.
   DBI und DBD::CSV benoetigt (zu beziehen bei http://www.cpan.org/).


3. Konfiguration
~~~~~~~~~~~~~~~~

Base.pm:
--------
Wenn Sie ein M-Tool verwenden, dass mit Klassifikationssystemen arbeitet, 
kopieren die das Verzeichnis 'SchemeDB' mit seinen enthaltenen Dateien 
(das Unterverzeichnis 'bin' ist nicht noetig) in eine Verzeichnis, auf dass
der Webserver lesend zugreifen kann. In Base.pm passen Sie bitte die 
Variable $SCHEME_DB (in Zeile 16) und ggf. die Konstante APPLICATION_TITLE
(in Zeile 19) entsprechend an.

Id.pm
-----
Wenn Sie Id.pm benoetigen (z.B. bei Nutzung der Expertendatenbank zusammen
mit MIPMPers) passen Sie in Zeile 18 die Variable $password_file an.

Pagetypes.pm
------------
In diesem Modul sind Seitentypen aufgelistet die einem RDF-Schema entsprechen
(wie z.B. Math&Industry http://www.iwi-iuk.org/material/RDF/Schema/Descriptor/midesc.html).
Ueblicherweise muss fuer jedes Einsatzgebiet ein eigenes Schema entwickelt werden.
In Pagetypes.pm befindet sich ein Beispiel. Weitere Beispiele sind im Verzeichnis
Examples/ zu finden.
Sie koennen jedoch ganz auf eine Seitentypisierung verzichten.
Die einzelnen MTools vergleichen den Wert des Parametern 'mm_pagetype' mit den
hier aufgefuehrten Werten. Listen Sie hier bitte nur die Typnamen auf (ohne URL).
Die aufgelisteten Seitentypen sind also nur ein Beispiel.

4. Hinweise zur Arbeit mit Klassifikationssystemen
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Die im Verzeichnis 'SchemeDB/' enthaltenen Dateien sind CSV-Dateien, die 
von MTool::Base direkt als Datenbaktabellen verwendet werden.
Im Verzeichnis 'SchemeDB/bin/' sind die Perl-Skripte enthalten, mit denen 
diese Dateien enzeugt wurden. In MSC2RDF.pl ist eine ausfuehrliche Hilfe im
POD-Format enthalten. Mit 'pod2text MSC2RDF.pl' oder 'pod2html MSC2RDF.pl'
erhalten Sie die Dokumentation, die entsprechend auch fuer die anderen 
xxx2RDF.pl-Skript gilt.
Mit den xxx2RDF.pl-Skripten wird die Website der jeweiligen Schemata
kontaktiert und eine RDF-Beschreibung erzeugt. Aus dieser RDF-Datei
kann dann mittels RDF2CSV.pl eine entsprechende CSV-Datei erzeugt werden.
Sie koennen diese Dateien auch fuer einen Datenimport in eine richtige 
Datenbank verwenden. Dann muessen Sie in Base.pm in der Funktion
get_label() den Verbindungsbefehl DBI->connect() entsprechend anpassen.
Hilfe dazu erhalten sie in der Dokumentation zur DBI (z.B. 'perldoc DBI').

5. Kontakt:
~~~~~~~~~~~
Wenn Sie Fragen oder Anregungen haben, oder Ihnen Fehler aufgefallen sind,
so treten Sie bitte mit toolmaster[at]mathematik-21.de in Verbindung, oder
besuchen Sie die Website vom http://www.mathematik-21.de/ .