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

Тема в разделе "Как сделать...", создана пользователем zizop, 24 янв 2009.

Статус темы:
Закрыта.
  1. zizop

    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

    Ну и на закуску, готовый плагин для Zend Studio for Eclipse
     
  2. PHP_Master

    PHP_Master

    Регистр.:
    3 фев 2008
    Сообщения:
    2.647
    Симпатии:
    590
    1. всё таки phpDocumentor а не phpDocumentator
    2. Нахрена плагин под ZDE, если он итак там есть?
     
  3. Slayter

    Slayter

    Регистр.:
    8 апр 2006
    Сообщения:
    232
    Симпатии:
    52
    Пишите комментарии к коду и все описания только на английском. Вы не знаете кому после вас рано или поздно придётся править ваши скрипты.

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