MegaZine3 Tutorial für Producers of MegaZine3 Books

Transcrição

MegaZine3 Tutorial für Producers of MegaZine3 Books
®
MegaZine3 Tutorial
für Producers of MegaZine3 Books
Basics about the Creation of
MZ3-Books
Download
mz3_producer_en.pdf
Draft:
1-1-10
MegaZine3 is free for personal use
MZ3-Version:
V2.0.x
Commercial Licenses are available in our shop
Last changed:
Feb-9, 2011
MZ3-Tutorial for MZ3 Book Creators
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9, 2011
Chapter Overview
Quickstart ...................................................................................................................................... 6
Tools .............................................................................................................................................. 9
Installation of the Demo Package ................................................................................................. 16
Tips & Tricks & FAQs..................................................................................................................... 25
Common Problems and Solutions ................................................................................................. 27
General Information ..................................................................................................................... 28
Forum summary Book .................................................................................................................. 30
Online Demo Book ....................................................................................................................... 30
MegaZine3 Software (Binaries nightly Build) You can find links to Binaries and Sources at our
Homepage under the tab Tab „MZ3-Download Links“................................................................... 30
Demo-Package: mz3_creator Tools (Batch-Dateien), Beispiel-Bilder, Video- und Audio-Dateien .... 30
Copyright © 2010 VservU GmbH
All rights reserved
2
MZ3-Tutorial for MZ3 Book Creators
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9, 2011
Table of Content
Quickstart ________________________________________________________________________6
The fast guide for the impatient user ___________________________________________________6
Preparation _____________________________________________________________________________________ 6
PDF-Conversion _________________________________________________________________________________ 6
Configuration and Settings _________________________________________________________________________ 6
Photo Book _____________________________________________________________________________________ 7
Demo-Book (short version) ________________________________________________________________________ 8
Tools _____________________________________________________________________________9
Topics discussed in this Chapter? ______________________________________________________9
Notepad++ - contect sensitive Editor ___________________________________________________9
Download and Installation _________________________________________________________________________ 9
Use of notepad++ ________________________________________________________________________________ 9
pdf2swf – Tool to convert PDF files into swf Pages _______________________________________12
Download the swf Tools _________________________________________________________________________ 12
Adjustment of the installation path _________________________________________________________________ 13
Use of the pdf2swf Tools _________________________________________________________________________ 14
Graphic Tool xnview ________________________________________________________________15
Installation of the Demo Package ____________________________________________________16
MZ3 Demo Book: Creation and working with the MZ3 Demo Book ___________________________16
Topics of this Chapter? ___________________________________________________________________________ 16
What is needed to create the demo book? ___________________________________________________________ 17
Preparations to create the base folder ______________________________________________________________ 17
Download and extraction of files of the Demo Package _________________________________________________ 17
Description of the base folder structure _____________________________________________________________ 18
Discussion: Batch file _config_d_demo_en.bat ________________________________________________________ 18
Bulding the Demo Book __________________________________________________________________________ 19
Discussion: The MZ3 configuration file megazine.mz3 __________________________________________________ 20
Final Remark______________________________________________________________________23
Photo Books ______________________________________________________________________24
Tips & Tricks & FAQs _______________________________________________________________25
Allgemeine HinweiseSolving the “FLASH sandbox“Problem _________________________________25
Common Problems and Solutions _____________________________________________________27
General Information _______________________________________________________________28
Copyright © 2010 VservU GmbH
All rights reserved
3
MZ3-Tutorial for MZ3 Book Creators
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9, 2011
Overview Terms and Abbreviations ____________________________________________________28
Helpful Links ______________________________________________________________________30
General Links providing more Information about MegaZine3 ____________________________________________ 30
Forum summary Book ______________________________________________________________30
List of Sample Books and Videos ___________________________________________________________________ 30
Online Demo Book _________________________________________________________________30
MZ3-Software und Demo-Packages ________________________________________________________________ 30
MegaZine3 Software (Binaries nightly Build) You can find links to Binaries and Sources at our
Homepage under the tab Tab „MZ3-Download Links“ ____________________________________30
Demo-Package: mz3_creator Tools (Batch-Dateien), Beispiel-Bilder, Video- und Audio-Dateien __30
Free Tools and Software __________________________________________________________________________ 30
Affordable Tools and Software ____________________________________________________________________ 30
Copyright © 2010 VservU GmbH
All rights reserved
4
MZ3-Tutorial for MZ3 Book Creators
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9, 2011
Remarks
This Manual is he second of 4 Books
1. MegaZine3 Manual and Introduction
2. Tutorial about the Creation of MegaZine3 Booksl
3. Guidelines for Developers and Designers (in preparation)
4. Price List and License Agreement
The first book explains the use of MegaZine3 books and some basic concepts; and summarizes the
features. It is highly recommended to read those chapters before studying this book.
This tutorial is addressing all those who want to create books. It helps to organize all the folders and
files and provides the background information needed to make best use of the features and functions
of MegaZine3.
The third book is for advanced users, developers and designers looking for ways to adjust the book to
their needs, expand the features and change the look&feel.
Also topics like integration into CMS systems or swf pages, the connection to Facebook, use of
Youtube and forms, email, Google Analytics and interactive expansions will be discussed.
This book is not ready yet. We expect to have the first draft available in August 2010.
The fourth book provides details about our license types for commercial users and the license
agreement.
Hint
This is a first, incomplete and not fully corrected and tested version. The first chapters should be usable already, but some links might be outdated or incorrect. Please bare with us, we’ll work on completing and correcting the chapters ASAP.
But what is available already will be helpful nevertheless. Therefore we decided to publish this first
draft despite those deficiencies.
Thank you for your understanding… and a lot of success and fun with MegaZine3; nevertheless ;-)
Copyright © 2010 VservU GmbH
All rights reserved
5
MZ3-Tutorial Quickstart
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9, 2011
Quickstart
The fast guide for the impatient user
This chapter is dedicated to those who hate reading documentation and an early hands on practice.
This is a how-to for two special use cases are: PDF conversion and photo books.
We prepared a special configuration file for both use cases.
We recommend reading later chapters also, which explain the logic behind naming conventions,
folder structures and the use of the tools. This will help to get the most out of MegaZine3.
The Fehler! Verweisquelle konnte nicht gefunden werden. is a good next step giving an overview
about several features of MegaZine3.
Preparation





Create a new base folder (location and name can be freely selected)
Declare that base folder as trust worthy for use with FLASH
Download MegaZine3 Binaries and unzip/copy into the base folder
Download mz3_creator Tools and unzip/copy into the base folder
Download and install notepad++ (context sensitive text editor) and install
PDF-Conversion






Download and install pdf2swf Tool and unzip/copy into the base folder
Download _config_quick_pdf.bat and unzip/copy into the base folder
start _config_quick_pdf.bat (double click).
The folder _custom_files/c_quick/pdf will be created
Copy a PDF file of your choice the folder _custom_files/quick
Rename that PDF file to quick_pdf.pdf (i.e. bookname = quick and version name = pdf)
Start _config_quick_pdf.bat again.
Now the PDF file will be converted to swf-pages and a MZ3-Buch will be created and shown.
Configuration and Settings


Modify the file _config_quick_pdf.bat with notepad++ to adjust e.g. page count
Create the search index file (see chapter Fehler! Verweisquelle konnte nicht gefunden werden.)
preparation
Copyright © 2010 VservU GmbH
All rights reserved
PDF conversion
configuration
search settings
6
MZ3-Tutorial Quickstart
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9, 2011
Photo Book
Preparation:





All Preparation as discussed before
Download _config_quick_foto_en.zip and unzip/copy into the base folder
Copy the downloaded folder and files to the base folder and confirm that a combination of an
existing _custom_files folder with the downloaded one is OK (if that folder already existed).
Either use the provided sample photos or optionally copy your own .jpg or .png photos into
the folder _custom_files/c_quick/de/jpgpng
Most probably you have to rename your photos, because they must be named like img_l1,
img_l2, … with the proper extension .jpg or .png.
If you would like to use higher quality photos for higher zoom levels, you also have to provide
the respective img_h1, img_h2, … versions.
The „Graphic Tool xnview“ or a similar program can be used for those tasks
Version 1: using Plugin Batchpages

Start _config_quick_foto_b.bat (double click)
This creates a MZ3 books and opens it in your browser. Up to 10 photos will be positioned,
each on a single page. The photos will be scaled to fit the page. Aspect ratio of a page is configured to 4:3
Version 2: Single Pages

Start _config_quick_foto_p.bat
This creates a MZ3 books with 4 pages and opens it in your browser.
You can adjust the file quick/foto/megazine.mz3 which describes the MegaZine3 book.
You could copy the 4 sample pages, adjust the name of the files with the photos and with this can
easily create a book with more pages.
You also can adjust the base name of the photo files in the batchpage plugin.
If you have photos in portrait format or images of different aspect ratio than 4:3 you also have to
make some adjustments.
It is also possible to distribute several images on one page..
Detailed hints can be found in chapter Photo Books
Preparation
Photo Book
Copyright © 2010 VservU GmbH
All rights reserved
Version 1
(in preparation)
Version 2
(in preparation)
Configuring the
photo book
7
(in preparation)
MZ3-Tutorial Quickstart
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9, 2011
Demo-Book (short version)
The MegaaZine3 Demo Book uses several different features combined in one book and also can serve
as base for own books. Useful parts can be copied and modified, unused parts can be deleted, new
elements can be added.
These compents are part oft he package:
 Full MegaZine3 Frameworks (Binaries, recent nightly build)
 A directory with sample date
o A PDF File and the already converted swf pages
o Some jpg and png Images
o 2 videos (mp4 and f4v format)
o 1 audio files (mp3)
 Complete set of mz3_creator command files (batch files to supprot in creating MZ3 books)
 A preconfigured _config_d_demo.bat file , which quickly creates a working MZ3 book making
use oft he sample data. An Offline version will be created (prepared to be copied on CD; ready
to run without browser and Flash plugin).
Creation of the demo book


Download Demo-Package (ca. 60 MB) and unzip/copy into the base folder
Start _config_d_demo_de.bat
An Offline MZ3 book will be built, based on the sample data
The file megazine.mz3, which will be interpreted by the MegaZine3 Software, is after a successful run
of the command file located in folder d_cd/demo/megazine/.
This file can be analysed with an editor like notepad++.
Creation of “mini demo books”



_config_d_jpgB.bat
_config_d_jpgP.bat
_config_d_pdf.bat
Builds Online book with 8 images, using batchpages
Offline book with 4 single pages
Offline book with 8 pages, converted out of the PDF file
A detailed step by step tutorial is provided in chapter Installation of the Demo Package.
Videos not ready yet!
Vorbereitung
Demobuch
Copyright © 2010 VservU GmbH
All rights reserved
komplettes
Demobuch
Minibücher
Anpassung
Demobuch
8
Hilfsprogramme
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Tools
Topics discussed in this Chapter?
In this chapter we discuss some tools we believe being helpful. We give support in installing those
tools that are available for free.
You can find a list of links at Free Tools and Software. Tools discussed here are:



swf-tools (standard tool to convert PDF files into swf pages)
notepad++ (context sensitive editor)
xnview (tool to manage, change, rename pictures)
Notepad++ - contect sensitive Editor
Notepad++ is free and knows about many different „languages“. It is capapble to color code different
code swgments. Here an extract of languages supported:






XML
HTML
BATCH
C#
PHP
Python
The MegaZine3 control file megazine.mz3 is an xml file, despite is’s extension .mz3.
That special extendion is used to distinguish mz3 files from other file types. The same is true for
*.asul files, which are xml files also but special configuration files used by MegaZine3 to define the
look and feel (like color and show of butiins, postion of GUI elements, …).
Please configure notepad++ to use „XML“ settings to show .mz3 and .asul files.
Download and Installation
Notepad++ is free and available in many servers, e.g. at Heise.
After downloading the file the installation is quickly done; jsut accept all suggested settings.
Use of notepad++
For MZ3 purposes these two settings are of importance:
1. For the use of .mz3 and .asul files:
2. To edit Batch files (to adjust parameter settings):
Copyright © 2010 VservU GmbH
All rights reserved
language: XML
language: BATCH
9
Hilfsprogramme
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Without the setting of a (programming-) language, only black/white text is presented. Which makes
reading pretty difficult. and syntax errors (like missing paranthesis) are difficult to detect
Here an example of the _config.bat file with standard settings:
If you select BATCH as language:
Copyright © 2010 VservU GmbH
All rights reserved
10
Hilfsprogramme
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Everything becomes much easier to be read…
Besides the capailities of every editor like search and substitute, notepad++ is able to substitute
strings in all files in a folder, a file comparison line by line is supported and much more.
The comparison of files is extremely helpful if you want to check for changes in configuration
settings.
Here an example of such a line by line comparison:
Lines with differences are color coded.
It is possible to jump directly to the
next difference.
These are some of the features of
notepad++.
Just play a bit and you will find out
many more helpful features.
Copyright © 2010 VservU GmbH
All rights reserved
11
Hilfsprogramme
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
pdf2swf – Tool to convert PDF files into swf Pages
Download the swf Tools
Click on the link below to download the pdf2swf tools. The latest version of the tools can be found
directly at http://www.swftools.org.
The installation is shown in a short video.
pdf2swf Tools
Video
After a successfull installation PDF files can be converted.
Our suggested „workflow“ making use oft he mz3_creator tools is explained in chapter Fehler! Verweisquelle konnte nicht gefunden werden..
The logic behind the suggested structure of folders and naming conventions are explained in chapter
Fehler! Verweisquelle konnte nicht gefunden werden..
The Open Source software pdf2swf is used to convert all pages of aPDF file into single swf pages.
we know and describe the use under Windows only. The pdf2sqf tool can also be used under Linux
(most probably also the MAC is supported), but we cannot give any guidance for those platforms.
Besides the use of pdf2swf as part of our mz3_creator tools ((see chapter Fehler! Verweisquelle
konnte nicht gefunden werden. and Fehler! Verweisquelle konnte nicht gefunden werden.), this
tool also can be used stand alone to convert PDF files.
This can be done either using the command line, or together with the program pdf2swf_gui.exe,
which is installed together with pdf2swf and offers a graphical interface. This kind of use could be
helpful to find out the best fit set of parameters for an optimal conversion of PDF pages.
Copyright © 2010 VservU GmbH
All rights reserved
12
Hilfsprogramme
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
This is a snapshot oft he user interface of pdf2swf_gui
Adjustment of the installation path
The pdf2swf program is expected to be located a tone of these paths:



C:\Program Files (x86)\SWFTools\pdf2swf.exe
C:\Program Files\SWFTools\pdf2swf.exe
C:\SWFTools\pdf2swf.exe
If the pdf2swf.exe file cannot be found at one of these locations, an error message asks to either provide the program or to adjust the path settings.
Such adjustment can be made directly in the _mz3_creator.bat file. The row with the definition tob e
changed looks like this:
SET PDF2SWF=C:\Programme\SWFTools\pdf2swf.exe
You can search for SET PDF2SWF; that row is in the range of row number 560.
Please change the path c:\Programme\SWFTools\ tot he correct path where pdf2swf.exe is located
on your computer.
Copyright © 2010 VservU GmbH
All rights reserved
13
Hilfsprogramme
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Use of the pdf2swf Tools
If you use the mz3_creator tools (i.e. _config.bat, _make_book.bat, _mz3_creator.bat), you do not
need to care about pdf2swf. The only reason might be to optimize the parameters/switches controlling the conversion to make some tweaks.
Links to a summary of such pdf2swf parameters and switches can be found in chapter Fehler! Verweisquelle konnte nicht gefunden werden..
Copyright © 2010 VservU GmbH
All rights reserved
14
Hilfsprogramme
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Graphic Tool xnview
If you have to rename many pictures, want to create copies of images with new format or quality or
similar jobs, you should have a look at xnview.
The way to operate that tool is not really intuitive, but learning how to make use o fit is worth the
effort.
Renaming of files is achieved with the command batch-renaming (sorry, I have no English version at
hand)..
With this names of images can be modified in exchanging single characters or part of the name. Or
build the name from scratch based on defined algorithms
A batch conversion support many ways of format changes.
A link for download is provided in chapter
Free Tools and Software
Copyright © 2010 VservU GmbH
All rights reserved
15
Demo-Package
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Installation of the Demo Package
An english version is available as mz3_d_demo_en.zip Datei for download on our server.
This step-by-step instruction shows how to build and run the demo book on your computer:
1. Download the package (60 MB!)
2. Create a new folder (name and location at your choice) which we will call base folder and
copy/unpack the files into that folder (WinZip and 7Z are useful tools for it if your system does
not support zipped folders).
3. Call the batch file _config_t_demo_de.bat with a double click
4. At the end of the creation process please hit any key (after reading the messages) to start the
demo book
5. Flip the book to check out the built in features. You also can use the online version of the
book available here: Online Demo Book
6. Check out the created megazine.mz3 file in folder
base_folder/d_cd/demo/megazine/
Use a text editor (suggested: notepad++) for that, and get a feeling about how a complex configuration file looks like. You will make adjustments later directly in those files, since it is the
most powerful and fastest way.
That’s all, and hopefully short enough also for the impatient reader ;-)
MZ3 Demo Book: Creation and working with the MZ3 Demo Book
Topics of this Chapter?
We show in detail how to install the mz3_creator tools and crate the demo book, and then do some
detailed analysis of the megazine.mz3 file.
Details will be discussed in the following chapter. In this chapter we’ll cover:




Download and installation oft he demo package
You can download everything packaged in one zip file as Demo Package (EN) .
Create the Demo Book
Using the components that are part of the package (images, vido and audio files) and using
the mz3_creator tools, a working demo book will be built.
Flip the book on your local PC
Check out the megazine.mz3 file.
Copyright © 2010 VservU GmbH
All rights reserved
16
Demo-Package
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
What is needed to create the demo book?
You will need this to successfully build the demo book on your PC:
 A computer with some free disk space (>200 MB)
 A fast internet connection; the faster the better ;-)
 A text editor
You could use even WordPad (in case of Windows), but we suggest to use a context sensitive
editor like notepad++. Links are provided in chapter Free Tools and Software, and a detailed
description can be found in chapter Notepad++ - contect sensitive Editor
 The Demo Package with these components:
 Sample data
 Some sfw pages
 some jpg images
 a png page for the front cover
 audio files (mp3 format)
 video files (in .f4v and .mp4 format)
 The MegaZine3 Software in Binary form (the MegaZine3 frame work)
 The MZ3-FLASH program for Windows (megazine.exe), to create and view an Offline book
(without the need of an internet connection and browser)
 The mz3_creator Tool:
3batch files supporting the creation of MZ3 books.
The automatic conversion of PDF files into MZ3 books will be discussed in chapter
Fehler! Verweisquelle konnte nicht gefunden werden.
Preparations to create the base folder
A new, empty folder should be created, the base folder. This folder will hold the mz3_creator batch
files, the components of the books, the books, the MegaZine3 software.
Name and location can be freely chosen. The mz3_creator tools need red/write permission for all
folders and files in the base folder.
This new folder will be called base folder throughout this tutorial..
Download and extraction of files of the Demo Package
Download the demo package in clicking on this button:
Be patient, size is about 60 MB!
Demo Package (EN)
The packed files in the ZIP folder must then be extracted/copied to the base folder. If your operating
system dows not support zipped files natively, you can use Winzip or 7Z for that..
Copyright © 2010 VservU GmbH
All rights reserved
17
Demo-Package
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Description of the base folder structure
The general structure of the base folder is the same as explained in chapter Fehler! Verweisquelle
konnte nicht gefunden werden. in detail.
This is a snap shot of the base folder content after the files of the demo package had been extracted.
All batch files of the mz3_creator tools start with a „_“.
Supporting files start with the letter „z“.
Discussion: Batch file _config_d_demo_en.bat
This file was created by copy out of the (template) file _config.bat.
This was performed by the batch file _make_book.bat, You always should start with this file first
when creating a new book. Then some parameters had been modified so you just have to start that
file to create the demo book fully automatically. You can edit and analyse _config_d_demo_en.bat
with notepad++. All parameters are explained with comments.
More details about the use oft he mz3_crator tools will be given in chapter Fehler! Verweisquelle
konnte nicht gefunden werden..
The following screenshot gives a first feeling about the content of that file.
Copyright © 2010 VservU GmbH
All rights reserved
18
Demo-Package
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Example of the _config_d_demo_en.bat file.
Comments are in green. Parameters are defined by SET. You can adjust the behavior of your
MegaZine3 book in changing these parameters.
Bulding the Demo Book
The demo book is built using the components provided in folder _custom_files/d/demo/.
First the batch file _config_d_demo_de.bat then the _config_d_demo_en.bat should be started with
a double click. Both batch files create the respective language version of the book; without interac-
Copyright © 2010 VservU GmbH
All rights reserved
19
Demo-Package
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
tion. Some details about the conversion process including what files are found and used are output
in the command file window.
Both batch files are identical but the parameter language.
The demo book works as offline version without internet connection
and browser. All steps are shown in the (to be updated!) Video
Hint:
To have both languages supported at the same time, you must run both versions once. After that you
should start the file _config_d_demo.bat, which as only difference has a language list defined as
lang_list=de,en
This creates a book with both languages and adds the language selector (the country flags) to the
navigation bar.
Discussion: The MZ3 configuration file megazine.mz3
The _config files (or more precisely the batch file mz3_creator.bat which is called by the _config
files) create a new folder named d_cd/demo/. This folder holds all files needed to run the final book.
Those are e.g. the images (on folder d_cd/demo/en/jpgpng/), the swf-files (in folder
d_cd/demo/en/pages/) and the MZ3 control file megazine.mz3 in folder d_cd/demo/megazine/
The Flash program megazine.exe is located in folder d_cd/demo/megazine/.
Copyright © 2010 VservU GmbH
All rights reserved
20
Demo-Package
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
To start a book, that file megazine.exe must be called.
If an autostart of a CD/DVD is enabled, this is performed by the autoexec.ini file, which will start the
book automatically when the CD is inserted.
If you are a MAC user, you need the folder megazine.app. A link to that file is provided in chapter
Fehler! Verweisquelle konnte nicht gefunden werden.. The megazine.mz3 file defines an MZ3 book.
The definitions in this file are interpreted by the MegaZine3 Software and at the end make the Page
Flip Book.
This is an example of a megazine.mz3 file::
This section shows the declaration oft the Plugins and the book parameters, followed by the declaration of bookmarks.
Copyright © 2010 VservU GmbH
All rights reserved
21
Demo-Package
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
The following screenshot shows the first chapter of the demo book, which just defines the front cover, followed by the chapter with the swf pages, where (batch)pages is used. Then the declaration of a
single page with audio (<snd> element), two overlayed images (<img> element) and a video file
(<vid> element). follow.
Details on batchpages:
The Plugins batchpages only needs a few rows of definitions, starting with the tag pages, to define all
swf pages. The number of pages is defined with the parameter count.
Here we have 3 definitions/rows:
1. the path names for the two different language versions (with low quality images):
pages_lxx.swf
2. the path names for both supported languages in higher quality:
pages_hxx.swf. The selection of either the low or high quality images is defined by the zoom
parameter scale, here set to the value of 2.
3. the path names to those files (again by language) that will be used in case of print. Here the
same high quality files are used.
Copyright © 2010 VservU GmbH
All rights reserved
22
Demo-Package
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Final Remark
The created MZ3 book (the megazine.mz3 file with all folders and files) can be analyzed for educational purposes. Details about the used plugins. elements and parameters can be found in the wiki
and forum; and in the following chapters..
Copyright © 2010 VservU GmbH
All rights reserved
23
MZ3 Photo Books
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Photo Books
Photo books can be built in several ways:




Using Tools like MS-Word, InDesign, Photoshop, Scribus, ??? the pages can be designed and
photos placed. After completion of the book a PDF file can be created, e.g. by „print as PDF
file“. That PDF file then can be converted as every standard PDF file making use of the
mz3_creator tools (see Fehler! Verweisquelle konnte nicht gefunden werden.).
Advantage:
easy combination of text, grphics and photos, text available in high quality (.swf files with
vvectorized text), easy and fast creation of complete books, full control of the design of the
book
Disadvantage:
Adding video and audio either needs programming in FLASH or a combination of batchpage
chapters and chapters with single, manually defined pages is needed
Definition of single pages
It is possible and after a first learning curve pretty easy to compile chapters and single pages
out of single elements using <img> for images/graphic files, <vid> for video date, <snd> for
audio and similar elements. With a text editor like notepad++ thise elements can be arranged
individually on pages. This is done by defining single command lines like
<img position=“middle center“ src=“images/img1.jpg“ />
This positions an image img1.jpg located in folder images/ centered in the middle of the page.
Advantage:
Full freedom defining the design of the page, option to additionally place active elements,
cloning of pages in copying single lines of „code“, all functions of MegaZine3 available.
Disadvantage:
steeper learning curve, higher risk of syntax errors (incorrect use of controls) with the need to
test and debug (e.g. using validome.org)
Use of mz3_creator Tools
The batchfiles suzpport the creation of sample books with 4 single pages. That working configuration file can be adjusted/modified and the lines of code defining a page can be easily
copied to build more pages.
Making use of our partner’s services
There are companies providing services to build and host books, with or without CMS systems. We plan to provide contact information once we tested such services and made some
own ecperiences with it. If you are interested, please contact us!
Copyright © 2010 VservU GmbH
All rights reserved
24
Lizenzfragen
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Tips & Tricks & FAQs
Sammlung von Hinweisen, Tricks, und Antworten zu häufig gestellten Fragen
Allgemeine HinweiseSolving the “FLASH sandbox“Problem
Flash is pretty picky regarding security, what in general is a good thing. But can drive you nuts ;-)
Flash does not allow moving deliberately across folder margins what is necessary if several books
should share one MageZine3 software installation.
Remark:
To have several different books sharing one MegaZine3 installation, the path and pointing to the
pages and images must be defined as relative path. Like “../book_1/pages/page_l1.swf
With „..“ telling the OS to go one folder up in the directory tree. Since all relative paths are based on
the location of the megazine/megazine.swf file, such relative path names are necessary.
To allow FLASH to move freely within a certain folder, that name of the folder must be added to the
list of folders accepted. This checking and security encapsulation also is known as “sandbox problem”. Try to google for that and you’ll get several hits!
Fortunately there is an easy way to overcome that problem, which only exists on your local PC. On
the server side this is not requested.
The link needed to adjust the settings can be found in right clicking inside the books; or to be more
precise: within the container of the book (close to the book edge will do it). Flash has to have the
focus also, so probably you have to left click into the book first.
With the right click the Adobe “about window” opens:
And after a clicking on the question mark (this is a new behavior with the latest version!) an Adobe
window opens where you can do your setting.
Copyright © 2010 VservU GmbH
All rights reserved
25
Lizenzfragen
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Click on „global security settings“so a new page opens where you can with setting add“ can add your
folder to the list.
After that FLASH allows free access within that folder. If
you create a new folder, you have to add that folder to
the list also… same procedure.
Please keep in mind:
If you run into enpty, grey pages, this whould ring a the „FLASH security setting bell“!
Another possibility is that the pages cannot be found or the path is incorrect. If you use the pdf2mz2
tools and carefully read the information presented, that usually is not the point. If you modify the
index and megazine.mz3 files directly (what is a common thing once you’re more experienced), this
might become your main problem. Then the console (hit the „#“ key when Flash has the focus) will
give you some hints; if it is enabled. What is the case if you use the pdf2mz3 tools ;-)
Also using http://validome.org can be very helpful to valiate your megazine.mz3 file. Again: ldf2mz3
should avoid those problems and create working files.
Copyright © 2010 VservU GmbH
All rights reserved
26
Lizenzfragen
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9,
2011
Common Problems and Solutions
Due to our worldwide presence, we encounter many different setups. We cannot test every possible
configuration, but this list of potential problems hopefully helps:
Effekt
Potential problem
No book, monitor Preloader file not found,
shows a complete- not called due to wrong
ly grey window
configuration of index.html or defect
Hints for solutions
Is there a file named preloader.swf in folder
megazine/? If not: run _set_version again and monitor the messages output in the window.
If there is a custom_preloader.sfw file, please rename or take out, so MegaZine3 is using the default
file.
Is another index.html working with MegaZine3?
No PDF conversion Pdf2swf not installed
correctly, path to
pdf2swf incorrect
Re-install pdf2swf (see Fehler! Verweisquelle konnte nicht gefunden werden.).
Adjust path to pdf2swf.exe in _set_param.bat. .
Book can be
opened and
flipped, but pages
are empty/grey
Click right into a grey page to have the Adobe
„about window“ opened. Change security settings to
allows access to your book folder.Solving the “FLASH
sandbox“Problem
Access denied by FLASH
security settings
PDF file password protected?
Take out pass word protection in PDF file
No swf pages converted
yet; no data available.
Wrong path to data
Are pdf pages present??
Check parameters you enter in _set_version.
Check information presented in command window.
Search plugin not
working
You need a special, sepa- Create such text file using Adobe Acrobat and save
rate text file as index file the text file into the folder _search_index.
fort he search
Creation in Acrobat is similar to
<File – save as text– Text (available)>
The message „install Flash Player“
pops up
No Flash Player available
or version outdated...
No MegaZine3 SW
present
Copyright © 2010 VservU GmbH
All rights reserved
Install Flash Player and/or update to latest revision..
Check if folder megazine\ is existent in your base
folder. Did you download the latest version of
MegaZine3 and unzipped into the base directory?
27
MegaZine3: Allgemeine Informationen zum MZ3-Tutorial
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9, 2011
General Information
Overview Terms and Abbreviations
Base Folder
Batch Files
Book Data
Folder to store all relevant data for the examples discussed in the tutorials
like sample files (in folder _custom_files), MegaZine3 Software, batch files
and the book folders.
Also called scripts or command files..
Collection of commands to run a sequence of commands automatically.
The mz2_create Tool is a collection of 3 Batch Files working together and
supporting in creating MZ3 books.
All Data files used as content for the MZ3 book. This can be complete swf
pages (usually the result of a pdf to swf conversion) or simply images in jpg
or png format, or video (mp4, fly, f4v) or sound (mp3).
These files are stored in dedicated folders by type:
Images
Folder jpg png/
Pages
Folder pages/
Video
Folder video(
Audio
Folder sound/
Thumbnails
Folder thumbs/
To create a MZ3 Book, the following files are needed also:
1. megazine.mz3
Central file, defining the MZ3 book
2 Index.html
Index file to start a MZ3 Book in a browser
3. Book_name.txt
Text file used as search index.
Demo-Order
Demo-Package
MegaZine3
MZ3
MZ3-Buch
Mz3_create Tools
Alternative name for Base Folder
Packed file in.zip Format, available for download at our server. Containing
demo files, MegaZine3 Software, mz3_creator Tools and a specific configuration file to create the demo book.
Name of the PageFlip software used to show MZ3 Books...
MegaZine3 is Actionscript3 based, a Flash programming language.
That’s why it is called MegaZine3
Alternative name for MegaZine3; used as abbreviation.
The representation of a document as a „PageFlip“ eBook
A collection of Batch-Files to create MZ3 Books.
Copyright © 2010 VservU GmbH
All rights reserved
28
MegaZine3: Allgemeine Informationen zum MZ3-Tutorial
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9, 2011
Offline-Book
Online-Book
Thumbnails
Tools
Sublicense
A mz3-Book which is presented by a Flash program like megazine.exe. No
browser nor online access is needed.
Therefore an Offline books is the ideal way to show documents/book in electronic form, without internet access.
A MZ3 Book usually is run in a browser using an internet connection to retrieve the data from a server. With correct FLASH settings an online book also can be shown locally on a PC:
Small representation of the images(s) used for preview; typically 25% the
size of a book page.
These thumbnails are used as page preview...
It is possible to provide thumbnails of correct size and name in the folder
thumbs/. This can accelerate the loading of the first page.
Specific programs performing specific tasks like:
- pdf2swf
An Open Source Solution, converting PDF files into
swf pages used by megazine3.
- notepad++
A context sensitive editor
mz3_creator
A set of batch files supporting during the process of
creating book.
Sublicenses are licenses under a MZ3-HOST or MZ3-PUBL license. Depending
on the size of the license (S: small, M: medium, L: large) the number of sublicenses per license varies. For every title/book one sublicense is needed.
Special case: the maximum page number for the S: small licenses is limited.
If that limit is exceeded, more than one sublicense can be bundled to cover
the needed number of pages (bundling).
Copyright © 2010 VservU GmbH
All rights reserved
29
MegaZine3: Allgemeine Informationen zum MZ3-Tutorial
Entwurf: 1-1-10 Version: V2.0.x vom Feb-9, 2011
Helpful Links
General Links providing more Information about MegaZine3
For those interested in learning more and/or in building own MZ3 books, we suggest to have a look
into the other manuals or follow the other links provided here.
Operation Manual and Introduction
Manual MZ3 Book creation
Price List and License Agreements
MegaZine3 Wiki
MegaZine3 Forum
Forum summary Book
List of Sample Books and Videos
Online Demo Book
MZ3-Software und Demo-Packages
MegaZine3 Software (Binaries nightly Build)
You can find links to Binaries and Sources at our Homepage under the tab Tab „MZ3-Download Links“
Demo-Package: mz3_creator Tools (Batch-Dateien), Beispiel-Bilder, Video- und Audio-Dateien
mz3_creator Download Package
Free Tools and Software
Download swf-tools:
http://swftools.org/swftools-0.9.1.exe
Download notepad++:
http://www.heise.de/software/download/notepad/26659
Download xnview:
PDF Tools (extract/combine pages, …)
http://www.xnview.de/
http://www.pdfhacks.com/pdftk/
Affordable Tools and Software
Tool to create and work with PDF files
http://www.softpedia.com/get/Office-tools/PDF/PDF-Stamping.shtml
Adobe Acrobat alternative
http://www.nitropdf.com/professional/overview.htm#overview/create.jpg
Subversion; to uncheck the Sources
http://www.heise.de/software/download/subversion/41692
Copyright © 2010 VservU GmbH
All rights reserved
30

Documentos relacionados