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

Reply via email to