ronn-ng 0.7.4

data/lib/ronn/server.rb

@@ -0,0 +1,70 @@
+require 'ronn'
+require 'rack'
+require 'sinatra/base'
+
+module Ronn
+
+  # Ronn HTTP server. Serves a list of .ronn files as HTML. The options Hash is
+  # passed to Ronn::Document.new on each invocation.
+  #
+  # Use Ronn::Server.new to create a Rack app. See the config.ru file in the
+  # root of the Ronn distribution for example usage.
+  #
+  # Ronn::Server.run starts a server on port 
+  module Server
+    def self.new(files, options={})
+      files = Dir[files] if files.respond_to?(:to_str)
+      raise ArgumentError, "no files" if files.empty?
+      Sinatra.new do
+        set :show_exceptions, true
+        set :public, File.expand_path(__FILE__, '../templates')
+        set :static, false
+        set :views, File.expand_path(__FILE__, '../templates')
+
+        get '/' do
+          files.map do |f|
+            base = File.basename(f, '.ronn')
+            "<li><a href='./#{base}.html'>#{escape_html(base)}</a></li>"
+          end
+        end
+
+        def styles
+          params[:styles] ||= params[:style]
+          case
+          when params[:styles].respond_to?(:to_ary)
+            params[:styles]
+          when params[:styles]
+            params[:styles].split(/[, ]+/)
+          else
+            []
+          end
+        end
+
+        files.each do |file|
+          basename = File.basename(file, '.ronn')
+
+          get "/#{basename}.html" do
+            options = options.merge(:styles => styles)
+            %w[date manual organization].each do |attribute|
+              next if !params[attribute]
+              options[attribute] = params[attribute]
+            end
+            Ronn::Document.new(file, options).to_html
+          end
+          get "/#{basename}.roff" do
+            content_type 'text/plain+roff'
+            Ronn::Document.new(file, options.dup).to_roff
+          end
+        end
+      end
+    end
+
+    def self.run(files, options={})
+      new(files, options).run!(
+        :server  => %w[mongrel thin webrick],
+        :port    => 1207,
+        :logging => true
+      )
+    end
+  end
+end

data/lib/ronn/template.rb

@@ -0,0 +1,171 @@
+require 'mustache'
+
+module Ronn
+  class Template < Mustache
+    self.template_path = File.dirname(__FILE__) + '/template'
+    self.template_extension = 'html'
+
+    def initialize(document, style_path=ENV['RONN_STYLE'].to_s.split(':'))
+      @document = document
+      @style_path = style_path + [Template.template_path]
+    end
+
+    def render(template='default')
+      super template[0,1] == '/' ? File.read(template) : partial(template)
+    end
+
+    ##
+    # Basic document attributes
+
+    def name
+      @document.name
+    end
+
+    def section
+      @document.section
+    end
+
+    def tagline
+      @document.tagline
+    end
+    alias tagline? tagline
+
+    def name_and_section?
+      name && section
+    end
+
+    def title
+      if !name_and_section? && tagline
+        tagline
+      else
+        [page_name, tagline].compact.join(' - ')
+      end
+    end
+
+    def custom_title?
+      !name_and_section? && tagline
+    end
+
+    def page_name
+      if section
+        "#{name}(#{section})"
+      else
+        name
+      end
+    end
+
+    def generator
+      "Ronn-NG/v#{Ronn.version} (http://github.com/apjanke/ronn-ng/tree/#{Ronn.revision})"
+    end
+
+    def manual
+      @document.manual
+    end
+
+    def organization
+      @document.organization
+    end
+
+    def date
+      @document.date.strftime('%B %Y')
+    end
+
+    def wrap_class_name
+      'mp'
+    end
+
+    ##
+    # Section TOCs
+
+    def section_heads
+      @document.section_heads.map do |id, text|
+        {
+          :id   => id,
+          :text => text
+        }
+      end
+    end
+
+    ##
+    # Styles
+
+    # Array of style module names as given on the command line.
+    def styles
+      @document.styles
+    end
+
+    # Array of stylesheet info hashes.
+    def stylesheets
+      styles.zip(style_files).map do |name, path|
+        base = File.basename(path, '.css')
+        fail "style not found: #{style.inspect}" if path.nil?
+        {
+          :name  => name,
+          :path  => path,
+          :base  => File.basename(path, '.css'),
+          :media => (base =~ /(print|screen)$/) ? $1 : 'all'
+        }
+      end
+    end
+
+    # All embedded stylesheets.
+    def stylesheet_tags
+      stylesheets.
+        map { |style| inline_stylesheet(style[:path], style[:media]) }.
+        join("\n  ")
+    end
+
+    attr_accessor :style_path
+
+    # Array of expanded stylesheet file names. If a file cannot be found, the
+    # resulting array will include nil elements in positions corresponding to
+    # the stylesheets array.
+    def style_files
+      styles.map do |name|
+        next name if name.include?('/')
+        style_path.
+          reject  { |p| p.strip.empty? }.
+          map     { |p| File.join(p, "#{name}.css") }.
+          detect  { |file| File.exist?(file) }
+      end
+    end
+
+    # Array of style names for which no file could be found.
+    def missing_styles
+      style_files.
+        zip(files).
+        select { |style, file| file.nil? }.
+        map    { |style, file| style }
+    end
+
+    ##
+    # TEMPLATE CSS LOADING
+
+    def inline_stylesheet(path, media='all')
+      data = File.read(path)
+      data.gsub!(%r|/\*.+?\*/|m, '')   # comments
+      data.gsub!(/([;{,]) *\n/m, '\1') # end-of-line whitespace
+      data.gsub!(/\n{2,}/m, "\n")      # collapse lines
+      data.gsub!(/[; ]+\}/, '}')       # superfluous trailing semi-colons
+      data.gsub!(/([{;,+])[ ]+/, '\1') # whitespace around things
+      data.gsub!(/[ \t]+/m, ' ')       # coalescing whitespace elsewhere
+      data.gsub!(/^/, '  ')            # indent
+      data.strip!
+      [
+        "<style type='text/css' media='#{media}'>",
+        "/* style: #{File.basename(path, '.css')} */",
+        data,
+        "</style>"
+      ].join("\n  ")
+    end
+
+    def remote_stylesheet(name, media='all')
+      path = File.expand_path("../template/#{name}.css", __FILE__)
+      "<link rel='stylesheet' type='text/css' media='#{media}' href='#{path}'>"
+    end
+
+    def stylesheet(path, media='all')
+      inline_stylesheet(name, media)
+    end
+  end
+end

data/lib/ronn/template/80c.css

@@ -0,0 +1,6 @@
+/* 80c.css - condense width to emulate a classical 80 character terminal */
+
+.mp                       { max-width:86ex }
+
+ /* .mp width + padding */
+.man-navigation           { left:101ex }

data/lib/ronn/template/dark.css

@@ -0,0 +1,18 @@
+.mp, body#manpage {
+  background:#080706;
+  color:#888;
+}
+.mp, .mp code, .mp pre,
+.mp pre code, .mp tt, .mp kbd,
+.mp samp                            { color:#aaa }
+.mp h1, .mp h2, .mp h3, .mp h4      { color:#fff }
+.man-decor, .man-decor ol li        { color:#666 }
+.mp code, .mp strong, .mp b         { color:#fff }
+
+.mp em, .mp var, .mp u              { color:#ddd }
+
+.mp pre code                        { color:#ddd }
+
+.mp a, .mp a:link, .mp a:hover,
+.mp a code, .mp a pre, .mp a tt,
+.mp a kbd, .mp a samp              { color:#fff }

data/lib/ronn/template/darktoc.css

@@ -0,0 +1,17 @@
+/* darktoc.css - enable table of contents */
+
+.man-navigation {
+    border-left:2px solid #222;
+    background-color:#131211;
+}
+.man-navigation a,
+.man-navigation a:hover,
+.man-navigation a:link,
+.man-navigation a:visited {
+    color:#777;
+    text-decoration:none;
+}
+.man-navigation a:hover {
+    color:#fff;
+    text-decoration:underline;
+}

data/lib/ronn/template/default.html

@@ -0,0 +1,41 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv='content-type' content='text/html;charset=utf8'>
+  <meta name='generator' content='{{ generator }}'>
+  <title>{{ title }}</title>
+  {{{ stylesheet_tags }}}
+</head>
+<!--
+  The following styles are deprecated and will be removed at some point:
+  div#man, div#man ol.man, div#man ol.head, div#man ol.man.
+
+  The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
+  .man-navigation should be used instead.
+-->
+<body id='manpage'>
+  <div class='mp' id='man'>
+
+  <div class='man-navigation' style='display:none'>
+    {{#section_heads}}
+    <a href="#{{id}}">{{text}}</a>
+    {{/section_heads}}
+  </div>
+
+  <ol class='man-decor man-head man head'>
+    <li class='tl'>{{ page_name }}</li>
+    <li class='tc'>{{ manual }}</li>
+    <li class='tr'>{{ page_name }}</li>
+  </ol>
+
+  {{{ html }}}
+
+  <ol class='man-decor man-foot man foot'>
+    <li class='tl'>{{ organization }}</li>
+    <li class='tc'>{{ date }}</li>
+    <li class='tr'>{{ page_name }}</li>
+  </ol>
+
+  </div>
+</body>
+</html>

data/lib/ronn/template/man.css

@@ -0,0 +1,100 @@
+/* man.css - core manpage styles */
+
+/* STRUCTURE, INDENT, MARGINS */
+
+body#manpage                        { margin:0 }
+.mp {
+    max-width:100ex;
+    padding:0 9ex 1ex 4ex;
+}
+
+.mp p,  .mp pre,
+.mp ul, .mp ol, .mp dl              { margin:0 0 20px 0 }
+.mp h2                              { margin:10px 0 0 0 }
+
+.mp > p, .mp > pre, .mp > ul,
+.mp > ol, .mp > dl                  { margin-left:8ex }
+.mp h3                              { margin:0 0 0 4ex }
+
+.mp dt                              { margin:0; clear:left }
+.mp dt.flush                        { float:left; width:8ex }
+.mp dd                              { margin:0 0 0 9ex }
+.mp h1, .mp h2, .mp h3, .mp h4      { clear:left }
+
+.mp pre                             { margin-bottom:20px }
+.mp pre+h2, .mp pre+h3              { margin-top:22px }
+.mp h2+pre, .mp h3+pre              { margin-top:5px }
+
+.mp img                             { display:block;margin:auto }
+.mp h1.man-title                    { display:none }
+
+/* FONTS */
+
+.mp, .mp code, .mp pre, .mp tt,
+.mp kbd, .mp samp, .mp h3, .mp h4 {
+    font-family:monospace;
+    font-size:14px;
+    line-height:1.42857142857143;
+}
+.mp h2 {
+  font-size:16px;
+  line-height:1.25;
+}
+.mp h1 {
+  font-size:20px;
+  line-height:2;
+}
+
+/* TEXT STYLES */
+
+.mp {
+  text-align:justify;
+  background:#fff;
+}
+.mp, .mp code, .mp pre,
+.mp pre code, .mp tt, .mp kbd,
+.mp samp                            { color:#131211 }
+.mp h1, .mp h2, .mp h3, .mp h4      { color:#030201 }
+.mp u                               { text-decoration:underline; }
+
+.mp code, .mp strong, .mp b {
+    font-weight:bold;
+    color:#131211;
+}
+
+.mp em, .mp var {
+    font-style:italic;
+    color:#232221;
+    text-decoration:none;
+}
+
+/* LINKS */
+
+.mp a, .mp a:link, .mp a:hover,
+.mp a code, .mp a pre, .mp a tt,
+.mp a kbd, .mp a samp              { color:#0000ff }
+
+.mp b.man-ref                      { font-weight:normal;color:#434241 }
+
+/* PREFORMATTED BLOCKS */
+
+.mp pre                            { padding:0 4ex }
+.mp pre code                       { font-weight:normal;color:#434241 }
+.mp h2+pre, h3+pre                 { padding-left:0 }
+
+/* DOCUMENT HEADER AND FOOTER AREAS */
+
+ol.man-decor, ol.man-decor li {
+    margin:3px 0 10px 0;
+    padding:0;
+    float:left;
+    width:33%;
+    list-style-type:none;
+    text-transform:uppercase;
+    color:#999;
+    letter-spacing:1px;
+}
+ol.man-decor                  { width:100% }
+ol.man-decor li.tl            { text-align:left }
+ol.man-decor li.tc            { text-align:center; letter-spacing:4px }
+ol.man-decor li.tr            { text-align:right; float:right }

data/lib/ronn/template/print.css

@@ -0,0 +1,5 @@
+.mp { max-width:none }
+.man-navigation { display:none !important }
+.mp a[href]:not([href^="#"]):not([data-bare-link]):after {
+  content:" " attr(href);
+}

data/lib/ronn/template/screen.css

@@ -0,0 +1,105 @@
+/* STRUCTURE, INDENT, MARGINS */
+
+body                                { margin:0 }
+#man                                { max-width:88ex; padding:0 2ex 1ex 2ex }
+
+#man p, #man pre,
+#man ul, #man ol, #man dl           { margin:0 0 20px 0 }
+#man h2                             { margin:10px 0 0 0 }
+
+#man > p, #man > pre,
+#man > ul, #man > ol, #man > dl     { margin-left:8ex }
+#man h3                             { margin:0 0 0 4ex }
+
+#man dt                             { margin:0; clear:left }
+#man dt.flush                       { float:left; width:8ex }
+#man dd                             { margin:0 0 0 9ex }
+#man h1, #man h2, #man h3, #man h4  { clear:left }
+
+#man pre                            { margin-bottom:20px }
+#man pre+h2, #man pre+h3            { margin-top:22px }
+#man h2+pre, #man h3+pre            { margin-top:5px }
+
+#man img                            { display:block;margin:auto }
+#man h1.man-title                   { display:none }
+
+/* FONTS */
+
+#man, #man code, #man pre,
+#man tt, #man kbd, #man samp,
+#man h3, #man h4 {
+    font-family:monospace;
+    font-size:14px;
+    line-height:1.42857142857143;
+}
+#man h2, #man ol.man {
+  font-size:16px;
+  line-height:1.25
+}
+#man h1 {
+  font-size:20px;
+  line-height:2;
+}
+
+/* TEXT STYLES */
+
+#man {
+  text-align:justify;
+  background:#fff;
+}
+#man, #man code, #man pre, #man pre code,
+#man tt, #man kbd, #man samp            { color:#131211 }
+#man h1, #man h2, #man h3, #man h4      { color:#030201 }
+#man ol.man, #man ol.man li             { color:#636261 }
+
+#man code, #man strong, #man b {
+    font-weight:bold;
+    color:#131211;
+}
+
+#man em, #man var, #man u {
+    font-style:italic;
+    color:#434241;
+    text-decoration:none;
+}
+
+#man pre {
+    background:#edeceb;
+    padding:5px 1ex;
+    border-left:1ex solid #ddd;
+}
+#man pre code {
+    font-weight:normal;
+    background:inherit;
+}
+
+/* DOCUMENT HEADER AND FOOTER AREAS */
+
+#man ol.man, #man ol.man li {
+    margin:3px 0 10px 0;
+    padding:0;
+    float:left;
+    width:33%;
+    list-style-type:none;
+    text-transform:uppercase;
+    color:#999;
+    letter-spacing:1px;
+}
+#man ol.man                  { width:100% }
+#man ol.man li.tl            { text-align:left }
+#man ol.man li.tc            { text-align:center; letter-spacing:4px }
+#man ol.man li.tr            { text-align:right; float:right }
+
+/* SECTION TOC NAVIGATION */
+
+#man div.man-navigation {
+    position:fixed;
+    top:0;
+    left:96ex;
+    height:100%;
+    width:100%;
+    padding:1ex 0 0 2ex;
+    border-left:0.25ex solid #DCDCDC;
+    background-color: #F5F5F5;
+}
+#man div.man-navigation a { display:block; margin-bottom:1.5ex }