|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bedienungsanleitung makealbum.pl V0.13Aufgabe des ProgrammsAufbau einer vollständigen Projektdefinition<ALBUMKONFIGURATION> vorschaubilder=5 auslassen=1 seitenname=fotoalbum/vollbild-seite#.html </ALBUMKONFIGURATION> <GERUESTFILES> geruest-vollquer.html=480x320 geruest-vollhoch.html=320x480 </GERUESTFILES> <ERSETZUNGEN> #background#=fotoalbum/elemente/fotohintergrund.jpg #SEITENTITEL#=Fotoalbum - VOLLBILD - Seite #$seite# / #$seiten# </ERSETZUNGEN> Beschreibung der EinträgeAbschnitt "ALBUMKONFIGURATION" - Konfiguration des AlbumsTag "seitenname"seitenname=[Muster]Beispiele: seitenname=seite#.htmlerzeugt z.B. seite5.html seite42.html Hiermit wird dem Programm gesagt, wie die zu erzeugenden Seiten des Albums heissen sollen. Eine Hashmark "#" gilt als Platzhalter für die aktuelle Seitenzahl. Tag "vorschaubilder"vorschaubilder=[Zahl](optional, default=1) Beispiele: vorschaubilder=5... falls fünf Vorschaubilder in der Leiste sind vorschaubilder=10... falls zehn Vorschaubilder verwendet werden Tag "auslassen"auslassen=[Zahl](optional, default=1) Beispiele: auslassen=1Jede Seite wird erzeugt auslassen=10Nur jede 10. Seite wird erzeugt, also die Seiten 1,11,21,31,... Abschnitt "GERUESTFILES" - Seitendesigns einbindenHier wird dem Progframm gesagt, aus welchen Dateien es die einzelnen Seiten des Albums generieren soll. Dabei gibt es zwei Möglichkeiten. Entweder man hat nur ein einzelnes Gerüst für alle Seiten, oder eine Auswahl aus mehreren Gerüsten, die je nach Bildproportion (Hochformat, Querformat) eingebunden wird. Syntax: [Dateiname]=[Proportion]Beispiele: geruest.html=* Falls nur ein einzelnes Gerüst verwendet wird, braucht keine Proportion angegeben zu werden. Dann reicht ein Sternchen "*". [Dateiname]=*Sobald aber mehrere Gerüste verwendet werden, müssen Kriterien zur Auswahl festgelegt werden. Da es nur Sinn macht, anhand der Bildproportion zu unterscheiden, kann man diese hier nun festlegen. Proportionen werden dabei wie bei makephotos.pl definiert. Syntax: [Dateiname]=[X-Größe]x[Y-Größe]Beispiel: geruest_hochformat.html=300x400 geruest_querformat.html=400x300 Abschnitt "ERSETZUNGEN" - Globale Ersetzungen definierenHier können alle eigenen Ersetzungen festgelegt werden. Das ist sinnvoll, um manche Parameter zentral verwalten zu können. Syntax:[Zu ersetzender String]=[neuer String]Beispiele: #SEITENTITEL#=Testalbum Seite #$seite# #BGCOLOR#=#ffffff #PFAD#=/homepage/Es ist nicht nötig, selbstdefinierte Platzhalter in Hashmarks "#" einzugrenzen. Es hat aber die Vorteile, daß man die Einträge später im Gerüst sofort als Platzhalter erkennt, und daß die Zeichenkette nicht unbeabsichtigt später nochmals auftaucht. Ein schlechtes Beispiel wäre sicherlich datum=01.01.2002weil dann jedes Vorkommen von "datum" ersetzt werden würde. Der Satz "Mein Geburtsdatum ist der ...." würde dann auch verstümmelt werden! Beispiel eines SeitengerüstesBei dem folgenden Beispiel handelt es sich um ein sehr einfaches Seitengerüst in HTML. Es zeigt das jeweils aktuelle Foto in festgelegter Größe im Browserfenster an, und bietet noch Links zum Vor- bzw. Rückwärtsblättern an. Bei den Seitengerüsten handelt es sich um Mustereinträge des späteres Fotoalbums. Daher ist die Sprache der Wahl hier HTML. Natürlich sind auch Fotoalben in TeX möglich, da PerlMagick auch in das Format .EPS konvertieren kann. Das habe ich aber noch nicht getestet. Da es sich aber nur um eine allgemeines Schablone handelt, dürfen noch keine endgütigen Werte für Bildgrößen, Dateinamen und Links verwendet werden. Dafür wurden Platzhalter definiert, die dann später vom Programm automatisch durch die jeweils aktuellen Werte ersetzt werden (Hier fett markiert). <HTML> <HEAD> <TITLE>#SEITENTITEL#</TITLE> </HEAD> <BODY> <CENTER> <TABLE border="5" cellspacing="0" cellpadding="0" background=#background#><TR><TD> <TABLE border="0" cellspacing="0" cellpadding="0" width="720" height="520"> <TR> <TD width="420" height="420" colspan="3" align="center" valign="center"> <IMG src="#filename-gross($0)#" width="#width-gross($0)#" height="#height-gross($0)#"> </TD> <TD width="300" height="420" align="center"> #beschreibung($0)# </TD> </TR> <TR> <TD width="100" height="100" align="center"> <A href="vollbild-seite#$<#.html">Zurück</A> </TD> <TD width="220" align="center"> Dies ist Seite #$seite# von #$seiten# </TD> <TD width="100" align="center"> <A href="vollbild-seite#$>#.html">Vor</A> </TD> <TD width="300"> </TD> </TR> </TABLE></TD></TR></TABLE> </CENTER> </BODY> </HTML> Platzhalter im Seitengerüst
Es gibt verschiedene Arten von Platzhaltern in der Gerüstdatei.
Alle weiteren Platzhalter werden vom Programm vorgeschrieben, und sind
an der Einschachtelung in zwei Hashmarks "#" zu erkennen.
Platzhalter, die das aktuelle Bild betreffen:
Platzhalter, die das n.te Bild der Vorschauleiste betreffen: (n>0)
Ergänzung der Bild-Platzhalter, wenn Serien verwendet werden:
Eine Serie besteht aus mehreren ALIAS-Einträgen
#typ($n)#gilt dann: #typaliasname($n)#mit
Platzhalter zum Blättern:Das Ergebnis der Ersetzung ist immer eine Seitenzahl.
Beispiel:
Platzhalter zum Anspringen spezieller SeitenAuch hier ist das Ergebnis der Ersetzung immer eine Seitenzahl. Eine Verwendung macht daher nur bei Links und Seitenzahlenanzeigen einen Sinn.
Kommandozeilenparameter zum Aufruf> makealbum.pl --help Strunz-Design's HTML-Photoalbum-Maker V0.13 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Syntax: makealbum.pl <Optionen> <Projekt[e]> Optionen: -h | --help : Diese Hilfe anzeigen -l | --log : Bildschirmausgaben in "albumlog.txt" mitloggen Bildschirmausgabe beeinflussen: -q | --quiet : (0) quiet - Nur kritische Fehler melden : (1) Knappe Ablaufausgaben (*default*) -v | --warn : (2) Warnungen mit ausgeben (Empfohlen) -vv | --debug : (3) Debug-Informationen mit ausgeben, !Zur Fehlersuche!
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Seitenanfang |
Inhalt und Design von Florian Evers, florian-evers@gmx.de |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||