cvs: phpdoc /en/appendices about.xml wrappers.xml
| From: | Joseph Drake | Date: | Fri, 27 Dec 2002 01:40:20 +0000 |
| Subject: | cvs: phpdoc /en/appendices about.xml wrappers.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969350417@lists.php.net to get a copy of this message | ||
joseph Thu Dec 26 20:40:20 2002 EDT
Modified files:
/phpdoc/en/appendices wrappers.xml about.xml
Log:
updated
Index: phpdoc/en/appendices/wrappers.xml diff -u phpdoc/en/appendices/wrappers.xml:1.8 phpdoc/en/appendices/wrappers.xml:1.9 --- phpdoc/en/appendices/wrappers.xml:1.8 Thu Oct 31 20:32:37 2002 +++ phpdoc/en/appendices/wrappers.xml Thu Dec 26 20:40:20 2002 @@ -1,19 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.8 Maintainer: joseph Status: ready --> <appendix id="wrappers"> - <title>List of Supported Protocols/Wrappers</title> + <title>Zoznam Podporovaných Protokolov/Balíèkov</title> <para> - The following is a list of the various URL style protocols that - PHP has built-in for use with the filesystem functions such as - <function>fopen</function> and <function>copy</function>. - In addition to these wrappers, as of PHP 4.3, you can write - your own wrappers using PHP script and + Následujúce je zoznam rôznych ¹týlových protokolov URL, ktoré + má PHP vstavané pre pou¾itie s filesystem funkciami ako sú + <function>fopen</function> a <function>copy</function>. + Okrem týchto balíèkov (wrappers), ako aj tých v PHP 4.3, si + mô¾te napísa» svoje vlastné balíèky s pou¾itím PHP skriptu a <function>stream_register_wrapper</function>. </para> <section id="wrappers.http"> - <title>HTTP and HTTPS</title> - <simpara>PHP 3, PHP 4. <filename>https://</filename> since PHP 4.3</simpara> + <title>HTTP a HTTPS</title> + <simpara>PHP 3, PHP 4. <filename>https://</filename> od PHP 4.3</simpara> <itemizedlist> <listitem><simpara><filename>http://example.com</filename></simpara></listitem> @@ -22,39 +22,38 @@ <listitem><simpara><filename>https://user:password@example.com</filename></simpara></listitem> </itemizedlist> - <simpara>Allows read-only access to files/resources via HTTP 1.0, - using the HTTP GET method. A <literal>Host:</literal> header is sent with the request - to handle name-based virtual hosts. If you have configured - a <link linkend="ini.user-agent">user_agent</link> string using - your ini file or the stream context, it will also be included - in the request. - </simpara> - <simpara> - Redirects have been supported since PHP 4.0.5; if you are using - an earlier version you will need to include trailing slashes in - your URLs. - </simpara> - <simpara> - The stream allows access to the <emphasis>body</emphasis> of - the resource; the headers are stored in the - <varname>$http_response_header</varname> variable. - Since PHP 4.3, the headers are available using + <simpara>Umo¾òuje prístup iba na èítanie k súborom/zdrojom cez HTTP 1.0 + pou¾itím metódy HTTP GET. Hlavièka <literal>Host:</literal> sa po¹le + s po¾iadavkou na zaistenie na mene zalo¾ených virtuálnych hostov. Ak + ste nakonfigurovali re»azec <link linkend="ini.user-agent">user_agent</link> + pou¾itím vá¹ho ini súboru alebo prúdového kontextu, taktie¾ sa zahrnie + do po¾iadavky. + </simpara> + <simpara> + Uz PHP 4.0.5 podporuje presmerovania; ak pou¾ívate predchádzajúce + verzie, budete musie» zahrnú» vleèné lomítka do svojich URL adries. + </simpara> + <simpara> + Prúd umo¾òuje prístup k <emphasis>telu</emphasis> + zdroja; hlavièky sú ulo¾ené v premennej + <varname>$http_response_header</varname>. + Od PHP 4.3, hlavièky sú dostupné pou¾itím <function>stream_get_meta_data</function>. </simpara> <simpara> - HTTP connections are read-only; you cannot write data or copy - files to an HTTP resource. + Pripojenia cez HTTP sú iba na èítanie; nemô¾ete zapisova» dáta + alebo kopírova» súbory do HTTP zdroja. </simpara> <note> - <simpara>HTTPS is supported starting from PHP 4.3, if you - have compiled in support for OpenSSL. + <simpara>HTTPS podporovalo u¾ PHP 4.3, ak ste + kompilovali s podporou pre OpenSSL. </simpara> </note> </section> <section id="wrappers.ftp"> - <title>FTP and FTPS</title> - <simpara>PHP 3, PHP 4. <filename>ftps://</filename> since PHP 4.3</simpara> + <title>FTP a FTPS</title> + <simpara>PHP 3, PHP 4. <filename>ftps://</filename> od PHP 4.3</simpara> <itemizedlist> <listitem><simpara><filename>ftp://example.com/pub/file.txt</filename></simpara></listitem> @@ -64,37 +63,37 @@ </itemizedlist> <simpara> - Allows read access to existing files and creation of new files - via FTP. If the server does not support passive mode ftp, the - connection will fail. - </simpara> - <simpara> - You can open files for either reading or writing, but not both - simultaneously. If the remote file already exists on the ftp - server and you attempt to open it for writing, the connection - will fail. If you need to update existing files over ftp, - use <function>ftp_connect</function>. - </simpara> - <simpara> - <filename>ftps://</filename> was introduced in PHP 4.3. - It is the same as <filename>ftp://</filename>, - but attempts to negotiate a secure connection with the ftp server. - If the server does not support SSL, then the connection falls back - to regular unencrypted ftp. + Umo¾òuje prístup na èítanie k existujúcim súborom a tvorbu + nových cez FTP. Ak server nepodporuje pasívny mód ftp, spojenie + zlyhá. + </simpara> + <simpara> + Mô¾te otvára» súbory buï na èítanie alebo zápis, ale nie oboje + zároveò. Ak u¾ vzdialený súbor existuje na ftp serveri + a pokú¹ate sa ho otvori» na zapisovanie, spojenie zlyhá. Ak + potrebujete obnovi» existujúci súbor cez ftp, pou¾ite + <function>ftp_connect</function>. + </simpara> + <simpara> + <filename>ftps://</filename> bol predstavený v PHP 4.3. + Je to rovnaké ako s <filename>ftp://</filename>, + ale pokú¹a sa vyhµada» bezpeèné spojenie s ftp serverom. Ak server + nepodporuje SSL, potom sa spojenie navráti k regulérnemu + kryptovanému ftp. </simpara> <note> - <simpara>FTPS is supported starting from PHP 4.3, if you - have compiled in support for OpenSSL. + <simpara>FTPS podporovalo u¾ PHP 4.3, ak ste + kompilovali s podporou pre OpenSSL. </simpara> </note> </section> <section id="wrappers.php"> - <title>PHP input/output streams</title> + <title>Vstupné/Výstupné prúdy PHP</title> <simpara> - PHP 3.0.13 and up, <filename>php://output</filename> - and <filename>php://input</filename> since PHP 4.3 + PHP 3.0.13 a vy¹¹ie, <filename>php://output</filename> + a <filename>php://input</filename> poèínajúc PHP 4.3 </simpara> <itemizedlist> @@ -107,33 +106,33 @@ <simpara> <filename>php://stdin</filename>, <filename>php://stdout</filename> - and <filename>php://stderr</filename> allow access to - the corresponding input or output stream of the PHP process. + a <filename>php://stderr</filename> umo¾òujú prístup ku + kore¹pondujúcemu vstupnému alebo výstupnému prúdu PHP procesu. </simpara> <simpara> - <filename>php://output</filename> allows you to write to the - output buffer mechanism in the same way as - <function>print</function> and <function>echo</function>. + <filename>php://output</filename> umo¾òuje zápis do výstupného + mechanizmu zásobníka rovnakým spôsobom ako + <function>print</function> a <function>echo</function>. </simpara> <simpara> - <filename>php://input</filename> allows you to read raw POST data. - It is a less memory intensive alternative to - <varname>$HTTP_RAW_POST_DATA</varname> and does not need any - special &php.ini; directives. + <filename>php://input</filename> umo¾òuje èítanie prvotné POST dáta. + Je to menej pamä» za»a¾ujúca alternatíva k + <varname>$HTTP_RAW_POST_DATA</varname> a nepotrebuje ¾iadne + ¹peciálne &php.ini; direktívy. </simpara> <simpara> - <filename>php://stdin</filename> and - <filename>php://input</filename> are read-only, whereas + <filename>php://stdin</filename> a + <filename>php://input</filename> sú iba na èítanie, zatiaµèo <filename>php://stdout</filename>, - <filename>php://stderr</filename> and - <filename>php://output</filename> are write-only. + <filename>php://stderr</filename> a + <filename>php://output</filename> sú iba na zápis. </simpara> </section> <section id="wrappers.compression"> - <title>Compression Streams</title> - <simpara><filename>zlib:</filename> PHP 4.0.4 - PHP 4.2.3 (systems with fopencookie only)</simpara> - <simpara><filename>compress.zlib://</filename> and <filename>compress.bzip2://</filename> PHP 4.3 and up</simpara> + <title>Prúdy Kompresie</title> + <simpara><filename>zlib:</filename> PHP 4.0.4 - PHP 4.2.3 (iba systémy s fopencookie)</simpara> + <simpara><filename>compress.zlib://</filename> a <filename>compress.bzip2://</filename> PHP 4.3 a vy¹¹ie</simpara> <itemizedlist> <listitem><simpara><filename>zlib:</filename></simpara></listitem> @@ -142,18 +141,18 @@ </itemizedlist> <simpara> - <filename>zlib:</filename> works like <function>gzopen</function>, except that the - stream can be used with <function>fread</function> and the other - filesystem functions. This is deprecated as of PHP 4.3 due - to ambiguities with filenames containing ':' characters; use - <filename>compress.zlib://</filename> instead. + <filename>zlib:</filename> pracuje ako <function>gzopen</function>, a¾ na to, ¾e + prúd sa dá pou¾i» s <function>fread</function> a inými + filesystem funkciami. Nie je to schvaµované ako to nie je aj v PHP 4.3 + kvôli nejednoznaènosti s názvami súborov obsahujúcich znaky ':'; rad¹ej + pou¾ívajte <filename>compress.zlib://</filename>. </simpara> <simpara> - <filename>compress.zlib://</filename> and - <filename>compress.bzip2://</filename> are equivalent to - <function>gzopen</function> and <function>bzopen</function> - respectively, and operate even on systems that do not support + <filename>compress.zlib://</filename> a + <filename>compress.bzip2://</filename> sú ekvivalentné k + <function>gzopen</function> a <function>bzopen</function> + jednotlivo a fungujú dokonca aj na systémoch, ktoré nepodporujú fopencookie. </simpara> </section> Index: phpdoc/en/appendices/about.xml diff -u phpdoc/en/appendices/about.xml:1.19 phpdoc/en/appendices/about.xml:1.20 --- phpdoc/en/appendices/about.xml:1.19 Sun Oct 27 07:31:14 2002 +++ phpdoc/en/appendices/about.xml Thu Dec 26 20:40:20 2002 @@ -1,161 +1,158 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<?xml version="1.0" encoding="iso-8859-2"?> +<!--EN-Revision: 1.19 Maintainer: joseph Status: ready --> <!-- TODO: add manual conventions section (eg. how to read function usage parts, what is fixed width, what is - bold, what is linked + bold, what is linked) add some tips about combining the versions (online- offline), and using "http://anymirror.php.net/funcname" --> <appendix id="about"> - <title>About the manual</title> + <title>O manuále</title> <sect1 id="about.formats"> - <title>Formats</title> + <title>Formáty</title> <para> - The PHP manual is provided in several formats. These formats can be divided - into two groups: online readable formats, and downloadable packages. + PHP manuál sa poskytuje v niekoµkých formátoch. Tieto formáty sa delia + na dve skupiny: online èitateµné formáty a stiahnuteµné balíky. </para> <note> <para> - Some publishers have made available printed versions of this manual. We - cannot recommend any of those, as they tend to become out-of-date very - quickly. + Niektorí vydávatelia uviedli tlaèené verzie tohto manuálu. Nemô¾eme + doporuèi» ¾iaden z nich, nakoµko sú zakrátko zastaralé. </para> </note> <para> - You can read the manual online at <ulink url="&url.php;">&url.php;</ulink> - and on the numerous mirror sites. For best performance, you should choose - the mirror site closest to you. 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. + Manuál si mô¾ete preèíta» online na <ulink url="&url.php;">&url.php;</ulink> + a na poèetných mirrorovaných stránkach. Pre najlep¹iu èinnos» by ste si mali + zvoli» mirrorovanú stránku najbli¾¹ie k vám. Manuál si mô¾ete prezera» buï + v jednoduchom (vhodnom pre tlaè) HTML formáte alebo v HTML formáte, ktorý + integruje manuál do podoby samotnej webovskej stránky PHP. </para> <para> - An advantage of the online manual over most of the offline formats is the - integration of <link linkend="about.notes">user-contributed - notes</link>. An obvious disadvantage is that you have to be online to view - the manual in the online formats. + Výhodou online manuálu oproti väè¹ine offline formátom je integrácia + <link linkend="about.notes">príspevkov u¾ivateµov</link>. Zrejmou + nevýhodou je, ¾e musíte by» online, aby ste si mohli prezera» manuál + v online formátoch. </para> <para> - 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. For information on how the manual is generated in so many - formats, read the <link linkend="about.generate">'How we generate the - formats'</link> section of this appendix. + Existuje niekoµko offline formátov manuálu a fakt, ktorý formát je pre vás + najvhodnej¹í, závisí na operaènom systéme, ktorý pou¾ívate a osobnom + spôsobe èítania. Ak chcete vedie» ako sa tento manuál generuje do mnohých + formátov, preèítajte si sekciu <link linkend="about.generate">'Ako generujeme formáty'</link> v tejto prílohe. </para> <para> - The most cross-platform formats of the manual are the HTML and plain-text - versions. 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). The HTML and plaintext formats are - provided as tar files compressed using the bzip2 archiver. + Najvhodnej¹ími multi-platformovými formátmi manuálu sú verzie HTML + a prostý-text. Formát HTML sa poskytuje ako jednoduchý HTML súbor ako aj + balík individuálnych súborov pre ka¾dú sekciu (ktorá pozostáva zo zväzku + niekoµko tisíc súborov). Formáty HTML a prostý-text sa poskytujú ako tar + súbory komprimované programom bzip2. </para> <para> - Another popular cross-platform format, and the format most suited to - printing, is PDF (also known as Adobe Acrobat). 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. + Ïal¹ím obµúbeným multi-platformovým formátom, ktorý je najvhodnej¹í pre + tlaè, je PDF (tie¾ známy ako Adobe Acrobat). Ale ne¾ sa pustíte do + s»ahovania tohto formátu a jeho tlaèe, majte na pamäti, ¾e manuál má + 2000 strán a ¾e sa neustále upravuje. </para> <note> <para> - If you do not already have a program capable of viewing PDF format - files, you may need to download <ulink url="&url.adobe.acrobat;">Adobe + Ak e¹te nemáte program schopný prezerania súborov formátu PDF, mo¾ete + si stiahnú» <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. </para> </note> <para> - For owners of Palm-compatible handhelds, the Palm document and iSilo - formats are ideal for this platform. You can bring your handheld with you - on your daily commute and use a <ulink url="&url.palm.doc;">DOC</ulink> - or <ulink url="&url.palm.isilo;">iSilo</ulink> reader to brush up on your - PHP knowledge, or just use it as a quick reference. + Pre vlastníkov handheldov kompaktibilných s Palm sú ideálne formáty + Palm dokument a iSilo. Mô¾ete si svoj handheld nosi» denne so sebou + a pou¾íva» <ulink url="&url.palm.doc;">DOC</ulink> alebo + <ulink url="&url.palm.isilo;">iSilo</ulink> reader, aby ste si + zdokonalili svoje PHP vedomosti, alebo ho len pou¾íva» ako príruèku. </para> <para> - For Windows platforms, the Windows HTML Help version of the manual soups up - the HTML format for use with the Windows HTML Help application. This - version provides full-text search, a full index, and bookmarking. Many - popular Windows PHP development environments also integrate with this - version of the documentation to provide easy access. + Pre platformy Windows, verzia manuálu Windows HTML Help umo¾òuje + pou¾itie HTML formátu vo Windows HTML Help aplikáciach. Táto verzia + poskytuje full-textové vyhµadávanie, plný index, a oznaènie zará¾ok + (bookmarking). Mnoho známych vývojových prostredí pre Windows tie¾ + zahàòa túto verziu dokumentácie pre jednoduchý prístup.. </para> <!-- mmmm, this project seems to be dead. Any news? <note> <para> - A Visual Basic for Linux project is in the planning stage, which will - include the development of a CHM Creator and Viewer for Linux. See their - <ulink url="&url.vb4linux;">SourceForge.net page</ulink> if you are - interested in the progress. + Projekt Visual Basic pre Linux je plánovaná fáza, ktorá bude zahàòa» + vývoj CHM Creator and Wiewer pre Linux. Pozrite si ich na + <ulink url="&url.vb4linux;">stránke SourceForge.net</ulink>, ak sa + zaujímate o priebeh. </para> </note> --> </sect1> <sect1 id="about.notes"> - <title>About user notes</title> + <title>O príspevkoch u¾ívateµov</title> <para> - The user-contributed notes play an important role in the development of - this manual. 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. And until the - notes have been incorporated, they can be viewed in their submitted form - online and in some of the offline formats. + Príspevky u¾ivateµov zohrávajú dôle¾itú úlohu vo vývoji tohto manuálu. + Tým, ¾e umo¾níme èitateµom manuálu prispevanie príkladov, rád a + ïal¹ích objasnení z ich prehliadaèa, ich mô¾eme zaèleni» do hlavného + textu manuálu. Kým sa príspevky zaèlenia, dajú sa prezera» vo svojej + predlo¾enej forme online a v niektorých offline formátoch. </para> <note> <para> - 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.) + Príspevky u¾ívateµov, pred tým ne¾ sa uverejnia online, nie sú upravované, + tak¾e kvalita zápisu alebo príkladov kódu, a dokonca ani správnos» + príspevku sa nedajú zaruèi». (Taktie¾ nie je záruka kvality a presnosti + samotného textu manuálu.) </para> </note> </sect1> - + <sect1 id="about.prototypes"> - <title>How to read a function definition (prototype)</title> + <title>Ako èíta» definíciu funkicie (prototyp)</title> <para> - Each function is documented for quick reference, knowing how - to read and understand the manual will make using PHP - much easier. Rather than relying on examples or cut/paste, you want - to know how to read function definitions (prototypes). Let's begin: + Ka¾dá funkcia je zdokumentovaná v informaènej príruèke; znalos», + ako sa má manuál èíta» a rozumie», pou¾ívanie PHP znaène + ulah¹í. Namiesto odvolávania sa na príklady alebo vystrihnú»/vlo¾i», + chcete rad¹ej vedie» ako èíta» definície funkcií (prototypy). Zaènime: </para> <note> <title> - Prerequisite: Basic understanding of <link linkend="language.types">types</link> + Nevyhnutná podmienka: Základná interpretácia <link linkend="language.types">typov</link> </title> <para> - Although PHP is a loosly typed language, it's important to have - a basic understanding of <link linkend="language.types">types</link> as - they have important meaning. + I keï PHP je len poµahky typovým jazykom, je dôle¾ité ma» základné + vedomosti o <link linkend="language.types">typoch</link>, preto¾e + majú dôle¾itý význam. </para> </note> <para> - Function definitions tell us what - type of value is <link linkend="functions.returning-values">returned</link>, - let's use the definition for <function>strlen</function> as our first example: + Definície funkcií nám hovoria aký + typ hodnoty je <link linkend="functions.returning-values">navrátený</link>, + pou¾ijeme definíciu pre <function>strlen</function>, ako ná¹ prvý príklad: </para> <para> <screen role="html"> strlen (PHP 3, PHP 4 >= 4.0.0) -strlen -- Get string length +strlen -- Urèí då¾ku reta¾ca -Description +Popis int strlen ( string str ) -Returns the length of string. +Vráti då¾ku re»azca. </screen> </para> <para> <table> - <title>Explanation of a function definition</title> + <title>Vysvetlenie funkènej definície<title> <tgroup cols="2"> <thead> <row> - <entry>Part</entry> - <entry>Description</entry> + <entry>Èas»</entry> + <entry>Popis</entry> </row> </thead> <tbody> @@ -164,7 +161,7 @@ strlen </entry> <entry> - The function name. + Názov funkcie. </entry> </row> <row> @@ -172,7 +169,7 @@ (PHP 3, PHP 4 >= 4.0.0) </entry> <entry> - strlen() has been around in both all of PHP 3 and PHP 4 + strlen() bol k dispozícii v ochoch PHP 3 a PHP 4 </entry> </row> <row> @@ -180,9 +177,9 @@ int </entry> <entry> - Type of value this function returns, which is an + Typ hodnoty, ktorú táto funkcia vracia, èo je <link linkend="language.types.integer">integer</link> - (i.e. The length of a string is measured in numbers). + (t.j. Då¾ka re»azca sa udáva v èíslach). </entry> </row> <row> @@ -190,9 +187,9 @@ ( string str ) </entry> <entry> - The first (and in this case the only) parameter/argument for the - function strlen() is named <parameter>str</parameter>, and it's a - <link linkend="language.types.string">string</link>. + Prvý (a v tomto prípade jediný) parameter/argument pre + funkciu strlen() sa nazýva <parameter>str</parameter> a je to + <link linkend="language.types.string">re»azec</link>. </entry> </row> </tbody> @@ -200,207 +197,204 @@ </table> </para> <para> - We could rewrite the above function definition in a generic way: + Definíciu horeuvedenej funkcie by sme mohli prepísa» do v¹eobecného tvaru: </para> <para> <screen role="html"> - returned type function name ( parameter type parameter name ) + vrátený typ názov funkcie ( typ parametra názov parametra ) </screen> </para> <para> - Many functions take on multiple parameters, such as <function>in_array</function>. - It's prototype is as follows: + Mnoho funkcií má viacero parametrov, ako má napr. <function>in_array</function>. + Jeho prototyp vyzerá následovne: </para> <para> <screen role="html"> - bool in_array ( mixed needle, array haystack [, bool strict]) + bool in_array ( zmie¹aná ihla, array stoh_sena [, bool striktne]) </screen> </para> <para> - What does this mean? in_array() returns a - <link linkend="language.types.boolean">boolean</link> value, &true; on - success (the <parameter>needle</parameter> was found in the - <parameter>haystack</parameter>) or &false; on failure (the - <parameter>needle</parameter> was not found in the - <parameter>haystack</parameter>). The first parameter is named - <parameter>needle</parameter> and it can be many different - <link linkend="language.types">types</link>, so we call it - "<emphasis>mixed</emphasis>". This mixed <parameter>needle</parameter> - (what we're looking for) can either be a scalar value (string, integer, - or <link linkend="language.types.float">float</link>), or an - <link linkend="language.types.array">array</link>. - <parameter>haystack</parameter> (the array we're searching in) is the - second parameter. The third <emphasis>optional</emphasis> parameter is - named <parameter>strict</parameter>. All optional parameters are seen - in <emphasis>[</emphasis> brackets <emphasis>]</emphasis>. The manual - states that the <parameter>strict</parameter> parameter defaults to - boolean &false;. See the manual page on each function for details on - how they work. + Èo to vlastne znamená? in_array() vracia hodnotu + <link linkend="language.types.boolean">boolean</link>, &true; ak je + prevdivý (<parameter>ihla</parameter> bola nájdená v + <parameter>stoh_sena</parameter>) alebo &false; pri chybe ( + <parameter>ihla</parameter> sa nena¹la v + <parameter>stoh_sena</parameter>). Prvý parameter je pomenovaný + <parameter>ihla</parameter> a mô¾e by» viacerých + <link linkend="language.types">typov</link>, tak¾e sme ho nazvali + "<emphasis>zmie¹aná</emphasis>". Táto zmie¹aná <parameter>ihla</parameter> + (ktorú hµadáme) mo¾e by» buï skalárna hodnota (string, integer, + alebo <link linkend="language.types.float">float</link>) alebo + <link linkend="language.types.array">pole</link>. + <parameter>stoh_sena</parameter> (pole, v ktorom hµadáme) je + druhý parameter. Tretí <emphasis>voliteµný</emphasis> parameter je + pomenovaný <parameter>striktne</parameter>. V¹etky voliteµné parametre sú uzavreté + do <emphasis>[</emphasis> zátvoriek <emphasis>]</emphasis>. Manuál + ukladá, ¾e parameter <parameter>striktne</parameter> je ¹tandardne + nastevený na boolean &false;. Pozri manuálovú stránku pre ka¾dú + funkciu a ako fungujú. </para> </sect1> <sect1 id="about.phpversions"> - <title>PHP versions documented in this manual</title> + <title>Verzie PHP zdokumentované v tomot manuále</title> <para> - This documentation contains information about PHP 4, with some added - migration and compatibility notes regarding PHP 3. Behaviour, - parameter, return value and other changes between different PHP - versions are documented in notes and inline text in the manual. - </para> - <para> - You may find documentation pieces for the CVS version of PHP, which - always means the very latest development version available through - the CVS version handling system. If you are not a developer of PHP - itself, and you are not keen on using the very latest development - version of PHP, features marked with the "available in CVS" wording - are not accessible to you. Though these features will probably be - available in the next stable version of PHP. If you would like to - download the CVS version, see the <ulink url="&url.php.anoncvs;">anonymous - CVS access page</ulink>. - </para> - <para> - You may also encounter documentation for a PHP version which is - not released (something like PHP 4.3.0 as the latest stable version - is 4.2.3). Most of the time, this is not an error in the documentation. - Explanation is often added for features not available in the current - PHP release, but will be available in a known future PHP version. + Táto dokumentácia obsahuje informácie o PHP 4, s niektorými pridanými + migráciami a poznámkami ku kompatibilite s PHP 3. Správanie, + parameter, navrátenie hodnoty a iné zmeny medzi rôznymi verziami + PHP sú zdokumentované v poznámkach a v medziriadkovom texte v manuále. + </para> + <para> + Mô¾te nájs» dokumentaèné kúsky pre CVS verziu PHP, ktorá v¾dy + predstavuje najnov¹ie vyvíjanú verziu dostupnú cez systém CVS. Ak + nie ste vývojárom PHP samotného a nie ste nad¹ený pou¾ívaním + najnov¹ie vyvíjanej verzie PHP, rubriky oznaèené "available in CVS" + (dostupné v CVS) nie sú pre vás dostupné. I keï tieto rubriky budú + prevdepodobne dostupné v dal¹ej samostatnej verzii PHP. Ak by ste + si chceli stiahnu» CVS verziu, pozri <ulink url="&url.php.anoncvs;">anonymná prístupná CVS stránka</ulink>. + </para> + <para> + Taktie¾ mô¾te narazi» na dokumentáciu pre PHP verziu, ktorá e¹te + nie je uvoµnená (nieèo ako PHP 4.3.0, preto¾e najnov¹ia samostatná + verzia je 4.2.3). Väè¹inou toto nepredstavuje chybu v dokumtácii. + Vysvetlenie sa èasto pridáva k rubrikám, ktoré nie sú dostupné v + aktuálnom PHP vydaní, ale budú dostupné v známej budúcej PHP verzií. </para> </sect1> - + <sect1 id="about.more"> - <title>How to find more information about PHP</title> + <title>Ako nájs» viac informácii o PHP</title> <para> - This manual does not attempt to provide instruction about general - programming practices. 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. You may want to seek out a text more oriented towards - beginners. You can find a list of PHP-related books at <ulink + Tento manuál sa nesna¾í poskytova» in¹trukcie o v¹eobecných programovacích + praktikách. Ak ste len zaèínajúcim programátorom, mô¾e sa vám zda» zlo¾ité + nauèi» sa programova» v PHP len za pomoci tohto manuálu. Mô¾ete si + vyhµada» texty, ktoré sú viac orientované pre zaèiatoèníkov. Zoznam + kníh súvisiacich s PHP mô¾ete nájs» na <ulink url="&url.php.books;">&url.php.books;</ulink>. </para> <para> - There are a number of active mailing lists for discussion of all aspects of - programming with PHP. 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. You can find a list of the mailing lists at <ulink - url="&url.php.support;">&url.php.support;</ulink>, as well as links to the - mailing list archives and other online support resources. Furthermore, at - <ulink url="&url.php.links;">&url.php.links;</ulink> there is a list of - websites devoted to PHP articles, forums, and code galleries. + Existuje mno¾stvo aktívnych mailing listov urèených pre diskusie o v¹etkých + aspektoch programovania v PHP. Ak ste uviazli na probléme, na ktorý neviete + nájs» vlastné rie¹enie, mô¾ete získa» pomoc od niekoho na týchto mailing + listoch. Zoznam mailing listov rovnako ako liniek na archívy mailing listov + a iných podporných online zdrojov mô¾ete nájs» na <ulink + url="&url.php.support;">&url.php.support;</ulink>. + Okrem toho, na + <ulink url="&url.php.links;">&url.php.links;</ulink> je zoznam webových + stránok urèených PHP èlánkom, diskusným fóram a galériám kódov. </para> </sect1> <sect1 id="about.howtohelp"> - <title>How to help improve the documentation</title> + <title>Ako pomôc» pri zlep¹ovaní dokumentácie</title> <para> - There are three ways you can help to improve this documentation. + Sú tri spôsoby ako mô¾ete pomôc» zlep¹i» túto dokumentáciu. </para> <para> - If you find errors in this manual, in any language, please report them - using the bug system at <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. - Classify the bug as "Documentation Problem". You can also submit problems - related to specific manual formats here. + Ak v tomto manuáli nájdete chyby, i v inom jazyku, prosím hláste ich + pomocou bug systému na <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. + Klasifikujte bug ako "Documentation Problem". Mô¾ete tu tie¾ hlási» + problémy, ktoré súvisia so ¹pecifickým formátom manuálu. </para> <note> <para> - Please don't abuse the bug system by submitting requests for help. Use the - mailing lists or community sites mentioned earlier, instead. + Prosím, nezneu¾ívajte bug systém ¾iadaním o pomoc. Namiesto toho pou¾ívajte + skôr spomenuté mailing listy alebo stránky komunity. </para> </note> <para> - By contributing notes, you can provide additional examples, caveats, and - clarifications for other readers. But do not submit bug reports using the - annotation system please. You can read more about annotations in the <link - linkend="about.notes">'About user notes'</link> section of this - appendix. + Prispievaním poznámok mô¾ete poskytova» doplòujúce príklady, rady a + objasnenia pre iných èitateµov. Ale, prosím, nepodávajte bug reporty + pou¾itím anotaèného systému. O anotáciách si mô¾ete preèíta» viac v sekcii + <link linkend="about.notes">'O príspevkoch u¾ívateµov'</link> tejto prílohy. </para> <para> - If you know English and some foreign language, you may also - help out in the translations. If you would like to start a new - translation, or help in a translation project, please read + Ak viete anglicky a nejaký cudzí jazyk, mô¾ete taktie¾ vypomôc» + v prekladaní. Ak by ste chceli zaèa» nový preklad, alebo + pomôc» v projekte prekladu, prosím èítajte <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>. </para> </sect1> <sect1 id="about.generate"> - <title>How we generate the formats</title> + <title>Ako generujeme formáty</title> <para> - This manual is written in <acronym>XML</acronym> using the <ulink - url="&url.docbook.xml;">DocBook XML DTD</ulink>, using <ulink - url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document - Style and Semantics Specification Language) for formatting, and - experimentally the <ulink url="&url.xslt;"><acronym>XSLT</acronym> + Tento manuál je napísaný v <acronym>XML</acronym> pomocou + <ulink url="&url.docbook.xml;">DocBook XML DTD</ulink>, vyu¾ívajúci + <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document + Style and Semantics Specification Language) pre formátovanie a + experimentrálne <ulink url="&url.xslt;"><acronym>XSLT</acronym> </ulink> (Extensible Stylesheet Language Transformations) - for maintenance and formatting. + pre úpravu a formátovanie. </para> <para> - Using <acronym>XML</acronym> 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. - The tools used for formatting <acronym>HTML</acronym> and - <acronym>TeX</acronym> versions are - <ulink url="&url.jade;">Jade</ulink>, written by <ulink - url="&url.jclark;">James Clark</ulink> and <ulink - url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink> - written by <ulink url="&url.nwalsh;">Norman Walsh</ulink>. - We use <ulink url="&url.winhelp;">Microsoft HTML Help - Workshop</ulink> to generate the Windows HTML Help format - of the manual, and of course PHP itself to do some - additional conversions and formatting. - </para> - <para> - You can download the manual in various languages and - formats, including plain text, plain <acronym>HTML</acronym>, - <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo and - Windows HTML Help, from + Pou¾ívanie <acronym>XML</acronym> ako zdrojového formátu nám + umo¾òuje generovanie mnohých výstupných formátov zo zdrojových + súborov, prièom sa upravuje iba jeden zdrojový dokument pre v¹etky + formáty. Nástroje pou¾ívané na formátovanie <acronym>HTML</acronym> + a <acronym>TeX</acronym> verzií sú + <ulink url="&url.jade;">Jade</ulink>, ktorý napísal <ulink + url="&url.jclark;">James Clark</ulink> a <ulink + url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>, + ktorý napísal <ulink url="&url.nwalsh;">Norman Walsh</ulink>. + Pou¾ívame <ulink url="&url.winhelp;">Microsoft HTML Help + Workshop</ulink>, aby sme vygenerovali formát Windows HTML Help + manuálu a, samozrejme, samotné PHP, aby sme urobili + dodatoèné úpravy a formátovanie. + </para> + <para> + Tie¾ si manuál mô¾ete stiahnú» vo viacerých jazykoch + a formátch, vrátanie prostého textu, <acronym>HTML</acronym>, + <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo a + Windows HTML Help, z <ulink url="&url.php.docs;">&url.php.docs;</ulink>. - The manuals are updated automatically as the text is updated. + Manuály sa aktualizujú automaticky súèasne s textom. </para> <para> - You can find more information about downloading the - <acronym>XML</acronym> source code of this documentation - at <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. The - documentation is stored in the <literal>phpdoc</literal> module. + Viac informácií o s»ahovaní zdrojového kódu + <acronym>XML</acronym> tejto dokumentácie mô¾ete nájs» + na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. + Dokumentácia je ulo¾ená v module <literal>phpdoc</literal>. </para> </sect1> <sect1 id="about.translations"> - <title>Translations</title> + <title>Preklady</title> <para> - The PHP manual is not only available in various formats, - it is also available in various languages. 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. - 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. - </para> - <para> - Peoples involved in the translations start from the <acronym>XML</acronym> - source code available from <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> - and from it they translate to thier mother language. They do - <emphasis>not use</emphasis> the <acronym>HTML</acronym>, the plain text, - or the <acronym>PDF</acronym> version. It is the build system which takes - care of the conversions from <acronym>XML</acronym> to human readable formats. + PHP manuál je dostupný nie len vo viacerých formátoch, + ale tie¾ vo viacerých jazykoch. Text manuálu sa najskôr + napí¹e v angliètine a potom ho tímy µudí po celom svete + prekladajú do svojho rodného jazyka. Ak sa preklad pre + ¹pecifickú funkciu alebo kapitolu e¹te neurobil, build systém + manuálu spadá do svojej anglickej verzie. + </para> + <para>ï + ¥udia, ktorí sa podieµajú na prekladoch zaèínajú zo zdrojového kódu + <acronym>XML</acronym> dostupného na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> + a z neho ho prekladajú do svojho materinského jazyka. + <emphasis>Nepou¾ívajú</emphasis> <acronym>HTML</acronym>, prostý text, + ani <acronym>PDF</acronym> verziu. Je to build systém, ktorý prekladá + <acronym>XML</acronym> kód do µudskej reèi. </para> <note> <para> - 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 <ulink + Ak by ste sa chceli podiela» na prekladaní dokumentácie do vá¹ho + rodného jazyka, prosím, kontaktujte translation/documentation team + prihlasením sa do mailing listu phpdoc: po¹lite prázdny mail na <ulink url="mailto:&email.php.doc.subscribe;">&email.php.doc.subscribe;</ulink>. - The mailing list address is <literal>&email.php.doc;</literal>. State in the - message that you are interested in translating the manual to a language - and someone will get back to you, helping you start a new language translation - or reach the already active documentation team for your language. - </para> + Adresa mailing listu je <literal>&email.php.doc;</literal>. V správe + uveï»e, ¾e máte záujem o prekladanie manuálu do svojho jazyka. Niekto sa + vám ozve, radiac vám ako zaèa» preklad do nového jazyka alebo ako sa + pripoji» k u¾ aktívnemu dokumentaènému tímu pre vá¹ jazyk. + </para> </note> <para> - At the moment the manual is available, partly or not, in the following languages: - Brazilian Portuguese, Chinese, Czech, Dutch, French, German, Hungarian, Italian, - Japanese, Korean, Polish and Spanish. + Momentálne je manuál èiastoène dostupný v následujúcich jazykoch: + v brazílskej portugal¹tine, èín¹tine, èe¹tine, holand¹tine, francúz¹tine, + nemèine, maïarèine, talianèine, japonèine, kórejèine, pol¹tine a ¹panielèine. </para> <para> - They all can be downloaded here: <ulink url="&url.php.docs;">&url.php.docs;</ulink>. + V¹etky sa dajú stiahnú» tu: <ulink url="&url.php.docs;">&url.php.docs;</ulink>. </para> </sect1>
Index: phpdoc/en/appendices/wrappers.xml diff -u phpdoc/en/appendices/wrappers.xml:1.8 phpdoc/en/appendices/wrappers.xml:1.9 --- phpdoc/en/appendices/wrappers.xml:1.8 Thu Oct 31 20:32:37 2002 +++ phpdoc/en/appendices/wrappers.xml Thu Dec 26 20:40:20 2002 @@ -1,19 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.8 Maintainer: joseph Status: ready --> <appendix id="wrappers"> - <title>List of Supported Protocols/Wrappers</title> + <title>Zoznam Podporovaných Protokolov/Balíèkov</title> <para> - The following is a list of the various URL style protocols that - PHP has built-in for use with the filesystem functions such as - <function>fopen</function> and <function>copy</function>. - In addition to these wrappers, as of PHP 4.3, you can write - your own wrappers using PHP script and + Následujúce je zoznam rôznych ¹týlových protokolov URL, ktoré + má PHP vstavané pre pou¾itie s filesystem funkciami ako sú + <function>fopen</function> a <function>copy</function>. + Okrem týchto balíèkov (wrappers), ako aj tých v PHP 4.3, si + mô¾te napísa» svoje vlastné balíèky s pou¾itím PHP skriptu a <function>stream_register_wrapper</function>. </para> <section id="wrappers.http"> - <title>HTTP and HTTPS</title> - <simpara>PHP 3, PHP 4. <filename>https://</filename> since PHP 4.3</simpara> + <title>HTTP a HTTPS</title> + <simpara>PHP 3, PHP 4. <filename>https://</filename> od PHP 4.3</simpara> <itemizedlist> <listitem><simpara><filename>http://example.com</filename></simpara></listitem> @@ -22,39 +22,38 @@ <listitem><simpara><filename>https://user:password@example.com</filename></simpara></listitem> </itemizedlist> - <simpara>Allows read-only access to files/resources via HTTP 1.0, - using the HTTP GET method. A <literal>Host:</literal> header is sent with the request - to handle name-based virtual hosts. If you have configured - a <link linkend="ini.user-agent">user_agent</link> string using - your ini file or the stream context, it will also be included - in the request. - </simpara> - <simpara> - Redirects have been supported since PHP 4.0.5; if you are using - an earlier version you will need to include trailing slashes in - your URLs. - </simpara> - <simpara> - The stream allows access to the <emphasis>body</emphasis> of - the resource; the headers are stored in the - <varname>$http_response_header</varname> variable. - Since PHP 4.3, the headers are available using + <simpara>Umo¾òuje prístup iba na èítanie k súborom/zdrojom cez HTTP 1.0 + pou¾itím metódy HTTP GET. Hlavièka <literal>Host:</literal> sa po¹le + s po¾iadavkou na zaistenie na mene zalo¾ených virtuálnych hostov. Ak + ste nakonfigurovali re»azec <link linkend="ini.user-agent">user_agent</link> + pou¾itím vá¹ho ini súboru alebo prúdového kontextu, taktie¾ sa zahrnie + do po¾iadavky. + </simpara> + <simpara> + Uz PHP 4.0.5 podporuje presmerovania; ak pou¾ívate predchádzajúce + verzie, budete musie» zahrnú» vleèné lomítka do svojich URL adries. + </simpara> + <simpara> + Prúd umo¾òuje prístup k <emphasis>telu</emphasis> + zdroja; hlavièky sú ulo¾ené v premennej + <varname>$http_response_header</varname>. + Od PHP 4.3, hlavièky sú dostupné pou¾itím <function>stream_get_meta_data</function>. </simpara> <simpara> - HTTP connections are read-only; you cannot write data or copy - files to an HTTP resource. + Pripojenia cez HTTP sú iba na èítanie; nemô¾ete zapisova» dáta + alebo kopírova» súbory do HTTP zdroja. </simpara> <note> - <simpara>HTTPS is supported starting from PHP 4.3, if you - have compiled in support for OpenSSL. + <simpara>HTTPS podporovalo u¾ PHP 4.3, ak ste + kompilovali s podporou pre OpenSSL. </simpara> </note> </section> <section id="wrappers.ftp"> - <title>FTP and FTPS</title> - <simpara>PHP 3, PHP 4. <filename>ftps://</filename> since PHP 4.3</simpara> + <title>FTP a FTPS</title> + <simpara>PHP 3, PHP 4. <filename>ftps://</filename> od PHP 4.3</simpara> <itemizedlist> <listitem><simpara><filename>ftp://example.com/pub/file.txt</filename></simpara></listitem> @@ -64,37 +63,37 @@ </itemizedlist> <simpara> - Allows read access to existing files and creation of new files - via FTP. If the server does not support passive mode ftp, the - connection will fail. - </simpara> - <simpara> - You can open files for either reading or writing, but not both - simultaneously. If the remote file already exists on the ftp - server and you attempt to open it for writing, the connection - will fail. If you need to update existing files over ftp, - use <function>ftp_connect</function>. - </simpara> - <simpara> - <filename>ftps://</filename> was introduced in PHP 4.3. - It is the same as <filename>ftp://</filename>, - but attempts to negotiate a secure connection with the ftp server. - If the server does not support SSL, then the connection falls back - to regular unencrypted ftp. + Umo¾òuje prístup na èítanie k existujúcim súborom a tvorbu + nových cez FTP. Ak server nepodporuje pasívny mód ftp, spojenie + zlyhá. + </simpara> + <simpara> + Mô¾te otvára» súbory buï na èítanie alebo zápis, ale nie oboje + zároveò. Ak u¾ vzdialený súbor existuje na ftp serveri + a pokú¹ate sa ho otvori» na zapisovanie, spojenie zlyhá. Ak + potrebujete obnovi» existujúci súbor cez ftp, pou¾ite + <function>ftp_connect</function>. + </simpara> + <simpara> + <filename>ftps://</filename> bol predstavený v PHP 4.3. + Je to rovnaké ako s <filename>ftp://</filename>, + ale pokú¹a sa vyhµada» bezpeèné spojenie s ftp serverom. Ak server + nepodporuje SSL, potom sa spojenie navráti k regulérnemu + kryptovanému ftp. </simpara> <note> - <simpara>FTPS is supported starting from PHP 4.3, if you - have compiled in support for OpenSSL. + <simpara>FTPS podporovalo u¾ PHP 4.3, ak ste + kompilovali s podporou pre OpenSSL. </simpara> </note> </section> <section id="wrappers.php"> - <title>PHP input/output streams</title> + <title>Vstupné/Výstupné prúdy PHP</title> <simpara> - PHP 3.0.13 and up, <filename>php://output</filename> - and <filename>php://input</filename> since PHP 4.3 + PHP 3.0.13 a vy¹¹ie, <filename>php://output</filename> + a <filename>php://input</filename> poèínajúc PHP 4.3 </simpara> <itemizedlist> @@ -107,33 +106,33 @@ <simpara> <filename>php://stdin</filename>, <filename>php://stdout</filename> - and <filename>php://stderr</filename> allow access to - the corresponding input or output stream of the PHP process. + a <filename>php://stderr</filename> umo¾òujú prístup ku + kore¹pondujúcemu vstupnému alebo výstupnému prúdu PHP procesu. </simpara> <simpara> - <filename>php://output</filename> allows you to write to the - output buffer mechanism in the same way as - <function>print</function> and <function>echo</function>. + <filename>php://output</filename> umo¾òuje zápis do výstupného + mechanizmu zásobníka rovnakým spôsobom ako + <function>print</function> a <function>echo</function>. </simpara> <simpara> - <filename>php://input</filename> allows you to read raw POST data. - It is a less memory intensive alternative to - <varname>$HTTP_RAW_POST_DATA</varname> and does not need any - special &php.ini; directives. + <filename>php://input</filename> umo¾òuje èítanie prvotné POST dáta. + Je to menej pamä» za»a¾ujúca alternatíva k + <varname>$HTTP_RAW_POST_DATA</varname> a nepotrebuje ¾iadne + ¹peciálne &php.ini; direktívy. </simpara> <simpara> - <filename>php://stdin</filename> and - <filename>php://input</filename> are read-only, whereas + <filename>php://stdin</filename> a + <filename>php://input</filename> sú iba na èítanie, zatiaµèo <filename>php://stdout</filename>, - <filename>php://stderr</filename> and - <filename>php://output</filename> are write-only. + <filename>php://stderr</filename> a + <filename>php://output</filename> sú iba na zápis. </simpara> </section> <section id="wrappers.compression"> - <title>Compression Streams</title> - <simpara><filename>zlib:</filename> PHP 4.0.4 - PHP 4.2.3 (systems with fopencookie only)</simpara> - <simpara><filename>compress.zlib://</filename> and <filename>compress.bzip2://</filename> PHP 4.3 and up</simpara> + <title>Prúdy Kompresie</title> + <simpara><filename>zlib:</filename> PHP 4.0.4 - PHP 4.2.3 (iba systémy s fopencookie)</simpara> + <simpara><filename>compress.zlib://</filename> a <filename>compress.bzip2://</filename> PHP 4.3 a vy¹¹ie</simpara> <itemizedlist> <listitem><simpara><filename>zlib:</filename></simpara></listitem> @@ -142,18 +141,18 @@ </itemizedlist> <simpara> - <filename>zlib:</filename> works like <function>gzopen</function>, except that the - stream can be used with <function>fread</function> and the other - filesystem functions. This is deprecated as of PHP 4.3 due - to ambiguities with filenames containing ':' characters; use - <filename>compress.zlib://</filename> instead. + <filename>zlib:</filename> pracuje ako <function>gzopen</function>, a¾ na to, ¾e + prúd sa dá pou¾i» s <function>fread</function> a inými + filesystem funkciami. Nie je to schvaµované ako to nie je aj v PHP 4.3 + kvôli nejednoznaènosti s názvami súborov obsahujúcich znaky ':'; rad¹ej + pou¾ívajte <filename>compress.zlib://</filename>. </simpara> <simpara> - <filename>compress.zlib://</filename> and - <filename>compress.bzip2://</filename> are equivalent to - <function>gzopen</function> and <function>bzopen</function> - respectively, and operate even on systems that do not support + <filename>compress.zlib://</filename> a + <filename>compress.bzip2://</filename> sú ekvivalentné k + <function>gzopen</function> a <function>bzopen</function> + jednotlivo a fungujú dokonca aj na systémoch, ktoré nepodporujú fopencookie. </simpara> </section> Index: phpdoc/en/appendices/about.xml diff -u phpdoc/en/appendices/about.xml:1.19 phpdoc/en/appendices/about.xml:1.20 --- phpdoc/en/appendices/about.xml:1.19 Sun Oct 27 07:31:14 2002 +++ phpdoc/en/appendices/about.xml Thu Dec 26 20:40:20 2002 @@ -1,161 +1,158 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<?xml version="1.0" encoding="iso-8859-2"?> +<!--EN-Revision: 1.19 Maintainer: joseph Status: ready --> <!-- TODO: add manual conventions section (eg. how to read function usage parts, what is fixed width, what is - bold, what is linked + bold, what is linked) add some tips about combining the versions (online- offline), and using "http://anymirror.php.net/funcname" --> <appendix id="about"> - <title>About the manual</title> + <title>O manuále</title> <sect1 id="about.formats"> - <title>Formats</title> + <title>Formáty</title> <para> - The PHP manual is provided in several formats. These formats can be divided - into two groups: online readable formats, and downloadable packages. + PHP manuál sa poskytuje v niekoµkých formátoch. Tieto formáty sa delia + na dve skupiny: online èitateµné formáty a stiahnuteµné balíky. </para> <note> <para> - Some publishers have made available printed versions of this manual. We - cannot recommend any of those, as they tend to become out-of-date very - quickly. + Niektorí vydávatelia uviedli tlaèené verzie tohto manuálu. Nemô¾eme + doporuèi» ¾iaden z nich, nakoµko sú zakrátko zastaralé. </para> </note> <para> - You can read the manual online at <ulink url="&url.php;">&url.php;</ulink> - and on the numerous mirror sites. For best performance, you should choose - the mirror site closest to you. 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. + Manuál si mô¾ete preèíta» online na <ulink url="&url.php;">&url.php;</ulink> + a na poèetných mirrorovaných stránkach. Pre najlep¹iu èinnos» by ste si mali + zvoli» mirrorovanú stránku najbli¾¹ie k vám. Manuál si mô¾ete prezera» buï + v jednoduchom (vhodnom pre tlaè) HTML formáte alebo v HTML formáte, ktorý + integruje manuál do podoby samotnej webovskej stránky PHP. </para> <para> - An advantage of the online manual over most of the offline formats is the - integration of <link linkend="about.notes">user-contributed - notes</link>. An obvious disadvantage is that you have to be online to view - the manual in the online formats. + Výhodou online manuálu oproti väè¹ine offline formátom je integrácia + <link linkend="about.notes">príspevkov u¾ivateµov</link>. Zrejmou + nevýhodou je, ¾e musíte by» online, aby ste si mohli prezera» manuál + v online formátoch. </para> <para> - 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. For information on how the manual is generated in so many - formats, read the <link linkend="about.generate">'How we generate the - formats'</link> section of this appendix. + Existuje niekoµko offline formátov manuálu a fakt, ktorý formát je pre vás + najvhodnej¹í, závisí na operaènom systéme, ktorý pou¾ívate a osobnom + spôsobe èítania. Ak chcete vedie» ako sa tento manuál generuje do mnohých + formátov, preèítajte si sekciu <link linkend="about.generate">'Ako generujeme formáty'</link> v tejto prílohe. </para> <para> - The most cross-platform formats of the manual are the HTML and plain-text - versions. 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). The HTML and plaintext formats are - provided as tar files compressed using the bzip2 archiver. + Najvhodnej¹ími multi-platformovými formátmi manuálu sú verzie HTML + a prostý-text. Formát HTML sa poskytuje ako jednoduchý HTML súbor ako aj + balík individuálnych súborov pre ka¾dú sekciu (ktorá pozostáva zo zväzku + niekoµko tisíc súborov). Formáty HTML a prostý-text sa poskytujú ako tar + súbory komprimované programom bzip2. </para> <para> - Another popular cross-platform format, and the format most suited to - printing, is PDF (also known as Adobe Acrobat). 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. + Ïal¹ím obµúbeným multi-platformovým formátom, ktorý je najvhodnej¹í pre + tlaè, je PDF (tie¾ známy ako Adobe Acrobat). Ale ne¾ sa pustíte do + s»ahovania tohto formátu a jeho tlaèe, majte na pamäti, ¾e manuál má + 2000 strán a ¾e sa neustále upravuje. </para> <note> <para> - If you do not already have a program capable of viewing PDF format - files, you may need to download <ulink url="&url.adobe.acrobat;">Adobe + Ak e¹te nemáte program schopný prezerania súborov formátu PDF, mo¾ete + si stiahnú» <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. </para> </note> <para> - For owners of Palm-compatible handhelds, the Palm document and iSilo - formats are ideal for this platform. You can bring your handheld with you - on your daily commute and use a <ulink url="&url.palm.doc;">DOC</ulink> - or <ulink url="&url.palm.isilo;">iSilo</ulink> reader to brush up on your - PHP knowledge, or just use it as a quick reference. + Pre vlastníkov handheldov kompaktibilných s Palm sú ideálne formáty + Palm dokument a iSilo. Mô¾ete si svoj handheld nosi» denne so sebou + a pou¾íva» <ulink url="&url.palm.doc;">DOC</ulink> alebo + <ulink url="&url.palm.isilo;">iSilo</ulink> reader, aby ste si + zdokonalili svoje PHP vedomosti, alebo ho len pou¾íva» ako príruèku. </para> <para> - For Windows platforms, the Windows HTML Help version of the manual soups up - the HTML format for use with the Windows HTML Help application. This - version provides full-text search, a full index, and bookmarking. Many - popular Windows PHP development environments also integrate with this - version of the documentation to provide easy access. + Pre platformy Windows, verzia manuálu Windows HTML Help umo¾òuje + pou¾itie HTML formátu vo Windows HTML Help aplikáciach. Táto verzia + poskytuje full-textové vyhµadávanie, plný index, a oznaènie zará¾ok + (bookmarking). Mnoho známych vývojových prostredí pre Windows tie¾ + zahàòa túto verziu dokumentácie pre jednoduchý prístup.. </para> <!-- mmmm, this project seems to be dead. Any news? <note> <para> - A Visual Basic for Linux project is in the planning stage, which will - include the development of a CHM Creator and Viewer for Linux. See their - <ulink url="&url.vb4linux;">SourceForge.net page</ulink> if you are - interested in the progress. + Projekt Visual Basic pre Linux je plánovaná fáza, ktorá bude zahàòa» + vývoj CHM Creator and Wiewer pre Linux. Pozrite si ich na + <ulink url="&url.vb4linux;">stránke SourceForge.net</ulink>, ak sa + zaujímate o priebeh. </para> </note> --> </sect1> <sect1 id="about.notes"> - <title>About user notes</title> + <title>O príspevkoch u¾ívateµov</title> <para> - The user-contributed notes play an important role in the development of - this manual. 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. And until the - notes have been incorporated, they can be viewed in their submitted form - online and in some of the offline formats. + Príspevky u¾ivateµov zohrávajú dôle¾itú úlohu vo vývoji tohto manuálu. + Tým, ¾e umo¾níme èitateµom manuálu prispevanie príkladov, rád a + ïal¹ích objasnení z ich prehliadaèa, ich mô¾eme zaèleni» do hlavného + textu manuálu. Kým sa príspevky zaèlenia, dajú sa prezera» vo svojej + predlo¾enej forme online a v niektorých offline formátoch. </para> <note> <para> - 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.) + Príspevky u¾ívateµov, pred tým ne¾ sa uverejnia online, nie sú upravované, + tak¾e kvalita zápisu alebo príkladov kódu, a dokonca ani správnos» + príspevku sa nedajú zaruèi». (Taktie¾ nie je záruka kvality a presnosti + samotného textu manuálu.) </para> </note> </sect1> - + <sect1 id="about.prototypes"> - <title>How to read a function definition (prototype)</title> + <title>Ako èíta» definíciu funkicie (prototyp)</title> <para> - Each function is documented for quick reference, knowing how - to read and understand the manual will make using PHP - much easier. Rather than relying on examples or cut/paste, you want - to know how to read function definitions (prototypes). Let's begin: + Ka¾dá funkcia je zdokumentovaná v informaènej príruèke; znalos», + ako sa má manuál èíta» a rozumie», pou¾ívanie PHP znaène + ulah¹í. Namiesto odvolávania sa na príklady alebo vystrihnú»/vlo¾i», + chcete rad¹ej vedie» ako èíta» definície funkcií (prototypy). Zaènime: </para> <note> <title> - Prerequisite: Basic understanding of <link linkend="language.types">types</link> + Nevyhnutná podmienka: Základná interpretácia <link linkend="language.types">typov</link> </title> <para> - Although PHP is a loosly typed language, it's important to have - a basic understanding of <link linkend="language.types">types</link> as - they have important meaning. + I keï PHP je len poµahky typovým jazykom, je dôle¾ité ma» základné + vedomosti o <link linkend="language.types">typoch</link>, preto¾e + majú dôle¾itý význam. </para> </note> <para> - Function definitions tell us what - type of value is <link linkend="functions.returning-values">returned</link>, - let's use the definition for <function>strlen</function> as our first example: + Definície funkcií nám hovoria aký + typ hodnoty je <link linkend="functions.returning-values">navrátený</link>, + pou¾ijeme definíciu pre <function>strlen</function>, ako ná¹ prvý príklad: </para> <para> <screen role="html"> strlen (PHP 3, PHP 4 >= 4.0.0) -strlen -- Get string length +strlen -- Urèí då¾ku reta¾ca -Description +Popis int strlen ( string str ) -Returns the length of string. +Vráti då¾ku re»azca. </screen> </para> <para> <table> - <title>Explanation of a function definition</title> + <title>Vysvetlenie funkènej definície<title> <tgroup cols="2"> <thead> <row> - <entry>Part</entry> - <entry>Description</entry> + <entry>Èas»</entry> + <entry>Popis</entry> </row> </thead> <tbody> @@ -164,7 +161,7 @@ strlen </entry> <entry> - The function name. + Názov funkcie. </entry> </row> <row> @@ -172,7 +169,7 @@ (PHP 3, PHP 4 >= 4.0.0) </entry> <entry> - strlen() has been around in both all of PHP 3 and PHP 4 + strlen() bol k dispozícii v ochoch PHP 3 a PHP 4 </entry> </row> <row> @@ -180,9 +177,9 @@ int </entry> <entry> - Type of value this function returns, which is an + Typ hodnoty, ktorú táto funkcia vracia, èo je <link linkend="language.types.integer">integer</link> - (i.e. The length of a string is measured in numbers). + (t.j. Då¾ka re»azca sa udáva v èíslach). </entry> </row> <row> @@ -190,9 +187,9 @@ ( string str ) </entry> <entry> - The first (and in this case the only) parameter/argument for the - function strlen() is named <parameter>str</parameter>, and it's a - <link linkend="language.types.string">string</link>. + Prvý (a v tomto prípade jediný) parameter/argument pre + funkciu strlen() sa nazýva <parameter>str</parameter> a je to + <link linkend="language.types.string">re»azec</link>. </entry> </row> </tbody> @@ -200,207 +197,204 @@ </table> </para> <para> - We could rewrite the above function definition in a generic way: + Definíciu horeuvedenej funkcie by sme mohli prepísa» do v¹eobecného tvaru: </para> <para> <screen role="html"> - returned type function name ( parameter type parameter name ) + vrátený typ názov funkcie ( typ parametra názov parametra ) </screen> </para> <para> - Many functions take on multiple parameters, such as <function>in_array</function>. - It's prototype is as follows: + Mnoho funkcií má viacero parametrov, ako má napr. <function>in_array</function>. + Jeho prototyp vyzerá následovne: </para> <para> <screen role="html"> - bool in_array ( mixed needle, array haystack [, bool strict]) + bool in_array ( zmie¹aná ihla, array stoh_sena [, bool striktne]) </screen> </para> <para> - What does this mean? in_array() returns a - <link linkend="language.types.boolean">boolean</link> value, &true; on - success (the <parameter>needle</parameter> was found in the - <parameter>haystack</parameter>) or &false; on failure (the - <parameter>needle</parameter> was not found in the - <parameter>haystack</parameter>). The first parameter is named - <parameter>needle</parameter> and it can be many different - <link linkend="language.types">types</link>, so we call it - "<emphasis>mixed</emphasis>". This mixed <parameter>needle</parameter> - (what we're looking for) can either be a scalar value (string, integer, - or <link linkend="language.types.float">float</link>), or an - <link linkend="language.types.array">array</link>. - <parameter>haystack</parameter> (the array we're searching in) is the - second parameter. The third <emphasis>optional</emphasis> parameter is - named <parameter>strict</parameter>. All optional parameters are seen - in <emphasis>[</emphasis> brackets <emphasis>]</emphasis>. The manual - states that the <parameter>strict</parameter> parameter defaults to - boolean &false;. See the manual page on each function for details on - how they work. + Èo to vlastne znamená? in_array() vracia hodnotu + <link linkend="language.types.boolean">boolean</link>, &true; ak je + prevdivý (<parameter>ihla</parameter> bola nájdená v + <parameter>stoh_sena</parameter>) alebo &false; pri chybe ( + <parameter>ihla</parameter> sa nena¹la v + <parameter>stoh_sena</parameter>). Prvý parameter je pomenovaný + <parameter>ihla</parameter> a mô¾e by» viacerých + <link linkend="language.types">typov</link>, tak¾e sme ho nazvali + "<emphasis>zmie¹aná</emphasis>". Táto zmie¹aná <parameter>ihla</parameter> + (ktorú hµadáme) mo¾e by» buï skalárna hodnota (string, integer, + alebo <link linkend="language.types.float">float</link>) alebo + <link linkend="language.types.array">pole</link>. + <parameter>stoh_sena</parameter> (pole, v ktorom hµadáme) je + druhý parameter. Tretí <emphasis>voliteµný</emphasis> parameter je + pomenovaný <parameter>striktne</parameter>. V¹etky voliteµné parametre sú uzavreté + do <emphasis>[</emphasis> zátvoriek <emphasis>]</emphasis>. Manuál + ukladá, ¾e parameter <parameter>striktne</parameter> je ¹tandardne + nastevený na boolean &false;. Pozri manuálovú stránku pre ka¾dú + funkciu a ako fungujú. </para> </sect1> <sect1 id="about.phpversions"> - <title>PHP versions documented in this manual</title> + <title>Verzie PHP zdokumentované v tomot manuále</title> <para> - This documentation contains information about PHP 4, with some added - migration and compatibility notes regarding PHP 3. Behaviour, - parameter, return value and other changes between different PHP - versions are documented in notes and inline text in the manual. - </para> - <para> - You may find documentation pieces for the CVS version of PHP, which - always means the very latest development version available through - the CVS version handling system. If you are not a developer of PHP - itself, and you are not keen on using the very latest development - version of PHP, features marked with the "available in CVS" wording - are not accessible to you. Though these features will probably be - available in the next stable version of PHP. If you would like to - download the CVS version, see the <ulink url="&url.php.anoncvs;">anonymous - CVS access page</ulink>. - </para> - <para> - You may also encounter documentation for a PHP version which is - not released (something like PHP 4.3.0 as the latest stable version - is 4.2.3). Most of the time, this is not an error in the documentation. - Explanation is often added for features not available in the current - PHP release, but will be available in a known future PHP version. + Táto dokumentácia obsahuje informácie o PHP 4, s niektorými pridanými + migráciami a poznámkami ku kompatibilite s PHP 3. Správanie, + parameter, navrátenie hodnoty a iné zmeny medzi rôznymi verziami + PHP sú zdokumentované v poznámkach a v medziriadkovom texte v manuále. + </para> + <para> + Mô¾te nájs» dokumentaèné kúsky pre CVS verziu PHP, ktorá v¾dy + predstavuje najnov¹ie vyvíjanú verziu dostupnú cez systém CVS. Ak + nie ste vývojárom PHP samotného a nie ste nad¹ený pou¾ívaním + najnov¹ie vyvíjanej verzie PHP, rubriky oznaèené "available in CVS" + (dostupné v CVS) nie sú pre vás dostupné. I keï tieto rubriky budú + prevdepodobne dostupné v dal¹ej samostatnej verzii PHP. Ak by ste + si chceli stiahnu» CVS verziu, pozri <ulink url="&url.php.anoncvs;">anonymná prístupná CVS stránka</ulink>. + </para> + <para> + Taktie¾ mô¾te narazi» na dokumentáciu pre PHP verziu, ktorá e¹te + nie je uvoµnená (nieèo ako PHP 4.3.0, preto¾e najnov¹ia samostatná + verzia je 4.2.3). Väè¹inou toto nepredstavuje chybu v dokumtácii. + Vysvetlenie sa èasto pridáva k rubrikám, ktoré nie sú dostupné v + aktuálnom PHP vydaní, ale budú dostupné v známej budúcej PHP verzií. </para> </sect1> - + <sect1 id="about.more"> - <title>How to find more information about PHP</title> + <title>Ako nájs» viac informácii o PHP</title> <para> - This manual does not attempt to provide instruction about general - programming practices. 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. You may want to seek out a text more oriented towards - beginners. You can find a list of PHP-related books at <ulink + Tento manuál sa nesna¾í poskytova» in¹trukcie o v¹eobecných programovacích + praktikách. Ak ste len zaèínajúcim programátorom, mô¾e sa vám zda» zlo¾ité + nauèi» sa programova» v PHP len za pomoci tohto manuálu. Mô¾ete si + vyhµada» texty, ktoré sú viac orientované pre zaèiatoèníkov. Zoznam + kníh súvisiacich s PHP mô¾ete nájs» na <ulink url="&url.php.books;">&url.php.books;</ulink>. </para> <para> - There are a number of active mailing lists for discussion of all aspects of - programming with PHP. 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. You can find a list of the mailing lists at <ulink - url="&url.php.support;">&url.php.support;</ulink>, as well as links to the - mailing list archives and other online support resources. Furthermore, at - <ulink url="&url.php.links;">&url.php.links;</ulink> there is a list of - websites devoted to PHP articles, forums, and code galleries. + Existuje mno¾stvo aktívnych mailing listov urèených pre diskusie o v¹etkých + aspektoch programovania v PHP. Ak ste uviazli na probléme, na ktorý neviete + nájs» vlastné rie¹enie, mô¾ete získa» pomoc od niekoho na týchto mailing + listoch. Zoznam mailing listov rovnako ako liniek na archívy mailing listov + a iných podporných online zdrojov mô¾ete nájs» na <ulink + url="&url.php.support;">&url.php.support;</ulink>. + Okrem toho, na + <ulink url="&url.php.links;">&url.php.links;</ulink> je zoznam webových + stránok urèených PHP èlánkom, diskusným fóram a galériám kódov. </para> </sect1> <sect1 id="about.howtohelp"> - <title>How to help improve the documentation</title> + <title>Ako pomôc» pri zlep¹ovaní dokumentácie</title> <para> - There are three ways you can help to improve this documentation. + Sú tri spôsoby ako mô¾ete pomôc» zlep¹i» túto dokumentáciu. </para> <para> - If you find errors in this manual, in any language, please report them - using the bug system at <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. - Classify the bug as "Documentation Problem". You can also submit problems - related to specific manual formats here. + Ak v tomto manuáli nájdete chyby, i v inom jazyku, prosím hláste ich + pomocou bug systému na <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. + Klasifikujte bug ako "Documentation Problem". Mô¾ete tu tie¾ hlási» + problémy, ktoré súvisia so ¹pecifickým formátom manuálu. </para> <note> <para> - Please don't abuse the bug system by submitting requests for help. Use the - mailing lists or community sites mentioned earlier, instead. + Prosím, nezneu¾ívajte bug systém ¾iadaním o pomoc. Namiesto toho pou¾ívajte + skôr spomenuté mailing listy alebo stránky komunity. </para> </note> <para> - By contributing notes, you can provide additional examples, caveats, and - clarifications for other readers. But do not submit bug reports using the - annotation system please. You can read more about annotations in the <link - linkend="about.notes">'About user notes'</link> section of this - appendix. + Prispievaním poznámok mô¾ete poskytova» doplòujúce príklady, rady a + objasnenia pre iných èitateµov. Ale, prosím, nepodávajte bug reporty + pou¾itím anotaèného systému. O anotáciách si mô¾ete preèíta» viac v sekcii + <link linkend="about.notes">'O príspevkoch u¾ívateµov'</link> tejto prílohy. </para> <para> - If you know English and some foreign language, you may also - help out in the translations. If you would like to start a new - translation, or help in a translation project, please read + Ak viete anglicky a nejaký cudzí jazyk, mô¾ete taktie¾ vypomôc» + v prekladaní. Ak by ste chceli zaèa» nový preklad, alebo + pomôc» v projekte prekladu, prosím èítajte <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>. </para> </sect1> <sect1 id="about.generate"> - <title>How we generate the formats</title> + <title>Ako generujeme formáty</title> <para> - This manual is written in <acronym>XML</acronym> using the <ulink - url="&url.docbook.xml;">DocBook XML DTD</ulink>, using <ulink - url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document - Style and Semantics Specification Language) for formatting, and - experimentally the <ulink url="&url.xslt;"><acronym>XSLT</acronym> + Tento manuál je napísaný v <acronym>XML</acronym> pomocou + <ulink url="&url.docbook.xml;">DocBook XML DTD</ulink>, vyu¾ívajúci + <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document + Style and Semantics Specification Language) pre formátovanie a + experimentrálne <ulink url="&url.xslt;"><acronym>XSLT</acronym> </ulink> (Extensible Stylesheet Language Transformations) - for maintenance and formatting. + pre úpravu a formátovanie. </para> <para> - Using <acronym>XML</acronym> 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. - The tools used for formatting <acronym>HTML</acronym> and - <acronym>TeX</acronym> versions are - <ulink url="&url.jade;">Jade</ulink>, written by <ulink - url="&url.jclark;">James Clark</ulink> and <ulink - url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink> - written by <ulink url="&url.nwalsh;">Norman Walsh</ulink>. - We use <ulink url="&url.winhelp;">Microsoft HTML Help - Workshop</ulink> to generate the Windows HTML Help format - of the manual, and of course PHP itself to do some - additional conversions and formatting. - </para> - <para> - You can download the manual in various languages and - formats, including plain text, plain <acronym>HTML</acronym>, - <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo and - Windows HTML Help, from + Pou¾ívanie <acronym>XML</acronym> ako zdrojového formátu nám + umo¾òuje generovanie mnohých výstupných formátov zo zdrojových + súborov, prièom sa upravuje iba jeden zdrojový dokument pre v¹etky + formáty. Nástroje pou¾ívané na formátovanie <acronym>HTML</acronym> + a <acronym>TeX</acronym> verzií sú + <ulink url="&url.jade;">Jade</ulink>, ktorý napísal <ulink + url="&url.jclark;">James Clark</ulink> a <ulink + url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>, + ktorý napísal <ulink url="&url.nwalsh;">Norman Walsh</ulink>. + Pou¾ívame <ulink url="&url.winhelp;">Microsoft HTML Help + Workshop</ulink>, aby sme vygenerovali formát Windows HTML Help + manuálu a, samozrejme, samotné PHP, aby sme urobili + dodatoèné úpravy a formátovanie. + </para> + <para> + Tie¾ si manuál mô¾ete stiahnú» vo viacerých jazykoch + a formátch, vrátanie prostého textu, <acronym>HTML</acronym>, + <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo a + Windows HTML Help, z <ulink url="&url.php.docs;">&url.php.docs;</ulink>. - The manuals are updated automatically as the text is updated. + Manuály sa aktualizujú automaticky súèasne s textom. </para> <para> - You can find more information about downloading the - <acronym>XML</acronym> source code of this documentation - at <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. The - documentation is stored in the <literal>phpdoc</literal> module. + Viac informácií o s»ahovaní zdrojového kódu + <acronym>XML</acronym> tejto dokumentácie mô¾ete nájs» + na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. + Dokumentácia je ulo¾ená v module <literal>phpdoc</literal>. </para> </sect1> <sect1 id="about.translations"> - <title>Translations</title> + <title>Preklady</title> <para> - The PHP manual is not only available in various formats, - it is also available in various languages. 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. - 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. - </para> - <para> - Peoples involved in the translations start from the <acronym>XML</acronym> - source code available from <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> - and from it they translate to thier mother language. They do - <emphasis>not use</emphasis> the <acronym>HTML</acronym>, the plain text, - or the <acronym>PDF</acronym> version. It is the build system which takes - care of the conversions from <acronym>XML</acronym> to human readable formats. + PHP manuál je dostupný nie len vo viacerých formátoch, + ale tie¾ vo viacerých jazykoch. Text manuálu sa najskôr + napí¹e v angliètine a potom ho tímy µudí po celom svete + prekladajú do svojho rodného jazyka. Ak sa preklad pre + ¹pecifickú funkciu alebo kapitolu e¹te neurobil, build systém + manuálu spadá do svojej anglickej verzie. + </para> + <para>ï + ¥udia, ktorí sa podieµajú na prekladoch zaèínajú zo zdrojového kódu + <acronym>XML</acronym> dostupného na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> + a z neho ho prekladajú do svojho materinského jazyka. + <emphasis>Nepou¾ívajú</emphasis> <acronym>HTML</acronym>, prostý text, + ani <acronym>PDF</acronym> verziu. Je to build systém, ktorý prekladá + <acronym>XML</acronym> kód do µudskej reèi. </para> <note> <para> - 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 <ulink + Ak by ste sa chceli podiela» na prekladaní dokumentácie do vá¹ho + rodného jazyka, prosím, kontaktujte translation/documentation team + prihlasením sa do mailing listu phpdoc: po¹lite prázdny mail na <ulink url="mailto:&email.php.doc.subscribe;">&email.php.doc.subscribe;</ulink>. - The mailing list address is <literal>&email.php.doc;</literal>. State in the - message that you are interested in translating the manual to a language - and someone will get back to you, helping you start a new language translation - or reach the already active documentation team for your language. - </para> + Adresa mailing listu je <literal>&email.php.doc;</literal>. V správe + uveï»e, ¾e máte záujem o prekladanie manuálu do svojho jazyka. Niekto sa + vám ozve, radiac vám ako zaèa» preklad do nového jazyka alebo ako sa + pripoji» k u¾ aktívnemu dokumentaènému tímu pre vá¹ jazyk. + </para> </note> <para> - At the moment the manual is available, partly or not, in the following languages: - Brazilian Portuguese, Chinese, Czech, Dutch, French, German, Hungarian, Italian, - Japanese, Korean, Polish and Spanish. + Momentálne je manuál èiastoène dostupný v následujúcich jazykoch: + v brazílskej portugal¹tine, èín¹tine, èe¹tine, holand¹tine, francúz¹tine, + nemèine, maïarèine, talianèine, japonèine, kórejèine, pol¹tine a ¹panielèine. </para> <para> - They all can be downloaded here: <ulink url="&url.php.docs;">&url.php.docs;</ulink>. + V¹etky sa dajú stiahnú» tu: <ulink url="&url.php.docs;">&url.php.docs;</ulink>. </para> </sect1>