Hi everybody! We want to make the translation of PHP manual into Ukrainian.
We would like to ask you to make the Ukrainian language enable in https://edit.php.net/. And so we need an VCS-account, if it is possible. This is one of the translated files, the English version of which is located at phpdoc-en-trunk-appendices-about.xml ---------------------------------------------------------------------------------- <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> <appendix xml:id="about" xmlns="http://docbook.org/ns/docbook"; xmlns:xlink=" http://www.w3.org/1999/xlink";> <title>Про довідник</title> <sect1 xml:id="about.formats"> <title>Формати</title> <para> Довідник PHP доступний в декількох форматах. Ці формати можна розділити на дві групи: формати для он-лайн перегляду, та формати для завантаження. </para> <note> <para> Деякі видавництва надають друкований варіант даного довідника. Ми не можемо рекомендувати жоден з них, оскільки вони дуже швидко втрачають актуальність. </para> </note> <para> Довідник можна знайти в он-лайні на сайті <link xlink:href="&url.php;">PHP.net</link>, та на численних сайтах-дзеркалах. Для найліпшої продуктивності оберіть найближче до вас дзеркало. Он-лайн версія довідника PHP наразі має два варіанти <acronym>CSS-стилів</acronym>, один для відображення в інтернет браузері, інший - для друку. </para> <para> Дві найбільших переваги он-лайн довідки над іншими джерелами є наявність <link linkend="about.notes">коментарів користувачів</link> та <link xlink:href="&url.php.urlhowto;">гіперпосилань</link>, які швидко перенаправлять вас до необхідного розділу довідки. Найбільш очевидною вадою такої довідки можна назвати необхідність інтернет з'єднання. </para> <para> Є декілька оф-лайн форматів даної довідки. Вибір найбільш придатного формату залежить від операційної системи та персональних вподобань. Щоб дізнатись, як ми створюємо численні різновиди фоматів довідки, читайте в цьому додатку секцію <link linkend="about.generate">'Як ми створюємо різні формати'</link>. </para> <para> Найбільш крос-платформенним форматом довідки є її HTML-версія. Неважливо, чи це один файл, чи пакет з окремих файлів, яких можна нарахувати декілька тисяч. Ми надаємо ці версії заархівованими, тому вам необхідно мати утиліту для їх розархівування </para> <!-- PDF версія PHP-довідки на даний момент недоступна. Проте колись вона з'явиться. <para> Інший популярний крос-платформенний формат, який є більш придатним для виводу на друк, є PDF (також відомий як формат Adobe Acrobat). Але майте на увазі, що довідка безперервно оновлюється і займає більше 2000 сторінок. </para> <note> <para> Є багато програм для перегляду <acronym>PDF-файлів</acronym>, наприклад <link xlink:href="&url.adobe.acrobat;">Adobe Acrobat Reader</link>. </para> </note> --> <para> Для платформи Windows є версія довідки<productname> Windows HTML Help</productname>, яка адаптує HTML-формат для використання в середовищі <productname> Windows HTML Help</productname>. Ця версія надає можливість повнотекстового пошуку, індексування, та створення закладок. Багато популярних середовищ розробки PHP під Windows також включають в себе цю версію документації, щоб надавти можливість зручного доступу до інформації. Також є доступними CHM-переглядачі для Linux систем. Можете спробувати <link xlink:href="&url.xchm;">xCHM</link> або <link xlink:href="&url.gnochm;">GnoCHM</link>. </para> <para> Існує також <link xlink:href="&url.php.echm;">розширена CHM-версія</link>, яка хоч і рідше оновлюється, але має багато додаткових можливостей. Працює вона тільки під <productname>Microsoft Windows</productname>, оскільки для створення довідок використовуються їхні рідні технології. </para> </sect1> <sect1 xml:id="about.notes"> <title>Про повідомлення користувачів</title> <para> Повідомлення користувачів відіграють важливу роль у розвитку цього довідника. Дозволяючи читачам додавати приклади, попередження, та їхні роз'яснення, ми можемо долучати їхні напрацювання в основний текст довідника. Навіть якщо їхні поради поки що не враховані при написанні довідника, вони тим не менше будуть доступними в он-лайні, та в деяких оф-лайн форматах. </para> <note> <para> Повідомлення користувачів не модеруються перед тим, як вони з'являться в он-лайні, тож якість та достовірність прикладів, кодів та тлумачень не може бути гарантованою. (Зауважте, що сам текст PHP-довідки є абсолютно достовірним.) </para> </note> <note> <para> З метою ліцензування дописів користувачів, вони розглядаються як частина PHP-довідки, і тому підпадають під ті самі умови ліцензування, що і сама документація довідки (на даний час це Creative Commons Attribution). Більше деталей можна знайти на сторінці <link linkend="copyright">Авторські права</link>. </para> </note> </sect1> <sect1 xml:id="about.prototypes"> <title>Як читати оголошення функції (прототип)</title> <para> Кожна функція в довіднику описана таким чином, щоб її було легко зрозуміти. Знаючи, як правильно читати та розуміти написаний текст, вивчати мову PHP буде набагато простіше. Замість того, щоб переглядати чужі приклади, чи просто копіювати-вставляти код, краще навчитись правильно читати оголошення функцій (прототипи). Почнемо: </para> <note> <title> Передумова: базові знання про <link linkend="language.types">типи</link> </title> <para> Хоча PHP є нетипізованою мовою програмування, обов'язковим є базове поняття про<link linkend="language.types">типи</link>, оскільки вони мають важливе значення в програмуванні. </para> </note> <para> Оголошення функції вказує на те, який тип даних вона <link linkend="functions.returning-values">поверне</link>. Давайте розглянемо оголошення функції <function>strlen</function> в якості нашого першого прикладу: </para> <para> <screen role="html"> <![CDATA[ strlen (PHP 4, PHP 5) strlen -- повертає розмір стрічки Опис int strlen ( string $string ) Повертає довжину даної стрічки. ]]> </screen> </para> <para> <table> <title>Пояснення оголошення функції</title> <tgroup cols="2"> <thead> <row> <entry>Частина</entry> <entry>Роз'яснення</entry> </row> </thead> <tbody> <row> <entry> strlen </entry> <entry> Ім'я функції. </entry> </row> <row> <entry> (PHP 4, PHP 5) </entry> <entry> strlen() є присутня у всіх версіях PHP 4 та PHP 5 </entry> </row> <row> <entry> int </entry> <entry> Тип результату, який є цілим числом <type>integer</type> (довжина стрічки вимірюється кількістю літер). </entry> </row> <row> <entry> ( string $string ) </entry> <entry> Перший (і в цьому випадку єдиний) параметр/аргумент для цієї функції, який називається <parameter>string</parameter>, та має стрічковий тип <type>(string)</type>. </entry> </row> </tbody> </tgroup> </table> </para> <para> Ми можемо переписати вищенаведене оголошення функції в загальному вигляді: </para> <para> <screen> <![CDATA[ тип_результату ім'я_функції ( тип_параметру ім'я_параметру ) ]]> </screen> </para> <para> Багато функцій приймають декілька параметрів, як наприклад функція <function>in_array</function>. Ось її прототип: </para> <para> <screen> <![CDATA[ bool in_array ( mixed $needle, array $haystack [, bool $strict]) ]]> </screen> </para> <para> Як інтерпретувати цей запис? in_array() повертає значення логічного типу <link linkend="language.types.boolean">(boolean)</link>, &true; якщо операція закінчилась успішно (якщо параметр <parameter>needle</parameter> знайдено в <parameter>haystack</parameter>), або &return.falseforfailure; (якщо <parameter>needle</parameter> не знайдено в <parameter>haystack</parameter>). Перший параметр має назву <parameter>needle</parameter> і він може належати до різнх <link linkend="language.types">типів</link> даних, тому його тип позначено як "<emphasis>mixed</emphasis>" ("змішаний, невизначений"). Параметр <parameter>needle</parameter> (який ми шукаємо) може бути або скаляром (стрічкою, цілим, чи <link linkend="language.types.float">дробовим</link> числом), або <link linkend="language.types.array">масивом</link>. Другим параметром є <parameter>haystack</parameter> (масив, в якому здійснюємо пошук). Третій <emphasis>необов'язковий</emphasis> параметр називається <parameter>strict</parameter>. Всі необов'язкові параметри знаходяться в <emphasis>[</emphasis> квадратних дужках <emphasis>]</emphasis>. Згідно цього довідника, параметр <parameter>strict</parameter> по замовчуванню має логічне значення &false;. Дивіться відповідні розділи довідки, щоб знати як працює потрібна вам функція. </para> <para> Є також функції з більш складною інформацією щодо підтримуваної версії PHP. До прикладу, функція <function>html_entity_decode</function>: </para> <para> <screen> <![CDATA[ (PHP 4 >= 4.3.0, PHP 5) ]]> </screen> </para> <para> Це значить, що дана функція є доступною тільки починаючи із версії PHP 4.3.0. </para> </sect1> <sect1 xml:id="about.phpversions"> <title>Версії PHP, задокументовані в даному довіднику</title> <para> <!-- FIXME PHP_6 What is the latest? --> Довідник містить інформацію про минулу, поточну та майбутню версії PHP. Внесені зміни відображені у вигляді зауважень, журналу змін та звичайного тексту в контексті довідника. Найстаріша задокументована версія це PHP 4.1.0, а найновіша - PHP 5.x.x. </para> <para> Якщо в документації йдеться про версію PHP, яка ще знаходиться в стані розробки, то її буде відзначено як "доступна в Git", або "версія в розробці." Оскільки ці нововведення є вже запланованими, то дуже рідко вони можуть бути змінені. </para> <para> Всі етапи розробки нових версій PHP знаходяться в Git. Якщо бажаєте з ними ознайомитись, пррочитайте сторінку <link xlink:href="&url.php.anongit;">'Анонімний доступ до Git'</link>. Ці самі коди можна завантажити зі сховища джерельних кодів мови PHP, що перебувають в процесі розробки <link xlink:href="&url.php.snapshots;">PHP snapshots</link>, і які є доступними для кожної активної версії PHP. </para> <para> Для більшої чіткості, довідка буде вказувати на версії, підверсії та виправлення PHP-релізів. Наприклад, запис PHP <literal>5.3.1</literal>, вказує на версію <emphasis>5</emphasis>, підверсію <emphasis>3</emphasis>, та виправлення <emphasis>1</emphasis>. В основному, розробники додають нові можливості до версій та підверсій, та виправляють помилки у версіях-виправленнях. Проте цей підхід іноді порушується. </para> <para> Також зазначте, що граматично довідка написана в теперішньому часі, а не в майбутньому, навіть коли йдеться про можливості, які ще не доступні. Причиною є те, що таким чином довідка буде залишатись достовірною довший період час, не вимагаючи значних граматичних виправлень із виходом кожної нової версії PHP. </para> <para> Дуже часто дана довідка надає список "Значень по-замовчуванню" для директив PHP. Ці значення вказують на поведінку PHP, якщо не використовується конфігураційний файл &php.ini; . Тому ці значення можуть різнитися від значень у розповсюджуваних конфігураційних файлах, таких як <filename>php.ini-development</filename> та <filename>php.ini-production.</filename> Також вони стосуються останньої версії PHP, проте список змін містить згадку про попередні значення змінних. Перегляньте додаток <link linkend="ini.list">Директиви PHP</link>, задля ознайомлення з цими значеннями та внесеними змінами. </para> </sect1> <sect1 xml:id="about.more"> <title>Як знайти більше інформації про PHP?</title> <para> Дана довідка не намагається надати інформацію про загальну практику програмування. Програмістам-початківцям може бути складно зрозуміти, як програмувати в PHP, використовуючи виключно цю довідку. Для цього вартує пошукати спеціальну літературу, орієнтовану на початківців. </para> <para> Існує кілька активних груп листування, де обговорюються всі аспекти програмування в PHP. Якщо маєте певну проблему, зверніться до однієї з цих груп. З видами технічної підтримки, включаючи групи листування, можна ознайомитись на сторінці <link xlink:href="&url.php.support;">Технічна підтримка PHP.net</link>. Крім того, на сторінці <link xlink:href="&url.php.links;">Посилання PHP.net</link> є список сайтів, присвячених розробці на PHP, форумів, та галерей коду. </para> </sect1> <sect1 xml:id="about.howtohelp"> <title>Як допомогти покращити довідку?</title> <para> Є три шляхи, як кожен бажаючий може взяти участь у покращенні цієї довідки. </para> <para> Якщо ви знайшли помилку в довідці, в будь-якому з її перекладів, будь-ласка, повідомте про це на сторінці <link xlink:href="&url.php.bugs;">&url.php.bugs;</link>. Класифікуйте помилку як <literal>"Documentation Problem"</literal>. Про всі помилки в документації, включно з помилками самого формату довідки, потрібно повідомляти як про звичайні баги. </para> <note> <para> Будь-ласка, не використовуйте систему повідомлень про баги, щоб просити про допомогу. Для цього краще використати одну з опцій <link xlink:href="&url.php.support;">технічної підтримки</link>. </para> </note> <para> Залишаючи повідомлення, користувачі можуть надавати додаткові приклади, застереження, та роз'яснення для інших читачів. Але не потрібно писати повідомлення про баги, використовуючи систему повідомлень. За більш детальною інформацією звернітьтся до розділу<link linkend="about.notes">'Повідомлення користувачів'</link>. </para> <para> PHP довідник перекладено на багато мов. Знання англійської та якоїсь іншої мови, це ще один метод допомогти покращити довідник PHP, оскільки ви можете співпрацювати із групою перекладачів. Про те, як розпочати новий переклад, чи допомогти вже перекладеній версії, ви можете прочитати на сторінці <link xlink:href="&url.php.dochowto;">&url.php.dochowto;</link>. </para> <para> Проект PHP-документації також має IRC-канал, де спілкується багато авторів цієї довідки. Завітайте на <literal>#php.doc</literal> за адресою <literal>irc.efnet.org</literal> та обговоріть можливості покращення PHP-документації. </para> </sect1> <sect1 xml:id="about.generate"> <title>Як ми створюємо різні формати</title> <para> Даний довідник створено в форматі <acronym>XML</acronym>, використовуючи <link xlink:href="&url.docbook.xml;">DocBook XML DTD</link> та <link xlink:href="&url.phd;"><acronym>PhD</acronym></link> ([D]ocBook оглядач на базі [PH]P) для підтримки та форматування. </para> <para> Використання <acronym>XML</acronym> як базового формату дає можливість генерувати інші формати на базі вихідного XML-файлу, натомість підтримувати потрібно тільки один вихідний, базовий формат. Для форматування он-лайн довідки використовується<link xlink:href="&url.phd;">PhD</link>. Ми використовуємо <link xlink:href="&url.winhelp;">Microsoft HTML Help Workshop</link> для генерування формату довідки<productname>Windows HTML Help</productname>, та звичайно сам PHP для реалізації додаткових конвертування та форматування. </para> <para> Довідник PHP доступний в різних форматах та мовах. Детальніше про це на сторінці <link xlink:href="&url.php.docs;">&url.php.docs;</link>. Джерельний код <acronym>XML</acronym> може бути завантажений з SVN та переглянутийна <link xlink:href="&url.php.svn;">&url.php.svn;</link>. Документація збережена в модулі <literal>phpdoc</literal>. </para> </sect1> <sect1 xml:id="about.translations"> <title>Переклади</title> <para> Довідник з PHP доступний не тільки в багатьох форматах, але також і на багатьох мовах. Базовий текст довідника написано англійською мовою, потім команди добровольців з усього світу займаються його перекладом на свої рідні мови. Якщо для певної функції чи розділу ще не існує перекладу, то система довідника відобразить ці частини англійською мовою. </para> <para> Люди, що займаються перекладом, починають опрацьовувати базовий код <acronym>XML</acronym> доступний на <link xlink:href="&url.php.svn;">&url.php.svn;</link>, на основі якого вони створюють довідку. Вони <emphasis>не використовують</emphasis> згенеровані версії (як наприклад <acronym>HTML</acronym> чи звичайний текст), тому що цим займеться система створення довідок, яка перетворить формат <acronym>XML</acronym> у формати, зручні для читання. </para> <note> <para> Щоб допомогти в перекладі документації, зв'яжіться з відповідною групою перекладачів, вступивши до групи листування phpdoc: відправте пустий е-мейл на адресу <link xlink:href="mailto: &email.php.doc.subscribe;">&email.php.doc.subscribe;</link>. Адреса групи листування наступна: <literal>&email.php.doc;</literal>. Зазначте в листі, що ви зацікавлені в перекладі довідника, і хтось вам відповість, уточнивши, що потрібно робити на початку шляху, або зв'язавши вас із існуючою командою перекладачів. </para> </note> <para> На даний момент, довідник доступний повністю, або частково, на більше наж 10 мовах. </para> <para> Всі вони можуть бути завантажені тут: <link xlink:href="&url.php.docs;">&url.php.docs;</link>. </para> </sect1> </appendix> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
