phpDocumentor и UTF-8 исходники

[zizop]

Как заставить phpDocumentator понимать русский текст в исходниках на UTF-8:

1. нужно править файл Setup.inc.php. В нем есть метод createDocs, где нужно исправить следующее
- if (stristr($ret, "utf-8") !== "")
+ if (stristr($ret, "utf-8") === false)
{
$ret = utf8_decode($ret);
}


2. Пройтись глобальной заменой по всем (*.*) файлам документатора и заменить
charset=iso-8859-1'/>
на
charset=utf-8'/>

3. Необязательный (у меня и без этого заработало, но возможно это имеет значение при выводе мануала в XML)
Пройтись глобальной заменой по всем (*.*) файлам документатора и заменить
<?xml version="1.0" encoding="iso-8859-1"?>
на
<?xml version="1.0" encoding="utf-8"?>

P.S. Тестировалось на теме HTML:frames:default

Ну и на закуску, готовый плагин для Для просмотра ссылки Войди или Зарегистрируйся

 

[PHP_Master]

1. всё таки phpDocumentor а не phpDocumentator
2. Нахрена плагин под ZDE, если он итак там есть?

 

[Slayter]

Пишите комментарии к коду и все описания только на английском. Вы не знаете кому после вас рано или поздно придётся править ваши скрипты.

Случай из жизни: дали проект на переработку, который был сделан каким-то итальянским фрилансером, так, ***ть, там даже файлы были названы на итальянском: config по итальянски (или испански я хз точно) оказался чем-то типа connexao. И, ***ть, часть переменных была названа на инглише, а часть на его языке. Так что уважайте других и пишите все комментарии на английском, а так же придерживайтесь единого стиля кодирования (PEAR, например).