Warning: Cannot use a scalar value as an array in /home/admin/public_html/forum/include/fm.class.php on line 757

Warning: Invalid argument supplied for foreach() in /home/admin/public_html/forum/include/fm.class.php on line 770
Форумы портала PHP.SU :: Версия для печати :: phpDocumentor - русский текст
Форумы портала PHP.SU » PHP » PEAR и PECL » phpDocumentor - русский текст

Страниц (1): [1]
 

1. DrunkenStranger - 02 Сентября, 2011 - 11:21:49 - перейти к сообщению
Есть проект, который надо задокументировать. Все исходники на 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). В инете где ни ищешь везде один совет:
CODE (php):
скопировать код в буфер обмена
  1. // fix 1151650
  2. if (stristr($ret, "utf-8") !== "")
  3. {
  4.     $ret = utf8_decode($ret);
  5. }

поменять на
CODE (php):
скопировать код в буфер обмена
  1. // fix 1151650
  2. if (stristr($ret, "utf-8") === false)
  3. {
  4.     $ret = utf8_decode($ret);
  5. }

Оно может какой-то смысл когда-то и имело, но сейчас ИМХО не более чем заноза в попе. Комментируем все:
CODE (php):
скопировать код в буфер обмена
  1. /*// fix 1151650
  2. if (stristr($ret, "utf-8") === false)
  3. {
  4.     $ret = utf8_decode($ret);
  5. }*/

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

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

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

 

Powered by ExBB FM 1.0 RC1