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