Re: [RFR] templates://dokuwiki/{templates} (17 templates)
Christian PERRIER wrote:
> I'd suggest moving the "Default:" line above "_Description:". This is
> only cosmetic but this is the common way to do things.
>> Anyone who matches this specification will be given full and complete
>> access to DokuWiki's content.
> ^
> Extra space here.
Version 3 also strips some trailing spaces.
I'm still searching for anything in the documentation that'll tell
me whether it seriously means "lowercase ASCII letters" or whether
it accepts digits (as it does for pagenames - but then again,
pagenames can also be things like "0-9.9"). All the discussion in
the docs seems to be about punctuation/control characters...
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
--- templates.orig 2010-03-13 13:01:59.000000000 +0000
+++ templates 2010-03-13 17:04:28.000000000 +0000
@@ -3,8 +3,8 @@
__Choices: apache2
Default: apache2
_Description: Web server(s) to configure automatically:
- DokuWiki runs on any web server supporting PHP, however this
- script is only able to configure Apache 2 automatically.
+ DokuWiki runs on any web server supporting PHP, but only Apache 2
+ can be configured automatically.
.
Please select the web server(s) that should be configured
automatically for DokuWiki.
@@ -12,132 +12,126 @@
Template: dokuwiki/system/restart-webserver
Type: boolean
Default: true
-_Description: Should the webserver(s) be restarted now?
+_Description: Should the web server(s) be restarted now?
In order to activate the new configuration, the reconfigured web
server(s) have to be restarted.
Template: dokuwiki/system/documentroot
Type: string
-_Description: Wiki location:
- DokuWiki will be accessible through a directory of your website.
- By default, this is http://yourserver/dokuwiki, but you can
- change it to be anything within your server. Enter just the directory
- portion below.
Default: /dokuwiki
+_Description: Wiki location:
+ Specify the directory below the server's document root from which
+ DokuWiki should be accessible.
Template: dokuwiki/system/accessible
Type: select
+Default: localhost only
_Description: Authorized network:
- A Wiki is normally used to provide unlimited access to information, which
- can be freely modified by anyone. Since this is not always wanted,
- it is possible to restrict access to the site on the basis of the
- originating IP address.
+ Wikis normally provide open access to their content, allowing anyone
+ to modify it. Alternatively, access can be restricted by IP address.
.
- If you select 'localhost only', only people on the localhost (the machine
- the Wiki is running on) will be able to connect. 'local network' will
+ If you select "localhost only", only people on the localhost (the machine
+ the wiki is running on) will be able to connect. "local network" will
allow people on machines in a local network (which you will need to
- specify) to talk to the Wiki. 'global' will allow anyone, any where, to
- connect to the Wiki.
+ specify) to talk to the wiki. "global" will allow anyone, anywhere, to
+ connect to the wiki.
.
- For security, this is set to 'localhost only' by default. Unless you have
- a particular need for privacy on your Wiki, you should be able to allow
- access globally without compromising site security.
+ The default is for site security, but more permissive settings should
+ be safe unless you have a particular need for privacy.
__Choices: localhost only, local network, global
-Default: localhost only
Template: dokuwiki/system/localnet
Type: string
+Default: 10.0.0.0/24
_Description: Local network:
The specification of your local network should either be
an IP network in CIDR format (x.x.x.x/y) or a domain specification (like
- .mydomain.com).
+ .example.org).
.
- Anyone who matches the specification given below will be given full and
- complete access to the DokuWiki.
-Default: 10.0.0.0/24
+ Anyone who matches this specification will be given full and complete
+ access to DokuWiki's content.
Template: dokuwiki/system/purgepages
Type: boolean
-_Description: Purge pages on package removal?
+Default: false
+_Description: Purge pages on package removal
By default, DokuWiki stores all its pages in a file database in
/var/lib/dokuwiki.
.
Accepting this option will leave you with a tidier system when the
DokuWiki package is removed, but may cause information loss if you have an
- operational Wiki that gets removed.
-Default: false
+ operational wiki that gets removed.
Template: dokuwiki/system/writeconf
Type: boolean
+Default: false
_Description: Make the configuration web-writeable?
DokuWiki includes a web-based configuration interface. To be usable, it
- requires the web server to have writing permission to the configuration
+ requires the web server to have write permission to the configuration
directory.
.
- Accepting this option will give the web server writing permissions on the
+ Accepting this option will give the web server write permissions on the
configuration directory and files.
.
The configuration files will still be readable and editable by hand
- regardless whether you accept or not this option.
-Default: false
+ regardless of whether or not you accept this option.
Template: dokuwiki/system/writeplugins
Type: boolean
+Default: false
_Description: Make the plugins directory web-writeable?
- DokuWiki includes a web-based plugin installation interface. To be useable,
- it requires the web server to have writing permission to the plugins directory.
+ DokuWiki includes a web-based plugin installation interface. To be usable,
+ it requires the web server to have write permission to the plugins directory.
.
- Accepting this option will give the web server writing permissions to the
+ Accepting this option will give the web server write permissions to the
plugins directory.
.
- Plugins can still be installed by hand regardless whether you accept or not
- this option.
-Default: false
+ Plugins can still be installed by hand regardless of whether or not you
+ accept this option.
Template: dokuwiki/wiki/title
Type: string
-_Description: Wiki title:
- The Wiki title will be displayed in the upper right corner of the default
- template and on the browser window title.
Default: Debian DokuWiki
+_Description: wiki title:
+ The wiki title will be displayed in the upper right corner of the default
+ template and on the browser window title.
Template: dokuwiki/wiki/acl
Type: boolean
+Default: true
_Description: Enable ACL?
Enable this to use an Access Control List for restricting what the users of
your wiki may do.
.
This is a recommended setting because without ACL support you will not have
access to the administration features of DokuWiki.
-Default: true
Template: dokuwiki/wiki/superuser
Type: string
-_Description: Administrator name:
- This script can create an initial administrator account that will allow you to
- create new wiki users and manage the wiki configuration. The username
- should be lowercase and ASCII letters only. Spaces are not allowed here.
- .
- Leave this field blank if you do not want to create an administrator account
- now.
Default: admin
+_Description: Administrator username:
+ Please enter a name for the administrator account, which will be able to
+ manage DokuWiki's configuration and create new wiki users. The username
+ should be composed of lowercase ASCII letters only.
+ .
+ If this field is left blank, no administrator account will be created now.
Template: dokuwiki/wiki/fullname
Type: string
_Description: Administrator real name:
Default: DokuWiki Administrator
- Please enter the full name associated to the wiki administrator account.
+ Please enter the full name associated with the wiki administrator account.
This name will be stored in the wiki password file as an informative
- field, and will be displayed with the wiki page changes made from the
+ field, and will be displayed with the wiki page changes made by the
administrator account.
Template: dokuwiki/wiki/email
Type: string
+Default: webmaster@localhost
_Description: Administrator email address:
- Please enter the email address associated to the wiki administrator account.
+ Please enter the email address associated with the wiki administrator account.
This address will be stored in the wiki password file, and may be used
- to get a new password if you loose the original administrator password.
-Default: webmaster@localhost
+ to get a new administrator password if you lose the original.
Template: dokuwiki/wiki/password
Type: password
@@ -146,26 +140,24 @@
Template: dokuwiki/wiki/confirm
Type: password
-_Description: Password confirmation:
- Please enter the same password again to verify
+_Description: Re-enter password to verify:
+ Please enter the same "admin" password again to verify
you have typed it correctly.
Template: dokuwiki/wiki/failpass
Type: error
-_Description: Password confimation failed!
- The passwords do not match, please type them again.
+_Description: Password input error
+ The two passwords you entered were not the same. Please try again.
Template: dokuwiki/wiki/policy
Type: select
-_Description: Initial ACL policy?
- The installer will set up an initial ACL configuration for you. What you
- choose here depends on how you intend to use the Wiki.
- .
- An open wiki is available to anonymous users for reading and writing.
- A public wiki is available to anonymous users for reading, but limited to
- registered users for writing. A closed wiki is only accessible to registered
- users for both reading and writing.
+Default: public
+_Description: Initial ACL policy:
+ Please select what initial ACL configuration should be set up to match
+ the intended usage of this wiki:
+ "open": both readable and writeable for anonymous users;
+ "public": readable for anonymous users, writeable for registered users;
+ "closed": readable and writeable for registered users only.
.
- This is only an initial setup, you will be able to adjust the ACL rules later.
+ This is only an initial setup; you will be able to adjust the ACL rules later.
__Choices: open, public, closed
-Default: public
Template: dokuwiki/system/configure-webserver
Type: multiselect
__Choices: apache2
Default: apache2
_Description: Web server(s) to configure automatically:
DokuWiki runs on any web server supporting PHP, but only Apache 2
can be configured automatically.
.
Please select the web server(s) that should be configured
automatically for DokuWiki.
Template: dokuwiki/system/restart-webserver
Type: boolean
Default: true
_Description: Should the web server(s) be restarted now?
In order to activate the new configuration, the reconfigured web
server(s) have to be restarted.
Template: dokuwiki/system/documentroot
Type: string
Default: /dokuwiki
_Description: Wiki location:
Specify the directory below the server's document root from which
DokuWiki should be accessible.
Template: dokuwiki/system/accessible
Type: select
Default: localhost only
_Description: Authorized network:
Wikis normally provide open access to their content, allowing anyone
to modify it. Alternatively, access can be restricted by IP address.
.
If you select "localhost only", only people on the localhost (the machine
the wiki is running on) will be able to connect. "local network" will
allow people on machines in a local network (which you will need to
specify) to talk to the wiki. "global" will allow anyone, anywhere, to
connect to the wiki.
.
The default is for site security, but more permissive settings should
be safe unless you have a particular need for privacy.
__Choices: localhost only, local network, global
Template: dokuwiki/system/localnet
Type: string
Default: 10.0.0.0/24
_Description: Local network:
The specification of your local network should either be
an IP network in CIDR format (x.x.x.x/y) or a domain specification (like
.example.org).
.
Anyone who matches this specification will be given full and complete
access to DokuWiki's content.
Template: dokuwiki/system/purgepages
Type: boolean
Default: false
_Description: Purge pages on package removal
By default, DokuWiki stores all its pages in a file database in
/var/lib/dokuwiki.
.
Accepting this option will leave you with a tidier system when the
DokuWiki package is removed, but may cause information loss if you have an
operational wiki that gets removed.
Template: dokuwiki/system/writeconf
Type: boolean
Default: false
_Description: Make the configuration web-writeable?
DokuWiki includes a web-based configuration interface. To be usable, it
requires the web server to have write permission to the configuration
directory.
.
Accepting this option will give the web server write permissions on the
configuration directory and files.
.
The configuration files will still be readable and editable by hand
regardless of whether or not you accept this option.
Template: dokuwiki/system/writeplugins
Type: boolean
Default: false
_Description: Make the plugins directory web-writeable?
DokuWiki includes a web-based plugin installation interface. To be usable,
it requires the web server to have write permission to the plugins directory.
.
Accepting this option will give the web server write permissions to the
plugins directory.
.
Plugins can still be installed by hand regardless of whether or not you
accept this option.
Template: dokuwiki/wiki/title
Type: string
Default: Debian DokuWiki
_Description: wiki title:
The wiki title will be displayed in the upper right corner of the default
template and on the browser window title.
Template: dokuwiki/wiki/acl
Type: boolean
Default: true
_Description: Enable ACL?
Enable this to use an Access Control List for restricting what the users of
your wiki may do.
.
This is a recommended setting because without ACL support you will not have
access to the administration features of DokuWiki.
Template: dokuwiki/wiki/superuser
Type: string
Default: admin
_Description: Administrator username:
Please enter a name for the administrator account, which will be able to
manage DokuWiki's configuration and create new wiki users. The username
should be composed of lowercase ASCII letters only.
.
If this field is left blank, no administrator account will be created now.
Template: dokuwiki/wiki/fullname
Type: string
_Description: Administrator real name:
Default: DokuWiki Administrator
Please enter the full name associated with the wiki administrator account.
This name will be stored in the wiki password file as an informative
field, and will be displayed with the wiki page changes made by the
administrator account.
Template: dokuwiki/wiki/email
Type: string
Default: webmaster@localhost
_Description: Administrator email address:
Please enter the email address associated with the wiki administrator account.
This address will be stored in the wiki password file, and may be used
to get a new administrator password if you lose the original.
Template: dokuwiki/wiki/password
Type: password
_Description: Administrator password:
Please choose a password for the wiki administrator.
Template: dokuwiki/wiki/confirm
Type: password
_Description: Re-enter password to verify:
Please enter the same "admin" password again to verify
you have typed it correctly.
Template: dokuwiki/wiki/failpass
Type: error
_Description: Password input error
The two passwords you entered were not the same. Please try again.
Template: dokuwiki/wiki/policy
Type: select
Default: public
_Description: Initial ACL policy:
Please select what initial ACL configuration should be set up to match
the intended usage of this wiki:
"open": both readable and writeable for anonymous users;
"public": readable for anonymous users, writeable for registered users;
"closed": readable and writeable for registered users only.
.
This is only an initial setup; you will be able to adjust the ACL rules later.
__Choices: open, public, closed
Reply to: