# PHP/php_en/html/about.generate.html.gz
# PHP/php_ru/html/about.generate.html.gz


(src)="s1.1"> PHP Manual
(trg)="s1.1"> Руководство по PHP

(src)="s2.1"> Prev
(trg)="s2.1"> Пред .

(src)="s3.1"> Appendix K .
(trg)="s3.1"> Приложение K . Об этом руководстве

(src)="s3.2"> About the manual
(trg)="s4.1"> След .

(src)="s4.1"> Next
(trg)="sabout.generate.1"> Как создаются форматы документации

(src)="s5.1"> This manual is written in XML using the DocBook XML DTD , using DSSSL ( Document Style and Semantics Specification Language ) for formatting , and experimentally the XSLT (Extensible Stylesheet Language Transformations ) for maintenance and formatting .
(trg)="s5.1"> Это руководство написано на XML с использованием DocBook XML DTD , DSSSL ( Document Style and Semantics Specification Language ) для форматирования и (экспериментально ) XSLT (Extensible Stylesheet Language Transformations ) в целях поддержки и форматирования .

(src)="s6.1"> Using XML as a source format gives us the ability to generate many output formats from the source files , while only maintaining one source document for all formats .

(src)="s6.2"> The tools used for formatting HTML and TeX versions are Jade , written by James Clark and The Modular DocBook Stylesheets written by Norman Walsh .
(src)="s6.3"> We use Microsoft HTML Help Workshop to generate the Windows HTML Help format of the manual , and of course PHP itself to do some additional conversions and formatting .
(trg)="s6.1"> Использование XML в качестве единственного исходного формата позволяет нам создавать документацию во многих форматах . Утилитами для форматирования форматов HTML и TeX являются Jade , написанная James Clark и The Modular DocBook Stylesheets написанная Norman Walsh . Для создания руководства в формате Windows HTML Help мы используем Microsoft HTML Help Workshop и , конечно , собственно PHP для дополнительных преобразований и форматирования .

(src)="s7.1"> You can download the manual in various languages and formats , including plain text , plain HTML , PDF , PalmPilot DOC , PalmPilot iSilo and Windows HTML Help , from http : / /www.php.net / docs.php .
(src)="s7.2"> The manuals are updated automatically as the text is updated .
(trg)="s7.1"> Вы можете загрузить руководство на многих языках и во многих форматах , включая обычный текст , обычный HTML , PDF , PalmPilot DOC , PalmPilot iSilo и Windows HTML Help , обратившись по адресу http : / /www.php.net / docs.php . Материалы , предназначенные для загрузки , обновляются автоматически по мере обновления исходного текста .

(src)="s8.1"> You can find more information about downloading the XML source code of this documentation at http : / /cvs.php.net / .
(src)="s8.2"> The documentation is stored in the phpdoc module .
(trg)="s8.1"> За более подробной информацией о получении исходного кода в формате XML обратитесь по адресу http : / /cvs.php.net / . Документация находится в модуле phpdoc .

(src)="s9.1"> Prev
(trg)="s9.1"> Пред .

(src)="s10.1"> Home
(trg)="s10.1"> Начало

(src)="s11.1"> Next
(trg)="s11.1"> След .

(src)="s12.1"> How to help improve the documentation
(trg)="s12.1"> Как помочь в написании документации

(src)="s13.1"> Up
(trg)="s13.1"> Уровень выше

(src)="s14.1"> Translations
(trg)="s14.1"> Переводы

# PHP/php_en/html/about.howtohelp.html.gz
# PHP/php_ru/html/about.howtohelp.html.gz


(src)="s1.1"> PHP Manual
(trg)="s1.1"> Руководство по PHP

(src)="s2.1"> Prev
(trg)="s2.1"> Пред .

(src)="s3.1"> Appendix K .
(trg)="s3.1"> Приложение K . Об этом руководстве

(src)="s3.2"> About the manual
(trg)="s4.1"> След .

(src)="s4.1"> Next
(trg)="sabout.howtohelp.1"> Как помочь в написании документации

(src)="s5.1"> There are three ways you can help to improve this documentation .
(trg)="s5.1"> Существуют три способа , чтобы помочь нам в улучшении документации .

(src)="s6.1"> If you find errors in this manual , in any language , please report them using the bug system at http : / /bugs.php.net / .
(src)="s6.2"> Classify the bug as " Documentation Problem " .
(trg)="s6.1"> Если вам встречаются ошибки в этом руководстве , сообщайте о них с помощью системы сообщения об ошибках , доступной по адресу http : / /bugs.php.net / . Классифицируйте ваше сообщение как " Documentation Problem " ("Ошибка в документации" ) . Также вы можете сообщать об ошибках , относящихся к какому-либо определенному формату руководства .

(src)="s6.3"> You can also submit problems related to specific manual formats here .

(src)="s7.1"> Note :

(src)="s7.2"> Please don ' t abuse the bug system by submitting requests for help .
(src)="s7.3"> Use the mailing lists or community sites mentioned earlier , instead .
(trg)="s7.1"> Замечание : Пожалуйста , не используйте систему сообщения об ошибках для того , чтобы получить помощь какого-либо рода . Вместо этого пользуйтесь списками рассылки или сайтами сообщества PHP , упомянутыми выше .

(src)="s8.1"> By contributing notes , you can provide additional examples , caveats , and clarifications for other readers .
(src)="s8.2"> But do not submit bug reports using the annotation system please .
(trg)="s8.1"> Не используйте систему аннотации для сообщений об ошибках . Более подробные сведения о заметках пользователей вы можете получить , ознакомившись с главой ' О заметках пользователей ' этого приложения .

(src)="s8.3"> You can read more about annotations in the ' About user notes ' section of this appendix .

(src)="s9.1"> If you know English and some foreign language , you may also help out in the translations .
(src)="s9.2"> If you would like to start a new translation , or help in a translation project , please read http : / /cvs.php.net / co.php / phpdoc / howto / howto.html.tar.gz .
(trg)="s9.1"> Если вы знаете английский язык и не являетесь его носителем , вы можете участвовать в переводе руководства . Если вы собираетесь приступить к переводу , обратитесь к http : / /cvs.php.net / co.php / phpdoc / howto / howto.html.tar.gz .

(src)="s10.1"> Prev
(trg)="s10.1"> Пред .

(src)="s11.1"> Home
(trg)="s11.1"> Начало

(src)="s12.1"> Next
(trg)="s12.1"> След .

(src)="s13.1"> How to find more information about PHP
(trg)="s13.1"> Как узнать больше о PHP

(src)="s14.1"> Up
(trg)="s14.1"> Уровень выше

(src)="s15.1"> How we generate the formats
(trg)="s15.1"> Как создаются форматы документации

# PHP/php_en/html/about.html.gz
# PHP/php_ru/html/about.html.gz


(src)="s1.1"> PHP Manual
(trg)="s1.1"> Руководство по PHP

(src)="s2.1"> Prev
(trg)="s2.1"> Пред .

(src)="s3.1"> Next
(trg)="s3.1"> След .

(src)="s4.1"> The PHP manual is provided in several formats .
(src)="s4.2"> These formats can be divided into two groups : online readable formats , and downloadable packages .
(trg)="sabout.1"> Приложение K . Об этом руководстве

(src)="s5.1"> Note :
(trg)="sabout.formats.1"> Форматы

(src)="s5.2"> Some publishers have made available printed versions of this manual .
(src)="s5.3"> We cannot recommend any of those , as they tend to become out-of-date very quickly .
(trg)="s5.1"> Руководство по PHP доступно в нескольких форматах . Эти форматы могут быть разделены на две группы : форматы для чтения в онлайн и форматы , доступные для загрузки .

(src)="s6.1"> You can read the manual online at http : / /www.php.net / You can read the manual online at http : / /www.php.net / and on the numerous mirror sites .
(src)="s6.2"> For best performance , you should choose the mirror site closest to you .
(trg)="s6.1"> Замечание : Некоторые издательства выпустили печатные версии этого руководства . Однако , мы не рекомендуем пользоваться ими вследствие их быстрого устаревания .

(src)="s6.3"> You can view the manual in either its plain ( print-friendly ) HTML format or an HTML format that integrates the manual into the look and feel of the PHP website itself .
(src)="s7.1"> An advantage of the online manual over most of the offline formats is the integration of user-contributed notes .
(trg)="s7.1"> Вы можете пользоваться руководством в он-лайн по адресу http : / /www.php.net / , а также на многочисленных сайтах-зеркалах . Чтобы обеспечить наиболее высокую скорость загрузки , вам нужно выбрать ближайший к вам сайт-зеркало . Вы можете пользоваться руководством в виде обычного HTML ( готового для распечатки ) или же в виде , предлагающем оформление самого сайта PHP .

(src)="s7.2"> An obvious disadvantage is that you have to be online to view the manual in the online formats .
(src)="s8.1"> There are several offline formats of the manual , and the most appropriate format for you depends on what operating system you use and your personal reading style .
(trg)="s8.1"> Преимуществом он-лайн руководства над большинством офф-лайн форматов является интеграция с замечаниями пользователей . Очевидным недостатком является то , что вам нужно находиться в он-лайне , чтобы пользоваться руководством в он-лайн форматах .

(src)="s8.2"> For information on how the manual is generated in so many formats , read the ' How we generate the formats ' section of this appendix .
(src)="s9.1"> The most cross-platform formats of the manual are the HTML and plain-text versions .
(trg)="s9.1"> Существуют несколько форматов для использования в офф-лайне , и вы можете выбрать формат , наиболее подходящий для использования в вашей операционной системе и отвечающий вашим читательским предпочтениям . Чтобы узнать больше о том , каким образом создается такое количество форматов руководства , обратитесь к разделу ' Как мы создаем форматы руководства ' .
(trg)="s10.1"> Наиболее кросс-платформенными форматами этого руководства являются формат HTML и формат обычного текста . Формат HTML доступен как в виде одного HTML-файла , так и в виде архива , содержащего несколько тысяч файлов , каждый из которых является отдельной главой руководства . Форматы HTML и обычного текста доступны в качестве файлов tar , упакованных архиватором bzip2 .

(src)="s9.2"> The HTML format is provided both as a single HTML file and as a package of individual files for each section ( which results in a collection of several thousand files ) .
(src)="s9.3"> The HTML and plaintext formats are provided as tar files compressed using the bzip2 archiver .
(trg)="s11.1"> Другим популярным кросс-платформенным форматом , к тому же наиболее подходящим для печати , является PDF ( также известный как Adobe Acrobat ) . Но прежде чем вы начнете загрузку этого формата и нажмете на кнопку Печать , имейте в виду , что руководство состоит примерно из 2000 страниц и постоянно обновляется .

(src)="s10.1"> Another popular cross-platform format , and the format most suited to printing , is PDF ( also known as Adobe Acrobat ) .
(src)="s10.2"> But before you rush to download this format and hit the Print button , be warned that the manual is nearly 2000 pages long , and constantly being revised .
(trg)="s12.1"> Замечание : Если у вас еще нет программы для просмотра формата PDF , вам нужно будет загрузить Adobe Acrobat Reader .

(src)="s11.1"> Note :

(src)="s11.2"> If you do not already have a program capable of viewing PDF format files , you may need to download Adobe Acrobat Reader .
(src)="s12.1"> For owners of Palm-compatible handhelds , the Palm document and iSilo formats are ideal for this platform .
(trg)="s13.1"> Для владельцев Palm-совместимых компьютеров идеально подойдут форматы руководства Palm document и iSilo . Вы можете захватить с собой ваш Palm , например , на совещание и использовать программу чтения форматов DOC или iSilo как удобный справочник или чтобы просто освежить в памяти какие-либо сведения о PHP .

(src)="s12.2"> You can bring your handheld with you on your daily commute and use a DOC or iSilo reader to brush up on your PHP knowledge , or just use it as a quick reference .
(src)="s13.1"> For Windows platforms , the Windows HTML Help version of the manual soups up the HTML format for use with the Windows HTML Help application .
(trg)="s14.1"> На платформах Windows доступна версия руководства в формате HTML , который может быть просмотрен с помощью приложения Windows HTML Help . Эта версия предусматривает поиск по тексту руководства , полный список тем и поддержку использования закладок . Многие среды разработки PHP-программ в Windows также используют эту версию для легкости доступа .

(src)="s13.2"> This version provides full-text search , a full index , and bookmarking .
(src)="s13.3"> Many popular Windows PHP development environments also integrate with this version of the documentation to provide easy access .
(trg)="s15.1"> Замечание : В данный момент проект Visual Basic для Linux находится на стадии планирования и будет включать CHM Creator и CHm Viewer для Linux . Если вы заинтересованы в том , как идет разработка , посетите страничку проекта на SourceForge.net .

(src)="s14.1"> Prev
(trg)="s16.1"> Пред .

(src)="s15.1"> Home
(trg)="s17.1"> Начало

(src)="s16.1"> Next
(trg)="s18.1"> След .

(src)="s18.1"> Up
(trg)="s20.1"> Уровень выше

(src)="s19.1"> About user notes
(trg)="s21.1"> О заметках пользователей

# PHP/php_en/html/about.more.html.gz
# PHP/php_ru/html/about.more.html.gz


(src)="s1.1"> PHP Manual
(trg)="s1.1"> Руководство по PHP

(src)="s2.1"> Prev
(trg)="s2.1"> Пред .

(src)="s3.1"> Appendix K .
(trg)="s3.1"> Приложение K . Об этом руководстве

(src)="s3.2"> About the manual
(trg)="s4.1"> След .

(src)="s4.1"> Next
(trg)="sabout.more.1"> Как узнать больше о PHP

(src)="s5.1"> This manual does not attempt to provide instruction about general programming practices .

(src)="s5.2"> If you are a first-time , or even just a beginning , programmer , you may find it difficult to learn how to program in PHP using just this manual .
(src)="s5.3"> You may want to seek out a text more oriented towards beginners .
(trg)="s5.1"> Это руководство не пытается охватить вопросы общего программирования . Если вы являетесь новичком или даже начинающим программистом , написание PHP-программ может показаться вам трудным , если вы будете использовать только это руководство . Вам , скорее всего , может понадобиться материал , более подходящий для начинающих . По адресу http : / /www.php.net / books.php вы можете найти список книг по теме PHP .

(src)="s5.4"> You can find a list of PHP-related books at http : / /www.php.net / books.php .

(src)="s6.1"> There are a number of active mailing lists for discussion of all aspects of programming with PHP .

(src)="s6.2"> If you find yourself stuck on a problem for which you can ' t find your own solution , you may be able to get help from someone on these lists .
(src)="s6.3"> You can find a list of the mailing lists at http : / /www.php.net / support.php , as well as links to the mailing list archives and other online support resources .
(trg)="s6.1"> Существует несколько списков рассылки , предназначенных для обсуждения всех аспектов программирования на PHP . Если вы чувствуете , что не можете найти решение какой-либо проблемы , кто-нибудь из подписчиков списка , вполне вероятно , сможет вам помочь . За перечислением доступных списков рассылки вы можете обратиться по адресу http : / /www.php.net / support.php , кроме того , там вы сможете найти архивы рассылок и другие ресурсы он-лайн поддержки . Кроме того , по адресу http : / /www.php.net / links.php доступен список веб-сайтов , посвященных статьям по PHP , форумам и галереям кода .

(src)="s6.4"> Furthermore , at http : / /www.php.net / links.php there is a list of websites devoted to PHP articles , forums , and code galleries .

(src)="s7.1"> Prev
(trg)="s7.1"> Пред .

(src)="s8.1"> Home
(trg)="s8.1"> Начало

(src)="s9.1"> Next
(trg)="s9.1"> След .

(src)="s10.1"> PHP versions documented in this manual
(trg)="s10.1"> О заметках пользователей

(src)="s11.1"> Up
(trg)="s11.1"> Уровень выше

(src)="s12.1"> How to help improve the documentation
(trg)="s12.1"> Как помочь в написании документации

# PHP/php_en/html/about.notes.html.gz
# PHP/php_ru/html/about.notes.html.gz


(src)="s1.1"> PHP Manual
(trg)="s1.1"> Руководство по PHP

(src)="s2.1"> Prev
(trg)="s2.1"> Пред .

(src)="s3.1"> Appendix K .
(src)="s3.2"> About the manual
(trg)="s3.1"> Приложение K . Об этом руководстве

(src)="s4.1"> Next
(trg)="s4.1"> След .

(src)="s5.1"> The user-contributed notes play an important role in the development of this manual .
(trg)="sabout.notes.1"> О заметках пользователей

(src)="s5.2"> By allowing readers of the manual to contribute examples , caveats , and further clarifications from their browser , we are able to incorporate that feedback into the main text of the manual .
(src)="s5.3"> And until the notes have been incorporated , they can be viewed in their submitted form online and in some of the offline formats .
(trg)="s5.1"> Заметки пользователей играют большую роль в процессе создания этого руководства . Позволяя читателям высылать нам примеры , выявленные опечатки и другие сведения с помощью их броузеров , мы имеем возможность добавить эти замечания в текст руководства . Пока замечания пользователей не были добавлены в руководство , с ними можно ознакомиться в он-лайн и в некоторых офф-лайн форматах .

(src)="s6.1"> Note :

(src)="s6.2"> The user-contributed notes are not moderated before they appear online , so the quality of the writing or code examples , and even the veracity of the contribution , cannot be guaranteed . ( Not that there is any guarantee of the quality or accuracy of the manual text itself . )

(src)="s7.1"> Note :

(src)="s7.2"> For the purposes of license coverage the user-contributed notes are considered part of the PHP manual , and are therefore covered by the same license that covers this documentation ( GPL at the moment ) .
(src)="s7.3"> For more details see the Manual ' s Copyright page .
(trg)="s6.1"> Замечание : Заметки пользователей не подвергаются модерации перед тем , как стать публично доступными , таким образом , качество написания примеров кода и даже их корректность не может быть гарантирована . ( Так же , как не может быть гарантировано качество и точность собственно текста руководства ) .

(src)="s8.1"> Prev
(trg)="s7.1"> Пред .

(src)="s9.1"> Home
(trg)="s8.1"> Начало

(src)="s10.1"> Next
(trg)="s9.1"> След .

(src)="s11.1"> About the manual
(trg)="s10.1"> Об этом руководстве

(src)="s12.1"> Up
(trg)="s11.1"> Уровень выше

(src)="s13.1"> How to read a function definition ( prototype )
(trg)="s12.1"> Как узнать больше о PHP

# PHP/php_en/html/about.translations.html.gz
# PHP/php_ru/html/about.translations.html.gz


(src)="s1.1"> PHP Manual
(trg)="s1.1"> Руководство по PHP

(src)="s2.1"> Prev
(trg)="s2.1"> Пред .

(src)="s3.1"> Appendix K .
(trg)="s3.1"> Приложение K . Об этом руководстве

(src)="s3.2"> About the manual
(trg)="s4.1"> След .

(src)="s4.1"> Next
(trg)="sabout.translations.1"> Переводы

(src)="s5.1"> The PHP manual is not only available in various formats , it is also available in various languages .

(src)="s5.2"> The text of the manual is first written in english , then teams of people across the world take care of translating it to their native language .
(src)="s5.3"> If a translation for a specified function or chapter has not yet been made , the build system of the manual falls back to the english version of it .
(trg)="s5.1"> Руководство по PHP доступно не только в нескольких форматах , но и на различных языках . Сначала текст руководства пишется на английском , а затем команды пользователей по всему миру переводят его на свой язык . Если перевод документации какой-либо функции или главы еще не был завершен , система сборки руководства использует соответствующий английский вариант .

(src)="s6.1"> Peoples involved in the translations start from the XML source code available from http : / /cvs.php.net / and from it they translate to thier mother language .
(src)="s6.2"> They do not use the HTML , the plain text , or the PDF version .
(trg)="s6.1"> Пользователи , осуществляющие перевод документации , используют исходный код в формате XML , доступный по адресу http : / /cvs.php.net / и переводят его на свой родной язык . Для перевода не используются форматы HTML , обычного текста или PDF . Преобразованием XML в читабельные форматы занимается система сборки документации .

(src)="s6.3"> It is the build system which takes care of the conversions from XML to human readable formats .

(src)="s7.1"> Note :
(src)="s7.2"> If you would like to help translating the documentation to your native language , please get in touch with the translation / documentation team subscribing to the phpdoc mailinglist : send an empty mail to phpdoc-subscribe@lists.php.net .
(trg)="s7.1"> Замечание : Если вы хотите принять участие в переводе документации на ваш родной язык , присоединитесь к команде перевода , подписавшись на список рассылки phpdoc : вышлите пустое сообщение на адрес phpdoc-subscribe@lists.php.net . Адрес списка рассылки - phpdoc@lists.php.net . Вышлите в рассылку сообщение , что вы заинтересованы в участии в переводе руководства и кто-нибудь поможет вам начать новый перевод или найти команду , занимающуюся переводом на ваш язык .

(src)="s7.3"> The mailing list address is phpdoc@lists.php.net .