Документы на веб-сайте груши ссылаются на сайт, к которому невозможно получить доступ. Кто-нибудь знает сайт, статью или книгу, которые объяснят, как использовать пакет Text_wiki?
Документация доступна здесь: http://pear.php.net/package/Text_Wiki/docs/latest/Text_Wiki/Text_Wiki.html#methodtransform
В простейшем случае вам просто нужно:
$wiki = new Text_Wiki; print $wiki->transform($source_text, "Xhtml");
Ответ @ mario является точным, хотя и кратким. Я был разочарован отсутствием документации «давайте начнем быстро» и потратил некоторое время на общение с источником (что, по общему признанию, никогда не плохо). Вот еще несколько справочных сведений для будущих потенциальных пользователей пакета Text_Wiki PEAR:
Чтобы использовать пакет PEAR:
Установите его с чем-то вроде pear install Text_Wiki
Кроме того, вы можете установить любой из pear install Text_Wiki_Mediawiki
непосредственно, например, Mediawiki: pear install Text_Wiki_Mediawiki
Когда пакет PEAR установлен, вы можете require_once 'Text/Wiki/Mediawiki.php';
в вашем PHP-файле, предполагая, что PHP и PEAR настроены правильно. (См. Также: Советы по устранению неполадок PEAR )
Оттуда вы можете забрать, где началось марио. Вот несколько деталей, которые помогут вам:
Этот пакет использует один класс для каждого «правила» (например, для абзацев, заголовков, Wikilinks, Tables, …).
Правила организованы как отдельные файлы классов PHP в вашем каталоге PEAR и разделены на классы «Parse», которые соответствуют частям ваших входных данных wikitext и «Render», которые отформатируют согласованный wikitext в формате вывода, таком как обычный текст или XHTML.
Вы можете найти свой каталог PEAR, используя pear config-get php_dir
. Например, у меня есть /usr/share/php
Установленные пакеты PEAR находятся в подпапках, соответствующих имени пакета, поэтому на моей машине «Text_Wiki_Mediawiki» находится в /usr/share/php/Text/Wiki/Mediawiki
Для данного типа вывода (например, «Xhtml») каждое правило Render имеет свои собственные параметры конфигурации. (Смотрите в Text/Wiki/Render/Xhtml/Wikilink.php
для параметров правила Wikilink.) Эти параметры должны быть установлены с помощью SetRenderConf()
.
SetRenderConf()
принимает следующие аргументы:
Вы должны прочитать исходный код каждого правила, чтобы узнать, какие опции доступны для него.
Вы можете контролировать, какие правила использовать и какой порядок их вызывать, передав в конструктор массив или строки с именами правил.
<?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');
Эти дополнительные моменты помогут вам начать гораздо быстрее, помогая вам узнать, где искать параметры, которые можно настроить.