Frank Seitz - Developer Logbuch

Einträge für Februar 2010

Impressum

Frank Seitz
Frank Seitz
Hermann-Rohwedder-Str. 16
25462 Rellingen

E-Mail: fsATfseitz.de
Telefon: +49 176 78243503

Kurzprofil
Inhaltsverzeichnis

Abonnieren

Kategorien



Alle Kategorien

Archiv

Dienstag, 9. Februar 2010

GNU Makefile zum Konvertieren von Dateien

Mitunter soll eine Menge von Dateien, die man erstellt und bearbeitet, systematisch in etwas anderes, z.B. ein anderes Format, konvertiert werden. Die Konvertierung lässt sich mit dem Utilty make organisieren, so dass überflüssige Konvertierungen vermieden werden.

Wie sieht ein GNU Makefile für diese Aufgabe aus?

Das folgende (fiktive) Beispiel geht davon aus, dass wir .in-Dateien in .out-Dateien konvertieren wollen. Die Konvertierung übernimmt das (fiktive) Programm in2out.

1 OUTFILES = $(patsubst %.in,%.out,$(wildcard *.in))
2
3 %.out: %.in
4 in2out $< $*.out
5
6 all: $(OUTFILES)
7
8 clean:
9 rm -f *.out
Zeile 1

Definition der Liste der Targets, also der Dateien, die zu generieren sind. Das sind .out-Dateien. Diese Liste könnten wir per Hand pflegen, was aber mühselig wäre. Stattdessen nutzen wir die Möglichkeiten von GNU make und generieren die Liste mittels der Funktionen wildcard und patsub aus den im aktuellen Verzeichnis befindlichen .in-Quell-Dateien.

Zeile 3-4

Pattern Rule, welche definiert, welche Kommandofolge aus einer .in-Quelldatei eine .out-Zieldatei erzeugt. Hier ist es ein einzelnes Kommando, der Aufruf von in2out [infile] [outfile]. Die make-Variable $< enthält den Namen der .in-Quelldatei, die Variable $* den Grundnamen der Quelldatei, aus dem durch Anhängen von ".out" der Name der Zieldatei wird.

Zeile 6

Regel, die bei Aufruf von 

$ make

oder 

$ make all

zu erfüllen versucht wird. Diese (PHONY-)regel besagt, dass als Vorbedingung alle $(OUTFILES) zu generieren sind.

Zeile 8-9

Regel ohne Vorbedingung, die aufräumt, also alle .out-Dateien löscht, z.B. um sie insgesamt neu zu generieren. Aufruf: 

$ make clean
Geschrieben von Frank Seitz in make um 12:09 | Kommentare (0) | Trackbacks (0)

Montag, 8. Februar 2010

Syntax-Highlighting mit highlight

Highlight stellt die Syntax von zahlreichen Programmiersprachen farbig und mit Fontattributen wie kursiv und fett dar: 

$ highlight --syntax=LANG --fragment <CODE >CODE.html

Die Option --syntax=LANG stellt die Programmiersprache ein, --fragment sorgt dafür, dass keine vollständige HTML-Seite, sondern einbettbarer HTML-Code generiert wird.

Die zugehörigen CSS-Klassen liefert folgendes Kommando nach stdout: 

$ highlight --print-style --style-outfile=stdout | grep '^\.' >CODE.css

Das nachgeschaltete grep sorgt dafür, dass der Output auf die relevanten Klassen für eine Einbettung eingeschränkt wird.

Geschrieben von Frank Seitz in Unix um 16:01 | Kommentare (0) | Trackbacks (0)

Freitag, 5. Februar 2010

Syntax-Highlighting mit perltidy

Perltidy stellt die Syntax von Perl-Code farbig und mit Fontattributen wie kursiv und fett dar, wenn man den Code mit Option -html nach HTML wandelt. Ich nutze dieses Feature, um lesbareren Perl-Code für mein Blog zu generieren.

Für die Einbettung des generierten HTML-Codes in eigene HTML-Seiten sind allerdings kleinere Sonderbehandlungen nötig.

Anpassung der Stylesheet-Definitionen

Perltidy generiert mit 

$ perltidy -html -ss >FILE.css

eine Stylesheet-Datei, die die Definitionen der CSS-Klassen für die Syntaxelemente enthält und in die eigenen HTML-Seiten eingebunden werden kann: 

/* default style sheet generated by perltidy */
body {background: #FFFFFF; color: #000000}
pre { color: #000000;
      background: #FFFFFF;
      font-family: courier;
    }

.c  { color: #228B22;} /* comment */
.cm { color: #000000;} /* comma */
.co { color: #000000;} /* colon */
.h  { color: #CD5555; font-weight:bold;} /* here-doc-target */
.hh { color: #CD5555; font-style:italic;} /* here-doc-text */
.i  { color: #00688B;} /* identifier */
.j  { color: #CD5555; font-weight:bold;} /* label */
.k  { color: #8B008B; font-weight:bold;} /* keyword */
.m  { color: #FF0000; font-weight:bold;} /* subroutine */
.n  { color: #B452CD;} /* numeric */
.p  { color: #000000;} /* paren */
.pd { color: #228B22; font-style:italic;} /* pod-text */
.pu { color: #000000;} /* punctuation */
.q  { color: #CD5555;} /* quote */
.s  { color: #000000;} /* structure */
.sc { color: #000000;} /* semicolon */
.v  { color: #B452CD;} /* v-string */
.w  { color: #000000;} /* bareword */

Anpassung 1

Die CSS-Definitionen für <body> und <pre> am Anfang sollten im Falle einer Einbettung nicht vorkommen, da diese an anderer Stelle definiert sind. Sie lassen sich mit grep wegfiltern. 

$ perltidy -html -ss | grep '^\.'

Anpassung 2

Die Namen der CSS-Klassen bestehen aus ein oder zwei Buchstaben, was zu Nameclashes führen kann. Dies verbessere ich, indem ich dem Klassennamen einen Präfix voranstelle. Ich wähle "pt-". 

$ perltidy -html -ss | grep '^\.' | sed -e 's/^\./.pt-/'

Resultierende CSS-Datei

.pt-c  { color: #228B22;} /* comment */
.pt-cm { color: #000000;} /* comma */
.pt-co { color: #000000;} /* colon */
.pt-h  { color: #CD5555; font-weight:bold;} /* here-doc-target */
.pt-hh { color: #CD5555; font-style:italic;} /* here-doc-text */
.pt-i  { color: #00688B;} /* identifier */
.pt-j  { color: #CD5555; font-weight:bold;} /* label */
.pt-k  { color: #8B008B; font-weight:bold;} /* keyword */
.pt-m  { color: #FF0000; font-weight:bold;} /* subroutine */
.pt-n  { color: #B452CD;} /* numeric */
.pt-p  { color: #000000;} /* paren */
.pt-pd { color: #228B22; font-style:italic;} /* pod-text */
.pt-pu { color: #000000;} /* punctuation */
.pt-q  { color: #CD5555;} /* quote */
.pt-s  { color: #000000;} /* structure */
.pt-sc { color: #000000;} /* semicolon */
.pt-v  { color: #B452CD;} /* v-string */
.pt-w  { color: #000000;} /* bareword */

Anpassung des HTML-Codes

Perltidy erzeugt mit 

$ perltidy -html -pre <FILE >FILE.html

eine Quelltext-Darstellung in HTML. Diese kann in die eigene Seite eingebunden werden.

Anpassung 1

Der HTML-Code ist in ein <pre> ohne Klassenanabe eingefasst. Das CSS-Layout dieses <pre> lässt sich also nicht gezielt anpassen. Am besten filtert man es weg und setzt den HTML-Code in ein eigenes <pre>. 

$ perltidy -html -pre <FILE | egrep -v '^</?pre>'

Anpassung 2

Die CSS-Klassennamen müssen an die oben gewählten Namen in der Stylesheet-Datei angepasst werden. 

$ perltidy -html -pre | egrep -v '^</?pre>' | sed -e 's/class="/class="pt-/g'

Resultierender HTML-Code

Aus 

print "Hello world!\n";

wird im HTML-Output (Umbruch hinzugefügt) 

<span class="pt-k">print</span> <span class="pt-q">
  &quot;Hello world!\n&quot;</span><span class="pt-sc">;</span>

und im Browser 

print "Hello world!\n";
Geschrieben von Frank Seitz in Perl um 18:45 | Kommentare (0) | Trackbacks (0)

Perl: Effizient Zeichen zählen

Ist eine FAQ (s. perldoc -q occurrences), aber ich vergesse immer die genaue Syntax, da ich tr/// selten nutze und es mehrere Funktionen in sich vereint: 

$n = $str =~ tr/\n//;

$n ist in diesem Fall die Anzahl der Zeilenumbrüche in $str.

Geschrieben von Frank Seitz in Perl um 12:06 | Kommentare (0) | Trackbacks (0)

Mittwoch, 3. Februar 2010

Apache: Redirection auf Subdirectory

Mit der Direktive Redirect kann ein Seitenzugriff auf eine andere Seite umgeleitet werden. Die Umleitung schließt alle Subpfade ein, also Seiten mit gleichem Pfadanfang.

Möchte man ein Directory auf ein Subdirectory umleiten, klappt dies mit Redirect nicht, weil das zu einer Endlos-Rekursion führt. Die Redirect-Regel 

Redirect /a /a/b

führt bei Aufruf von /a zu der endlosen Kette von HTTP-Aufrufen 

/a
/a/b
/a/b/b
/a/b/b/b
...

bis der Browser dies erkennt und mit einer Meldung wie 

Redirect Loop: Redirection limit for this URL exceeded.

abbricht.

Die Lösung liefert die (leistungsfähigere) Direktive RedirectMatch. Mit dieser lässt sich der umzulenkende Pfad per Regex präzise eingrenzen: 

RedirectMatch /a$ /a/b

Das Dollarzeichen verankert den Pfad /a am Ende des URL, so dass Subpfade nicht mehr matchen und die Rekursion unterbleibt.

Da durch die Regel keine Subpfade weitergeleitet werden, müssen die Zugriffe innerhalb von /a/b relativ sein.

Ist das Ausgangsdirectory das Root-Directory, muss auch der Anfang verankert werden, da jedes Verzeichnis auf / endet: 

RedirectMatch ^/$ /a
Geschrieben von Frank Seitz in Apache um 17:28 | Kommentare (0) | Trackbacks (0)
(Seite 1 von 1, insgesamt 5 Einträge)

Kalender

Zurück Februar '10 Vorwärts
Mo Di Mi Do Fr Sa So
1 2 3 4 5 6 7
8 9 10 11 12 13 14
15 16 17 18 19 20 21
22 23 24 25 26 27 28

Suche

Statistik

Letzter Artikel:
10.04.2013 17:54
87 Artikel insgesamt

Validierung

Valid XHTML 1.0!
Valid CSS!

Links

Video