User:Mannyack/multizip

From DPWiki
Jump to navigation Jump to search

multizip.pl: Software to Create the Slices for BEGIN Projects

Version 1.04 of multizip is a rewrite into perl. There is a major performance enhancement, as there are no longer temporary disk files. Thumbs.db is ignored if present in pngs or images. -- mannyack June 2021

The ruby version of Multizip was written by rfrank in 2008.


Installing Perl

This version of multizip was written on Windows 10 and tested with Strawberry Perl. If you have already installed Strawberry Perl for Guiguts or Guiprep, you have already done all that is needed in terms of installing Perl.

For anyone who has not installed Strawberry Perl, go to their web-site, download the package appropriate to your computer and follow their install instructions.

Guiguts and Guiprep require some CPAN modules. The only module used by multizip is ARCHIVE::ZIP. I did not have to install this through CPAN, it appeared to have been part of the base Strawberry Perl installation.

How to Use multizip

These instructions work for Multizip once you installed Perl successfully.

You can download the current version of multizip.pl (1.04) from the common dpscans folder (mannyack_multizip104) on the DP web-site. The file is less than 3k. Unzip the file and place it in the parent directory of your project directories.

Now you are ready to slice up some projects.


Slicing

You have prepped the project and you have the usual folders: text, pngs, images within a project folder.


1. Open a command prompt on your computer and navigate to your project directory, the one that contains pngs, text and images.

2. Multizip should be in the parent of this directory, so invoke it with the following command:

 perl ..\multizip.pl file_name_you_want number_of_parts_you_want
  • file name is whatever you want multizip to call your zipped up slice files
  • number of parts is how many slices you want to end up with

Multizip doesn’t allow you to specify how many pages you want to have in a single slice, only how many slices you want to end up with.

So if you type:

 perl ..\multizip.pl mybook 5

you will end up with five zip files named: mybook-1of5.zip, mybook-2of5.zip, etc., and mybook-all.zip.


3. Upload these zip files to your own dpscan folder, not BEGIN. (BEGIN can find your dpscans when you create the projects.)

mybook-all.zip is created so you can upload it to the first slice, create the GWL and BWL entries for the entire project and then delete all the project files and load the first slice zip.

Multizip will put your illustration files into the first zip file. If you don't put your "images" folder into the slicing directory, multizip will object. (If images is empty, it will complain, but proceed.)

If the number of pages in your project doesn't divide neatly into even sized slices, multizip will even out the slice sizes so that no slice is more than one page larger than any other slice. Multizip doesn't destroy your folders so you can experiment until you are happy with the result.