как использовать Pear Text_wiki

Документы на веб-сайте груши ссылаются на сайт, к которому невозможно получить доступ. Кто-нибудь знает сайт, статью или книгу, которые объяснят, как использовать пакет 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() принимает следующие аргументы:

    • Имя типа вывода, обычно 'xhtml'
    • Имя правила, которое вы хотите настроить, которое будет соответствовать имени файла. Например, «Wikilink».
    • Имя параметра из этого правила, которое вы хотите установить.
    • Значение для назначения этому параметру.
  • Вы должны прочитать исходный код каждого правила, чтобы узнать, какие опции доступны для него.

  • Вы можете контролировать, какие правила использовать и какой порядок их вызывать, передав в конструктор массив или строки с именами правил.

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

Эти дополнительные моменты помогут вам начать гораздо быстрее, помогая вам узнать, где искать параметры, которые можно настроить.