Die Bearbeiten-Variablen

für die Liste aller Seiten

Zum Setzen der meisten der unten aufgeführten Variablen tragen Sie sie in die config.php-Datei ein.

%apply=item id=EnableNotSavedWarning?%$EnableNotSavedWarning

Setzen Sie diese Variable auf 1, um Editor*innen davor zu warnen, dass sie die Bearbeitenseite, ohne die Änderungen zu speichern, verlassen. Das basiert auf dem Rezept Cookbook:NotSavedWarning. Per Voreinstellung ist die Warnung nicht aktiv. Wenn Sie sie aktivieren, deaktivieren Sie bitte alle Addons, die ein ähnliches Verhalten erzeugen, insbesondere ältere Versionen von Cookbook:NotSavedWarning.

$EnableNotSavedWarning = 0; # deaktiviere die Warnung, Voreinstellung ist 1 (aktiviert, seit 2.3.0)

%apply=item id=EnableEditAutoText?%$EnableEditAutoText

Setzen Sie diese Variable auf 1, um das vorausschauende Bearbeiten wie automatisch eingefügte Listenpunkte zu aktivieren, siehe Cookbook:EditHelp. Per Voreinstellung ist das deaktiviert. Wenn Sie das aktivieren, deaktivieren Sie bitte alle Addons mit ähnlicher Funktionalität, insbesondere Cookbook:EditHelp.

$EnableEditAutoText = 1;

%apply=item id=AutoCreate?%$AutoCreate

wird in Verbindung mit der 'AutoCreateTargets? edit'-Funktion benutzt, dies Array enthält einen Satz von Seiten, die erzeugt werden sollen, falls sie nicht existieren. Die Syntax ist:

    $AutoCreate[REGEXP] = PAGE_PARAMETERS;

wobei REGEXP ein regulärer Ausdruck ist, der die automatisch zu erzeugenden Seiten identifiziert und PAGE_PARAMETERS ein Array von Attributen für die neu zu erzeugenden Seiten ist. Zum Beispiel:

    $AutoCreate['/^Category\\./'] = array('ctime' => $Now);

erzeugt eine leere Seite mit der aktuellen Erstellungszeit für alle fehlenden Kategorien-Seiten.

%apply=item id=DefaultPageTextFmt?%$DefaultPageTextFmt

Der Text, der angezeigt werden soll, wenn eine Seite nicht gefunden wurde. PmWiki benutzt dazu den Inhalt der Seite Site.PageNotFound.

$DefaultPageTextFmt = '(:include $[{$SiteGroup}.PageNotFound]:)';

%apply=item id=DeleteKeyPattern?%$DeleteKeyPattern

Das Muster, das verwendet wird, um zu löschende Seiten zu markieren. Der Standard ist, dass Seiten gelöscht werden, die nur das eine Wort "delete" und sonst höchstens Leerzeichen enthalten.

## ändere Löschenwort auf "remove":
$DeleteKeyPattern = "^\\s*remove\\s*$";
## lösche Seiten ohne sichtbaren Text, d. h. leere Seiten:
$DeleteKeyPattern = "^\\s*$";

%apply=item id=DiffKeepDays?%$DiffKeepDays

Diese Variable setzt die minimale Zeitspanne fest, während der die Versionen von Änderungen aufbewahrt werden. Standard sind 3650 Tage, fast 10 Jahre. Sie können den Wert durch einen Eintrag in eine Anpassungsdatei (z. B. local/Gruppe.Seitenname.php) verringern, z. B.:

    $DiffKeepDays = 30; # Revisionen wenigstens 30 Tage aufbewahren

Wollen Sie für eine Seite die Versionen der Änderungen ganz unterdrücken, fügen Sie in die Anpassungsdatei das Folgende ein:

    $DiffKeepDays = $DiffKeepNum = -1; # suppress revision history

(siehe auch Individuelle Anpassungen pro Seite)

Beachten Sie, dass eine bestimmte Seitenrevision nicht gelöscht wird, bis die Seite nach der eingestellten Zeit wieder geändert wird. So ist es immer noch möglich, Seiten wiederherzustellen, deren Änderung länger zurückliegt als die eingestellte Zeitspanne, wenn sie nach dieser Zeit nicht mehr angerührt wurden. Die Änderungen werden bei der nächsten Änderung (z. B. bei eben diesem Wiederherstellen) gelöscht.

%apply=item id=DiffKeepNum?%$DiffKeepNum

Diese Variable enthält die Mindestzahl an Änderungen, die in den Versionen aufgehoben werden, sogar wenn einige von ihnen älter sind als die eingestellte Grenze $DiffKeepDays. Das verhindert den Verlust von Änderungen auf Seiten, die lange bestehen, aber selten geändert wurden.

## Behalte wenigstens 50 Änderungen (Standard ist 20): 
$DiffKeepNum = 50;

Um die Aufbewahrung der Änderungen mit $DiffKeepNum = -1 zu unterdrücken, siehe $DiffKeepDays weiter oben.

%apply=item id=DraftActionsPattern?%$DraftActionsPattern

Die Aktionen, die es erlauben, die volle draft.php-Funktionalität für eigenen Aktionen zu laden. Voreingestellt ist 'edit'. Sie können Entwürfe auch für weitere Aktionen aktivieren:

## Aktiviere Entwürfe für die Aktionen 'edit', 'pmform' und 'translate':
$DraftActionsPattern = 'edit|pmform|translate';

%apply=item id=DraftSuffix?%$DraftSuffix

Der Anhang für die Entwurfsversion von Seiten (Standard ist "-Draft").

%apply=item id=EditFunctions?%$EditFunctions

Dieses Array enthält die Sequenz der Funktionen, die aufgerufen werden, wenn eine Seite editiert wird. Es kann angepasst werden, um zusätzliche Funktionen einzufügen und diese zum Bestandteil des Veröffentlichungsprozesses zu machen. Die Standardeinstellung ist:

$EditFunctions = array('EditTemplate', 'RestorePage', 'ReplaceOnSave',
                       'SaveAttributes', 'PostPage', 'PostRecentChanges',
                       'AutoCreateTargets', 'PreviewPage'); 

Viele Rezepte manipulieren dieses Array, deshalb wird empfohlen, statt das komplette Array neu zu definieren, Funktionen wie array_unshift(), array_push() und array_splice() zu benutzen.

%apply=item id=EditRedirectFmt?%$EditRedirectFmt

Die Seite, zu der ein Autor geführt wird, nachdem er den Speichern- oder Abbrechen-Button in dem Editierformular gedrückt hat, per Standard gesetzt auf "$Fullname", wodurch der Autor auf die gerade bearbeitete Seite geführt wird, aber das kann verändert werden, um eine andere Seite anzuzeigen.

## Umleiten zur Hauptstartseite Main.HomePage:
$EditRedirectFmt = 'Main.HomePage';  
## Umleiten zur Startseite der aktuellen Gruppe:
$EditRedirectFmt = '{$Group}.HomePage';

%apply=item id=EditTemplatesFmt?%$EditTemplatesFmt

Name der Seite (oder ein Array von Namen), die als Vorlage benutzt wird (werden) für neu anzulegende Seiten.

## Benutze 'Main.NewPageTemplate' als Standardtext für alle neuen Seiten:
$EditTemplatesFmt = 'Main.NewPageTemplate';
## Benutze 'Template' in der aktuellen Gruppe als Vorlage:
$EditTemplatesFmt = '$Group.Template';
## Benutze 'Template' in der aktuellen Gruppe, wenn die Datei existiert,
## andernfalls benutze 'Main.NewPageTemplate':
$EditTemplatesFmt = array('$Group.Template', 'Main.NewPageTemplate');

%apply=item id=EnableDrafts?%$EnableDrafts

Wenn diese Variable auf '1' gesetzt wird, wird unterm 'Bearbeiten'-Fenster ein 'Als Entwurf speichern'-Button angezeigt und die eingebaute Handhabung von Entwürfen eingeschaltet, wobei

1. erstmaliges 'Als Entwurf speichern' einer existierenden Seite ("SeitenName?") die Änderungen in einer neuen Seite mit dem Namen ("SeitenName?-Draft") speichert,
2. nachfolgende Versuche, "SeitenName?" zu bearbeiten, in der Bearbeitung von "SeitenName?-Draft" münden,
3. nachfolgendes 'Als Entwurf speichern' das Speichern der Änderungen in der Datei "SeitenName?-Draft" bewirkt,
4. erst der Button 'Veröffentlichen' das Speichern der Änderungen in der Datei "SeitenName?" und das Löschen des Entwurfes "SeitenName?-Draft" bewirkt,
5. ein Aufruf der Seite ohne ''action=edit' die "alte" Seite anzeigt.

   ## Einschalten der Entwurfsversionen:
   $EnableDrafts = 1;

Eine verwandte Variable, $EnablePublishAttr, fügt eine neue Ebene zum Autorisieren der Veröffentlichung ein, um eine Unterscheidung zwischen dem Editieren von Entwürfen und deren Veröffentlichung zu erreichen.

%apply=item id=EnableDraftAtomicDiff?%$EnableDraftAtomicDiff

Wenn diese Variable auf '1' gesetzt wird, werden durch das Veröffentlichen eines Entwurfes die Entwurfsversionen gelöscht. Es bleibt eine einzige alles zusammenfassende Änderung (diff) übrig zwischen der zuvor veröffentlichten Version und der letzten veröffentlichten Version, dem nun veröffentlichten letzten Entwurf.

Beachten Sie, dass dadurch auch die Autorennamen, die Daten und die Beiträge der unveröffentlichten Entwurfsversionen gelöscht werden. (Drafts müssen aktiv sein, siehe $EnableDrafts.)

%apply=item id=EnableGUIButtons?%$EnableGUIButtons

Wenn diese Variable auf '1' gesetzt wird, werden die grafischen Buttons am oberen Rand der Editierfeldes angezeigt.

## Schalte die grafischen Bearbeiten-Buttons ein:
$EnableGUIButtons = 1;

%apply=item id=EnableGuiEditFixUrl?%$EnableGuiEditFixUrl

Aktiviert einen -Button im Editor, der dabei hilft, spezielle Zeichen in URL-Links zu kodieren, siehe Cookbook:GuiButtons. Enthält der Link die Zeichen <>"{}|\^`()[]', müssen diese durch ihre Prozentdarstellung ersetzt werden.(z. B. '%20' für ein Leerzeichen, siehe Cookbook:FixURL). $EnableGUIButtons muss dazu aktiviert sein.

## Setze den Button weit nach rechts in der Buttonleiste:
$EnableGuiEditFixUrl = 2000;

%apply=item id=EnablePreviewChanges?%$EnablePreviewChanges

Wenn diese Variable auf '1' gesetzt wird, zeigt die "Vorschau"-Funktion die hervorgehobenen Änderungen im Wiki-Quelltext vor der erstellten Seitenvorschau. Siehe Cookbook:PreviewChanges.

$EnablePreviewChanges = 1;

%apply=item id=EnableListIncludedPages?%$EnableListIncludedPages

Wenn diese Variable auf 1 gesetzt ist, fügt sie in der Bearbeiten-Seite eine Liste mit Seiten ein, die in die bearbeitete Seite eingefügt sind, entweder über ein Einbinden anderer Seiten oder über Seiten-Text-Variablen (und weitere verschachtelte Seiten und Variablen). Die Liste erscheint in einem zusammengeklappten <details>-Element zwischen dem Textbereich und dem 'Zusammenfassung'-Feld.

%apply=item id=EnablePostAuthorRequired?%$EnablePostAuthorRequired

Wenn diese Variable auf '1' gesetzt wird, erfordert das Bearbeiten von Seiten – eigentlich erst das Speichern der Seiten – die Angabe eines Autorennamen. Andernfalls kann ohne einen Namen gearbeitet werden, als Autorenname erscheint dann die IP des Autors.

## Verlange vom Autoren die Angabe eines Namen:
$EnablePostAuthorRequired = 1;

%apply=item id=EnableUploadAuthorRequired?%$EnableUploadAuthorRequired

Diese Variable bestimmt, ob das Hochladen von Dateien die Eingabe des Namen des Hochladenden erfordert (hinzugefügt in 2.2.117). Wenn diese Variable nicht gesetzt ist, wird die Variable $EnablePostAuthorRequired ausgewertet.

%apply=item id=EnableRevUserAgent?%$EnableRevUserAgent

Wenn diese Variable auf '1' gesetzt wird, wird der "User agent"-String des Browsers in den Seitenversionen gespeichert (standardmäßig ist das deaktiviert). Das kann nützlich sein, wenn man Fehler in einer eigenen Applikation aufspüren will, indem man die Dateien in wiki.d/ untersucht.

## Speichere den "User agent" des Browsers in den Seitenversionen:
$EnableRevUserAgent = 1;

%apply=item id=GUIButtons?%$GUIButtons

Erlaubt die Konfiguration der Schaltflächen, die über dem Eingabefeld erscheinen, wenn man eine Seite bearbeitet. Siehe scripts/guiedit.php wegen der Standarddefinition. Beachten Sie, dass das fünfte Element auch HTML-Kode sein kann anstelle des URL einer GIF-Datei – das erlaubt mehr Flexibilität in der Definition des diesbezüglichen JavaSkripts?.

%apply=item id=HandleEditFmt?%$HandleEditFmt

Wie $HandleBrowseFmt gibt dies das vollständige Ausgabeformat einer Seite für ?action=edit an.

%apply=item id=IsPagePosted?%$IsPagePosted

wird auf einen Wahr-Wert gesetzt, wenn die Seite aktuell gespeichert wurde (das wird z. B. benutzt, um den 'Aktuelle Änderungen'-Behandlern (RecentChanges handlers) zu signalisieren, dass ein Update nötig ist.

%apply=item id=PageEditFmt?%$PageEditFmt

ist per Standardeinstellung der HTML-Kode, der als Bearbeitenformular angezeigt wird.

%apply=item id=PageEditForm?%$PageEditForm

gibt das Bearbeitenformular für die Aktion Bearbeiten (?action=edit) an, standardmäßig '$SiteGroup.EditForm?'.

%apply=item id=ROEPatterns?%$ROEPatterns

Mit diesem Array können Sie Muster als Schlüssel hinzufügen und Text als Wert setzen, der das Muster bei jedem Aufruf zum Editieren ersetzt, wobei die preg_replace-Funktion benutzt wird. Insbesondere werden die Ersetzungen vorgenommen, wenn die Seite in das Editierformular eingefügt wird, wann auch immer eine Vorschau vorgenommen wird und wenn die Seite gespeichert wird. (ab PmWiki 2.2.0beta45). Siehe Cookbook:ROSPatterns für Beispiele.

%apply=item id=ROSPatterns?%$ROSPatterns

Mit diesem Array können Sie Muster als Schlüssel hinzufügen und Text als Wert setzen, der das Muster ersetzt, wenn die bearbeitete Seite veröffentlicht wird (geposted wird), wie es durch die Variable $EnablePost signalisiert wird. Das Muster wird weder ersetzt, wenn die Seite in das Editierformular eingefügt wird, noch wenn eine Vorschau vorgenommen wird, sondern nur, wenn die Seite gespeichert wird. Siehe Cookbook:ROSPatterns für Beispiele.

%apply=item id=EnableROSEscape?%$EnableROSEscape

Wenn diese Variable auf '1' gesetzt wird, werden die $ROEPatterns- und die $ROSPatterns-Ersetzungen geschützten Text (umgeben von [=...=] oder [@...@]) überspringen. Nicht gesetzt oder auf 0 gesetzt werden die Ersetzungen sogar in geschütztem Text vorgenommen.

Kategorie: PmWiki Developer für die Liste aller Seiten