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 def html_extension 'html' 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 .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::Popen.new.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 # Removes a directory recursively. def rm_r(directory) FileUtils.rm_r(directory) if File.directory?(directory) 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 first location on the path for a given file. def first_path(file) possible_paths = ENV['PATH'].split(File::PATH_SEPARATOR). collect { |x| File.join(x, file) } possible_paths.find { |f| File.file?(f) } end # Returns the filename of a dependency given a label. def dependency_filename(label) case label when :latex get_filename(:xelatex) when :ghostscript get_filename(:gs) when :calibre get_filename(:'ebook-convert') when :epubcheck # Finds EpubCheck anywhere on the path. version_4 = path('epubcheck-4.2.2/epubcheck.jar') first_path(version_4) || get_filename(:'epubcheck') || "" when :inkscape default = '/Applications/Inkscape.app/Contents/MacOS/inkscape' filename_or_default(:inkscape, default) when :phantomjs phantomjs = get_filename(label) # Test for version 2, which is now necessary. version = `#{phantomjs} -v`.scan(/^(\d)\./).flatten.first.to_i rescue nil if version == 2 phantomjs else "" end when :python3 python = get_filename(:python3) `#{python} --version`.match(/Python 3\.*/) ? python : "" else get_filename(label) end end def get_filename(name) `which #{name}`.chomp end # Returns the filename if it exists on the path and a default otherwise. def filename_or_default(name, default) (f = get_filename(name)).empty? ? default : f 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 # Returns the directory of the document template. def template_dir(options) doc = options[:article] ? 'article' : 'book' File.expand_path File.join(File.dirname(__FILE__), "#{doc}_template") end # Returns true if document is an article. def article? !!File.readlines(path('config/preamble.tex')).first.match(/extarticle/) end # Silences a stream. # This is taken directly from Rails Active Support `silence_stream`. # The `silence_stream` method is deprecated because it's not thread-safe, but # we don't care about that and the deprecation warnings are annoying. def silence_stream(stream) old_stream = stream.dup stream.reopen(RbConfig::CONFIG['host_os'] =~ /mswin|mingw/ ? 'NUL:' : '/dev/null') stream.sync = true yield ensure stream.reopen(old_stream) old_stream.close end # Run text through the Polytexnic pipeline to make an HTML snippet. def polytexnic_html(text) Nokogiri::HTML(Polytexnic::Pipeline.new(text).to_html).at_css('p') .inner_html.strip end end