# HG changeset patch # User Thomas Waldmann # Date 1363445229 -3600 # Node ID eae1013296ed427a88e42ebbff482f8d0bebfa68 # Parent f4028129b8cbb869071a50b13a6a6d42bc0db173 make install-docs interwiki diff -r f4028129b8cb -r eae1013296ed docs/INSTALL.html --- a/docs/INSTALL.html Sat Mar 16 15:46:12 2013 +0100 +++ b/docs/INSTALL.html Sat Mar 16 15:47:09 2013 +0100 @@ -1,7 +1,7 @@ - + @@ -18,7 +18,7 @@ - + @@ -34,7 +34,7 @@
MoinMaster:

@@ -114,7 +114,7 @@

Multiple wikis

Just copy the files wiki/config/wikifarm/* from the dist archive to /moin/config/.

Now follow the directions as for a single wiki (see above) for each of your farm wikis.

Special wiki farm hints:

  • You need a separate data_dir and data_underlay_dir per wiki

  • If you want to share some settings for your wikis, put them into farmconfig.py - they will be inherited by mywiki

  • The settings that need to be different are put into mywiki.py

  • If you need more than 1 wiki, add files like mywiki.py and reference them from farmconfig.py as you see for mywiki

Static file serving

-

MoinMoin also comes with some static files like images, CSS, Javascript, Java applet files, etc. (see the MoinMoin/web/static/htdocs/ directory in the distribution archive). They are needed for things like styling, icons and additional client-side functionality.

MoinMoin serves those files by a built-in static file server at the path '../MoinMoin/web/static/htdocs' (XYZ like in MoinMoin version X.Y.Z, e.g. ../MoinMoin/web/static/htdocs for moin 1.9.0).

Please note that this path is relative to the script root, so:

  • if you run your wiki script at /mywiki, the URL for the static files server will be /mywiki../MoinMoin/web/static/htdocs. You need to configure url_prefix_static in your wiki config to match this.

  • if you run your wiki script at /, the URL for the static files server will be ../MoinMoin/web/static/htdocs - and it will automagically match the default value of url_prefix_static, so no need to configure it.

+

MoinMoin also comes with some static files like images, CSS, Javascript, Java applet files, etc. (see the MoinMoin/web/static/htdocs/ directory in the distribution archive). They are needed for things like styling, icons and additional client-side functionality.

MoinMoin serves those files by a built-in static file server at the path '../MoinMoin/web/static/htdocsZ' (XYZ like in MoinMoin version X.Y.Z, e.g. ../MoinMoin/web/static/htdocs0 for moin 1.9.0).

Please note that this path is relative to the script root, so:

  • if you run your wiki script at /mywiki, the URL for the static files server will be /mywiki../MoinMoin/web/static/htdocsZ. You need to configure url_prefix_static in your wiki config to match this.

  • if you run your wiki script at /, the URL for the static files server will be ../MoinMoin/web/static/htdocsZ - and it will automagically match the default value of url_prefix_static, so no need to configure it.

Running MoinMoin with Apache / mod_wsgi

Now you should be able to simply run the moin.wsgi script the same way you ran test.wsgi above.

Running MoinMoin with other WSGI servers

diff -r f4028129b8cb -r eae1013296ed docs/UPDATE.html --- a/docs/UPDATE.html Sat Mar 16 15:46:12 2013 +0100 +++ b/docs/UPDATE.html Sat Mar 16 15:47:09 2013 +0100 @@ -1,7 +1,7 @@ - + @@ -18,7 +18,7 @@ - + @@ -34,7 +34,7 @@
MoinMaster:

@@ -68,11 +68,11 @@

Configuration update

After upgrading, your existing wiki should continue to work (the goal is to have sane defaults for any new config values, but then there can be bugs and also changes that must break compatibility).

Check that this is indeed the case, and then take the time to check the CHANGES file in your distribution archive. Often, new features will be invisible unless you extend your configuration in wikiconfig.py.

Check that you have the latest "intermap.txt" file; If you have your own entries, you can point "shared_intermap" at a file loaded before the file in your data directory, which takes precedence (i.e. have global entries in the shared one, private entries the data dir file).

Static files

-

Since release 1.9.0, moin has a built-in static file webserver to serve the CSS, images, javascript, etc. files that come with moin.

This static file web server serves the files contained in path MoinMoin/web/static/htdocs/ at URL <script URL> + <url_prefix_static>.

So, if you run your wiki at the root of your site (/) the default url_prefix_static will work for you.

The default url_prefix_static is something like ../MoinMoin/web/static/htdocs (VVV is 190 for moin release 1.9.0) and VVV will change on every release (moin 1.9.1 will use ../MoinMoin/web/static/htdocs by default). This is done to be able to use a very long cache lifetime for the static stuff, so your wiki will be faster and cause less load and traffic. Even if you don't use a long cache lifetime, a changing url_prefix_static makes sure that if you upgrade your wiki all your wiki users will immediately get the fresh static stuff.

If you run your wiki at a different base path, you need to set url_prefix_static to the correct value, e.g. url_prefix_static = '/mywiki' + url_prefix_static if you run your wiki at /mywiki.

If you want moin to serve a different directory than the default MoinMoin/web/static/htdocs/, you can change the path in moin.wsgi like shared='/my/path/to/htdocs' to serve static files from that path.

(!) Please note that if you serve the static files from a different than the "builtin" directory, you are responsible for updating those files from MoinMoin/web/static/htdocs/ when you upgrade your moin installation.

Alternatively to using moin's builtin static files server, you can also serve the static files with some external webserver (e.g. with Apache, if that is your main web server). If you want to do this, just have your web server catch the requests for stuff below the url_prefix_static URL (before they reach the moin script) and serve those requests with the files from MoinMoin/web/static/htdocs/ (or a copy of them).

+

Since release 1.9.0, moin has a built-in static file webserver to serve the CSS, images, javascript, etc. files that come with moin.

This static file web server serves the files contained in path MoinMoin/web/static/htdocs/ at URL <script URL> + <url_prefix_static>.

So, if you run your wiki at the root of your site (/) the default url_prefix_static will work for you.

The default url_prefix_static is something like ../MoinMoin/web/static/htdocsV (VVV is 190 for moin release 1.9.0) and VVV will change on every release (moin 1.9.1 will use ../MoinMoin/web/static/htdocs1 by default). This is done to be able to use a very long cache lifetime for the static stuff, so your wiki will be faster and cause less load and traffic. Even if you don't use a long cache lifetime, a changing url_prefix_static makes sure that if you upgrade your wiki all your wiki users will immediately get the fresh static stuff.

If you run your wiki at a different base path, you need to set url_prefix_static to the correct value, e.g. url_prefix_static = '/mywiki' + url_prefix_static if you run your wiki at /mywiki.

If you want moin to serve a different directory than the default MoinMoin/web/static/htdocs/, you can change the path in moin.wsgi like shared='/my/path/to/htdocs' to serve static files from that path.

(!) Please note that if you serve the static files from a different than the "builtin" directory, you are responsible for updating those files from MoinMoin/web/static/htdocs/ when you upgrade your moin installation.

Alternatively to using moin's builtin static files server, you can also serve the static files with some external webserver (e.g. with Apache, if that is your main web server). If you want to do this, just have your web server catch the requests for stuff below the url_prefix_static URL (before they reach the moin script) and serve those requests with the files from MoinMoin/web/static/htdocs/ (or a copy of them).

Wiki pages update

System and Help pages

-

System and help pages are separately stored in the underlay directory. Just use the fresh underlay directory we provide in the distribution archive (move the old one to your backup directory).

If you previously modified some system page in your wiki (see EditedSystemPages on your wiki), you might want to Delete them to use moinmoin's updated version (warning: you can't un-delete that page later).

+

System and help pages are separately stored in the underlay directory. Just use the fresh underlay directory we provide in the distribution archive (move the old one to your backup directory) and read and follow the LanguageSetup page in your wiki.

If you previously modified some system page in your wiki (see EditedSystemPages on your wiki), you might want to Delete them to use moinmoin's updated version (warning: you can't un-delete that page later).

InterWiki data

Copy intermap.txt from the distribution archive into your wiki data

Your valuable own pages

@@ -82,7 +82,7 @@

Troubleshooting

Hints:

  • Use absolute pathes, not relative ones.
  • Make sure you have an adequate logging configuration (see server adaptor script and the logging configuration file) and carefully read the log!
  • Make sure python can find the MoinMoin code package and your wiki configuration files (fix sys.path in the server adaptor script or PYTHONPATH in the environment).

  • Make sure MoinMoin can find the data_dir and data_underlay_dir (see wikiconfig.py).

  • When you are editing python code files (e.g. wikiconfig.py), be careful to indent correctly (use 4 spaces, not tabs) and also be careful not to make syntax errors. If you have a working config, do not make too many changes at once (and have a backup of a working version).

  • Check permissions (the moin process needs read/write access to data_dir and data_underlay_dir, it needs at least read access to the MoinMoin code and configuration).

  • Depending on your installation, more tightly secured permissions are a good idea. Ideally, you assign all files in the data directory to the user the web server runs under, and then you use 700 or 770 - see also the config.umask setting.

Version specific notes

-

MoinMaster: HelpOnUpdating (last edited 2010-05-25 17:21:51 by ThomasWaldmann)

+

MoinMaster: HelpOnUpdating (last edited 2013-02-23 20:44:09 by ReimarBauer)