couchbase-git-scribe 0.1.1.1

data/lib/git-scribe/init.rb

@@ -0,0 +1,16 @@
+class GitScribe
+  module Init
+    # start a new scribe directory with skeleton structure
+    def init(args = [])
+      name = first_arg(args)
+      die("needs a directory name") if !name
+      die("directory already exists") if File.exists?(name)
+
+      info "inititalizing #{name}"
+      from_stdir = File.join(SCRIBE_ROOT, 'template')
+      ign = Dir.glob(from_stdir + '/.[a-z]*')
+      FileUtils.cp_r from_stdir, name
+      FileUtils.cp_r ign, name
+    end
+  end
+end

data/lib/git-scribe/version.rb

@@ -0,0 +1,3 @@
+class GitScribe
+  VERSION = '0.1.1.1'
+end

data/lib/subcommand.rb

@@ -0,0 +1,266 @@
+#!/usr/bin/env ruby -w
+######################################
+# A tiny wrapper over optparse that gives easy subcommand facility.
+# It also neatly prints help for global and subcommands
+# as well as summarizes subcommands in global help.
+#
+# Thanks to Robert Klemme for his idea on lazy loading the subcommand option parsers.
+# 
+# @author Rahul Kumar, Jun  2010
+# @date 2010-06-20 22:33 
+#
+# @examples
+# if a program has subcommands foo and baz
+#
+# ruby subcommand.rb help
+# ruby subcommand.rb --help
+# ruby subcommand.rb help foo
+# ruby subcommand.rb foo --help
+# ruby subcommand.rb baz --quiet "some text"
+# ruby subcommand.rb --verbose foo --force file.zzz
+#
+# == STEPS 
+#    1. define global_options (optional)
+#
+#     global_options do |opts|
+#       opts.banner = "Usage: #{$0} [options] [subcommand [options]]"
+#       opts.description = "Stupid program that does something"
+#       opts.separator ""
+#       opts.separator "Global options are:"
+#       opts.on("-v", "--[no-]verbose", "Run verbosely") do |v|
+#         options[:verbose] = v
+#       end
+#     end
+#
+#    2. define commands using command().
+#     command :foo do |opts|
+#       opts.banner = "Usage: foo [options]"
+#       opts.description = "desc for foo"
+#       opts.on("-f", "--[no-]force", "force verbosely") do |v|
+#         options[:force] = v
+#       end
+#     end
+#
+#    3. call opt_parse()
+#
+#    4. As before, handle ARGS and options hash.
+#
+# TODO: add aliases for commands
+######################################
+require 'optparse'
+
+# Allow command to have a description to generate help
+class OptionParser
+  attr_accessor :description
+  #attr_accessor :action
+end
+
+module Subcommands
+  ##
+  # specify a single command and all its options
+  # If multiple names are given, they are treated as aliases.
+  # Do repeatedly for each command
+  # Yields the optionparser
+  def command *names
+    name = names.shift
+    @commands ||= {}
+    @aliases ||= {}
+    if names.length > 0
+      names.each do |n| 
+        #puts "aliases #{n} => #{name} "
+        @aliases[n.to_s] = name.to_s
+      end
+    end
+    # Thanks to Robert Klemme for the lazy loading idea.
+    opt = lambda { OptionParser.new do |opts|
+      yield opts
+      # append desc to banner in next line
+      opts.banner << "\n#{opts.description}\n" if opts.description
+    end }
+    @commands[name.to_s] = opt
+  end
+  # specify global options and banner and description
+  # Yields the optionparser
+  def global_options
+    if !defined? @global
+      @global = OptionParser.new do |opts|
+        yield opts
+      end
+    else
+      yield @global
+    end
+  end
+  def print_actions
+    cmdtext = "Commands are:"
+    @commands.each_pair do |c, opt| 
+      #puts "inside opt.call loop"
+      desc = opt.call.description
+      cmdtext << "\n   #{c} : #{desc}"
+    end
+
+    # print aliases
+    unless @aliases.empty?
+      cmdtext << "\n\nAliases: \n" 
+      @aliases.each_pair { |name, val| cmdtext << "   #{name} - #{val}\n"  }
+    end
+
+    cmdtext << "\n\nSee '#{$0} help COMMAND' for more information on a specific command."
+  end
+  ## add text of subcommands in help and --help option
+  def add_subcommand_help
+    # user has defined some, but lets add subcommand information
+
+    cmdtext = print_actions
+
+    global_options do |opts|
+      # lets add the description user gave into banner
+      opts.banner << "\n#{opts.description}\n" if opts.description
+      opts.separator ""
+      opts.separator cmdtext
+    end
+  end
+  # this is so that on pressing --help he gets same subcommand help as when doing help.
+  # This is to be added in your main program, after defining global options
+  # if you want detailed help on --help. This is since optionparser's default
+  # --help will not print your actions/commands
+  def add_help_option
+    global_options do |opts|
+      opts.on("-h", "--help", "Print this help") do |v|
+        add_subcommand_help
+        puts @global
+        exit
+      end
+    end
+  end
+  # first parse global optinos
+  # then parse subcommand options if valid subcommand
+  # special case of "help command" so we print help of command - git style (3)
+  # in all invalid cases print global help
+  # @return command name if relevant
+  def opt_parse
+    # if user has not defined global, we need to create it
+    @command_name = nil
+    if !defined? @global
+      global_options do |opts|
+        opts.banner = "Usage: #{$0} [options] [subcommand [options]]"
+        opts.separator ""
+        opts.separator "Global options are:"
+        opts.on("-h", "--help", "Print this help") do |v|
+          add_subcommand_help
+          puts @global
+          exit
+        end
+        opts.separator ""
+        #opts.separator subtext # FIXME: no such variable supposed to have subcommand help
+      end
+    else
+    end
+    @global.order!
+    cmd = ARGV.shift
+    if cmd
+      #$stderr.puts "Command: #{cmd}, args:#{ARGV}, #{@commands.keys} "
+      sc = @commands[cmd] 
+      #puts "sc: #{sc}: #{@commands}"
+      unless sc
+        # see if an alias exists
+        sc, cmd = _check_alias cmd
+      end
+      # if valid command parse the args
+      if sc
+        @command_name = cmd
+        sc.call.order!
+      else
+        # else if help <command> then print its help GIT style (3)
+        if !ARGV.empty? && cmd == "help"
+          cmd = ARGV.shift
+          #$stderr.puts " 110 help #{cmd}"
+          sc = @commands[cmd]
+          # if valid command print help, else print global help
+          unless sc
+            sc, cmd = _check_alias cmd
+          end
+          if sc
+            #puts " 111 help #{cmd}"
+            puts sc.call
+          else 
+            # no help for this command XXX check for alias
+            puts "Invalid command: #{cmd}."
+            add_subcommand_help
+            puts @global
+          end
+        else
+          # invalid command 
+          puts "Invalid command: #{cmd}" unless cmd == "help"
+          add_subcommand_help
+          puts @global 
+        end
+        exit 0
+      end
+    end
+    return @command_name
+  end
+  def alias_command name, *args
+    @aliases[name.to_s] = args
+  end
+  def _check_alias cmd
+    alas = @aliases[cmd]
+    #$stderr.puts "195 alas: #{alas} "
+    if alas
+      case alas
+      when Array
+        cmd = alas.shift
+        #$stderr.puts "Array cmd: #{cmd} "
+        ARGV.unshift alas.shift unless alas.empty?
+        #$stderr.puts "ARGV  #{ARGV} "
+      else
+        cmd = alas
+      end
+    end
+    sc = @commands[cmd] if cmd
+    return sc, cmd
+  end
+end
+
+if __FILE__ == $PROGRAM_NAME
+  include Subcommands
+  options = {}
+  appname = File.basename($0)
+  # global is optional
+  global_options do |opts|
+    opts.banner = "Usage: #{appname} [options] [subcommand [options]]"
+    opts.description = "Stupid program that does something"
+    opts.separator ""
+    opts.separator "Global options are:"
+    opts.on("-v", "--[no-]verbose", "Run verbosely") do |v|
+      options[:verbose] = v
+    end
+  end
+  add_help_option
+  # define a command
+  command :foo, :goo do |opts|
+    opts.banner = "Usage: foo [options]"
+    opts.description = "desc for foo"
+    opts.on("-f", "--[no-]force", "force verbosely") do |v|
+      options[:force] = v
+    end
+  end
+  command :baz do |opts|
+    opts.banner = "Usage: baz [options]"
+    opts.description = "desc for baz"
+    opts.on("-q", "--[no-]quiet", "quietly run ") do |v|
+      options[:quiet] = v
+    end
+  end
+  alias_command :bar, 'baz'
+  alias_command :boo, 'foo', '--force'
+  alias_command :zoo, 'foo', 'ruby'
+
+  # do the parsing.
+  cmd = opt_parse()
+
+  puts "cmd: #{cmd}"
+  puts "options ......"
+  p options
+  puts "ARGV:"
+  p ARGV
+end

data/site/default/book-docinfo.xml

@@ -0,0 +1,23 @@
+<mediaobject role="cover">
+  <imageobject>
+    <imagedata fileref="{{cover_image}}" format="JPG"/>
+  </imageobject>
+  <textobject><phrase>{{title}}</phrase></textobject>
+</mediaobject>
+<mediaobject role="icons">
+  <imageobject>
+    <imagedata fileref="images/icons/note.png" format="PNG"/>
+  </imageobject>
+  <imageobject>
+    <imagedata fileref="images/icons/caution.png" format="PNG"/>
+  </imageobject>
+  <imageobject>
+    <imagedata fileref="images/icons/important.png" format="PNG"/>
+  </imageobject>
+  <imageobject>
+    <imagedata fileref="images/icons/tip.png" format="PNG"/>
+  </imageobject>
+  <imageobject>
+    <imagedata fileref="images/icons/warning.png" format="PNG"/>
+  </imageobject>
+</mediaobject>

data/site/default/book.opf

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<package xmlns="http://www.idpf.org/2007/opf" version="2.0">
+
+<metadata xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:opf="http://www.idpf.org/2007/opf">
+  <dc:title>{{title}}</dc:title>
+  <dc:language>en</dc:language>
+  <dc:creator>{{author}}</dc:creator>
+  <dc:date>{{pubdate}}</dc:date>
+  <dc:publisher>GitHub.com</dc:publisher>
+  <meta name="cover" content="cover"/>
+</metadata>
+
+<manifest>
+  <item id="book" media-type="application/xhtml+xml" href="book.html"></item>
+  <item id="toc_file" media-type="application/xhtml+xml" href="toc.html"></item>
+  <item id="toc" media-type="application/x-dtbncx+xml" href="book.ncx"/>
+  <item id="cover" media-type="image/jpeg" href="{{cover_image}}"/>
+</manifest>
+
+<spine toc="toc">
+  <itemref idref="book"/>
+</spine>
+
+<guide>
+  <reference type="toc" title="Table of Contents" href="toc.html"></reference>
+  <reference type="text" title="Contents" href="book.html"></reference>
+</guide>
+
+</package>
+

data/site/default/index.html

@@ -0,0 +1,43 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <link rel="stylesheet" href="master.css" type="text/css" />
+    <title>{{book_title}}</title>
+  </head>
+  <body>
+    <a href="book.epub">Epub (iBooks)</a> | 
+    <a href="book.mobi">Mobi (Kindle)</a> | 
+    <a href="book.html">Single Page</a> | 
+    <a href="book.pdf">PDF</a>
+    <hr/>
+    <div class="content">
+      <h1>{{book_title}}</h1>
+      <hr/>
+      <div>
+        {{toc}}
+      </div>
+      <div id="toc">
+        <ul>
+        {% for section in sections %}
+          <li>
+          <h2><a href="{{ section.link }}">{{section.title}}</a></h2>
+            {% if section.sub %}
+            <ul>
+              {% for sub in section.sub %}
+              <li><a href="{{ sub.link }}">{{ sub.title }}</a></li>
+              {% endfor %}
+            </ul>
+            {% endif %}
+          </li>
+        {% endfor %}
+        </ul>
+      </div>
+    </div>
+    <hr/>
+    <a href="book.epub">Epub (iBooks)</a> | 
+    <a href="book.mobi">Mobi (Kindle)</a> | 
+    <a href="book.html">Single Page</a> | 
+    <a href="book.pdf">PDF</a>
+  </body>
+</html>

data/site/default/master.css

@@ -0,0 +1,281 @@
+/* BEG */
+/* ---------------------------------------------------------------------------
+   Bare AsciiDoc styles
+   Ryan Tomayko <r@tomayko.com>
+--------------------------------------------------------------------------- */
+
+body {
+  font-family:"Helvetica Neue", Helvetica, Arial, sans-serif;
+  font-size: 1.0em;
+  line-height:140%;
+  margin-left: 10%;
+  margin-right: 10%;
+  min-width: 790px;
+  color:#222;
+  background: #eee;
+}
+
+.tip { 
+	background: #eee;
+	padding: 0 10px;
+}
+.warning { 
+	background: #fcc;
+	padding: 0 10px;
+}
+.important { 
+	background: #ccf;
+	padding: 0 10px;
+}
+.caution { 
+	background: #ffc;
+	padding: 0 10px;
+}
+.content {
+  background: #fff;
+  padding: 20px;
+}
+
+a {
+  color: #336;
+}
+
+a:visited {
+  color: #447;
+}
+
+.nav {
+  color: #777;
+}
+.nav a {
+  color: #555;
+}
+
+#toc a { 
+	text-decoration: none; 
+	color: #444;
+}
+#toc > ul { 
+	list-style: none;
+	padding-left: 0;
+}
+#toc > ul ul { 
+	list-style: none;
+}
+
+hr { border: none; border-bottom: 1px solid #ccc; }
+
+em {
+	font-style:italic;
+}
+
+strong {
+	font-weight:bold;
+	color:#000;
+}
+
+tt {
+	font-family:consolas, 'lucida console', 'bitstream vera sans mono',
+	           'courier new', monospace;
+	color:#000;
+}
+
+p, ul, ol, dl {
+	margin:10px 0
+}
+
+dl {
+	margin-left:40px
+}
+
+dt {
+	font-weight:normal;
+	color:#000;
+}
+
+h1, h2, h3, h4, h5 {
+	font-family:'lucida grande',georgia,verdana,helvetica,arial,sans-serif;
+	font-weight:normal;
+	color:#000;
+}
+
+h1 {
+	font-size:30px;
+	line-height:1.428;
+	margin:20px 0;
+}
+
+h2 {
+	font-size:23px;
+	line-height:1.36363636; /* repeating, of course */
+	margin:20px 0;
+}
+
+h2 + .sectionbody {}
+
+h3 {
+	font-size:18px;
+	line-height:1.1;
+	margin:30px 0 10px 0;
+}
+
+h4 {
+	font-size:13px;
+	font-weight:bold;
+	line-height:1.538;
+}
+
+h5 {
+	font-size:13px;
+	font-style:italic;
+	line-height:1.538;
+}
+
+pre {
+	font-size:larger;
+}
+
+#header { 
+	text-align:center;
+	margin-bottom:30px;
+}
+
+#header h1 { margin-bottom:0 }
+
+
+.title, .sidebar-title {
+	font-weight:normal;
+	margin-bottom:0;
+}
+
+.admonitionblock .title {
+	font-weight:bold;
+}
+
+.admonitionblock {
+	margin:30px 0px;
+	color:#555;
+}
+
+.admonitionblock td.icon {
+	width:30px;
+	padding-right:20px;
+	padding-left:20px;
+	text-transform:uppercase;
+	font-weight:bold;
+	color:#888;
+}
+
+.listingblock .content {
+	border:1px solid silver;
+	background:#eee;
+	padding:5px;
+}
+
+.listingblock .content pre {
+	margin:0;
+}
+
+.literalblock .content {
+	margin-left:40px;
+}
+
+.verseblock .content {
+	white-space:pre
+}
+
+.sidebarblock .sidebar-content {
+	border:1px solid silver;
+	background:#FFFFEE;
+	padding:0 10px;
+	color:#222;
+	font-size:smaller;
+	line-height:1.5;
+}
+
+.sidebar-title {
+	margin:10px 0;
+	font-weight:bold;
+	color:#442;
+}
+
+.quoteblock-content {
+	font-style:italic;
+	color:#444;
+	margin-left:40px;
+}
+
+.quoteblock-content .attribution {
+	font-style:normal;
+	text-align:right;
+	color:#000;
+}
+
+.exampleblock-content *:first-child { margin-top:0 }
+.exampleblock-content {
+	border-left:2px solid silver;
+	padding-left:8px;
+}
+
+#footer {
+	font-size:11px;
+	margin-top:40px;
+	border-top:1px solid silver;
+	color:#555;
+}
+
+#author {
+	color:#000;
+	text-transform:uppercase
+}
+
+/* vim: set ft=css ts=4 sw=4 noexpandtab: */
+
+/* END @import url(bare.css); */
+
+/* ---------------------------------------------------------------------------
+   FreeBSD AsciiDoc Theme
+   Ryan Tomayko <r@tomayko.com>
+
+   Based on The FreeBSD Handbook and various other FreeBSD documenration.
+--------------------------------------------------------------------------- */
+
+tt { color:#007A00 }
+pre tt { color:#000 }
+
+dt { color:#000 }
+
+h1, h2, h3, h4, h5 {
+  font-family:'lucida grande',helvetica,verdana,sans-serif;
+  color:#900;
+  font-weight:bold;
+}
+
+#header {
+  text-align:left;
+}
+#header h1 { margin-bottom:40px }
+
+h1 {
+  font-size:36px;
+  line-height:1;
+  margin:40px 0;
+}
+
+h2 {
+  font-size:28px;
+  line-height:1;
+  margin:30px 0 20px 0;
+}
+
+.sectionbody {
+  margin-left:30px;
+}
+
+pre {
+  background:#000;
+  color:#fff;
+  padding: 15px;
+}
+
+/* vim: set ft=css ts=4 sw=4 noexpandtab: */