用户工具

站点工具


wiki:dokuwiki-setting

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

wiki:dokuwiki-setting [2010/06/02 01:18]
wiki:dokuwiki-setting [2010/06/02 01:18] (当前版本)
行 1: 行 1:
 +
 +
 +====== DokuWiki 设置 ======
 +
 +====== 为DokuWiki添加登录功能 ======
 +
 +DokuWiki的登录功能默认是关闭的,您可以通过配置local.php,users.auth.php,acl.auth.php这三个文件来设置DokuWiki的登录功能。
 +
 +具体设置方法请见下面的说明:以本机调试为例。
 +
 +====== DokuWiki的安装 ======
 +
 +  - 首先去[[http://​www.splitbrain.org/​projects/​dokuwiki|wiki官方网站]]去下载一个最新版本。
 +  - 将下回来的文件解压,并传到站点根目录下的dokuwiki((文件夹的名称可以任意))文件夹中。
 +  - 在浏览器中输入类似“<​html>​www.example.com/​dokuwiki/​index.php</​html>​”格式的网址,就可以访问wiki了。
 +
 +====== DokuWiki的配置 ======
 +
 +DokuWiki默认的首页为[[:​start]]页,现在首页里没有任何内容,页面也是英文的。下面我们来配置几个参数,让我们的wiki更符合我们的要求。
 +
 +===== 配置local.php 全局设置 =====
 +
 +在conf目录下,找到local.php.dist,这个文件即local.php的样本,将其复制一份,重命名为:local.php。
 +
 +local.php采用utf-8编码存储,使用支持utf-8编码的文本编辑器打开,内容见下(为了查看方便,去掉了一部分注释,请仔细对照):
 +
 +  * 原选项前含有<​html>​“//​”</​html>​注释符号,若想使相应选项生效,必须去掉注释符。
 +
 +  $conf['​title'​] = 'My Wiki'; ​             //​wiki页面的标题,即页面右上方的标题。
 +  $conf['​useacl'​] = 1;                     //​启用ACL管理。0-不启用;1-启用。见下:
 +
 +  * 使用acl权限审核。acl-Access Control Lists(访问控制列表)。有两个选项:0-关闭权限审核,1-开启权限审核。
 +  * 如果想添加用户登录功能,必须开启权限审核。
 +
 +  $conf['​superuser'​] = '​admin'; ​           //​超级用户(管理员)登录名。
 +  $conf['​authtype'​] = '​plain'; ​            //​这里使用plain(简单)验证方式。
 +
 +常用的三种登录验证方式:
 +<​code>​
 +  * plain-使用配置文件,conf/​acl.auth.php存储用户名及密码资料。
 +  * ldap-使用ldap主机的用户资料来做使用者验及提供用户身份。
 +  * mysql-使用mysql数据库资料存储用户资料。
 +  //​require_once ("​mysql.conf.php"​); ​       //​如果你不使用MySQL数据库,那么就请保持这一行的注释状态,或干脆删除该行。
 +</​code>​
 +
 +接下来,根据情况,添加如下内容:
 +
 +  $conf['​lang'​] = '​zh'; ​                   //​wiki的界面语言。默认为“en”,中文请改为“zh”。
 +  $conf['​youarehere'​] = 1;                 //​显示you are here导航。0-不显示,1-显示。
 +  $conf['​defaultgroup'​] = '​user'; ​         //​默认用户组。
 +  $conf['​htmlok'​] = 1;                     //​是否支持html标记。0-不支持,1-支持。
 +  $conf['​phpok'​] = 0;                      //​是否支持php脚本。0-不支持,1-支持。
 +  $conf['​openregister'​] = '​0'; ​            //​是否允许用户注册。0-不允许,1允许。
 +
 +至于local.php文件配置完成。
 +
 +===== 配置acl.auth.php 权限管理 =====
 +
 +acl.auth.php中存储用户组及页面权限信息。在conf目录下,找到acl.auth.php.dist,这个文件即acl.auth.php的样本,将其复制一份,重命名为:acl.auth.php。
 +
 +默认的acl.auth.php文件内容如下:
 +
 +  # acl.auth.php
 +  <?php exit()?>
 +  # Don't modify the lines above
 +  #
 +  # Access Control Lists
 +  #
 +  # Editing this file by hand shouldn'​t be necessary. Use the ACL
 +  # Manager interface instead.
 +  #
 +  # If your auth backend allows special char like spaces in groups
 +  # or user names you need to urlencode them (only chars <128, leave
 +  # UTF-8 multibyte chars as is)
 +  #
 +  # none   0
 +  # read   1
 +  # edit   2
 +  # create 4
 +  # upload 8
 +  # delete 16
 +  *               ​@ALL ​       8
 +
 +注意,这个权限表由下往上是相互包含的,即如果你为一个用户组设置上传权限,那么上传权限以上的权限,读取,编辑,建立等是自动添加的,一定要注意。按此编辑用户组权限如下:
 +
 +<​code>​
 +  * @admin 255 ​                  //​为admin用户组分配全部权限。255这个权限值是专为admin用户组准备。
 +  * @user 8 ​                    //​为user用户组分配上传以下的权限。
 +  * @ALL 1 ​                    //​为所有人,即浏览者分配读取权限。
 +  playground:​playground @ALL 2 ​    //​为playground:​playground页面分配编辑权限。
 +
 +</​code>​
 +
 +===== 配置users.auth.php 用户配置 =====
 +
 +users.auth.php中存储用户组及页面权限信息。在conf目录下,找到users.auth.php.dist,这个文件即users.auth.php的样本,将其复制一份,重命名为:users.auth.php。
 +
 +默认的users.auth.php文件内容如下:
 +
 +  # users.auth.php
 +  # <?php exit()?>
 +  # Don't modify the lines above
 +  #
 +  # Userfile
 +  #
 +  # Format:
 +  #
 +  # user:​MD5password:​Real Name:​email:​groups,​comma,​seperated
 +
 +最后一行,即user:​MD5password:​Real Name:​email:​groups,​comma,​seperated即添加单个用户配置的标准格式。
 +
 +  user                     ​-->​用户名
 +  md5password ​             -->​采用md5加密的密码
 +  real name                -->​真实姓名
 +  email                    -->​电邮地址
 +  groups ​                  ​-->​用户组
 +
 +各个权限项之间用:​分隔。举例如下,用户名:admin,密码:admin,真实姓名:tr.c,电邮地址:<​html>​tr.c@huobao0911.com</​html>​,用户组admin
 +
 +  admin:​21232f297a57a5a743894a0e4a801fc3:​tr.c:​tr.c@huobao0911.com:​admin
 +
 +===== 生成md5编码 =====
 +
 +用记事本编辑以下文本行,存储为md5.php,在服务器上调试此文件,生成相应文本的md5编码:
 +
 +  <form action=""​ method="​post"​ name="​form1">​
 +    <input type="​text"​ name="​textfield">​
 +    <input type="​submit"​ name="​Submit"​ value="​create">​
 +  </​form>​
 +  <?php
 +  echo $_POST["​textfield"​];​
 +  echo "<​br>";​
 +  echo md5( $_POST["​textfield"​]);​
 +  ?>
 +
 +至此,DokuWiki的登录设置完成。
 + 
  
wiki/dokuwiki-setting.txt · 最后更改: 2010/06/02 01:18 (外部编辑)