Dodatok Q. O manuále

Obsah
Formáty
O príspevkoch užívateľov
Ako čítať definíciu funkcie (prototyp)
Verzie PHP zdokumentované v tomto manuále
Ako nájsť viac informácii o PHP
Ako pomôcť pri zlepšovaní dokumentácie
Ako generujeme formáty
Preklady

Formáty

PHP manuál sa poskytuje v niekoľkých formátoch. Tieto formáty sa delia na dve skupiny: online čitateľné formáty a stiahnuteľné balíky.

Poznámka: Niektorí vydávatelia uviedli tlačené verzie tohto manuálu. Nemôžeme doporučiť žiaden z nich, nakoľko sú zakrátko zastaralé.

Manuál si môžete prečítať online na http://www.php.net/ a na početných mirrorovaných stránkach. Pre najlepšiu činnosť by ste si mali zvoliť mirrorovanú stránku najbližšie k vám. Manuál si môžete prezerať buď v jednoduchom (vhodnom pre tlač) HTML formáte alebo v HTML formáte, ktorý integruje manuál do podoby samotnej webovskej stránky PHP.

Dve za zmienku stojace výhody online manuálu oproti väčšine offline formátom je integrácia príspevkov uživateľov a URL skratiek, ktoré môžete použiť na rýchle získanie požadovaných častí manuálu. Zrejmou nevýhodou je, že musíte byť online, aby ste si mohli prezerať manuál v online formátoch.

Existuje niekoľko offline formátov manuálu a fakt, ktorý formát je pre vás najvhodnejší, závisí na operačnom systéme, ktorý používate a osobnom spôsobe čítania. Ak chcete vedieť ako sa tento manuál generuje do mnohých formátov, prečítajte si sekciu 'Ako generujeme formáty' v tejto prílohe.

Najvhodnejšími multi-platformovými formátmi manuálu je HTML verzia. Táto sa poskytuje ako jednoduchý HTML súbor a aj ako balík individuálnych súborov pre každú sekciu (ktorá pozostáva zo zväzku niekoľko tisí súborov). Poskytujeme tieto verzie zbalené, budete pobrebovať nejaký druh rozbalovacej utility na získanie súborov obsiahnutých v archívoch.

Ďalším obľúbeným multi-platformovým formátom, ktorý je najvhodnejší pre tlač, je PDF (tiež známy ako Adobe Acrobat). Ale než sa pustíte do sťahovania tohto formátu a jeho tlače, majte na pamäti, že manuál má viac než 2000 strán a že sa neustále upravuje.

Poznámka: Ak ešte nemáte program schopný prezerania súborov formátu PDF, možete si stiahnúť Adobe Acrobat Reader.

Pre vlastníkov handheldov kompaktibilných s Palm sú ideálne formáty Palm dokument a iSilo. Môžete si svoj handheld nosiť denne so sebou a používať DOC alebo iSilo reader, aby ste si zdokonalili svoje PHP vedomosti, alebo ho len používať ako príručku.

Pre platformy Windows, verzia manuálu Windows HTML Help umožňuje použitie HTML formátu vo Windows HTML Help aplikáciach. Táto verzia poskytuje full-textové vyhľadávanie, plný index, a označnie zarážok (bookmarking). Mnoho známych vývojových prostredí pre Windows tiež zahŕňa túto verziu dokumentácie pre jednoduchý prístup. CHM prehliadače pre Linuxové desktopy sú tiež k dispozícii. Skúste xCHM alebo GnoCHM.

Je tiež dostupná rozšírená CHM verzia, ktorá sa obnovuje menej často, ale poskytuje vačší počet funkcií. Bude fungovať teda fungovať pod Microsoft Windows, kvôli technológiám používaným na tvorenie stránok pomocníka.