cvs: phpdoc-ru /chapters intro.xml tutorial.xml

shafff Sat Jan 17 12:58:59 2009 UTC Modified files: /phpdoc-ru/chapters intro.xml tutorial.xml Log: edit translation, fix xml

http://cvs.php.net/viewvc.cgi/phpdoc-ru/chapters/intro.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-ru/chapters/intro.xml diff -u phpdoc-ru/chapters/intro.xml:1.6 phpdoc-ru/chapters/intro.xml:1.7 --- phpdoc-ru/chapters/intro.xml:1.6 Sat Jan 17 12:35:57 2009 +++ phpdoc-ru/chapters/intro.xml Sat Jan 17 12:58:59 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.49 Maintainer: shafff Status: ready --> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <chapter xml:id="introduction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <info><title>Введение</title></info> @@ -8,7 +8,7 @@ <title>Что такое PHP?</title> <para> <acronym>PHP</acronym> (рекурсивный акроним словосочетания - "PHP: Hypertext Preprocessor) - это распространённый + PHP: Hypertext Preprocessor) - это распространённый язык программирования общего назначения с открытым исходным кодом. PHP сконструирован специально для ведения Web-разработок и код на нём может внедряться в HTML-код. @@ -244,7 +244,7 @@ по функциям</link> за более подробными сведениями о перечисленных выше расширениях. </para> - </sect1> + </section> </chapter> http://cvs.php.net/viewvc.cgi/phpdoc-ru/chapters/tutorial.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-ru/chapters/tutorial.xml diff -u phpdoc-ru/chapters/tutorial.xml:1.6 phpdoc-ru/chapters/tutorial.xml:1.7 --- phpdoc-ru/chapters/tutorial.xml:1.6 Thu Jan 24 14:29:01 2008 +++ phpdoc-ru/chapters/tutorial.xml Sat Jan 17 12:58:59 2009 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.10 Maintainer: alexws Status: ready --> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Краткое руководство</title> + <info><title>Краткое руководство</title></info> <para> В данном кратком руководстве на примерах объясняются основы PHP. @@ -17,28 +17,27 @@ как и обычные страницы на HTML. </para> - <sect1 xml:id="tutorial.requirements"> - <title>Что потребуется?</title> + <section xml:id="tutorial.requirements"> + <info><title>Что мне потребуется?</title></info> <para> В данном руководстве мы предполагаем, что ваш сервер имеет поддержку PHP и что все файлы, заканчивающиеся на <filename>.php</filename>, - обрабатываются PHP. В большинстве серверов это расширение используется для - PHP по умолчанию, но все-таки не лишним будет уточнить это у вашего - администратора сервера. Если ваш сервер поддерживает PHP, то у вас есть - все, что требуется. Просто создавайте ваши файлы <filename>.php</filename> + обрабатываются PHP. В большинстве случаев это расширение используется для + PHP по умолчанию, но всё-таки не лишним будет уточнить это у вашего + администратора сервера. Итак, если ваш сервер поддерживает PHP, то у вас есть + всё, что требуется. Просто создавайте файлы <filename>.php</filename> и размещайте их в вашем каталоге Web-сервера - они будут обрабатываться автоматически. Не нужно ничего компилировать, не нужно никаких дополнительных программ. Считайте файлы PHP обычными файлами HTML с - набором новых "волшебных" тегов, которые позволяют вам делать все, что - угодно. + набором новых «волшебных» тегов, которые позволяют вам «оживить» ваш сайт. </para> - </sect1> + </section> - <sect1 xml:id="tutorial.firstpage"> - <title>Первая страница на PHP</title> + <section xml:id="tutorial.firstpage"> + <info><title>Первая страница на PHP</title></info> <para> Создайте файл с именем <filename>hello.php</filename> в корневом - каталоге ваших документов Web-сервера и запишите в него следующее: + каталоге веб-сервера и запишите в него следующее: </para> <para> <example> @@ -73,10 +72,9 @@ </example> </para> <para> - Заметим, что сходства со скриптами на CGI нет. Файл не обязан быть - выполнимым или отмеченным любым другим образом. Это просто обычный - файл HTML, в котором есть набор специальных тегов, делающих много - интересного. + Заметим, что сходства со скриптами на CGI нет. Файл не должен быть + исполняемым или иметь какие-либо другеи атрибуты. Это просто обычный + файл HTML, в котором есть набор специальных тегов, делающих много интересного. </para> <para> Эта программа чрезвычайно проста, и для создания настолько простой @@ -86,10 +84,10 @@ </para> <para> Если у вас этот пример не отображает ничего или выводит окно загрузки, - или если вы видите весь этот файл в текстовом виде, то весьма вероятно, - что ваш Web-сервер не имеет поддержки PHP. Попросите вашего администратора + или если вы видите весь этот файл в текстовом виде, то скорей всено, + что ваш веб-сервер не имеет поддержки PHP. Попросите вашего администратора сервера включить такую поддержку. Предложите ему инструкцию по установке - - раздел "<link linkend="install">Установка</link>" данной + раздел <link linkend="install">Установка</link> данной документации. Если же вы хотите разрабатывать скрипты на PHP дома, то вам в раздел <link xlink:href="&url.php.downloads;">необходимые файлы</link>. Дома можно разрабатывать скрипты с использованием любой операционной @@ -108,7 +106,7 @@ Существует множество текстовых редакторов и интегрированных сред разработки (IDE), в которых вы можете создавать и редактировать файлы PHP. Список некоторых редакторов содержится в разделе - "<link xlink:href="&url.phpeditorlist;">Список редакторов PHP</link>". + <link xlink:href="&url.phpeditorlist;">Список редакторов PHP</link>. Если вы хотите порекомендовать какой-либо редактор, посетите данную страницу и попросите добавить данный редактор в список. </para> @@ -117,8 +115,8 @@ <note> <title>Пара слов о текстовых процессорах</title> <para> - Текстовые процессоры (StarOffice Writer, Microsoft Word, Abiword и - др.) в большинстве случаев не подходят для редактирования файлов PHP. + Текстовые процессоры (StarOffice Writer, Microsoft Word, Abiword и др.) + в большинстве случаев не подходят для редактирования файлов PHP. </para> <para> @@ -129,29 +127,29 @@ </note> <note> - <title>Пара слов о "Блокноте" Windows</title> + <title>Пара слов о Блокноте Windows</title> <para> - При написании скриптов PHP с использованием встроенного "Блокнота" - Windows необходимо сохранять файлы с расширением .php. "Блокнот" + При написании скриптов PHP с использованием встроенного Блокнота + Windows необходимо сохранять файлы с расширением .php. Блокнот автоматически добавляет расширение .txt. Для обхода этой проблемы существует несколько методов. </para> <para> - Можно поместить название файла в кавычки (пример: "hello.php"). + Можно поместить название файла в кавычки (пример: hello.php). </para> <para> - Кроме того, можно выбрать "Все файлы" вместо "Текстовые документы" из + Кроме того, можно выбрать «Все файлы» вместо «Текстовые документы» из ниспадающего списка с типами файлов в окне сохранения. После этого можно вводить имя файла без кавычек. </para> </note> - </sect1> + </section> - <sect1 xml:id="tutorial.useful"> - <title>Делаем что-нибудь полезное</title> + <section xml:id="tutorial.useful"> + <info><title>Делаем что-нибудь полезное</title></info> <para> Давайте сделаем что-нибудь полезное. К примеру, определим, какой браузер использует тот, кто смотрит в данный момент нашу страницу. @@ -320,9 +318,9 @@ <function>strstr</function> (другими словами, в зависимости от того, найдена строка "MSIE" или нет). </para> - </sect1> + </section> - <sect1 xml:id="tutorial.forms"> + <section xml:id="tutorial.forms"> <title>Работа с формами</title> <para> Одно из главнейших достоинств PHP - то, как он работает с формами HTML. @@ -389,9 +387,9 @@ данных GET, POST, COOKIE и FILE. Также советуем взглянуть на описание функции <function>import_request_variables</function>. </para> - </sect1> + </section> - <sect1 xml:id="tutorial.oldcode"> + <section xml:id="tutorial.oldcode"> <title>Использование старых программ с новыми версиями PHP</title> <para> Сейчас PHP является популярным языком сценариев (скриптов). Становится @@ -443,9 +441,9 @@ linkend="language.variables.predefined">Предопределенные переменные</link>" и ссылки этого раздела. </para> - </sect1> + </section> - <sect1 xml:id="tutorial.whatsnext"> + <section xml:id="tutorial.whatsnext"> <title>Что дальше?</title> <para> То, что вы узнали, поможет вам понять большую часть руководства и @@ -453,7 +451,7 @@ примеры находятся на различных сайтах, ссылки на которые можно найти на php.net: <link xlink:href="&url.php.links;">&url.php.links;</link>. </para> - </sect1> + </section> </chapter> <!-- Keep this comment at the end of the file