Parameterbeispiel: Anzeige von Hyperlinks

Im allegro-Standardformat sind Links auf externe Dokumente in Kategorie #8e abgelegt. Diese Kategorie erlaubt analog zu USMARC viele Teilfelder für unterschiedliche Aspekte der Beschreibung der externen Ressource, viele davon sind in Zeiten des WWW obsolet.

In der einfachsten Form enthält die Kategorie nur eine durch » ; « getrennte Liste von eventuell unvollständigen URLs, etwa in den drei folgenden Arten:

1. voll qualifiziert, d.h. unter Angabe des Protokolltyps (http:, ftp:, etc.): Diese nehmen wir für Links auf fremde Inhalte
2. absolute Pfade, d.h. die URLs beginnen mit einem Schrägstrich »/«: Diese benutzen wir für Links auf Inhalte auf unserem eigenen Webserver (nicht notwendig unsere eigenen Inhalte).
3. relative Pfade, also alles, was nicht den Protokolltyp oder einen absoluten Pfad angibt: Diese fassen wir als Links auf einen von uns selbst verwalteten Verzeichnisbaum »Digitale Bibliothek« auf. Die URL des Wurzelverzeichisses dieses unseres Verzeichnisbaums ist in den Parametern fest eingetragen.

Folgende Besonderheiten müssen wir außerdem noch beachten:

• In vielen URLs kommt der Unterstrich »_« vor, dieses Zeichen wird aber u.U. von der gegebenen allegro-Anwendung für Stammsatzersetzungen genutzt. Eingabe daher möglichst als %5f oder %5F, dies ist eine standardkonforme (»URL-encoded string«) Umschreibung.
  Damit zusammen hängt, daß in Parameterdateien oft die Umcodierung so eingestellt ist, daß Unterstriche (und evtl. alles folgende in der Kategorie) ausgeblendet werden. Zeilen
  p _ 0
  oder
  p _ 1
  sind daher zu deaktivieren!
• Falls die allegro-Exportparamer mit beschränkter Zeilenbreite operieren, wird riskiert, daß mitten in den URLs umbrochen wird und die Links daher nicht funktionieren. Das Parameterbeispiel setzt daher die Zeilenbreite temporär auf einen möglichst hohen Wert und spickt die Ausgabe an harmlosen Stellen (also innerhalb von HTML-Tags) mit Zeilenumbrüchen. Auch für die Darstellung der URL wird also mit der hohen Zeilenbreite gearbeitet, der Browser findet typischerweise aber eine Stelle, an der er selbsttätig einen Umbruch machen kann.

Um die Mehrfachbelegung zu handhaben, ist die eigentliche Aufbereitung von einer Standardschleife umgeben: #ucc bekommt den urspruenglichen Kategorieinhalt, und wird zusammen mit dem Ende-Test jeweils von vorne beginnend reduziert. #ucd wird jeweils der erste Bestandteil zugewiesen.

#8e +° dcc ... f32 acc          % Test und Start
#nr +#98a Z                     % Abbruch stattdessen

#-°                             % Einsprung Schleife
#ucc ... dcd e";" F32 =cd       % Initialisierung #ucd

#ucd ...                        % Verarbeitung

#ucc +° dcc dcd b";" f32 acc    % Endetest Schleife

...                             % Abschluss

#98a                            % Aussprung

  % Code an geeignete Stelle der Parameter einfuegen...
  % Benutzte Anwendervariable sind #ucc und #ucd
  % Benutzte Sprungmarke fuer die Schleife ist #-°

#8e +° dcc p{&130 #0 C} f32 acc
#nr +#98a Z

#-°         % Einsprung Schleife
   % Ab hier enthaelt #ucc stets den um fuehrende Leerzeichen
   % bereinigten Rest der Kategorie
#ucc p{C '['} dcd e";" F32 =cd

#ucc p{C '['} dcd e";" F32 ,",%5f,_," ,",%5F,_," =cd
     

   % Ab hier enthaelt #ucd die aktuelle URL bereinigt um 
   % folgende Leerzeichen

   % Behandlung der drei moeglichen Eingabefaelle
   % 1. volle URL

    [Externes Dokument: <A
    HREF="http://www.gymel.com/beispiele/8elink.html"
    >http://www.gymel.com/beispiele/8elink.html</A>]

#ucd c"://" y0 p{'Externes Dokument: <A' C 'HREF="'} P{'"' C '>'}
#ucd +#98b c"://"

   % 2. absoluter Pfad (auf diesem Server)

    [Lokales Dokument: <A
    HREF="/beispiele/8elink.html#code"
    >/beispiele/8elink.html#code</A>]

#ucd i4,/ y0 p{'Lokales Dokument: <A' C 'HREF="'} P{'"' C '>'}
#ucd +#98b i4,/

   % 3. relativer Pfad (Volltext)

    [==&gt; <A HREF="http://www.gymel.com/capriccio/htmlfaq/faq.htm"
    >Volltext</A>]

#ucd y0 p{'==&gt; <A HREF="http://www.gymel.com/capriccio/'} P{'"' C '>Volltext'}

#98b
#t{'</A>]'}
#ucc +° dcc dcd b";" f32 acc
  % Folgende Zahl ueberpruefen, ob sie mit der Setzung 
  % fuer den Parameter zl uebereinstimmt!
#t{&75}


  % Sprungziel, falls #8e nicht belegt war  
#98a

  % Code an geeignete Stelle der Parameter einfuegen...
  % Benutzte Anwendervariable sind #ucc und #ucd
  % Benutzte Sprungmarke fuer die Schleife ist #-°
#8e +° dcc p{&130 #0 C} f32 acc
#nr +#98a Z

#-°         % Einsprung Schleife
   % Ab hier enthaelt #ucc stets den um fuehrende Leerzeichen
   % bereinigten Rest der Kategorie
#ucc p{C '['} dcd e";" F32 =cd
   % Ab hier enthaelt #ucd die aktuelle URL bereinigt um 
   % folgende Leerzeichen

   % Behandlung der drei moeglichen Eingabefaelle
   % 1. volle URL
#ucd c"://" y0 p{'Externes Dokument: <A' C 'HREF="'} P{'"' C '>'}
#ucd +#98b c"://"
   % 2. absoluter Pfad (auf diesem Server)
#ucd i4,/ y0 p{'Lokales Dokument: <A' C 'HREF="'} P{'"' C '>'}
#ucd +#98b i4,/
   % 3. relativer Pfad (Volltext)
#ucd y0 p{'==&gt; <A HREF="http://www.gymel.com/capriccio/'} P{'"' C '>Volltext'}

#98b
#t{'</A>]'}
#ucc +° dcc dcd b";" f32 acc
   % Folgende Zahl ueberpruefen, ob sie mit der Setzung 
   % fuer den Parameter zl uebereinstimmt!
#t{&75}


  % Sprungziel, falls #8e nicht belegt war  
#98a

  % Beachten:
  %  p _ 0
  % (bzw. p _ 1 oder aehnliches) muss ueberall auskommentiert sein!