Re: Есть ли возможность д елать предварительный просмотр

From: Date: Mon, 01 Aug 2011 17:02:29 +0000
Subject: Re: Есть ли возможность д елать предварительный просмотр
References: 1 2 3 4  Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-2040@lists.php.net to get a copy of this message
Да спасибо, разобрался, все установил, все сгенерил... проблем и правда не вызвало. Теперь надо стили и прочии доп. ресурсы скачать, но это уже мелочь. Спасибо огромное! 1 августа 2011 г. 20:58 пользователь Alexey Shein <confik@gmail.com> написал: > Если вы опытный пользователь Windows и PHP (к сожалению, > не знаю ваш > уровень), то установить все это под виндоус также не > должно создать > проблем, я точно знаю, что несколько людей (не из doc-ru) > работают с > phd под виндоус. > > К сожалению, самое простое решение я уже озвучил - > все, что я написал > также сработает и из консоли Windows, просто придется > немного > повозиться. > Для работы локального сайта нужно будет сделать все > вышесказанное (ну > разве что в phd указать другой формат вывода) + еще > настроить > веб-сервер + скопировать доп. файлы с ближайшего к > вам зеркала php.net > (стили, картинки, js, т.к. эти файлы генерироваться не > будут). Но этот > последний шаг нужно сделать всего лишь раз, только > при установке. > > Опишу полную установку по шагам (скорее всего что-то > у вас уже настроено): > > 1. Установить PHP + Apache. > 2. Установить TortoiseSVN. > 3. Настроить запуск PHP из командной строки. > 4. Установить PEAR. > 5. Установить Phd и Phd_php через PEAR (см. предыдущее > письмо) > 6. Выгрузить копию репозитория (чекаут) к себе (эта > часть описывается > в статье на хабре). > 7. Сделать билд документации (запустить команду php > doc-base/configure.php --with-lang=ru, см. предыдущее письмо) > 8. Сгенерировать документацию в нужном формате (phd -d > doc-base/.manual.xml -P PHP -f xhtml или phd -d doc-base/.manual.xml > -P PHP -f php для локального сайта/зеркала) > 9. Настроить виртуальный хост для локального > зеркала, например, php.dz > (эта ссылка может помочь: > http://php.net/mirroring.php) > 10. Скопировать нужные файлы с ближайшего зеркала > (linux-решение с > помощью rsync указано в ссылке > http://php.net/mirroring.php, не знаю > как это аналогично можно сделать в Windows). > > Вот как-то так, проще не получится. > > Напишите на каком шаге вы остановились и будем уже > разбираться предметно. > Если у вас есть скайп, то напишите мне туда (мой > логин shein.alexey) и > я постараюсь вам помочь. > > 1 августа 2011 г. 20:08 пользователь Dmitriy Pakhtinov > <ex.devote@gmail.com> написал: >> Алексей, проблема в том что у меня Windows и хотелось >> бы для него >> самое простое решение, я понимаю что в линукс все >> проще, но сейчас нет >> возможности использовать линукс. Поэтому >> расскажите пожалуйста какие >> манипуляции нужно сделать что бы в виндовсе все >> это можно было >> конвертировать. И не совсем понял все же что проще >> сделать локальный >> сайт php.net или создать html есть ли возможность >> сделать это не >> устанавливая pear и все то что он требует. В идеале >> конечно лучше >> создать локальный сайт. Так намного удобнее, >> нежели юзать html. >> >> Заранее Спасибо! >> >> 1 августа 2011 г. 18:03 пользователь Alexey Shein >> <confik@gmail.com> написал: >>> Привет! >>> Есть возможность сгенерировать выходные файлы >>> в нескольких форматах, >>> проще всего это сделать в html-формате, но также >>> можно и в php-формате >>> (в этом случае у вас получается локальная копия >>> сайта php.net). >>> >>> Должен сразу предупредить, что это потребует >>> некоторых усилий. >>> >>> Для начала вам нужно скачать репозиторий >>> локально, как описано в >>> статье:http://habrahabr.ru/blogs/php/125341/ в >>> разделе "Альтернатива". >>> >>> Далее нужно установить Phd: >>> http://doc.php.net/phd/docs/ - это >>> утилита, используемая в самом PHP для генерации >>> документации (Php >>> Docbook Renderer). >>> >>> Проще всего это сделать через pear: >>> >>> $ pear install doc.php.net/phd >>> $ pear install doc.php.net/phd_php >>> >>> Phd нужен модуль php-sqlite, так что его нужно >>> установить заранее, >>> иначе ничего не получится. >>> >>> После того как phd установится, нужно собрать >>> билд: >>> >>> $ php doc-base/configure.php --with-lang=ru >>> >>> В случае успешного билда должно быть выведено >>> сообщение All good. >>> Saving .manual.xml... done. >>> Если вывелось Don't worry, Happ shittens, значит, вы >>> допустили ошибку >>> и ее нужно исправить. >>> >>> Далее можно генерировать саму документацию. >>> Для этого нужно указать команду >>> >>> $ phd -d doc-base/.manual.xml -P PHP -f xhtml >>> >>> Если все сработало верно, то у вас в консоли >>> должен идти лог действий >>> Phd, генерация занимает около 5 минут. Что-то >>> вроде этого: >>> >>> [18:56:23 - Rendering Style       ] Running full build >>> [18:56:23 - Indexing              ] Indexing... >>> [18:58:14 - Indexing              ] Indexing done >>> [18:58:15 - Rendering Style       ] Running full build >>> [18:58:15 - Rendering Format      ] Starting PHP-Web rendering >>> [19:01:30 - Rendering Format      ] Writing search indexes.. >>> [19:01:30 - Rendering Format      ] Index written >>> [19:01:30 - Rendering Format      ] Finished rendering >>> >>> BUILD FINISHED >>> >>> Total time: 6 minutes  15.92 seconds >>> >>> По окончании генерации должна появиться папка >>> output, в которой уже >>> будут сгенерированы готовые html-файлы, которые >>> уже можно смотреть >>> браузером. >>> >>> Список всех поддерживаемых форматов Phd можно >>> посмотреть командой >>> $ phd -l >>> >>> Удачи! >>> >>> 1 августа 2011 г. 18:08 пользователь Dmitriy Pakhtinov >>> <ex.devote@gmail.com> написал: >>>> Есть ли возможность делать предварительный >>>> просмотр того что я >>>> перевел, в локальной версии. То-есть XML это не >>>> HTML так просто в >>>> браузере его не посмотреть, хотелось бы >>>> видеть то что делаю. >>>> >>>> Заранее Спасибо! >>>> >>> >>> >>> >>> -- >>> Regards, >>> Shein Alexey >>> >> > > > > -- > Regards, > Shein Alexey >

« previous php.doc.ru (#2040) next »