Re: Есть ли возможность д елать предварительный просмотр
| From: | Alexey Shein | 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