n0nick Tue Apr 30 20:59:11 2002 EDT
Added files:
/phpdoc/he/appendices about.xml
Log:
Translated sections about.formats and about.notes.
I'm tired, will continue tomorrow ;)
Index: phpdoc/he/appendices/about.xml
+++ phpdoc/he/appendices/about.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!--
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";
-->
<appendix id="about">
<title>About the manual</title>
<sect1 id="about.formats">
<title>גרסאות</title>
<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>
מספר מו"לים פרסמו גרסאות מודפסות של מדריך זה. אנו
לא יכולים להמליץ על גרסאות כאלו, שכן הן נוטות להפוך
ללא-מעודכנות במהירות רבה.
</para>
</note>
<para>
ניתן לקרוא את המדריך באופן מקוון ב <ulink url="&url.php;"> &url.php;</ulink>
ובאתרי ה"מראה". לביצועים הטובים ביותר, כדאי לבחור באתר המראה הקרוב ביותר אליך.
ניתן להציג את המדריך בפורמט HTML פשוט (קל-להדפסה) או בפורמט HTML שמשלב את
המדריך עם המראה וההרגשה של אתר PHP עצמו.
</para>
<para>
יתרון של המדריך המקוון על הגרסאות הלא-מקוונות הוא השילוב של
<link linkend="about.notes">הערות משתמשים</link>. חיסרון ברור
הוא שיש להיות מחובר על-מנת לקרוא את המדריך בפורמט מקוון.
</para>
<para>
ישנן מספר גרסאות לא-מקוונות של המדריך, והגרסה המתאימה לך ביותר תלויה במערכת
ההפעלה שלך ובסגנון הקריאה האישי שלך. למידע על כיצד המדריך מחולל בכל-כך
הרבה גרסאות, ניתן לקרוא את החלק <link linkend="about.generate">'כיצד אנו מחוללים
את הגרסאות'</link> של נספח זה.
</para>
<para>
הגרסאות הכי לא-תלויות-פלטפורמה של המדריך הן גרסאות ה-HTML והטקסט.
גרסאת ה-HTML מסופקת הן כדף HTML בודד והן כחבילה של קבצים נפרדים
עבור כל חלק (דבר שיוצר אוסף של מספר אלפים של קבצים(. גרסאות ה-HTML והטקסט
מסופקות כקבצי tar המכווצים ע"י bzip2.
</para>
<para>
גרסה לא-תלוית-פלטפורמה פופולרית נוספת, והגרסה המתאימה ביותר להדפסה,
היא גרסת ה-PDF (ידוע גם כ-Adobe Acrobat). אך לפני שתזדרז להוריד את
הגרסה וללחוץ על כפתור ההדפסה, שים לב שהמדריך הוא בן כמעט 2000 דפים,
ומשתנה באופן קבוע.
</para>
<note>
<para>
אם אין לך עדיין תוכנה שמסוגלת להציג קבצי PDF, תצטרך להוריד את
<ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>.
</para>
</note>
<para>
לבעלי מחשבי כף-יד תואמי-Palm, גרסאות מסמך ה-Palm וה-iSilo הן
האידאליות לפלטפורמה זו. אתה יכול לקחת איתך את המכשיר בנסיעות
היומיות ולהשתמש בקורא<ulink url="&url.palm.doc;">DOC</ulink>
או <ulink url="&url.palm.isilo;">iSilo</ulink> כדי לרענן
את ידע ה-PHP שלך, או פשוט כחומר-עיון מהיר.
</para>
<para>
למשתמשי חלונות, גרסת ה"עזרת HTML לחלונות" של המדריך מתאימה את גרסת ה-HTML
לתוכנת עזרת ה-HTML של חלונות. גרסה זו מאפשרת חיפוש טקסט-מלא, אינדקס מלא
וסימניות. בנוסף הרבה סביבות פיתוח PHP לחלונות משולבות עם גרסה זו של התיעוד
כדי לספק גישה מהירה.
</para>
<note>
<para>
פרויקט Visual Basic ללינוקס נמצא בשלבי פיתוח, מה שיכלול את הפיתוח של
יוצר ומציג CHM ללינוקס. ראה
<ulink url="&url.vb4linux;">דף הפרויקט ב-SourceForge.net</ulink>
אם אתה מעוניין בהתקדמות.
</para>
</note>
</sect1>
<sect1 id="about.notes">
<title>אודות הערות המשתמשים</title>
<para>
להערות המשתמשים תפקיד חשוב מאוד בפיתוח של מדריך זה. ע"י מתן אפשרות
לקוראי המדריך לתרום דוגמאות, אזהרות ושאר הבהרות הישר מהדפדפן שלהם,
אנו מסוגלים להכליל את המשוב הזה לתוך הטקסט הראשי של המדריך. ועד
שההערות הוכללו, הן מוצגות בצורה המוגשת שלהן באופן מקוון ובמספר גרסאות
לא מקוונות.
</para>
<note>
<para>
הערות המשתמשים לא מנוהלות לפני שהן מופיעות באופן מקוון, ולכן איכות הכתיבה
או דוגמאות הקוד, או אפילו האמיתות של התרומה, לא יכולים להיות מובטחים.
(לא שיש כל אחריות על האיכות או הדיוק של טקסט המדריך עצמו.)
</para>
</note>
</sect1>
<sect1 id="about.more">
<title>How to find more information about 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.
</para>
</sect1>
<sect1 id="about.howtohelp">
<title>How to help improve the documentation</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.
</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.
</para>
</sect1>
<sect1 id="about.generate">
<title>How we generate the formats</title>
<para>
This manual is written in <acronym>XML</acronym> using the <ulink
url="&url.docbook.xml;">DocBook XML DTD</ulink>, using <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>
</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
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.
</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
<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.
</para>
</sect1>
</appendix>
<!-- 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
indent-tabs-mode:nil
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
-->
