Zurück zur Hilfe-Hauptseite.
Sie sind herzlich eingeladen, die Text-Engine in Ihrer Website zu benutzen, ob als Text-Server, der bestimmte Zitate und Textauszüge liefert, oder auch, um Ihren Besuchern Zugang zum hiesigen Korpus zu verschaffen. Sie können den Text-Server abfragen, indem Sie einen Ausdruck in der Textsprache an ihn richten. Ihnen stehen dafür die folgenden Möglichkeiten zur Verfügung:
Am einfachsten bauen Sie auf Ihren Seiten Zugang zur Text-Engine ein mit einem Formular, das zumindest aus einem Textfeld und einer Schaltfläche besteht.
Der HTML-Code dazu ist dieser:
<form action="http://textei.net/text.php" method="get" target="_blank"> <p>Suche in Kants <i>Kritik der reinen Vernunft</i> nach: <input type="hidden" type="text" name="text" value="kant.krv"> <input type="text" name="query" size="30" value=""> <input type="submit" value="Auszug"></p> </form>
Die Angaben können dadurch erleichtert werden, dass wie oben Optionen gezeigt werden. Dies erlaubt Besuchern, die nichts über die Textsprache wissen, über die Angabe der Operation zu verfügen. Ein Formular kann auch stillschweigend Angaben festlegen (wie es hier der Fall mit dem Text kant.krv ist). Der Code für das obige Formular lautet:
<form action="http://textei.net/text.php" method="get" target="_blank"> <p>Suche in Kants <i>Kritik der reinen Vernunft</i> nach <input type="hidden" type="text" name="text" value="kant.krv"> <select name="op"> <option value="and">Sätzen mit den Wörtern:</option> <option value="or">Sätzen mit einigen der Wörter:</option> </select> <input type="text" name="query" size="30" value=""> <input type="submit" value="Auszug"></p> </form>
Die Optionen können Sie nach Wunsch beschreiben. Wichtig ist nur, dass als „name=” den Angabetyp und als „value=” das entsprechende Wort steht. Alle hier beschriebene Angaben und Angabetypen der Textsprache können Sie auf dieser Weise festlegen.
Einen Link zu einem beliebigen Auszug können Sie mit der folgenden URL erstellen:http://textei.net/text.php?query=<Ausdruck in der Textsprache>.
Es besteht die Möglichkeit, die Angaben als Parameter der URL anzugeben (was unter anderem die oben besprochenen Formularen ermöglicht), also etwa:
http://textei.net/text.php?text=kant.krv&op=or&uti=<UTI>&query=<Ausdruck in der Textsprache>.
Bitte vergessen Sie nicht, die URL als solche zu kodieren! (In Zweifelsfall geben Sie einfach die Abfrage in der Textsuche ein und sehen Sie nach der erstellten URL in Ihrem Browser nach.)
Siehe auch die statischen Links zur Volltextausgabe, die unter UTI als URI beschrieben werden.
Ein beliebiger Auszug lässt sich auf Ihre HTML-Seite durch den folgenden JavaScript-Aufruf einbetten:
<script src="http://textei.net/gettext.js.php?query=<Ausdruck in der Textsprache>" type="text/javascript" language="Javascript" charset="utf-8"></script>.
Die Abfrage „?query=<…>” ist hier identisch mit dem Ausdruck für einen Weblink und hat dieselben Möglichkeiten.
Sie können sich den Code für Ihren Auszug hier erstellen lassen.
Mit einer beliebigen Skript- oder Programmiersprache können Sie sich jeden Auszug von der Text-Engine liefern lassen, indem Sie die folgende URL abrufen:
http://textei.net/gettext.html.php?query=<Ausdruck in der Textsprache>.
Die Abfrage „?query=<…>” ist hier identisch mit dem Ausdruck für einen Weblink und hat dieselben Möglichkeiten.
Mit diesem Aufruf erhalten Sie den HTML-Code für den Auszug, den Sie in Ihre HTML-Seite einfügen können. Mit PHP können Sie dies beispielsweise so tun:
<?php
$handle = fopen("http://textei.net/gettext.html.php?query=<Ausdruck in der Textsprache>", 'r');
while (!feof($handle)) { echo fgets($handle); }
fclose ($handle);
?>
Zu beachten ist hier, dass der gelieferte HTML-Code mit dem Zeichensatz UTF-8 kodiert ist.
Diese URL ist natürlich nicht nur mit HTML-Preprozessoren abrufbar, sondern auch mit jeder selbstständigen Programmiersprache.
Zurück zur Hilfe-Hauptseite.