home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 November / PCO1197.ISO / FilesBBS / DOS / MXLUP230.EXE / NEWS230.DOC < prev    next >
Encoding:
Text File  |  1997-09-05  |  24.6 KB  |  622 lines

  1.  
  2.           ┌──────┐ ┌──────┐ ┌─┐  ┌─┐ ┌─┐      ┌─┐ ┌──────┐ ┌───────┐
  3.           └──────┘ └──────┘ └─┘  └─┘ └─┘      └─┘ └──────┘ └───────┘
  4.           ┌─┐┌┐┌─┐ ┌──────┐   ┌──┐   ┌─┐      ┌─┐ ┌──────┐    ┌─┐
  5.           │ │└┘│ │ │ ┌──┐ │  ┌┘┌┐└┐  │ │      │ │ └────┐ │    │ │
  6.           │ │  │ │ │ │  │ │ ┌┘┌┘└┐└┐ │ └────┐ │ │ ┌────┘ │    │ │
  7.           └─┘  └─┘ └─┘  └─┘ └─┘  └─┘ └──────┘ └─┘ └──────┘    └─┘
  8.      ■ MaxList v2.30 ∙ 05-Sep-97             OS/2, DOS und DPMI Version ■
  9.      ■ Templategesteuerter Filebaseprozessor für Maximus CBCS v2 und v3 ■
  10.      ────────────────────────────────────────────────────────────────────
  11.      ■ (c) 1994-97 by Wilfried Brinkmann, Germany - All rights reserved ■
  12.  
  13.  
  14.  
  15.    Vorwort
  16.    ═══════
  17.     Diese Version von MaxList basiert auf der Version 2.26b. Alle dort
  18.     vorhandenen Funktionen sowie die Dokumentation ist auch hier gültig.
  19.     Zusätzlich wurden Erweiterungen eingebaut, um HTML-Listen und FILES.BBS
  20.     im HTML-Format zu erzeugen (FILES.HTM).
  21.  
  22.     In dieser Anleitung werden NUR diese Erweiterungen beschrieben, sowie
  23.     alle Änderungen und Fixes, welche auch andere Funktionen beeinflussen.
  24.  
  25.     Ich habe einen Satz HTML-Templates für Online- und Downloadlisten
  26.     beigesteuert, so wie sie hier verwendet werden. Die Beispielkonfig ist
  27.     ebenfalls identisch mir den bei mir verwendeten Einstellungen.
  28.  
  29.  
  30.    Intranet (PPP) Zugang bei der TsC
  31.    ═════════════════════════════════
  32.     Die Tiger's Claw bietet einen Intranet Zugang als Alternative zum
  33.     BBS-Zugang an. Hier kannst Du MaxList 2.30 "Life" erleben ;-)
  34.  
  35.     Dazu musst Du TCP/IP installiert haben und einen Browser Dein eigen
  36.     nennen, der Frames verarbeiten kann, wie z.B. Netscape.
  37.     Weiterhin ist ein FTP-Zugang vorhanden. Via 'anonymous' - Login (mit
  38.     der eMail-Addresse als Passwort) kannst Du auf die Filebase zugreifen.
  39.  
  40.     Wer mit OS/2 arbeitest, kann den Internet-Dialer von OS/2 verwenden.
  41.     Alternativ kann auch ILink/2 oder InJoy verwendet werden.
  42.  
  43.     Folgende Parameter müssen benutzt werden (schreibweise beachten):
  44.  
  45.       Connection Type:     PPP
  46.       LoginID:             tsc
  47.       Password:            gast
  48.       Domain Nameserver:   172.30.30.1
  49.       Login Sequenz:       NONE     (oder nichts angeben)
  50.  
  51.    Der Server reagiert auf: http://tsc.bbs.de   oder  ftp://tsc.bbs.de
  52.  
  53.    Einwählen kannst Du Dich auf 02324-947040 (V34/ISDN) oder
  54.    02324-45700 (ISDN). Bei ISDN ist X75 angesagt, kein HDLC !!!
  55.  
  56.  
  57.    Allgemeines
  58.    ═══════════
  59.     HTML-Listen mit MaxList zu erstellen ist (im prinzip) recht simpel.
  60.     Wer mit Filedivisionen (Gruppen) arbeitet, ist hier klar im Vorteil,
  61.     da sehr einfach eine Übersicht der Gruppen zu erstellen ist und die
  62.     Gruppenlisten dynamisch erzeugt werden können. Hierzu wurde die Konfig
  63.     für die Filelisten entsprechend erweiter.
  64.  
  65.     Aber auch ohne Filedivision können HTML-Listen generiert werden.
  66.     Lediglich der Umfang der Konfiguration ist etwas aufwendiger, da in
  67.     diesem Fall jeder Bereich einzeln definiert werden muss.
  68.     OHNE Filedivision können keine dynamischen Listen benutzt werden !
  69.  
  70.  
  71.     Bei HTML sollten die Dateien nicht zu gross werden, da sonst das Laden
  72.     (Übertragen) zu lange dauert. Für Filelisten, die per Download angeboten
  73.     werden, ist das nicht ganz so kritisch. Für Online-Dienste muss man etwas
  74.     mehr auf diese Dinge achten.
  75.  
  76.     Beispiel für den Aufbau einer Allfiles-Liste zum Download:
  77.  
  78.     Indexliste 1                 Indexliste 2             Liste der Files
  79.     (Gruppen)                    (Areas in Grp 1)         in Gruppe 1
  80.     ┌──────────────────┐         ┌──────────────┐         ┌─────────────┐
  81.     │ Gruppe 1         ├── ref >─┤ Area 1       ├─ ref >──┤Dateien Ar.1 │
  82.     ├──────────────────┤         ├──────────────┤         ├─────────────┤
  83.     │ Gruppe 2         ├─┐       │ Area 2       ├─ ref >──┤Dateien Ar.2 │
  84.     ├──────────────────┤ │       └──────────────┘         └─────────────┘
  85.     │  ... more ...    │ │       │Areas in Grp 2│
  86.                          │       ┌──────────────┐
  87.                          └ ref >─┤ Area 1       ├─ ref >── Fileliste
  88.                                  ├──────────────┤          Gruppe 2
  89.                                  │ ... more ... │
  90.  
  91.     In diesem Beispiel haben wir zwei Indexlisten und soviel einzelne
  92.     Filelisten, wie Gruppen vorhanden sind. Diese Listen werden teilweise
  93.     recht gross und sind deshalb nur für Filelisten zum Download geeignet.
  94.  
  95.  
  96.     Für Online-Dienste muss die zweite Indexliste in einzelne Gruppen
  97.     aufgeteilt werden. Die Referenz der Area verweist dann direkt auf
  98.     die entsprechende FILES.HTM.
  99.  
  100.     Auch hierzu ein Beispiel:
  101.  
  102.     Indexliste                   Gruppenliste 1
  103.     (Gruppenübersicht)           (Areas in Grp 1)
  104.     ┌──────────────────┐         ┌───────────────┐          ┌──────────┐
  105.     │ Gruppe 1         ├── ref >─┤ Area 1        ├── ref >──┤FILES.HTM │
  106.     ├──────────────────┤         ├───────────────┤          └──────────┘
  107.     │ Gruppe 2         ├─┐       │ Area 2        ├─┐
  108.     ├──────────────────┤ │       └───────────────┘ │        ┌──────────┐
  109.     │  ... more ...    │ │                         └ ref >──┤FILES.HTM │
  110.                          │       Gruppenliste 2             └──────────┘
  111.                          │       (Areas in Grp 2)
  112.                          │       ┌───────────────┐          ┌──────────┐
  113.                          └ ref >─┤ Area 1        ├── ref >──┤FILES.HTM │
  114.                                  ├───────────────┤          └──────────┘
  115.                                  │ ... more ...  │
  116.  
  117.  
  118.     Soweit der prinzipielle Aufbau der Listen-Struktur. Natürlich sind auch
  119.     andere Abläufe machbar. MaxList ist da sehr flexibel. Letztendlich ist
  120.     das ganze nur durch die Anzahl der Listen beschränkt (Maximal ca. 200).
  121.  
  122.     Noch ein Hinweis:
  123.       Kommentare in der Files.bbs werden in HTML-Dateien NICHT ausgegeben !
  124.  
  125.  
  126.     So, nun kommen wir zum Eingemachten, sprich den dazu notwendigen
  127.     Änderungen, bzw. Erweiterungen der Konfiguration und der Templates.
  128.  
  129.          ┌──────────────────────────────────────┐
  130.    ──────┤ Konfiguration für HTML (MAXLIST.CFG) ├─────────────────────────────
  131.          └──────────────────────────────────────┘
  132.  
  133.      Allgemeine Hinweise:
  134.      ────────────────────
  135.       Bei HTML-Listen und FILES.HTM setzt MaxList automatisch <html> am Anfang
  136.       und </html> am Ende der Dateien ein. Der Dateianfang sieht also so aus:
  137.  
  138.        <html>
  139.        <!--
  140.        This list was produced by MAXLIST+ (Version 2.30∙OS/2)
  141.        Copyright 1994/1997 by Wilfried Brinkmann, 45529 Hattingen, Germany
  142.        Registered to: Vorname Nachname
  143.        //-->
  144.  
  145.       Danach folgen die diversen Templates und zwar (abhängig vom ListenTyp) in
  146.       dieser Reihenfolge:
  147.  
  148.        ┌───────────────────────────────────┐
  149.        │ FileListHeader (Optional)         │
  150.        ├───────────────────────────────────┤
  151.        │ ListTitle      (Optional)         │
  152.        ╞═══════════════════════════════════╡ ──┐
  153.        │ GroupTitle     (Optional)         │   │
  154.        ├───────────────────────────────────┤   │
  155.        │ AreaHeader mit @Format Anweisung  │   │
  156.        ├ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┤   ├── Dieser Block wird für alle
  157.        │ Datei Beschreibung                │   │   Gruppen wiederholt.
  158.        │   ...                             │   │
  159.        │ Datei Beschreibung                │   ├── Nicht bei Reportlisten.
  160.        ├ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┤   │   Bei Dupelisten nur ein
  161.        │ AreaFooter     (Optional)         │   │   AreaHeader.
  162.        ├───────────────────────────────────┤   │
  163.        │ ... weitere Areas                 │   │
  164.        ╞═══════════════════════════════════╡ ══╡
  165.        │ ReportHeader   (Optional)         │   │
  166.        ├───────────────────────────────────┤   │
  167.        │ GroupHeader mit @Format Anweisung │   │
  168.        ├ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┤   │
  169.        │ Areas dieser Gruppe               │   │
  170.        │   ...                             │   ├── Nur wenn AllAreaReport
  171.        │ Areas dieser Gruppe               │   │   auf YES steht.
  172.        ├ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┤   │   Immer bei Reportlisten.
  173.        │ GroupFooter    (Optional)         │   │
  174.        ├───────────────────────────────────┤   │
  175.        │ ... weitere Gruppen               │   │
  176.        ├───────────────────────────────────┤   │
  177.        │ ReportFooter   (Optional)         │   │
  178.        ╞═══════════════════════════════════╡ ──┘
  179.        │ FileListFooter (Optional)         │
  180.        └───────────────────────────────────┘
  181.  
  182.       Als letztes setzt MaxList dann das Datum (als Kommentar) ein und
  183.       schliesst die Liste mit einem </html> ab.
  184.  
  185.        <!-- Created at dd-mm-yy -->
  186.        </html>
  187.  
  188.       Beachte, das die bei 'FileListHeader' und 'FileListFooter' abgegebenen
  189.       Dateien NICHT  über den Template-Interpreter laufen ! Diese werden
  190.       lediglich an die entsprechenden Stellen kopiert !
  191.  
  192.    ───────────────────────────────────────────────────────────────────────────
  193.  
  194.      Neue Konfig-Befehle (Global):
  195.      ═════════════════════════════
  196.  
  197.       EraseOldHtmlBbs    Yes | No
  198.       ───────────────────────────
  199.       Damit können vorhanden FILES.HTM wieder gelöscht werden.
  200.       Es ist natürlich unsinn, hier YES anzugeben um anschliessend neue
  201.       FILES.HTM anzulegen ;-) Vorgabe ist NO.
  202.  
  203.  
  204.       CreateHtmlBbs      Yes | No
  205.       ───────────────────────────
  206.       Mit diesem Eintrag wird global festgelegt, ob FILES.HTM erzeugt werden
  207.       sollen. Vorgabe ist NO.
  208.  
  209.  
  210.       HtmlBbsHeader   <Area [ .. Area]>    <d:\path\Template.ext>
  211.       ───────────────────────────────────────────────────────────
  212.       Kann mehrfach benutzt werden.
  213.  
  214.       Dieser Eintrag ist in etwas mit BBSHeader gleichzusetzen.
  215.       Das Template MUSS den Kopf der Files.htm enthalten, sowie die Ausgabe
  216.       der Dateien mit der @Format( .. ) Anweisung.
  217.       Ein Beispiel hierfür findest Du in BBS-AHDR.TPL.
  218.  
  219.       HINWEIS: Ohne die Angabe HTMLBbsHeader wird keine FILES.HTM erzeugt !
  220.  
  221.  
  222.       HtmlBbsFooter   <Area [ .. Area]>    <d:\path\Template.ext>
  223.       ───────────────────────────────────────────────────────────
  224.       Kann mehrfach benutzt werden.
  225.  
  226.       Dieses Template wird NACH der Ausgabe aller Dateien verwendet.
  227.       In der Regel wird hier nur eine Tabelle und der Body beendet.
  228.       Ein Beispiel hierfür findest Du in BBS-AFTR.TPL.
  229.  
  230.  
  231.       HtmlReplace     "Originalstring", "Ersatzstring"
  232.       ────────────────────────────────────────────────
  233.       Kann mehrfach benutzt werden.
  234.  
  235.       Mit diesem Befehl kann eine beliebige Zeichenfolge in der Datei-
  236.       beschreibung durch eine andere ersetzt werden. Die Strings müssen
  237.       in Anführungszeichen gesetzt werden. Dabei ist folgendes zu beachten:
  238.  
  239.         MaxList überarbeitet die Dateibeschreibung für Html in mehreren
  240.         Schritten. Zunächst werden alle mehrfach nacheinander auftretenden
  241.         nicht Buchstaben-Zeichen entfernt. Anschliessend werden die Umlaute
  242.         sowie <, >, & und " umgewandelt. Dannach folgt die Auswertung von
  243.         HtmlReplace. Als letztes werden noch alle mehrfachen Spaces und alle
  244.         Zeichen < 32 und > 126 entfernt.
  245.  
  246.  
  247.       MapPath         "Drive:\Path", "Pseudonym"
  248.       ──────────────────────────────────────────
  249.       Kann mehrfach benutzt werden.
  250.  
  251.       Dieser Eintrag kann benutzt werden, um Laufwerksbezeichner und/oder
  252.       Pfade durch "relative" Angaben zu ersetzen. Beide Angaben müssen in
  253.       Anführungszeichen gesetzt werden. Die Angabe bei "Drive:\Path" sollte
  254.       eindeutig sein.
  255.       Die eigentliche Übersetzung erfolgt mit dem Template-Token @MAP(@ID).
  256.  
  257.       Beispiel:
  258.         CONFIG:     MAPPATH   "H:", "\\mailbox\drive_h"
  259.         TEMPLATE:   @MAP(@FILEBBS)
  260.  
  261.         Wir nehmen an, @FileBbs liefert "H:\TOOLS\FILES.HTM". Nach dem
  262.         Mappen wird daraus "\\mailbox\drive_h\TOOLS\FILES.HTM"
  263.  
  264.       Beachte, das "Pseudony" ohne jegliche Änderung übernommen wird !
  265.  
  266.  
  267.      Neues Befehle in der Listendefinition:
  268.      ══════════════════════════════════════
  269.  
  270.       │ HTMLFormat      YES | NO
  271.       └─────────────────────────
  272.       Damit wird festgelegt, ob eine 'normale' oder eine HTML-Liste erzeugt
  273.       werden soll. Vorgabe ist NO.
  274.  
  275.  
  276.       │ AddToArchive    d:\path\Datei.ext
  277.       └──────────────────────────────────
  278.       Damit kann z.B. eine FILE_ID.DIZ zum Archiv hinzugefügt werden.
  279.       Der Dateiname kann die Wildcards (* und ?) enthalten.
  280.  
  281.       HINWEIS: Wird bei dynamischen Listen ignoriert !
  282.  
  283.  
  284.       │ DelOldArchive   YES | NO
  285.       └─────────────────────────
  286.       Bei YES wird das Archiv zunächst gelöscht. Werden mehrere Listen
  287.       in ein Archiv gepackt, darf dieser Befehl nur in der ersten Liste
  288.       (Reihenfolge in der Konfiguration) angegeben werden. Vorgabe ist NO.
  289.  
  290.       HINWEIS: Wird bei dynamischen Listen ignoriert !
  291.  
  292.  
  293.       │ HideTypeCD      YES | NO
  294.       └─────────────────────────
  295.       Bei YES werden keine Areas, die mit TYPE CD definiert sind in die
  296.       Liste aufgenommen. Vorgabe ist NO.
  297.  
  298.  
  299.  
  300.      Dynamische Gruppenlisten (nur mit Filedivision)
  301.      ═══════════════════════════════════════════════
  302.      Wie schon Eingangs erwähnt, können die einzelnen Gruppenlisten auch
  303.      dynamisch (zur Laufzeit) erzeugt werden. In diesem Fall muss in der
  304.      Konfiguration nur EINE Fileliste definiert werden. Zur Laufzeit werden
  305.      dann soviele (identische) Listen erzeugt, wie Gruppen vorhanden sind.
  306.      Für Gruppen, die keine Areas oder Dateien enthalten, werden natürlich
  307.      keine Listen erzeugt. Eine dynamische Liste hat z.B. folgendes Format:
  308.  
  309.        FileList DYNAMIC  Group&GNUM.HTM All Dateien in Gruppe >AG
  310.         ...
  311.         Exclude          Area    *
  312.         Include          Area    >AG.*
  313.        End FileList
  314.  
  315.      In einer dynamischen Liste kannst (und musst) Du die Macros >AG und
  316.      &GNUM verwenden. Diese zur Laufzeit durch den Gruppennamen (>AG) bzw.
  317.      die laufende Gruppennummer (&GNUM) ersetzt.
  318.      Weitere Informationen zu Gruppennummer und Gruppentag findest Du bei den
  319.      Template-Token @GROUPNUM und @GROUPTAG.
  320.  
  321.      Um z.B. eine (Online) HTML-Liste mit einem Index und den Gruppenlisten zu
  322.      erzeugen, werden lediglich zwei Listendefinitionen benötigt. In diesem
  323.      Beispiel nehmen wir an, Du hast eine Gruppe 'DAT' und darin weiter Gruppen
  324.      'A', 'B', 'C' und 'D'. Die Gruppe 'DAT' enthält keine Dateien, sondern nur
  325.      weitere (Unter)Gruppen. Desweiteren nehmen wir an, dass die Gruppe 'DAT.C'
  326.      keine Datei enthält. Die Filelisten werden dann wie folgt definiert:
  327.  
  328.        ; Indexliste
  329.        ;
  330.        FileList            Index.htm All Dateiliste Gruppenindex
  331.          HtmlFormat        Yes
  332.          ListTitle         Ix-LTtl.tpl
  333.          GroupTitle        Ix-GTtl.tpl
  334.          ReportFooter      Ix-LFtr.tpl
  335.          AllAreaReport     Yes
  336.          Exclude           Area    UNCHK
  337.        End FileList
  338.  
  339.        ; Gruppenlisten
  340.        ;
  341.        FileList  Dynamic   Group&GNum.HTM All Dateibereiche Gruppe >ag
  342.          HtmlFormat        Yes
  343.          ListTitle         Rp-LTtl.tpl
  344.          GroupHeader       Rp-GHdr.tpl
  345.          GroupFooter       Rp-GFtr.tpl
  346.          ReportFooter      Rp-LFtr.tpl
  347.          AllAreaReport     Yes
  348.          Exclude           Area    *
  349.          Include           Area    >ag.*
  350.        End FileList
  351.  
  352.      Als Ergebnis erhälst Du eine Liste 'INDEX.HTM' sowie die Gruppenlisten
  353.      'GROUP1.HTM' mit den Areas aus 'DAT.A', 'GROUP2.HTM' mit den Areas aus
  354.      'DAT.B' sowie 'GROUP3.HTM' mit den Areas aus 'DAT.D'. Die Gruppe 'DAT'
  355.      sowie die Untergruppe 'DAT.C' wird nicht ausgegeben, da in diesen keine
  356.      Dateien enthalten sind.
  357.  
  358.      Alternativ kannst Du den Dateinamen der Gruppenlisten auch aus dem
  359.      Gruppennamen bilden. Dabei ist zu beachten, das dieser keine Zeichen
  360.      enthält, die für Dateinamen nicht erlaubt sind. Du solltest das auch
  361.      nur verwenden, wenn Du die Listen auf einem Dateisystem erzeugst,
  362.      welches lange Dateinamen unterstützt, wie z.B. HPFS bei OS/2.
  363.      Auf einer DOS FAT-Partion geht das nicht!!
  364.  
  365.      Beispiel:
  366.  
  367.        FileList  Dynamic   >ag.HTM All Dateibereiche Gruppe >ag
  368.          ....
  369.          Exclude           Area    *
  370.          Include           Area    >ag.*
  371.        End FileList
  372.  
  373.      In diesem Fall erhälst Du die Gruppenlisten 'DAT.A.HTM', 'DAT.B.HTM'
  374.      sowie 'DAT.C.HTM'.
  375.  
  376.      HINWEIS: Dynamische Listen können nur mit dem Listentyp ALL, NEW oder
  377.      PART definiert werden !
  378.  
  379.  
  380.          ┌────────────────────────────────────┐
  381.    ──────┤ Konfiguration für HTML (TEMPLATES) ├───────────────────────────────
  382.          └────────────────────────────────────┘
  383.  
  384.      Allgemeine Hinweise:
  385.      ════════════════════
  386.       Folgende vorhandene Token liefern andere Ergebnisse als bei 'normalen'
  387.       Listen oder Files.bbs Dateien:
  388.  
  389.        @Adjust( .. )     - ALLE nach dem Auffüllen vorhanden Leerzeichen
  390.                            werden durch " " ersetzt.
  391.  
  392.        @FileName         - Wird nicht mit Leerzeichen aufgefüllt.
  393.  
  394.        @FileDesc( .. )   - Alle Parameter in der Klammer werden ignoriert.
  395.                            Die Dateibeschreibung wird in ein HTML-Konformes
  396.                            einzeiliges Format konvertiert. Leerzeilen, -zeichen
  397.                            und alle Sonderzeichen werden automatisch entfernt.
  398.  
  399.  
  400.  
  401.      Neue Token:
  402.      ═══════════
  403.  
  404.       @COPY
  405.       ─────
  406.       Syntax:     @Copy(@ID, Startpos, Länge)
  407.       Templates:  Alle
  408.       Vorgaben:   Startpos = 1, Länge = 255
  409.  
  410.       Damit kann ein Teil aus einem beliebigen String herauskopiert werden.
  411.       @ID kann ein Token oder ein String sein, Startpos und Länge eine Nummer
  412.       im Bereich 1 .. 255.
  413.  
  414.       Beispiel:
  415.         @Copy(EinString, 4)      ergibt "String"
  416.         @Copy(EinString, 1, 3)   ergibt "Ein"
  417.         @Copy(EinString, 4, 3)   ergibt "Str"
  418.  
  419.  
  420.  
  421.       @FILEBBS
  422.       ────────
  423.       Syntax:     @FileBbs([LOCASE])
  424.       Templates:  Alle ausser Titel und Dupe
  425.  
  426.       Dieses Token liefert Laufwerk, Pfad und Name der Files.bbs Datei.
  427.       Bei Files.bbs im HTML-Format ist das Extension IMMER ".HTM" !
  428.  
  429.       Ist der (optinale) Parameter LOCASE angegeben, wird der ganze String
  430.       in Kleinbuchstaben umgewandelt.
  431.  
  432.  
  433.  
  434.       @GROUPNUM
  435.       ─────────
  436.       Syntax:     @GroupNum
  437.       Templates:  Alle ausser Titel
  438.  
  439.       Liefert die laufende Nummer der Gruppe, die gerade bearbeitet wird.
  440.       Die Zählung beginnt mit 1.
  441.  
  442.       Beachte, das die Anweisung 'SortAreaFile  GROUP' oder 'BOTH' Einfluss
  443.       auf die namentliche Reihenfolge der Gruppen hat, jedoch nicht auf die
  444.       Nummerierung.
  445.  
  446.       Wozu soll das gut sein ?
  447.       Nun, wenn Du ein HPFS-Dateisystem benutzt und die Listen NUR lokal
  448.       benutzen willst, kannst Du die Referenzierung der Einzellisten auch
  449.       mit dem Gruppennamen machen. Für HPFS ist eine Datei GFD.APP.XYZ.HTM ja
  450.       kein Problem. Anders sieht das aber aus, wenn Du die Listen verteilen
  451.       willst. In diesem Fall ist es besser, die Referenz mit z.B. LISTE##.HTM
  452.       zu machen. ## ist dabei die Nummer der Gruppe.
  453.  
  454.  
  455.  
  456.       @HTML
  457.       ─────
  458.       Syntax:     @Html(@ID)
  459.       Templates:  Alle
  460.  
  461.       Dieses Token konvertiert @ID gemäss HTML-Spezifikationen.
  462.       Die Umlaute ä, ö, ü, Ä, Ö, Ü, ß sowie <, >, & und " werden umgewandelt.
  463.  
  464.       Diese Token muss benutzt werden, um Listentitel, Gruppen- und Area-
  465.       beschreibungen gemäss HTML-Spezifikation zu wandeln.
  466.  
  467.  
  468.  
  469.       @FLAGS
  470.       ──────
  471.       Syntax:     @Flags()
  472.       Template:   BBS und HTML-Template (innerhalb der @Format-Anweisung)
  473.  
  474.       Diese Token liefert das in der Konfig definierte Zeichen für das Alter
  475.       einer Datei. Die Anwendung erfolgt innerhalb der @Format Anweisung in
  476.       Verbindung mit @TEST.
  477.  
  478.       Beispiel:
  479.         <font color="@Test(@Flags(),=,*,"#00ff00",\
  480.                      @Test(@Flags(),=,+,"#dddd00","#ffcccc"))">\
  481.           @FileName\
  482.         </font>\
  483.  
  484.         Hier wird in Abhängigkeit vom Alter der Datei, die Farbe des Datei-
  485.         namens verändert.
  486.  
  487.       Hinweis:
  488.         Die leere Klammer nach dem Token MUSS gesetzt werden !
  489.  
  490.  
  491.  
  492.       @MAP
  493.       ────
  494.       Syntax:     @Map(@ID)
  495.       Templates:  Alle
  496.  
  497.       Wenn in der Konfiguration (MaxList.cfg) unter "MapPath" eine Angabe
  498.       gemacht ist UND diese in @ID enthalten ist, wird der entsprechende
  499.       Teil von @ID ausgetauscht.
  500.  
  501.       Beispiel:
  502.         CONFIG:     MAPPATH   "H:", "\\mailbox\drive_h"
  503.         TEMPLATE:   @MAP(@FILEBBS(LOCASE))
  504.  
  505.         Wir nehmen an, @FileBbs liefert "H:\TOOLS\FILES.HTM". Nach dem
  506.         Mappen wird daraus "\\mailbox\drive_h\tools\files.htm"
  507.  
  508.       Beachte, das der "Mapstring" ohne jegliche Änderung übernommen wird !
  509.  
  510.  
  511.  
  512.       @SPLIT
  513.       ──────
  514.       Syntax:     @Split(@ID, Drive, Path, Name, Ext)
  515.       Templates:  Alle
  516.  
  517.       Mit @Split kann ein Pfad oder Pfad und Dateiname in die einzelnen
  518.       Bestandteile "Laufwerk", "Pfad", "Dateiname" und "Dateierweiterung"
  519.       zerlegt werden. Das Token liefert NUR die Parameter, die angeben werden.
  520.  
  521.       Bei Drive, Path, Name und Ext reicht es den ersten Buchstaben anzugeben,
  522.       also D, P, N und E. @ID kann eine beliebige Pfadangabe sein.
  523.  
  524.       Beispiel:
  525.         @Split(D:\TOOLS\DATEI.DOC, D, , N)      liefert   "D:DATEI"
  526.         @Split(D:\TOOLS\DATEI.DOC,  , , N, E)   liefert   "DATEI.DOC"
  527.         @Split(D:\TOOLS\DATEI.DOC,  , P)        liefert   "\TOOLS\"
  528.         @Split(D:\TOOLS\DATEI.DOC, D, P)        liefert   "D:\TOOLS\"
  529.  
  530.       Hinweise:
  531.         Als Extension wird der Teil das Namens geliefert der nach dem LETZTEN
  532.         Punkt steht, z.B. bei "EIN.NAM.EXT" ist das Extension ".EXT" !!
  533.         Als Pfadtrenner kann ein Backslash (\) oder Slash (/) angegeben werden.
  534.  
  535.         Beachte: SPLIT arbeitet GENAU wie das OS/2 äquivalent, auch wenn Du
  536.         die DOS-Version von MaxList benutzt!
  537.  
  538.  
  539.  
  540.       @UNIXSTYLE
  541.       ──────────
  542.       Syntax:     @UnixStyle(@ID [, LOCASE])
  543.       Templates:  Alle
  544.  
  545.       Dieses Token konvertiert Backslash-Zeichen (\) in @ID nach Slash (/).
  546.       Wenn Du Pfade in HTML-Referenzen hast, musst Du dieses Token benutzen.
  547.  
  548.       Beispiel:
  549.         @UnixStyle(D:\PATH\XYZ.HTM, LOCASE)    liefert     "d:/path/xyz.htm"
  550.  
  551.       Ist als zweiter Parameter LOCASE angegeben, wird der ganze String in
  552.       Kleinbuchstaben umgewandelt.
  553.  
  554.  
  555.          ┌──────────────────────────────────────────────────┐
  556.    ──────┤ Sonstige allgemeine Änderungen und Erweiterungen ├─────────────────
  557.          └──────────────────────────────────────────────────┘
  558.  
  559.      Nachfolgende Änderungen und Erweiterungen sind allgemein gültig, also
  560.      auch für die 'normalen' Filelisten und Templates.
  561.  
  562.  
  563.       + In den Templates können nun auch Kommentare benutzt werden.
  564.         Eine Kommentarzeile beginnt mit immer mit @@ (2 Klammeraffen).
  565.         Alle nachfolgenden Zeichen (einschliesslich der CrLf) werden bereits
  566.         bei Laden des Templates entfernt.
  567.  
  568.         Beispiel:
  569.           @@ Das ist ein Kommentar
  570.  
  571.  
  572.       + Der Backslash (\) kann nun auch am Zeilenanfang stehen. So können
  573.         Leerzeilen entfernt werden. In nachfolgendem Beispiel werden die
  574.         Leerzeilen vor und nach '<body ...>' nicht ausgegeben:
  575.  
  576.           <head>\
  577.            <title>\
  578.             Dateiliste @Areaname\
  579.            </title>\
  580.           </head>
  581.           \
  582.           <body bgcolor="#000000" text="#ffffff">
  583.           \
  584.             ... more html stuff\
  585.           \
  586.           </body>
  587.  
  588.  
  589.       + Bei DEBUGG  Yes werden keine Listen archiviert und keine EXECUTE
  590.         Befehle ausgeführt.
  591.  
  592.  
  593.       + Der Kommandozeilenparameter /R[=Area[..Area]] wurde hinzugefügt.
  594.         Der Befehl ist identisch mit /I, jedoch wird nur dann versucht eine
  595.         FILE_ID.DIZ zu importieren, wenn die Beschreibung den String enthält,
  596.         der unter 'NoDescription' definiert ist.
  597.  
  598.  
  599.       + In der Archiver-Konfig kann der Parameter %P benutzt werden.
  600.         %P wird durch Laufwerk und Pfad des MaxList-Verzeichnisses ersetzt,
  601.         z.B. D:\MAXLIST\
  602.  
  603.         Um z.B. in Zip-Archiven auch FILE_ID.DIZ zu finden, die in einem
  604.         Unterverzeichnis stehen, kann folgender Eintrag in der Archiver-CFG
  605.         erfolgen:   OS2 Extract     Unzip -ojC %a *%f -d %p
  606.  
  607.  
  608.       + Einige kleineren Bugs und Schwächen (Dupecheck, Announce-Listen,
  609.         MSG-ID und Formatroutine) von MaxList v2.26 wurden beseitigt.
  610.  
  611.  
  612.  
  613.    Schlusswort:
  614.    ════════════
  615.      Alle Tippfehler sind geistiges Eigentum des Verfassers, unterliegen dem
  616.      Urherberrecht und dürfen somit nicht wiederverwand werden ;-))
  617.  
  618.    ───────────────────────────────────────────────────────────────────────────
  619.    [EOF] NEWS230.DOC                              Hattingen, im September 1997
  620.    ───────────────────────────────────────────────────────────────────────────
  621.  
  622.