cvs: phpdoc /he/appendices about.xml

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