Page Comparison

Anleitung

Wie ist die Resource HTML aufgebaut?

1. HTML-Gerüst

Den eigentlichen Inhalt kann man entweder in einem herkömmlichen HTML-Gerüst platzieren, oder das Gerüst komplett weglassen. Mit dem Gerüst kann das valide HTML in einem Browser gesichtet werden und bei Bedarf auch gestylt werden.

2. Artikel

Der Inhalt wird in Form von Artikeln gegliedert. Ein Artikel besteht aus einem umfassenden Div, das eine Überschrift und wiederum ein Div enthält. Unterartikel (mit einer höheren Überschrift) werden nicht verschachtelt, sondern einfach mit der entsprechenden Überschrift als weiterer Artikel auf derselben Ebene aufgeführt.

<div>
    <h2>TITEL DES ARTIKEL 1</h2>
    <div>
        INHALT DES ARTIKEL 1
    </div>
</div>
<div>
    <h3>TITEL DES ARTIKEL 2</h3>
    <div>
        INHALT DES ARTIKEL 2
    </div>
</div>

Aus einem Artikel wird grundsätzlich eine Frage generiert und ein Index erstellt, welcher bei der Beantwortung von Fragen zum Zuge kommt.

Überschriften

Die Überschrift H1 ist nicht zulässig, da der Dokumententitel nicht im HTML erfasst wird. Valide Überschriften sind H2-H6. Dabei muss die Hierarchie eingehalten werden. Auf ein H3 darf dementsprechend kein H5 folgen (sondern ein H4 oder ein H2). Wird die Hierarchie nicht eingehalten, können Probleme bei der Verarbeitung auftreten oder die Qualität der generierten Resultate darunter leiden.

Enthält ein Artikel mit einer Überschrift keinen direkten Text (sondern weitere Abschnitte mit Titeln), wird der Titel ohne Inhalt erfasst:

<div>
    <h2>TITEL DES ARTIKEL 1</h2>
</div>
<div>
    <h3>TITEL DES ARTIKEL 1.1</h3>
    <div>
        INHALT DES ARTIKEL 1.1
    </div>
</div>
<div>
    <h3>TITEL DES ARTIKEL 1.2</h3>
    <div>
        INHALT DES ARTIKEL 1.2
    </div>
</div>

3. Inhalt eines Artikel

Ein Artikel kann beliebige Elemente enthalten, sofern die Grundstruktur eingehalten wird. Strukturen von Elementen wie Listen (<ul>), Tabellen (<table>) und Paragrafen (<p>) werden für die Verarbeitung verwendet. Andere Elemente, wie z. B. Bilder (<img>), werden aktuell beim Verarbeiten ignoriert. Für zukünftige Erweiterungen lohnt es sich gegebenenfalls jedoch, diese Elemente dennoch zu erfassen.

4. Artikel mit Selektionen logisch unterteilen

Um die Indexierung und die Fragegenerierung zu beeinflussen, bietet sich der Tag <mm-selection> an. Werden Selektionen verwendet, wird für jeder Selektion eine Frage und ein Index erstellt. Es lohnt sich lange Artikel in inhaltlich sinnvolle Selektionen zu gliedern. Mit dem Tag kann eine beliebige Struktur innerhalb des Artikelinhalts eingefasst werden. Der eingefasste Texte, sowie der davorstehende und folgende Text, werden automatisch unterteilt.

Beide der folgenden Varianten resultieren in drei Fragen und Indizes:

5. Seitenzahl

Neben den Überschriften, kann das Dokument mit dem Attribute data-page-number mit einer weiteren Quellen-Spezifizierung bereichert werden. Das Attribute enthält eine Zahl, welche die Seitenzahl des Artikels oder der Selektion im Originaldokument widerspiegelt. Entscheidend für die Seitenzahl ist, ist die Seite, auf der der Artikel bzw. die Selektion startet.

Beispieldateien

Die Datei grano.html dient als Beispieldatei. Die grano.css ist optional und stylet die grano.html, damit u. a. die Selektionen sichtbar sind.