[Tutorial] Ръководство за бърз старт (BG)

[Bob]

Megazine 3 - Ръководство за бърз старт

Колкото и фундаментално да е представено това ръководство, все пак би било добре и необходимо да имате основни познания и поне веднъж да сте работили с HTML и / или XML.
За всеки един от следващите линкове към файловете, се приема, че съдържанието на bin-папката на изтегленият от архива вариант е разопакована и се намира в основната директория на вашата работа. Ако например съдържанието на bin-папката е разопакована в C:\МоятMegaZine\, следва че сега е това е главната директория и трябва непременно да съдържа файла index.html, а и трите папки наречени - swfobject, swfaddress и megazine.


1 - Основни Настройки

1.1 - Размер на страницата
Ако искате да промените размера на страницата са необходими само две корекции.

1.1.1 - XML
Като първо е промяната в XML файла. Отворете файла megazine.xml в подпапката Megazine. Тук ще видите един (Tag) Индикатор с името book (един Индикатор (Tag) – е един елемент в XML, и е плациран (затворен) между две остри скоби (<...>)). Добавете там следните две характеристики:

pagewidth и pageheight и нанесете съответно желаната ширина и височина на страницата
Един пример:
Да предположим, че искате страниците да са 300 пиксела широки и 200 пиксела високи. След промяната ще видите, че XML файла ще изглежда така:

Code: (xml)

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE book SYSTEM "http://megazine.mightypirates.de/megazine.dtd">
<book pagewidth="300" pageheight="200">
    <chapter>
        <page>
        </page>
    </chapter>
</book>

Това означава, че за сега сте готови с размерите в XML-файла.

1.1.2 - HTML

Update: Този раздел може междувременно да се прескочи, тъй като размерът е динамичен (когато е зададена процентна стойност в CSS). Ако все пак искате или сте принуден ръчно да промените размерите, трябва да се уверите, че сте нанесли абсолютени размери в CSS-Спецификацията (Klasse #megazine), защото в противен случай, информацията в сценарийният (script)-раздел няма да има ефект.

За да има достатъчно място в сайта за Flash(а), ще трябва да се направи малка промяна в HTML файла.
Отворете файла index.html в главната директория.
Потърсете <script> блока в заглавната част на файла.
Тук трябва да нанесете ширината (Стандарт (default) 750, маркирана с (1)) и височината (Стандарт (default) 700, маркирани с (2)).
По правило като основна формула може да бъде приета:

Ширината = Ширина-Страница * 2 + 200
(width = pagewidth)
и
Височината = Височина-Страница * 2
(height = pageheight)

...с ограничението, че изчислената височина функционира, само ако страните са по-високи, отколкото широки.
Правилната математическа формула за минимална височина - така че при прелистване, страниците да не биха могли да бъдат отрязани - е както следва:

Височината = корен²(ШирСтр * ШирСтр + ВисСтр * ВисСтр) * 2 - ВисСтр
height = sqrt(pagewidth * pagewidth + pageheight * pageheight) * 2 – pageheight

или с други думи – диагоналите на страницата по 2 минус Височината на Страницата!
В този случай няма да сгрешите ако зададете по-голям размер за да може (при активиране) да се види по-голяма ивица от огледалното отражение на страницата. Освен това, когато страниците са доста повече, ще има съответно достатъчно място и за навигацията (ивицата на символите за единичните страници).
Алтернативно можете да направите опити с различни размери, докато намерите оптималното решение.
Малко математически засегнато, но това е всичко. По този начин размера на страниците са адаптирани успешно.

1.2 – Цвят на фона

Ако искате да използвате друг, различен цвят за фон на сайта, можете да го направите по следният начин:
ако сте го затворили, то отворете отново файла index.html.

На същото място, където зададахте размерите на страниците (вижте предишната точка), можете да нанесете вашият параметър за желаният от вас фонов цвят (вижте за фон (bgcolor:), със стойност #333333 (маркиран с (3)) в (в HTML / CSS формат, т.е. зададен като хексадецимално означение с водещ символ #). Ако това нищо не ви говори, погледнете тогава тук: (Уикипедия на Webcolor) за съжаление на английски. След това намерете секцията style-в заглавната част на файла, и по-точно текста background: #333333; (маркирани с (5)). Променете стойността на фона със съща стойност, както преди това (виж по-горе!).

Като алтернатива също можете да ползвате фоново изображение (Снимка). Отстранете двете наклонени черти (//) маркирани с (4) и напишете в CSS формат в дясно след background: в замяна на цвета,  както следва (като пример):
background: url("пътека (pfad)/до/а/ снимка.jpg");.
background: url('megazine/src/images/image.jpg');.
Това е всичко!


2 – Cъздаване на страници

2.1 - Създаване на елементи на страницата

Сега след първото преодоляно препятствие, можете да започнете да създавате своите страници. За да направите това, отворете файла megazine.xml в подпапката Megazine.
Копирайте блока <page></page>- (<страница></ страница>), толкова пъти, колкото ще са и страници ви, така че за всяка страница да имате елемента <page></page>.
Моля, имайте предвид, че елемента <page></page>  представлява само една страница (т.е. видимият единичен лист от ляво или дясно в книгата), а не като цяло - двойната страница.
Двойната страница (представлява всъщност физическата страница) се състои от два елемента-страници. Това означава, че винаги е необходимо броят на страниците да е четен. Ако броят на страниците е нечетен, то автоматично последната страница ще е празна.

2.2 - Настройка на страниците - Свойства

Има няколко основни настройки, които трябва да знаете:
Атрибутите на страниците са - bgcolor, foldfx и stiff.

• bgcolor
  Позволява индивидуален избор на цветове за фона на отделните страници. Това е важно, евентуално в случай, че страницата не е покрита напълно от снимка или от някакъв друг елемент се вижда фоновият цвят на непокритата част от страницата. Цифровият параметър не трябва да е форматиран като хексадецимални цифри, но от съображения за за по-добра четливост, непременно се препоръчва  да се използва. За разлика от определянето на цвета на фона при сайта, тук трябва да се нанесе хексадецимално цифрово означение за начало с 0x, а не с # знак.
  (пример: нанесете така 0x333333, а не #333333).
• foldfx
  Определя дали на страницата има фалцов ефект (folding effect) или не, т.е. светло-сянкови ефекти в средата на книгата, която трябва да създаде усещането, че страниците са огънати (ефект придава усещането за пластичност). Въпреки, че не би било необходимо да промените тази настройка, все пак  би било уместно да се направи това ако имате голяма снимка в рамките на две страници. Параметър на атрибут за фалцов-ефект е: 0(без ефект) или 0.5(слаб ефект) или 1(силен ефект).

Code: (xml)

<page foldfx="0.5"><img src="../../src/images/image.jpg"/></page>

• stiff
  Ако атрибутът за страницата е дефиниран като истина (true), означава че страницата е корава, т.е. като подвързия. Дори, ако тази настройка може да се използва навсякъде в книгата, то се препоръчва само за първата и последната страница. Достатъчно е да се постави този аргумент само за един елемент на една страница т.е. "физическа" страница.

Страница с някои от тези атрибути може да изглежда така:

Code: (xml)

<page bgcolor="0xFF0000" stiff="true"></page>

...корава страница с червен фонов цвят. Тъй като коравите странници нямат фалцов-ефект той не е и дефиниран.
Още един пример:

Code: (xml)

<page bgcolor="0x0000FF" foldfx="0"></page>

Това е синя (нормална) страница без фалцов-ефект.

2.3 – Поставяне съдържанието в страница

Да разгледаме най-простият случай и приемем, че за всяка страница имаме точно по една снимка. Тя изпълва и интерпретира цялата страница на книгата. Създайте при всеки page-Елемент на тази страница един img-Element, който посочва местонахождението на снимката в директорията. Това изглежда така:

Code: (xml)

<img src="path/to/my/image.jpg">

Относителната пътека (pfad) е относителна спрямо megazine.swf-Файла в папката megazine.
Ако е необходимо да го направите за всяка страница, то вашият XML-Файл би трябвало да изглеждал така:

Code: (xml)

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE book SYSTEM "http://megazine.mightypirates.de/megazine.dtd">
<book>
    <chapter>
        <page>
            <img src="src/cover_outside.jpg"/>
        </page>
        <page>
            <img src="src/cover_inside_and_inprint.jpg"/>
        </page>
        <page>
            <img src="src/content.jpg"/>
        </page>
        <page>
            <img src="src/some_picture.jpg"/>
        </page>
        <page>
            <img src="src/cover_back_blank.jpg"/>
        </page>
        <page>
            <img src="src/cover_back_outside.jpg"/>
        </page>
    </chapter>
</book>

В този случай всички снимки на img-тага със src-атрибута се намират в папката под името megazine/src.
Всъщност това е еквиваленнтно при използването на img-Елемента в HTML.

Това е основата - достатъчно проста - за създаването на една Книга/Албум. За повече възможности хвърлете поглед на документацията, която съдържа пълен списък на всички елементи, включително техните атрибути.
И накрая добра идея е да проверите (валидирате) файла megazine.xml за печатни и синтактични грешки. За една добра проверка вижте например сайта тук.