unit tests MDL-22017 made test_usergetdate() work on machines in different timezones

[moodle.git] / mod / wiki / ewiki / README.de

README.de
���������
Dies ist eine teilweise �bersetzung der README Datei, die weiterhin als
Referenz verwendet sollte, da hier nur ein paar allgemeine und Setup-
Informationen enthalten sind.

      1  Was ist das?
    1.1  Warum "ErfurtWiki"?
    1.2  WikiAlternativen
    1.3  Autor
    1.4  ProjektSeiten
    1.5  Support bekommen
    1.6  Lizens

      2  Wie jetzt?
    2.1  In yoursite.php integrieren
    2.2  Den WikiSeitenNamen bestimmen
  2.9.1  WikiSprache einstellen (deutsch)

      3  Im Detail
    3.1  die ewiki_ Funktionen
    3.2  $GLOBALS Verschmutzung
    3.3  die EWIKI_ Konstanten
    3.4  $ewiki_config[] array

    4.1  Nur die WikiQuelltextTransformation einsetzen

  6.1.2  Ohne MySQL DB verwenden     (WICHTIG)
  6.1.3  db_fast_files
  7.3.3  B�seB�ckSl�shes \\\\"       (WICHTIG)

  9.5.5  Pa�w�rter und tools/



  -------------------------------------------------------------------------



Was ist das?
������������
Dies ist eine "WikiWikiWeb" Bibliothek, die in der PHP Webskriptsprache
implementiert ist. Ein WikiWiki ist eine Webseite, die von wirklich jedem
ver�ndert/erg�nzt werden kann, der dort vorbeischaut (ohne vorhergehenden
Registrierungskram).

Es sollte relativ einfach in bestehende Websites integrierbar sein,
weil es eben kein komplettes Script sondern vielmehr eine Bibliothek
ist, die kein fertiges Seitenlayout erzwingt. Stattdessen k�nnen die
erzeugten WikiSeiten als Inhalt in das Layout einer bestehenden Seite
eingebunden werden.



Warum "ErfurtWiki"?
�������������������
Meine Heimatstadt (Erfurt liegt nahe bei Weimar.de) - und das ist wirklich
nix weiter als ein Name! Der interne Projektname ist �brigens "ewiki".


Warum sollte man ausgerechnet dieses Wiki verwenden wollen?

 - es ist wirklich alles notwendige in einer einzigen Skriptdatei, so
   da� keine 20 anderen Dateien mit herumliegen m�ssen, wenn man es
   in die eigene Site einbindet

 - vordefinierte Layouts werden nicht aufgezwungen, es gibt Beispielseiten
   aber keine Skins oder Themes aus denen man w�hlen m��te; das Wiki pa�t
   sich wirklich in eine existierende Seite ein

 - es ist vergleichsweise schnell, regul�re Ausdr�cke werden zwar auch hier
   verwendet, aber nicht so exzessiv wie in anderen Wikis
   (haupts�chlich einfache und flinke String-Funktionen)

 - der Funktionsumfang ist inzwischen beachtlich :)



WikiAlternativen
����������������
Es gibt auch noch andere h�bsche WikiWare, falls jemand hiermit nicht
gl�cklich werden tut:

* PhpWiki ist deutlich vollst�ndiger,
  siehe http://freshmeat.net/projects/phpwiki,
  unterst�tzt versch. Datenbanktypen, Lokalisierung, integrierter
  Administrationsbereich

* Miki ist eine kleine WikiImplementierung in PHP von Jukka
  Zitting.  http://miki.sourceforge.net/

* http://coWiki.org/ ist tats�chlich mehr ein CMS denn ein Wiki

* Und schlie�lich: sfWiki - das sourceforge Wiki (daher auch zu finden
  bei http://sfwiki.sourceforge.net/). Teile der WikiSyntax sieht ein
  wenig merkw�rdig aus, ein paar andere Sachen sind ganz nett; und es
  unterst�tzt Benutzerauthentifizierung

* f�r andere Wikis in anderen Programmiersprachen einfach mal die
  Suchmaschienen nerven:
  http://www.freshmeat.net/search/?q=wiki&section=projects
  http://www.google.com/search?q=wiki



Autor
�����
Mario Salzer <milky*erphesfurt�de>
ICQ95596825 und Yahoo: icq95596825

Und alle anderen wurden in die Datei CREDITS verbannt  ;->

Dies ist ein relativ neues Projekt. Um es zu verbessern, bin ich sehr
auf R�ckmeldungen angewiesen. Jede Mail ist ein wertvoller Beitrag!



ProjektSeiten
�������������
freshmeat
- http://freshmeat.net/ewiki

demo:
- http://erfurtwiki.sourceforge.net/

neueste Versionen (instabile EnwicklerVersionen):
- http://erfurtwiki.sourceforge.net/downloads/



Support bekommen
����������������
Hilfe bei der Installation gibt's nat�rlich, und selbstverst�ndlich sind
wir auch dankbar f�r jeden Hinweis �ber bestehende Probleme und Fehler
(bekannterma�en ist die REAMDE noch nicht ausf�hrlich genug und stellenweise
�berhaupt keine Hilfe).
Bevor du aber einen BugReport versendest, lies dir bitte folgende Anleitung
durch (absolut notwendig um KOSTENLOSEN support zu bekommen):

http://www.lugbz.org/documents/smart-questions_de.html

Danach bitte nicht z�gern, einen der Autoren zu kontakten oder einfach eine
Nachricht in BugReports oder UserSuggestion auf unserer ProjektSeite zu
hinterlassen.
Wenn du dich auf unserer http://erfurtwiki.sourceforge.net/?MailingList
anmeldest, hast du die M�glichkeit Hilfe f�r dein Problem von einer gr��eren
Gruppe von Leuten zu bekommen (an- und wieder abmelden geht schnell).



Lizens
������
Dieses "Programm" wird als "Public Domain" vertrieben. Public Domain
ist wie "FreeWare", nur ein bischen mehr frei ;->  Man kann sich das
vorstellen, wie die GPL ohne an die GPL gebunden zu sein. (Tats�chlich
wollte ich einfach keine LICENSE Datei mitreinpacken, die gr��er ist als
das eigentliche Programm.)

Da dies ein freies (Bier) St�ck Software ist, kann mich nat�rlich
niemand f�r irgendwelche Fehler oder all die WIRKLICH SCHLIMMEN
FESTPLATTEN-SCH�DEN verantwortlich machen, die bei der Verwendung
entstehen k�nnten ;>




  -------------------------------------------------------------------------




Wie jetzt?
����������
ewiki ben�tigt:

- Webserver (Apache, Nanoweb, ...)
- PHP 4.1 oder neuer
- nach Mglk. eine MySQL Datenbank (l�uft aber auch ohne)
- deine bereits exitierenden Webseite
- die wundervollen "magic slashes" in antiken PHP version sollten wirklich
  abgeschalten sein

Wenn du keine MySQL-Datenbank hast, dann verwende die Erweiterung f�r
die Datei-Datenbank.



In yoursite.php integrieren
���������������������������
In den n�chsten Abschitten, soll mit dem Begriff "yoursite.php" der
Teil deiner bestehenden Seite verstanden werden, der das Seitenlayout
erzeugt (der also zumindest die <html><body> Tags um die Ausgaben von
ewiki.php bastelt).
Die schlichteste L�sung findet sich auch noch mal in example-2.php:

    <HTML>
    <BODY>
    <?php

       mysql_connect("localhost", "DB-USER-NAME", "PASSWORD");
       mysql_query("use DATABASE-NAME-HERE");

       define("EWIKI_SCRIPT", "yoursite.php?page=);
       error_reporting(0);

       include("ewiki.php");

       echo   ewiki_page();

    ?>
    </BODY>
    </HTML>

Die ersten beiden Befehle �ffnen eine Verbindung zur MySQL-Datenbank,
normalerweise w�rde man das Ergebnis von mysql_conect() in einer Variable
wie "$db" ablegen, aber da PHP ohnehin nicht auf deren Verwendung besteht,
wenn es nur eine DB-Verbindung gibt, wird eine solche Variable in
"ewiki.php" auch gar nicht verwendet (und der Name dieser Variable w�re
damit hier egal).

Der Wert in der define() Zeile sagt ewiki wie die Hyperlinks zu den
referenzierten WikiSeiten lauten m�ssen, damit ewiki.php auch f�r die
n�chste angeklickte WikiSeite aufgerufen wird.
Wenn du nur ein einziges "yoursite.php" Skript hast, wirst du den Wert
direkt in "ewiki.php" ver�ndern wollen.

Das error_reporting(0) wird sehr empfohlen.

Das include("ewiki.php") l�dt endlich die ewiki "Bibliothek" und setzt
alle bis hierher noch nicht definierten EWIKI_ Konstanten.

Der Aufruf der ewiki_page() Funktion gibt diejenige WikiSeite zur�ck, die
vom Browser angefragt wurde. Du mu�t hier "echo" davorsetzen, denn sonst
wird der Text nicht ausgegeben (verpufft im PHP-Nirvana) - ewiki gibt die
erzeugte Seite nicht selber aus.



Den WikiSeitenNamen bestimmen
�����������������������������
Wenn du ewiki_page() einfach so aufrufst wie im oberen Beispiel angegeben
(empfohlen), dann wird es versuchen, den Namen der angefragten Seite selber
zu ermmitteln ($_SERVER["PATH_INFO"] oder GET-Variablen '?id=' oder '?name='
oder '?page=' oder '?file=' in $_REQUEST["name"]).

Wenn yoursite.php aber einen anderen Weg benutzt (andere Parameternamen),
um den WikiSeitenNamen zu �bergeben, dann kann man ihn schlicht als ersten
Parameter angeben:

  ewiki_page( $id = "WikiSeitenNanem" );


Example-4.php zeigt das beispielsweise, um die Liste der aktualisierten
Seiten einzubinden.





WikiSprache einstellen (deutsch)
��������������������������������
Ich hab es jetzt schon einige Leute behaupten h�ren, aber auch beim
IntranetExplodierer kann man die "bevorzugten Sprachen" irgendwo einstellen.
Wers nicht findet, kann ja auch gleichmal auf einen aktuellen Browser
wechseln - das lohnt sich nicht nur wegen der vielen Seiten, die es dann
pl�tzlich doch auf Deutsch gibt!

Wer es partou nicht hinbekommt, kann nat�rlich die deutsche Sprache f�r
ewiki erzwingen; hilfreich hierf�r ist z.B. die include()-Datei
"fragments/force_lang_de.php".

Es funktioniert aber auch mit diesem Befehl, der irgendwo in ewiki.php,
config.php oder yoursite.php eingef�gt werden kann (nicht empfohlen):

$_SERVER["HTTP_ACCEPT_LANGUAGE"] = "de; q=1.0, en; q=0.2, eo, nl";




  -------------------------------------------------------------------------




Im Detail
���������
Die MySQL DB Tabellenstruktur ist zu einem gewissen Grad kompatibel mit der
des allseits bekannten �PHPWiki� (normalerweise reicht es EWIKI_DB_TABLE_NAME
auf "wiki" zu �ndern, um PhpWikis DB weiterzuverwenden).
Dies ist der MySQL Befehl, der die DB-Tabelle erstellt (beim ersten Start,
automatisch):

    CREATE TABLE ewiki (
        pagename VARCHAR(160) NOT NULL,
        version INTEGER UNSIGNED NOT NULL DEFAULT 0,
        flags INTEGER UNSIGNED DEFAULT 0,
        content MEDIUMTEXT,
        author VARCHAR(100) DEFAULT 'ewiki',
        created INTEGER UNSIGNED DEFAULT 0,
        lastmodified INTEGER UNSIGNED DEFAULT 0,
        refs TEXT,
        meta TEXT,
        hits INTEGER UNSIGNED DEFAULT 0,
        PRIMARY KEY id (pagename, version)
    )

Den Spaltennamen {pagename} mochte ich eigentlich nicht, aber weil das der
offensichtlich einzige Unterschied zur PhpWiki-Tabelle war, kam mir die Idee
mit der Kombatibilit�t un so hab ich das adaptiert.
Dummerweise mu� nun die ewiki_database() Funktion "pagename" st�ndig von
und nach "id" �bersetzen.

Die Spalte {version} wird zur Speicherung der verschiedenen abgelegten
Seiten�nderungen verwendet. In anderen Wikis gibt es zu diesem Zweck eine
Bonus-tabelle wie "backup" oder "history", aber ich hab den Sinn von sowas
bisher nicht verstanden; und daher gibt es in ewiki nur diese eine Tabelle
(und das scheint absolut zu reichen)!
Die erste {version} einer Seite erh�lt die Nummer 1. Eine bestehende
Seiten {version} wird niemals �berschrieben werden => sehr sicherer MySQL-
Einsatz.

Mehr �ber die {flags} in dem entsprechenden Abschnitt in der README. Das
Feld {content} enth�lt nat�rlich den WikiSeitenQuelltext. {created} und
{lastmodified} enthalten die entsprechenden Zeitangaben im UNIX format.

{refs} enth�lte eine "\n" - getrennte Liste von referenzierten WikiSeiten.
Der Code um diese List zu erzeugen ist etwas unsauber, so da� oftmals
GeisterSeiten aufgef�hrt sind. Wieauchimmer, da� beeintr�chtigt ewiki
nicht wirklich, und eine Korrektur w�re Zeit- und Geschwindigkeits-
verschwendung.

{meta} kann Bonusinfos enth, so da� die Tabellenstruktur nicht bei jeder
Erweiterung ge�ndert werden mu�. Aktuell nur f�r Bin�rdaten (Bilder)
verwendet.

{hits} z�hlt die Seitenaufrufe, und ist nicht in {meta} integriert, weil
separat schneller und einfacher zu verwenden.

Die ewiki DB Tabelle kann nicht nur Texteseiten enthalten, sondern auch
bin�ren Inhalt (vornehmlich Bilder), siehe {flags}.

Das Ein-Tabellen-Konzept hat es �brigens auch recht einfach gemacht, das
Datei-basierte DB-Backend zu entwickeln. Eine Beispieldatei:

   id: WikiPageName\r
   version: 1\r
   flags: 1\r
   author: 127.0.0.1:3054\r
   created: 1046532697\r
   lastmodified: 1046532697\r
   refs: \nErfurtWiki\nNewestPages\n\r
\r
   !! WikiSourceContent
   <more-text>...




ewiki_ Funktionen
�����������������
Einige der Basis-Funktionen aus ewiki.php k�nnen getrennt von den anderen
verwendet werden, andere sind ausgelegt um durch bessere Implementierungen
ersetzt zu werden.


   ewiki_page($id)
   ---------------
       Hauptfunktion, die die angefragte WikiSeite (oder die mit $id
       angegebene) aus der DB holt, und mit ewiki_format() die fertige
       HTML-Seite erzeugt.
       Wenn die angefragte Seite nicht existert, wird eine edit-Box
       zur�ckgegeben.


   ewiki_page_...()
   ----------------
       Die meisten Fkt. mit diesem Prefix wurden aus der Hauptfkt.
       herausgetrennt, um ewiki �bersichtlicher und leichter erweiterbar
       zu machen.
       Die meisten enthalten Code um spezielle/interne Seiten zu erzeugen
       (Suche, Neuest, Info, und das Edit <FORMular>, ...)


   ewiki_script()
   --------------
       Erzeugt URL aus angegebener Seiten $id und $action, verwendet dazu
       die EWIKI_SCRIPT-Konstante. Dieser wrapper erm�glicht es auch die
       eigentlich reservierten Schr�gstriche in Seitennamen zu verwenden.


   ewiki_control_links($id, $data)
   -------------------------------
       Gibt die Zeile mit "DieseSeite�ndern, SeitenInfo, ... links" aus.


   ewiki_format($wiki_source, $scan_links=1, $html_allowed=0)
   ----------------------------------------------------------
       Erzeugt die formatierten (HTML) Ausgabe f�r den �bergebenen
       WikiQuelltext.

       Der zweite Parameter gibt an, ob nach denen im Quelltext referenzierten
       WikiLinks in der DB nachgesehen werden soll. Wenn dieser  Parameter 0
       ist, dann wird eine bereits vorh. $ewiki_links Array stattdessen
       verwendet, um zu pr�fen ob eine Seite in der DB vorh. ist.


   ewiki_link_regex_callback()
   ---------------------------
       Aufgerufen aus ewiki_format(). Um ewiki_format() {die eigentliche
       WikiEngine} weiter von der Datenbank zu trennen, verwendet diese
       Fkt. das globale array in $ewiki_links, in dem normalerweise vorher
       schon gefundene WikiSeiten eingetragen wurden (siehe zweiter Param.
       von ewiki_format) um entweder einen normalen Verweis oder einen
       Fragezeichen-Link auszugeben (wenn die angegebene Seite noch nicht
       exisitiert).


   ewiki_binary()
   --------------
       Wird automatisch aufgerufen, wenn das Skript mit dem ?binary= Anhang
       aufgerufen wird, um referenzierte / hochgeladene Bilder auszugeben.


   ewiki_author()
   --------------
       erzeugt einen String, der mit REMOTE_ADDR und $ewiki_author
       angereichert wurde.


   ewiki_database($FUNCTION, $args=array() )
   ------------------------------------------
       Diese Funktion ist die "Datenbankabstraktion" in ewiki. Sie enth�lt
       ''only'' sechs SQL Kommandos, die ersetzt werden m��tem, wenn du eine
       andere DB verwenden mu�t.
       Die einzelnen "atomaren" Funktionen sind beschrieben in der
       orignialen README-Datei.





$GLOBALS Verschmutzung
����������������������
Zumindest die ewiki_page() Funktion erzeugt einige Variablen im globalen
Namensraum. Nat�rlich haben auch diese Namen, die sich mit irgendetwas
aus yoursite.php �berschneiden sollten:

 $ewiki_id      - Enth�lt die DB-$id der aktuellen Seite, ist nicht
                  immer identisch mit $ewiki_title.

 $ewiki_action  - Der $action-Parameter, mit dem die Seite angefordert
                  wurde.

 $ewiki_title   - Wird nach dem ersten Aufruf von ewiki_page() gestzt,
                  am n�tzlichsten um in dem <TITLE> Tag ausgegeben
                  zu werden - daf�r mu� aber ewiki_page() schon im
                  Kopfbereich aufgerufen werden, die Ausgabe gepuffert,
                  damit der Seitentitel noch innerhalb von <HEAD>
                  ausgegeben werden kann.

 $ewiki_script  - Eine Kopie von EWIKI_SCRIPT.

 $ewiki_links   - Ist ein Arraym da� in ewiki_format() prodiziert wird, und
                  alle gesuchten WikiSeitenNamen mit einem Wert von 0 oder 1
                  assoziiert, je nach dem, ob die Seite existiert oder nicht.
                  Wird diese variable jedoch auf ==true gesetzt (also kein
                  Array), wird angenommen, da� alle WikiSeiten existieren.

 $ewiki_author  - Der Inhalt dieser Variable wird in der {author}-Spalte
                  von gespeicherten WikiSeiten abgelegt (zusammen mit
                  IP:PORT).
                  Wenn yoursite.php Benutzer kennt und authentifizieren
                  kann, sollte der Nutzername hier abgelegt werden.
                  Diese Feld sollte aber NICHT ZUGEM�LLT werden mit
                  irgendwelchen Bonusinfos.

 $ewiki_auth_user  - Enth�lt Namen eines wirklich authentifizierten
                  Benutzers im _PROTECTED_MODE. Nicht notwendig, wird aber
                  u.a. gerne von ewiki_auth() und ewiki_auth_user() zur
                  Vereinfachung verwendet.

 $ewiki_ring    - Berechtigungslevel im _PROTECTED_MODE
                  3 = nur lesen
                  2 = normaler Benutzer (lesen, editieren, ...)
                  1 = Moderator (auch Seiten l�schen?)
                  0 = Administrator (darf alles)

 $ewiki_plugins - Dieses array verbindet Aufgabengruppen (z.B. "database"
                  oder "image_resize") mit Funktionsnamen.
                  Dies stellt einen wirklich einfachen und dennoch m�chtigen
                  Weg dar, um ewiki zu erweitern.
                  Es gibt ein eigenes Kapitel dar�ber in der orig. README.

 $ewiki_config  - Ersetzt teilweise die EWIKI_ Konstanten.

Folgende gibt's nich mehr (teilweise in $ewiki_config):

 $ewiki_data, $ewiki_interwiki, $ewiki_internal_pages,





EWIKI_ Konstanten
�����������������
- - WARNUNG - WARNUNG -  WARNUNG - WARNUNG - WARNUNG -  WARNUNG - WARNUNG - -
WARNUNG: Dieser Abschnitt ist grunds�tzlich besonders inaktuell! Von daher
sollte ein Studium des gleichnamigen Abschnitts in der orig. README-Datei
wirklich vorgezogen werden!! Viele der neu hinzugekommenen Konstanten werden
hier schlichtweg nicht erw�hnt, oder inzwischen sogar __falsch__ beschrieben.
- - WARNUNG - WARNUNG -  WARNUNG - WARNUNG - WARNUNG -  WARNUNG - WARNUNG - -

Dieser Abschnitt erkl�rt einige der Konstanten und wie man sie verwenden
kann, um ewiki nach der eigenen Pfeife tanzen zu lassen.

Normalerweise solltest diese innherhalb von "ewiki.php" angepa�t werden, einige
sind jedoch mehr wie Statusvariablen ausgelegt und sollten von "yoursite.php"
in Abh�ngigkeit von dort vorhanden Infos gesetzt werden (wenn dort Benutzer
eingeloggt sind z.B.).
Dann ist es gut einige der Konstanten vorzudefinieren (einmal def. Konst.
k�nnen nicht wieder ge�ndert werden).


 EWIKI_SCRIPT
     Wichtigste Einstellung. Wird von ewiki.php verwendet, um Links zu
     anderen WikiSeiten zu erzeugen.

     Es ben�tigt den Namen von yourscript.php, da� selbst wiederrum
     ewiki.php geeignet einbindet.
     Der Name der angefragten WikiSeite wird immer schlicht an den hier
     definierten TextString angeh�ngt, daher sollter dieser immer in
     "/" oder "?" oder "?id=" oder "?name=" oder "?page=" enden, damit
     eine g�ltige URL dabei herauskommt und der SeitenName von ewiki_page()
     gefunden wird.

     Wenn auf deinem Server mod_rewrite vorhanden ist und funktioniert,
     k�nntest du diese Konst. auch leer lassen, so alle Anfragen zu
     http://wiki.example.com/ an das richtige Skript �bergeben werden.
     Ansonsten ist es gut, wenn eine URL absolut zum Server-Hauptpfad
     angegeben ist, also z.B. "/~user/wiki/index.php/", damit Browser
     keine ung�ltigen URLs erzeugen, sobald eine $action vor den
     Seitennamen gesetzt wird (z.B. "edit/DieseSeite").

     Die Konstante wird von ewiki_script() eingesetzt um URLs zu den
     angegebenen Seiten zu erstellen (wobei einige Fehler abgefangen
     werden).

 EWIKI_SCRIPT_URL
     Sollte eine absolute URL enthalten, die ebenfalls zum ewiki-wrapper
     zeigt, z.B. "http://www.example.com/wiki/?id="


 EWIKI_DB_TABLE_NAME
     Setzt den Namen der MySQL DB Tabelle fest, die erzeugt und verwendet
     werden soll, um alle WikiSeiten abzulegen.


 EWIKI_PAGE_INDEX
     Definiert den Namen der WikiSeite, die als Startseite angezeigt werden
     soll.
 EWIKI_PAGE_NEWEST
     Name (intern erzeugt) der Seite, die List der zuletzt hinzugef�gten
     Seiten enth�lt.
 EWIKI_PAGE_SEARCH
     Enth�lt den WikiSeitenNamen f�r dei SuchFunktion.


 EWIKI_CONTROL_LINE
     Wenn auf 0 gestzt, wird die Zeile unter einer WikiSeite mit
     "DieseSeite�ndern, SeitenInfo, ..." nicht angezeigt.
     In diesem Fall sollte der Edit-Link in yoursite.php erzeugt werden.
     Besser ist es normalerweise das Aussehen der Ausgabe in
     ewiki_control_links() selbst zu �ndern.

 EWIKI_AUTO_EDIT
     Bei 1 (voreinstellung) wird automatisch eine Edit-Box f�r
     nicht-exisiterende Seiten angezeigt, ansonsten wird eine ZwischenSeite
     ("Bitte �ndere mich!") angezeigt (wie in PhpWiki).

 EWIKI_LIST_LIMIT
     Maximale Anzahl von Seiten, die in den generierten Listen angezeigt
     werden sollen (Suche, ...)

 EWIKI_PRINT_TITLE
     Wenn 0 werden keine SeitenTitel (WikiSeiten und InterneSeiten)
     angeziegt.


 EWIKI_ALLOW_HTML
     Normalerweise sollte im Wiki keine HTML erlaubt sein - b�ses JavaScript
     und <brokenHTML/>, andere Leute nerven.

     Siehe orig. README f�r mehr Informationen.


 EWIKI_RESCUE_HTML
     �berholt, siehe plugins/markup_rescuehtml.php


 EWIKI_DB_F_TEXT
     Dieses Flag wird f�r normale WikiSeiten in der DB gesetzt.

 EWIKI_DB_F_BINARY
     F�r bin�ren Inhalt in der DB.

 EWIKI_DB_F_DISABLED
     DB-Eintrage werden hiermit ausgeknippst.

 EWIKI_DB_F_HTML
     Erlaubt die Verwendung von HTML im WikiQuelltext, unabh�ngig von
     EWIKI_ALLOW_HTML.

 EWIKI_DB_F_READONLY
     WikiSeite kann nicht ver�ndert werden, so dieses Flag gesetzt ist.

 EWIKI_DB_F_WRITEABLE
     Umkehrung von READONLY, nur n�tzlich wenn zuvor alle Seiten mit
     EWIKI_EDIT_AUTHENTICATE schriebgesch�tzt wurden.


 EWIKI_ALLOW_OVERWRITE
     F�r eingeloggte nutzer kann yoursite.php diese Konst. auf 1 setzen, um
     auch das �ndern von schreibgesch�tzten Seiten zu erlauben.

 EWIKI_EDIT_AUTHENTICATE
     Hiermit kann man ewiki dahingehend kaputt machen, da� alle Seiten
     schreibgesch�tzt werden, und nur ver�nderbar sind, so yoursite.php
     $ewiki_author setzt.


 EWIKI_SCRIPT_BINARY
     Um bin�re Daten ausgeben zu k�nnen, mu� hier ein wrapper-script
     angegeben werden, da� ein Datenbank-Verbindung �ffnet und keine
     Textausgaben erzeugt, bevor nicht ewiki.php eingebunden wurde,
     da sonst nur Datenm�ll ausgegeben w�rde.

     Um alle binary-Funktionalit�t (Bilder hochladen / cachen) loszuwerden,
     einfach diese Konstante auf "" setzen, und die folgenden zwei auf 0:


 EWIKI_CACHE_IMAGES
     Bilder zwischenspeichern.

 EWIKI_IMAGE_MAXSIZE
     Maximale Gr��e von Bildern die in der DB abgelegt werden sollen.

 EWIKI_IMAGE_RESIZE
     Bilder herunterskalieren, wenn zu gro�.

 EWIKI_IDF_INTERNAL
     Wird verwendet um hochgeladene Bilder zu identifizieren. Bitte
     im laufenden Betrieb nicht �ndern.


 EWIKI_ADDPARAMDELIM
     Automatisch definiert, enth�lt entweder "?" oder "&", abh�ngig von
     EWIKI_SCRIPT.


 EWIKI_T_*
     �berholt, siehe ewiki_t() und $ewiki_t[] in der englischen README


 EWIKI_CHARS_U
 EWIKI_CHARS_L
     Erlaubte Zeichen in WikiSeitenNamen (gro�e und kleine Letter). Hiermit
     kann man das wiki lokalisieren; deutsche Umlaute sind schon enthalten.

 UNIX_MILLENNIUM
     Sehr wichtiges Ereignis ;)


Im tools/ Ordner ist ein kleines Script, mit dem man die erw�hnten
SeitenFlags �ndern kann.



$ewiki_config[] array
���������������������
Einige der EWIKI_ Konstanten wurden durch Eintr�ge im $ewiki_config[] Array
ersetzt oder erg�nzt (die Konstanten k�nnen weiterhin zur Voreinstellung
verwendet werden). Der Vorteil dieses Arrays ist, da� die Einstellungen auch
zur Laufzeit ge�ndert werden k�nnen.

F�r eine komplette und (einigerma�en) aktuelle �bersicht bem�he bitte die
englischsprachige README.




  -------------------------------------------------------------------------




Nur WikiQuelltextTransformation einsetzen
�����������������������������������������
Die ewiki_format Funktion war entworfen, um sie auch unabh�ngig von dem
restlichen WikiSkript einsetzen zu k�nnen.
Ben�tigt normalerweise nur den "wiki_source" Parmeter und erzeugt die
HTML-Seite daraus.
    ewiki_format($wiki_source, 0);

Alles was man noch anpassen mu� ist die $ewiki_links Variable. Setze
$ewiki_links=true ("true" und nicht "1") so da� ewiki_format() sp�ter
annimmt alle WikiSeiten w�rden existieren.

Wers eilig hat, kann auch die extrahierte Variante fragments/wiki_format.inc
verwenden, die Frank Luithle beigesteuert hat.




  -------------------------------------------------------------------------




Ohne MySQL DB verwenden
�����������������������
Sollte dein Provider keine MySQL Datenbank f�r dich bereithalten, kannst
du das plugin "db_flat_files.php" verwenden (einfach include("plugins/...");
aufrufen um es zu laden).

Alle WikiSeiten werden dann in Textdateien in einem nur daf�r
bereitgestelltem Ordner gespeichert. Stelle hierzu noch die Konstante
EWIKI_DBFILES_DIRECTORY in der Datei "ewiki.php" passend ein ("/tmp" w�rde
jedesmal gel�scht, wenn der Server neu startet).
Das Verzeichnus mu� relativ zum ewiki.php script angegeben werden, oder
absolut zum Serverhauptverzeichnis, nicht aber relativ zum DocumentRoot
deines Webspeicherplatzes!  In diesem Beispiel w�re "./pages" richtig:

Erstelle ein neues Verzeichnis (via FTP-Programm) und gib dem Webserver
Schreibzugriff daf�r mit dem Befehl " chmod 777 ./pages ".
ftp> cd .../ewiki
ftp> mkdir pages
ftp> chmod 777 pages
ftp> ls
-rw----r--    1 deinname deinname    57024 01. Jan 00:00 ewiki.php
-rw----r--    1 deinname deinname      512 01. Jan 00:00 index.php
drw----r-x    2 deinname deinname     4096 01. Jan 00:00 init-pages
drwxrwxrwx    2 deinname deinname     4096 25. Feb 23:59 pages
drw----r-x    5 deinname deinname     4096 01. Jan 00:00 plugins
-rw----r--    1 deinname deinname    15826 01. Jan 00:00 README.de
ftp> quit

Mit einem graphischem FTP-Programm gibt es auch immer die Mglk. die
"Dateizugriffsrechte" einzustellen.



db_fast_files
�������������
Diese neuere Version von db_flat_files, speichert die WikiSeiten
komprimiert in einem Bin�r-Format (kann man nicht mehr mit Editor
ansehen und bearbeiten). Zus�tzlich wurde der HitZ�hler aktiviert.

db_fast_files wurde in db_flat_files integriert, so da� das neue
Format jetzt nur noch �ber eine Konstante aktiviert werden mu�
(beide Dateiformate k�nnen gleichzeitig in der DB vorhanden sein).
F�r die schnellere Variante aktiviere in "plugins/db_flat_files.php"
die entsprechende Konstante:
   define("EWIKI_DB_FAST_FILES", 1);
(Diese Einstellung k�nntest du aber auch schon in der "config.php"
eintragen.)

Zus�tzliche Konstante: EWIKI_DBFILES_GZLEVEL sagt wieviel Zeit
beim Komprimieren verschwendet werden soll:
0 - keine Komprimierung
1 - ein ganz klein wenig Kompr.
2 - Voreinstellung, schnell
5 - normaler Wert in zlib, gute Komprimierung
9 - langsam f�r allerbeste Kompression

Dieses plugin wurde von Carsten Senf beigesteuert.




  --------------------------------------------------------------------------




B�seB�ckSl�shes
���������������
Wenn auf deinen Seiten p�tzlich viele "\" R�ckw�rtsSchr�gStriche
auftauchen liegt das an einer Fehlkonfiguration von PHP. In �lteren
Versionen war leider immer die Option "magic_slashes_gpc" aktiviert
(siehe auch php.ini).

Bitte am besten deinen WebserverProvider das zu �ndern. Wenn du aber bei
einem der BilligHoster (umsonst wie sourceforge.net oder tripod.com) bist,
gilt wie immer: einem geschenkten Gaul...
Dann verwende bitte "fragements/strip_wonderful_slashes.php", um das
Problem zumindest zu umschiffen, oder �ndere deine .htaccess Datei (Apache)
wie darin beschrieben.



  --------------------------------------------------------------------------



Pa�w�rter und tools/
��������������������
Die tools/ sind gef�hrlich und daher per Voreinstellung nicht ohne weiteres
Nutzbar. In der Datei "tools/t_config.php" wird das Script
"fragmenst/funcs/auth.php" geladen, da� f�r den Browser-Login-Dialog
verantwortlich ist. Wenn du also die tools/ verwenden willst, mu�t du dort
zuerst einen Benutzer mit Pa�wort eintragen, sonst geht nix.

Um hingegen dein Wiki zu sch�tzen, so da� nur einige wenige Personen die
Seiten editieren k�nnen, lie� dir bitte die Datei "plugins/auth/README.auth"
durch (leider nur in Englisch). Sie beschreibt den _PROTECTED_MODE und
stellt die entsprechenden Plugins vor.