cvs: phpdoc /he/appendices about.xml
| From: | Sagie Maoz | Date: | Wed, 01 May 2002 15:36:22 +0000 |
| Subject: | cvs: phpdoc /he/appendices about.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969345123@lists.php.net to get a copy of this message | ||
n0nick Wed May 1 11:36:22 2002 EDT
Modified files:
/phpdoc/he/appendices about.xml
Log:
I'm done. Somebody review this.
Index: phpdoc/he/appendices/about.xml
diff -u phpdoc/he/appendices/about.xml:1.1 phpdoc/he/appendices/about.xml:1.2
--- phpdoc/he/appendices/about.xml:1.1 Tue Apr 30 20:59:11 2002
+++ phpdoc/he/appendices/about.xml Wed May 1 11:36:21 2002
@@ -17,8 +17,6 @@
<para>
îãøéê PHP îâéò áîñôø âøñàåú. âøñàåú àìå éëåìåú ìäúçì÷
ìùúé ÷áåöåú:
âøñàåú ùðéúï ì÷øåà áàåôï î÷ååï åçáéìåú
ðéúðåú-ìäåøãä.
- The PHP manual is provided in several formats. These formats can be divided
- into two groups: online readable formats, and downloadable packages.
</para>
<note>
<para>
@@ -104,92 +102,86 @@
</sect1>
<sect1 id="about.more">
- <title>How to find more information about PHP</title>
+ <title>ëéöã ì÷áì îéãò ðåñó àåãåú PHP</title>
<para>
- This manual does not attempt to provide instruction about general
- programming practices. If you are a first-time, or even just a beginning,
- programmer, you may find it difficult to learn how to program in PHP using
- just this manual. You may want to seek out a text more oriented towards
- beginners. You can find a list of PHP-related books at <ulink
- url="&url.php.books;">&url.php.books;</ulink>.
- </para>
- <para>
- There are a number of active mailing lists for discussion of all aspects of
- programming with PHP. If you find yourself stuck on a problem for which you
- can't find your own solution, you may be able to get help from someone on
- these lists. You can find a list of the mailing lists at <ulink
- url="&url.php.support;">&url.php.support;</ulink>, as well as links
to the
- mailing list archives and other online support resources. Furthermore, at
- <ulink url="&url.php.links;">&url.php.links;</ulink> there is a
list of
- websites devoted to PHP articles, forums, and code galleries.
+ îãøéê æä ìà îðñä ìñô÷ äñáøéí àåãåú úøâåìé úëðåú
ëììééí.
+ àí àúä îúëðú áôòí äøàùåðä, àå àôéìå ø÷ îúëðú îúçéì,
àåìé úîöà
+ ùììîåã úëðåú á-PHP áàîöòåú îãøéê æä éäéä ÷ùä.
+ ëãàé ùúçôù è÷ñè ùîëååï éåúø ìîúçéìéí. àúä éëåì ìîöåà
øùéîä ùì
+ ñôøéí ä÷ùåøéí ì-PHP á <ulink
url="&url.php.books;">&url.php.books;</ulink>.
+ </para>
+ <para>
+ éùðï îñôø øùéîåú ãéååø ôòéìåú ìãéåï ëì ääéáèéí ùì
úëðåú òí PHP.
+ àí úú÷ò ôòí ááòéä ùàúä ìà îöìéç ìîöåà ìä ôúøåï,
áàôùøåúê ì÷áì òæøä
+ îîéùäå áøùéîåú àìå. ðéúï ìîöåà øùéîä ùì øùéîåú
äãéååø á <ulink
+ url="&url.php.support;">&url.php.support;</ulink>, ëîå âí
÷éùåøéí
+ ìî÷åøåú úîéëä î÷ååðéí àçøéí. áðåñó, á <ulink
+ url="&url.php.links;">&url.php.links;</ulink> éùðä øùéîä
ùì àúøéí
+ äîå÷ãùéí ìîàîøéí, ôåøåîéí åâìøéåú ÷åã ùì PHP.
</para>
</sect1>
<sect1 id="about.howtohelp">
- <title>How to help improve the documentation</title>
+ <title>ëéöã ðéúï ìòæåø ìùéôåø äúéòåã</title>
<para>
- There are two ways you can help to improve this documentation.
+ éùðï ùúé ãøëéí ìòæåø ìùéôåø úéòåã æä.
</para>
<para>
- If you find errors in this manual, in any language, please report them
- using the bug system at <ulink
url="&url.php.bugs;">&url.php.bugs;</ulink>.
- Classify the bug as "Documentation Problem". You can also submit problems
- related to specific manual formats here.
+ àí àúä îåöà ùâéàåú áîãøéê æä, áëì ùôä, àðà ãååç òìéäï
áàîöòåú îòøëú äáàâéí
+ á <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>.
+ ñååâ àú äáàâ ë"áòééú úéòåã" ("Documentation Problem").
àúä éëåì ìãååç âí òì
+ áòéåú ä÷ùåøåú ìâøñàåú îñåéîåú ùì äúéòåã ëàï.
</para>
<note>
<para>
- Please don't abuse the bug system by submitting requests for help. Use the
- mailing lists or community sites mentioned earlier, instead.
+ àðà àì úùúîù ìøòä áîòøëú äáàâéí ò"é ùìéçú á÷ùåú
ìòæøä. äùúîù áøùéîåú äãéååø
+ åáàúøé ä÷äéìä ùöåéðå ÷åãí áî÷åí.
</para>
</note>
<para>
- By contributing notes, you can provide additional examples, caveats, and
- clarifications for other readers. But do not submit bug reports using the
- annotation system please. You can read more about annotations in the <link
- linkend="about.notes">'About user notes'</link> section of this
- appendix.
+ òì-éãé äåñôú äòøåú, àúä éëåì ìñô÷ ãåâîàåú ðåñôåú,
àæäøåú åäáäøåú ì÷åøàéí
+ äàçøéí. àê áá÷ùä àì úãååç òì áàâéí áàîöòåú îòøëú
äôéøåùéí. ðéúï ì÷øåà òåã
+ òì äôéøåùéí áçì÷ <link linkend="about.notes">'àåãåú
äòøåú äîùúîùéí'</link>
+ ùì ðñôç æä.
</para>
</sect1>
<sect1 id="about.generate">
- <title>How we generate the formats</title>
+ <title>ëéöã àðå îçåììéí àú äâøñàåú</title>
<para>
- This manual is written in <acronym>XML</acronym> using the <ulink
- url="&url.docbook.xml;">DocBook XML DTD</ulink>, using <ulink
+ îãøéê æä øùåí á <acronym>XML</acronym> åîùúîù á <ulink
+ url="&url.docbook.xml;">DocBook XML DTD</ulink>, äîùúîù á
<ulink
url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document
- Style and Semantics Specification Language) for formatting, and
- experimentally the <ulink
url="&url.xslt;"><acronym>XSLT</acronym>
+ Style and Semantics Specification Language) ìòéöåá, åáàåôï ðéñéåðé á
+ <ulink url="&url.xslt;"><acronym>XSLT</acronym>
</ulink> (Extensible Stylesheet Language Transformations)
- for maintenance and formatting.
+ ìðéäåì åòéöåá.
</para>
<para>
- Using <acronym>XML</acronym> as a source format gives us
- the ability to generate many output formats from the source
- files, while only maintaining one source document for all formats.
- The tools used for formatting <acronym>HTML</acronym> and
- <acronym>TeX</acronym> versions are
- <ulink url="&url.jade;">Jade</ulink>, written by <ulink
- url="&url.jclark;">James Clark</ulink> and <ulink
+ äùéîåù á <acronym>XML</acronym> ëôåøîè î÷åø îàôùø ìðå
+ ìçåìì ôìè áâøñàåú øáåú î÷áöé äî÷åø, úåê ðéäåì îñîê
î÷åø
+ àçã òáåø ëì äâøñàåú.
+ äëìéí ìòéöåá âøñàåú ä-<acronym>HTML</acronym>
åä-<acronym>TeX</acronym>
+ äí <ulink url="&url.jade;">Jade</ulink>, ùðëúá ò"é
<ulink
+ url="&url.jclark;">â'ééîñ ÷ìàø÷</ulink> å <ulink
url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>
- written by <ulink url="&url.nwalsh;">Norman Walsh</ulink>.
- We use <ulink url="&url.winhelp;">Microsoft HTML Help
- Workshop</ulink> to generate the Windows HTML Help format
- of the manual, and of course PHP itself to do some
- additional conversions and formatting.
+ ùðëúáå ò"é <ulink url="&url.nwalsh;">ðåøîï
ååìù</ulink>.
+ àðå îùúîùéí á<ulink url="&url.winhelp;">ñãðú òæøú HTML
ùì
+ îé÷øåñåôè</ulink> ëãé ìçåìì àú âøñàåú òæøú ä-HTML
ìçìåðåú
+ ùì äîãøéê, åëîåáï PHP òöîå áùáéì îñôø äîøåú åòéöåáéí
àçøéí.
</para>
<para>
- You can download the manual in various languages and
- formats, including plain text, plain <acronym>HTML</acronym>,
- <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo and
- Windows HTML Help, from
+ ðéúï ìäåøéã àú äîãøéê áùôåú åâøñàåú ùåðåú, áéï äùàø
áè÷ñè ôùåè,
+ <acronym>HTML</acronym> ôùåè, <acronym>PDF</acronym>, PalmPilot DOC,
+ PalmPilot iSilo åòæøú HTML ìçìåðåú, î
<ulink url="&url.php.docs;">&url.php.docs;</ulink>.
- The manuals are updated automatically as the text is updated.
+ äîãøéëéí îòåãëðéí áàåôï àåèåîèé ëùäè÷ñè îúòãëï.
</para>
<para>
- You can find more information about downloading the
- <acronym>XML</acronym> source code of this documentation
- at <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. The
- documentation is stored in the <literal>phpdoc</literal> module.
+ ðéúï ìîöåà îéãò ðåñó àåãåú äåøãú ÷åã äî÷åø á
+ <acronym>XML</acronym> ùì úéòåã æä á
+ <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. äúéòåã
+ îàåçñï áîåãåì <literal>phpdoc</literal>.
</para>
</sect1>