softcover-nonstop 1.0.beta2

data/lib/softcover/template/latex_styles/softcover.sty

@@ -0,0 +1,167 @@
+% This is a generated file. Do not edit.
+
+% Page size
+% These settings are optimized for ebooks.
+% If you want different settings, override them in custom_pdf.sty.
+\setlength{\oddsidemargin}{.25in}
+\setlength{\evensidemargin}{.25in}
+\setlength{\textheight}{8in}
+\setlength{\textwidth}{6.25in}
+\setlength{\topmargin}{0in}
+
+% Font encodings
+\usepackage[T1]{fontenc}
+% Be able to define colors
+\usepackage[svgnames]{xcolor}
+% Be able to include book covers
+\usepackage{pdfpages}
+% Include graphics
+\usepackage{graphicx}
+\def\maxwidth#1{\ifdim\Gin@nat@width>#1 #1\else\Gin@nat@width\fi}
+% Commands included by PolyTeXnic
+\usepackage{latex_styles/polytexnic_commands}
+% Links
+\definecolor{darkblue}{rgb}{0,0.18,0.45}
+\definecolor{darkgreen}{rgb}{0,0.39,0}
+% Bizarrely, we need to define the ALL CAPS version of DARKGREEN to account
+% for some edge cases, whose nature remains mysterious.
+\definecolor{DARKGREEN}{rgb}{0,0.39,0}
+\definecolor{hilightyellow}{rgb}{1.0,1.0,0.8}
+% Configure hyperref footnotes
+\usepackage[hyperfootnotes=false]{hyperref}
+\hypersetup{hyperfootnotes=false}
+\hypersetup{colorlinks,linkcolor=darkblue,urlcolor=blue}
+% Syntax highlighting
+\usepackage{latex_styles/pygments}
+% Change color of '@go', "general output", from gray to dark green.
+\expandafter\def\csname PY@tok@go\endcsname{\def\PY@tc##1{\textcolor{darkgreen}{##1}}}
+% American Mathematical Society extensions
+\usepackage{amsmath}
+\usepackage{amsfonts}
+% 'Verbatim' environment
+\usepackage{fancyvrb}
+% Be able to resize text relative to other text
+\usepackage{relsize}
+% Support longtable environment.
+\usepackage{longtable}
+% Support strikethrough (via \sout{text})
+\usepackage[normalem]{ulem}
+
+% Configure fonts
+\renewcommand{\rmdefault}{ptm}
+\usepackage{courier}
+\normalfont % in case the EC fonts aren't available
+
+% Code environments
+\DefineVerbatimEnvironment%
+  {code}{Verbatim}{fontsize=\relsize{-2.5},fontseries=b}
+% The metacode environment exists solely to allow meta-discussion of the code
+% environment, as in
+%   %= lang:latex
+%   \begin{metacode}
+%   %= lang:ruby
+%   \begin{code}
+%   def foo
+%     "bar"
+%   end
+%   \end{code}
+%   \end{metacode}
+\DefineVerbatimEnvironment%
+  {metacode}{Verbatim}{fontsize=\relsize{-2.5},fontseries=b}
+% Use a nice font in code environments.
+\usepackage[scaled=0.92]{helvet}
+
+% Filesystem paths
+\newcommand{\filepath}[1]{\textit{\texttt{\small #1}}}
+
+% Size-constrained images
+\newcommand{\image}[1]{\begin{center}\includegraphics[width=\maxwidth{0.95\textwidth}]{#1}\end{center}}
+\newcommand{\imagebox}[1]{\begin{center}\fbox{\includegraphics[width=\maxwidth{0.95\textwidth}]{#1}}\end{center}}
+
+\newenvironment{framed_shaded}{%
+  \def\FrameCommand##1{\hskip\@totalleftmargin
+  \fcolorbox{boxcolor}{shadecolor}{##1}%
+      % There is no \@totalrightmargin, so:
+      \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth}%
+  \MakeFramed {\advance\hsize-\width
+    \@totalleftmargin\z@ \linewidth\hsize
+    \advance\labelsep\fboxsep
+    \@setminipage\vspace{0.3em}}%
+ }{\vspace{-0.6em}\par\unskip\@minipagefalse\endMakeFramed}
+
+\newenvironment{full_framed_shaded}{%
+  \def\FrameCommand{\fboxsep=\FrameSep\fcolorbox{boxcolor}{shadecolor}}%
+  \MakeFramed {\advance\hsize\width \FrameRestore}}%
+ {\endMakeFramed}
+
+\newenvironment{container}{%
+  \def\FrameCommand##1{\hskip\@totalleftmargin \hskip-\fboxsep
+  \colorbox{white}{##1}\hskip-\fboxsep
+      % There is no \@totalrightmargin, so:
+      \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth}%
+  \MakeFramed {\advance\hsize-\width
+    \@totalleftmargin\z@ \linewidth\hsize
+    \@setminipage}%
+ }{\par\unskip\@minipagefalse\endMakeFramed}
+
+% Caption styling
+\usepackage[font={it,small}]{caption}
+
+% Codelistings
+\newcounter{codelisting}
+\numberwithin{codelisting}{chapter}
+\newenvironment{codelisting}{\refstepcounter{codelisting}\begin{framed_shaded}\vspace{-0.5em}}%
+{\end{framed_shaded}}
+% See latex_styles/language_customization.sty for codelisting captions.
+
+% Aside boxes
+\usepackage{amsthm}
+\theoremstyle{definition}
+\newcommand{\boxlabel}{Box}
+\newtheorem{aside}{\boxlabel}[chapter]
+\usepackage{latex_styles/framed}
+\definecolor{shadecolor}{gray}{0.97}
+\definecolor{boxcolor}{gray}{0.10}
+\newenvironment{shaded_aside}[2]{\begin{full_framed_shaded}\begin{aside}\label{#2} \textbf{#1}\end{aside}}{\bigskip\end{full_framed_shaded}}
+
+% Additional commands
+\newcommand{\heading}[1]{\textbf{#1}}
+\newcommand{\kodesize}{\smaller[0.75]}
+\newcommand{\kode}[1]{\textcolor{darkgreen}{\textbf{\texttt{\kodesize #1}}}}
+\newcommand{\coloredtext}[2]{\textcolor{#1}{#2}}
+\newcommand{\coloredtexthtml}[2]{\textcolor[HTML]{#1}{#2}}
+
+% Subtitle command
+\usepackage{titling}
+\newcommand{\subtitle}[1]{%
+  \posttitle{%
+    \par\end{center}
+    \begin{center}\large#1\end{center}
+    \vskip0.5em}%
+}
+
+% Enable the \pbox command for paragraph boxes in tables.
+\usepackage{pbox}
+
+% Define some commonly used Unicode characters.
+\usepackage{newunicodechar}
+\newunicodechar{—}{---}
+\newunicodechar{–}{--}
+
+\usepackage{latex_styles/language_customization}
+
+% Fix quotes in code environments.
+% Provides "upquote.sty" functionality compatible with the latest Pygments.
+\RequirePackage{textcomp}
+\begingroup
+\catcode`'=\active
+\catcode``=\active
+\g@addto@macro\@noligs
+   {\let`\textasciigrave
+    \let'\textquotesingle
+    \let\PYZsq\textquotesingle}
+\endgroup
+
+% Include custom commands.
+\usepackage{latex_styles/custom}
+\usepackage{latex_styles/custom_pdf}

data/lib/softcover/uploader.rb

@@ -0,0 +1,90 @@
+module Softcover
+  class Uploader
+    include Softcover::Utils
+
+    # Takes response from S3 upload signature generation API endpoint.
+    def initialize(res)
+      @params = res['upload_params']
+      @bucket = res['bucket']
+      @access_key = res['access_key']
+    end
+
+    def after_each(&blk)
+      @after_each_blk = blk
+    end
+
+    def upload!(options={})
+      unless @params.empty?
+        bar = ProgressBar.create title:     "Starting Upload...",
+                                 format:    "%t |%B| %P%% %e",
+                                 total:     total_size,
+                                 smoothing: 0.75,
+                                 output:    Softcover::Output.stream
+
+        upload_host = "http://#{@bucket}.s3.amazonaws.com"
+
+        @params.each do |params|
+          path = params['path']
+
+          size = File.size? path
+
+          c = Curl::Easy.new "http://#{@bucket}.s3.amazonaws.com"
+
+          c.multipart_form_post = true
+
+          last_chunk = 0
+          c.on_progress do |_, _, ul_total, ul_now|
+            uploaded = ul_now > size ? size : ul_now
+            x = as_size(uploaded)
+            y = as_size(size)
+            x = y if x > y
+            begin
+              bar.send(:title=, "#{path} (#{x} / #{y})")
+              bar.progress += ul_now - last_chunk
+              bar.refresh
+            rescue
+              nil
+            end
+            last_chunk = ul_now
+            true
+          end
+
+          c.http_post(
+            Curl::PostField.content('key', params['key']),
+            Curl::PostField.content('acl', params['acl']),
+            Curl::PostField.content('Signature', params['signature']),
+            Curl::PostField.content('Policy', params['policy']),
+            Curl::PostField.content('Content-Type', params['content_type']),
+            Curl::PostField.content('AWSAccessKeyId', @access_key),
+            Curl::PostField.file('file', path)
+          )
+
+          if c.body_str =~ /Error/
+            puts c.body_str
+            break
+          end
+
+          if @after_each_blk
+            @after_each_blk.call params
+          end
+        end
+
+        bar.finish
+      else
+        puts "Nothing to upload." unless options[:silent]
+      end
+      @params.size > 0
+    end
+
+    def total_size
+      @params.inject(0) do |sum, p|
+        sum += File.size?(p['path']) || 0
+      end
+    end
+
+    def file_count
+      @params.size
+    end
+
+  end
+end

data/lib/softcover/utils.rb

@@ -0,0 +1,284 @@
+module Softcover::Utils
+  extend self
+
+  def current_book
+    # using module level variable because it should be context independent
+    @@current_book ||= begin
+      in_book_directory? ? Softcover::Book.new(origin: source) : false
+    end
+  end
+
+  # Returns the source type (PolyTeX or Markdown) of the current book.
+  def source
+    Dir.glob(path('chapters/*.md')).empty? ? :polytex : :markdown
+  end
+
+  # Returns the slug to be unpublished.
+  def unpublish_slug
+    Softcover::BookManifest.new(origin: source).slug
+  end
+
+  def reset_current_book!
+    @@current_book = nil
+  end
+
+  def in_book_directory?
+    Softcover::BookManifest::find_book_root!
+
+    files = Dir['**/*']
+
+    Softcover::FORMATS.each do |format|
+      unless files.any?{ |file| File.extname(file) == ".#{format}" }
+        puts "No #{format} found, skipping."
+      end
+    end
+
+    return Softcover::BookManifest::valid_directory?
+  end
+
+  def logged_in?
+    require 'softcover/config'
+    Softcover::Config['api_key'].present?
+  end
+
+  UNITS = %W(B KB MB GB TB).freeze
+
+  def as_size(number)
+    if number.to_i < 1024
+      exponent = 0
+
+    else
+      max_exp  = UNITS.size - 1
+
+      exponent = ( Math.log( number ) / Math.log( 1024 ) ).to_i
+      exponent = max_exp if exponent > max_exp
+
+      number  /= 1024 ** exponent
+    end
+
+    "#{number.round} #{UNITS[ exponent ]}"
+  end
+
+
+  # Writes the master LaTeX file <name>.tex to use chapters from Book.txt.
+  # We skip this step if Book.txt doesn't exist, as that means the user
+  # is writing raw LaTeX.
+  def write_master_latex_file(manifest)
+    if File.exist?(manifest.book_file)
+      File.write(master_filename(manifest), master_content(manifest))
+    end
+  end
+
+  # Returns the name of the master LaTeX file.
+  def master_filename(manifest)
+    "#{manifest.filename}.tex"
+  end
+
+  # Returns the lines of book file as an array, removing commented-out lines.
+  def book_file_lines(manifest)
+    non_comment_lines(raw_lines(manifest))
+  end
+
+  # Returns only non-comment lines.
+  def non_comment_lines(lines)
+    comment = /^\s*#.*$/
+    lines.reject { |line| line.match(comment) }
+  end
+
+  # Returns all the lines in Book.txt.
+  def raw_lines(manifest)
+    File.readlines(manifest.book_file)
+  end
+
+  # Returns the content for the master LaTeX file.
+  def master_content(manifest)
+    front_or_mainmatter = /(.*):\s*$/
+    source_file = /(.*)(?:\.md|\.tex)\s*$/
+
+    tex_file = [master_latex_header(manifest)]
+    book_file_lines(manifest).each do |line|
+      if line.match(source_file)
+        tex_file << "\\include{#{manifest.polytex_dir}/#{$1}}"
+      elsif line.match(front_or_mainmatter)  # frontmatter or mainmatter
+        tex_file << "\\#{$1}"
+      elsif line.strip == 'cover'
+        tex_file << '\\includepdf{images/cover.pdf}'
+      else # raw command, like 'maketitle' or 'tableofcontents'
+        tex_file << "\\#{line.strip}"
+      end
+    end
+    tex_file << '\end{document}'
+    tex_file.join("\n") + "\n"
+  end
+
+  def master_latex_header(manifest)
+    preamble = File.read(path('config/preamble.tex'))
+    subtitle = manifest.subtitle.nil? ? "" : "\\subtitle{#{manifest.subtitle}}"
+    <<-EOS
+#{preamble}
+\\usepackage{#{Softcover::Directories::STYLES}/softcover}
+\\VerbatimFootnotes % Allows verbatim text in footnotes
+\\title{#{manifest.title}}
+#{subtitle}
+\\author{#{manifest.author}}
+\\date{#{manifest.date}}
+
+\\begin{document}
+    EOS
+  end
+
+  # Returns the tmp version of a filename.
+  # E.g., tmpify('foo.tex') => 'foo.tmp.tex'
+  def tmpify(manifest, filename)
+    tmp = Softcover::Directories::TMP
+    mkdir tmp
+    sep = File::SEPARATOR
+    filename.sub(manifest.polytex_dir + sep, tmp + sep).
+             sub('.tex', '.tmp.tex')
+  end
+
+  # Writes a Pygments style file.
+  # We support both :html (outputting CSS) and :latex (outputting
+  # a LaTeX style file).
+  def write_pygments_file(format, path)
+    require 'pygments'
+    extension = case format
+                when :html
+                  'css'
+                when :latex
+                  'sty'
+                end
+    # Here we burrow into the private 'Pygments#mentos' method.
+    # Pygments exposes a 'css' method to return the CSS,
+    # but we want to be able to output a LaTeX style file as well.
+    # The inclusion of the ':css' symbol is necessary but doesn't actually
+    # result in CSS being output unless the format is 'html'.
+    pygments = Pygments.send(:mentos, :css, [format.to_s, ''])
+    add_highlight_class!(pygments) if format == :html
+    File.open(File.join(path, "pygments.#{extension}"), 'w') do |f|
+      f.write(pygments)
+    end
+  end
+
+  # Adds a 'highlight' class for MathJax compatibility.
+  def add_highlight_class!(pygments_css)
+    pygments_css.gsub!(/^/, '.highlight ')
+  end
+
+  # Returns a digest of the string.
+  def digest(string)
+    Digest::SHA1.hexdigest(string)
+  end
+
+  # Returns the executable if it exists, raising an error otherwise.
+  def executable(filename)
+    filename.tap do |f|
+      unless File.exist?(f)
+        $stderr.puts "Document not built due to missing dependency"
+        $stderr.puts "Run `softcover check` to check dependencies"
+        exit 1
+      end
+    end
+  end
+
+  def mkdir(dir)
+    Dir.mkdir(dir) unless File.directory?(dir)
+  end
+
+  # Removes a file (or list of files).
+  def rm(file)
+    if file.is_a?(Array)
+      file.each { |f| rm(f) }
+    else
+      FileUtils.rm(file) if File.exist?(file)
+    end
+  end
+
+  # Returns the system-independent file path.
+  # It's nicer to write `path('foo/bar/baz')` than
+  # `File.join('foo', 'bar', 'baz')`.
+  def path(path_string='')
+    File.join(*path_string.split('/'))
+  end
+
+  # Execute a command.
+  # The issue here is that `exec` is awful in tests, since it exits the process.
+  # This command arranges to use `system` in tests instead.
+  def execute(command)
+    Softcover.test? ? system(command) : exec(command)
+  end
+
+  def silence
+    return yield if ENV['silence'] == 'false'
+
+    silence_stream(STDOUT) do
+      yield
+    end
+  end
+
+  # Returns true if platform is OS X.
+  def os_x?
+    RUBY_PLATFORM.match(/darwin/)
+  end
+
+  # Returns true if platform is Linux.
+  def linux?
+    RUBY_PLATFORM.match(/linux/)
+  end
+
+  # Returns the commands from the given lines.
+  # We skip comments and blank lines.
+  def commands(lines)
+    skip = /(^\s*#|^\s*$)/
+    lines.reject { |line| line =~ skip }.join("\n")
+  end
+
+  # Returns the filename of a dependency given a label.
+  def dependency_filename(label)
+    case label
+    when :latex
+      `which xelatex`.chomp
+    when :ghostscript
+      `which gs`.chomp
+    when :convert
+      `which convert`.chomp
+    when :node
+      `which node`.chomp
+    when :phantomjs
+      `which phantomjs`.chomp
+    when :kindlegen
+      `which kindlegen`.chomp
+    when :java
+      `which java`.chomp
+    when :zip
+      `which zip`.chomp
+    when :calibre
+      `which ebook-convert`.chomp
+    when :epubcheck
+      File.join(Dir.home, 'bin', 'epubcheck-3.0', 'epubcheck-3.0.jar')
+    when :inkscape
+      filename = `which inkscape`.chomp
+      if filename.empty?
+        filename = '/Applications/Inkscape.app/Contents/Resources/bin/' +
+                   'inkscape'
+      end
+      filename
+    else
+      raise "Unknown label #{label}"
+    end
+  end
+
+  # Returns the language labels from the config file.
+  def language_labels
+    YAML.load_file(File.join(Softcover::Directories::CONFIG, 'lang.yml'))
+  end
+
+  def chapter_label(chapter_number)
+    if language_labels["chapter"]["order"] == "reverse"
+      "#{chapter_number} #{language_labels['chapter']['word']}"
+    else
+      "#{language_labels['chapter']['word']} #{chapter_number}"
+    end
+  end
+
+end

data/lib/softcover/version.rb

@@ -0,0 +1,3 @@
+module Softcover
+  VERSION = "1.0.beta2"
+end

data/lib/softcover.rb

@@ -0,0 +1,68 @@
+require 'polytexnic'
+require 'active_support/core_ext/string'
+
+@profiling = false
+
+require_relative 'softcover/formats'
+require_relative 'softcover/utils'
+require_relative 'softcover/output'
+require_relative 'softcover/directories'
+
+if @profiling
+  times = []
+  Dir[File.join(File.dirname(__FILE__), '/softcover/**/*.rb')].each do |file|
+    t1 = Time.now
+    next if file =~ /railtie/ && !defined?(Rails)
+    require file.chomp(File.extname(file))
+    times << "#{Time.now - t1} #{File.basename(file)}"
+  end
+  $stderr.puts times.sort.reverse
+end
+
+require_relative 'softcover/book'
+require_relative 'softcover/book_manifest'
+require_relative 'softcover/builder'
+require_relative 'softcover/builders/epub'
+require_relative 'softcover/builders/html'
+require_relative 'softcover/builders/mobi'
+require_relative 'softcover/builders/pdf'
+require_relative 'softcover/builders/preview'
+require_relative 'softcover/cli'
+require_relative 'softcover/commands/auth'
+require_relative 'softcover/commands/build'
+require_relative 'softcover/commands/check'
+require_relative 'softcover/commands/deployment'
+require_relative 'softcover/commands/epub_validator'
+require_relative 'softcover/commands/generator'
+require_relative 'softcover/commands/opener'
+require_relative 'softcover/commands/server'
+require_relative 'softcover/mathjax'
+require_relative 'softcover/uploader'
+require_relative 'softcover/version'
+
+module Softcover
+  extend self
+
+  include Softcover::Utils
+
+  # Return the custom styles, if any.
+  def custom_styles
+    custom_file = File.join(Softcover::Directories::STYLES, 'custom.sty')
+    File.exist?(custom_file) ? File.read(custom_file) : ''
+  end
+
+  def set_test_mode!
+    @test_mode = true
+  end
+
+  def test?
+    @test_mode
+  end
+
+  def profiling?
+    return false if test?
+    @profiling
+  end
+end
+
+require 'softcover/rails/railtie' if defined?(Rails)

data/softcover.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'softcover/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "softcover-nonstop"
+  gem.version       = Softcover::VERSION
+  gem.authors       = ["Michael Hartl", "Nick Merwin", "Frank Ittermann"]
+  gem.email         = ["pussinboots666@googlemail.com"]
+  gem.description   = %q{CLI interface for softcover.io}
+  gem.summary       = %q{A typesetting system for technical authors}
+  gem.homepage      = "http://github.com/pussinboots/softcover"
+  gem.license       = "MIT"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency 'polytexnic', '~> 1.0.beta2'
+  gem.add_dependency 'msgpack', '~> 0.4.2'
+  gem.add_dependency 'nokogiri', '~> 1.6.0'
+  gem.add_dependency 'thor', '~> 0.18.1'
+  gem.add_dependency 'activesupport', '~> 3.2.16'
+  gem.add_dependency 'rest-client', '~> 1.6.7'
+  gem.add_dependency 'curb', '~> 0.8.5'
+  gem.add_dependency 'ruby-progressbar', '~> 1.4.2'
+  gem.add_dependency 'maruku', '~> 0.7.1'
+  gem.add_dependency 'pygments.rb', '~> 0.4.2'
+  gem.add_dependency 'kramdown', '~> 1.3.2'
+
+  gem.add_dependency 'sinatra', '~> 1.4.4'
+  gem.add_dependency 'thin', '~> 1.6.1'
+  gem.add_dependency 'async_sinatra', '~> 1.1.0'
+  gem.add_dependency 'sinatra-respond_to', '~> 0.9.0'
+  gem.add_dependency 'coffee-script', '~> 2.2.0'
+  gem.add_dependency 'listen', '~> 1.3.1'
+  gem.add_dependency 'rb-fsevent', '~> 0.9.3'
+  gem.add_dependency 'sanitize', '~> 2.0.6'
+end