cvs: peardoc /pl language-defs.ent language-snippets.ent preface.xml

adamg Mon Dec 20 11:48:36 2004 EDT Added files: /peardoc/pl language-defs.ent language-snippets.ent preface.xml Log: - initial commit

http://cvs.php.net/co.php/peardoc/pl/language-defs.ent?r=1.1&p=1 Index: peardoc/pl/language-defs.ent +++ peardoc/pl/language-defs.ent <!-- $Revision: 1.1 $ --> <!ENTITY PEARManual "Podrêcznik PEAR"> <!ENTITY Date "Data:"> <!ENTITY AboutPEAR "O PEAR"> <!ENTITY DevelopersGuide "Podrêcznik Developera"> <!ENTITY NewMaintainersGuide "Nowy Podrêcznik Opiekuna"> <!ENTITY LanguageReference "Powi±zania jêzyka"> <!ENTITY Features "Cechy"> <!ENTITY PEAR "PEAR: Repozytorium Rozszerzeñ i Aplikacji."> <!ENTITY Packages "Pakiety"> <!ENTITY Pecl "Pakiety PECL"> <!ENTITY Core "Podstawowe komponenty"> <!ENTITY Contributing "Do³±czanie do PEAR"> http://cvs.php.net/co.php/peardoc/pl/language-snippets.ent?r=1.1&p=1 Index: peardoc/pl/language-snippets.ent +++ peardoc/pl/language-snippets.ent <!-- $Revision: 1.1 $ --> <!ENTITY warn.experimental '<warning><simpara>Ten modu³ jest w fazie <emphasis> EKSPERYMENTALNEJ</emphasis>. Oznacza to, ¿e zachowanie funkcji, ich nazwy, czy w praktyce WSZYSTKO opisane tutaj mo¿e zmieniæ siê w przysz³o¶ci BEZ POINFORMOWANIA. B±d¼ ostrze¿ony i u¿ywaj tego modu³y na w³asne ryzyko.</simphara> </warning>'> <!ENTITY warn.experimental.func '<warning><simpara>Ta funkcja jest <emphasis> EKSPERYMENTALNA</emphasis>. Oznacza to, ¿e zachowanie funkcji, jej nazwa, czy w praktyce WSZYSTKO opisane tutaj mo¿e zmieniæ siê w przysz³o¶ci BEZ POINFORMOWANIA. B±d¼ ostro¿ny i u¿ywaj tej funkcji na w³asne ryzyko.</simphara> </warning>'> <!ENTITY warn.undocumented.func '<warning><simpara>Ta funkcja jest obecnie nieudokumentowana.</simpara></warning>'> <!ENTITY warn.undocumented.method '<warning><simpara>Ta metoda jest obecnie nieudokumentowana.</simpara></warning>'> <!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs its result directly to the browser, you can use the <ulink url="&url.php.lookup;outcontrol">output-control functions</ulink> to capture the output of this function, and save it - for example - in a <type>string</type>.</simpara></tip>'> <!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs its result directly to the browser, you can use the <ulink url="&url.php.lookup;outcontrol">output-control functions</ulink> to capture the output of this function, and save it - for example - in a <type>string</type>.</simpara></tip>'> <!ENTITY return.success 'Zwraca &true; w przypadku powodzenia, &false; w przypadku niepowodzenia.'> <!ENTITY return.success-pearerror 'Zwraca &true; w przypadku powodzenia, <classname>PEAR_Error</classname> w przypadku niepowodzenia.'> <!ENTITY return.falseproblem '<warning><simpara>Ta funkcja mo¿e zwróciæ &false;, ale mo¿e równie¿ zwróciæ warto¶æ obliczan± do &false; w prostej konstrukcji if. U¿yj <ulink url="&url.php.lookup;operators.comparison">operatora === </ulink> do sprawdzenia warto¶ci zwracanej przez tê funkcjê.</simpara></warning>'> <!ENTITY link.coding-standards '<link linkend="standards">Standardy kodowania </link> PEAR'> <!ENTITY note.canstatic '<simpara>Ta funkcja mo¿e byæ wywo³ana statycznie.</simpara>'> <!ENTITY note.shouldstatic '<simpara>Ta funkcja powinna byæ wywo³ana statycznie.</simpara>'> <!ENTITY note.notstatic '<simpara>Ta funkcja nie mo¿e byæ wywo³ana statycznie.</simpara>'> <!ENTITY note.deprecated '<warning><para>Ta funkcja jest <emphasis> niezalecana</emphasis>. Oznacza to, ¿e przysz³e wersje tego pakietu mog± jej ju¿ nie wspieraæ.</para></warning>'> <!ENTITY title.desc '<title>Opis</title>'> <!ENTITY title.param '<title>Parametr</title>'> <!ENTITY title.deprecated '<title>Niezalecana</title>'> <!ENTITY title.returns '<title>Zwracana warto¶æ</title>'> <!ENTITY title.throws '<title>Wyj±tki</title>'> <!ENTITY title.throws.errortable 'Mo¿liwe warto¶ci PEAR_Error'> <!ENTITY title.note '<title>Uwagi</title>'> <!ENTITY title.example '<title>Przyk³ad</title>'> <!ENTITY title.see '<title>Zobacz</title>'> <!ENTITY title.constants 'Sta³e'> <!ENTITY type.bool '<type>boolean</type>'> <!ENTITY type.int '<type>integer</type>'> <!ENTITY type.float '<type>float</type>'> <!ENTITY type.string '<type>string</type>'> <!ENTITY type.mixed '<type>mixed</type>'> <!ENTITY type.object '<type>object</type>'> <!ENTITY type.res '<type>resource</type>'> <!ENTITY type.array '<type>array</type>'> <!ENTITY type.resource '<type>resource</type>'> <!ENTITY type.void '<type>void</type>'> <!ENTITY purpose.preconstants 'predefiniowane sta³e'> <!ENTITY pdevrel '(powi±zane z developerem pakietu)'> <!ENTITY notdocumented '<para>Ten pakiet nie jest jeszcze udokumentowany.</para>'> http://cvs.php.net/co.php/peardoc/pl/preface.xml?r=1.1&p=1 Index: peardoc/pl/preface.xml +++ peardoc/pl/preface.xml <?xml version="1.0" encoding="iso-8859-2" ?> <!-- $Revision: 1.1 $ --> <preface id="preface"> <title>Przedmowa</title> <abstract> <simpara> <acronym>PEAR</acronym> Repozytorium Rozszerzeñ i Aplikacji PHP (PHP Extension and Application Repository). </simpara> </abstract> <sect1 id="about"> <title>O tym podrêczniku</title> <para> Ten podrêcznik jest napisany w <acronym>XML</acronym>, z u¿yciem <ulink url="&url.docbook.xml;">DocBook XML DTD</ulink> i <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Jêzyk Stylu Dokumentu oraz Specyfikacji Semantyki, ang. Document Style and Semantics Specification Language) do formatowania. Narzêdzia u¿yte do formatowania wersji <acronym>HTML</acronym> to <ulink url="&url.jade;">Jade</ulink>, napisane przez <ulink url="&url.jclark;">Jamesa Clarka</ulink> i <ulink url="&url.dbstyle;">Modularnych Arkuszy Stylów DocBook (The Modular DocBook StyleSheets)</ulink> napisane przez <ulink url="&url.nwalsh;">Normana Walsh</ulink>. </para> <para> Podstawowa struktura oparta jest na bardzo dobrze wykonanej pracy przez grupê dokumentalistów PHP. Przeczytaj dokument <ulink url="&url.php.manual.about;">O podrêczniku PHP</ulink> aby poznaæ wiêcej szczegó³ów. </para> </sect1> <sect1 id="struktura"> <title>Struktura podrêcznika</title> <para> Ten przewodnik wyja¶nia ogóln± strukturê, uk³ad i konwencje u¿yte w podrêczniku PEAR. Podrêcznik ten jest podzielony na sze¶æ g³ównych rozdzia³ów: </para> <para> <itemizedlist> <listitem> <para> <link linkend="about-pear">O PEAR</link> </para> <para> Ta sekcja zawiera ³agodne wprowadzenie w ¶wiat PEAR i to, co ma do zaoferowania. Zawarte s± ogólne informacje na temat instalowania i u¿ywania PEAR, pytania o wsparcie i odpowiedzi na najczê¶ciej zadawane pytania dotycz±ce PEAR. </para> </listitem> <listitem> <para> <link linkend="guide-developers">Podrêcznik Developerów</link> </para> <para> Ogólne informacje na temat rozwijania i wydawania pakietów PEAR. </para> </listitem> <listitem> <para> <link linkend="core">Podstawowe komponenty</link> </para> <para> Ta sekcja zawiera dokumentacjê na temat podstawowych klas PEAR. Te podstawowe koponenty s± podstaw± ka¿dej klasy w PEAR, a zrozumienie tych podstaw u³atwi u¿ycie biblioteki PEAR. Omówione tematy to miêdzy innymi baza &class.pear;, administracja PEAR, obs³uga b³êdów za pomoc± obiektu &class.pear-error; oraz komendy systemowe. Te klasy s± zazwyczaj dostarczanw wraz ze ¼ród³ami PHP. </para> </listitem> <listitem> <para> <link linkend="packages">Pakiety</link> </para> <para> Dostêpnych jest wiele pakietów PEAR a ich liczba wzrasta z dnia na dzieñ. Praktycznie ka¿dy pakiet jest udokumentowany, ale ma³o który jest dommy¶lnie instalowany. Informacje na temat instalowania klas PEAR w Twoim systemie znajdziesz w rozdziale <link linkend="installation">Instalacja</link>. </para> <para> Ka¿da udokumentowana klasa zawiera podstawow± dokumentacjê na temat publicznie dostêpnych funkcji. Mog± byæ tak¿e dodatkowe informacje takie jak wstêp, lista dostêpnych sta³ych, czy przyk³ady u¿ycia danego pakietu. Dodatkowe informacje mog± tak¿e siê znajdowaæ wewn±trz ¼róde³ danego pakietu. </para> <para> Opis ka¿dej funkcji mo¿e zaweiraæ niektóre lub wszystkie z poni¿szych elementów: <itemizedlist> <listitem> <para>Synopsis</para> <para> Pokazuje strukturê oraz prototyp funkcji. </para> </listitem> <listitem> <para>Opis</para> <para> Pokazuje opis danej funkcji (do czego s³u¿y). </para> </listitem> <listitem> <para>Parametry</para> <para> Opis ka¿dego z parametrów funkcji wraz z typem i nazw±. Wy¶wietlone s± zarówno wymagane jak i opcjonalne parametry. </para> </listitem> <listitem> <para>Zwraca</para> <para> Opis zwracanej warto¶ci, je¶li wykonanie funkcji zakoñczy siê pomy¶lnie. </para> </listitem> <listitem> <para>Wyj±tki</para> <para> Opis zwróconego obiektu <classname>PEAR_Error</classname> je¶li wykonanie funkcji nie powiod³o siê. </para> </listitem> <listitem> <para>Uwagi</para> <para> Dodatkowe informacje dotycz±ce danej funkcji. Przyk³adowa uwaga mo¿e dotyczyæ tego, czy funkcja mo¿e byæ wywo³ana statycznie. </para> </listitem> <listitem> <para>Zobacz</para> <para> Odno¶niki do pokrewnych funkcji lub pozycji podrêcznika. </para> </listitem> <listitem> <para>Przyk³ad</para> <para> Przyk³ad u¿ycia funkcji lub klasy. </para> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> <link linkend="pecl">Pakiety PECL</link> </para> <para> Pakiet PECL s± typowymi rozszerzeniami PHP napisanymi w C. Struktura dokumentacji powinna byæ identyczna z opisan± powy¿ej. </para> </listitem> <listitem> <para> <link linkend="contributing">Do³±czanie do PEAR</link> </para> <para> Zawiera informacje dotycz±c± tworzenia w³asnych pakietów PEAR. </para> </listitem> </itemizedlist> </para> </sect1> <sect1 id="authors"> <title>Autorzy i Wspó³pracownicy</title> <titleabbrev>Autorzy</titleabbrev> <para> Lista osób pomagaj±cych w opiece nad t± dokumentacj±. Je¶li chcia³by¶ siê skontaktowaæ z którymkolwiek z nich, napisz na adres <ulink url="mailto:&email.pear.doc;">&email.pear.doc;</ulink>. </para> &authors.list; <simpara> (W kolejno¶ci alfabetycznej.) </simpara> </sect1> </preface> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->