Dokumentation | 
Funktionen für Fortgeschrittene
Arachnophilia 5.3 © Copyright 2006, P. Lutus.
Arachnophilia ist CareWare (Englische Webseite)

Übersetzt ins Deutsche von Wolfram Strempfer

Diese Seite beschreibt einige Funktionen, die den Arachnophilia Power-User interessieren dürften -- wie man größeren Einfluss auf den FTP-Service ausübt, wie man die Arachnophilia Systemkommandos auflistet und benutzt, und ein paar andere Dinge mehr.
Seitenvorschau für Seiten, die Server-Ressourcen benötigen
  • Übersicht

    PHP- und ASP-Seiten sind spezielle Webseiten, die von einem Server verarbeitet werden, bevor sie an den Browser des Besuchers weitergegeben werden. Wenn Sie einen Server auf Ihrem Entwicklungsrechner laufen haben, können Sie mit Arachnophilia auch solche Webseiten interaktiv ansehen.

  • Wie geht das?

    Während der Vorschau behandelt Arachnophilia die Dateitypen PHP und ASP auf eine besondere Art. Ihnen wird eine spezielle Aufruf-Zeichenkette zugewiesen, die dafür sorgt, dass sie von Ihrem lokalen Webserver verarbeitet werden. Diese Zeichenkette kann von Ihnen im Browser-Konfigurationsdialog verändert werden (in HTML... Browser-Einstellungen)

    Vielleicht möchten Sie diese speziellen Seiten in Ihrem Standard-HTML-Verzeichnis speichern, dann müssen Sie nur den Namen Ihres Servers in den Initialisierungs-String eintragen; etwa so:

    http://ihr-server-name/$1

    Denken Sie daran, dass an diesen Init-String ein einfacher Dateiname angehängt wird (und kein Verzeichnisname), und zwar genau dort, wo das "$1" steht. Das bedeutet, wenn Sie in einem Unterverzeichnis des Verzeichnisbaums Ihrer Website arbeiten, müssen Sie diese zusätzliche Pfadinformation mit angeben, oder aber Sie richten in Ihrer Serversoftware einen Verweis ein und geben diesen stattdessen an. Im Gegensatz zur Arbeit mit normalen HTML-Seiten und dem Benutzen von Pfadangaben müssen Sie deshalb den Zusammenhang zwischen vollständigen Dateipfaden und seiten-relativen Pfadangaben innerhalb Ihres Servers herauskriegen -- Arachnophilia kann Ihnen dabei leider nicht helfen.

    Um das alles zu verdeutlichen, machen wir jetzt ein Beispiel. Wenn Sie in einem Verzeichnis arbeiten, das "php" heißt, welches ein Unterverzeichnis des "Dokumenten-Wurzelverzeichnisses" Ihres Servers ist, würden Sie eingeben:

    http://server-name/php/$1

    Noch etwas ist wichtig: wenn Sie eine Server-verarbeitete Seite entwerfen, die sich selbst immer wieder aufruft, gibt es keinen anderen Weg als die Seite zu speichern und den "Neu-Laden"-Knopf Ihres Browsers anzuklicken. Das ist deshalb so, weil die Benutzung einer temporären Datei nicht funktionieren würde (und Arachnophilia normalerweise genau so Vorschau-Dateien erzeugt).

  • Ein einfacher PHP-Test

    Wenn Sie Ihren lokalen Webserver fertig eingerichtet haben, erstellen Sie eine neue PHP-Seite und bauen Sie folgende Zeile ein (zwischen die <body> und </body>-Tags:)

    <?php phpinfo() ?>

    Verändern Sie den Server-Init-String wie oben erklärt und klicken Sie auf den Vorschau-Button. Wenn Sie Ihren Server richig eingerichtet haben, werden Sie eine etwas längliche Übersicht über die momentan aktiven PHP-Merkmale sehen.

Die Arachnophilia Makro-Architektur
  • Übersicht

    Die Makroliste links im Arachnophilia Hauptfenster ist eigentlich so etwas wie eine Telefon-Schalttafel, die Menüeinträge, Werkzeugleisten-Knöpfe und Tastenkürzel mit bestimmten Arachnophilia-Befehlen verbindet (oder auch mit vom Benutzer eingegeben Text). Die Arachnophilia Befehlsliste ist ziemlich lang, und nicht alle Befehle besitzen im Auslieferungszustand auch einen eigenen Menüeintrag oder einen Werkzeugleistenknopf.

    Sie können sich eine Liste von allen Befehlen anschauen, indem Sie den Menüpunkt Werkzeuge ... System-Befehle auflisten verwenden. Dies ist eine sehr wichtige Liste -- merken Sie sich, wo sie sich befindet und schauen Sie sie sich öfters einmal an.. Einige der weniger oft benutzten Befehle sind nur in der Liste beschrieben und nirgendwo sonst. Und jeder einzelne Befehl kann in den Makros, die Sie schreiben, verwendet werden.

  • Befehlsargumente

    Einige der Arachnophilia-Befehle akzeptieren Zusätze oder Argumente, die es dem Benutzer erlauben, mächtige, genau zugeschnittene Befehle zu erstellen. Ein Beispiel wäre:

    [FindReplaceAll:/Katze/Hund/]
    (Sucht nach "Katze" und ersetzt das Wort, falls gefunden, durch "Hund")

    Diese Art von Makro macht es also unnötig, Suchtext und zu ersetzenden Text von Hand einzugeben.

    Kurz gesagt gibt es viele mächtige Kommandos in der Liste, die sonst nirgends auftauchen. Es ist eine sehr gute Idee, sich diese Liste einmal (oder auch mehrmals!) anzuschauen, bevor Sie nach einer Funktion fragen, die es vielleicht schon längst gibt! .

FTP-Operationen für Fortgeschrittene
  • Bestimmung des Dateityps

    Manche Betriebssysteme müssen zwischen Text- und Binärdateien unterscheiden, um die Zeilenenden richtig behandeln zu können. FTP-Programme führen deshalb im Normalfall eine Liste von Dateiendungen und der entsprechenden Dateitypen. In Arachnophilia befindet sich diese Liste innerhalb der Dateitypen-Konfigurationsdatei.

    Die Dateitypen-Konfigurationsdatei befindet sich in

    (Benutzerverzeichnis)/.Arachnophilia/FileData.txt


    Diese Datei ist selbsterklärend und enthält einen Datensatz für jeden Dateityp. Für jeden einzelnen Datensatz wird zwischen Binär- und Textdatei unterschieden.

    Um, sagen wir einmal die Dateiendung "xyz" hinzuzufügen, müssen Sie sie nur zu einem bestehenden Textdateityp hinzufügen (Änderungen sind hier rot markiert ):

    Text|t|-|txt,text,doc,bat,log,tbd ,xyz ; text files


    Oder, wenn Sie einen neuen Dateityp anlegen wollen, der die Endungen für Textdateien enthält, dann könnte das so aussehen:

    TextFileSuffixes|t||abc,def,ghi,jkl ; text file types for FTP


    Seit dem Build 1860 nimmt der FTP-Service standardmäßig Binärdaten an, aber um die Entscheidung festzulegen, schaut er in dieser Konfigurationsdatei nach, ob die Datei mit der momentan vorhandenen Endung nicht als Textdatei behandelt werden soll.

  • Fehlersuche bei FTP-Aktionen

    Der FTP-Service hat eine Funktion zur Suche von Fehlern, die von dem Schieberegler unten im FTP-Dialog beeinflusst wird. Damit Sie mehr Meldungen zur Fehlersuche sehen, schieben Sie den Regler nach rechts und starten den Datenaustausch. Jede Raste weiter nach rechts vergrößert die Anzahl der angezeigten Meldungen.

    Ich erhalte viele "Fehlermeldungen" von Benutzern, die einfach nur sagen "Die FTP-Aktion hat einfach aufgehört." Alle Benutzer sollten sich zuerst einmal die Meldungen zur Fehlersuche ansehen, damit sie feststellen kö nnen, was denn genau passiert ist.

  • Zielverzeichnis

    Die Server verhalten sich sehr unterschiedlich, was die Angabe des Zielverzeichnisses angeht. Manche Systeme verlangen, dass der Pfad mit einem Schrägstrich anfängt ("/"), manche funktionieren damit wiederum nicht, wieder anderen ist das vollkommen egal. Dieses Problem tritt leider sehr häufig auf.

    Ein Beispiel — sagen wir, Sie haben eine WebSite mit einem Zielverzeichnis namens "WebPages". Je nach Betriebssystem auf dem Server müssen Sie also einen dieser Einträge als Zielverzeichnis angeben:

    /home/username/WebPages
    /WebPages
    ~/WebPages
    /


    Was davon jetzt richtig ist, können Sie am Einfachsten herausfinden, indem Sie bei Ihrem Provider nachfragen; das Lesen der Meldungen zur Fehlersuche wird Ihnen aber in jedem Fall helfen, da sich die Gegenseite in der Regel beschwert, wenn der Eintrag falsch ist. Geben Sie nie ein Verzeichnis an, ohne einen vorangestellten Schrägstrich "/" oder eine Tilde "~" ein; das ist immer falsch.

    Wenn Sie die oben beschriebene Möglichkeit zum Finden von Fehlern nicht nutzen, werden Sie vielleicht nie erfahren, warum die Übertragung nicht geklappt hat .

HTML-Verschönerung
Die HTML-Verschönerung (Sie finden sie im HTML-Menü) rückt Ihren HTML-Quellcode genau so ein, wie es auch die Verschönerer für (Programm-)Quellcode tun. Wenn Ihre Seite in altem HTML geschrieben ist, können aber Probleme auftauchen, die Sie nicht von den Quellcode-Verschönerern kennen. Die allermeisten Probleme werden durch inkonsistente HTML-Syntax verursacht — manche Tags haben ein abschließenes Gegenstück, manche auch nicht. Und einige haben nur manchmal ein abschließendes Gegenstück, aber nicht immer - und beides ist erlaubt. Ein Beispiel hierfür:
Mein Abschnitt<p> (erlaubt)

<p align=left>Mein Abschnitt</p> (auch erlaubt)

Weil in HTML beide Formen erlaubt sind, und weil es viele dieser erlaubten Beispiele gibt, gibt es keine sinnvolle Möglichkeit, einen zuverlässigen und stabilen HTML-Verschönerer zu schreiben - das habe ich leider erst viel zu spät begriffen. Diese Probleme gibt es aber mit der Einführung von XHTML nicht mehr; das war auch der Hauptgrund, die aktuellen Arachnophilia-Versionen zu schreiben.

Die letzte Arachnophilia-Version (4.0) besaß einen sehr anspruchsvollen Verschönerer, der sogar versuchte, den Code nach der HTML-Syntax zu verbessern. Wegen der angesprochenen Inkonsistenzen in HTML, wurden zunächst beide Funktionen (Verschönern und Validieren) etwas stiefmütterlich behandelt, und eine Funktion wurde sogar komplett aufgegeben. In den aktuellen Arachnophilia-Versionen (Version 5.3 und neuer) konnten beide Funktionen wieder eingebaut werden, weil XHTML in sich konsistent ist. Beide Funktionen können getrennt voneinander aufgerufen werden und werden ganz genau so arbeiten, wie Sie sich das wünschen — wenn Ihre Seite den gültigen XHTML-Regeln entspricht.

Wenn Sie Ihre Seiten so behalten wollen, wie sie sind (also nicht zu XHTML konvertieren wollen), aber trotzdem alle Arachnophilia-Funktionen benutzen wollen, machen Sie bitte folgende Änderungen:
  • Stellen Sie sicher, dass jedes Tag in Ihrer Seite einen schließenden Partner hat:
    <auf>Inhalt</zu>
    oder sich selbst abschließt:
    <selbstschließendes Tag/>
  • Beispiele für Tags, die eigentlich schließende Partner haben sollten, aber in früheren Arachnophilia-Versionen leider nicht hatten, sind <li></li> und <option></option>.
  • Beispiele für Tags, die <selbst-schließend/> gemacht werden sollten, sind <img ... />, <input ... />, <frame .../>, <meta ... /> und nochmal ein halbes Dutzend weitere Tags. Es geht also schlicht darum, dass es niemals ein Tag geben sollte, dem <entweder> ein </Partner> fehlt oder die spezielle <selbst-schließende/> Syntax.
  • Wenn Sie diesem System folgen, können Sie Ihre Webseiten mit kleinem Aufwand aktualisieren; nebenbei werden Ihre Seiten auch noch annehmbarer fü Browser und auch für Arachnophilia.
An dieser Stelle kommt jetzt sowas wie eine Anmerkung der Redaktion. Ich empfehle Ihnen dringend, Ihre Seiten nach XHTML zu konvertieren. Dieser Wechsel erlaubt deutlich größere Kontrollmöglichkeiten für die Seitendarstellung und den Inhalt und verhindert letztlich auch die Aufgabe von Seiten, die nicht in sich selbst konsistent sind.

Über die Jahre habe ich einige Energie in den Versuch gesteckt, das Erstellen von Webseiten zu automatisieren. Arachnophilia verköpert einige der Schritte in diese Richtung (obwohl das Schreiben von Skripten der grundlegendere Ansatz zur Automatisierung ist). Im Falle der alten HTML-Seiten ist es recht schwer, etwas zu automatisieren, weil man nicht davon ausgehen kann, dass der Seiteninhalt konsistenten Regeln folgt. XHTML wurde ins Leben gerufen, um die krassen Mängel von HTML auszubügeln, und Arachnophilia orientiert sich nun an XHTML — so weit sogar, dass manche der erweiterten Funktionen nicht mehr mit HTML funktionieren.

 

Dokumentation |