File: about.xml

package info (click to toggle)
phpdoc 20020310-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 35,272 kB
  • ctags: 354
  • sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (215 lines) | stat: -rw-r--r-- 8,592 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.11 Maintainer: luk Status: ready -->
<!--
  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>O tomto manulu</title>

 <sect1 id="about.formats">
  <title>Formty</title>
  <para>
   Tento PHP manul je poskytovn v rznch formtech. Tyto formty se
   daj rozdlit do dvou skupin: formty pro prohlen on-line a
   balky pro stahovn.   
  </para>
  <note>
   <para>
    Nkte vydavatel vydali titn verze tohoto manulu. dn z nich
    nedoporuujeme, protoe velmi rychle zastarvaj.    
   </para>
  </note>
  <para>
   Manul mete st on-line na <ulink url="&url.php;"> &url.php;</ulink>
   a mnoha zrcadlech. Pro zajitn nejrychlejho pstupu byste si mli
   vybrat zrcadlo umstn nejble k vm. Mete si prohlet manul v
   "holm" HTML formtu (vhodnm pro tisk) nebo v HTML formtu integrujcm
   manul do vzhledu a chovn samotnch strnek PHP.   
  </para>
  <para>
   Vhodou on-line manulu ped off-line formty je integrace
   <link linkend="about.notes">uivatelskch poznmek</link>.
   Samozejmou nevhodou je to, e pi prohlen muste bt on-line.   
  </para>
  <para>
   Existuje vce off-line formt manulu a formt pro vs nejvhodnj
   zvis na tom, jak operan systm pouvte a na vaem osobnm stylu
   ten. Pro informaci o tom, jak je manul generovn v tolika formtech,
   si pette sekci <link linkend="about.generate">'Jak generujeme
   formty'</link> v dodatcch.
  </para>
  <para>
   Pro nejvce platforem se hod manul v HTML a jako prost text. HTML
   formt je poskytovn jak jako jedin HTML soubor, tak jako balek
   soubor podle jednotlivch sekc (co ve vsledku znamen kolekci
   tisc soubor). HTML a prost text jsou poskytovny jako tar soubory
   zkomprimovan pomoc bzip2.   
  </para>
  <para>
   Jinm populrnm platformn nezvislm formtem, a tak formtem
   nejvhodnjm pro tisk, je PDF (znm tak jako Adobe Acrobat). Ale
   ped staenm tohoto formtu a stisknutm tlatka pro tisk jet jedno
   varovn: Manul je skoro 2000 strnek dlouh a stle se upravuje!   
  </para>
  <note>
   <para>
    Pokud jet nemte program schopn zobrazit formt PDF, mete si
    sthnout  <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>.
   </para>
  </note>
  <para>
   Pro vlastnky handheld (Palm kompatibilnch) jsou ideln formty
   Palm document a iSilo. Mete si pinst svj handheld na smnu a pout
   prohle formtu <ulink url="&url.palm.doc;">DOC</ulink> nebo
   <ulink url="&url.palm.isilo;">iSilo</ulink> k opren znalost PHP nebo
   jako rychlou pruku.
  </para>
  <para>
   Pro platformu Windows existuje verze Widows HTML Help pro pouit
   s aplikac Windows HTML Help- Tato verze poskytuje fulltextov
   vyhledvn, pln rejstk a zloky. Mnoho populrnch vvojovch
   prosted pro vvoj v PHP pod Windows tak integruje tuto verzi
   dokumentace, co zajiuje snadn pstup.   
  </para>
  <note>
   <para>
    Projekt Visual Basic for Linux je ve stdiu plnovn, bude zahrnovat
    vvoj aplikace CHM Creator and Viewer for Linux. Pokud se zajmte
    o stav vvoje, podvejte se na
    <ulink url="&url.vb4linux;">SourceForge.net page</ulink>.
   </para>
  </note>
 </sect1>
 
 <sect1 id="about.notes">
  <title>O uivatelskch poznmkch</title>
  <para>
   Uivatelsk poznmky hraj dleitou roli ve vvoji tohoto manulu.
   Umonnm tenm manulu pidvat pklady a dal vysvtlen pmo
   z jejich prohlee jsme schopni zabudovat zptnou vazbu do hlavnho
   textu manulu. A ne jsou poznmky zpracovny, jsou vidt v podob,
   v jak je uivatel poslali, v on-line (a nkterch off-line) formtech.
  </para>
  <note>
   <para>
    Uivatelsk poznmky nejsou moderovny ped jejich zobrazenm on-line,
    take kvalita textu nebo pklad kdu a jejich vrohodnost nemohou
    bt zarueny (ne, e by byla zaruena kvalita nebo pesnost samotnho
    manulu).    
   </para>
  </note>
 </sect1>
 
 <sect1 id="about.more">
  <title>Jak najt vce informac o PHP</title>
  <para>
   Tento manul se nepokou poskytovat instrukce o obecnch programovacch
   technikch. Pokud jste pln erstv programtor nebo stle jet
   zatenk, me vm pijt obtn nauit se programovat v PHP pouze podle
   tohoto manulu. Mete chtt hledat texty vce orientovan na zatenky.
   Zde je seznam knih tkajcch se PHP:
   <ulink url="&url.php.books;">&url.php.books;</ulink>.
  </para>
  <para>
   Existuje mnoho aktivnch e-mailovch diskusnch skupin pro diskusi
   o vech aspektech programovn v PHP. Pokud mte problm, pro kter
   nmete najt een, mohl by vm pomoci nkdo z tchto skupin. Seznam
   diskusnch skupin najdete na
   <ulink url="&url.php.support;">&url.php.support;</ulink>, stejn tak i
   odkazy na archivy tchto skupin a jin on-line zdroje. Dle,
   na <ulink url="&url.php.links;">&url.php.links;</ulink> je seznam strnek
   zamench na lnky, fra a galerie kdu pro PHP.
  </para>
 </sect1>

 <sect1 id="about.howtohelp">
  <title>Jak pomoci zlepit dokumentaci</title>
  <para>
   Jsou dv cesty, jak mete pomoci zlepit tuto dokumentaci.
  </para>
  <para>
   Pokud v manulu najdete chyby (v ktermkoli jazyce), oznamte je prosm
   pomoc bug systmu na <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>.
   Klasifikujte chybu jako "Documentation Problem". Mete tak poslat
   problmy spojen s konkrtnmi manulovmi formty zde.
  </para>
  <note>
   <para>
    Nezneuvejte prosm bug systm odeslnm dost o pomoc. Pouijte
    namsto toho diskusn frum nebo komunitn strnky, jak ji bylo zmnno.    
   </para>
  </note>
  <para>
   Pi pidvn poznmek mete poskytnout dodaten pklady a vysvtlen
   pro ostatn tene. Avak neposlejte prosm pomoc tohoto anotanho
   systmu hlen o chybch. O anotacch se mete vce dozvdt v sti
   <link linkend="about.notes">'O uivatelskch poznmkch'</link> tohoto
   dodatku.
  </para>
 </sect1>
 
 <sect1 id="about.generate">
  <title>Jak generujeme formty</title>
  <para>
   Tento manul je napsn v <acronym>XML</acronym> s pouitm <ulink
   url="&url.docbook.xml;">DocBook XML DTD</ulink>, <ulink
   url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document
   Style and Semantics Specification Language) pro formtovn a
   experimentln <ulink url="&url.xslt;"><acronym>XSLT</acronym>
   </ulink> (Extensible Stylesheet Language Transformations)
   pro drbu a formtovn.
  </para>
  <para>
   Pouit <acronym>XML</acronym> jako zdrojovho formtu nm dv monost
   generovat mnoho vstupnch formt ze zdrojovch soubor a udrovat pouze
   jedin zdrojov dokument pro vechny formty. Nstroji pouitmi pro
   formtovn <acronym>HTML</acronym> a
   <acronym>TeX</acronym> verz jsou <ulink url="&url.jade;">Jade</ulink>,
   jeho autorem je <ulink
   url="&url.jclark;">James Clark</ulink>, a <ulink
   url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>
   kde je autorem <ulink url="&url.nwalsh;">Norman Walsh</ulink>.
   Pouvme <ulink url="&url.winhelp;">Microsoft HTML Help
   Workshop</ulink> ke generovn formtu Windows HTML Help a, samozejm,
   PHP samotn pro dodaten konverze a formtovn.   
  </para>
  <para>
   Manul si mete sthnout v rznch jazycch a formtech, vetn prostho
   textu, prostho <acronym>HTML</acronym>,
   <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo a
   Windows HTML Help, z
   <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
   Manuly jsou automaticky aktualizovny, pokud se jejich text zmn.   
  </para>
  <para>
   Vce informac o stahovn zdrojovho kdu dokumentace v   
   <acronym>XML</acronym> najdete na
   <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. Dokumentace je uloena
   v modulu <literal>phpdoc</literal>.
  </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:
-->