Форум программистов [Powered by Invision Power Board]

Версия для печати темы
Нажмите сюда для просмотра этой темы в оригинальном формате

Форум программистов > PHP: Libraries > phpDocumentor - русский текст

Автор: DrunkenStranger 2.9.2011, 07:21

Есть проект, который надо задокументировать. Все исходники на cp1251. Логично сделать документацию в той же кодировке.

1. Устанавливаем интегрированный с PEAR потому как есть подозрения что отдельным архивом косячный.
2. Поиск/замена по всем TPL файлам (C:\php5\pear\data\PhpDocumentor\phpDocumentor\Converters для установки с PEAR) "iso-8859-1" на "windows-1251". После этого русский текст отображается в документации кода, но не отображается в туториалах и RIC (README, INSTALL, CHANGELOG).
3. Редактируем Setup.inc.php (PEAR\PhpDocumentor\phpDocumentor для установки с PEAR). В инете где ни ищешь везде один совет:

Код

// fix 1151650
if (stristr($ret, "utf-8") !== "")
{
    $ret = utf8_decode($ret);
}

поменять на

Код

// fix 1151650
if (stristr($ret, "utf-8") === false)
{
    $ret = utf8_decode($ret);
}

Оно может какой-то смысл когда-то и имело, но сейчас ИМХО не более чем заноза в попе. Комментируем все:

Код

/*// fix 1151650
if (stristr($ret, "utf-8") === false)
{
    $ret = utf8_decode($ret);
}*/

Теперь русский текст отображается в туториалах.

А теперь сам вопрос: у кого-нибудь получалось добиться отображение русского текста в README, INSTALL, CHANHGELOG?

P.S. Создаю тему здесь потому как уже заепси рыться в англоязычных форумах. Не надо отвечать "используй Doxygen". С UTF-8 такая же фигня.