bookshop 0.1.4 → 0.1.5
Sign up to get free protection for your applications and to get access to all the features.
- data/lib/bookshop/commands/build.rb +12 -8
- data/lib/bookshop/generators/bookshop/app/app_generator.rb +16 -20
- data/lib/bookshop/generators/bookshop/app/templates/book/assets/css/stylesheet.epub.css +2 -203
- data/lib/bookshop/generators/bookshop/app/templates/book/assets/css/stylesheet.mobi.css +14 -169
- data/lib/bookshop/generators/bookshop/app/templates/book/bodymatter/ch01/adding_images.html.erb +1 -1
- data/lib/bookshop/generators/bookshop/app/templates/book/bodymatter/ch01/ch01.html.erb +1 -1
- data/lib/bookshop/generators/bookshop/app/templates/book/book.html.erb +6 -6
- data/lib/bookshop/generators/bookshop/app/templates/book/epub/OEBPS/content.opf.erb +17 -13
- data/lib/bookshop/generators/bookshop/app/templates/book/frontmatter/preface.html.erb +1 -1
- data/lib/bookshop/generators/bookshop/app/templates/book/frontmatter/toc.html.erb +5 -1
- data/lib/bookshop/generators/bookshop/app/templates/config/book.yml +2 -2
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/Contents +36 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/LICENSE +60 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/README +234 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/README.CR +119 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/WHATSNEW +333 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/WHERE +266 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/zip.exe +0 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/zip.txt +2027 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/zip30.ann +95 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/zipcloak.exe +0 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/zipcloak.txt +75 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/zipnote.exe +0 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/zipnote.txt +63 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/zipsplit.exe +0 -0
- data/lib/bookshop/generators/bookshop/app/templates/script/zip/zipsplit.txt +53 -0
- data/lib/bookshop/version.rb +1 -1
- metadata +31 -16
data/lib/bookshop/generators/bookshop/app/templates/book/bodymatter/ch01/adding_images.html.erb
CHANGED
@@ -11,5 +11,5 @@ documents with the <span class="element">img</span> element –
|
|
11
11
|
|
12
12
|
<div class="figure" id="fig-loaded">
|
13
13
|
<p class="caption">The image has been loaded.</p>
|
14
|
-
<p class="art"><img alt="
|
14
|
+
<p class="art"><img alt="image" src="assets/images/html-18.png" style="width: 100%;" /></p>
|
15
15
|
</div>
|
@@ -1,5 +1,5 @@
|
|
1
1
|
<div class="chapter" id="html-h-1">
|
2
|
-
<h1 style="counter-reset: page 1"
|
2
|
+
<h1 <% if @output != :mobi %>style="counter-reset: page 1"<% end %>>The Web and HTML</h1>
|
3
3
|
|
4
4
|
<p class="sidenote">The box <a class="pageref" href="#specs">“CSS Specifications”</a> lists the different CSS specifications.</p>
|
5
5
|
<p>Cascading Style Sheets (CSS) represent a major breakthrough in
|
@@ -1,11 +1,10 @@
|
|
1
|
-
|
2
|
-
|
3
|
-
<html>
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
2
|
+
<html xmlns="http://www.w3.org/1999/xhtml">
|
4
3
|
<head>
|
5
|
-
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
|
6
5
|
<title>Cascading Style Sheets</title>
|
7
6
|
<link rel="stylesheet" type="text/css" href="assets/css/stylesheet.<%= @output %>.css" />
|
8
|
-
|
7
|
+
<link rel="stylesheet" type="application/vnd.adobe-page-template+xml" href="assets/css/page-template.xpgt"/>
|
9
8
|
</head>
|
10
9
|
<body>
|
11
10
|
|
@@ -31,4 +30,5 @@
|
|
31
30
|
|
32
31
|
<%= import('backmatter/index.html.erb')%>
|
33
32
|
|
34
|
-
</body
|
33
|
+
</body>
|
34
|
+
</html>
|
@@ -1,4 +1,5 @@
|
|
1
1
|
<?xml version="1.0" encoding="UTF-8"?>
|
2
|
+
<!DOCTYPE package PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
2
3
|
<package xmlns="http://www.idpf.org/2007/opf" version="2.0" unique-identifier="BlueHeadPublishing">
|
3
4
|
<metadata xmlns:opf="http://www.idpf.org/2007/opf" xmlns:dc="http://purl.org/dc/elements/1.1/">
|
4
5
|
<dc:language>en</dc:language>
|
@@ -7,35 +8,38 @@
|
|
7
8
|
<dc:date><%= @book.date %></dc:date>
|
8
9
|
<dc:publisher><%= @book.publisher %></dc:publisher>
|
9
10
|
<dc:rights><%= @book.rights %></dc:rights>
|
10
|
-
<dc:identifier id="BlueHeadPublishing" opf:scheme="ISBN"><%= @book.
|
11
|
+
<dc:identifier id="BlueHeadPublishing" opf:scheme="ISBN"><%= @book.isbn %></dc:identifier>
|
11
12
|
<dc:subject><%= @book.subject %></dc:subject>
|
12
13
|
<meta name="cover" content="cover-image"/>
|
13
14
|
</metadata>
|
14
15
|
<manifest>
|
15
|
-
|
16
|
-
|
17
|
-
<item
|
18
|
-
<item
|
19
|
-
|
20
|
-
<item
|
16
|
+
|
17
|
+
<!-- Main Meta Items -->
|
18
|
+
<item media-type="text/css" href="assets/css/stylesheet.<%= @output %>.css" id="ebook-css" />
|
19
|
+
<item media-type="application/vnd.adobe-page-template+xml" href="assets/css/page-template.xpgt" id="pt" />
|
20
|
+
<% if @output != :mobi %><item media-type="application/xhtml+xml" href="cover.html" id="cover" /><% end %>
|
21
|
+
<item media-type="image/png" href="assets/images/cover.png" id="cover-image" />
|
22
|
+
<item media-type="application/xhtml+xml" href="toc.html" id="toc" />
|
23
|
+
<item media-type="application/x-dtbncx+xml" href="toc.ncx" id="ncx" />
|
21
24
|
|
22
25
|
<!-- Book Contents -->
|
23
|
-
<item id="book"
|
24
|
-
href="book.html"
|
25
|
-
media-type="application/xhtml+xml" />
|
26
|
+
<item id="book" href="book.html" media-type="application/xhtml+xml" />
|
26
27
|
|
27
|
-
<!-- Assets -->
|
28
|
+
<!-- Additional Assets -->
|
28
29
|
<item id="canvas-image" href="assets/images/canvas.jpg" media-type="image/jpeg"/>
|
29
30
|
<item id="draft-image" href="assets/images/draft.png" media-type="image/png"/>
|
30
31
|
<item id="html-image" href="assets/images/html-18.png" media-type="image/png"/>
|
32
|
+
|
33
|
+
<!-- Fonts -->
|
31
34
|
|
32
35
|
</manifest>
|
33
36
|
<spine toc="ncx">
|
34
|
-
|
37
|
+
<% if @output != :mobi %><itemref idref="cover" linear="no"/><% end %>
|
35
38
|
<itemref idref="toc" />
|
36
39
|
<itemref idref="book" />
|
37
40
|
</spine>
|
38
41
|
<guide>
|
39
|
-
|
42
|
+
<% if @output != :mobi %><reference type="cover" title="Cover" href="cover.html"/><% end %>
|
43
|
+
<reference type="toc" title="Table of Contents" href="toc.html"/>
|
40
44
|
</guide>
|
41
45
|
</package>
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<p>This is a sample document whose purpose is to show how CSS can be
|
4
4
|
used to print a book. To make the document more lively, excerpts from
|
5
5
|
the third edition of “Cascading Style Sheets — designing
|
6
|
-
for
|
6
|
+
for the Web” have been included.<span class="footnote"> That
|
7
7
|
book <em>was</em> produced using the methods described in the
|
8
8
|
document, and it was published by Addison-Wesley in 2005.</span> The
|
9
9
|
excerpts have been selected for their example values and they appear,
|
@@ -28,8 +28,12 @@
|
|
28
28
|
|
29
29
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
30
30
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
31
|
+
|
31
32
|
<head>
|
32
|
-
<
|
33
|
+
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
|
34
|
+
<title>Table of Contents</title>
|
35
|
+
<link rel="stylesheet" type="text/css" href="assets/css/stylesheet.<%= @output %>.css" />
|
36
|
+
<link rel="stylesheet" type="application/vnd.adobe-page-template+xml" href="assets/css/page-template.xpgt"/>
|
33
37
|
</head>
|
34
38
|
<body>
|
35
39
|
<div class="toc" id="toc-h-1">
|
@@ -19,12 +19,12 @@ contributor: 'Håkon Wium Lie and Bert Bos'
|
|
19
19
|
date: 2012-03-31
|
20
20
|
type:
|
21
21
|
format:
|
22
|
-
identifier: 1234567891011
|
23
22
|
source:
|
24
23
|
language: en
|
25
24
|
relation:
|
26
25
|
coverage:
|
27
|
-
rights:
|
26
|
+
rights: 'Copyright © 2012 Pragmatic Programmers, LLC'
|
27
|
+
subject: BlueHead Publishing
|
28
28
|
|
29
29
|
|
30
30
|
|
@@ -0,0 +1,36 @@
|
|
1
|
+
Contents of the Zip 3.0 for "Windows 32-bit x86" binary distribution:
|
2
|
+
|
3
|
+
Contents you are reading it...
|
4
|
+
LICENSE the Info-ZIP software license
|
5
|
+
README general information about Zip 3.0
|
6
|
+
README.CR Information and usage terms for the built-in crypt
|
7
|
+
WHATSNEW Coarse description of new features in this release
|
8
|
+
WHERE Information about distribution packages
|
9
|
+
zip30.ann more detailed "user-visible" feature history
|
10
|
+
zip.txt user manual for Zip
|
11
|
+
zipcloak.txt user manual for ZipCloak
|
12
|
+
zipnote.txt user manual for ZipNote
|
13
|
+
zipsplit.txt user manual for ZipSplit
|
14
|
+
zip.exe Zip program
|
15
|
+
zipnote.exe ZipNote program
|
16
|
+
zipsplit.exe ZipSplit program
|
17
|
+
zipcloak.exe ZipCloak program
|
18
|
+
|
19
|
+
The binaries have been built using Microsoft Visual C/C++ 6.0 SP6; they are
|
20
|
+
linked against the static single-threading runtime library and do not require
|
21
|
+
any additional runtime environment besides the basic Win32 system service dlls
|
22
|
+
supplied by every basic Windows installation.
|
23
|
+
The programs should run on every Windows version that supports 32-bit x86
|
24
|
+
executables: Windows 9x/ME, Windows NT3.x/NT4/2000/XP/2003/Vista/2008.
|
25
|
+
The Windows port of Zip 3.0 supports Unicode (UTF-8 coded) archive entry names;
|
26
|
+
on the "non-unicode" Windows variants 95/98/ME, this unicode support is limited
|
27
|
+
to the character subset supported by the active "single/double byte charcodes"
|
28
|
+
system codepage of the operating system.
|
29
|
+
|
30
|
+
The programs have been built without the optional assembler code for CRC-32
|
31
|
+
and the deflate inner loop. Some coarse test resulted in the impression that
|
32
|
+
the performance of the standard C code seems to be better on modern CPUs
|
33
|
+
(Pentium 3, Pentium 4, etc...). Additionally, the main Zip program has been
|
34
|
+
compiled with the optional bzip2 compression support enabled.
|
35
|
+
|
36
|
+
2008-10-19, Info-ZIP
|
@@ -0,0 +1,60 @@
|
|
1
|
+
This is version 2007-Mar-4 of the Info-ZIP license.
|
2
|
+
The definitive version of this document should be available at
|
3
|
+
ftp://ftp.info-zip.org/pub/infozip/license.html indefinitely and
|
4
|
+
a copy at http://www.info-zip.org/pub/infozip/license.html.
|
5
|
+
|
6
|
+
|
7
|
+
Copyright (c) 1990-2007 Info-ZIP. All rights reserved.
|
8
|
+
|
9
|
+
For the purposes of this copyright and license, "Info-ZIP" is defined as
|
10
|
+
the following set of individuals:
|
11
|
+
|
12
|
+
Mark Adler, John Bush, Karl Davis, Harald Denker, Jean-Michel Dubois,
|
13
|
+
Jean-loup Gailly, Hunter Goatley, Ed Gordon, Ian Gorman, Chris Herborth,
|
14
|
+
Dirk Haase, Greg Hartwig, Robert Heath, Jonathan Hudson, Paul Kienitz,
|
15
|
+
David Kirschbaum, Johnny Lee, Onno van der Linden, Igor Mandrichenko,
|
16
|
+
Steve P. Miller, Sergio Monesi, Keith Owens, George Petrov, Greg Roelofs,
|
17
|
+
Kai Uwe Rommel, Steve Salisbury, Dave Smith, Steven M. Schweda,
|
18
|
+
Christian Spieler, Cosmin Truta, Antoine Verheijen, Paul von Behren,
|
19
|
+
Rich Wales, Mike White.
|
20
|
+
|
21
|
+
This software is provided "as is," without warranty of any kind, express
|
22
|
+
or implied. In no event shall Info-ZIP or its contributors be held liable
|
23
|
+
for any direct, indirect, incidental, special or consequential damages
|
24
|
+
arising out of the use of or inability to use this software.
|
25
|
+
|
26
|
+
Permission is granted to anyone to use this software for any purpose,
|
27
|
+
including commercial applications, and to alter it and redistribute it
|
28
|
+
freely, subject to the above disclaimer and the following restrictions:
|
29
|
+
|
30
|
+
1. Redistributions of source code (in whole or in part) must retain
|
31
|
+
the above copyright notice, definition, disclaimer, and this list
|
32
|
+
of conditions.
|
33
|
+
|
34
|
+
2. Redistributions in binary form (compiled executables and libraries)
|
35
|
+
must reproduce the above copyright notice, definition, disclaimer,
|
36
|
+
and this list of conditions in documentation and/or other materials
|
37
|
+
provided with the distribution. The sole exception to this condition
|
38
|
+
is redistribution of a standard UnZipSFX binary (including SFXWiz) as
|
39
|
+
part of a self-extracting archive; that is permitted without inclusion
|
40
|
+
of this license, as long as the normal SFX banner has not been removed
|
41
|
+
from the binary or disabled.
|
42
|
+
|
43
|
+
3. Altered versions--including, but not limited to, ports to new operating
|
44
|
+
systems, existing ports with new graphical interfaces, versions with
|
45
|
+
modified or added functionality, and dynamic, shared, or static library
|
46
|
+
versions not from Info-ZIP--must be plainly marked as such and must not
|
47
|
+
be misrepresented as being the original source or, if binaries,
|
48
|
+
compiled from the original source. Such altered versions also must not
|
49
|
+
be misrepresented as being Info-ZIP releases--including, but not
|
50
|
+
limited to, labeling of the altered versions with the names "Info-ZIP"
|
51
|
+
(or any variation thereof, including, but not limited to, different
|
52
|
+
capitalizations), "Pocket UnZip," "WiZ" or "MacZip" without the
|
53
|
+
explicit permission of Info-ZIP. Such altered versions are further
|
54
|
+
prohibited from misrepresentative use of the Zip-Bugs or Info-ZIP
|
55
|
+
e-mail addresses or the Info-ZIP URL(s), such as to imply Info-ZIP
|
56
|
+
will provide support for the altered versions.
|
57
|
+
|
58
|
+
4. Info-ZIP retains the right to use the names "Info-ZIP," "Zip," "UnZip,"
|
59
|
+
"UnZipSFX," "WiZ," "Pocket UnZip," "Pocket Zip," and "MacZip" for its
|
60
|
+
own source and binary releases.
|
@@ -0,0 +1,234 @@
|
|
1
|
+
Zip 3.0 is the first Zip update adding large file support. For now Zip 2.3x
|
2
|
+
remains available and supported, but users should switch to this new release.
|
3
|
+
|
4
|
+
Testing for Zip 3.0 has focused mainly on Unix, VMS, Max OS X, and Win32,
|
5
|
+
and some other ports may not be fully supported yet. If you find your
|
6
|
+
favorite port is broke, send us the details or, better, send bug fixes. It's
|
7
|
+
possible that support for some older ports may be dropped in the future.
|
8
|
+
|
9
|
+
|
10
|
+
|
11
|
+
Copyright (c) 1990-2008 Info-ZIP. All rights reserved.
|
12
|
+
|
13
|
+
See the accompanying file LICENSE (the contents of which are also included
|
14
|
+
in unzip.h, zip.h and wiz.h) for terms of use. If, for some reason, all
|
15
|
+
of these files are missing, the Info-ZIP license also may be found at:
|
16
|
+
ftp://ftp.info-zip.org/pub/infozip/license.html and
|
17
|
+
http://www.info-zip.org/pub/infozip/license.html.
|
18
|
+
|
19
|
+
|
20
|
+
Zip 3.0 is a compression and file packaging utility. It is compatible with
|
21
|
+
PKZIP 2.04g (Phil Katz ZIP) for MSDOS systems. There is a companion to zip
|
22
|
+
called unzip (of course) which you should be able to find in the same place
|
23
|
+
you got zip. See the file 'WHERE' for details on ftp sites and mail
|
24
|
+
servers.
|
25
|
+
|
26
|
+
So far zip has been ported to a wide array of Unix and other mainframes,
|
27
|
+
minis, and micros including VMS, OS/2, Minix, MSDOS, Windows, Atari, Amiga,
|
28
|
+
BeOS and VM/CMS. Although highly compatible with PKware's PKZIP and PKUNZIP
|
29
|
+
utilities of MSDOS fame, our primary objective has been one of portability
|
30
|
+
and other-than-MSDOS functionality. Features not found in the PKWare version
|
31
|
+
include creation of zip files in a pipe or on a device; VMS, BeOS and OS/2
|
32
|
+
extended file attributes; conversion from Unix to MSDOS text file format; and,
|
33
|
+
of course, the ability to run on most of your favorite operating systems. And
|
34
|
+
it's free.
|
35
|
+
|
36
|
+
See the file zip30.ann for a summary of new features in Zip 3.0 and WhatsNew
|
37
|
+
for the detailed list of new features and changes since Zip 2.32. The file
|
38
|
+
CHANGES details all day-to-day changes during development.
|
39
|
+
|
40
|
+
Notes:
|
41
|
+
|
42
|
+
Multi-volume support. This version does not support multi-volume spanned
|
43
|
+
archives as in pkzip 2.04g, and there is no intention at this point to support
|
44
|
+
spanned archives, but Zip 3.0 supports split archives. A split archive is an
|
45
|
+
archive split into a set of files, each file a piece of the archive and each
|
46
|
+
file using an extension, such as .z02 as in the file name archive.z02, that
|
47
|
+
provides the order of the splits. In contrast, a spanned archive is the
|
48
|
+
original multi-floppy archive supported by pkzip 2.0g where the split order
|
49
|
+
is contained in the volume labels. The contents of split and spanned archives
|
50
|
+
are mostly identical and there is a simple procedure to convert between the
|
51
|
+
formats. Many current unzips now support split archives.
|
52
|
+
|
53
|
+
Zip64 support. This version supports Zip64 archives as described in the
|
54
|
+
PKWare AppNote. These archives use additional fields to support archives
|
55
|
+
greater than 2 GB and files in archives over the 2 GB previous limit (4 GB
|
56
|
+
on some ports). The Zip64 format also allows more than 64k entries in an
|
57
|
+
archive. Support by the OS for files larger than 4 GB is needed for Zip to
|
58
|
+
create and read large files and archives. On Unix, Win32, and some other
|
59
|
+
ports, large file and Zip64 support is automatically checked for and
|
60
|
+
compiled in if available. Use of Zip64 by Zip is automatic and to maximize
|
61
|
+
backward compatibility the Zip64 fields will only be used if needed. A
|
62
|
+
Zip64 archive requires a pkzip 4.5 compatible unzip, such as UnZip 6.0.
|
63
|
+
|
64
|
+
Unicode support. This version has initial Unicode support. This allows
|
65
|
+
paths and names of files in other character sets to be accurately recreated
|
66
|
+
on OS that have sufficient character set support. On Win32, if wide
|
67
|
+
character calls are supported (not Win 9x unless Unicode support has been
|
68
|
+
added) all files (including paths with illegal characters in the current
|
69
|
+
character set) should now be readable by zip. Unicode support is provided
|
70
|
+
using a new set of UTF-8 path and comment extra fields and a new UTF-8 bit
|
71
|
+
for flagging when the current character set is already UTF-8. Zip 3.0
|
72
|
+
maintains backward compatibility with older archives and is mostly compliant
|
73
|
+
with the new Unicode additions in the latest PKWare AppNote. The exception
|
74
|
+
is UTF-8 comments, which are not supported if UTF-8 is not the native
|
75
|
+
character set, but should be fully implemented in Zip 3.1.
|
76
|
+
|
77
|
+
16-bit OS support. Though Zip 3.0 is designed to support the latest zip
|
78
|
+
standards and modern OS, some effort has been made to maintain support
|
79
|
+
for older and smaller systems. If you find Zip 3.0 does not fit on or
|
80
|
+
otherwise does not work well on a particular OS, send in the details and
|
81
|
+
we might be able to help.
|
82
|
+
|
83
|
+
Compression methods. In addition to the standard store and deflate methods,
|
84
|
+
Zip now can use the bzip2 compression format using the bzip2 library. Though
|
85
|
+
bzip2 compression generally takes longer, in many cases using bzip2 results
|
86
|
+
in much better compression. However, many unzips may not yet support
|
87
|
+
bzip2 compressed entries in archives, so test your unzip first before using
|
88
|
+
bzip2 compression.
|
89
|
+
|
90
|
+
Installation. Please read the file INSTALL for information on how to compile
|
91
|
+
and install zip, zipsplit, zipcloak, and zipnote and please read the manual
|
92
|
+
pages ZIP.txt, ZIPSPLIT.txt, ZIPCLOAK.txt, and ZIPNOTE.txt for information on
|
93
|
+
how to use them. Also, if you are using MSDOS or Windows, note that text
|
94
|
+
files in the distribution are generally in Unix line end format (LF only)
|
95
|
+
and Windows and DOS users will need to either convert the files as needed to
|
96
|
+
DOS line ends (CR LF) or extract the distribution contents using unzip -a.
|
97
|
+
|
98
|
+
Utilities. At this point zipsplit, zipcloak, and zipnote should work with
|
99
|
+
large files, but they currently do not handle split archives. A work around
|
100
|
+
is to use zip to convert a split archive to a single file archive and then use
|
101
|
+
the utilities on that archive.
|
102
|
+
|
103
|
+
Encryption. This version supports standard zip encryption. Until recently
|
104
|
+
the encryption code was distributed separately because of the US export
|
105
|
+
regulations but now is part of the main distribution. See crypt.c for
|
106
|
+
details. Decryption can be made with unzip 5.0p1 or later, or with zipcloak.
|
107
|
+
|
108
|
+
Bug reports. All bug reports or patches should go to zip-bugs via the web
|
109
|
+
site contact form at http://www.info-zip.org/zip-bug.html (we have discontinued
|
110
|
+
the old email address zip-bugs@lists.wku.edu because of too much spam lately)
|
111
|
+
and suggestions for new features can be submitted there also (although we don't
|
112
|
+
promise to use all of them). We also are on SourceForge at
|
113
|
+
http://sourceforge.net/projects/infozip/ and now automatically get Bug Reports
|
114
|
+
and Feature Requests submitted there. In addition, a new Info-ZIP discussion
|
115
|
+
forum is available as well. See below. Though bug reports can be posted there,
|
116
|
+
we don't have automatic monitoring of all postings set up yet so you may want
|
117
|
+
to use the web form or SoureForge for a quicker response. A good approach may
|
118
|
+
be to post the details on the forum so others can benefit from the posting,
|
119
|
+
then use the web reply form to let us know you did that if you don't get a
|
120
|
+
reply in a reasonable time.
|
121
|
+
|
122
|
+
Ports. If you're considering a port, please check in with zip-bugs FIRST,
|
123
|
+
since the code is constantly being updated behind the scenes. We'll
|
124
|
+
arrange to give you access to the latest source.
|
125
|
+
|
126
|
+
Discussion group. If you'd like to keep up to date with our Zip (and companion
|
127
|
+
UnZip utility) development, join the ranks of BETA testers, add your own
|
128
|
+
thoughts and contributions, etc., check out the new discussion forum. This is
|
129
|
+
the latest offering, after the various Info-ZIP mailing-lists on
|
130
|
+
mxserver@lists.wku.edu (courtesy of Hunter Goatley) were no longer available
|
131
|
+
and the temporary QuickTopic discussion group for Info-ZIP issues at
|
132
|
+
http://www.quicktopic.com/27/H/V6ZQZ54uKNL died a horrible death due to large
|
133
|
+
amounts of spam. The new discussion forum is now available at
|
134
|
+
http://www.info-zip.org/board/board.pl (thanks again to Hunter Goatley) and
|
135
|
+
can be used to discuss issues, request features, and is one place new betas
|
136
|
+
and releases are announced. It also is a place to post bug reports, and
|
137
|
+
patches can be submitted as attachments. However, we don't yet get
|
138
|
+
automatic notification of all postings there so try one of the other methods
|
139
|
+
if you don't get a response. You can also post Bug Reports and Feature
|
140
|
+
Requests at Source Forge. However, the web site contact form remains
|
141
|
+
available if you would rather not post on the public forums.
|
142
|
+
|
143
|
+
Frequently asked questions on zip and unzip:
|
144
|
+
|
145
|
+
Q. When unzipping I get an error message about "compression method 8".
|
146
|
+
|
147
|
+
A. This is standard deflate, which has been around for awhile. Please
|
148
|
+
get a current version of unzip. See the file 'WHERE' for details.
|
149
|
+
|
150
|
+
|
151
|
+
Q. How about "compression method 12"?
|
152
|
+
|
153
|
+
A. Compression method 12 is bzip2 and requires a relatively modern unzip.
|
154
|
+
Please get the latest version of unzip.
|
155
|
+
|
156
|
+
|
157
|
+
Q. I can't extract this zip file that I just downloaded. I get
|
158
|
+
"zipfile is part of multi-disk archive" or some other message.
|
159
|
+
|
160
|
+
A. Please make sure that you made the transfer in binary mode. Check
|
161
|
+
in particular that your copy has exactly the same size as the original.
|
162
|
+
Note that the above message also may actually mean you have only part
|
163
|
+
of a multi-part archive. Also note that UnZip 5.x does not and UnZip 6.0
|
164
|
+
probably won't have multi-disk (split) archive support. A work around
|
165
|
+
is to use Zip 3.0 to convert the split archive to a single-file archive
|
166
|
+
then use UnZip on that archive. As a last result, if there's something
|
167
|
+
readable in what you have, zip -FF should be able to recover it.
|
168
|
+
|
169
|
+
|
170
|
+
Q. When running unzip, I get a message about "End-of-central-directory
|
171
|
+
signature not found".
|
172
|
+
|
173
|
+
A. This usually means that your zip archive is damaged, or that you
|
174
|
+
have an uncompressed file with the same name in the same directory.
|
175
|
+
In the first case, it makes more sense to contact the person you
|
176
|
+
obtained the zip file from rather than the Info-ZIP software
|
177
|
+
developers, and to make sure that your copy is strictly identical to
|
178
|
+
the original. In the second case, use "unzip zipfile.zip" instead
|
179
|
+
of "unzip zipfile", to let unzip know which file is the zip archive
|
180
|
+
you want to extract.
|
181
|
+
|
182
|
+
|
183
|
+
Q. Why doesn't zip do <something> just like PKZIP does?
|
184
|
+
|
185
|
+
A. Zip is not a PKZIP clone and is not intended to be one. In some
|
186
|
+
cases we feel PKZIP does not do the right thing (e.g., not
|
187
|
+
including pathnames by default); in some cases the operating system
|
188
|
+
itself is responsible (e.g., under Unix it is the shell which
|
189
|
+
expands wildcards, not zip). Info-ZIP's and PKWARE's zipfiles
|
190
|
+
are interchangeable, not the programs.
|
191
|
+
|
192
|
+
For example, if you are used to the following PKZIP command:
|
193
|
+
pkzip -rP foo *.c
|
194
|
+
you must use instead on Unix:
|
195
|
+
zip -R foo "*.c"
|
196
|
+
(the quotes are needed to let the shell know that it should
|
197
|
+
not expand the *.c argument but instead pass it on to the program,
|
198
|
+
but are not needed on ports that do not expand file paths like
|
199
|
+
MSDOS)
|
200
|
+
|
201
|
+
|
202
|
+
Q. Can I distribute zip and unzip sources and/or executables?
|
203
|
+
|
204
|
+
A. You may redistribute the latest official distributions without any
|
205
|
+
modification, without even asking us for permission. You can charge
|
206
|
+
for the cost of the media (CDROM, diskettes, etc...) and a small copying
|
207
|
+
fee. If you want to distribute modified versions please contact us at
|
208
|
+
www.Info-ZIP.org first. You must not distribute beta versions.
|
209
|
+
The latest official distributions are always on ftp.Info-ZIP.org in
|
210
|
+
directory /pub/infozip and subdirectories and at SourceForge.
|
211
|
+
|
212
|
+
|
213
|
+
Q. Can I use the executables of zip and unzip to distribute my software?
|
214
|
+
|
215
|
+
A. Yes, so long as it is made clear in the product documentation that
|
216
|
+
zip or unzip are not being sold, that the source code is freely
|
217
|
+
available, and that there are no extra or hidden charges resulting
|
218
|
+
from its use by or inclusion with the commercial product. See the
|
219
|
+
Info-ZIP license for more. Here is an example of a suitable notice:
|
220
|
+
|
221
|
+
NOTE: <Product> is packaged on this CD using Info-ZIP's compression
|
222
|
+
utility. The installation program uses UnZip to read zip files from
|
223
|
+
the CD. Info-ZIP's software (Zip, UnZip and related utilities) is
|
224
|
+
freely distributed under the Info-ZIP license and can be obtained as
|
225
|
+
source code or executables from various anonymous-ftp sites,
|
226
|
+
including ftp://ftp.info-zip.org/pub/infozip.
|
227
|
+
|
228
|
+
|
229
|
+
Q. Can I use the source code of zip and unzip in my commercial application?
|
230
|
+
|
231
|
+
A. Yes, as long as the conditions in the Info-ZIP license are met. We
|
232
|
+
recommend you include in your product documentation an acknowledgment
|
233
|
+
and note that the original compression sources are available at
|
234
|
+
www.Info-ZIP.org. If you have special requirements contact us.
|