用户:Missx/mediawiki修改

增加如同蓝色理想维基右上角的贡献

• 在根目录下找到Localsetting.php 在最后加入参数

$wgMaxCredits="5"; //5可以修改成你想要显示的作者个数

NOTICE

可能因为editplus的某些配置原因，在本地机调试的时候使用ep编辑localsetting.php的时候会出现无法访问的问题。

• 找语言包，如果使用的是中文的，找到languages\messages\MessageZh_hans.php修改代码

'lastmodifiedat'    => '最后修订 $1 $2。', # $1 date, $2 time
'viewcount'         => '浏览$1次',
 
'anonymous'        => '匿名用户',
'siteuser'         => ' $1 ',
'lastmodifiedatby' => '此页由$3于 $1 $2 ', # $1 date, $2 time, $3 user
'othercontribs'    => '在$1的基础上最后更改。',
'siteusers'        => ' $1 ',

• 找到你的模板文件，例如skin\monobook.php里面，找到你要放置该文字的地方 加入代买

<?php if($this->data['credits']) $this->html('credits');?>

就可以输出类似蓝色理想的贡献文本。

• 蓝色理想的代码为：

<?php if($this->data['credits']) { ?>
  <div id="byLine">
     <?php $this->html('credits');?>
  </div>
<?php } ?>

增加文件上传类型

• 找到根目录下的localsetting.php
• 增加参数

$wgFileExtensions=array("jpg","png","doc");//文件上传类型

• 该参数的使用方法：

// Add one filetype to the default array
$wgFileExtensions[] = 'pdf';
 
// Add several file types to the default array
$wgFileExtensions = array_merge( $wgFileExtensions, array( 'pdf', 'ppt', 'zip' ) );
 
// Override the default with a bundle of filetypes:
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'ppt', 'pdf', 'doc', 'psd', 'mp3','xls', 'zip','swf', 'doc', 'odt', 'odc', 'odp', 'odg', 'mpp');

• 相关页面

http://www.mediawiki.org/wiki/Manual:$wgFileExtensions

增加导航菜单

子页面导航

因为wiki是网状结构,在wiki里面没有真正的导航菜单.在现在这个页面看到的实际上是因为这个名字空间开启了SubPages.

现有蓝色理想里面开启子页面的代码为:

$wgNamespacesWithSubpages =  array(
 NS_USER      => true,
 NS_MEDIAWIKI => true,
 NS_HELP      => true
);

其中$wgNamespacesWithSubpages的使用方法为:

#单个页面开启的方法:
$wgNamespacesWithSubpages[NS_MAIN] = true;
#多个页面数字数组的控制,这个方法不是很直观,其中0代表false,1代表ture:
$wgNamespacesWithSubpages = array( -1 => 0, 0 => 1, 1 => 1, 2 => 1, 3 => 1, 4 => 1, 5 => 1, 6 => 0, 7 => 1, 8 => 0, 9 => 1, 10 => 0, 11 => 1,12 => 1);
#多个页面数组的开启方法,这个方法直观一些:
$wgNamespacesWithSubpages =  array(
        NS_TALK           => true,
        NS_USER           => true,
        NS_USER_TALK      => true,
        NS_PROJECT_TALK   => true,
        NS_IMAGE_TALK     => true,
        NS_MEDIAWIKI_TALK => true,
        NS_TEMPLATE_TALK  => true,
        NS_HELP_TALK      => true,
        NS_CATEGORY_TALK  => true
 );
#开启所有页面的子页面方法:
$wgNamespacesWithSubpages = array_fill(0, 200, true);

NOTICE

如果是在开放wiki里面依旧要注意结合template的设置来一起操作.一旦允许了子页面,并且开启了所有空间都可以变成template的时候,恶意添加将会更加容易.

模板导航

模板导航实际上就是手工导航. 以台棒为例:下面的是他们的导航模板代码:

<font size="-3"> <font color="#008000">• 目前所在分類： [[:category:主分類|主分類]] > [[:category:棒球|棒球]] > [[:category:{{{1}}}|{{{1}}}]]</font>

NOTICE

在台棒里面,这个是受到了保护的,所以请大家注意一下保护.
PS.如果硬要将网状结构的wiki变成树状结构是有点困难的.最好还是学习下维基百科的做法,以某一种方式做分类,其他的方式做辅助.

图片的引用

内部图片引用

先将图片使用wiki上传到服务器上面,然后通过使用[[Image:图片名称.后缀]]来调用图片.该引用还有很多的参数设置,详细可以查看帮助.

外部图片的调用

• 先在Localsetting.php里面增加如下参数:

$wgAllowExternalImages="true";

以上允许使用直接粘贴图片地址就可以调用得到图片:即使用

http://www.mediawiki.org/wiki/Image:Example.jpg 的方式直接使用图片而不需要将图片上传.

安全的转化外部图片

$wgAllowExternalImages上方式有一个缺点,就是你可以让任何人调用来自任何网站的图片.这样的安全性比较低下,不过mediawiki给了另外一个参数来限制这样的情况:$wgAllowExternalImagesFrom

该参数的赋值方式如下:

$wgAllowExternalImagesFrom = 'http://127.0.0.1/';
$wgAllowExternalImagesFrom = array( 'http://127.0.0.1/', 'http://www.example.com/' );

这样允许你的网址只解析来自于这两个网站的图片,而将其他的图片显示为链接.

NOTICE

注意,使用这个参数的时候要将$wgAllowExternalImages定义为false.
PS.在默认的参数里面$wgAllowExternalImages实际上就是为false,你只要删除Localsetting.php里面的就可以了.

首页的模板解析

某些人说看到wiki的首页模板感觉很头大 我这里稍微解释下:

首先,可以看到蓝色理想维基里面的布局重用性很高,基本上属于单一布局加上颜色变化.所以我先确定了一个首页布局模板.

这个模板页面最终使用的时候是这样:

{{首页布局
|颜色代码
|标题名
|内容模板名称
}}

如此,我们就得到一个布局页面,当然,里面的代码和参数变量可以使用任意定义.上面的这种是需要严格注意顺序的.下面的这种是不需要严格注意顺序,因为它不再以类数组的方式循环得到Template里面的变量.

{{首页布局
|颜色代码=
|标题名=
|内容模板名称=
}}

得到这个模板之后,我们还要确定一个内容模板,以后编辑的时候可以不用动布局模板,同时也可以提高可读性,内容模板的定义是随意的,也就是随便你怎么定义,没有特定性.

之后我们就要得到一个结合这两个的模板,我使用一个已有的例子:Template:导航模板 我们可以看到其源代码是

{{首页布局
|标题背景色=#efefef
|标题=导航
|内容模板名=导航内容
}}

为了提高可读性我在编写的时候使用了"变量名=变量"的模式.这样,我就将内容的模板套在布局的模板当中,然后再在即将引用的模板里面将两者的结果保存.这样首页就可以使用较少的代码实现效果.当然,你也可以直接将这个代码写到首页而不另外存为其他的模板.

最后,我们在首页使用wiki语法打好框架,将各个模板放进去,预览,保存,即可.

NOTICE

注意逻辑明确关系和对系统的消耗,模板嵌套模板实际上有点类似我们使用的模板引擎了.

禁止某个名字空间作为模板使用

wiki最大的一个好处，同时也是一个坏处，就是任意一个空间的文章都可以作为模板引用到文章里面。好处自然是可以不用重复写一些东西，但是带来的坏处就是安全问题，因为这样就可以include一些别的需要权限的隐秘空间的内容了。所以在当时考虑到这个情况，在蓝色理想维基使用了这个函数限制了只能有Template的名字空间作为模板来使用。

$wgNonincludableNamespaces[]=103;

NOTICE

该函数赋值的时候只能使用名字空间的id。将这个代码写在Localsetting.php里面即可生效。

多语言导航

多语言导航就是类似 首页最下面的多语言导航的版本。实现的方法其实很简单，只是我和蓝色在一个1.12.0的wiki上测试的时候发生了问题，而在1.13.2测试的时候是完好的。（很奇怪为什么在1.12.0的时候测试的是出错的，照理来说是可以用的才对，要是1.12.0出错了官方岂不乱了套了？）

多语言导航实际上是组合使用了子页面和扩展函数的判断。

使用方法

首先，我们先安装维基的语法扩展插件：点击到该页面下载ParserFunctions插件。这个插件提供给我们扩展的wiki语法，如#if #ifexist等,详细的可以查看他的帮助

安装过程就是将他的几个文件复制到extensions目录下的ParserFunctions（如果不存在则创建）。然后在Localsetting.php里面添加

#绝对路径
require_once( "$IP/extensions/ParserFunctions/ParserFunctions.php" );
#相对路径
require_once( "extensions/ParserFunctions/ParserFunctions.php" );

这样我们就可以使用它的扩展函数了。

接下来将Template:Languages 和Template:Languages/Lang 的源码复制到你相应的页面里面。

然后在你想要创建多语言版本的内容下创建子页面,对应的子页面名字是其语言的缩写，详细请看附录。

使用的就在你想要的页面里面加上{{Languages}}，通过Template:Languages/Lang当中的函数来判断该文章的子页面名字是否存在，如果有，则显示到{{Languages}}的地方,如果没有,则为空。

NOTICE

1.由于是使用创建相应子页面的方法，所以你得要让你需要创建多语言内容的名字空间开启子页面。详细的方法请参考子页面导航,当中$wgNamespacesWithSubpages的使用方法。
2.在mediawiki那里的<span>是没有解析出来的,而在蓝色理想里面是解析了了,所以我在最后"如果没有则显示<span>"的地方去掉了<span>的标签。
PS.通过扩展函数的使用，你可以创建更加复杂的模板和判断条件来使你的wiki更方便使用。你甚至可以使用类似程序的判断方式来控制内容的显示。

附录

子页面名字对应的语言

Page Name	Language
Main Page	English
Main Page/af	Afrikaans
Main Page/ar	Arabic
Main Page/az	Azerbaijani
Main Page/bcc	Southern Balochi
Main Page/bg	Bulgarian
Main Page/br	Breton
Main Page/ca	Catalan
Main Page/cs	Czech
Main Page/da	Danish
Main Page/de	German
Main Page/el	Greek
Main Page/es	Spanish
Main Page/fa	Persian
Main Page/fi	Finnish
Main Page/fr	French
Main Page/gu	Gujarati
Main Page/he	Hebrew
Main Page/hu	Hungarian
Main Page/id	Indonesian
Main Page/it	Italian
Main Page/ja	Japanese
Main Page/ko	Korean
Main Page/ksh	Kölsch
Main Page/mr	Marathi
Main Page/ms	Malay
Main Page/nl	Nederlands
Main Page/no	Norwegian
Main Page/oc	Occitan
Main Page/pl	Polish
Main Page/pt	Portugese
Main Page/ro	Romanian
Main Page/ru	Russian
Main Page/si	Sinhalese
Main Page/sq	Albanian
Main Page/sr	Serbian
Main Page/sv	Swedish
Main Page/th	Thai
Main Page/tr	Turkish
Main Page/uk	Ukrainian
Main Page/vi	Vietnamese
Main Page/yue	Cantonese
Main Page/zh	Chinese
Main Page/zh-hans	Chinese (Simplified)
Main Page/zh-hant	Chinese (Traditional)

模板用法晋级

• {{模板名称}} 会将模板的当前内容包含在页面内。
• {{subst:模板名称}} 会在保存后将模板的内容以平常可以编辑的方式 (wiki 代码) 插入页面源代码中。
• {{msgnw:模板名称}} 会将模板的源代码包含在页面中，类似一样。 *<nowiki><noinclude></noinclude> 和 <includeonly></includeonly> 是控制模板当中的内容哪些部分被当作模板使用而哪些不是当作模板使用。例如Template:首页布局当中使用了的<noinclude></noinclude> ,中间的内容用来解释模板是如何使用的。
• 更加详细的解释请参考官方中文帮助当中的模板
• 更多扩展语法请参考维基百科