php - 如何使用 Pear Text_wiki

Question

pear 网站上的文档链接到一个无法访问的站点。有谁知道可以解释如何使用 Text_wiki 包的网站、文章或书籍？

Answer 1

@mario 的回答是准确的，尽管很简短。我也对缺乏“让你快速入门”文档感到沮丧，并花了一些时间与源代码交流(诚然，这从来都不是坏事)。以下是为 Text_Wiki PEAR 包的 future 潜在用户提供的更多背景信息:

使用 PEAR 包:

• 使用类似pear install Text_Wiki

  的工具安装它

• 或者，您可以直接安装任何子包，例如 Mediawiki:pear install Text_Wiki_Mediawiki

• 安装 PEAR 包后，假设 PHP 和 PEAR 设置正确，您可以在 PHP 文件中require_once 'Text/Wiki/Mediawiki.php';。 (另请参阅:PEAR Troubleshooting Tips)

从那里您可以找到马里奥的起点。这里有更多详细信息可以帮助您解决问题:

• 此包为每个“规则”(例如段落、标题、维基链接、表格等)使用一个类。

• 规则在您的 PEAR 目录中被组织为单独的 PHP 类文件，并分为匹配您的维基文本输入部分的“解析”类和将匹配的维基文本格式化为输出格式(如纯文本)的“渲染”类或 XHTML。

• 您可以使用 pear config-get php_dir 找到您的 PEAR 目录。比如我的是/usr/share/php

• 安装的 PEAR 包位于与包名称匹配的子文件夹中，因此在我的机器上，“Text_Wiki_Mediawiki”位于 /usr/share/php/Text/Wiki/Mediawiki

• 对于给定的输出类型(如“Xhtml”)，每个渲染规则都有自己的配置选项。(在 Text/Wiki/Render/Xhtml/Wikilink.php 中查找 Wikilink规则选项。)这些选项必须使用 SetRenderConf() 方法设置。

• 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');

这些额外的要点可以帮助您了解在哪里可以找到可以调整的设置，从而让您更快地开始。