Anleitung q-var

Startseite

--------

q-var

Anleitung q-var

Anleitung Version 0.4

q-sync

GKK

gpx2gpx

Alwins Seiten

Zum Autor

Find-Hilfe

** Diese Seiten werden nicht mehr gepflegt! *** q-Seiten ->Die Q im Deutschland des frühen dritten Jahrtausends

Kurzanleitung q-var

Dies ist die Kurzbeschreibung der Version 0.5 von q-var vom 20.2.2006.
q-var steht in der aktuellen Version im Downloadbereich von qhaut.de, dem Forum zu htmledit phase 5. Q-var steht im Downloadbereich unter "Plugins und Erweiterungen". q-var ist Freeware und wird ohne jede Gewährleistung verteilt.

Was ist neu an q-var 0.5?

q-var ist in der Version 0.5 erwachsener geworden.
Zu den neuen Möglichkeiten zählen:

q-var unterstützt jetzt mehrere Phase5-Projekte und legt Informationen zu jedem Projekt getrennt ab
Die Ausgabe von q-var ist verbessert, auf fehlende Variablen oder Includebausteine wrd hingewiesen.
Die Aktualisierung der Dateien geht nun deutlich schneller.
Dateien, die bearbeitet werden, werden anhand des Phase5-Registry-eintrags EXHTML (HTML-Extension) erkannt. Die Angabe kann in q-var überschrieben werden.
Includes können fast beliebig geschachtelt werden (bis zu 9 mal)
Includebausteinnamen innerhalb von includes können eine Variable enthalten.
Globale Variablen können direkt in q-var eingegeben werden.
q-var kennt neue Variablen:

q-menu fügt ein Menü mit vollständig konfigurierbarem Layout ein. Nach Angabe von Menübeschreibungsdaten wid jede Datei im Menü so dargestellt, dass das Menü bei der aktuellen Datei "aufgeklappt" dargestellt wird. Es wird also ein dynamisches Menü simuliert.
Wenn ein Menü definiert wurde, stehen Variablen zur Verfügung, die Link, Name und Beschreibung des nächsten, letzten, übergeordneten, nächsten übergeordneten und des Home- Menüpunktes zur Verfügung.

q-var unterstützt das Testen von Webseiten, Includes und Variablen, indem es Includes komprimiert einfügen kann oder die Variablen nicht ersetzt.
q-var kennt jetzt die Übergabeparameter -project:, -file:, -noreg, -novar und -compress

Was macht q-var?

q-var ersetzt in den Dateien eines htmledit phase5-Projekt in allen Includebausteinen von HTML-Dateien Variablen, die im Format %q-VARIABLENNAME% vorliegen.
Dazu werden die Include-Dateien aller HTML-Dateien aktualisiert und anschließend Variablen, die innerhalb von Include-Bausteinen verwendet werden, aktualisiert.
Das Ergebnis des q-var-Laufs befindet sich in der Ergebnisdatei q-var-html, die sich im Programmverzechnis von q-var befindet.

Zwei Anwendungen springen ins Auge:
mit der internen Variable ../ und verwandten Variablen können Pfadangaben so gestaltet werden, dass sie auch in Unterverzeichnissen gültig bleiben.
Beispiel:
<img src="../images/stern.gif">
wird in einer Datei im Hauptverzeichnis des Phase5-Projektes zu <img src="images/stern.gif">
und im Unterverzeichnis bsp/ des Phase5-Projektes zu <img src="../images/stern.gif">,
so daß der Link gültig bleibt.

Includes innerhalb von Includes können variabel aufgerufen werden:
...
kann abhängig vom Wert der Variable q-bottom verschiedene Includes aufrufen

Wie installiere ich q-var?

Q-var muss nicht installiert, sondern lediglich entpackt werden. Ich würde vorschlagen, dass du unter dem Ordner Programme ein Verzeichnis q-var anlegst und die Zip-Datei q-var dorthin entpackst. Anschliessend solltest du Links zur q-var Programmdatei "q-var.exe" anlegen und diese in das Verzeichnis "Plugins" im Verzeichnis von htmledit kopieren. Dann kannst du q-var aus dem Punkt "Tools" der Menüleiste von htmledit aus starten (Achtung, Tools starten aus dem aktuellen htmledit nur, wenn du eine Datei geöffnet hast)
Neben dem Programm q-var sind auch mehrere Batchaufrufe enthalten, die q-var mit besonderen Paramtern aufrufen. Auch zu diesen Dateien kann ein Link angelegt und ins "Plugin"-Verzeichnis von htmledit kopiert werden, um direkte Aurufe aus htmledit zu ermöglichen.
Du kannst q-var auch direkt ins Plugin-Verzeichnis von Phase5 entpacken.

Die graphische Oberfläche von q-var

q-var hat eine recht übersichtliches Hauptfenster: In der Mitte gibt es eine Ausgabefenster mit Meldungen des Programms, darunter lässt sich der Aktualisierungslauf starten oder das das Programm beenden.

In der Menüzeile gibt es Möglichkeiten zu Anpassungen:
Aktualisierugslauf Hier kann der Aktualisierungslauf gestartet, Testoptionen gesetzt oder die Ergebnisdatei als HTML geöffnet werden
Variablen: Hier können globale Variablen verwaltet und eine Übersicht der internen Variablen angezeigt werden
Menü: Hier können Angaben zu Struktur, Inhalt und Format eines einzufügenden Menüs gemacht werden
Projekteinstellungen: Hier können die vorgegebenen Einstellungen für das aktuelle Phase5-Projekt überschriebben werden
Grundeinstellungen: Hier können Angaben zum Start von q-var verändert werden.
Hilfe: Hier können Informationen zu q-var abgefragt und die Hilfe gestartet werden.

Welche Variablen gibt es und wie kann ich sie selber setzen?

q-var kennt drei Typen von Variablen:
(1) Interne Variablen werden vom Programm gesetzt, (2) globale Variablen werden in der ini-Datei vorgegeben und (3) dateispezifische Variablen können in der Datei oder in Includebausteinen vorgegeben werden. Dabei werden globale Variablen von internen Variablen und interne Variablen von dateispezifischen Variablen überschrieben.
Nicht existierende Variablen werden aus dem Code entfernt.

1. Interne Variablen sind:
Variablen zu Verzeichnispfaden:
../ - damit können korrekte Verweise in Includes auch vom Unterverzeichnis aus realisert werden:
                z.Bsp: <a href="../index.html">
%q-relpathnofile% - relativer Pfad ohne Dateiname
%q-relpathcss%    - Relativer Pfad zum CSS-Verzeichnis von Phase 5
%q-relpathres%    - Relativer Pfad zum Ressourcen-Verzeichnis von Phase 5

Variablen zum Dateinamen:
%q-aktfile% - Aktueller Dateiname mit relativem Pfad
%q-aktfilenopath% - Dateiname ohne Pfad
%q-aktfilenoext% - Dateiname ohne Erweiterung
%q-aktfilepath% - Dateiname mit absolutem Pfad

Variable zum Aufruf eines Includes abhängig vom Unterverzeichnis!
%q-relpathnoslash%: Relativer Pfad ohne Slash
            Z.Bsp:  wird zu: 

Datumsversionen
%q-date% - Datumsversionen
%q-date-long%
%q-date-short%
%q-version% - q-var Version
%q-versionsdatum% - q-var Versionsdatum

Variablen zur Verwendung bspw. im Head-Bereich Meta
%q-firsttagh1%    - Erste Überschrift <H1>
%q-firsttagh1short% gekürzte Version erste Überschrift <H1>, 30 Zeichen + Wortende
%q-firsttagh2%   - Erste Überschrift <H2>
%q-firsttagh2short% gekürzte Version erste Überschrift <H2>, 30 Zeichen + Wortende
%q-firsttagp%     - Erster Normaler Absatz <P>
%q-firsttagpshort%   gekürzte Version Normaler Absatz <p>, 50 Zeichen + Wortende
            Z.Bsp:
                      <meta name="Author" content="%q-autor%">
                      <meta name="GENERATOR" content="%q-version% %q-versinsdatum%">
                      <meta NAME="DESCRIPTION" CONTENT="%q-firsttagh1%">
                      <meta NAME="ABSTRACT" CONTENT="%q-firsttagh1% %q-firsttagpshort%">
                      <meta NAME="KEYWORDS" CONTENT="%q-firsttagh1short% %q-firsttagh2short%">

Variablen, die mit dem Menü zusammenhängen
Die Variablen stehen nur zur Verfügung, wenn ein Menü in q-var definiert wurde.

%q-menu% - Individuell konfigurierbares Menü

Menüpunkt	Dateiverweis	Name Menüpunkt	Beschreibung Menüpunkt
Aktueller	%q-aktfile%	%q-aktmenu%	%q-akttitle%
Nächster	%q-nextfile%	%q-nextmenu%	%q-nexttitle%
Letzter	%q-lastfile%	%q-lastmenu%	%q-lasttitle%
Nächster, der mindestens eine Ebene höher liegt	%q-nextupfile%	%q-nextupmenu%	%q-nextuptitle%
Letzter, der mindestens eine Ebene höher liegt	%q-lastupfile%	%q-lastupmenu%	%q-lastuptitle%
Home des Menüs	%q-homefile%	%q-homemenu%	%q-hometitle%

Die Variablen zur letzten, nächsten und zur nächst höher liegenden Datei stehen nur zur Verfügung, wenn die aktuelle Datei auch selbst im Menü enthalten ist.

2. Dateispezifische Variablen (Inline-Variablen)
Variablen können mit dem Tag 
in der Webseite eingefügt werden und gelten dann für diese Seite. Als Trennzeichen werden Kommas und enfache Anführungszeichen verwendet. Diese dürfen deshalb nicht in Variablenname und Variableninhalt vorkommen.
Inline-Variablen können sowohl im Normalen Dateicode oder in Includes stehen.

3. Globale Variablen
Im Fenster "Globale Variablen" können global verfügbare Variablen und ihre Werte angegeben werden. Globale Variablen müssen mit "q-" beginnen und müssen einen Wert erhateln, sonst werden sie gelöscht.
In die Include-Dateien werden die globalen Variablen mit "%q-VARNAME%" eingefügt

Zusammenarbeit mit Phase 5

q-var ist normalerweise auf Registry-Angaben von phase 5 angewiesen, um funktionieren zu können. Bitte kopiere q-var.exe und q-var.ini in das Plugin-Verzeichnis von Phase5 oder verlinke entsprechend. Um einen Link einzufügen, im Explorer mit der rechten Maustaste die Programmdatei anklicken, im Kontextmenü "Verknüpfung erstellen" anklicken und die erstellte Verknüpfung ins Verzeichnis plugins kopieren.

q-var liest die Registryangaben von Phase 5 und wertet die Angaben zum Stammordner für die Homepagedateien und zum Verzeichnis für Includedateien des aktuellen Projektes aus.

Unter dem Punkt "Grundeinstellungen" der Menüleiste kann eingestellt werden, ob alte, neue oder keine Phase5-Registryeinstellungen verwendet werden soll. Normalerweise sollte aber die Einstellung "automatisch" das richtige Ergebnis liefern,

q-var bearbeitet alle Dateien mit der in Phase5 angegebenen Dateierweiterung für HTML-Extensions (EXHTML). Standardmässig sind dies "*.htm,*.html,*.shtml,*.asp,*.inc" zu bearbeiten. In Dateien mit dieser Erweiterung im Dateinamen werden die Include-Dateien aktualisiert und Variablen ersetzt. q-var bearbeitet das Homepagerverzeichnis und alle darunter liegenden Verzeichnisse. Wenn das Includeverzeichnis unter dem Homepageverzeichnis liegt, wird es aber ausgeschlossen, damit die Includeangaben nicht überschrieben werden. Je nachdem, wie deine Verzeichnisse organisiert sind, könnte das zur Bearbeitung der falschen Dateien und damit zum Ausschluss für die Anwendung von q-var führen. Normalerweise sollten aber im Phase 5 Homepageverzeichnis die richtigen Dateien liegen.
q-var löst neun Ebenen von Include-Dateien auf (also includes in includes).

Q-var-spezifische Angaben machen

Über die Menüleiste können globale Variablen und das Menü von q-var definiert werden. Diese Angaben werden in der ini-Datei gespeichert. Wird q-var mit einem neuen Projektnamen aufgerufen, wird eine neue ini-Datei angelegt, so dass jedes Projekt seine eigene ini-Datei hat.

Angaben von Phase5 verändern

q-var kann unter dem Menüpunkt "Projekteinstellungen" die Angaben von Phase5 verändern. Die veränderten Angaben werden dann in der ini-Datei von q-var gespeichert. Q-var verändert keine Registrywerte von Phase5.

Globale Variablen

Globale Variablen müssen mit den Zeichen "q-" beginnen und dürfen keine Leerzeichen enthalten. Wenn eine Variable keinen Wert zugewiesen bekommt, wird sie beim nächsten Programmlauf gelöscht.

Menü

Im Menüfenster können alle Dateinamen, die im Menü %q-menu% erscheinen sollen, ausgewählt werden. Zu jedem Menüpunkt müssen Angaben zum Titel des Menüpunkts, der später im Menü erscheint, sowie eine Kurzbeschreibung gemacht werden. Durch Pfeiltasten kann die Reihenfolge im Menü und die Menüebene verändert werden. Punkte mit einer hierarchisch tieferliegenden Ebene werden als Unterpunkte des vorhergehenden Punktes mit einer höheren Menüebene interpretiert.

Über den Button "Menüformatierung" kann das Aussehen jeder Menüebene definiert werden. So können Menüpunkte scheinbar dynamisch aufgeklappt werden, da die jeweils richtige Menüdarstellung über %q-menu% eingefügt wird.

Ini-Datei direkt anpassen

Wird q-var mit einem neuen Projektnamen aufgerufen, wird eine neue ini-Datei angelegt.
Die Inidateien von q-var liegen im Verzeichnis "Dokumente und Einstellungen\<AKTUELLER NUTZER>\Anwendungsdaten" unter dem Namen des Projekts mit der Dateiendung ini.
Normalerweise solltest du in der ini-Datei selbst nichts ändern (müssen). Alle Werte können über das Programm direkt verändert werden

Die ini-Datei kennt Kommentare, die mit einem #(Doppelpunkt) beginnen müssen, Abschnitte, die in eckige Klammern eingefügt sind ([...]) und Werte ,die hinter den Abschnittskennzeichen eingefügt werden können.

Verzeichnisangaben sind mit "/" (Slash) statt "\" (backslash) zu machen, am Ende ist ein zusätzlicher "/" notwendig!

Globale Variablen
Wenn du globale Variablen hast, gib sie hier ein, falls du sie nicht in q-var direkt eingeben willst.
[q-variablen]
q-test='<p>Testinformation</p>'

Die Ini-Datei q-var.ini kennt außerdem mehrere Angaben, die normalerweise nicht notwendig sind, außer:

...ich benutze andere Include-Kennzeichen
Ich weiß nicht, warum man das tun sollte, aber falls du andere Include Kennzeichen verwenden solltest, kannst du sie hier angeben. %1% steht als Platzhalter für konkrete Dateinamen und muß enthalten sein

[include code anfang]


[include code ende]


Prizipiell können in der ini-Datei fast alle Optionen angegeben werden, die zu Beginn des Aktualisierungslauf ausgegeben werden. Solltest du q-var ohne htmledit benutzen, musst du mindestens die Abschnitte [Homepagedir] und [IncDir], besser auch die Angaben zu den Abschnitten [CssDir], [ResDir] und [UMLFiles] einfügen. Im Abschnitt UMLFiles sind in einer Zeile mit Komma getrennt die Dateiendungen in folgender Form anzugeben: *.html,*.htm,*.php

Parameter beim Programmaufruf

q-var.exe kann mit folgenden Optionen aufgerufen werden:
-compress : Funktion zum Testen der Webseiten: Es werden nicht die include-Dateien, sondern leere includes eingefügt. Dies kann den Code der HTML-Seite ggf übersichtlicher
-novar : Funktion zum Testen der Webseiten: Die Variablen werden nicht ersetzt
-file:"<absoluter oder relativer dateiname>" : es wird nicht das gesamte Projekt, sondern nur der genannte Dateiname aktualisiert.
-project:"<Projektname>": es wird nicht das aktuelle htmledit-Projekt, sondern das angegebene Prjekt verwendet
-noreg : es werden keine Angaben aus der Registry verwendet, alle notwendigen Projektinformationen müssen in der ini-Datei angegeben werden. (Abschnitte "HomePageDir", "IncDir", "CssDir", "ResDir" und "UMLFiles" müssen in der ini vorhanden sein, Paramter -project muss angegebn sein)

Das könnte etwa so aussehen:

Beispiel von Variablen in INCLUDES: 

 Variablen grün, 

 Includes Lila und 

 Variablensetzung blau
<html>
<head>
<title>Q-Var Beispielseite</title>
<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//de">
<!--INC:"head.inc"-->   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <meta name="Author" content="Roland Wirth">
   <meta name="GENERATOR" content="Mozilla/4.72 [de] (Windows NT 5.0; U) [Netscape]"> 
   <meta NAME="DESCRIPTION" CONTENT="%q-firsttagh1% %q-firsttagh2% %q-firsttagpshort%">
   <meta NAME="ABSTRACT" CONTENT="%q-firsttagh1short% %q-firsttagh2short%">
   <meta NAME="KEYWORDS" CONTENT="%q-firsttagh1short% %q-id%">
<!--/INC:"head1.inc"-->

<!--INC:"head-script.inc"--><link rel="stylesheet"
  href="%q-relpathcss%newstyle.css" type="text/css">
   <script language="JavaScript" src="%q-relpathup%overlib.js"></script>
<!--/INC:"head-script.inc"-->
</head>

 
<!--INC:"body_top.inc"-->
   <body background="%q-relpathrsc%back1.gif" bgcolor="#ffffff">
<table border=0 cellspacing=0 width="100%" >
   <tbody>
   <tr>
     <td>
        <a href="javascript:history.back(-1)"

  onmouseover="return overlib('&nbsp; &nbsp;zur&uuml;ck')"        
        onmouseout="return nd();"><img name=oback
  src="%q-relpathup%images/o-back.gif" width="71"
 height="18" 
        border="0" alt="zur&uuml;ck">
        </a>
        <a href="#bottom" onmouseover="return
  overlib('&nbsp;
         &nbsp;Seitenende')"  
        onmouseout="return nd();"><img name=ende src="%q-relpathup%images/ende.gif"
 width="71" height="18"
  border="0" alt="">
        </a>
     </td>
     <td valign="bottom" colspan=2>
       Hauptseite
     </td>
     <td>
        <!--INC:"%q-body_img%.inc"-->
           <div align=left><img src="%q-relpathrsc%Logo.gif" height=33 width=100>
 
        <!--INC:"%q-body_img%.inc"-->
        </div>
     </td>
   </tr>
   </tbody>
   </table>
<!--/INC:"body_top.inc"-->

 <h1> Hallo,  Hier gibts eine Übersicht und damit mehr Durchblick!</h1>
<!--q-vars:q-id='&Uuml;bersichtsseite';q-body_img='logo'-->
 
<p>Hier gibts Text und noch mehr Durchblick.</p>

usw. ...

Wo kann ich q-var erhalten?

q-var steht in der aktuellen Version im Downloadbereich von qhaut.de, dem Forum zu htmledit phase 5.
Konkret: Auf der Startseite von qhaut in der Seitennavigation auf der rechten Spalte ins Forum gehen.
Dann in der Menüzeile oben "Downloads" anwählen.
q-var steht im Bereich "Plugins und Erweiterungen".

Was funktioniert nicht richtig?

Tja, wenn man das im voraus wüsste :-)

Auf jeden Fall solltest du darauf achten, dass in htmledit eine Datei geöffnet ist, wenn du q-var von dort aus startet. Sonst führen die neueren Versionen von htmledit keine Tools aus. Im Original von Meybohm ging das übrigens noch.
q-var braucht sehr lange zum Starten - dies ist leider unvermeidlich, da q-var eine Perl-Anwendung ist, die mit einer Art Laufzeitumgebung zu einer exe-Datei verbunden wurde. So ist Perl ohne installierten Perl-Interpreter auf jedem Windowsrechner lauffähig.
Derzeit wird die in htmledit geöffnete Datei nicht automatisch aktualisiert, so dass sie nach einem Aktualisierungslauf von q-var den falschen(alten) Inhalt anzeigt.
Wenn Angaben zum Menü nicht gespeichert wurden, kann kein Aktualisierungslauf mehr durchgeführt werden, da die Initialisierung nicht mehr eindeutig definiert ist. q-var muss dann erneut gestartet werden.

Famous Last Words

q-var ist ein Perl-Script.
q-var ist Freeware.
Die Benutzung dieser Freeware geschieht auf eigene Gefahr. q-var kann bei Fehlbedienung oder aufgrund von Programmfehlern zu Datenverlust führen. Weitere Informationen erhältst Du nach dem Start von q-var unter "Hilfe"
Und jetzt viel Erfolg.

Interne Links
Linkliste
Intern Suchen

Externe Links
Erste Adresse für BMW /5 bis /7:
2-ventiler.de

Letzte Änderungen
9/16 Serverumzug: q-tipps.hol.es
8/20 Serverumzug: q-seiten.wir-in-lie.de

Die Q im Deutschland des frühen dritten Jahrtausends auf q-seiten.wir-in-lie.de / Impressum / Letztes Update: 1/25