Englisch: Projects More |
PmWikiDe /
Seiten-Dateiformat
Administratoren (FTP)
Möglicherweise haben Sie viele Dokumente, die Sie gern mit einem lokalen Programm in ein Format umwandeln möchten, das PmWiki anzeigen kann. Sie könnten
FormatNur zwei Zeilen sind in der Datei wirklich notwendig. version=pmwiki-2.1.0 urlencoded=1 text=Markup text "urlencoded=1" sagt PmWiki, dass die Werte urlkodiert (urlencoded) sind. Der aktuelle Wert von "version" spielt keine Rolle, solange nur irgendwo in der Zeile "urlencoded=1" auftaucht. Die Zeile muss aber mit "version=" beginnen. "text=" muss den mit Markups versehenen Text (Quelltext) enthalten, wobei
umgewandelt sein müssen. Zusätzlich kodiert PmWiki beim Schreiben der Seiten '<' als '%3c' (zur Unterstützung der Sicherheit), aber es ist nicht zwingend notwendig, das '<'-Zeichen zu kodieren, damit die Seite gelesen werden kann.
Weitere Umwandlungen könnten in Zukunft dazu kommen.
Damit die Suche und die Damit die targets=GroupName1.Pagename1,GroupName2.Pagename2,... "targets=" ist eine kommagetrennte Liste aller Verweise in dieser Seite auf andere Seiten (ohne Leerzeichen nach den Kommata). SeitenformatattributeSchlüssel, die in einer nackten PmWiki-Datei erscheinen könnten:
in der gleiche Zeile dahinter ggf.:
ordered=1
Darunter sehen Sie Einträge, die die Versionen der Seiten dokumentieren (engl. history). Eine Seite für die Veröffentlichung erzeugenEin einfacher Weg eine Wikiseitendatei zu erzeugen, um sie für die Veröffentlichung zu verwenden (z. B. mit einem Rezept oder einem Skin), ist die Seie mit PmWiki zu erzeugen und anschließend mit einem Texteditor alle Zeilen zu löschen außer version, text, und ctime. Beispiel: version=pmwiki-2.1.0 ordered=1 urlencoded=1 text=This is a line.%0aThis is another. ctime=1142030000 Seitenversionen im Auge behaltenInnerhalb der Seitendatei speichert PmWiki die letzte Version des Quelltextes und nutzt diese, um die Seite zu erzeugen. Die Seitenversionen werden als eine Folge von Unterschieden zwischen der letzten Version der Seite und der jeweils vorigen Seite notiert. PmWiki setzt normalerweise die Versionshistorie an das Ende jeder Seitendatei in umgekehrter chronologischer Reihenfolge und setzt den "order=1" Eintrag in den Kopf. Wenn eine Operation nur die letzte Version der Seite benötigt, wird PmWiki mit dem Einlesen der Datei und dem Verarbeiten der Seite an der Stelle aufhören, wo die Historie beginnt, und spart dadurch möglicherweise viel Zeit und Speicher. Wenn das "ordered=1"-Kennzeichen fehlt, macht PmWiki keine Annahmen über die Reihenfolge der Einträge in der Seitendatei und verarbeitet die gesamte Datei. Die Schlüssel werden von einem Doppelpunkt begrenzt, nicht von einem Gleichheitszeichen. Den Schlüsseln folgt ein Zeitstempel und nach einem Gleichheitszeichen der Wert (z. B.
Seiten von/aus Textdateien ladenSiehe Cookbook: Import text. → Importiere Textdateien als PmWiki-Seiten. Unix-Werkzeug zum Extrahieren von WikitextenDieses einzeilige sed-Kommando extrahiert den Text einer PmWiki-2.x-Datei und gibt ihn aus (kann als alias deklariert werden, z. B. pmcat): sed -n 's/^text=//; s/%0a/\n/gp; s/%3c/</gp; s/%25/%/gp' GroupName.PageName Das folgende Unix-Skript (getestet auf MacOSX) extrahiert und dekodiert den aktuellen Text einer Wikidatei:
#!/bin/tcsh
# wtext - extract wiki text
#
# wtext wikifile > output
set fn = "$1"
if ("$fn" == "") then
echo "need input file parameter"
exit 999
endif
if (! -f $fn) then
echo "$fn does not exist"
exit 999
endif
rm sedin.$$ >& /dev/null
set ch = `grep ^newline= $fn | cut -d= -f2`
if ("$ch" == "") set ch = "%0a"
cat <<eof > sedin.$$
s/^text=//
s/$ch/\
/g
s/%3c/</g
s/%25/%/g
eof
grep "^text=" "$1" | sed -f sedin.$$
rm sedin.$$ >& /dev/null
Siehe auch
Kategorien: PmWiki Developer Übersetzung von PmWiki.PageFileFormat, Originalseite auf PmWikiDe.PageFileFormat — Backlinks
|