cvs: phpdoc-hu /appendices about.xml

From: Date: Sat, 12 Jun 2004 22:17:01 +0000
Subject: cvs: phpdoc-hu /appendices about.xml
Groups: php.doc.hu 
Request: Send a blank email to doc-hu+get-649@lists.php.net to get a copy of this message
bagilevi Sat Jun 12 18:17:01 2004 EDT Modified files: /phpdoc-hu/appendices about.xml Log: sync with En revision

http://cvs.php.net/diff.php/phpdoc-hu/appendices/about.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-hu/appendices/about.xml diff -u phpdoc-hu/appendices/about.xml:1.1 phpdoc-hu/appendices/about.xml:1.2 --- phpdoc-hu/appendices/about.xml:1.1 Wed Apr 28 04:24:14 2004 +++ phpdoc-hu/appendices/about.xml Sat Jun 12 18:17:01 2004 @@ -1,13 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.31 Maintainer: bagilevi Status: working --> -<!-- - TODO: add manual conventions section (eg. how to read - function usage parts, what is fixed width, what is - bold, what is linked - - add some tips about combining the versions (online- - offline), and using "http://anymirror.php.net/funcname" ---> +<!-- EN-Revision: 1.34 Maintainer: bagilevi Status: ready --> <appendix id="about"> <title>A kézikönyvrõl</title> @@ -26,16 +18,18 @@ </para> </note> <para> - Online módon a <ulink url="&url.php;">&url.php;</ulink> - címen olvashatod, valamint + Online módon a <ulink url="&url.php;">PHP.net honlapon</ulink> + olvashatod, valamint számos tükörszerveren. A legjobb teljesítmény elérése érdekében válaszd a hozzád legközelebb esõt. Olvashatod sima (nyomtatóbarát) HTML formátumban, vagy egy olyan HTML formátumban, amely illeszkedik a PHP weboldalának arculatához. </para> <para> - Az online kézikönyv elõnye a legtöbb offline formátum felett a - <link linkend="about.notes">felhasználói megjegyzések</link> jelenléte. + Az online kézikönyv két számottevõ elõnye a legtöbb offline formátum felett a + <link linkend="about.notes">felhasználói megjegyzések</link> jelenléte, + valamint a <ulink url="&url.php.urlhowto;">URL shortcut</ulink>-ok, amiket + arra használhatsz, hogy a kézikönyv egy kívánt oldalán gyorsan lekérd. Egy kézenfekvõ hátránya pedig az, hogy kapcsolódva kell lenned az Internetre, ha ezeket az online formátumokat akarod olvasni. </para> @@ -48,18 +42,18 @@ formátumokat'</link> címû részét. </para> <para> - A kézikönyv leginkább platformfüggetlen formátuma a HTML és a sima - szöveges (plain-text) változat. A HTML formátumnak két fajtája van: + A kézikönyv leginkább platformfüggetlen formátuma a HTML. + Ennek két fajtája van: az egyik egyetlen HTML állományból áll, a másikban pedig minden részhez tartozik egy állomány (ennek következménye egy sok ezer állományból - álló csomag). A HTML és a sima szöveges változatok bzip2-vel tömörített - tar fájlokként érhetõek el. + álló csomag). Ezek a változatok tömörítve érhetõek el, szükséged lesz + valamilyen kitömörítõ programra, hogy hozzájuss a HTML fájlokhoz. </para> <para> Egy másik platformfüggetlen formátum, amely leginkább alkalmas a nyomtatásra, a PDF (Adobe Acrobat-ként is ismert). Viszont mielõtt nagy sietve letöltenéd ezt a változatot és megnyomnád a Nyomtatás - feliratú gombot, figyelmeztetünk, hogy ez közel 2000 oldalas és + feliratú gombot, figyelmeztetünk, hogy ez tobb mint 2000 oldalas és folyamatosan módosul. </para> <note> @@ -72,7 +66,8 @@ </note> <para> A Palm-kompatibilis kéziszámítógépek tulajdonosai számára a - Palm dokumentum és az iSilo formátumok remekül használhatóak. + Palm dokumentum és az <productname>iSilo</productname> + formátumok remekül használhatóak. A napi utadra magaddal viheted a kéziszámítógépedet és használhatod a <ulink url="&url.palm.doc;">DOC</ulink> vagy @@ -81,23 +76,16 @@ hivatkozási pontként is használhatod. </para> <para> - Windows-os környezetben a kézikönyvnek a Windows HTML Help + Windows-os környezetben a kézikönyvnek a + <productname>Windows HTML Help</productname> verziója a HTML formátumnak az a változata, - ami használható a Windows HTML Help alkalmazással. + ami használható a <productname>Windows HTML Help</productname> alkalmazással. Ez a változat biztosít keresést a teljes szövegben, - egy teljes tárgymutatót, és könyvjelzõkezelést. + egy teljes tárgymutatót, és könyvjelzõkezelést. + Linux környezetre is léteznek CHM megjelenítõk: + <ulink url="&url.xchm;">xCHM</ulink>, + <ulink url="&url.gnochm;">GnoCHM</ulink> </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. - </para> - </note> - --> </sect1> <sect1 id="about.notes"> @@ -137,9 +125,10 @@ <sect1 id="about.prototypes"> <title>Hogyan olvassunk egy függvénydefiníciót (prototípust)</title> <para> - Minden függvény gyors referencia céljából van dokumentálva. - Ha tudod, hogyan kell olvasni és értelmezni a kézikönyvet, - sokkal könnyebben tudod használni a PHP-t. + A kézikönyvben szereplõ függvények gyors referencia céljából + vannak dokumentálva. + Ha tudod, hogyan kell olvasni és értelmezni a szöveget, + sokkal könnyebben tudod majd tanulni a PHP-t. Ahelyett, hogy megbíznál a példákban és a kivág/beszúr technikában, valószínûleg inkább azt szeretnéd tudni, hogyan olvasd függvénydefiníciókat (prototípusokat). Kezdjük is el: @@ -165,7 +154,7 @@ <screen> strlen -(PHP 3, PHP 4 >= 4.0.0) +(PHP 3, PHP 4, PHP 5) strlen -- A string hosszának lekérdezése Leírás @@ -195,10 +184,10 @@ </row> <row> <entry> - (PHP 3, PHP 4 >= 4.0.0) + (PHP 3, PHP 4, PHP 5) </entry> <entry> - A strlen() létezik PHP 3-ban és PHP 4-ben is. + A strlen() létezik PHP 3-ban, a PHP 4-ben és a PHP 5-ben is. </entry> </row> <row> @@ -228,17 +217,17 @@ A fenti függvénydefiníciót átírhatjuk egy általános formába: </para> <para> - <screen role="html"> + <screen> visszatérítési típus függvény neve ( paraméter típusa paraméter neve ) </screen> </para> <para> Sok függvény elfogad összetett paramétereket, mint például az -<function>in_array</function>. + <function>in_array</function>. A prototípusa a következõképpen néz ki: </para> <para> - <screen role="html"> + <screen> bool in_array ( mixed needle, array haystack [, bool strict]) </screen> </para> @@ -266,12 +255,26 @@ <parameter>strict</parameter> paraméter alapértelmezett értéke &false;. Nézd meg minden függvény oldalát, hogy lásd, hogy mûködik. </para> + <para> + Vannak függvények, amelyeknek összetetteb PHP verzióinformációval + vannak ellátva. Vegyük példának a + <function>html_entity_decode</function> fügvényt: + </para> + <para> + <screen> + (PHP 4 >= 4.3.0, PHP 5) + </screen> + </para> + <para> + Ez azt jelenti, hogy ez a függvény nem volt jelen a PHP 3-ban, + és csak a PHP 4.3.0 kiadás óta létezik. + </para> </sect1> <sect1 id="about.phpversions"> <title>Ebben a kézikönyvben dokumentált PHP verziók</title> <para> - Ez a dokumentáció a PHP 4-rõl tartalmaz információkat, + Ez a dokumentáció a PHP 4-rõl és a PHP 5-rõl tartalmaz információkat, valamint néhány kompatibilitási információval szolgál a PHP 3-ra vonatkozólag. A viselkedésmód, a visszatérési érték és egyéb változások a különbözõ PHP verziók között @@ -319,11 +322,11 @@ szemszögbõl történõ megtárgyalására. Ha elakadtál egy problémán, amelyre nem tudsz magadtól megoldást találni, kaphatsz segítséget valakitõl a levlisták segítségével. - A <ulink url="&url.php.support;">&url.php.support;</ulink> - címen találsz egy listát a levelezõlistákról és egyéb + A <ulink url="&url.php.support;">PHP.net support oldal</ulink>on + találsz egy listát a levelezõlistákról és egyéb segítséget nyújtó erõforrásokrõl. Továbbá a - <ulink url="&url.php.links;">&url.php.links;</ulink> - címen találsz egy listát olyan webhelyekrõl, amelyeket + <ulink url="&url.php.links;">PHP.net link oldal</ulink>on + találsz egy listát olyan webhelyekrõl, amelyeket PHP cikkeknek, fórumoknak és kódgyûjteményeknek szenteltek. </para> </sect1> @@ -396,10 +399,10 @@ A kézikönyv letölthetõ a <ulink url="&url.php.docs;">&url.php.docs;</ulink> címen számos nyelven és formátumban, - beleértve a sima szöveges, sima <acronym>HTML</acronym>, + beleértve a, sima <acronym>HTML</acronym>, <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo, és Windows HTML Help formátumokat. - A kézikönyv periodikusan frissül, ahogy a szöveg változik. + Technikai okok miatt néhány formátum elérhetetlen lehet. </para> <para> Több információt is találsz errõl, ha letöltöd ennek a
« previous php.doc.hu (#649) next »