cvs: phpdoc-sk /appendices about.xml
| From: | Joseph Drake | Date: | Wed, 07 Sep 2005 23:27:39 +0000 |
| Subject: | cvs: phpdoc-sk /appendices about.xml | ||
| Groups: | php.doc.sk | ||
| Request: | Send a blank email to doc-sk+get-367@lists.php.net to get a copy of this message | ||
joseph Wed Sep 7 19:27:39 2005 EDT
Modified files:
/phpdoc-sk/appendices about.xml
Log:
synced with en version
http://cvs.php.net/diff.php/phpdoc-sk/appendices/about.xml?r1=1.18&r2=1.19&ty=u Index: phpdoc-sk/appendices/about.xml diff -u phpdoc-sk/appendices/about.xml:1.18 phpdoc-sk/appendices/about.xml:1.19 --- phpdoc-sk/appendices/about.xml:1.18 Fri Dec 3 15:10:58 2004 +++ phpdoc-sk/appendices/about.xml Wed Sep 7 19:27:38 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!--EN-Revision: 1.36 Maintainer: joseph Status: ready --> +<!--EN-Revision: 1.42 Maintainer: joseph Status: ready --> <appendix id="about"> <title>O manuále</title> @@ -19,7 +19,7 @@ <para> 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ï + zvoli» najbli¾¹í mirror. HTML verzia manuálu je 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> @@ -44,27 +44,22 @@ Poskytujeme tieto verzie zbalené, budete pobrebova» nejaký druh rozbalovacej utility na získanie súborov obsiahnutých v archívoch. </para> + <!-- + The PDF version of the PHP Manual is "currently" unavailable. Perhaps + one day it will exist. <para> Ï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á - viac ne¾ 2000 strán a ¾e sa neustále upravuje. + tlaè, je PDF (tie¾ známy ako Adobe Acrobat). Ale majte na pamäti, + ¾e manuál má viac ne¾ 2000 strán a ¾e sa neustále upravuje. </para> <note> <para> - Ak e¹te nemáte program schopný prezerania súborov formátu PDF, mo¾ete - si stiahnú» <ulink url="&url.adobe.acrobat;">Adobe + Existuje mnoho programov na prezeranie súborov <acronym>PDF</acronym>, + ako napr. <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. </para> </note> - <para> - Pre vlastníkov handheldov kompaktibilných s Palm sú ideálne formáty - Palm dokument a <productname>iSilo</productname>. - 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> Pre platformy Windows, verzia manuálu <productname>Windows HTML Help</productname> umo¾òuje pou¾itie HTML formátu vo Windows HTML Help aplikáciach. Táto verzia @@ -78,7 +73,7 @@ <para> Je tie¾ dostupná <ulink url="&url.php.echm;">roz¹írená CHM verzia</ulink>, - ktorá sa obnovuje menej èasto, ale poskytuje vaè¹í poèet + ktorá sa obnovuje menej èasto, ale poskytuje mnoho ïal¹ích funkcií. Bude fungova» teda fungova» pod <productname>Microsoft Windows</productname>, kvôli technológiám pou¾ívaným na tvorenie stránok pomocníka. </para> @@ -116,8 +111,8 @@ <para> Ka¾dá funkcia v manuále je zdokumentovaná v informaènej príruèke. Znalos», ako sa má text èíta» a rozumie», uèenie PHP znaène uµahèí. - Namiesto odvolávania sa na príklady alebo vystrihnú»/vlo¾i», rad¹ej - budete chcie» vedie» ako èíta» definície funkcií (prototypy). Zaènime: + Namiesto odvolávania sa na príklady alebo vystrihnú»/vlo¾i», ka¾dý by + mal vedie» ako èíta» definície funkcií (prototypy). Zaènime: </para> <note> <title> @@ -135,7 +130,8 @@ Pou¾ijeme definíciu pre <function>strlen</function>, ako ná¹ prvý príklad: </para> <para> - <screen> + <screen role="html"> +<![CDATA[ strlen (PHP 3, PHP 4, PHP 5) @@ -145,6 +141,7 @@ int strlen ( string str ) Vráti då¾ku re»azca. +]]> </screen> </para> <para> @@ -203,7 +200,9 @@ </para> <para> <screen> +<![CDATA[ vrátený typ názov funkcie ( typ parametra názov parametra ) +]]> </screen> </para> <para> @@ -212,7 +211,9 @@ </para> <para> <screen> +<![CDATA[ bool in_array (mixed ihla, array stoh_sena [, bool strict]) +]]> </screen> </para> <para> @@ -242,7 +243,9 @@ </para> <para> <screen> +<![CDATA[ (PHP 4 >= 4.3.0, PHP 5) +]]> </screen> </para> <para> @@ -260,20 +263,34 @@ 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;">CVS stránka prístupná pre anonymných</ulink>. + Dokumentácia èiastoène existuje pre CVS verziu PHP, ktorá v¾dy + predstavuje najnov¹ie vyvíjanú verziu. Táto sa stále e¹te musí vyda», + tak¾e je dostupná jedine cez riadiaci systém verzií alebo cez + <ulink url="&url.php.snapshots;">snapshot</ulink>. Tak¾e vedzte, ¾e + rubriky oznaèené "available in CVS" (dostupné v CVS) nie sú pre vás + typicky dostupné. I keï tieto rubriky budú prevdepodobne dostupné + v dal¹ej stabilnej verzii PHP. Pre stiahnutie CVS verzie, porzi + <ulink url="&url.php.anoncvs;">anonymná prístupová CVS stránka</ulink>. </para> <para> - Taktie¾ mô¾ete narazi» na dokumentáciu pre PHP verziu, ktorá e¹te - nie je uvoµnená (nieèo ako PHP 5.0.0, zatialèo najnov¹ia stabilná + Taktie¾ mô¾u existova» dokumentácie pre PHP verzie, ktoré e¹te + nie sú uvoµnené (nieèo ako PHP 5.0.0, zatialèo najnov¹ia stabilná verzia je 4.3.x). Väè¹inou toto nepredstavuje chybu v dokumetácii. Vysvetlenie sa èasto pridáva k rubrikám, ktoré nie sú dostupné v aktuálnom PHP vydaní, ale ktoré budú dostupné v známej budúcej PHP verzií. + PHP typicky pridáva nové vlastnosti iba v hlavných vydaniach, inak sa + opravujú iba chyby. Pri pou¾ití formátu verzií A.B.C, hlavný vydanie + inkrementuje A alebo B, nakoµko men¹ie vydania inkrementujú C. Tak¾e napr. + nie je nezvyklé, aby nejaká vlastno» bola zdokumentovaná a dostupná + v PHP x.1.x, keï najnov¹ie vydanie je PHP x.0.x. Tie¾ si v¹imnite, ¾e + manuál je písaný v prítomnom èase, nie v budúcom. + </para> + <para> + Many times the PHP manual lists "Default Values" for PHP directives. These + values are based on <filename>php.ini-dist</filename> and not + <filename>php.ini-recommended</filename>. They also refer to the latest + version of PHP. See the <link linkend="ini.list">PHP directive + appendix</link> for details on these values and changes. </para> </sect1> @@ -281,40 +298,39 @@ <title>Ako nájs» viac informácii o PHP</title> <para> 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 + praktikách. Zaèínajúcim programátorom sa mô¾e zda» zlo¾ité + nauèi» sa programova» v PHP výhradne za pomoci tohto manuálu. Miest toho + si vyhµadajte texty, ktoré sú viac orientované pre zaèiatoèníkov. Alebo + nejakú knihu, tie¾ pozri zoznam kníh súvisiacich s PHP na <ulink url="&url.php.books;">&url.php.books;</ulink>. </para> <para> 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;">Stránke podpory PHP.net</ulink>. - Okrem toho, na - <ulink url="&url.php.links;">Stránke odkazov PHP.net</ulink> je zoznam webových - stránok urèených PHP èlánkom, diskusným fóram a galériám kódov. + aspektoch programovania v PHP. Ak ste uviazli pri probléme, zvá¾te + vyu¾itie týchto mailing listov. Pre mo¾nosti podpory, vrátane mailing + listov, pozri <ulink url="&url.php.support;">Stránku podpory PHP.net</ulink>. + Okrem toho existuje zoznam web stránok venovaných PHP èlánkom, fóram + a galériam kódov na <ulink url="&url.php.links;">Stránke odkazov PHP.net</ulink> . </para> </sect1> <sect1 id="about.howtohelp"> <title>Ako pomôc» pri zlep¹ovaní dokumentácie</title> <para> - Sú tri spôsoby ako mô¾ete pomôc» zlep¹i» túto dokumentáciu. + Sú tri spôsoby ako ka¾dý mô¾e pomôc» zlep¹i» túto dokumentáciu. </para> <para> - Ak v tomto manuáli nájdete chyby, i v inom jazyku, prosím hláste ich + Ak sa v tomto manuáli nájdu 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 tam tie¾ hlási» - problémy, ktoré súvisia so ¹pecifickým formátom manuálu. + Klasifikujte bug ako "Documentation Problem". V¹etky problémy vz»ahujúce sa + k manuálu, vrátane tých súvisiacich s formátmi manuálu, by sa mali posiela» + ako správy o chybách (bug report). </para> <note> <para> - Prosím, nezneu¾ívajte bug systém ¾iadaním o pomoc. Namiesto toho pou¾ívajte - skôr spomenuté mailing listy alebo stránky komunity. + Prosím, nezneu¾ívajte bug systém ¾iadaním o pomoc. + Namiesto toho, pou¾ite jednu z mnohých + <ulink url="&url.php.support;">mo¾ností podpory</ulink>. </para> </note> <para> @@ -324,16 +340,17 @@ <link linkend="about.notes">'O príspevkoch u¾ívateµov'</link> tejto prílohy. </para> <para> - 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>. + PHP manuál je prelo¾ený do mnohých jazykov. Znalos» angliètiny a + cudzieho jazyka dáva priestor pre ïal¹í spôsob ako pomôc» zlep¹i» PHP + manuál, a to prácou s prekladateµským tímov. Pre informácie ako zaèa» + nový preklad, alebo ako pomôc» momentálne prekladanej verzii, prosím + èitajte <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>. </para> <para> - PHP Dokoumentaèný Projekt má IRC kanál, kde mô¾ete prís» - a pokeca» si s autormi manuálu alebo nájs» nejaké aspekty - manuálu, s ktorými mo¾no potrebujete pomôc» Je to - <literal>#phpdoc</literal> na <literal>irc.freenode.net</literal>. + Dokumentaèný Projekt PHP má IRC kanál, kde sa zdr¾iavajú + autori. Nav¹tívte <literal>#phpdoc</literal> na + <literal>irc.freenode.net</literal> a diskutujte o spôsoboch zlep¹enia + PHP dokumentácie. </para> </sect1> @@ -349,7 +366,7 @@ pre úpravu a formátovanie. </para> <para> - Pou¾ívanie <acronym>XML</acronym> ako zdrojového formátu nám + Pou¾ívanie <acronym>XML</acronym> ako zdrojového formátu 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> @@ -364,17 +381,10 @@ 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>. - Kvôli technickým dôvodom nemusia by» niektoré formáty dostupné. - </para> - <para> - 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>. + PHP manuál je generovaný vo viacerých jazykoch a formátoch, pozri + <ulink url="&url.php.docs;">&url.php.docs;</ulink> pre ïal¹ie detaily. + Zdrojový kód <acronym>XML</acronym> je mo¾né stiahnú» z CVS a + prezrie» na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. Dokumentácia je ulo¾ená v module <literal>phpdoc</literal>. </para> </sect1> @@ -393,20 +403,21 @@ ¥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. + <emphasis>Nepou¾ívajú</emphasis> generované verzie (ako + <acronym>HTML</acronym> alebo prostý text) nakoµko je to build systém, + ktorý sa stará o preklad z <acronym>XML</acronym> do formátu zrozumiteµného + pre µudí. </para> <note> <para> - Ak by ste sa chceli podiela» na prekladaní dokumentácie do vá¹ho - rodného jazyka, prosím, kontaktujte translation/documentation team + Ak chcete pomôc» s prekladom dokumentácie, + 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>. 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. + preuká¾te záujem o prekladanie manuálu a ozve sa vám niekto, kto + a poradí ako zaèa» s preklad do nového jazyka alebo ako skontaktova» + existujúci tím pre ¾iadaný jazyk. </para> </note> <para>
http://cvs.php.net/diff.php/phpdoc-sk/appendices/about.xml?r1=1.18&r2=1.19&ty=u Index: phpdoc-sk/appendices/about.xml diff -u phpdoc-sk/appendices/about.xml:1.18 phpdoc-sk/appendices/about.xml:1.19 --- phpdoc-sk/appendices/about.xml:1.18 Fri Dec 3 15:10:58 2004 +++ phpdoc-sk/appendices/about.xml Wed Sep 7 19:27:38 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!--EN-Revision: 1.36 Maintainer: joseph Status: ready --> +<!--EN-Revision: 1.42 Maintainer: joseph Status: ready --> <appendix id="about"> <title>O manuále</title> @@ -19,7 +19,7 @@ <para> 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ï + zvoli» najbli¾¹í mirror. HTML verzia manuálu je 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> @@ -44,27 +44,22 @@ Poskytujeme tieto verzie zbalené, budete pobrebova» nejaký druh rozbalovacej utility na získanie súborov obsiahnutých v archívoch. </para> + <!-- + The PDF version of the PHP Manual is "currently" unavailable. Perhaps + one day it will exist. <para> Ï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á - viac ne¾ 2000 strán a ¾e sa neustále upravuje. + tlaè, je PDF (tie¾ známy ako Adobe Acrobat). Ale majte na pamäti, + ¾e manuál má viac ne¾ 2000 strán a ¾e sa neustále upravuje. </para> <note> <para> - Ak e¹te nemáte program schopný prezerania súborov formátu PDF, mo¾ete - si stiahnú» <ulink url="&url.adobe.acrobat;">Adobe + Existuje mnoho programov na prezeranie súborov <acronym>PDF</acronym>, + ako napr. <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. </para> </note> - <para> - Pre vlastníkov handheldov kompaktibilných s Palm sú ideálne formáty - Palm dokument a <productname>iSilo</productname>. - 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> Pre platformy Windows, verzia manuálu <productname>Windows HTML Help</productname> umo¾òuje pou¾itie HTML formátu vo Windows HTML Help aplikáciach. Táto verzia @@ -78,7 +73,7 @@ <para> Je tie¾ dostupná <ulink url="&url.php.echm;">roz¹írená CHM verzia</ulink>, - ktorá sa obnovuje menej èasto, ale poskytuje vaè¹í poèet + ktorá sa obnovuje menej èasto, ale poskytuje mnoho ïal¹ích funkcií. Bude fungova» teda fungova» pod <productname>Microsoft Windows</productname>, kvôli technológiám pou¾ívaným na tvorenie stránok pomocníka. </para> @@ -116,8 +111,8 @@ <para> Ka¾dá funkcia v manuále je zdokumentovaná v informaènej príruèke. Znalos», ako sa má text èíta» a rozumie», uèenie PHP znaène uµahèí. - Namiesto odvolávania sa na príklady alebo vystrihnú»/vlo¾i», rad¹ej - budete chcie» vedie» ako èíta» definície funkcií (prototypy). Zaènime: + Namiesto odvolávania sa na príklady alebo vystrihnú»/vlo¾i», ka¾dý by + mal vedie» ako èíta» definície funkcií (prototypy). Zaènime: </para> <note> <title> @@ -135,7 +130,8 @@ Pou¾ijeme definíciu pre <function>strlen</function>, ako ná¹ prvý príklad: </para> <para> - <screen> + <screen role="html"> +<![CDATA[ strlen (PHP 3, PHP 4, PHP 5) @@ -145,6 +141,7 @@ int strlen ( string str ) Vráti då¾ku re»azca. +]]> </screen> </para> <para> @@ -203,7 +200,9 @@ </para> <para> <screen> +<![CDATA[ vrátený typ názov funkcie ( typ parametra názov parametra ) +]]> </screen> </para> <para> @@ -212,7 +211,9 @@ </para> <para> <screen> +<![CDATA[ bool in_array (mixed ihla, array stoh_sena [, bool strict]) +]]> </screen> </para> <para> @@ -242,7 +243,9 @@ </para> <para> <screen> +<![CDATA[ (PHP 4 >= 4.3.0, PHP 5) +]]> </screen> </para> <para> @@ -260,20 +263,34 @@ 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;">CVS stránka prístupná pre anonymných</ulink>. + Dokumentácia èiastoène existuje pre CVS verziu PHP, ktorá v¾dy + predstavuje najnov¹ie vyvíjanú verziu. Táto sa stále e¹te musí vyda», + tak¾e je dostupná jedine cez riadiaci systém verzií alebo cez + <ulink url="&url.php.snapshots;">snapshot</ulink>. Tak¾e vedzte, ¾e + rubriky oznaèené "available in CVS" (dostupné v CVS) nie sú pre vás + typicky dostupné. I keï tieto rubriky budú prevdepodobne dostupné + v dal¹ej stabilnej verzii PHP. Pre stiahnutie CVS verzie, porzi + <ulink url="&url.php.anoncvs;">anonymná prístupová CVS stránka</ulink>. </para> <para> - Taktie¾ mô¾ete narazi» na dokumentáciu pre PHP verziu, ktorá e¹te - nie je uvoµnená (nieèo ako PHP 5.0.0, zatialèo najnov¹ia stabilná + Taktie¾ mô¾u existova» dokumentácie pre PHP verzie, ktoré e¹te + nie sú uvoµnené (nieèo ako PHP 5.0.0, zatialèo najnov¹ia stabilná verzia je 4.3.x). Väè¹inou toto nepredstavuje chybu v dokumetácii. Vysvetlenie sa èasto pridáva k rubrikám, ktoré nie sú dostupné v aktuálnom PHP vydaní, ale ktoré budú dostupné v známej budúcej PHP verzií. + PHP typicky pridáva nové vlastnosti iba v hlavných vydaniach, inak sa + opravujú iba chyby. Pri pou¾ití formátu verzií A.B.C, hlavný vydanie + inkrementuje A alebo B, nakoµko men¹ie vydania inkrementujú C. Tak¾e napr. + nie je nezvyklé, aby nejaká vlastno» bola zdokumentovaná a dostupná + v PHP x.1.x, keï najnov¹ie vydanie je PHP x.0.x. Tie¾ si v¹imnite, ¾e + manuál je písaný v prítomnom èase, nie v budúcom. + </para> + <para> + Many times the PHP manual lists "Default Values" for PHP directives. These + values are based on <filename>php.ini-dist</filename> and not + <filename>php.ini-recommended</filename>. They also refer to the latest + version of PHP. See the <link linkend="ini.list">PHP directive + appendix</link> for details on these values and changes. </para> </sect1> @@ -281,40 +298,39 @@ <title>Ako nájs» viac informácii o PHP</title> <para> 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 + praktikách. Zaèínajúcim programátorom sa mô¾e zda» zlo¾ité + nauèi» sa programova» v PHP výhradne za pomoci tohto manuálu. Miest toho + si vyhµadajte texty, ktoré sú viac orientované pre zaèiatoèníkov. Alebo + nejakú knihu, tie¾ pozri zoznam kníh súvisiacich s PHP na <ulink url="&url.php.books;">&url.php.books;</ulink>. </para> <para> 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;">Stránke podpory PHP.net</ulink>. - Okrem toho, na - <ulink url="&url.php.links;">Stránke odkazov PHP.net</ulink> je zoznam webových - stránok urèených PHP èlánkom, diskusným fóram a galériám kódov. + aspektoch programovania v PHP. Ak ste uviazli pri probléme, zvá¾te + vyu¾itie týchto mailing listov. Pre mo¾nosti podpory, vrátane mailing + listov, pozri <ulink url="&url.php.support;">Stránku podpory PHP.net</ulink>. + Okrem toho existuje zoznam web stránok venovaných PHP èlánkom, fóram + a galériam kódov na <ulink url="&url.php.links;">Stránke odkazov PHP.net</ulink> . </para> </sect1> <sect1 id="about.howtohelp"> <title>Ako pomôc» pri zlep¹ovaní dokumentácie</title> <para> - Sú tri spôsoby ako mô¾ete pomôc» zlep¹i» túto dokumentáciu. + Sú tri spôsoby ako ka¾dý mô¾e pomôc» zlep¹i» túto dokumentáciu. </para> <para> - Ak v tomto manuáli nájdete chyby, i v inom jazyku, prosím hláste ich + Ak sa v tomto manuáli nájdu 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 tam tie¾ hlási» - problémy, ktoré súvisia so ¹pecifickým formátom manuálu. + Klasifikujte bug ako "Documentation Problem". V¹etky problémy vz»ahujúce sa + k manuálu, vrátane tých súvisiacich s formátmi manuálu, by sa mali posiela» + ako správy o chybách (bug report). </para> <note> <para> - Prosím, nezneu¾ívajte bug systém ¾iadaním o pomoc. Namiesto toho pou¾ívajte - skôr spomenuté mailing listy alebo stránky komunity. + Prosím, nezneu¾ívajte bug systém ¾iadaním o pomoc. + Namiesto toho, pou¾ite jednu z mnohých + <ulink url="&url.php.support;">mo¾ností podpory</ulink>. </para> </note> <para> @@ -324,16 +340,17 @@ <link linkend="about.notes">'O príspevkoch u¾ívateµov'</link> tejto prílohy. </para> <para> - 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>. + PHP manuál je prelo¾ený do mnohých jazykov. Znalos» angliètiny a + cudzieho jazyka dáva priestor pre ïal¹í spôsob ako pomôc» zlep¹i» PHP + manuál, a to prácou s prekladateµským tímov. Pre informácie ako zaèa» + nový preklad, alebo ako pomôc» momentálne prekladanej verzii, prosím + èitajte <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>. </para> <para> - PHP Dokoumentaèný Projekt má IRC kanál, kde mô¾ete prís» - a pokeca» si s autormi manuálu alebo nájs» nejaké aspekty - manuálu, s ktorými mo¾no potrebujete pomôc» Je to - <literal>#phpdoc</literal> na <literal>irc.freenode.net</literal>. + Dokumentaèný Projekt PHP má IRC kanál, kde sa zdr¾iavajú + autori. Nav¹tívte <literal>#phpdoc</literal> na + <literal>irc.freenode.net</literal> a diskutujte o spôsoboch zlep¹enia + PHP dokumentácie. </para> </sect1> @@ -349,7 +366,7 @@ pre úpravu a formátovanie. </para> <para> - Pou¾ívanie <acronym>XML</acronym> ako zdrojového formátu nám + Pou¾ívanie <acronym>XML</acronym> ako zdrojového formátu 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> @@ -364,17 +381,10 @@ 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>. - Kvôli technickým dôvodom nemusia by» niektoré formáty dostupné. - </para> - <para> - 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>. + PHP manuál je generovaný vo viacerých jazykoch a formátoch, pozri + <ulink url="&url.php.docs;">&url.php.docs;</ulink> pre ïal¹ie detaily. + Zdrojový kód <acronym>XML</acronym> je mo¾né stiahnú» z CVS a + prezrie» na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. Dokumentácia je ulo¾ená v module <literal>phpdoc</literal>. </para> </sect1> @@ -393,20 +403,21 @@ ¥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. + <emphasis>Nepou¾ívajú</emphasis> generované verzie (ako + <acronym>HTML</acronym> alebo prostý text) nakoµko je to build systém, + ktorý sa stará o preklad z <acronym>XML</acronym> do formátu zrozumiteµného + pre µudí. </para> <note> <para> - Ak by ste sa chceli podiela» na prekladaní dokumentácie do vá¹ho - rodného jazyka, prosím, kontaktujte translation/documentation team + Ak chcete pomôc» s prekladom dokumentácie, + 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>. 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. + preuká¾te záujem o prekladanie manuálu a ozve sa vám niekto, kto + a poradí ako zaèa» s preklad do nového jazyka alebo ako skontaktova» + existujúci tím pre ¾iadaný jazyk. </para> </note> <para>