@mario 的回答虽然简短,但很准确。我也因缺乏“让我们快速入门”文档而感到沮丧,并花了一些时间与源代码进行交流(诚然,这绝不是一件坏事)。以下是为 Text_Wiki PEAR 包的未来潜在用户提供的更多背景信息:
要使用 PEAR 包:
用类似的东西安装它pear install Text_Wiki
或者,您可以直接安装任何子包,例如 Mediawiki:pear install Text_Wiki_Mediawiki
安装 PEAR 包后,您可以require_once 'Text/Wiki/Mediawiki.php';
在您的 PHP 文件中,假设 PHP 和 PEAR 设置正确。 (也可以看看:PEAR 故障排除技巧 http://pear.php.net/manual/en/installation.checking.php)
从那里你可以从马里奥开始的地方开始。这里有一些更详细的信息可以帮助您:
该包为每个“规则”使用一个类(例如段落、标题、维基链接、表格等)。
这些规则在 PEAR 目录中组织为单独的 PHP 类文件,并分为与 wiki 文本输入部分匹配的“解析”类和将匹配的 wiki 文本格式化为纯文本或 XHTML 等输出格式的“渲染”类。
您可以使用以下命令找到您的 PEAR 目录pear config-get php_dir
。例如,我的是/usr/share/php
安装的 PEAR 软件包位于与软件包名称匹配的子文件夹中,因此在我的计算机上,“Text_Wiki_Mediawiki”位于/usr/share/php/Text/Wiki/Mediawiki
对于给定的输出类型(如“Xhtml”),每个渲染规则都有自己的配置选项。(查看Text/Wiki/Render/Xhtml/Wikilink.php
用于 Wikilink 规则选项。)这些选项必须使用SetRenderConf()
method.
-
SetRenderConf()
采用以下参数:
- 输出类型的名称,通常为“xhtml”
- 您要调整的规则的名称,该名称将与文件名匹配。例如“维基链接”。
- 您要设置的规则中的选项的名称。
- 分配给该选项的值。
您必须阅读每个规则的源代码才能了解其可用的选项。
您可以通过将带有规则名称的数组或字符串传递到构造函数来控制要使用哪些规则以及调用它们的顺序。
<?php
require_once 'Text/Wiki/Mediawiki.php';
// If you only wanted ==Heading==s, <P>aragraphs and
// [[Wikilink]]s in your output:
//$rules = array('Heading', 'Paragraph', 'Wikilink');
//$wiki = new Text_Wiki_Mediawiki($rules);
// Create a new Text_Wiki instance with default rules:
$wiki = new Text_Wiki_Mediawiki();
// When rendering XHTML, make sure "internal" wiki links
// point to a specific base URL.
$wiki->setRenderConf('xhtml', 'Wikilink', 'view_url',
'http://your.wikibaseurl.com/wiki/');
// Turn off fake "page exists?" checking.
// This makes every "internal" link point to an "existing" wiki page
// instead of a "page doesn't exist, do you want to create it?" page.
$wiki->setRenderConf('xhtml', 'Wikilink', 'pages', false);
// Turn off opening external links in a new window.
$wiki->setRenderConf('xhtml', 'Url', 'target', false);
// With all of your options set, transform source text
// into a destination format using the "Xhtml" renderers.
print $wiki->transform("==Some wiki text==", 'Xhtml');
这些额外的要点应该可以帮助您知道在哪里寻找可以调整的设置,从而让您更快地开始。