goba Sun Aug 19 14:46:04 2001 EDT
Added files:
/phpdoc/hu/pear about.xml standards.xml
Modified files:
/phpdoc/hu Translators
Log:
New PEAR docs addded tu Hungarian version, now Translated
Index: phpdoc/hu/Translators
diff -u phpdoc/hu/Translators:1.45 phpdoc/hu/Translators:1.46
--- phpdoc/hu/Translators:1.45 Sun Aug 19 13:06:17 2001
+++ phpdoc/hu/Translators Sun Aug 19 14:45:55 2001
@@ -188,8 +188,8 @@
types.xml Hojtsy G�bor 1.45
variables.xml Kontra Gergely 1.17
-------- pear ---------------------------------------------------------------
-about.xml
+about.xml Hojtsy G�bor 1.3
benchmark_timer.xml
pear.xml
-standards.xml
+standards.xml Hojtsy G�bor 1.11
-----------------------------------------------------------------------------
Index: phpdoc/hu/pear/about.xml
+++ phpdoc/hu/pear/about.xml
<?xml encoding="iso-8859-2"?>
<chapter id="pear.about">
<title>A PEAR-r�l</title>
<simpara>
A PEAR-t <ulink url="&url.malinimg;">Malin Bakken</ulink>-nek aj�nljuk,
aki 1999 november 21-�n sz�letett (az els� PEAR program �ppen
k�t �r�val a sz�let�se el�tt �r�dott).
</simpara>
<sect1 id="pear-whatis">
<title>Mi a PEAR?</title>
<simpara>
A PEAR egy k�dt�r, PHP kiterjeszt�sek �s PHP nyelven �rt
programok gy�jtem�nye. Megsz�let�s�t a TeX CTAN �s a
Perl CPAN nev� hasonl� k�zpontjai inspir�lt�k.
</simpara>
<para>
A PEAR c�lja:
<itemizedlist>
<listitem>
<simpara>
hogy egy szab�lyozott k�rnyezetet teremtsen az �rjahaszn�lhat�
PHP k�nyvt�rak �r�inak, hogy megoszthass�k a k�djukat m�s
fejleszt�kkel
</simpara>
</listitem>
<listitem>
<simpara>
hogy infrastrukt�r�t adjon a PHP k�z�ss�gnek programk�dok
cser�j�hez
</simpara>
</listitem>
<listitem>
<simpara>
hogy a fejleszt�ket hordozhat� �s �jrahaszn�lhat� programok
�r�s�ban seg�t� szabv�nyokat hozzon l�tre
</simpara>
</listitem>
<listitem>
<simpara>
hogy eszk�z�ket adjon a k�dok karbantart�s�ra �s tejeszt�s�re
</simpara>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>
<!-- 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:
-->
Index: phpdoc/hu/pear/standards.xml
+++ phpdoc/hu/pear/standards.xml
<?xml encoding="iso-8859-2"?>
<chapter id="pear.standards">
<title>PEAR programoz�si szabv�ny</title>
<note>
<simpara>
A PEAR programoz�si szabv�nyok azokra a k�dokra vonatkoznak,
amik a PEAR r�sz�v� v�lnak, ak�r a PHP-vel egy�tt terjesztve,
ak�r a PEAR telep�t� eszk�z�vel let�lthet�en.
</simpara>
</note>
<sect1 id="pear.standards.indenting">
<title>Bekezd�sek</title>
<para>
Bekezd�sekhez 4 sz�k�z haszn�latos. Ha az Emacs programot
haszn�lod PEAR k�dok szerkeszt�s�re, az indent-tabs-mode
�rt�ket nil-re �ll�tsd. Itt egy p�lda m�d be�ll�t�s, ami
ezeknek a szab�lyoknak megfelel�ven szabja testre az Emacs
szerkeszt�t. (meg kell gy�z�dn�d r�la, hogy ez v�grehajt�dik,
amikor PHP �llom�nyokat szerkesztesz):
<programlisting role="elisp">
(defun php-mode-hook ()
(setq tab-width 4
c-basic-offset 4
c-hanging-comment-ender-p nil
indent-tabs-mode
(not
(and (string-match "/\\(PEAR\\|pear\\)/" (buffer-file-name))
(string-match "\.php$" (buffer-file-name))))))
</programlisting>
</para>
<para>Ugyanerre a dologra a vim be�ll�t�sok:
<programlisting role="vim">
set expandtab
set shiftwidth=4
set tabstop=4
</programlisting>
</para>
</sect1>
<sect1 id="pear.standards.control">
<title>Verz�rl�si szerkezetek</title>
<para>
Ezek az if, for, while, switch, stb. Itt egy p�lda
if szerkezet, mivel ez a legbonyolultabb:
<programlisting role="php">
<![CDATA[
if ((felt�tel1) || (felt�tel2)) {
akci�1;
} elseif ((felt�tel3) && (felt�tel4)) {
akci�2;
} else {
akci�_egy�bk�nt;
}
]]>
</programlisting>
</para>
<simpara>
A vez�rl�si szerkezetekn�l egy sz�k�zt kell hagyni a
kulcssz� �s a nyit� z�r�jel k�z�tt, hogy megk�l�nb�ztess�k
ezeket a f�ggv�nyh�v�sokt�l.
</simpara>
<simpara>
Miden esetben haszn�lj kapcsos z�r�jeleket, m�s akkor
is, ha technikailag elhagyhat�ak lenn�nek. Ez jobban
olvashat�v� teszi a k�dot, �s cs�kkenti a logikai hib�k
el�fordul�s�nak es�ly�t, ha �j k�dsorokat adsz a blokkhoz.
</simpara>
<para>
A switch szerkezet haszn�lata:
<programlisting role="php">
switch (felt�tel) {
case 1:
akci�1;
break;
case 2:
akci�2;
break;
default:
akci�_egy�bk�nt;
break;
}
</programlisting>
</para>
</sect1>
<sect1 id="pear.standards.funcalls">
<title>F�ggv�nyh�v�sok</title>
<para>
A f�ggv�nyh�v�sokn�l nem szabad sz�k�zt tenni a
f�ggv�ny neve �s a nyit� z�r�jel k�z�, valamint a
nyit� z�r�jel �s az els� param�ter k�z�. A param�terek
k�z� sz�k�zt kell tenni, de az utols� param�ter ut�n
k�zvetlen�l kell, hogy �lljon a z�r�jel �s a pontosvessz�.
Egy p�lda:
<programlisting role="php">
$valtozo = ize($valami, $valalmi_mas, $teljesen_mas);
</programlisting>
</para>
<para>
Mint ahogy fent l�tszik, az egyenl�s�gjelek mindk�t oldal�n
egy-egy sz�k�znek kell �llnia, amikor a f�ggv�ny visszat�r�si
�rt�k�t egy v�ltoz�hoz rendeled. Ha egy blokkban t�bb
hozz�rendel�st is el kell helyezni, t�bb sz�k�z is beilleszthet�
az olvashat�s�g �rdek�ben:
<programlisting role="php">
$rovid_nev = ize($valami);
$hosszu_valtozo_nev = ize($valami_mas);
</programlisting>
</para>
</sect1>
<sect1 id="pear.standards.funcdef">
<title>F�ggv�ny defin�ci�k</title>
<para>
A f�ggv�ny defin�ci�k az al�bbi konvenci�t k�vetik:
<programlisting role="php">
function izeFuggveny($param1, $param2 = '')
{
if (felt�tel) {
utas�t�s_blokk;
}
return $valtozo;
}
</programlisting>
</para>
<para>
Ay alapbe�ll�t�s� �rt�kekkel rendelkez� param�terek a lista
v�g�re ker�lnek. Mindig pr�b�lj meg egy �rtelmes visszat�r�si
�rt�ket adni a f�ggv�nynek. Egy valamivel hosszabb p�lda:
<programlisting role="php">
<![CDATA[
function connect(&$dsn, $persistent = false)
{
if (is_array($dsn)) {
$dsninfo = &$dsn;
} else {
$dsninfo = DB::parseDSN($dsn);
}
if (!$dsninfo || !$dsninfo['phptype']) {
return $this->raiseError();
}
return true;
}
]]>
</programlisting>
</para>
</sect1>
<sect1 id="pear.standards.comments">
<title>Megjegyz�sek</title>
<para>
A bels� dokument�ci� a PHPDoc standardot k�veti, ami hasonl�.
a Javadoc dokument�ci�khoz. Tov�bbi inform�ci�k a PHPDoc-r�l
a <ulink url="&url.phpdoc;">&url.phpdoc;</ulink> c�men tal�lhat�ak.
</para>
<para>
A nem dokument�ci� jelleg� megjegyz�sek haszn�lata is er�sen javasolt.
�ltal�nos szab�ly, hogy ha egy k�dra n�zel, �s azt gondolod, hogy
"Ah, �n nem szeretn�m most ezt megmagyar�zni", akkor gyorsan �rd
oda a megjegyz�seidet, m�g miel�tt elfejeted, hogyan m�k�dik.
</para>
<para>
A C st�lus� (/* */) megjegyz�sek, �s a szabv�nyos C++ megjegyz�sek
(//) is megfelel�ek. A Perl/shell megjegyz�sek (#) azonban nem
javasoltak.
</para>
</sect1>
<sect1 id="pear.standards.including">
<title>K�ls� k�d bet�lt�se</title>
<para>
B�rhol, ahol felt�tel n�lk�l bet�ltesz egy PHP k�dot
tartalmaz� �llom�nyt, haszn�ld a <function>require_once</function>
szerkezetet. B�rhol, ahol valamilyen felt�telnek megfelel�en
t�ltesz be egy PHP �llom�nyt, (p�ld�ul a "factory" met�dusokban),
haszn�ld az <function>include_once</function> szerkezetet.
Mindkett� gondoskodni fog r�la, hogy a megadott �llom�ny csak
egyszer legyen megnyitva. Ugyanazt a list�t haszn�lj�k, ez�rt
nem kell agg�dni a vegyes haszn�latuk miatt, egy
<function>require_once</function> haszn�lat�val bet�lt�tt
�llom�ny nem t�lt�dik be ism�t <function>include_once</function>
seg�t�s�g�vel.
<note>
<simpara>
Az <function>include_once</function> �s
<function>require_once</function> utas�t�sok �s nem
f�ggv�nyek. Nem <emphasis>kell</emphasis> z�r�jelet
tenned a bet�ltend� �llom�nyn�v k�r�.
</simpara>
</note>
</para>
</sect1>
<sect1 id="pear.standards.tags">
<title>PHP k�d blokkok</title>
<para>
<emphasis>Mindig</emphasis> a <literal><?php ?></literal>
form�t haszn�ld a PHP k�dblokkok meghat�roz�s�ra, �s nem a
<literal><? ?></literal> r�vid�t�st. Ez fontos a PEAR
megfelel�s�g miatt, �s mindenk�ppen a leghordozhat�bb forma
a k�l�nb�z� oper�ci�s rendszereken �s k�rnyezetekben.
</para>
</sect1>
<sect1 id="pear.standards.header">
<title>�llom�ny kezd� megjegyz�sek</title>
<para>
Minden forr�s�llom�ny a PEAR disztib�ci�ban a k�vetkez� megjegyz�s
blokkot tartalmazza az �llom�ny elej�n:
<programlisting role="php">
/* vim: set expandtab tabstop=4 shiftwidth=4: */
// +----------------------------------------------------------------------+
// | PHP version 4.0 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1997, 1998, 1999, 2000, 2001 The PHP Group |
// +----------------------------------------------------------------------+
// | This source file is subject to version 2.0 of the PHP license, |
// | that is bundled with this package in the file LICENSE, and is |
// | available at through the world-wide-web at |
// | http://www.php.net/license/2_02.txt. |
// | If you did not receive a copy of the PHP license and are unable to |
// | obtain it through the world-wide-web, please send a note to |
// | [EMAIL PROTECTED] so we can mail you a copy immediately. |
// +----------------------------------------------------------------------+
// | Authors: Original Author <[EMAIL PROTECTED]> |
// | Your Name <[EMAIL PROTECTED]> |
// +----------------------------------------------------------------------+
//
// $Id$
</programlisting>
</para>
<para>
Nincs semmilyen konr�t szab�ly, hogy mikor ker�lhet be
egy �j programoz� a szerz�k list�j�ba egy �llom�nyban.
�Ltal�noss�gban a v�ltoztat�soknak a "l�nyeges" kateg�ri�ba
kell tartozniuk (k�r�lbel�l 10-20% v�ltoz�s). Kiv�telek
tehet�ek f�ggv�ny �jra�r�sok vagy �j logika megval�s�t�sa
eset�n.
</para>
<para>
Egyszer� k�d �trendez�s vagy hibajav�t�sok nem mer�tik ki
az �j szerz� felv�tel�hez sz�ks�ges m�rt�ket.
</para>
<para>
A nem az alap PEAR k�dt�rba tartoz� �llom�nyoknak is egy hasonl�
fejl�c�k lehet, jel�lve a copyright �s a licensz felt�teleket,
valamint a szerz�ket. Minden �llom�nyban benne kell lennie
a modeline megjegyz�seknek, hogy megtartsuk a konzisztenci�t.
</para>
</sect1>
<sect1 id="pear.standards.cvs">
<title>A CVS haszn�lata</title>
<simpara>
Ez a r�sz csak a cvs.php.net c�men el�rhet� CVS
szolg�ltat�ssal fejlesztett csomagokra �rv�nyes.
</simpara>
<para>
Add meg az $Id$ CVS kulcssz�t minden �llom�nyban.
Ahogy szerkesztesz egy �llom�nyt, add hozz� ezt a kulcssz�t,
ha m�g nincs ott (vagy helyettes�tsd a kor�bbi "Last Modified:"
vagy m�s form�kat).
<!--
<note>
<simpara>
We have a custom $Horde tag in Horde cvs to track our versions
seperately; we could do the same and make a $PEAR tag, that
would remain even if PEAR files were put into another source
control system, etc...]
</simpara>
</note>
-->
</para>
<para>
A tov�bbi r�szben feltessz�k, hogy alapvet� CVS tud�sod van,
�s ismered a CVS �gak (branch) fogalm�t.
</para>
<para>
A CVS jel�l�sek arra szolg�lnak, hogy megadd, melyik
verzi�ja tartozik a csomagban l�v� �llom�nyodnak egy
kiad�shoz. Al�bb olvashatod a sz�ks�ges, �s javasolt
CVS jel�l�seket:
<variablelist>
<varlistentry>
<term>RELEASE_<replaceable>n_n</replaceable></term>
<listitem>
<simpara>
(sz�ks�ges) Egy kiad�s jel�l�s�re haszn�latos. Ha nem haszn�lod,
nincs semmilyen m�d, hogy a csomagodat megtekints�k a CVS szerveren
abban az �llapotban, ahogy a kiad�s el�tti id�ben volt.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>QA_<replaceable>n_n</replaceable></term>
<listitem>
<simpara>
(�g, elhagyhat�) Ha �gy gondolod, hogy ki kell adnod
egy "kiad�sra jel�lt" (release candidate) verzi�t
a t�nyleges kiad�s el�tt, j� �let egy �gat nyitni
annak, �gy el tudod k�l�n�teni, �s a kritikus
m�dos�t�sokat �t tudod vezetni a t�nyleges kiad�s
el�tt. Ezalatt a fejleszt�s folytat�dhat a
t�rzsben.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>MAINT_<replaceable>n_n</replaceable></term>
<listitem>
<simpara>
(�g, elhagyhat�) Ha "mikro-kiad�sokat" kell
csin�lnod (mint az 1.2.1 az 1.2 kiad�s ut�n),
erre is haszn�lhatsz egy k�l�n �gat, ha a
t�rzs nagyon akt�v �s csak kisebb v�ltoztat�sokat
szeretn�l a mikro-kiad�sok k�z�tt.
</simpara>
</listitem>
</varlistentry>
</variablelist>
Csak a RELEASE jel�l�s sz�ks�ges, a t�bbi k�nyelmi szempontok
miatt javasolt.
</para>
<para>
�me egy p�lda, hogy hogyan kell megjel�lni az 1.2 kiad�s�t
a "Money_Fast" csomagnak:
<informalexample>
<screen><prompt>$ </prompt><command>cd pear/Money_Fast</command>
<prompt>$ </prompt><command>cvs tag RELEASE_1_2</command>
<computeroutput>T Fast.php
T README
T package.xml
</computeroutput>
</screen>
</informalexample>
Ezt haszn�lva lehet�v� teszed a PEAR webhelynek, hogy
�tvezessen a kiad�si folyamat tov�bbi l�p�sein.
</para>
<para>
Itt egy p�lda, hogy hogyan k�sz�tsz egy QA �gat:
<informalexample>
<screen><prompt>$ </prompt><command>cvs tag QA_2_0_BP</command>
..
<prompt>$ </prompt><command>cvs rtag -b -r QA_2_0_BP QA_2_0</command>
<prompt>$ </prompt><command>cvs update -r QA_2_0</command>
<prompt>$ </prompt><command>cvs tag RELEASE_2_0RC1</command>
.. majd ezut�n a t�nyleges kiad�s ugyanebben az �gban:
<prompt>$ </prompt><command>cvs tag RELEASE_2_0</command>
</screen>
</informalexample>
A "QA_2_0_BP" jel�l� egy "�g pont" jel�l�, ami az �g kiindul�pontja.
Mindig j� �tlet egy CVS �gat egy ilyen �g pontb�l nyitni.
A MAINT �gak haszn�lhatj�k a RELEASE jel�l�t az �gpontokhoz.
</para>
</sect1>
<sect1 id="pear.standards.exampleurls">
<title>P�lda URL-ek</title>
<para>
Haszn�ld az "example.com" c�met minden p�lda URL-hez,
ahogy az RFC 2606 javasolja.
</para>
</sect1>
<sect1 id="pear.standards.naming">
<title>Elnevez�si szab�lyok</title>
<sect2>
<title>F�ggv�nyek �s met�dusok</title>
<para>
A f�ggv�nyeket �s a met�dusokat a "studly caps" st�lusban
kell elnevezni (ez ismert m�g "bumpy case" �s "camel caps" n�ven
is). A f�ggv�nyek nev�t ezen k�v�l a csomag nev�vel kell
kezdeni, hogy elker�lj�k a csomagok k�z�tti n�v �tk�z�seket.
A n�v els� bet�je (a csomagn�v ut�n) kisbet�s, minden �j "sz�t"
kezd� bet� nagybet�. N�h�ny p�lda:
<informaltable>
<tgroup cols="3">
<tbody>
<row>
<entry><simpara>connect()</simpara></entry>
<entry><simpara>getData()</simpara></entry>
<entry><simpara>buildSomeWidget()</simpara></entry>
<entry><simpara>XML_RPC_serializeData()</simpara></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
Priv�t oszt�ly met�dusok, �s tulajdons�gok
(azaz olyan met�dusok �s tulajdons�gok, amelyeket
csak az oszt�lyon bel�li haszn�latra tervezt�l, mivel
a PHP jelenleg nem t�mogatja a priv�t megk�t�st)
elnevez�sekor al�h�z�sjelet kell haszn�lni a n�v elej�n.
P�ld�ul:
<informaltable>
<tgroup cols="3">
<tbody>
<row>
<entry><simpara>_sort()</simpara></entry>
<entry><simpara>_initTree()</simpara></entry>
<entry><simpara>$this->_status</simpara></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</sect2>
<sect2>
<title>�lland�k</title>
<para>
Az �lland�k neve mindig csupa nagybet�s, a szavakat
al�h�z�sjel v�lasztja el egym�st�l. A konstansok nevei
a csomagjuk nagybet�s nev�vel kedz�dnek. P�ld�ul a
<literal>DB::</literal> csomag konstansai mind
"<literal>DB_</literal>"-al kezd�dnek.
</para>
</sect2>
<sect2>
<title>Glob�lis v�ltoz�k</title>
<para>
Ha a csomagodnak glob�lis v�ltoz�kat kell haszn�lnia,
a v�ltoz�n�vnek egy al�h�z�ssal kell kezd�dnie, amit
a csomag neve k�vet, majd m�g egy al�h�z�s. P�ld�ul a PEAR
csomag egy $_PEAR_destructor_object_list nev� glob�lis
v�ltoz�t haszn�l.
</para>
</sect2>
</sect1>
</chapter>
<!-- 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:
-->
