Форматы

Руководство по PHP доступно в нескольких форматах. Эти форматы могут быть разделены на две группы: форматы для чтения в онлайн и форматы, доступные для загрузки.

Замечание: Некоторые издательства выпустили печатные версии этого руководства. Однако, мы не рекомендуем пользоваться ими вследствие их быстрого устаревания.

Вы можете пользоваться руководством в он-лайн по адресу /, а также на многочисленных сайтах-зеркалах. Чтобы обеспечить наиболее высокую скорость загрузки, вам нужно выбрать ближайший к вам сайт-зеркало. Вы можете пользоваться руководством в виде обычного HTML (готового для распечатки) или же в виде, предлагающем оформление самого сайта PHP.

Преимуществом он-лайн руководства над большинством офф-лайн форматов является интеграция с замечаниями пользователей. Очевидным недостатком является то, что вам нужно находиться в он-лайне, чтобы пользоваться руководством в он-лайн форматах.

Существуют несколько форматов для использования в офф-лайне, и вы можете выбрать формат, наиболее подходящий для использования в вашей операционной системе и отвечающий вашим читательским предпочтениям. Чтобы узнать больше о том, каким образом создается такое количество форматов руководства, обратитесь к разделу 'Как мы создаем форматы руководства'.

Наиболее кросс-платформенными форматами этого руководства являются формат HTML и формат обычного текста. Формат HTML доступен как в виде одного HTML-файла, так и в виде архива, содержащего несколько тысяч файлов, каждый из которых является отдельной главой руководства. Форматы HTML и обычного текста доступны в качестве файлов tar, упакованных архиватором bzip2.

Другим популярным кросс-платформенным форматом, к тому же наиболее подходящим для печати, является PDF (также известный как Adobe Acrobat). Но прежде чем вы начнете загрузку этого формата и нажмете на кнопку Печать, имейте в виду, что руководство состоит примерно из 2000 страниц и постоянно обновляется.

Замечание: Если у вас еще нет программы для просмотра формата PDF, вам нужно будет загрузить Adobe Acrobat Reader.

Для владельцев Palm-совместимых компьютеров идеально подойдут форматы руководства Palm document и iSilo. Вы можете захватить с собой ваш Palm, например, на совещание и использовать программу чтения форматов DOC или iSilo как удобный справочник или чтобы просто освежить в памяти какие-либо сведения о PHP.

На платформах Windows доступна версия руководства в формате HTML, который может быть просмотрен с помощью приложения Windows HTML Help. Эта версия предусматривает поиск по тексту руководства, полный список тем и поддержку использования закладок. Многие среды разработки PHP-программ в Windows также используют эту версию для легкости доступа.

Замечание: В данный момент проект Visual Basic для Linux находится на стадии планирования и будет включать CHM Creator и CHm Viewer для Linux. Если вы заинтересованы в том, как идет разработка, посетите страничку проекта на SourceForge.net.

add a note User Contributed Notes
Об этом руководстве

kulakov74 at yandex dot ru
21-Aug-2007 08:38


I improved the script php_manual_prefs.js provided with the extended chm-version to better hilight user comments and code samples as I found those in the original version too dull (gray). Note that this all cannot be done using stylesheets only as the code samples in the chm-docs do not have any distinct classes etc and can only be parsed with a script. What I added to the original script follows. The timeouts are used because the page is not loaded right at once so we have to wait for complete loading. The colors (aColorMap) can be customized. This also improves navigation links positioning in short pages, so instead of directly following contents they are now bottom-aligned. This fix needs some extra styles so they follow the code, along with some general styles. 



setTimeout("AddStyles(); window.focus();", 50);



//-----------



var D, TimerId, oNav, oPage;



function AddStyles(){

D=document; ChangeExamples(); ChangeNotes();

}



function ChangeExamples(){

var aDivs, DivNo, oDiv, aSpans, SpanNo, oSpan, aColorMap, Color, aCodes;



aColorMap=[];

aColorMap['#007700']='yellow';

aColorMap['#0000bb']='white';

aColorMap['#dd0000']='yellow';

aColorMap['#ff8000']='Aqua';

//aColorMap['']='';



//Scan examples

aDivs=D.getElementsByTagName('DIV');

for(DivNo=0; DivNo<aDivs.length; DivNo++){

    oDiv=aDivs[DivNo];

    if (oDiv.className!='examplecode') continue;

    //Change colors

    oDiv.style.backgroundColor='black';

    oDiv.style.backgroundImage='none';

    //oDiv.style.color='white';



    aSpans=oDiv.getElementsByTagName('SPAN');

    for(SpanNo=0; SpanNo<aSpans.length; SpanNo++){

        oSpan=aSpans[SpanNo];

        Color=oSpan.style.color;

        oSpan.style.color=aColorMap[Color];

        if (Color=='#dd0000') oSpan.style.backgroundColor='DarkRed';

        oSpan.style.fontFamily='Lucida Console';

        }

    aCodes=oDiv.getElementsByTagName('CODE');

    for(SpanNo=0; SpanNo<aCodes.length; SpanNo++){

        oSpan=aCodes[SpanNo];

        oSpan.style.color='yellow';

        oSpan.style.fontFamily='Lucida Console';

        }

    }

}



function ChangeNotes(){

var oNotes, oDiv, aDivs, DivNo, oP, aPs;



oNotes=D.getElementById('pageNotes');

if (!oNotes){

    setTimeout('ChangeNotes();', 100); return;

    }

aDivs=oNotes.getElementsByTagName('DIV');

for(DivNo=0; DivNo<aDivs.length; DivNo++){

    oDiv=aDivs[DivNo];

    aPs=oDiv.getElementsByTagName('P');

    oP=aPs[0];

    oP.style.backgroundColor='DarkGreen';

    oP.style.color='yellow';

    oP.style.marginBottom='0px';

    oP=aPs[1];

    oP.style.backgroundColor='LightYellow';

    oP.firstChild.style.fontFamily='Lucida Console';

    //oP.firstChild.style.fontSize='12px';

    oP.style.border='1px solid DarkGreen';

    oP.style.borderTopWidth='0px';

    }



//return;

oNav=D.getElementById('pageNav');

oPage=D.getElementById('pageContent');

AlignNav(); window.onresize=AlignNav;

}



function AlignNav(){

var Pos, NavBottom, Diff;



Pos=AbsPos(oNav);

NavBottom=Pos[1]+oNav.offsetHeight;

Diff=oPage.offsetHeight-NavBottom;

if (Diff!=0) oNav.style.top=(Diff+oNav.style.posTop)+'px';

}



function AbsPos(O, Parent){

var X=0, Y=0, Next;



Next=O; if (Parent==null) Parent=D;

while (Next!=null && Next!==Parent){

    Y+=Next.offsetTop; X+=Next.offsetLeft; Next=Next.offsetParent;

    }

return [X, Y];

}



//----------

This is to be added in style.css:



Body{

    font-family: Verdana;

    font-size: 80%;

    height: 100%;

}



P{

    text-align:justify;

}



#pageContent{

    height: 100%;

}



#pageNav {

    position:relative;

}



.literal{

    background-color: LightCyan;

}



TR.question TD{

    background:LightYellow;

} 



TR.answer TD{

    background:#F0FFF0;

}

add a note

Приложение S. Об этом руководстве

Форматы