cvs: phpdoc-cs /appendices about.xml
| From: | Lukas Jelinek | Date: | Mon, 15 May 2006 21:07:14 +0000 |
| Subject: | cvs: phpdoc-cs /appendices about.xml | ||
| Groups: | php.doc.cs | ||
| Request: | Send a blank email to doc-cs+get-170@lists.php.net to get a copy of this message | ||
luk Mon May 15 21:07:14 2006 UTC
Modified files:
/phpdoc-cs/appendices about.xml
Log:
EN -> CS synchronization
http://cvs.php.net/viewcvs.cgi/phpdoc-cs/appendices/about.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-cs/appendices/about.xml diff -u phpdoc-cs/appendices/about.xml:1.3 phpdoc-cs/appendices/about.xml:1.4 --- phpdoc-cs/appendices/about.xml:1.3 Sat Nov 13 20:46:23 2004 +++ phpdoc-cs/appendices/about.xml Mon May 15 21:07:14 2006 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.36 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.43 Maintainer: luk Status: ready --> <appendix id="about"> <title>O tomto manuálu</title> @@ -18,9 +18,9 @@ </para> </note> <para> - Manuál mù¾ete èíst on-line na <ulink url="&url.php;"> &url.php;</ulink> - a mnoha zrcadlech. Pro zaji¹tìní nejrychlej¹ího pøístupu byste si mìli - vybrat zrcadlo umístìné nejblí¾e k vám. Mù¾ete si prohlí¾et manuál v + Manuál si lze pøeèíst on-line na <ulink url="&url.php;"> &url.php;</ulink> + a mnoha zrcadlech. Pro nejrychlej¹í pøístup byste si mìli + vybrat zrcadlo umístìné co nejblí¾e k vám. HTML verze manuálu existuje v "holém" HTML formátu (vhodném pro tisk) nebo v HTML formátu integrujícím manuál do vzhledu a chování samotných stránek PHP. </para> @@ -28,23 +28,26 @@ Dvìma podstatnými výhodami on-line formátù manuálu oproti vìt¹inì off-line formátù je integrace <link linkend="about.notes">u¾ivatelských poznámek</link> a <ulink url="&url.php.urlhowto;">URL odkazù</ulink>, které - mù¾ete pou¾ít k rychlému získání po¾adovaní èástí manuálu. Oèividnou - nevýhodou je, ¾e k prohlí¾ení této verze manuálu musíte být on-line. + lze pou¾ít k rychlému pøístupu k po¾adovaným èástem manuálu. Oèividnou + nevýhodou je, ¾e k prohlí¾ení této verze manuálu nutno být on-line. </para> <para> Existuje více off-line formátù manuálu a formát pro vás nejvhodnìj¹í - závisí na tom, jaký operaèní systém pou¾íváte a na va¹em osobním stylu + závisí na pou¾itém operaèním systému a na osobním stylu ètení. Pro informaci o tom, jak je manuál generován v tolika formátech, si pøeètìte sekci <link linkend="about.generate">'Jak generujeme - formáty'</link> v dodatcích. + formáty'</link> v tomto dodatku. </para> <para> Pro nejvíce platforem se hodí manuál v HTML a jako prostý text. HTML formát je poskytován jak jako jediný HTML soubor, tak jako balíèek souborù podle jednotlivých sekcí (co¾ ve výsledku znamená kolekci tisícù souborù). Tyto verze poskytujeme komprimované, k získání souborù - z archivù budete potøebovat nìjaký dekompresní nástroj. + z archivù je potøeba nìjaký dekompresní nástroj. </para> + + <!-- + PDF momentálnì není k dispozici. Ale jednoho dne snad bude. <para> Jiným populárním platformnì nezávislým formátem, a také formátem nejvhodnìj¹ím pro tisk, je PDF (známý také jako Adobe Acrobat). Ale @@ -57,13 +60,8 @@ stáhnout <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. </para> </note> - <para> - Pro vlastníky handheldù (Palm kompatibilních) jsou ideální formáty - Palm document a iSilo. Mù¾ete si pøinést svùj handheld do práce a pou¾ít - prohlí¾eè formátu <ulink url="&url.palm.doc;">DOC</ulink> nebo - <ulink url="&url.palm.isilo;">iSilo</ulink> k oprá¹ení znalostí PHP nebo - jako rychlou pøíruèku. - </para> + --> + <para> Pro platformu Windows je k dispozici verze <productname>Windows HTML Help</productname> pro pou¾ití s aplikací @@ -89,7 +87,7 @@ U¾ivatelské poznámky hrají dùle¾itou roli ve vývoji tohoto manuálu. Umo¾nìním ètenáøùm manuálu pøidávat pøíklady a dal¹í vysvìtlení pøímo z jejich prohlí¾eèe jsme schopni zabudovat zpìtnou vazbu do hlavního - textu manuálu. A ne¾ jsou poznámky zpracovány, jsou vidìt v podobì, + textu manuálu. A ne¾ jsou poznámky zpracovány, mohou být vidìt v podobì, v jaké je u¾ivatelé poslali, v on-line (a nìkterých off-line) formátech. </para> <note> @@ -115,7 +113,7 @@ <para> Ka¾dá funkce v manuálu je pro rychlou referenci zdokumentována. Kdy¾ víte, jak èíst a chápat tyto texty, nauèíte se PHP mnohem snadnìji. Namísto - spoléhání na pøíklady nebo na vystøihování/vkládání, budete chtít vìdìt, + spoléhání na pøíklady nebo na vystøihování/vkládání, by mìl ka¾dý vìdìt, jak èíst definice (prototypy) funkcí. Nu¾e, zaènìme: </para> <note> @@ -135,16 +133,18 @@ <function>strlen</function>: </para> <para> - <screen> + <screen role="html"> +<![CDATA[ strlen (PHP 3, PHP 4, PHP 5) -strlen -- Zjistí délku øetìzce +strlen -- Vrací délku øetìzce Popis int strlen ( string str ) Vrací délku øetìzce. +]]> </screen> </para> <para> @@ -202,7 +202,9 @@ </para> <para> <screen> +<![CDATA[ návratový typ název funkce ( typ parametru název parametru ) +]]> </screen> </para> <para> @@ -210,8 +212,10 @@ Prototy pak vypadá následovnì: </para> <para> - <screen> + <screen> +<![CDATA[ bool in_array ( mixed needle, array haystack [, bool strict]) +]]> </screen> </para> <para> @@ -241,8 +245,10 @@ jako pøíklad funkci <function>html_entity_decode</function>: </para> <para> - <screen> + <screen> +<![CDATA[ (PHP 4 >= 4.3.0, PHP 5) +]]> </screen> </para> <para> @@ -261,11 +267,12 @@ </para> <para> Mù¾ete najít kusy dokumentace pro CVS verzi PHP, co¾ v¾dycky znamená - nejpozdìj¹í vývojovou verzi dostupnou pøes systém správy verzí CVS. + nejpozdìj¹í vývojovou verzi dostupnou pøes systém správy verzí CVS + nebo jako <ulink url="&url.php.snapshots;">snapshot</ulink> Nejste-li vývojáø samotného PHP a netrpíte posedlostí pou¾ívat nejpozdìj¹í vývojovou verzi PHP, mo¾nosti oznaèené jako "dostupné v CVS" pro vás nejsou dostupné. Tyto mo¾nosti v¹ak budou pravdìpodobnì dostupné - v pøí¹tí stabilní verzi PHP. Chcete-li stáhnout CVS verzi, podívejte se + v pøí¹tí stabilní verzi PHP. Pro sta¾ení CVS verze se podívejte na stránku o <ulink url="&url.php.anoncvs;">anonymním CVS pøístupu</ulink>. </para> <para> @@ -274,6 +281,12 @@ Vìt¹inou to není chyba v dokumentaci. Èasto se pøidává vysvìtlení mo¾ností, které v aktuální vydané verzi nejsou dostupné, ale budou dostupné ve známe budoucí verzi PHP. + Do PHP se nové vlastnosti pøidávají typicky pouze ve "velkých" (major) + verzích, jinak se pouze opravují chyby. Ve formátu A.B.C znamená nová + major verze zvý¹ení èísla A nebo B, kde¾to minor verze zvy¹uje èíslo C. + Je napø. neobvyklé, aby byla vlastnost dokumenentována jako dostupná + od verze PHP x.1.x, kdy¾ poslední verze je x.0.x. Nezapomeòte také, + ¾e manuál je psán v pøítomném, nikoli budoucím èase. </para> </sect1> @@ -281,19 +294,18 @@ <title>Jak najít více informací o PHP</title> <para> Tento manuál se nepokou¹í poskytovat instrukce o obecných programovacích - technikách. Pokud jste úplnì èerstvý programátor nebo stále je¹tì - zaèáteèník, mù¾e vám pøijít obtí¾né nauèit se programovat v PHP pouze podle - tohoto manuálu. Mù¾ete chtít hledat texty více orientované na zaèáteèníky. - Zde je seznam knih týkajících se PHP: + technikách. Úplnì èerstvému programátorovi, nebo stále je¹tì + zaèáteèníkovi, se mù¾e zdát obtí¾né nauèit se programovat v PHP pouze podle + tohoto manuálu. Proto je lep¹í místo toho hledat text více orientovaný na zaèáteèníky. + Nebo knihu, viz také seznam knih týkajících se PHP: <ulink url="&url.php.books;">&url.php.books;</ulink>. </para> <para> Existuje mnoho aktivních e-mailových diskusních skupin pro diskusi - o v¹ech aspektech programování v PHP. Pokud máte problém, pro který - nmù¾ete najít øe¹ení, mohl by vám pomoci nìkdo z tìchto skupin. Seznam - diskusních skupin najdete na - <ulink url="&url.php.support;">&url.php.support;</ulink>, stejnì tak i - odkazy na archivy tìchto skupin a jiné on-line zdroje. Dále, + o v¹ech aspektech programování v PHP. Pøi problémech zva¾te pou¾ití + tìchto diskusních skupin. Mo¾nosti podpory, vèetnì diskusních skupin, + jsou k dispozici na + <ulink url="&url.php.support;">&url.php.support;</ulink>. Dále, na <ulink url="&url.php.links;">&url.php.links;</ulink> je seznam stránek zamìøených na èlánky, fóra a galerie kódu pro PHP. </para> @@ -308,31 +320,35 @@ Pokud v manuálu najdete chyby (v kterémkoli jazyce), oznamte je prosím pomocí bug systému na <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. Klasifikujte chybu jako "Documentation Problem". Mù¾ete také poslat - problémy spojené s konkrétními manuálovými formáty zde. + problémy spojené s konkrétními manuálovými formáty zde. V¹echny problémy + spojené s dokumentací, vèetnì tìch souvisejících s formáty manuálu, + by se mìly posílat jako chybová hlá¹ení. </para> <note> <para> Nezneu¾ívejte prosím bug systém odesíláním ¾ádostí o pomoc. Pou¾ijte - namísto toho diskusní fórum nebo komunitní stránky, jak ji¾ bylo zmínìno. + namísto toho nìkterou z mnoha + <ulink url="&url.php.support;">mo¾ností podpory</ulink>. </para> </note> <para> - Pøi pøidávání poznámek mù¾ete poskytnout dodateèné pøíklady a vysvìtlení + Pøi pøidávání poznámek mohou u¾ivatelé poskytnout dodateèné pøíklady a vysvìtlení pro ostatní ètenáøe. Av¹ak neposílejte prosím pomocí tohoto anotaèního systému hlá¹ení o chybách. O anotacích se mù¾ete více dozvìdìt v èásti - <link linkend="about.notes">'O u¾ivatelských poznámkách'</link> tohoto - dodatku. + <link linkend="about.notes">'O u¾ivatelských poznámkách'</link>. </para> <para> - Umíte-li angliètinu a nìjaký cizí jazyk, mù¾ete také pomoci s pøeklady. + PHP manuál se pøekládá do mnoha jazykù. + Umíte-li angliètinu a nìjaký cizí jazyk, mù¾ete také pomoci zlep¹it + manuál prací v pøekladatelském týmu. Chcete-li zaèí nový pøeklad nebo pomoci s pøekladovým projektem, ètìte prosím <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>. </para> <para> - Dokumentaèní projekt PHP má IRC kanál, kam mù¾ete pøijít a mluvit - s autory manuálu, nebo najít nìjaké aspekty manuálu, se kterými mù¾ete - pomoci. Je to - <literal>#phpdoc</literal> na <literal>irc.freenode.net</literal>. + Dokumentaèní projekt PHP má IRC kanál, kde se zdr¾uje mnoho autorù + manuálu. Nav¹tivte + <literal>#phpdoc</literal> na <literal>irc.freenode.net</literal> + a diskutujte o cestách, jak zlep¹it dokumentaci PHP. </para> </sect1> @@ -348,7 +364,7 @@ pro údr¾bu a formátování. </para> <para> - Pou¾ití <acronym>XML</acronym> jako zdrojového formátu nám dává mo¾nost + Pou¾ití <acronym>XML</acronym> jako zdrojového formátu dává mo¾nost generovat mnoho výstupních formátù ze zdrojových souborù a udr¾ovat pouze jediný zdrojový dokument pro v¹echny formáty. Nástroji pou¾itými pro formátování <acronym>HTML</acronym> a @@ -362,18 +378,11 @@ PHP samotné pro dodateèné konverze a formátování. </para> <para> - Manuál si mù¾ete stáhnout v rùzných jazycích a formátech, vèetnì prostého - textu, prostého <acronym>HTML</acronym>, - <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo a - Windows HTML Help, z + Manuál se generuje v rùzných jazycích a formátech, viz <ulink url="&url.php.docs;">&url.php.docs;</ulink>. - Manuály jsou automaticky aktualizovány, pokud se jejich text zmìní. - </para> - <para> - Více informací o stahování zdrojového kódu dokumentace v - <acronym>XML</acronym> najdete na + Zdrojové kódy v <acronym>XML</acronym> lze stáhnout z CVS a prohlí¾et na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. Dokumentace je ulo¾ena - v modulu <literal>phpdoc</literal>. + v modulu <literal>phpdoc</literal> (èeská v <literal>phpdoc-cs</literal>). </para> </sect1> @@ -390,8 +399,8 @@ Lidé, kteøí dokumentaci pøekládají, vycházejí z <acronym>XML</acronym> zdrojového kódu dostupného na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> a pøekládají ho do svého mateøského jazyka. - <emphasis>Nepou¾ívají</emphasis> <acronym>HTML</acronym>, holý text nebo - ani <acronym>PDF</acronym> verzi. Je to sestavovací systém, který zajistí + <emphasis>Nepou¾ívají</emphasis> generované verze (jako <acronym>HTML</acronym> + nebo holý text). Je to sestavovací systém, který zajistí konverzi z <acronym>XML</acronym> do lidsky èitelných formátù. </para> <note> @@ -402,8 +411,8 @@ <ulink url="mailto:&email.php.doc.subscribe;">&email.php.doc.subscribe;</ulink>. Adresa konference je <literal>&email.php.doc;</literal>. Po¹lete zprávu, ve které uvedete, ¾e se zajímáte o pøekládání manuálu do nìjakého jazyka - a nìkdo vám odpoví. pomù¾e vám se zaèátkem nového pøekladu nebo kontaktovat - ji¾ aktivní dokumentaèní tým pro vá¹ jazyk. + a nìkdo vám odpoví. Pomù¾e vám se zaèátkem nového pøekladu nebo kontaktovat + ji¾ aktivní dokumentaèní tým pro zvolený jazyk. </para> </note> <para>
http://cvs.php.net/viewcvs.cgi/phpdoc-cs/appendices/about.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-cs/appendices/about.xml diff -u phpdoc-cs/appendices/about.xml:1.3 phpdoc-cs/appendices/about.xml:1.4 --- phpdoc-cs/appendices/about.xml:1.3 Sat Nov 13 20:46:23 2004 +++ phpdoc-cs/appendices/about.xml Mon May 15 21:07:14 2006 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.36 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.43 Maintainer: luk Status: ready --> <appendix id="about"> <title>O tomto manuálu</title> @@ -18,9 +18,9 @@ </para> </note> <para> - Manuál mù¾ete èíst on-line na <ulink url="&url.php;"> &url.php;</ulink> - a mnoha zrcadlech. Pro zaji¹tìní nejrychlej¹ího pøístupu byste si mìli - vybrat zrcadlo umístìné nejblí¾e k vám. Mù¾ete si prohlí¾et manuál v + Manuál si lze pøeèíst on-line na <ulink url="&url.php;"> &url.php;</ulink> + a mnoha zrcadlech. Pro nejrychlej¹í pøístup byste si mìli + vybrat zrcadlo umístìné co nejblí¾e k vám. HTML verze manuálu existuje v "holém" HTML formátu (vhodném pro tisk) nebo v HTML formátu integrujícím manuál do vzhledu a chování samotných stránek PHP. </para> @@ -28,23 +28,26 @@ Dvìma podstatnými výhodami on-line formátù manuálu oproti vìt¹inì off-line formátù je integrace <link linkend="about.notes">u¾ivatelských poznámek</link> a <ulink url="&url.php.urlhowto;">URL odkazù</ulink>, které - mù¾ete pou¾ít k rychlému získání po¾adovaní èástí manuálu. Oèividnou - nevýhodou je, ¾e k prohlí¾ení této verze manuálu musíte být on-line. + lze pou¾ít k rychlému pøístupu k po¾adovaným èástem manuálu. Oèividnou + nevýhodou je, ¾e k prohlí¾ení této verze manuálu nutno být on-line. </para> <para> Existuje více off-line formátù manuálu a formát pro vás nejvhodnìj¹í - závisí na tom, jaký operaèní systém pou¾íváte a na va¹em osobním stylu + závisí na pou¾itém operaèním systému a na osobním stylu ètení. Pro informaci o tom, jak je manuál generován v tolika formátech, si pøeètìte sekci <link linkend="about.generate">'Jak generujeme - formáty'</link> v dodatcích. + formáty'</link> v tomto dodatku. </para> <para> Pro nejvíce platforem se hodí manuál v HTML a jako prostý text. HTML formát je poskytován jak jako jediný HTML soubor, tak jako balíèek souborù podle jednotlivých sekcí (co¾ ve výsledku znamená kolekci tisícù souborù). Tyto verze poskytujeme komprimované, k získání souborù - z archivù budete potøebovat nìjaký dekompresní nástroj. + z archivù je potøeba nìjaký dekompresní nástroj. </para> + + <!-- + PDF momentálnì není k dispozici. Ale jednoho dne snad bude. <para> Jiným populárním platformnì nezávislým formátem, a také formátem nejvhodnìj¹ím pro tisk, je PDF (známý také jako Adobe Acrobat). Ale @@ -57,13 +60,8 @@ stáhnout <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. </para> </note> - <para> - Pro vlastníky handheldù (Palm kompatibilních) jsou ideální formáty - Palm document a iSilo. Mù¾ete si pøinést svùj handheld do práce a pou¾ít - prohlí¾eè formátu <ulink url="&url.palm.doc;">DOC</ulink> nebo - <ulink url="&url.palm.isilo;">iSilo</ulink> k oprá¹ení znalostí PHP nebo - jako rychlou pøíruèku. - </para> + --> + <para> Pro platformu Windows je k dispozici verze <productname>Windows HTML Help</productname> pro pou¾ití s aplikací @@ -89,7 +87,7 @@ U¾ivatelské poznámky hrají dùle¾itou roli ve vývoji tohoto manuálu. Umo¾nìním ètenáøùm manuálu pøidávat pøíklady a dal¹í vysvìtlení pøímo z jejich prohlí¾eèe jsme schopni zabudovat zpìtnou vazbu do hlavního - textu manuálu. A ne¾ jsou poznámky zpracovány, jsou vidìt v podobì, + textu manuálu. A ne¾ jsou poznámky zpracovány, mohou být vidìt v podobì, v jaké je u¾ivatelé poslali, v on-line (a nìkterých off-line) formátech. </para> <note> @@ -115,7 +113,7 @@ <para> Ka¾dá funkce v manuálu je pro rychlou referenci zdokumentována. Kdy¾ víte, jak èíst a chápat tyto texty, nauèíte se PHP mnohem snadnìji. Namísto - spoléhání na pøíklady nebo na vystøihování/vkládání, budete chtít vìdìt, + spoléhání na pøíklady nebo na vystøihování/vkládání, by mìl ka¾dý vìdìt, jak èíst definice (prototypy) funkcí. Nu¾e, zaènìme: </para> <note> @@ -135,16 +133,18 @@ <function>strlen</function>: </para> <para> - <screen> + <screen role="html"> +<![CDATA[ strlen (PHP 3, PHP 4, PHP 5) -strlen -- Zjistí délku øetìzce +strlen -- Vrací délku øetìzce Popis int strlen ( string str ) Vrací délku øetìzce. +]]> </screen> </para> <para> @@ -202,7 +202,9 @@ </para> <para> <screen> +<![CDATA[ návratový typ název funkce ( typ parametru název parametru ) +]]> </screen> </para> <para> @@ -210,8 +212,10 @@ Prototy pak vypadá následovnì: </para> <para> - <screen> + <screen> +<![CDATA[ bool in_array ( mixed needle, array haystack [, bool strict]) +]]> </screen> </para> <para> @@ -241,8 +245,10 @@ jako pøíklad funkci <function>html_entity_decode</function>: </para> <para> - <screen> + <screen> +<![CDATA[ (PHP 4 >= 4.3.0, PHP 5) +]]> </screen> </para> <para> @@ -261,11 +267,12 @@ </para> <para> Mù¾ete najít kusy dokumentace pro CVS verzi PHP, co¾ v¾dycky znamená - nejpozdìj¹í vývojovou verzi dostupnou pøes systém správy verzí CVS. + nejpozdìj¹í vývojovou verzi dostupnou pøes systém správy verzí CVS + nebo jako <ulink url="&url.php.snapshots;">snapshot</ulink> Nejste-li vývojáø samotného PHP a netrpíte posedlostí pou¾ívat nejpozdìj¹í vývojovou verzi PHP, mo¾nosti oznaèené jako "dostupné v CVS" pro vás nejsou dostupné. Tyto mo¾nosti v¹ak budou pravdìpodobnì dostupné - v pøí¹tí stabilní verzi PHP. Chcete-li stáhnout CVS verzi, podívejte se + v pøí¹tí stabilní verzi PHP. Pro sta¾ení CVS verze se podívejte na stránku o <ulink url="&url.php.anoncvs;">anonymním CVS pøístupu</ulink>. </para> <para> @@ -274,6 +281,12 @@ Vìt¹inou to není chyba v dokumentaci. Èasto se pøidává vysvìtlení mo¾ností, které v aktuální vydané verzi nejsou dostupné, ale budou dostupné ve známe budoucí verzi PHP. + Do PHP se nové vlastnosti pøidávají typicky pouze ve "velkých" (major) + verzích, jinak se pouze opravují chyby. Ve formátu A.B.C znamená nová + major verze zvý¹ení èísla A nebo B, kde¾to minor verze zvy¹uje èíslo C. + Je napø. neobvyklé, aby byla vlastnost dokumenentována jako dostupná + od verze PHP x.1.x, kdy¾ poslední verze je x.0.x. Nezapomeòte také, + ¾e manuál je psán v pøítomném, nikoli budoucím èase. </para> </sect1> @@ -281,19 +294,18 @@ <title>Jak najít více informací o PHP</title> <para> Tento manuál se nepokou¹í poskytovat instrukce o obecných programovacích - technikách. Pokud jste úplnì èerstvý programátor nebo stále je¹tì - zaèáteèník, mù¾e vám pøijít obtí¾né nauèit se programovat v PHP pouze podle - tohoto manuálu. Mù¾ete chtít hledat texty více orientované na zaèáteèníky. - Zde je seznam knih týkajících se PHP: + technikách. Úplnì èerstvému programátorovi, nebo stále je¹tì + zaèáteèníkovi, se mù¾e zdát obtí¾né nauèit se programovat v PHP pouze podle + tohoto manuálu. Proto je lep¹í místo toho hledat text více orientovaný na zaèáteèníky. + Nebo knihu, viz také seznam knih týkajících se PHP: <ulink url="&url.php.books;">&url.php.books;</ulink>. </para> <para> Existuje mnoho aktivních e-mailových diskusních skupin pro diskusi - o v¹ech aspektech programování v PHP. Pokud máte problém, pro který - nmù¾ete najít øe¹ení, mohl by vám pomoci nìkdo z tìchto skupin. Seznam - diskusních skupin najdete na - <ulink url="&url.php.support;">&url.php.support;</ulink>, stejnì tak i - odkazy na archivy tìchto skupin a jiné on-line zdroje. Dále, + o v¹ech aspektech programování v PHP. Pøi problémech zva¾te pou¾ití + tìchto diskusních skupin. Mo¾nosti podpory, vèetnì diskusních skupin, + jsou k dispozici na + <ulink url="&url.php.support;">&url.php.support;</ulink>. Dále, na <ulink url="&url.php.links;">&url.php.links;</ulink> je seznam stránek zamìøených na èlánky, fóra a galerie kódu pro PHP. </para> @@ -308,31 +320,35 @@ Pokud v manuálu najdete chyby (v kterémkoli jazyce), oznamte je prosím pomocí bug systému na <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. Klasifikujte chybu jako "Documentation Problem". Mù¾ete také poslat - problémy spojené s konkrétními manuálovými formáty zde. + problémy spojené s konkrétními manuálovými formáty zde. V¹echny problémy + spojené s dokumentací, vèetnì tìch souvisejících s formáty manuálu, + by se mìly posílat jako chybová hlá¹ení. </para> <note> <para> Nezneu¾ívejte prosím bug systém odesíláním ¾ádostí o pomoc. Pou¾ijte - namísto toho diskusní fórum nebo komunitní stránky, jak ji¾ bylo zmínìno. + namísto toho nìkterou z mnoha + <ulink url="&url.php.support;">mo¾ností podpory</ulink>. </para> </note> <para> - Pøi pøidávání poznámek mù¾ete poskytnout dodateèné pøíklady a vysvìtlení + Pøi pøidávání poznámek mohou u¾ivatelé poskytnout dodateèné pøíklady a vysvìtlení pro ostatní ètenáøe. Av¹ak neposílejte prosím pomocí tohoto anotaèního systému hlá¹ení o chybách. O anotacích se mù¾ete více dozvìdìt v èásti - <link linkend="about.notes">'O u¾ivatelských poznámkách'</link> tohoto - dodatku. + <link linkend="about.notes">'O u¾ivatelských poznámkách'</link>. </para> <para> - Umíte-li angliètinu a nìjaký cizí jazyk, mù¾ete také pomoci s pøeklady. + PHP manuál se pøekládá do mnoha jazykù. + Umíte-li angliètinu a nìjaký cizí jazyk, mù¾ete také pomoci zlep¹it + manuál prací v pøekladatelském týmu. Chcete-li zaèí nový pøeklad nebo pomoci s pøekladovým projektem, ètìte prosím <ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink>. </para> <para> - Dokumentaèní projekt PHP má IRC kanál, kam mù¾ete pøijít a mluvit - s autory manuálu, nebo najít nìjaké aspekty manuálu, se kterými mù¾ete - pomoci. Je to - <literal>#phpdoc</literal> na <literal>irc.freenode.net</literal>. + Dokumentaèní projekt PHP má IRC kanál, kde se zdr¾uje mnoho autorù + manuálu. Nav¹tivte + <literal>#phpdoc</literal> na <literal>irc.freenode.net</literal> + a diskutujte o cestách, jak zlep¹it dokumentaci PHP. </para> </sect1> @@ -348,7 +364,7 @@ pro údr¾bu a formátování. </para> <para> - Pou¾ití <acronym>XML</acronym> jako zdrojového formátu nám dává mo¾nost + Pou¾ití <acronym>XML</acronym> jako zdrojového formátu dává mo¾nost generovat mnoho výstupních formátù ze zdrojových souborù a udr¾ovat pouze jediný zdrojový dokument pro v¹echny formáty. Nástroji pou¾itými pro formátování <acronym>HTML</acronym> a @@ -362,18 +378,11 @@ PHP samotné pro dodateèné konverze a formátování. </para> <para> - Manuál si mù¾ete stáhnout v rùzných jazycích a formátech, vèetnì prostého - textu, prostého <acronym>HTML</acronym>, - <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo a - Windows HTML Help, z + Manuál se generuje v rùzných jazycích a formátech, viz <ulink url="&url.php.docs;">&url.php.docs;</ulink>. - Manuály jsou automaticky aktualizovány, pokud se jejich text zmìní. - </para> - <para> - Více informací o stahování zdrojového kódu dokumentace v - <acronym>XML</acronym> najdete na + Zdrojové kódy v <acronym>XML</acronym> lze stáhnout z CVS a prohlí¾et na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. Dokumentace je ulo¾ena - v modulu <literal>phpdoc</literal>. + v modulu <literal>phpdoc</literal> (èeská v <literal>phpdoc-cs</literal>). </para> </sect1> @@ -390,8 +399,8 @@ Lidé, kteøí dokumentaci pøekládají, vycházejí z <acronym>XML</acronym> zdrojového kódu dostupného na <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> a pøekládají ho do svého mateøského jazyka. - <emphasis>Nepou¾ívají</emphasis> <acronym>HTML</acronym>, holý text nebo - ani <acronym>PDF</acronym> verzi. Je to sestavovací systém, který zajistí + <emphasis>Nepou¾ívají</emphasis> generované verze (jako <acronym>HTML</acronym> + nebo holý text). Je to sestavovací systém, který zajistí konverzi z <acronym>XML</acronym> do lidsky èitelných formátù. </para> <note> @@ -402,8 +411,8 @@ <ulink url="mailto:&email.php.doc.subscribe;">&email.php.doc.subscribe;</ulink>. Adresa konference je <literal>&email.php.doc;</literal>. Po¹lete zprávu, ve které uvedete, ¾e se zajímáte o pøekládání manuálu do nìjakého jazyka - a nìkdo vám odpoví. pomù¾e vám se zaèátkem nového pøekladu nebo kontaktovat - ji¾ aktivní dokumentaèní tým pro vá¹ jazyk. + a nìkdo vám odpoví. Pomù¾e vám se zaèátkem nového pøekladu nebo kontaktovat + ji¾ aktivní dokumentaèní tým pro zvolený jazyk. </para> </note> <para>