Anleitung Version 0.4   

BMW R60/6
Startseite
R60/6
R75/6
Modelle /5-/7
Reparaturen und Tips
Fahren mit der /6
Quellen
--------
Q-Tools
   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 altes q-var 0.4


Dies ist die Kurzbeschreibung der alten Version 0.4 von q-var vom 7.12.2005

Während q-var 0.4 eher die prinzipielle Machbarkeit einer Include-erweiterung im Fokus hatte, hat 0.5 deutliche Verbesserungen im Handling. Hier dennoch noch die Beschreibung der alten Version, die für den einen oder anderen vielleicht völlig ausreichend sein könnte.

q-var ist Freeware und wird ohne jede Gewährleistung verteilt.

Was macht q-var, bzw was sollte es idealerweise machen

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 %q-relpathup% und verwandten Variablen können Pfadangaben so gestaltet werden, dass sie auch in Unterverzeichnissen gültig bleiben.
Beispiel:
<img src="%q-relpathup%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:
<!--INC:"%q-bottom%-->...<!--/INC:"q-bottom%-->
kann abhängig vom Wert der Variable q-bottom verschiedene Includes aufrufen

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.

Interne Variablen sind:
Variablen zu Verzeichnispfaden:
%q-relpathup% - damit können korrekte Verweise in Includes auch vom Unterverzeichnis aus realisert werden:
                z.Bsp: <a href="%q-relpathup%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 Dateiname:
%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: <!--INC:"%q-relpathnoslash%vVAR.INC"--> wird zu: <!--INC"Aktuelles-VAR.INC"-->

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%">

Dateispezifische Variablen
Variablen können mit dem Tag <!--q-vars:q-v1='Hallo',q-v2='<p>Zeile</p>'-->
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.

Globale Variablen
In der ini-Datei q-var.inikönnen global verfügbare Variablen im Format q-VARIABLENNAME='VARIABLENINHALT' angegeben werden
Bsp:
[q-variablen]
q-test='<p>Testinformation</p>'
q-autor='Hans Dampf'

Zusammenarbeit mit Phase 5

q-var ist unbedingt 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.

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

q-var versucht, alle html(l)-Dateien, also Dateien mit der Dateierweiterung htm(l) zu bearbeiten, dort die Include-Dateien zu aktualisieren und dann die Variablen zu ersetzen. 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 zwei Ebenen von Include-Dateien auf (also includes in includes), Includes mit q-Variablennamen gehen über diese zwei Ebenen hinaus (maximal: includes in includes in variablen includes in includes in includes).

Ini-Datei anpassen

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

Globale Variablen
Wenn du globale Variablen hast, gib sie hier ein (siehe auch direkt darüber)
[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 verwende noch das alte htmledit phase 5 von Uli Meybohm;
Wenn du noch das alte Phase 5 von Uli Meybohm verwendest, ist hier 1 anzugeben
Kennzeichen, ob alte oder neue Phase5-Registry-informationen verwendet werden
sollen
1=alt, 2=neu (Standard)
[altes Phase5]

...ich kann das Ergebnis nicht im q-var-Programmverzeichnis speichern
Solltest du eine ordentliche Sicherheitsstrategie auf deinem Rechner fahren, was ei ne durchaus gute Idee ist, kannst du eventuell konsequenterweise im Programmverzeichnis von q-var nicht schreiben. Dann kannst du hier ein Verzeichnis angeben, in das die HTML-Ergebnisdatei von q-var geschrieben wird.
Verzeichnis für HTML-Ausgabedatei, Standard ist im Programmverzeichnis
Verzeichnisangabe bitte mit voller Pfadangabe und mit / (Slash) statt \ (backslash)
sowie mit einem / (slash) am Ende der Verzeichnisangabe
z.Bsp: c:/WWW/Testverzeichnis/
[Outputverzeichnis]

...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]
<!--INC:"%1%"-->

[include code ende]
<!--/INC:"%1%"-->

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".

Famous Last Words

q-var wurde als Perl-Script entwickelt.
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.
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