Kommentare

Ein Kommentar beginnt mit # in der Zeile und wird nicht beachtet.

    # das ist ein Kommentar

Variablen und Macros

Variablen werden nicht explizit definiert. Ihr Name muss allerdings mit einem Dollarzeichen beginnen. Eine Variable kann entweder global, damit von jedem Makro benutzt werden, oder lokal innerhalb eines Makros. Bevor eine Variable benutzt in einem Ausdruck verwendet werden kann, muss ihr ein Wert zugewiesen werden. "Integer" Werte und "strings" Zeichen können benutzt werden.

    $x = 0;
    $y = "A text string";

Falls nötig, wird eine Variable automatisch von Integer in String (und umgekehrt) umgewandelt.

    $x = 1 + "2";
    $y = "Der Wert von x ist " . x;

Die Strings "true" und "false" werden als "boolean" Werte erkannt und können in bedingten Anweisungen benuztzt werden.

    $z = "false";
    $z ? $x = 1 : $x = 0;               $x = 0
    $z = "true";
    $z ? $x = 1 : $x = 0;               $x = 1

Die Definition eines Makros beginnt mit "macro" gefolgt von einigen Aussagen. Eine zusätzliche Anweisung in einem string-Ausdruck ist 'menu' um Text anzuzeigen, wenn das Makros im Menu vorkommen.

    example {
        menu = "Menu text";
        $x = 0;
    }

Ausdrücke

Es gibt die folgenden Operatoren:

  +     addition         $x = 7 + 3;         10
  -     subtraction      $x = 7 - 3;         4
  *     multiplication   $x = 7 * 3;         21
  /     division         $x = 7 / 3;         2
  %     remainder        $x = 7 % 3;         1
      equal            $x = 7  3;        0
  !=    not equal        $x = 7 != 3;        1
  .     concatenation    $x = 7 . 3;         73
  ? :   conditionals     $x = $y1 ? 2:3;   2 if y  1; 3 otherwise

Klammern ändern die Reihenfolge der Ausführung der Ausdrücke. Addition und Subtraktion werden vor Multiplikation, Division und den restlichen Ausdrücken ausgeführt.

Strings

"Strings" sollen eigentlich in Anführungszeichen gesetzt werden, außer sie enthalten Befehle. Ein "backslash" dient dazu spezielle Buchstaben, stellvertretend für einen Befehl, zu benutzen.

  \\   backslash
  \n   newline
  \r   carrige return
  \t   tab
  \"   quotation mark

Globale Variablen

Es gibt bereits definierte allgemeingültige Variablen. Somit können K-Meleon Makros auf globale Informationen zurückgreifen.

$URL

$LinkURL

$ImageURL

$FrameURL

$TITLE

Events

OnStartup?
OnOpenWindow?
OnCloseWindow?
OnLoad?
OnQuit?

Aussagen

Einige Aussagen können, von einem Strichpunkt getrennt, in eine Zeile geschrieben werden.

    $x = 0; $y = "A text string";

!!! Aussagen dürfen nicht über mehrere Zeilen verteilet, geschrieben werden! !!!

    $error = 1 +
        1;

Spezielle Aussagen:

  open( URL );
        Öffnet eine "url" im Browser.

  opennew( URL );
        Öffnet eine "url" in einem neuen Browserfenster.

  openbg( URL );
        Öffnet eine "url" in einer neuen Schicht.

  $VALUE = getpref( TYPE, "user.preference.variable" );
        Gibt die vom Benutzer bevorzugte Einstellung zurück.
        TYPE = BOOL | INT | STRING

  setpref( TYPE, "user.preference.variable", VALUE );
        Setzt vom Benutzer bevorzugte Einstellung.
        TYPE = BOOL | INT | STRING

  togglepref( TYPE, "user.preference.variable", VALUE1, VALUE2, ... );
        Wechselt die vom Benutzer bevorzugte Einstellung zu anderen festvorgebenen Werten.
        TYPE = BOOL | INT | STRING
        ("booleans" können nur die Werte "true" und "false" annehmen)

  exec( PROGRAM );
        Ruft ein anderes Programm auf.

  id( COMMAND_ID );
        Gibt eine Nachricht aus.
        Schaue in der kompletten Liste zum Befehl "IDs" nach.

  plugin( PLUGIN, COMMAND );
  pluginmsg( PLUGIN, COMMAND, ARGS );
  $REPLY = pluginmsgex( PLUGIN, COMMAND, ARGS, TYPE );
        Ruft einen "plugin" Befehl auf.
        Schaue in der kompletten Liste zu den "plugin" Befehlen nach.
        COMMAND = ???
        ARGS = ???
        TYPE = ???

  alert( MESSAGE, TITLE, ICON );
        Zeigt eine "messagebox" an.
        ICON = EXCLAIM | INFO | STOP | QUESTION

  $RESULT = confirm( MESSAGE, TITLE, BUTTONS, ICON );
        Zeigt eine Messagebox an und verlangt eine Bestätigung.
        BUTTONS = RETRYCANCEL | YESNO | YESNOCANCEL | ABORTRETRYIGNORE;
        ICON = EXCLAIM | INFO | STOP | QUESTION
        RESULT = OK | YES | NO |ABORT | RETRY | IGNORE | 0

  $VALUE = prompt( PROMPT, TITLE, DEFAULT_STRING );
        Zeigt einen Hinweis an.

  statusbar( TEXT );
        Zeigt einen Nachrichtentext auf der Statusleiste an.

  $TEXT = getclipboard();
        Holt Daten aus den Zwischenspeicher.

  setclipboard( TEXT );
        Gibt Daten an den Zwischenspeicher.

  $SUB = gensub( r, s, h, t );
        durchsucht den "string" t nach "string" r.  Z.B. wenn h 
        ein string ist und mit g oder G beginnt, werden alle 
        vorkommenden r durch s ersetzt. Andernfalls, also wenn h eine
        Zahl ist, wird das hte Vorkommen von r ersetzt. 
        Der geänderte "string" wird als Ergebnis zurückgeben.

  $SUB = gsub( r, s, t );
        ersetze jeden "substring" r im "string" t durch s, und gibt 
        den geänderten string zurück.
        Das ist gleichwertig mit gensub( r, s, "G", t);

  $SUB = sub( r, s, t );
        Fast wie bei gsub(), allerdings wird nur der erste passende "substring" ersetzt. 
        Das ist gleichwertig mit gensub( r, s, 1, t);

  $I = index( s, t );
        gibt die Stelle an, ab der t in s zufinden ist, oder -1 wenn t
        gar nicht drin vorkommt.

  $LEN = length( s );
        Gibt die Länge des "string" s zurück.

  $SUB = substr( s, i , n? );
        gibt einen "substring", der n viele Buchstaben besitzt, aus dem "string s" ab der Stelle i gelesen, zurück.
        Wenn n nicht gegeben ist, wird der Rest von s ausgegeben.

  $BASE = basename( NAME , SUFFIX? );
        Gibt den Namen mit den übergeordneten Verzeichnissen zurück.
        Wenn es angegeben ist, sogar mit SUFFIX.

  $DIR = dirname( NAME );
        Gibt den Namen mit einem / zurück; 
        ohne / sondern mit '.' (bedeutet das gerade angezeigte Verzeichnis).

  $HOST = hostname( URL );
        Gibt den "hostname" einer vorgegebenen URL zurück.

  macros( MACRO );
        Führe ein andres Makro aus.

  &MACRO
        Alias für 'macros(MACRO)'

Es sind nicht immer alle Parameter für die Befehle, seien es nun Warnmeldungen, Bestätigungen und Eingabeaufforderungen, erforderlich.

Plugin Befehle für Makros

Hier kannst Du eine Liste der Befehle finden.