fnando-bookmaker 0.0.7

data/History.txt

@@ -0,0 +1,41 @@
+== 0.0.1 2008-06-06
+
+* 1 major enhancement:
+  * Initial release
+
+== 0.0.2 2008-06-09
+* 1 major enhancement
+	* Added textile support
+* Bug fix
+	* Wrong require was throwing an error
+	
+== 0.0.3 2008-06-09
+* Cleaning up the house
+	* README converted to Markdown
+* 1 major enhancement
+	* Added syntax callback for Textile and Markdown
+
+== 0.0.4 2008-06-12
+* 1 major enhancement
+	* Added some textile helpers
+* 1 bug fix
+	* Textile was escaping code inside <pre> blocks
+	
+== 0.0.5 2008-06-17
+* 1 small changes
+	* Removed frontcover and backcover jpgs
+* 1 bug fix
+	* Line stub (__) now ignores spaces and tabs
+
+== 0.0.6 2008-06-20
+* 1 major change
+	* All rake tasks moved to namespace 'book'
+* 1 major enhancement
+	* Added task book:watch
+
+== 0.0.7 2008-06-21
+* 1 major enhancement
+	* Added Table of Contents based on h2-h6 tags
+	* Added `book:titles` rake task
+* 1 small enhancement
+	* Added new Textile link tag (similar to Markdown)

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Nando Vieira
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest.txt

@@ -0,0 +1,38 @@
+History.txt
+License.txt
+Manifest.txt
+PostInstall.txt
+README.markdown
+TODO.txt
+Rakefile
+app_generators/bookmaker/bookmaker_generator.rb
+app_generators/bookmaker/templates/config.yml
+app_generators/bookmaker/templates/Rakefile
+app_generators/bookmaker/templates/user.css
+app_generators/bookmaker/templates/layouts/boom/layout.html
+app_generators/bookmaker/templates/layouts/boom/layout.css
+app_generators/bookmaker/templates/css/active4d.css
+app_generators/bookmaker/templates/css/blackboard.css
+app_generators/bookmaker/templates/css/dawn.css
+app_generators/bookmaker/templates/css/eiffel.css
+app_generators/bookmaker/templates/css/idle.css
+app_generators/bookmaker/templates/css/iplastic.css
+app_generators/bookmaker/templates/css/lazy.css
+app_generators/bookmaker/templates/css/mac_classic.css
+app_generators/bookmaker/templates/css/slush_poppies.css
+app_generators/bookmaker/templates/css/sunburst.css
+bin/bookmaker
+config/hoe.rb
+config/requirements.rb
+lib/bookmaker.rb
+lib/bookmaker/version.rb
+lib/bookmaker/base.rb
+lib/bookmaker/tasks.rb
+lib/bookmaker/blackcloth.rb
+script/console
+script/destroy
+script/generate
+script/txt2html
+setup.rb
+test/test_bookmaker.rb
+test/test_helper.rb

data/README.markdown

@@ -0,0 +1,168 @@
+Bookmaker
+=========
+
+* <http://github.com/fnando/bookmaker>
+
+DESCRIPTION:
+------------
+
+A framework for creating e-books from Markdown/Textile text markup using Ruby. 
+Using the Prince PDF generator, you'll be able to get high quality PDFs.
+Mac users that have [Textmate](http://macromates.com) installed can have source 
+code highlighted with his/her favorite theme.
+
+While Prince is too expensive (495USD for a single user license), the 
+free version available at <http://www.princexml.com/download/> generates
+a PDF with a small logo on the first page, which is removed when sent
+to a printer.
+
+FEATURES:
+---------
+
+* Write PDF using Markdown or Textile text markup
+* Book layout support
+* Syntax highlight theme based on Textmate
+* Generate a PDF with a single rake task
+* Table of Contents automatically generated from chapter titles
+
+SYNOPSIS:
+---------
+
+Create a new book with `bookmaker mybook`. Bookmaker has support for book
+layout and syntax highlight theme. You can specify other settings:
+
+	bookmaker mybook --theme=mac_classic
+	bookmaker mybook --layout=boom
+
+You can check available layouts and themes with `bookmaker --help`
+
+The `bookmaker` command creates a directory "mybook" with the 
+following structure:
+
+- book
+	- config.yml
+	- images
+	- output
+	- Rakefile
+	- templates
+		- layout.css
+		- layout.html
+		- syntax.css
+		- user.css
+	- text
+
+The `config.yml` file holds some information about your book; so you'll always
+change it. This is the default generated file:
+
+	title: [Your Book Title]
+	copyright: Copyright (c) 2008 [Your Name], All Rights Reserved
+	authors:
+	  - [Your Name]
+	  - [Other Name]
+	subject: [Write down what your book is about]
+	keywords: [The keywords related to your book]
+	theme: eiffel
+
+If you're writing on a different language, the `user.css` file can override all
+the messages added by the `layout.css`. Examples on doing this coming soon.
+
+Now it's time to write your book. All your book content will be placed on the
+text directory. Bookmaker requires you to separate your book into chapters. 
+A chapter is nothing but a directory that holds lots of Markdown/Textile files.
+The book will be generated using every folder/file alphabetically. So be sure 
+to use a sequential numbering as the name. Here's a sample:
+
+- text
+	- 01_Introduction
+		- 01\_introduction.markdown
+	- 02\_What\_is\_Ruby\_on\_Rails
+		- 01\_MVC.markdown
+		- 02\_DRY.markdown
+		- 03\_Convention\_Over\_Configuration.markdown
+	- 03\_Installing\_Ruby\_on\_Rails
+		- 01\_Installing.textile
+		- 02\_Mac\_OS\_X\_instructions.textile
+		- 03\_Windows\_instructions.markdown
+		- 04\_Ubuntu\_Linux\_instructions.markdown
+
+Note that you can use Textile or Markdown at the same time. Just use the 
+`.markdown` or `.textile` file extension.
+
+You'll want to see your progress eventually; it's time for you to generate
+the book PDF. Just run the command `rake book:pdf` and your book will be 
+created on the output directory.
+
+There are other rake tasks you can use:
+
+* `book:html` - generate a html from your content
+* `book:syntaxes` - list all available syntaxes
+* `book:themes` - list all available themes
+* `book:titles` - list all titles and its permalinks
+* `book:watch` - watch `text` for any change and automatically generate html
+
+Bookmaker can generate a Table of Contents (TOC) based on your h2-h6 tags. The 
+h1 tag is discarded because it's meant to be the book title. 
+
+If you need to link to a specific chapter, you can use the `book:titles` rake
+task to know what's the permalink that you need. For example, a title 
+`Installing Mac OS X` will have a permalink `installing-mac-os-x` and you can
+link to this chapter by writing
+`"See more on Installing Mac OS X":#installing-mac-os-x` when using 
+Textile.
+
+To generate the TOC, you need to print a variable called `toc`, using the eRb
+tag `<%= toc %>`.
+
+INSTALL:
+--------
+
+You need to install some gems before you go any further.
+
+	sudo gem install rubigen
+	sudo gem install discount
+	sudo gem install RedCloth
+
+If you're a Mac user and have Textmate installed, you can
+generate HTML from your source code with syntax highlight,
+the same way you see in Textmate. First, you need to install
+Oniguruma regular expression library that can be found at 
+<http://www.geocities.jp/kosako3/oniguruma/>
+
+Then, you need to install the Ultraviolet gem.
+
+	sudo gem install ultraviolet
+
+REFERENCES:
+-----------
+
+- Textile: <http://hobix.com/textile/>
+- Markdown: <http://daringfireball.net/projects/markdown/syntax>
+
+MAINTAINER
+----------
+ 
+* Nando Vieira (<http://simplesideias.com.br>)
+
+LICENSE:
+--------
+
+(The MIT License)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,4 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }

data/TODO.txt

@@ -0,0 +1,2 @@
+- Create additional layouts
+- Support Linux and Windows (Linux is probably already supported, but need testing to be sure)

data/app_generators/bookmaker/bookmaker_generator.rb

@@ -0,0 +1,68 @@
+require 'bookmaker'
+
+class BookmakerGenerator < RubiGen::Base
+
+  DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'],
+                              Config::CONFIG['ruby_install_name'])
+
+  default_options :theme => Bookmaker::Base.default_theme,
+    :layout => Bookmaker::Base.default_layout
+  attr_reader :theme, :layout
+
+  def initialize(runtime_args, runtime_options = {})
+    super
+    usage if args.empty?
+    @destination_root = File.expand_path(args.shift)
+    @name = base_name
+    extract_options
+  end
+
+  def manifest
+    record do |m|
+      m.directory ''
+      BASEDIRS.each { |path| m.directory path }
+      
+      m.template "Rakefile", "Rakefile"
+      m.template "user.css", "templates/user.css"
+      m.template "layouts/#{@layout}/layout.css", "templates/layout.css"
+      m.template "layouts/#{@layout}/layout.html", "templates/layout.html"
+      m.template "css/#{@theme}.css", "templates/syntax.css"
+      m.template "config.yml", "config.yml", :assigns => {:theme => @theme}
+    end
+  end
+
+  protected
+    def banner
+      <<-EOS
+The 'bookmaker' command creates a new book with a default
+directory structure at the path you specify.
+
+USAGE: #{spec.name} /path/to/your/book [options]
+EOS
+    end
+
+    def add_options!(opts)
+      opts.separator ''
+      opts.separator 'Options:'
+      opts.on("-v", "--version", "Show the #{File.basename($0)} version number and quit.")
+      opts.on("--layout=LAYOUT_NAME", String,
+        "Define the book layout (#{Bookmaker::Base.layouts.join('|')})",
+        "Default: #{Bookmaker::Base.default_layout}") { |x| options[:layout] = x }
+      opts.on("--theme=THEME_NAME", String,
+        "Define the syntax highlight theme (#{Bookmaker::Base.themes.join('|')})",
+        "Default: #{Bookmaker::Base.default_theme}") { |x| options[:theme] = x } if RUBY_PLATFORM =~ /darwin/
+    end
+
+    def extract_options
+      @theme = options[:theme]
+      @layout = options[:layout]
+    end
+
+    BASEDIRS = %w(
+      templates
+      text
+      output
+      images
+      code
+    )
+end

data/app_generators/bookmaker/templates/Rakefile

@@ -0,0 +1,3 @@
+BOOKMAKER_ROOT = File.dirname(__FILE__)
+ENV['BOOKMAKER_NAME'] ||= File.basename(BOOKMAKER_ROOT)
+require "bookmaker/tasks"

data/app_generators/bookmaker/templates/config.yml

@@ -0,0 +1,8 @@
+title: [Your Book Title]
+copyright: Copyright (c) <%= Time.now.year %> [Your Name], All Rights Reserved
+authors:
+  - [Your Name]
+  - [Other Name]
+subject: [Write down what your book is about]
+keywords: [The keywords related to your book]
+theme: <%= theme %>

data/app_generators/bookmaker/templates/css/active4d.css

@@ -0,0 +1,114 @@
+pre.active4d .DiffHeader {
+   background-color: #656565;
+   color: #FFFFFF;
+}
+pre.active4d .Operator {
+}
+pre.active4d .InheritedClass {
+}
+pre.active4d .TypeName {
+   color: #21439C;
+}
+pre.active4d .Number {
+   color: #A8017E;
+}
+pre.active4d .EmbeddedSource {
+   background-color: #ECF1FF;
+}
+pre.active4d {
+   background-color: #FFFFFF;
+   color: #000000;
+}
+pre.active4d .DiffInsertedLine {
+   background-color: #98FF9A;
+   color: #000000;
+}
+pre.active4d .LibraryVariable {
+   color: #A535AE;
+}
+pre.active4d .Storage {
+   color: #FF5600;
+}
+pre.active4d .InterpolatedEntity {
+   font-weight: bold;
+   color: #66CCFF;
+}
+pre.active4d .line-numbers {
+   background-color: #BAD6FD;
+   color: #000000;
+}
+pre.active4d .LocalVariable {
+   font-weight: bold;
+   color: #6392FF;
+}
+pre.active4d .DiffLineRange {
+   background-color: #1B63FF;
+   color: #FFFFFF;
+}
+pre.active4d .BlockComment {
+   color: #D33435;
+}
+pre.active4d .TagName {
+   color: #016CFF;
+}
+pre.active4d .FunctionArgument {
+}
+pre.active4d .BuiltInConstant {
+   color: #A535AE;
+}
+pre.active4d .LineComment {
+   color: #D33535;
+}
+pre.active4d .DiffDeletedLine {
+   background-color: #FF7880;
+   color: #000000;
+}
+pre.active4d .NamedConstant {
+   color: #B7734C;
+}
+pre.active4d .CommandMethod {
+   font-weight: bold;
+   color: #45AE34;
+}
+pre.active4d .TableField {
+   color: #0BB600;
+}
+pre.active4d .PlainXmlText {
+   color: #000000;
+}
+pre.active4d .Invalid {
+   background-color: #990000;
+   color: #FFFFFF;
+}
+pre.active4d .LibraryClassType {
+   color: #A535AE;
+}
+pre.active4d .TagAttribute {
+   color: #963DFF;
+}
+pre.active4d .Keyword {
+   font-weight: bold;
+   color: #006699;
+}
+pre.active4d .UserDefinedConstant {
+}
+pre.active4d .String {
+   color: #666666;
+}
+pre.active4d .DiffUnchangedLine {
+   color: #5E5E5E;
+}
+pre.active4d .TagContainer {
+   color: #7A7A7A;
+}
+pre.active4d .FunctionName {
+   color: #21439C;
+}
+pre.active4d .Variable {
+   font-weight: bold;
+   color: #0053FF;
+}
+pre.active4d .DateTimeLiteral {
+   font-weight: bold;
+   color: #66CCFF;
+}