bookshop 0.0.19 → 0.0.21

data/lib/bookshop/commands/epub/templates/META-INF/container.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<container version="1.0" xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
+   <rootfiles>
+      <rootfile full-path="OEBPS/content.opf" media-type="application/oebps-package+xml"/>
+   </rootfiles>
+</container>

data/lib/bookshop/commands/epub/templates/OEBPS/content.opf.erb

@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<package xmlns="http://www.idpf.org/2007/opf" version="2.0" unique-identifier="PragmaticMagazine">
+  <metadata xmlns:opf="http://www.idpf.org/2007/opf" xmlns:dc="http://purl.org/dc/elements/1.1/">
+    <dc:language>en</dc:language>
+    <dc:title>PragPub 2011-11: Issue #29</dc:title>
+    <dc:creator opf:role="aut">The Pragmatic Bookshelf</dc:creator>
+    <dc:date>2011-11-01</dc:date>
+    <dc:publisher>The Pragmatic Bookshelf, LLC</dc:publisher>
+    <dc:rights>
+	  Copyright © The Pragmatic Bookshelf, LLC
+	</dc:rights>
+    <dc:identifier id="PragmaticMagazine" opf:scheme="pragmatic">November 2011</dc:identifier>
+    <dc:subject>PragPub—Monthly Magazine</dc:subject>
+    <meta name="cover" content="cover-image"/>
+  </metadata>
+  <manifest>
+    <item id="magazine-css" href="css/magazine.css" media-type="text/css"/>
+    <item id="pt" href="page-template.xpgt" media-type="application/vnd.adobe-page-template+xml"/>
+    <item id="cover" href="cover.xhtml" media-type="application/xhtml+xml"/>
+    <item id="cover-image" href="images/cover.jpg" media-type="image/jpeg"/>
+    <item id="ncx" href="toc.ncx" media-type="application/x-dtbncx+xml"/>
+<item id="f_0000"
+      href="f_0000.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0001"
+      href="f_0001.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0002"
+      href="f_0002.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0003"
+      href="f_0003.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0004"
+      href="f_0004.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0005"
+      href="f_0005.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0006"
+      href="f_0006.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0007"
+      href="f_0007.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0008"
+      href="f_0008.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0009"
+      href="f_0009.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0010"
+      href="f_0010.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0011"
+      href="f_0011.html"
+      media-type="application/xhtml+xml" />
+
+<item id="f_0012"
+      href="f_0012.html"
+      media-type="application/xhtml+xml" />
+
+    <item id="img1" href="images/actionshot-november.jpg" media-type="image/jpeg"/>
+    <item id="img2" href="images/XcodeSettings.jpg" media-type="image/jpeg"/>
+    <item id="img3" href="images/RefactorToARC.jpg" media-type="image/jpeg"/>
+    <item id="img4" href="images/ScreenShot.jpg" media-type="image/jpeg"/>
+    <item id="img5" href="images/bigger-than-we-thought.jpg" media-type="image/jpeg"/>
+    <item id="img6" href="images/self-infliced-scope-creep.jpg" media-type="image/jpeg"/>
+    <item id="img7" href="images/why-is-this-going-up.jpg" media-type="image/jpeg"/>
+    <item id="img8" href="images/Brian1.jpg" media-type="image/jpeg"/>
+    <item id="img9" href="images/Brian2.jpg" media-type="image/jpeg"/>
+    <item id="img10" href="images/Brian3.jpg" media-type="image/jpeg"/>
+    <item id="img11" href="images/new-in-pragpub.jpg" media-type="image/jpeg"/>
+    <item id="img12" href="images/new-on-bookshelf.jpg" media-type="image/jpeg"/>
+  </manifest>
+  <spine toc="ncx">
+    <itemref idref="cover" linear="no"/>
+    <itemref idref="f_0000" />
+    <itemref idref="f_0001" />
+    <itemref idref="f_0002" />
+    <itemref idref="f_0003" />
+    <itemref idref="f_0004" />
+    <itemref idref="f_0005" />
+    <itemref idref="f_0006" />
+    <itemref idref="f_0007" />
+    <itemref idref="f_0008" />
+    <itemref idref="f_0009" />
+    <itemref idref="f_0010" />
+    <itemref idref="f_0011" />
+    <itemref idref="f_0012" />
+  </spine>
+  <guide>
+    <reference type="cover" title="Cover" href="cover.xhtml"/>
+  </guide>
+</package>

data/lib/bookshop/commands/epub/templates/OEBPS/page-template.xpgt

@@ -0,0 +1,48 @@
+<ade:template xmlns="http://www.w3.org/1999/xhtml" xmlns:ade="http://ns.adobe.com/2006/ade"
+		 xmlns:fo="http://www.w3.org/1999/XSL/Format">
+
+  <fo:layout-master-set>
+
+    <fo:simple-page-master master-name="single_column">
+	<fo:region-body margin-bottom="3pt" margin-top="3pt" margin-left="3pt" margin-right="3pt"/>
+    </fo:simple-page-master>
+
+    <fo:simple-page-master master-name="two_column"
+		margin-bottom="0.5em" margin-top="0.5em" margin-left="0.5em" margin-right="0.5em">
+	<fo:region-body column-count="2" column-gap="10pt"/>
+    </fo:simple-page-master>
+
+    <fo:simple-page-master master-name="two_column_head"
+		margin-bottom="0.5em" margin-left="0.5em" margin-right="0.5em">
+	<fo:region-before extent="8.3em"/>
+	<fo:region-body column-count="2" margin-top="8.7em" column-gap="10pt"/>
+    </fo:simple-page-master>
+
+    <fo:simple-page-master master-name="three_column"
+		margin-bottom="0.5em" margin-top="0.5em" margin-left="0.5em" margin-right="0.5em">
+	<fo:region-body column-count="3" column-gap="10pt"/>
+    </fo:simple-page-master>
+
+    <fo:simple-page-master master-name="three_column_head"
+		margin-bottom="0.5em" margin-top="0.5em" margin-left="0.5em" margin-right="0.5em">
+	<fo:region-before extent="8.3em"/>
+	<fo:region-body column-count="3" margin-top="8.7em" column-gap="10pt"/>
+    </fo:simple-page-master>
+
+    <fo:page-sequence-master>
+        <fo:repeatable-page-master-alternatives>
+            <fo:conditional-page-master-reference master-reference="three_column_head" page-position="first" ade:min-page-width="80em"/>
+            <fo:conditional-page-master-reference master-reference="three_column" ade:min-page-width="80em"/>
+            <fo:conditional-page-master-reference master-reference="two_column_head" page-position="first" ade:min-page-width="50em"/>
+            <fo:conditional-page-master-reference master-reference="two_column" ade:min-page-width="50em"/>
+            <fo:conditional-page-master-reference master-reference="single_column"/>
+        </fo:repeatable-page-master-alternatives>
+    </fo:page-sequence-master>
+
+  </fo:layout-master-set>
+
+  <ade:style>
+    <ade:styling-rule selector=".title_box" display="adobe-other-region" adobe-region="xsl-region-before"/>
+  </ade:style>
+
+</ade:template>

data/lib/bookshop/commands/epub/templates/OEBPS/toc.opf.erb

@@ -0,0 +1,107 @@
+<?xml version="1.0"?>
+<ncx xmlns:calibre="http://calibre.kovidgoyal.net/2009/metadata" xmlns="http://www.daisy.org/z3986/2005/ncx/" version="2005-1" xml:lang="en">
+  <head>
+    <meta name="dtb:uid" content="<%= book.isbn %>"/>
+    <meta name="dtb:depth" content="1"/>
+    <meta name="dtb:totalPageCount" content="0"/>
+    <meta name="dtb:maxPageNumber" content="0"/>
+  </head>
+  <docTitle>
+    <text><%= book.epub.title %></text>
+  </docTitle>
+  <navMap>
+	<% for toc in toc do %>
+  <navPoint id="navPoint-0" playOrder="1">
+    <navLabel>
+      <text><%= toc.test %></text>
+    </navLabel>
+    <content src="book.html#<%= toc.name %>"/>
+  </navPoint>
+	
+
+  <navPoint id="navPoint-1" playOrder="2">
+    <navLabel>
+      <text>Up Front</text>
+    </navLabel>
+    <content src="f_0001.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-2" playOrder="3">
+    <navLabel>
+      <text>Choice Bits</text>
+    </navLabel>
+    <content src="f_0002.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-3" playOrder="4">
+    <navLabel>
+      <text>Meet the Team</text>
+    </navLabel>
+    <content src="f_0003.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-4" playOrder="5">
+    <navLabel>
+      <text>Inside iOS 5</text>
+    </navLabel>
+    <content src="f_0004.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-5" playOrder="6">
+    <navLabel>
+      <text>Scala for the Intrigued</text>
+    </navLabel>
+    <content src="f_0005.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-6" playOrder="7">
+    <navLabel>
+      <text>Test-Driven Development</text>
+    </navLabel>
+    <content src="f_0006.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-7" playOrder="8">
+    <navLabel>
+      <text>Self-Inflicted Scope Creep</text>
+    </navLabel>
+    <content src="f_0007.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-8" playOrder="9">
+    <navLabel>
+      <text>Root Cause Analysis from Long Ago</text>
+    </navLabel>
+    <content src="f_0008.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-9" playOrder="10">
+    <navLabel>
+      <text>When Did That Happen?</text>
+    </navLabel>
+    <content src="f_0009.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-10" playOrder="11">
+    <navLabel>
+      <text>Calendar</text>
+    </navLabel>
+    <content src="f_0010.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-11" playOrder="12">
+    <navLabel>
+      <text>Shady Illuminations</text>
+    </navLabel>
+    <content src="f_0011.html"/>
+  </navPoint>
+
+  <navPoint id="navPoint-12" playOrder="13">
+    <navLabel>
+      <text>But Wait, There ’s More...</text>
+    </navLabel>
+    <content src="f_0012.html"/>
+  </navPoint>
+
+</navMap>
+</ncx>

data/lib/bookshop/commands/epub/templates/mimetype

@@ -0,0 +1 @@
+application/epub+zip

data/lib/bookshop/commands/yaml/book.rb

@@ -1,4 +1,4 @@
-# Take a YAML data structure and express it in a 'class.method.method' convention so
+# Take a YAML data structure and express it in a 'class.attribute.attribute' convention so
 #   it can be passed to the build command, used in the source files to call data
 #   from the book.yml file
 #
@@ -7,37 +7,41 @@
 #   bar: foobar
 #
 # is referenced in the source files as <%= book.foo.bar %> and yields in build 'foobar'
-class Book
+module Bookshop
+  module Commands
+    class Book
 
-  def initialize(data={})
-    @data = {}
-    update!(data)
-  end
+      def initialize(data={})
+        @data = {}
+        update!(data)
+      end
 
-  def update!(data)
-    data.each do |key, value|
-      self[key] = value
-    end
-  end
+      def update!(data)
+        data.each do |key, value|
+          self[key] = value
+        end
+      end
 
-  def [](key)
-    @data[key.to_sym]
-  end
+      def [](key)
+        @data[key.to_sym]
+      end
 
-  def []=(key, value)
-    if value.class == Hash
-      @data[key.to_sym] = Book.new(value)
-    else
-      @data[key.to_sym] = value
-    end
-  end
+      def []=(key, value)
+        if value.class == Hash
+          @data[key.to_sym] = Book.new(value)
+        else
+          @data[key.to_sym] = value
+        end
+      end
+
+      def method_missing(sym, *args)
+        if sym.to_s =~ /(.+)=$/
+          self[$1] = args.first
+        else
+          self[sym]
+        end
+      end
 
-  def method_missing(sym, *args)
-    if sym.to_s =~ /(.+)=$/
-      self[$1] = args.first
-    else
-      self[sym]
     end
   end
-
 end

data/lib/bookshop/commands/yaml/toc.rb

@@ -0,0 +1,46 @@
+# Take a YAML data structure and express it in a 'class.attribute.attribute' convention so
+#   it can be used in the source files to call data from the toc.yml file
+#
+# # toc.yml
+# foo:
+#   bar: foobar
+#
+# is referenced in the source files as <%= toc.foo.bar %> and yields in build 'foobar'
+module Bookshop
+  module Commands
+    class Toc
+
+      def initialize(data={})
+        @data = {}
+        update!(data)
+      end
+
+      def update!(data)
+        data.each do |key, value|
+          self[key] = value
+        end
+      end
+
+      def [](key)
+        @data[key.to_sym]
+      end
+
+      def []=(key, value)
+        if value.class == Hash
+          @data[key.to_sym] = Book.new(value)
+        else
+          @data[key.to_sym] = value
+        end
+      end
+
+      def method_missing(sym, *args)
+        if sym.to_s =~ /(.+)=$/
+          self[$1] = args.first
+        else
+          self[sym]
+        end
+      end
+
+    end
+  end
+end

data/lib/bookshop/generators/bookshop/app/templates/README.rdoc

@@ -1,12 +1,18 @@
-== Welcome to bookshop
+=== http://blueheadpublishing.github.com/bookshop/assets/logo.png
 
-bookShop is a publishing framework for html-to-pdf/(e)book toolchain happiness and sustainable productivity. The framework is optimized to help developers quickly ramp-up, allowing them to more rapidly jump in and develop their html-to-pdf/(e)book (print-pdf, epub, mobi, etc.) flows, by favoring convention over configuration, setting them up with best practices, standards and tools from the start.
+    "a book publishing framework for today's publishing world"
+	
+bookshop is a book publishing framework for publishers, editors, and coders in today's publishing industry. bookshop provides a framework for developing books using well-known/standard web languages like HTML/CSS, which are then converted into pdf and other (e)book formats. The framework is optimized to help developers quickly ramp-up, allowing them to jump in and develop their html-to-pdf/(e)book flows, by favoring convention over configuration, setting them up with best-practices, standards and tools from the start.
 
 bookshop hopes to simplify the process by:
-* using common tools like HTML, CSS, etc. to make the creation of your book comfortable and familiar, greatly reducing the learning curve for your developers, authors, agents, and other team members
-* providing a Ruby Gem to make building a book from HTML as easy as 'gem install bookshop'
+* separating the book into layers
+  * *Content*: the book's source - <i>writings, images, videos, copy</i>
+  * *Structure*: using div/css microformat to describe the book's structure - <i>chapter, section, etc.</i>
+  * *Style*: stylesheets to create the book's layout - <i>fonts, margins, color, etc.</i>
+* using common tools like HTML/CSS to make the creation of your book comfortable and familiar, greatly reducing the learning curve for your developers, authors, agents, and other team members
+* providing a Ruby Gem to make building a book in HTML as easy as 'gem install bookshop'
 * pulling all the html-to-pdf/(e)book tools together into one place (wkhtmltopdf, kindlegen, epubcheck)
-* sticking with open-source tools
+* sticking with open-source tools to encourage community development
 * giving the developer a set of scripts to automate the redundant stuff
 * providing an architecture/structure that follows best-practices and simplification (DRY... Don't Repeat Yourself)
 
@@ -14,8 +20,7 @@ bookshop hopes to simplify the process by:
 
 === System Requirements
 
-* Ruby v1.8.7 or v1.9.2 http://www.ruby-lang.org/en/downloads/
-* Rubygems v1.3.6 http://docs.rubygems.org/read/chapter/3
+* Ruby v1.8.7 or higher http://www.ruby-lang.org/en/downloads/
 
 == Installation
 
@@ -25,13 +30,13 @@ bookshop hopes to simplify the process by:
 
 === Install wkhtmltopdf
 
-1. Install by hand (recommended):
+1. Try using the wkhtmltopdf-binary gem (mac + linux i386)
 
-https://github.com/blueheadpublishing/bookshop/wiki/Installing-wkhtmltopdf
+    $ gem install wkhtmltopdf-binary
 
-2. Try using the wkhtmltopdf-binary gem (mac + linux i386)
+2. Install by hand (for windows or users who want to install newer builds):
 
-    $ gem install wkhtmltopdf-binary
+https://github.com/blueheadpublishing/bookshop/wiki/Installing-wkhtmltopdf
 
 3. The wkhtmltopdf site has more info
 
@@ -39,18 +44,30 @@ https://github.com/blueheadpublishing/bookshop/wiki/Installing-wkhtmltopdf
 
 == Using bookshop
 
-=== Create a bookshop application
+=== Create a bookshop book
 
-    $ bookshop new name_of_book
+    $ bookshop new my_new_book
 
-	This will create a new bookshop app in /path/to/name_of_book
-	
-* If you can't issue bookshop from your command line, make sure you have included your gems folder in your system $PATH. In unix you can add the following to your .bashrc file in your home folder (this example is for Ubuntu 10.10):
+	This will create a new bookshop book in /path/to/my_new_book with the following structure:
+
+    |-- book/                 # Source files for your book
+        |--book.html.erb      # The master file
+        |--css/
+            |--stylesheet.css
+        |--images/
+
+    |-- builds/               # All the builds are created here
+        |--epub/
+        |--html/
+        |--mobi/
+        |--pdf/
+
+    |-- config/               # Your config and data settings
+        |--book.yml           # Settings/Data for your book
 
-  PATH="$PATH:/var/lib/gems/1.8/bin"
-  export PATH
 
 === Editing Your New Book
+
 ==== Where does my Book really live?
 
 All of the source documents and assets for your book are stored in the +book/+ folder. So your stylesheets, images, text - everything used for building your book - lives here. Ideally, you should only every edit files in your +book/+ folder (with the exception of your config/book.yml file).
@@ -59,23 +76,15 @@ All of the source documents and assets for your book are stored in the +book/+ f
 
 The source files are all in ERB. ERB is a templating language for the Ruby programming language. Why is this cool? Because it means that you can use HTML _and_ you can embed Ruby code in your source files. In other words, you can do all kinds of cool programmy things. Like embed ruby functions and calls:
 
-    <p>Today is <%= Time.now.strftime('%A') %>.</p>
-
-  or
+    <p>Today is <%= Time.now.strftime('%A') %>.</p>  # creates -> <p>Today is Thursday.</p>
 
-    items = [ "ball", "stick", "corgi" ]
-
-    <ul>
-      <% items.each do |item| %>
-        <li><%= item %></li>
-      <% end %>
-    </ul>
+More information on ERB - http://www.ruby-doc.org/stdlib-1.9.3/libdoc/erb/rdoc/ERB.html
 
 ==== One File to Rule Them All!
 
 Your master file (which is used to build everything) is the +book.html.erb+ file (remember that we are in the +book/+ folder). You could of course just use this file and put all of your book contents here, making one enormous file, but we don't recommend it... 
 
-==== The Magic of include()
+==== The Magic of import()
 
 Are you writing another "War and Peace"? We've created a nice way to make your epic book easier to manage. Rather than putting everything in the +book.html.erb+ file, you can +import+ files. This allows you to break your book up into smaller, more manageable pieces. This makes it soooooo much easier to manage your book. And others will thank you for it..
 
@@ -147,9 +156,9 @@ Here's an example +config/book.yml+ file with some Book Variables:
 
 You can then use these Book Variables in your book source file:
     
-    <p>The book isbn is <%= book.isbn %></p>
-    <p>The html title is <%= book.html.title %></p>
-    <p>The epub pub_date is <%= book.epub.pub_date %></p>
+    <p>The book isbn is <%= @book.isbn %></p>
+    <p>The html title is <%= @book.html.title %></p>
+    <p>The epub pub_date is <%= @book.epub.pub_date %></p>
 
 Note that you can construct and/or nest variables however you want to:
 
@@ -162,7 +171,7 @@ Note that you can construct and/or nest variables however you want to:
 
 Then call it in your source file with the variable:
 
-    <p>My made up friend's name is <%= book.my.madeup.friend.name %>
+    <p>My made up friend's name is <%= @book.my.madeup.friend.name %>
 
 More info about YAML:
 
@@ -172,30 +181,68 @@ http://en.wikipedia.org/wiki/YAML
 
 So, do you want to see something cool? Now that we have the Output Variable and Book Variables, we can combine them to do nifty things, like:
 
-    <p>The ISBN is <%= book.isbn %></p>
+    <p>The ISBN is <%= @book.isbn %></p>
     <p>Title: 
       <% if @output == :html %>
-        <%= book.html.title %>
+        <%= @book.html.title %>
       <% elsif @output == :pdf %>
-        <%= book.pdf.title %>
+        <%= @book.pdf.title %>
       <% elsif @output == :epub %>
-        <%= book.epub.title %>
+        <%= @book.epub.title %>
       <% end %>
     </p>
 
 Please explore other creative ways to structure and enhance your book (we'd love to see how you are doing it).
 
-http://www.ruby-doc.org/stdlib-1.9.3/libdoc/erb/rdoc/ERB.html
-
 === Building Your First Book
 
+To build an HTML format of your book from the ERB source:
+
+    $ bookshop build html   # -> find the output in builds/html/book_(date).html
+
 To build a pdf format of your book from the ERB source:
 
     $ bookshop build pdf    # -> find the output in builds/pdf/book_(date).pdf
 
-To build an HTML format of your book from the ERB source:
+==== Editing your pdf document options
 
-    $ bookshop build html   # -> find the output in builds/html/book_(date).html
+What if you want your pdf to print as Lanscape, or a different page-size, or in grayscale? Because bookshop uses PDFKit, you can pass wkhtmltopdf (the pdf rendering engine) options by way of <meta> tags in your html source code.
+
+For example, to print in Landscape mode, in your master +book/book.html.erb+ file we can add <meta name="pdfkit-orientation" content="Landscape" />:
+
+so you html would be:
+
+    <html>
+      <head>
+        <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
+        <meta name="pdfkit-orientation" content="Landscape" />
+        <title>how-to bookshop</title>
+        <link rel="stylesheet" type="text/css" href="css/stylesheet.css" />
+      </head>
+    <body>
+    <p>The ISBN is <%= @book.isbn %></p>
+
+Here's a list of other options https://github.com/blueheadpublishing/bookshop/wiki/wkhtmltopdf-options
+
+Or you can look at all of the possible wkhtmltopdf options by using the command:
+
+    $ wkhtmltopdf --extended-help
+
+Your meta tags should use the following naming conventions. 
+
+* For each option, replace the double-dashes '--' before the option with +pdfkit-+ and change single-dashes '-' to an underscore +_+.
+    --page-size
+
+    becomes
+
+    <meta name="pdfkit-page_size" content="Letter" />
+
+* For options that do not require an additional parameter/value, you still need to include the content attribute, but keep it blank.
+    --grayscale
+
+    becomes
+
+    <meta name="pdfkit-grayscale" content="" />
 
 == Example Book
 
@@ -213,14 +260,20 @@ You can then build the book into whatever format you like.
 
 The default directory structure of a generated bookshop project:
 
-  |-- book
-  |-- builds
-    epub
-    html
-    mobi
-    pdf
+    |-- book/                 # Source files for your book
+        |--book.html.erb      # The master file
+        |--css/
+            |--stylesheet.css
+        |--images/
+
+    |-- builds/               # All the builds are created here
+        |--epub/
+        |--html/
+        |--mobi/
+        |--pdf/
 
-  |-- config
+    |-- config/               # Your config and data settings
+        |--book.yml           # Settings/Data for your book
 
 book
   Holds all the manuscript html code/files. This is where your master manuscript lives from which everything is built.
@@ -249,9 +302,45 @@ config
 6. Let us know about your code and we'll review/merge it into the master.
 7. And pat yourself on the back for contributing to an open source project!!
 	
-== Copyright (MIT-LICENSE)
+== Copyright (LICENSE)
+
+BookShop is available under *either* the terms of the modified BSD license *or* the
+MIT License (2008). As a recipient of BookShop, you may choose which
+license to receive this code under (except as noted in per-module LICENSE
+files). Some modules may not be the copyright of BlueHead Publishing. These
+modules contain explicit declarations of copyright in both the LICENSE files in
+the directories in which they reside and in the code itself. No external
+contributions are allowed under licenses which are fundamentally incompatible
+with the MIT or BSD licenses that BookShop is distributed under.
+
+The text of the MIT and BSD licenses is reproduced below.
+
+=== The "New" BSD License
+
+Copyright (c) 2010-2011, BlueHead Publishing
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* Neither the name of Bookshop/BlueHead/BlueHead Publishing nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+=== The MIT License
 
-Copyright (C) 2010, 2011 by BlueHead Publishing, Inc (http://blueheadpublishing.com)
+Copyright (c) 2010, 2011 BlueHead Publishing, et. al.,
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -273,9 +362,9 @@ THE SOFTWARE.
 
 == The Boom Microformat License (as listed in the boom.css)
 
-  Sample style sheet for boom!, the book microformat
-  written  by Hakon Wium Lie and Bert Bos, November 2005
-  You may reuse this style sheet for any purpose without any fees
+Sample style sheet for boom!, the book microformat
+written  by Hakon Wium Lie and Bert Bos, November 2005
+You may reuse this style sheet for any purpose without any fees
 
 == Thanks