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