File: README.Debian

package info (click to toggle)
usemod-wiki 1.0.6-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 1,400 kB
  • ctags: 1,658
  • sloc: perl: 4,841; sh: 56; makefile: 19
file content (54 lines) | stat: -rw-r--r-- 1,926 bytes parent folder | download | duplicates (9)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
= Debian README for the usemod-wiki package =

== Using multiple wiki instances ==

This package includes a wrapper script [1] that can be used to run multiple
usemod wiki instances in parallel without the need to edit the main wiki.pl
script.

[1] /usr/share/doc/usemod-wiki/examples/wiki-wrapper.pl

== UseModWiki and mod_perl ==

UseModWiki is currently not mod_perl clean. Using the provided wiki.pl as a
perl module and running multiple wiki instances will break as the configs
interfere. In the same line, the wiki-wrapper.pl script will break (at least)
the RSS feed with mod_perl. It is probably possible to convert wiki.pl to a
UseModWiki.pm that can run a single wiki instance, but this package does not
attempt to. Use Apache's cgi-script handler.

== Charset and Language ==

Up to version 0.92, this package did not specify a charset for the wiki pages,
which resulted in a us-ascii (depending on the client, latin1) default. The
config file in /etc/usemod-wiki/ now specifies utf-8. The charset conversion
script skeleton [2] can be used to convert legacy pages.

[2] /usr/share/doc/usemod-wiki/examples/convert-charset.sh

As of version 1.0-7, the NewFS setting has been activated to enable non-ascii
utf-8 characters. Please run ?action=convert when upgrading from an older
version.

The umtrans.pl script [3] can be used to translate the wiki messages to other
languages.

[3] /usr/share/usemod-wiki/umtrans.pl

== Patches ==

=== BodyOnly ===

If you set $BodyOnly = 1, the program will only output the HTML that is inside
the <body> tag in normal use. This can be used with SSI statements like the
following to embed the wiki in a custom layout template:

	<!--#exec cmd="/path/to/wiki.pl"-->

=== Unresolvable IP addresses ===

Using the special "unknown" token in the banned list will block all edits from
unresolvable IP addresses.

 -- Christoph Berg <myon@debian.org>  Thu,  6 Oct 2005 22:52:04 +0200