ewiki

Generation of a "monsterwiki.php" script

ewiki over the time grow larger, and nowadays isn't anymore the
SINGLE SCRIPT it once was. The distribution ships with over hundred
extension plugins. But nevertheless it is still possible to build
a single script from it all.

That being said, the "ewiki.php" script still implements a fully
functional Wiki (and just only lacks the advanced features supplied
by the plugins). - You could still just include_once() the "ewiki.php"
script into yoursite and delete everything else the ewiki tarball
contained.

However, it is also possible to MERGE all wanted plugins and the
core script together to built a customized (feature enhanced) Wiki
script from it. All you needed to do was:

  /unix/$   cat  ewiki.php plugins/*.*  >  monsterwiki.php
or
  C:\win\   type  ewiki.php plugins/*.*  >  monsterwiki.php

This way you'd get the "monsterwiki.php" file, which contained the
ewiki core script plus all plugins - but of course, you should only
copy the ones in, you really need and want (and not all "*.*" as
shown in the example above)!

The UNIX shell script "tools/mkhuge" will do exactly that for you;
it accepts a parameter from 0 to 3, which will merge a custom set
of useful plugins into the then generated "monsterwiki.php" script.
In newer versions, you may want to use the "tools/setup" console
tool instead (for Linux), which makes this far easier.

If you have built a "monsterwiki.php" script, you can include() this
instead of the minimal "ewiki.php" into yoursite to integrate a Wiki.

Eventually you'd also want to merge some configuration settings into
this monsterwiki script, so you wouldn't have to put the define(...)
commands into yoursite.php before you include("monsterwiki.php");
The define() commands however need to be the very first part merged
into that monsterwiki script, so it's best to edit the monsterscript
after generation and insert the appropriate settings then at the
very beginning.
    You could also merge a (reduced!) "config.php" into the script,
    using the above "cat" (or "type" for DOS/Win) method.  But
    beware, that this "config.php" then does not contain any
    include() command; because else the resulting "monsterwiki.php"
    script would fail trying to load the "ewiki.php" core script and
    plugins which were probably already merged in. (The newer and
    recommended "include_once()" won't help here.)  Even if you merge
    such a minimal config script at the start of this monsterwiki
    script, you still could override some settings (at least
    establishing the database connection) from within yoursite, if
    you think it's useful.

Additional note: You could still include() plugins, if you included()
such a monsterwiki script into yoursite, provided that the plugin
you try to include() wasn't already merged into that monsterwiki.php
script before (else it would crash the PHP interpreter, because
loading it twice is once too much => error + crash).

StaticPages+ (read about "spages" plugin) can also be included, if
you first convert them into ordinary ["page"] plugins using the 
'mkpageplugin' commandline tool.
prev << "other/advanced integration issues"
next >> "Supplying the WikiPageName"


You cannot modify the README file, but anyhow any ideas or suggestion should as usually get filed on BugReports, UserSuggestions or even better the README.Discussion.