Re: Есть ли возможность д елать предварительный просмотр
| From: | Alexey Shein | Date: | Mon, 01 Aug 2011 16:58:57 +0000 |
| Subject: | Re: Есть ли возможность д елать предварительный просмотр | ||
| References: | 1 2 3 | Groups: | php.doc.ru |
| Request: | Send a blank email to doc-ru+get-2039@lists.php.net to get a copy of this message | ||
Если вы опытный пользователь 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