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
-->