CD2HTMLs eigene TagsNun endlich zu den CD2HTML- Tags. Es ist vollkommen egal, ob die Tags gross oder klein geschrieben werden. Wichtig ist, dass sie mit '<%' anfangen und mit '%>' enden. Leerzeichen sind, bis auf einige Ausnahmen, nicht erlaubt. Bei Fehlern gibt CD2HTML eine Fehlermeldung in der erzeugten HTML- Seite aus.
Dieses Tag erzeugt einen neuen Link im Index- Tag. Die Verwendung des Anchor- Tags ohne dem Index- Tag macht keinen Sinn. Dort, wo das Anchor- Tag steht, kann vom Index aus hingesprungen werden.
Das Author- Tag gibt eine Info über CD2HTML und dessen Autor aus. Um die Verbreitung des Programms zu erhöhen, bitte ich Sie, dieses Tag auf jeder Seite einzubinden bzw. eingebunden zu lassen.
Das Date- Tag gibt das Datum der letzten Änderung eines Eintrags aus.
Das Description- Tag (dt. Beschreibung) gibt die Dateibeschreibung, sofern vorhanden, aus. Woher die Beschreibung gewonnen wird, kann
im Optionen- Dialog unter Suchen II festgelegt werden (z.B. aus file_id.diz, Dateiname.txt oder files.bbs). Jede Zeile der
Beschreibung wird durch einen harten Zeilenumbruch abgeschlossen (<br>). In der Regel sieht das einfach besser aus.
Dieses Tag gibt im VALUES- Bereich das Verzeichnis, auf den sich die Werte beziehen, wieder oder im HEADLINES- Bereich das aktuelle Verzeichnis. Für das Verzeichnis c:\Bilder\Urlaub Spanien 2000 würde Urlaub Spanien 2000 zurückgeliefert werden.
Gibt die Größe des aktuellen Verzeichnisses zurück. Dabei werden die Werte, wie in Optionen| Allgemein festgelegt formatiert. Die 10er Potenzen werden für das Binärsystem korrekt umgerechnet, also 1 MB = 1024 KB = 1048576 Bytes.
Gibt die komplette Anzahl aller gefundenen Verzeichnisse zurück.
Gibt die komplette Anzahl aller gefundenen Unterverzeichnisse im aktuellen Verzeichnis zurück.
<%dltime14.4k%>, <%dltime28.8k%>, <%dltime64k%>, <%dltime56k%>
Diese Tags geben die Downloadzeit in Minuten einer Datei/ eines Verzeichnisses bei verschiedenen Bandbreiten wieder.
Die Werte hinter dltime stehen für Modems mit 14400 bps und 28800 bps (bps = Bits pro Sekunde), ISDN- Adaptern
mit 64000 bps (56K in USA) oder für eine 2MBit- Festverbindung.
Verlinkt die aktuelle Bilddatei direkt ind die ausgegebene HTML- Datei. Sinnvoll für Übersichten von animierten GIF- Bildern.
Gibt die Anzahl der enthaltenen Dateien des aktuellen Verzeichnisses zurück.
Gibt die komplette Anzahl aller gefundenen Dateien zurück.
Gibt den Dateipfad der aktuellen Datei relativ zum aktuell erzeugten HTML- Dokument an. Mit diesem Tag können eigene Links erzeugt werden (z.B. <a href="<%filepath%>" target="_top"><%name%></a>). Ein anderes Beispiel zeigt die Einbindung einer JavaScript- Routine zum Anzeigen des Bildes per Pop- Up- Fenster. Man kann dazu den folgenden Code nutzen (vorausgesetzt, die JavaScript- Routine showbigimage existiert auch): <a href="javascript:showbigimage('<%filepath%>',<%picxres%>,<%picyres%>, '<%piccomment%>')"><%picture 200x150%></a> Das Beispiel finden Sie im Template pictures - pop-up windows.html im Unterverzeichnis templates im CD2HTML- Verzeichnis.
Per <%include%> kann eine Datei in die aktuelle HTML- Datei ausgegeben werden. Die Include- Datei wird dabei
im Zielverzeichnis (dort wo die HTML- Datei hingespeichert wird) oder als absoluter Pfad erwartet
(z.B. <%INCLUDE d:\html\header.html%>, <%INCLUDE header.html%>). Verwalten Sie mit CD2HTML
mehrere Templates, die immer den gleichen Kopfteil haben sollen, brauchen Sie diesen nur einmal abzuspeichern und zu pflegen.
Dieses Tag erzeugt eine Liste von Links zu allen Vorkommen des Anchor- Tags (also unbedingt auch dort schauen). Verzweigungen können nur innerhalb einer HTML- Seite erzeugt werden. Die einzelnen Links werden durch Komma getrennt (siehe auch indexli und indexbr).
Das <%indexli%>- Tag ist identisch mit dem <%index%>- Tag, mit dem kleinen Unterschied, dass jedem Link ein <li> vorangestellt wird. Es sollte also gemeinsam mit <ol> oder <ul> verwendet werden (z.B. <ul> <%indexli%> </ul>). Siehe auch index und indexbr.
Das <%indexbr%>- Tag ist identisch mit dem <%index%>- Tag, mit dem kleinen Unterschied, dass jedem Link ein <br> angestellt wird. Siehe auch index und indexli.
Liefert Anzeigetext zurück, falls es sich beim aktuellen Eintrag um ein Verzeichnis handelt. Damit kann man zum Beispiel Verzeichnisse im Gegensatz zu Dateien fett ausgeben oder einen Text ausgeben (z.B. <%is_dir <DIR>%> gibt <DIR> zurück, falls es sich aktuell um ein Verzeichnis handelt).
Der Gegenpart zu <%is_dir Anzeigetext%>.
Gibt die komplette Anzahl aller gefundenen Dateien und Verzeichnisse zurück und ist damit die Summe aus <%dircountabs%> und <%filecountabs%>.
Gibt die komplette Anzahl aller gefundenen Dateien und Unterverzeichnisse im aktuellen Verzeichnis zurück und ist damit die Summe aus <%dircount%> und <%filecount%>.
Diese Tag gibt das Systemdatum zurück.
Gibt einen Link zur übergeordneten HTML- Seite wieder, falls CD2HTML für jedes Verzeichnis eine HTML- Seite
schreiben soll. Der Anzeigetext ist der Anzeigetext, auf den man dann klicken kann. Alternativ kann der
Link auch selbst mit dem <%parentpath%>- Tag gestaltet werden.
Dieses Tag gibt die Systemzeit zurück.
Dieses Tag erzeugt einen Link zur aktuellen Datei/ zum aktuellen Verzeichnis. Befindet sich die Datei im selben Pfad wie die erzeugte HTML- Datei, so wird ein relativer Pfad verwendet (zu empfehlen, da laufwerksunabhängig), ansonsten wird ein absoluter Pfad verwendet (mit Laufwerksbuchstaben, nicht anders möglich). Der angezeigte Linktext ist der Datei-/ Verzeichnisname.
Das Links- Tag schreibt Links zu allen Dateien, wie Sie nach den Spezifikationen im Optionen- Dialog Optionen| Suchen II gefunden wurden. So können Links zu sinnvollen Dateien in einem Verzeichnis, wie es etwa *.txt- oder index.html- Dateien sind, erzeugt werden. Welche Dateien CD2HTML gefunden hat, kann auch durch einen Doppelklick auf ein Verzeichnis in der Listenansicht des Hauptfensters herausgefunden werden. Es wird beim Schreiben der Links versucht, relative Pfade zu verwenden. Wenn der Index aber auf einem anderen Laufwerk, als das, auf welchem sich die durchsuchten Dateien/Verzeichnisse befinden, gespeichert wird, können nur absolute Pfade, die den Laufwerksbuchstaben enthalten, geschrieben werden. Damit ist der Index nicht mehr für das Brennen auf eine CD-ROM oder das Publizieren im Internet geeignet.
<%mp3title%>, <%mp3artist%>, <%mp3album%>, <%mp3year%>, <%mp3comment%>, <%mp3genre%> tags: Diese Tags versorgen Sie mit allen nötigen Informationen, die dem ID3- Tag Version 1.0 entnommen werden können. Das ID3- Tag befindet sich am Ende vieler MP3- Dateien und gibt detaillierte Informationen zu dem entsprechenden Musikstück, ist aber kein Muss. Sollten bei einigen MP3- Dateien keine ID3- Informationen verfügbar sein (weil kein ID3- Tag vorhanden ist), so können Sie diese durch einen Doppelklick auf MP3- Dateien in der Listenansicht des Hauptfensters einsehen und ändern.
<%mp3original%>, <%mp3copyright%>, <%mp3samplerate%>, <%mp3durationmin%>, <%mp3durationsec%>, <%mp3mode%>, <%mp3layer%>, <%mp3version%>, <%mp3bitrate%> Diese Tags geben Ihnen die volle Bandbreite der MP3- Header- Informationen. Alles, was im Kopf einer MP3- Datei gelesen werden kann, steht Ihnen mit diesen Tags zur Verfügung, so die Länge des Stücks (in Min. und Sek.), der Kodiertyp, die Bitrate, Das Original- Flag (yes|no), Copyright- Bit (yes|no), Layer ('Unknown', 'I', 'II', 'III'), Modus (Stereo, Joint-Stereo, Dual-channel, Single-Channel) und die MP3- Version ('Unknown', '1.0', '2.0', '2.5').
Dieses Tag liefert den Namen der aktuellen Datei oder des aktuellen Verzeichnisses.
<%oddeven odd="..." even="..."%>
Dieses Tag kann unterschiedliche Texte für gerade und ungerade Zeilen ausgeben. Die
Texte für gerade Zeilen (engl. even) und ungerade Zeilen (engl. odd) werden in den
Anführungsstrichen angegeben.
Dieses Tag entspricht dem <%description%>- Tag, nur dass es lediglich die erste Zeile einer Dateibeschreibung ausgibt. Damit kann man sicher gehen, dass nicht zu viele Informationen die erzeugte HTML- Seite "vermüllen" (die erste Zeile einer Dateibeschreibung enthält meistens auch die wichtigste Information). Wurde keine Dateibeschreibung gefunden, so gibt CD2HTML lediglich ein Leerzeichen ( ) aus. Bei Bildern wird die Auflösung und bei MP3- Dateien werden verschiedene andere Parameter ausgegeben.
Falls CD2HTML nur eine begrenzte Anzahl von Zeilen pro Seite ausgeben soll (siehe Optionen|HTML I|Modus 2), so gibt dieses Tag die Seitennummer der letzten Seite aus. Siehe auch <%thispage%> (Seitennummer der aktuellen Seite).
Gibt den Pfad zur übergeordneten HTML- Seite wieder, falls CD2HTML für jedes Verzeichnis eine HTML- Seite
schreiben soll. Ähnlich wie <%linkparent Anzeigetext%>, nur dass hier
der Link selbst gestaltet werden kann.
Gibt den Pfad der aktuellen Datei/des aktuellen Verzeichnisses relativ zum Pfad des durchsuchten Verzeichnisses an (z.B. wird das Verzeichnis c:\eigene dateien\eigene bilder\ durchsucht, so wird \Urlaub 2000\Serie 1 beim Verzeichnis Serie 1 zurückgeliefert).
Das Picture- Tag erstellt ein GIF- Bild vom Icon der aktuellen Datei/ des aktuellen Verzeichnisses oder, falls es sich bei der Datei um ein Bild handelt (momentan werden die Formate GIF, JPEG und PNG unterstützt), eine verkleinerte Ansicht des Bildes (engl. Thumbnail). Die Bilder werden normalerweise im Verzeichnis pics, welches im selben Verzeichnis wie die erzeugte HTML- Datei erzeugt wird, gespeichert. Die Bilder erhalten ausserdem eine Vorsilbe, so dass sie sofort als Vorschaubilder zu erkennen sind (i.d.R. tn_). Beide letztgenannten Parameter können in den Optionen geändert werden. Bilder gleichen Inhalts, wie sie z.B. bei Icons von Verzeichnissen die Regel sind, werden nur einmal erzeugt und mehrfach verwendet. Die Größe des Vorschaubildes kann ebenfalls im Optionen- Dialog festgelegt werden. Der Wert im Optionen- Dialog kann aber durch eine zusätzliche Angabe im Picture- Tag überschrieben werden (z.B. <%picture [300x400]%>). Dadurch kann auch die Größenbeschränkung im Optionen- Dialog von 140 x 140 Punkten umgangen werden. Das Seitenverhältnis wird in jedem Fall beibehalten. Zurückgeliefert wird der HTML- Code zum Einbinden des Vorschaubildes inklusive der Höhen- und Breitenangaben. Das ALT- Tag wird mit dem Dateinamen des Bildes belegt und das BORDER- Tag auf Null gesetzt.
<%picturelink [widthxheight]%> Diese Tag ist mit dem <%picture%>- Tag identisch, nur dass es zusätzlich noch einen Link zur Originaldatei/dem Originalbild mit zurückliefert.
Diese Tag ist mit dem <%picture%>- Tag identisch, nur dass es lediglich den Dateipfad zum Vorschaubild oder Icon zurückliefert. So hat man die maximale Freiheit beim Gestalten einer Webseite.
<%picxres%>, <%picyres%>, <%picdepth%>, <%pictype%>, <%piccomment%> tags: Diese Tags geben die gleichnamigen Informationen über Bilddateien zurück (X- und Y- Auflösung, Farbtiefe, Bildtyp, Beschreibungstext).
Falls CD2HTML nur eine begrenzte Anzahl von Zeilen pro Seite ausgeben soll (siehe Optionen|HTML I|Modus 2), so erhalten Sie mit diesem Tag eine Navigation für die erzeugten Seiten. Siehe auch <%prevnextsimple%>.
Falls CD2HTML nur eine begrenzte Anzahl von Zeilen pro Seite ausgeben soll (siehe Optionen|HTML I|Modus 2), so erhalten Sie mit diesem Tag eine Navigation zur jeweils vorigen/nächsten Seite. Siehe auch <%prevnextlist%>.
<%REPEAT=x%> ... <%ENDREPEAT%> tags: Normalerweise wird der VALUES- Bereich bei jedem Eintrag einmal komplett durchschritten. Damit ist es aber nicht möglich eine bestimmte Anzahl von Einträgen in einer Tabellenzeile auszugeben (entweder einen oder alle, je nachdem, ob Sie das <th>- Tag in den VALUES- Bereich reinnehmen oder in den HEADLINES- Bereich). Mit den <%REPEAT=x%> ... <%ENDREPEAT%>- Tags können Sie dieses Problem umgehen. Schauen Sie sich bitte folgendes Beispiel an:
<tr> <%repeat=5%> <td> <%picturelink%> <br> <%name%> <br> <%picxres%>x<%picyres%>x<%picdepth%> [<%size%>] </td> <%endrepeat%> </tr> Es werden jeweils 5 Vorschaubilder mit Dateinamen, Bildauflösung und Dateigröße in einer Tabellenzeile ausgegeben. Durch den Wert hinter repeat kann die Anzahl der Schleifendurchläufe geändert werden.
Das Root- Tag (engl. für Wurzel) gibt den Namen des Verzeichnisses, welches sich in oberster Ebene des Suchbaums befindet, zurück (wenn z.B. das Verzeichnis c:\eigene dateien durchsucht wird, würde eigene dateien zurückgegeben werden). Damit ist es ein guter Ersatz des title- Tags.
Das Size- Tag (engl. Größe) liefert die Größe der aktuellen Datei/des aktuellen Verzeichnisses zurück. Das Format kann im Optionen- Dialog unter Allgemeines verändert werden. Siehe auch dirsize.
Falls CD2HTML nur eine begrenzte Anzahl von Zeilen pro Seite ausgeben soll (siehe Optionen|HTML I|Modus 2), so gibt dieses Tag die Seitennummer der aktuellen Seite aus. Siehe auch <%pages%> (Seitennummer der letzten Seite).
Liefert den Titel der aktuellen Suche zurück. Der Titel kann im Optionen- Dialog unter Allgemeines verändert werden.
Das Totalsize- Tag (engl. Gesamtgröße) liefert die Gesamtgröße aller Dateien der kompletten Suche zurück. Das Format kann im Optionen- Dialog unter Allgemeines verändert werden.
|