1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/doc/MM/CLEANUP Fri Jan 11 19:08:40 2008 +0100
1.3 @@ -0,0 +1,14 @@
1.4 +rm *.lof
1.5 +rm *.toc
1.6 +rm *.out
1.7 +rm *.aux
1.8 +rm *.bbl
1.9 +rm *.blg
1.10 +rm *.dvi
1.11 +rm *.log
1.12 +rm *.backup
1.13 +rm *.pdf
1.14 +rm *.ps
1.15 +rm *~
1.16 +rm bib
1.17 +rm fig
1.18 \ No newline at end of file
2.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
2.2 +++ b/doc/MM/ISAC_AuthoringTools.tex Fri Jan 11 19:08:40 2008 +0100
2.3 @@ -0,0 +1,235 @@
2.4 +\chapter{Einleitung}
2.5 +\label{chap:Einleitung}
2.6 +Der Mathematikunterricht in Schulen wird grunds\"atzlich anhand von Lehrb\"uchern durchgef\"uhrt. Die darin vorkommenden Beispiele werden je nach Schulstufe ohne technische Hilfsmittel oder mit Hilfe eines Taschenrechners gel\"ost. Um den Sch\"ulern einen besseren Einblick in L\"osungsverfahren verschiedener Beispiele zu bieten, soll das ISAC Tutoring System im Schulbetrieb eingesetzt werden. Dem Sch\"uler wird nun erm\"oglicht, Rechenbeispiele automatisiert zu l\"osen und die dabei durchgef\"uhrten Schritte einzeln zu betrachen.
2.7 +
2.8 +Das ISAC Tutoring System beinhaltet nur eine kleine Sammlung von Beispielen zur Veranschaulichung. Um den Einsatz im Unterricht effizient und auch sinnvoll zu gestalten ist es nun notwendig den Sch\"ulern Beispiele aus ihrem im Mathematikunterricht verwendeten B\"uchern mit ISAC zu pr\"asentieren. A priori ist es aber nicht m\"oglich, alle Beispiele aus diversen Schulb\"uchern im System zu integrieren. Daher muss, bevor das System in einer Schulklasse eingesetzt wird, der jeweilige Content generiert werden. Dazu wird das ISAC Authoring System verwendet. Content besteht entweder nur aus der aktuellen Seite des Mathematikbuches die gerade bearbeitet wird, oder auch aus mehreren Kapiteln.
2.9 +
2.10 +Diese Arbeit sollte m\"oglichst einfach, rasch und effizient durchf\"uhrbar sein. Es ist nicht Sinn der Sache, dass die Contentgenerierung \"uberproportional viel an Zeit beansprucht. Daher entspringt auch die Notwendigkeit, Werkzeuge bereitzustellen, die diese Arbeit vereinfachen und automatisieren. Im n\"achsten Kapitel wird der Aufbau einer typischen Content Seite beschrieben und auch kurz auf die verschiedenen Variationsm\"oglichkeiten eingegangen. Es stellt keinenfalls den Anspruch auf Vollst\"andigkeit, denn nicht alle Mathematikb\"ucher folgen diesem Schema, und Ausnahmen sind durchaus m\"oglich. Diese m\"ussen dann aber gesondert behandelt werden und sind nicht Teil dieses Dokuments. Danach wird der Prototyp des im Rahmen dieser Arbeit entwickelte Tools vorgestellt, welcher die Erstellung von Content erheblich vereinfacht und automatisiert. Dies soll erste Aufschl\"usse dar\"uber geben, welche Requirements f\"ur ein Content Generierungs Tool erforderlich sind. Abschliessend werden die Ergebnisse zusammengefasst, offene Fragen behandelt und kurz erl\"autert, welche Faktoren bei der Entwicklung eines Vollst\"andigen Tools zu ber\"ucksichtigen sind.
2.11 +
2.12 +\chapter{Content}
2.13 +\label{chap:content}
2.14 +
2.15 +Wenn von Content gesprochen wird, bezieht es sich in diesem Dokument auf die Inhalte (Beispiele) eines Mathematikbuches, welche im ISAC Tutoring System zur Verf\"ugung gestellt werden sollen. Grunds\"atzlich werden die Inhalte Seitenweise im System abgebildet. In diesem Kapitel wird zuerst der Aufbau einer Content Seite beschrieben, und danach die davon erzeugte Abbildung im ISAC Tutoring System vorgestellt.
2.16 +
2.17 +\section{Aufbau}
2.18 +\label{sec:Aufbau_Content}
2.19 +Eine typische Seite eines Mathematikbuches, welche im ISAC Tutoring System bereitgestellt werden soll, ist in Abbildung \ref{fig:exp_page} zu sehen.
2.20 +
2.21 +\begin{figure}[htbp]
2.22 + \centering
2.23 + \includegraphics[width=0.6\textwidth]{myfig/MM-exp_Etc_LebMat-34-N142-b.png}
2.24 + \caption{Beispiel Seite aus einem Mathematikbuch}
2.25 + \label{fig:exp_page}
2.26 +\end{figure}
2.27 +
2.28 +Eine Seite kann unterteilt werden in Kopfzeile und Hauptteil. Die Kopfzeile enth\"alt die Seitennummer, den Kapiteltitel und den Seitentitel. Der Hauptteil besteht aus Erl\"auterungen und durchgerechneten Beispielen, aus Bildern und den eigentlichen Beispielen. Diese sind fortlaufend mit Nummern durchnummeriert und jedes Beispiel besitzt Unterbeispiele, welche durch Kleinbuchstaben gekennzeichnet sind. Wie schon eingangs erw\"ahnt, k\"onnen diverse B\"ucher von diesem Aufbau abweichen. Dieser Arbeit liegt jedoch dieses spezielle Schema des Buches ``Lebendige Mathematik'' zu Grunde und Spezialf\"alle werden nicht behandelt und sind Thema m\"oglicher weiterf\"uhrender Arbeiten (Kapitel \ref{chap:Ausblick}).
2.29 +
2.30 +\section{Abbildung im ISAC Tutoring System}
2.31 +\label{sec:Abbildung_Content}
2.32 +
2.33 +Das Ziel ist es nun, die vorliegenden Inhalte des Buches im ISAC Tutoring System abzubilden. F\"ur die Sch\"uler soll ein Wiedererkennungswert gegeben sein, deswegen werden nicht nur zu rechnende Beispiele, sondern auch Erl\"auterungen, Grafiken und bereits durchgerechnete Beispiele abgebildet.
2.34 +
2.35 +Nach starten der Anwendung gelangt man mit dem \texttt{Examples} Button in den \texttt{Example browser}, welcher in Abbildung \ref{fig:exp_browser} zu sehen ist. Der \texttt{Example browser} soll in der Lage sein, mehrere Beispielsammlungen parallel anzuzeigen. Deswegen sind alle Beispiele in eine (vom Benutzer konfigurierbare) hierarchische Men\"ustruktur eingegliedert, die in der linken Spalte zu sehen ist. So kann der Hauptmen\"upunkt den Namen des abzubildenden Mathematikbuches tragen und darunter jede Seite einen Men\"upunkt bekommen, welche dann alle Beispiele beinhaltet. Das in diesem Dokument behandelte Buch ``Lebendige Mathematik'' ist unter \texttt{Etc>Lebendige Mathematik} zu finden.
2.36 +
2.37 +\begin{figure}[htbp]
2.38 + \centering
2.39 + \includegraphics[width=0.6\textwidth]{myfig/MM-exp_browser.png}
2.40 + \caption{Example Browser im ISAC System}
2.41 + \label{fig:exp_browser}
2.42 +\end{figure}
2.43 +
2.44 +
2.45 +\chapter{Content Generator}
2.46 +\label{chap:Content_Generator}
2.47 +Um die Erstellung von Content zu erleichtern, wurde ein Prototyp eines Content Generators erstellt. Dieser vereinfacht die Abbildung von Lehrbuchinhalten in das ISAC Tutoring System. Wie schon eingangs erw\"ahnt, ist dieser Prototyp sehr an die Struktur des Mathematikbuches ``Lebendige Mathematik'' angelehnt.
2.48 +
2.49 +Wenn nun Inhalte abgebildet werden sollen, ist eine Reihe von Schritten notwendig:
2.50 +\begin{enumerate}
2.51 + \item Ausw\"ahlen der gew\"unschten Seiten im Mathematikbuch
2.52 + \item Ausw\"ahlen und Einscannen der Grafiken und Erl\"auterungen die im ISAC Tutoring System angezeigt werden soll
2.53 + \item Ausw\"ahlen der Rechenbeispiele, die im ISAC Tutoring System durchrechenbar sein sollen
2.54 + \item Erstellen einer XML Konfigurationsdatei f\"ur jede Seite, mit welchem der Content Generator die Inhalte in ISAC erzeugt
2.55 + \item Konfiguration und starten des Content Generators
2.56 + \item Anpassung der Hierarchie
2.57 + \item Kopieren von Dateien
2.58 + \item Starten der HTML Generierung
2.59 +\end{enumerate}
2.60 +
2.61 +\section{Seitenauswahl}
2.62 +Zu Beginn muss eine Auswahl der abzubildenden Seiten getroffen werden. Es gibt keine weiteren Vorgaben f\"ur diesen Schritt. Die n\"achsten Schritte werden am Beispiel einer einzelnen Seite erl\"autert. Erst Schritt 7 (\ref{sec:Content_Konfiguration}) bezieht sich wieder auf die Gesamtheit aller ausgew\"ahlten Seiten.
2.63 +
2.64 +\section{Einscannen}
2.65 +Sch\"uler sollen im ISAC Tutoring System die Seite aus ihrem Mathematikbuch wiedererkennen. Aus diesem Grund werden Grafiken, Erl\"auterungen und durchgerechnete Beispiele eingescannt und in Kombination mit den Rechenbeispielen angezeigt. Die Entscheidung, welche Elemente eingescannt und dann im \texttt{Example browser} angezeigt werden sollen, liegt ganz beim Ersteller des Contents. In Abbildung \ref{fig:scan_page} ist eine Beispielseite zu sehen, von welcher die rot markierten Bereiche eingescannt wurden.
2.66 +
2.67 +\begin{figure}[htbp]
2.68 + \centering
2.69 + \includegraphics[width=0.6\textwidth]{myfig/MM-exp_Etc_LebMat-34-N142-b.png}
2.70 + \caption{Ausgew\"ahlte Bereiche die eingescannt werden}
2.71 + \label{fig:scan_page}
2.72 +\end{figure}
2.73 +
2.74 +Folgende Scan-Einstellungen haben sich bew\"ahrt:
2.75 +\begin{description}
2.76 + \item[Format] JPG
2.77 + \item[DPI] 100
2.78 + \item[Qualit\"at] Foto
2.79 + \end{description}
2.80 +
2.81 +Alle Scans m\"ussen in dem \texttt{\$EXP\_DATA\_IMG\_DIR\$} Verzeichnis gespeichert werden.
2.82 +
2.83 +\section{Ausw\"ahlen der Rechenbeispiele}
2.84 +Nun m\"ussen alle Rechenbeispiele von dieser Seite, die im ISAC Tutoring System zur Verf\"ugung stehen sollen, ausgew\"ahlt werden. Diese m\"ussen dann im n\"achsten Schritt in die XML Konfigurationsdatei eingetragen werden.
2.85 +
2.86 +\section{XML Konfigurationsdatei}
2.87 +F\"ur jede Seite muss nun eine XML Konfigurationsdatei erstellt werden, welche der Content Generator verwendet, um den Content des ISAC Tutoring Systems zu erstellen. Diese Datei beinhaltet die Kopfzeile der Seite, die Seitenummer, die Platzierung der eingescannten Elemente, die Rechenbeispiele und die verwendeten Theorien zur L\"osung der Beispiele. Weiters kann noch spezifiert werden, ob es eine Probe zu einem Rechenbeispiel gibt. In Listing \ref{lst:Content_XMLconfig} ist das Schema der XML Datei zu sehen.
2.88 +
2.89 +\lstset{language=XML}
2.90 +\begin{lstlisting}[caption=Beispiel einer XML Konfigurationsdatei, label=lst:Content_XMLconfig]
2.91 +<Seite>
2.92 + <Kapiteltitel></Kapiteltitel>
2.93 + <Seitentitel></Seitentitel>
2.94 + <SeitenNr></SeitenNr>
2.95 + <Beispiel>
2.96 + <ImagePath></ImagePath>
2.97 + <ImageName></ImageName>
2.98 + <ImageWidth></ImageWidth>
2.99 + <ImageHeight></ImageHeight>
2.100 + <locateBeforeExp>true</locateBeforeExp>
2.101 + <Nr>142</Nr>
2.102 + <Spalten>4</Spalten>
2.103 + <Term>a + (4*a - 3)</Term>
2.104 + <HasProbe>true</HasProbe>
2.105 + <Probe>
2.106 + <ProbeTerm>5*a - 3</ProbeTerm>
2.107 + <SubsValues>a=2</SubsValues>
2.108 + </Probe>
2.109 + <Theory>poly</Theory>
2.110 + <Problem></Problem>
2.111 + <Method></Method>
2.112 + </Beispiel>
2.113 +</Seite>
2.114 +
2.115 +\end{lstlisting}
2.116 +
2.117 +\begin{description}
2.118 + \item[Titel] Kapitel- und Seitentitel sind optional, die Seitennummer muss jedoch angegeben werden. Danach folgen die Beispiele f\"ur die ganze Seite.
2.119 + \item[Beispiele] Ein Beispiel umfasst ein oder mehrere Unterbeispiele, wie in Abbildung \ref{fig:exp_beispiel} zu sehen ist. Wie schon vorher erw\"ahnt, m\"ussen die eingescannten Grafiken dargestellt werden.
2.120 + \item[Gescannte Elemente] Dem Content Generator muss nun mitgeteilt werden, an welcher Position der Seite die eingescannte Grafik plaziert werden soll. Dies wurde so gel\"ost, indem eine eingescanntes Grafik immer einem Beispiel zugeordnet wird. Nun kann man definieren, ob es vor oder nach dem Beispiel plaziert werden soll, vergleiche dazu Abbildung \ref{fig:exp_scanLocation}. Wird \texttt{locateBeforeExp} auf \texttt{true} gesetzt, wird die Grafik vor dem Beispiel angezeigt, bei \texttt{false} danach. Die eingescannte Grafik wird mit einem Pfad \texttt{ImagePath}, dem Dateinamen \texttt{ImageName} und optionaler Breite \texttt{ImageWidth} und H\"ohe \texttt{ImageHeight} definiert. Soll einem Beispiel kein Grafik zugeordnet werden, bleiben diese Elemente leer.
2.121 + \item[Beispielnummer] Das Beispiel selbst muss eine Nummer \texttt{Nr} erhalten.
2.122 + \item[Spalten] Jedes Beispiel umfasst ein oder mehrere Unterbeispiele, welche in einer bestimmten Anzahl von Spalten angezeigt werden. Mit dem Element \texttt{Spalten} kann definiert werden, wieviele Unterbeispiele pro Zeile angeordnet werden sollen. Dies wird in Abbildung \ref{fig:exp_spalten} verdeutlicht.
2.123 + \item[Unterbeispiele] Ein Unterbeispiel wird mit dem Element \texttt{Term} definiert. Dort gibt man das eigentlich Rechenbeispiel an. Die Unterbeispiele werden dann im ISAC Tutoring System automatisch mit fortlaufenden Kleinbuchstaben bezeichnet.
2.124 + \item[Proben] Manchmal sollen bei Rechenbeispielen auch Proben durchgef\"uhrt werden. Im derzeitigen System k\"onnen Proben nur f\"ur eine gesammte Beispielnummer (also alle Unterbeispiele gemeinsam) definiert werden und die Substitutionswerte sind f\"ur alle die Gleichen. Entweder werden allen oder gar keinen Unterbeispielen Proben zugeordnet. Dies geschieht mit dem Element \texttt{hasProbe}, welches im Fall von vorliegenden Proben den Wert \texttt{true} bekommt, ansonsten leer bleibt oder auf \texttt{false} gesetzt wird. Liegen Proben vor, m\"ussen f\"ur alle Elemente \texttt{Term} in der gleichen Reihenfolge Elemente \texttt{ProbeTerm} erstellt werden. Diese enthalten das Ergebnis des jeweiligen durchgerechneten Unterbeispieles, da in der Probe die Angabe mit dem Ergebnis eines Beispiels gleichgesetzt und die Unbekannten mit Zahlenwerten ersetzt werden. Diese Zahlenwerte, mit denen die Probe durchgef\"uhrt werden sollen, werden durch Beistriche getrennt im Element \texttt{SubsValues} angegeben.
2.125 + \item[Theorie] Damit das ISAC Tutoring System ein Beispiel durchrechnen kann, muss es eine spezielle Theorie verwenden. Derzeit sind nur zwei Theorien implementiert. Solange ein Beispiel keinen Bruchstrich enth\"alt, wird \texttt{Theorie} auf \texttt{poly} gesetzt, ansonsten auf \texttt{rational}.
2.126 + \item[Probleme und Methoden] Die Attribute \texttt{Problem} und \texttt{Method} sind derzeit nicht in Verwendung. Jedoch muss jedes Beispiel eine Problem- und Methodendefintion haben. Derzeit ist diese im Sourcecode des Prototyps integriert und muss daher vor der Contentgenerierung eventuell f\"ur jede Seite manuell angepasst werden.
2.127 +\end{description}
2.128 +
2.129 +Nachdem f\"ur jede Seite eine XML Konfigurationsdatei erstellt wurde, kann man zum n\"achsten Schritt \"ubergehen.
2.130 +
2.131 +\section{Content Generator konfigurieren und starten}
2.132 +\label{sec:Content_Konfiguration}
2.133 +
2.134 +Nun ist es notwendig, dem Content Generator mitzuteilen, welche Konfigurationsdateien f\"ur die Content Generierung verwendet werden sollen. Dazu werden f\"ur jede XML Konfigurationsdatei folgende Zeilen in die \texttt{main} Methode von \texttt{GeneratorMain.java} eingef\"ugt, wobei \texttt{$<$Dateiname$>$} mit dem eigentlichen Namen der XML Konfigurationsdatei ersetzt wird.
2.135 +
2.136 +\begin{verbatim}
2.137 +XMLParser parser = new XMLParser();
2.138 +Page page = parser.parsePage("<Dateiname>");
2.139 +page.generatePageFile();
2.140 +page.generateExampleFiles();
2.141 +page.clearAll();
2.142 +\end{verbatim}
2.143 +
2.144 +Danach wird \texttt{GeneratorMain.java} mit 2 Argumenten ausgef\"uhrt. Das erste Argument gibt an, welche Dateinamen f\"ur die generierten Dateien verwendet werden soll. Es ist ratsam einen sprechenden Namen zu w\"ahlen, bew\"ahrt hat sich den Namen entsprechend der Anordnung in der Men\"ustruktur zu w\"ahlen. Zum Beispiel wurde f\"ur das Buch ``Lebendige Mathematik'' \textit{exp\_Etc\_LebMatC-S} verwendet, wobei ``exp'' f\"ur Examples steht, ``Etc'' dass es in der Hierachie unter Etc angesiedelt ist, und ``LebMatC'' bezeichnet den Namen des Buches und dass es sich bei diesen Dateien um die Computerversion handelt (mehr dazu in K\"urze). ``S'' steht f\"ur Seite, und danach werden vom Content Generator die Seiten- und Beispielnummern automatisch angef\"ugt. Die generierte Datei f\"ur das Beispiel 257a auf Seite 53 w\"urde dann folgenden Namen erhalten: \textit{exp\_Etc\_LebMatC-S53-N257a.xml}.
2.145 +
2.146 +// TODO
2.147 +//soll auch erkl\"art werden, welche Files erzeugt werden und wie deren Struktur aussieht???
2.148 +//
2.149 +
2.150 +Das zweite Argument definiert, ob die Lehrversion oder Computerversion erstellt werden soll. \texttt{true} erzeugt hierbei die Lehrversion, und \texttt{false} die Computerversion. Der Unterschied zwischen Lehr- und Computerversion ist die Methoden- und Problemwahl bei der Erstellung des Contents f\"ur das ISAC Tutoring System. Die Methoden und Probleme sind im Prototyp noch im Sourcecode enthalten und m\"ussen manuell f\"ur die Contentgenerierung angepasst werden.
2.151 +
2.152 +\section{Hierarchie anpassen und Dateien kopieren}
2.153 +Nachdem nun der Content Generator die Metadaten aus den XML Konfigurationsdateien \"ubersetzt hat, m\"ussen diese noch in das ISAC Tutoring System eingebunden werden. Dazu m\"ussen zuerst die neuen Seiten in die Hierarchie des ISAC Systems eingebunden werden. Die Hierarchy des \texttt{Example browser} ist in Abbildung \ref{fig:exp_hierarchy} zu sehen. Diese wird aus der XML Datei \texttt{exp\_hierarchy.xml} erzeugt. Um nun die neuen Seiten in dieser Hierarchie sichtbar zu machen, muss diese Datei ge\"andert werden. Die Hierarchie ist relativ einfach aufgebaut, und alle Men\"upunkte sind dem Hauptpunkt \textit{Examples} untergeordnet. Wie in der Abbildung zu sehen ist, kann jeder Men\"upunkt weitere Untermen\"upunkte enthalten. So sind die Seiten mit den Beispielen des Buches ``Lebendige Mathematik'' in der Hierarchie folgendermassen angeordnet: \textit{Examples-$>$Etc-$>$Leb. Mathematik-$>$Computerversion}. Eine Seite enth\"alt nun nur mehr die einzelnen Beispiele, welche keine Untermen\"upunkte mehr besitzen.
2.154 +
2.155 +\begin{figure}[htbp]
2.156 + \centering
2.157 + \includegraphics[width=0.9\textwidth]{myfig/MM-exp_hierarchy.png}
2.158 + \caption{Hierarchie im Example Browser}
2.159 + \label{fig:exp_hierarchy}
2.160 +\end{figure}
2.161 +
2.162 +Die Anordnung der Seiten in der Hierarchie wird im XML File \texttt{exp\_hierarchy.xml} definiert. Der Content Generator erstellt automatisch ein XML File \texttt{exp\_hierarchy\_allPages.xml}, welche die Hierarchy der neuen Seiten im XML Format abbildet. Die Struktur der Hierarchie folgt der oben genannten, d.h. jede Seite repr\"asentiert einen Men\"upunkt und jedes Beispiel einen dazugeh\"orenden Untermen\"upunkt. Von der Entscheidung, wo in der Hierarchy die neuen Seiten aufscheinen sollen, ist es abh\"angig an welcher Stelle diese XML Daten in die Datei \texttt{exp\_hierarchy.xml} eingef\"ugt werden m\"ussen.
2.163 +
2.164 +Ein Men\"upunkt sieht immer folgendermassen aus:
2.165 +\begin{verbatim}
2.166 +<NODE>
2.167 + <ID> </ID>
2.168 + <CONTENTREF> </CONTENTREF>
2.169 +</NODE>
2.170 +\end{verbatim}
2.171 +
2.172 +\texttt{ID} beinhaltet den Namen, der in der Hierarchy aufscheint, und \texttt{CONTENTREF} den Namen der XML Datei, deren Inhalt im Browser angezeigt wird. Dies ist eine rekursive Struktur, d.h. jeder Men\"upunkt kann wieder Untermen\"upunkte mit der gleichen Struktur beinhalten. F\"ur die neu erstellten Seiten muss ein neuer Men\"upunkt an der gew\"unschten Stelle, wo sie in der Hierarchie aufscheinen sollen, erstellt werden. Danach m\"ussen die Daten von \texttt{exp\_hierarchy\_allPages.xml} vor \texttt{$<$/NODE$>$} hineinkopiert werden. Wie dies am Beispiel des Buches ``Lebendige Mathematik'' aussieht ist im folgenden Listing zu erkennen. Wenn man die XML Struktur mit der Hierarchiestruktur des \texttt{Example browser} in Abbildung \ref{fig:exp_hierarchy} vergleicht, ist leicht der Zusammenhang zu erkennen.
2.173 +
2.174 +\lstset{language=XML}
2.175 +\begin{lstlisting}[]
2.176 +<NODE>
2.177 + <ID> Etc </ID>
2.178 + <CONTENTREF> exp_Etc</CONTENTREF>
2.179 + <NODE>
2.180 + <ID> Algebra Einfuehrung </ID>
2.181 + <CONTENTREF> exp_Etc_AlgEin </CONTENTREF>
2.182 + </NODE>
2.183 + <NODE>
2.184 + <ID> Leb. Mathematik </ID>
2.185 + <CONTENTREF> exp_Etc_LebMat </CONTENTREF>
2.186 +
2.187 + <NODE>
2.188 + <ID> Lehrversion </ID>
2.189 + <CONTENTREF> exp_Etc_LebMatL </CONTENTREF>
2.190 + ...
2.191 + </NODE>
2.192 + <NODE>
2.193 + <ID> Computerversion </ID>
2.194 + <CONTENTREF> exp_Etc_LebMatC </CONTENTREF>
2.195 +
2.196 + // ==== hier beginnen die Daten aus exp_hierarchy_AllPages.xml
2.197 + <NODE>
2.198 + <ID>Seite 33</ID>
2.199 + <CONTENTREF> exp_Etc_LebMatC-S33 </CONTENTREF>
2.200 + ...
2.201 + </NODE>
2.202 + // ==== hier enden die Daten aus exp_hierarchy_AllPages.xml
2.203 + </NODE>
2.204 + </NODE>
2.205 +</NODE>
2.206 +\end{lstlisting}
2.207 +
2.208 +Hier wurde ein neuer Men\"upunkt \textit{Leb. Mathematik} erzeugt. Dieser beinhaltet einen weiteren Untermen\"upunkt \textit{Lehrversion} und \textit{Computerversion}. In letzteren wurde die XML Hierarchie Spezifikation aus \texttt{exp\_hierarchy\_allPages.xml} hineinkopiert.
2.209 +
2.210 +\section{Kopieren von Dateien}
2.211 +Vor dem letzten Schritt m\"ussen noch alle XML Dateien , die der Content Generator erzeugt hat und die eingescannten Grafiken in das Datenverzeichnis (\texttt{\$EXP\_DATA\_DIR\$}) des ISAC Systems kopiert werden.
2.212 +
2.213 +\section{Starten der HTML Generierung}
2.214 +Abschliessend wird das Tool \texttt{GenHTML} ausgef\"uhrt, welche die neuen Seiten schliesslich ins ISAC Tutoring System integriert. Nach Neustart des ISAC Tutoring Systems sind alle neuen Beispiele im \texttt{Example browser} sichtbar und k\"onnen durchgerechnet werden.
2.215 +
2.216 +
2.217 +\chapter{Zusammenfassung und Ausblick}
2.218 +\label{chap:Ausblick}
2.219 +Ziel dieser Arbeit war es, einen Prototyp f\"ur die Content Generierung f\"ur das ISAC Tutoring zu erstellen. Aus diesem sollten wichtige Erfahrungen f\"ur die Entwicklung eines vollst\"andigen Tools zur Content Generierung gewonnen werden. Dies ist erfolgreich gelungen und in diesem Kapitel wird eine kurze Zusammenfassung und danach ein Ausblick f\"ur die Entwicklung eines universeller einsetzbaren Tools gegeben.
2.220 +
2.221 +xxxxxxxxxx \cite{AG:thesis} xxxxxxxxxx
2.222 +
2.223 +
2.224 +Der Prototyp ist sehr stark an das Buch ``Lebendige Mathematik'' angelehnt. Es wurde keine Requirements Analyse durchgef\"uhrt, sondern er ist schrittweise mit den aufgetauchten Anforderungen gewachsen. Daher ist er nur sinnvoll f\"ur die Content Generierung von Seiten aus diesem Buch einsetzbar, und auch hierbei gibt es Einschr\"ankungen. Es hat sich gezeigt, dass das Einscannen von Grafiken einen sehr hohen Wiedererkennungswert erzielt und den Content im ISAC Tutoring System anschaulicher macht. Die Beschreibung der Seiten im XML Format, welche vom Content Generator als Input verwendet werden, hat sich ebenfalls sehr bew\"ahrt. Jedoch muss dieses Format weitaus flexibler gestaltet werden, um Variationen von Mathematikb\"uchern und Beispielen ansich abzudecken. Dies erfordert eine sehr genaue und weitblickende Analyse- und Definitionsphase. Die Grenzen des Prototyps wurden aufgezeigt, als es notwendig wurde unterschiedliche Probleme und Methoden f\"ur einzelne Beispiele zu definieren. Weiters ist es nur sehr rudiment\"ar m\"oglich, Proben f\"ur Beispiele einzubinden.
2.225 +
2.226 +Bei der Entwicklung eines universellen Tools m\"ussen einige Punkte ber\"ucksichtigt werden, und nun folgt eine Auflistung von Erkenntnissen und offenen Fragen, die w\"ahrend der Entwicklung des Prototyps gewonnen wurden bzw. aufgetaucht sind:
2.227 +
2.228 +\begin{description}
2.229 + \item[Grafiken] Die Platzierung der Grafiken zu definieren, indem sie an ein konkretes Beispiel gebunden werden, hat sich als sehr robust bew\"ahrt. Jedoch muss evaluiert werden, ob dieser Ansatz variabel genug ist um alle vorkommenden F\"alle abzudecken. Derzeit ist es nur m\"oglich, Grafiken ober- oder unterhalb von Beispielen zu plazieren, jedoch nicht in gleicher H\"ohe in einer angrenzenden Spalte.
2.230 +\item[Spalten] Der erste Ansatz, eine vordefinierte Spaltenanzahl pro Seite zu haben, war bald zu restriktiv. Es ist notwendig, pro Beispiel definieren zu k\"onnen, in wie vielen Spalten die Unterbeispiele angeordnet sein sollen.
2.231 +\item[XML Definition] Das XML Format zur Beschreibung einer Seite ist sicher der richtige Ansatz und sollte weiter verfolgt werden. Jedoch ist es notwendig, zuerst eine ausf\"uhrliche Analyse der abzubildenden Seiten durchzuf\"uhren. Es gibt eine Vielzahl von Mathematikb\"uchern und jedes hat bestimmte Eigenheiten die ber\"ucksichtig werden sollten. Deswegen ist es wichtig, ein m\"oglichst allgemeines Bild zu bekommen und Spezialf\"alle und Ausnahmen zu erkennen. In diesem Prototyp wurde vorausgesetzt, dass alle Beispiele eine bestimmte Anzahl von Unterbeispielen besitzen, welche mit fortlaufenden Kleinbuchstaben bezeichnet werden. Weiters ist noch zu \"uberlegen, ob die generierten XML Files einfach aus Strings oder aus XML Objekten generiert werden. Derzeit wird einfach ein String erstellt, und dieser in ein File geschrieben (einfachste L\"osung). Ein im Code erstelltes XML Objekt hat den Vorteil, dass man es auf Korrektheit \"uberpr\"ufen (durch vergleichen mit einem Schema) und durch genormte Manipulationsschritte ver\"andern kann.
2.232 +\item[Proben] Es kann sicher vorkommen, dass nicht alle Unterbeispiele eine Probe besitzen, und diese auch nicht alle mit den gleichen Substitutionswerten durchgef\"uhrt werden. Es muss eine flexible Definition von Proben f\"ur einzelne Beispiele gefunden werden.
2.233 +\item[Probleme und Methoden] Wie sich im Laufe der Entwicklung des Protoyps gezeigt hat, ist die Problem- und Methodendefintion nicht einheitlich und unterscheidet sich eventuell von Beispiel zu Beispiel. Derzeit ist diese Definition im Sourcecode integriert, was eine sehr undynamische L\"osung darstellt. Dies hat den Grund, dass es sich hierbei nur um einen in kurzer Zeit entwickelten Prototyp handelt. Es ist auf jeden Fall erforderlich, dass jedes Beispiel eine eigene Problem- und Methodendefinition besitzt. Da aber einige Beispiele die gleichen Definition haben werden, kann diese repetitive Arbeit verhindert werden, indem eine Menge von Problem- und Methodendefinitionen in einer Lookup-Tabelle oder einem speziellen XML File definiert werden. Jedes Beispiel m\"usste dann nur mehr auf die gew\"unschte Problem- und Methodendefinition in der Lookup-Tabelle referenzieren. Dies vereinfacht \"Anderungen und vermeidet sehr oft wiederholte Definitionen in den XML Konfigurationsdateien.
2.234 +\item[Computer- vs. Lehrversion] Zur Zeit gibt es die Unterscheidung zwischen der Computer- und Lehrversion. Sie unterscheiden sich dadurch, dass verschiedene Probleme- und Methoden verwendet werden, und dass der Angabetext bei der Lehrversion nicht Englisch, sonder Deutsch ist (z.B. \textit{Vereinfache} anstatt \textit{Simplify}). Diese Unterschiede sind derzeit auch nur im Sourcecode eingebettet, m\"ussen jedoch entweder in globalen Variablen, Konstanten oder \"uberhaupt extern definiert werden. Die Frage, ob es in Zukunft noch mehrere verschiedenen Versionen geben wird, ist auch zu stellen.
2.235 +\item[Hierarchie] Wie oben erw\"ahnt, muss jede neu erstellte Seite in die XML Hierarchie Datei eingebunden werden, um in der Men\"ustruktur des \texttt{Example browsers} aufzuscheinen. Dieser Schritt ist derzeit noch sehr umst\"andlich, werden doch die XML-Hierarchiedaten f\"ur die neu erstellten Seiten statisch im Code erzeugt und m\"ussen dann manuell an die richtige Stelle der XML-Hierarchie Datei kopiert werden. Ziel soll es sein, dass man nur definieren muss wie und wo die neuen Seiten in die Hierarchie eingebunden werden sollen und das Tool die XML-Hierarchie Datei automatisch anpasst, und somit dieser manuelle Schritt wegf\"allt.
2.236 + \end{description}
2.237 +
2.238 +\end{document}
3.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
3.2 +++ b/doc/MM/MM_semproj.tex Fri Jan 11 19:08:40 2008 +0100
3.3 @@ -0,0 +1,12 @@
3.4 +\documentclass[a4wide]{report}
3.5 +\input{preamble}
3.6 +
3.7 +\begin{document}
3.8 +\input{titlepage}
3.9 +\tableofcontents
3.10 +\listoffigures
3.11 +
3.12 +\input{ISAC_AuthoringTools}
3.13 +\bibliography{bib/isac}
3.14 +%\bibliography{bib/isac,bib/GS}
3.15 +\end{document}
4.1 Binary file doc/MM/myfig/MM-exp_Etc_LebMat-34-N142-b.png has changed
5.1 Binary file doc/MM/myfig/MM-exp_browser.png has changed
6.1 Binary file doc/MM/myfig/MM-exp_hierarchy.png has changed
7.1 Binary file doc/MM/myfig/MM-exp_page.pdf has changed
8.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
8.2 +++ b/doc/MM/preamble.tex Fri Jan 11 19:08:40 2008 +0100
8.3 @@ -0,0 +1,180 @@
8.4 +%chaos rules:
8.5 +
8.6 +\usepackage{listings}
8.7 +\usepackage{latexsym}
8.8 +\usepackage{epsfig}
8.9 +\usepackage{makeidx} % allows for indexgeneration
8.10 +\usepackage{color}
8.11 +\usepackage{eurosym}
8.12 +\usepackage{scrpage2}
8.13 +\usepackage{amsmath,amssymb,amstext}
8.14 +\usepackage{capt-of}
8.15 +\usepackage{mathrsfs}
8.16 +\usepackage{multirow} % tall tables
8.17 +\usepackage{amsfonts} % Mathematical symbols
8.18 +\usepackage{graphicx}
8.19 +\usepackage{mathpazo}
8.20 +\usepackage{german}
8.21 +%\usepackage[utf8]{inputenc} % MM
8.22 +
8.23 +
8.24 +\newif\ifpdf
8.25 +\ifx\pdfoutput\undefined
8.26 + \pdffalse % we are not running PDFLaTeX
8.27 +\else
8.28 + \pdfoutput=1 % we are running PDFLaTeX
8.29 + \pdftrue
8.30 +\fi
8.31 +%----------------------------------------------------------------------
8.32 +\ifpdf
8.33 + \usepackage[pdftex,
8.34 + colorlinks=false,
8.35 + pagebackref,
8.36 + pdfpagemode=None,
8.37 + bookmarksopen=true]{hyperref}
8.38 +\else
8.39 + \usepackage[
8.40 + colorlinks=false,
8.41 + urlcolor=rltblue, % \href{...}{...}
8.42 + anchorcolor=rltbrightblue,
8.43 + filecolor=rltgreen, % \href*{...}
8.44 + linkcolor=rltred, % \ref{...} and \pageref{...}
8.45 + menucolor=webdarkblue,
8.46 + citecolor=webgreen]{hyperref}
8.47 +\fi
8.48 +
8.49 +
8.50 +
8.51 +
8.52 +\bibliographystyle{alpha}
8.53 +
8.54 +%AK macros for labelling and referencing use cases, user requirements etc
8.55 +\newcommand{\preAuth}{AK}
8.56 +\newcommand{\preUC}{\preAuth:UC}
8.57 +\newcommand{\preUR}{\preAuth:UR}
8.58 +\newtheorem{usecase}{UC}[section]
8.59 +\newtheorem{userreq}{UR}[section]
8.60 +\newtheorem{softreq}{SR}[section]
8.61 +\newcommand{\refUC}[1]{UC \ref{\preUC:#1}}
8.62 +\newcommand{\refUR}[1]{UR \ref{\preUR:#1}}
8.63 +\newcommand{\refSR}[1]{SR \ref{#1}}
8.64 +%\newcommand{\UC} below could replace \newtheorem{UC} in common.tex
8.65 +%\newcommand{\UC}[2]{\begin{usecase}\bf#1\label{\preUC:#2}\end{usecase}}
8.66 +%\newcommand{\UR}[2]{\begin{userreq}\bf#1\label{\preUR:#2}\end{userreq}}
8.67 +%...the latter two are already used differently
8.68 +
8.69 +%others
8.70 +\def\zB{z.B.}
8.71 +\def\dah{d.h.}
8.72 +%\newcommand {\url}[1]{\tt#1}
8.73 +\lstdefinelanguage{ISACXML}
8.74 + {morekeywords={NODE,ID,CONTENTREF,NODECONTENT,STRING,STRINGLIST,META,GIVEN,WHERE,FIND,MATHML,ISA,
8.75 + RELATE,THEORY,METHODS,EXPLANATIONS,CAS,EVALPRECOND,DESCRIPTION,FORMALIZATION,VARIANT,
8.76 + TERMLIST,PROBLEM,METHOD,KEY,SPECIFICATION,HIDE,DETAIL,EXAMPLE},
8.77 + sensitive=false
8.78 +}
8.79 +
8.80 + \lstset{xleftmargin = 10mm,
8.81 + framexleftmargin = 10mm,
8.82 + frame=lines,
8.83 + emph=[2]{_init,zero_target},
8.84 + emphstyle=\textit,
8.85 + numbers=left,
8.86 + numberstyle=\tiny \color{mygray},
8.87 + %basicstyle=\small,
8.88 + basicstyle=\scriptsize,
8.89 + keywordstyle=\bf\color{blue},
8.90 + %directivestyle=\color{darkblue},
8.91 + %indexstyle=\color{red},
8.92 + commentstyle=\color{darkgreen},
8.93 + index={6},
8.94 + escapeinside={(*@}{@*)},
8.95 + indexstyle=\color{red}
8.96 + }
8.97 +
8.98 +\newcommand {\kommentar}[1]{\marginpar{\begin{flushright}\tiny#1\end{flushright}}}
8.99 +\newcommand {\frage}[1]{
8.100 + \marginpar{
8.101 + \begin{tabular}{p{5mm} p{2cm}}
8.102 + \begin{flushleft}
8.103 + {\large?}
8.104 + \end{flushleft}
8.105 + &
8.106 + \begin{flushright}
8.107 + \tiny #1
8.108 + \end{flushright}
8.109 + \\
8.110 + \end{tabular}
8.111 + }
8.112 +
8.113 + }
8.114 +\newcommand {\bigquest}{\marginpar{\huge?}}
8.115 +\newcommand {\cnumber}[1]{\put(8,4){\circle{11}}\put(5,1){#1}\hspace{5mm}}
8.116 +
8.117 +\def\isac{${\cal I}\mkern-2mu{\cal S}\mkern-5mu{\cal AC}$}
8.118 +\def\sisac{{\small${\cal I}\mkern-2mu{\cal S}\mkern-5mu{\cal AC}$}}
8.119 +\def\see{$\rightarrow$}
8.120 +
8.121 +% macro for relating to buttons on the gui
8.122 +\newcommand {\button}[1]{$\langle${\it#1}$\rangle$}
8.123 +\setcounter{totalnumber}{8}
8.124 +\setcounter{topnumber}{5}
8.125 +\setcounter{bottomnumber}{5}
8.126 +
8.127 +\renewcommand{\topfraction}{0.99}
8.128 +\renewcommand{\bottomfraction}{0.99}
8.129 +\renewcommand{\textfraction}{0.005}
8.130 +\definecolor{color1}{rgb}{0.5,0.5,1}%fixxme
8.131 +\definecolor{darkgreen}{rgb}{0,0.5,0}
8.132 +\definecolor{darkblue}{rgb}{0,0,.5}
8.133 +\definecolor{lightblue}{rgb}{0.8,0.85,1}
8.134 +\definecolor{mygray}{gray}{.3}
8.135 +
8.136 +\definecolor{rltbrightred}{rgb}{1,0,0}
8.137 +\definecolor{rltred}{rgb}{0.75,0,0}
8.138 +\definecolor{rltdarkred}{rgb}{0.5,0,0}
8.139 +%
8.140 +\definecolor{rltbrightgreen}{rgb}{0,0.75,0}
8.141 +\definecolor{rltgreen}{rgb}{0,0.5,0}
8.142 +\definecolor{rltdarkgreen}{rgb}{0,0,0.25}
8.143 +%
8.144 +\definecolor{rltbrightblue}{rgb}{0,0,1}
8.145 +\definecolor{rltblue}{rgb}{0,0,0.75}
8.146 +\definecolor{rltdarkblue}{rgb}{0,0,0.5}
8.147 +
8.148 +\definecolor{webred}{rgb}{0.5,.25,0}
8.149 +\definecolor{webblue}{rgb}{0,0,0.75}
8.150 +\definecolor{webgreen}{rgb}{0,0.5,0}
8.151 +
8.152 +
8.153 +
8.154 +\newcommand{\trademark}{${}^{\mbox{\scriptsize\textregistered}}$}
8.155 +
8.156 + \newtheorem{UR}{UR}[section]
8.157 + \newtheorem{SR}{SR}[section]
8.158 +
8.159 +\newcommand{\mredcirc}[1]{{\color{red} \textcircled{\small #1}}}
8.160 +\newcommand{\mcirc}[1]{{\textcircled{\small #1}}}
8.161 +
8.162 +
8.163 +
8.164 +
8.165 +
8.166 +
8.167 +
8.168 +
8.169 +
8.170 +
8.171 +
8.172 +
8.173 +
8.174 +
8.175 +
8.176 +
8.177 +
8.178 +
8.179 +
8.180 +
8.181 +
8.182 +
8.183 +
9.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
9.2 +++ b/doc/MM/titlepage.tex Fri Jan 11 19:08:40 2008 +0100
9.3 @@ -0,0 +1,74 @@
9.4 +\begin{titlepage}
9.5 + \fontsize{12pt}{16pt}\selectfont
9.6 +
9.7 + \begin{center}
9.8 +
9.9 + \vspace*{10mm}
9.10 +
9.11 + \textbf{\LARGE{Prototyp eines Authoring Tools f\"ur das ISAC System}} \\
9.12 + \medskip
9.13 + \vspace{15mm}
9.14 +
9.15 + {\large Martin Moschitz} \\
9.16 + \vspace{3mm}
9.17 + {\large Student at the \\Institute for Softwaretechnology,\\
9.18 +Graz University of Technology, \\ Inffeldgasse 16b, A-8010 Graz, Austria.}\\
9.19 + {\large \verb,m2@student.tugraz.at,}
9.20 +
9.21 + \vspace{10mm}
9.22 +
9.23 + {\large Seminar/Projekt}
9.24 +
9.25 + \vspace{10mm}
9.26 + \end{center}
9.27 +
9.28 +
9.29 + \begin{center}
9.30 +
9.31 + \vspace{5mm}
9.32 +
9.33 +\begin{figure}[htb]
9.34 +\centerline{\includegraphics[width=0.2\textwidth, keepaspectratio=true]{../fig/icons/tug}}
9.35 +\end{figure}
9.36 +
9.37 +
9.38 + \vspace{5mm}
9.39 +
9.40 + Graz, Jan. 2008 \\
9.41 +% \end{center}
9.42 +
9.43 + \vspace{30mm}
9.44 +%{\small
9.45 +%\begin{tabular}{ll}
9.46 +% Betreuer: & Prof. Dipl.-Ing. Dr.techn. Franz Wotawa \\
9.47 + Betreuer: Prof. Dipl.-Ing. Dr.techn. Franz Wotawa \\
9.48 +%\end{tabular}
9.49 +%}
9.50 + \end{center}
9.51 +
9.52 +\newpage
9.53 +
9.54 +\def\changemargin#1#2{\list{}{\rightmargin#2\leftmargin#1}\item[]}
9.55 +\let\endchangemargin=\endlist
9.56 +
9.57 +\verb' '\\
9.58 +\vspace{20mm}
9.59 +\verb' '\\
9.60 +\begin{center}
9.61 +{\bf Abstract: }
9.62 +\end{center}
9.63 +Das vorliegende Seminar/Projekt hatte zur Aufgabe, mehrere hundert Beispiele aus einem Mathematik-Lehrbuch in das \sisac-Lernsystem zu \"ubertragen.
9.64 +
9.65 +Die besondere Herausforderung in der Aufgabenstellung ergab sich daraus, dass das \sisac-System zwar eine relativ leistungsf\"ahige Tutoring-Komponente hat, diese die komplexe Struktur des Contents bestimmt, aber dass bisher noch niemals Requirements f\"ur die Autorenarbeit bedacht wurden.
9.66 +
9.67 +Es zeigte sich, dass der Aufwand an Autorenarbeit f\"ur eine solche Menge von Beispielen nicht mehr zu bew\"altigen war. Daher wurde ein Prototyp eines Autorenwerkzeuges erstellt, der die Autorenarbeit teilweise automatisiert.
9.68 +
9.69 +Dieser Prototyp ist ein erster Schritt in Richtung einer umfassenden Requirements-Analyse zur Autorenarbeit (nicht nur f\"ur Beispiels-Daten, sondern auch f\"ur Daten der Mathematik-Wissensbasis).
9.70 +
9.71 +%F\"ur den erfolgreichen Einsatz von \sisac{} im Schulbetrieb ist es notwendig, neuen Content f\"ur das Tutoring System rasch und mit wenig Aufwand zu erstellen. Grunds\"atzlich umfasst die Erstellung einer neuen Contentseite mehrere Schritte, die bisher nur manuell durchgef\"uhrt werden konnten. Dieses Dokument gibt eine Einf\"uhrung \"uber Content, und stellt einen Protoyp eines Tool vor, welches die Contenterstellung teilweise automatisiert und stark vereinfacht. Ziel war es, einen grunds\"atzlichen \"Uberblick \"uber Content Generierung zu gewinnen, erste Automatisierungsschritte mit dem Prototyp durchzuf\"uhren und erste Einblicke in die notwendigen Requirements f\"ur ein vollst\"andiges Content Generierungs Tool zu gewinnen.
9.72 +
9.73 +\end{titlepage}
9.74 +
9.75 +
9.76 +% Der derzeitige \sisac-Protyp hat die Tutoring-Komponente relativ gut ausgebaut, und diese bestimmt auch
9.77 +
