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

From: Date: Mon, 01 Aug 2011 17:04:28 +0000
Subject: Re: Есть ли возможность д елать предварительный просмотр
References: 1 2 3 4 5  Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-2041@lists.php.net to get a copy of this message
Ок, рад что смог помочь :) 1 августа 2011 г. 22:02 пользователь Dmitriy Pakhtinov <ex.devote@gmail.com> написал: > Да спасибо, разобрался, все установил, все > сгенерил... проблем и > правда не вызвало. Теперь надо стили и прочии доп. > ресурсы скачать, но > это уже мелочь. Спасибо огромное! > > 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 >> > -- Regards, Shein Alexey

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