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