deg-yard 0.8.7.1

data/lib/yard/server/router.rb

@@ -0,0 +1,176 @@
+module YARD
+  module Server
+    # A router class implements the logic used to recognize a request for a specific
+    # URL and run specific {Commands::Base commands}.
+    #
+    # == Subclassing Notes
+    # To create a custom router, subclass this class and pass it into the adapter
+    # options through {Adapter#initialize} or by directly modifying {Adapter#router}.
+    #
+    # The most general customization is to change the URL prefixes recognized by
+    # routing, which can be done by overriding {#docs_prefix}, {#list_prefix}
+    # and {#search_prefix}.
+    #
+    # == Implementing Custom Caching
+    # By default, the Router class performs static disk-based caching on all
+    # requests through the +#check_static_cache+. To override this behaviour,
+    # or create your own caching mechanism, mixin your own custom module with
+    # this method implemented as per {StaticCaching#check_static_cache}.
+    #
+    # @example Creating a subclassed router
+    #   # Adds 'my' to all routing prefixes
+    #   class MyRouter < YARD::Server::Router
+    #     def docs_prefix; 'mydocs' end
+    #     def list_prefix; 'mylist' end
+    #     def search_prefix; 'mysearch' end
+    #   end
+    #
+    #   # Using it:
+    #   WebrickAdapter.new(libraries, :router => MyRouter).start
+    class Router
+      include StaticCaching
+      include Commands
+
+      # @return [Adapter Dependent] the request data coming in with the routing
+      attr_accessor :request
+
+      # @return [Adapter] the adapter used by the router
+      attr_accessor :adapter
+
+      # Creates a new router for a specific adapter
+      #
+      # @param [Adapter] adapter the adapter to route requests to
+      def initialize(adapter)
+        self.adapter = adapter
+      end
+
+      # Perform routing on a specific request, serving the request as a static
+      # file through {Commands::StaticFileCommand} if no route is found.
+      #
+      # @param [Adapter Dependent] request the request object
+      # @return [Array(Numeric,Hash,Array)] the Rack-style server response data
+      def call(request)
+        self.request = request
+        if result = (check_static_cache || route)
+          result
+        else
+          StaticFileCommand.new(adapter.options).call(request)
+        end
+      end
+
+      # @group Route Prefixes
+
+      # @return [String] the URI prefix for all object documentation requests
+      def docs_prefix; 'docs' end
+
+      # @return [String] the URI prefix for all class/method/file list requests
+      def list_prefix; 'list' end
+
+      # @return [String] the URI prefix for all search requests
+      def search_prefix; 'search' end
+
+      # @group Routing Methods
+
+      # @return [Array(LibraryVersion, Array<String>)] the library followed
+      #   by the rest of the path components in the request path. LibraryVersion
+      #   will be nil if no matching library was found.
+      def parse_library_from_path(paths)
+        return [adapter.libraries.values.first.first, paths] if adapter.options[:single_library]
+        library, paths = nil, paths.dup
+        if libs = adapter.libraries[paths.first]
+          paths.shift
+          if library = libs.find {|l| l.version == paths.first }
+            request.version_supplied = true if request
+            paths.shift
+          else # use the last lib in the list
+            request.version_supplied = false if request
+            library = libs.last
+          end
+        end
+        [library, paths]
+      end
+
+      protected
+
+      # Performs routing algorithm to find which prefix is called, first
+      # parsing out library name/version information.
+      #
+      # @return [Array(Numeric,Hash,Array<String>)] the Rack-style response
+      # @return [nil] if no route is matched
+      def route(path = request.path)
+        path = path.gsub(%r{//+}, '/').gsub(%r{^/|/$}, '')
+        return route_index if path.empty? || path == docs_prefix
+        case path
+        when /^(#{docs_prefix}|#{list_prefix}|#{search_prefix})(\/.*|$)/
+          prefix = $1
+          paths = $2.gsub(%r{^/|/$}, '').split('/')
+          library, paths = *parse_library_from_path(paths)
+          return unless library
+          return case prefix
+          when docs_prefix;   route_docs(library, paths)
+          when list_prefix;   route_list(library, paths)
+          when search_prefix; route_search(library, paths)
+          end
+        end
+        nil
+      end
+
+      # Routes requests from {#docs_prefix} and calls the appropriate command
+      # @param [LibraryVersion] library the library to route for
+      # @param [Array<String>] paths path components (split by '/')
+      # @return (see #route)
+      def route_docs(library, paths)
+        return route_index if library.nil?
+        case paths.first
+        when "frames"
+          paths.shift
+          cmd = FramesCommand
+        when "file"
+          paths.shift
+          cmd = DisplayFileCommand
+        else
+          cmd = DisplayObjectCommand
+        end
+        cmd = cmd.new(final_options(library, paths))
+        cmd.call(request)
+      end
+
+      # Routes for the index of a library / multiple libraries
+      # @return (see #route)
+      def route_index
+        if adapter.options[:single_library]
+          route_docs(adapter.libraries.values.first.first, [])
+        else
+          LibraryIndexCommand.new(adapter.options.merge(:path => '')).call(request)
+        end
+      end
+
+      # Routes requests from {#list_prefix} and calls the appropriate command
+      # @param (see #route_docs)
+      # @return (see #route_docs)
+      def route_list(library, paths)
+        return if paths.empty?
+        ListCommand.new(final_options(library, paths)).call(request)
+      end
+
+      # Routes requests from {#search_prefix} and calls the appropriate command
+      # @param (see #route_docs)
+      # @return (see #route_docs)
+      def route_search(library, paths)
+        return unless paths.empty?
+        SearchCommand.new(final_options(library, paths)).call(request)
+      end
+
+      # @group Utility Methods
+
+      # Adds extra :library/:path option keys to the adapter options.
+      # Use this method when passing options to a command.
+      #
+      # @param (see #route_docs)
+      # @return [Hash] finalized options
+      def final_options(library, paths)
+        adapter.options.merge(:library => library, :path => paths.join('/'))
+      end
+    end
+  end
+end

data/lib/yard/server/static_caching.rb

@@ -0,0 +1,45 @@
+module YARD
+  module Server
+    # Implements static caching for requests.
+    #
+    # @see Router Router documentation for "Caching"
+    module StaticCaching
+      # Called by a router to return the cached object. By default, this
+      # method performs disk-based caching. To perform other forms of caching,
+      # implement your own +#check_static_cache+ method and mix the module into
+      # the Router class.
+      #
+      # Note that caching does not occur here. This method simply checks for
+      # the existence of cached data. To actually cache a response, see
+      # {Commands::Base#cache}.
+      #
+      # @example Implementing In-Memory Cache Checking
+      #   module MemoryCaching
+      #     def check_static_cache
+      #       # $memory_cache is filled by {Commands::Base#cache}
+      #       cached_data = $memory_cache[request.path]
+      #       if cached_data
+      #         [200, {'Content-Type' => 'text/html'}, [cached_data]]
+      #       else
+      #         nil
+      #       end
+      #     end
+      #   end
+      #
+      #   class YARD::Server::Router; include MemoryCaching; end
+      # @return [Array(Numeric,Hash,Array)] the Rack-style response
+      # @return [nil] if no cache is available and routing should continue
+      # @see Commands::Base#cache
+      def check_static_cache
+        return nil unless adapter.document_root
+        cache_path = File.join(adapter.document_root, request.path.sub(/\.html$/, '') + '.html')
+        cache_path = cache_path.sub(%r{/\.html$}, '.html')
+        if File.file?(cache_path)
+          log.debug "Loading cache from disk: #{cache_path}"
+          return [200, {'Content-Type' => 'text/html'}, [File.read_binary(cache_path)]]
+        end
+        nil
+      end
+    end
+  end
+end

data/lib/yard/server/templates/default/fulldoc/html/css/custom.css

@@ -0,0 +1,78 @@
+#search_results h1 { margin-bottom: 0; }
+#search_results p { margin-top: 0; margin-bottom: 25px; }
+#search_results ul { list-style-position: inside; padding-left: 0; list-style: none; }
+#search_results ul li { padding: 7px 15px; font-size: 1.1em; }
+
+#search_frame { z-index: 9999; }
+
+form.search {
+  position: relative;
+  color: #fff;
+  margin-top: 3px; padding: 7px; border: 1px solid #99f; width: 315px; background: #05a;
+  -moz-border-radius: 4px; -webkit-border-radius: 4px;
+  margin-bottom: 10px;
+}
+form.search input { margin-left: 5px; width: 250px; border: 1px solid #99f; -moz-border-radius: 3px; font-family: monospace; }
+
+#menu { padding-top: 5px; }
+#content h1 { margin-top: 0; border-top: 0; }
+
+#content.error { font-size: 1.2em; }
+#content.error p tt { font-size: 1.2em; }
+#content.error .note { padding: 12px; }
+
+.signature .permalink { float: right; font-size: 0.9em; }
+
+/* autocomplete */
+.ac_results {
+	padding: 0px;
+	border: 1px solid black;
+	width: 500px;
+	overflow: hidden;
+	z-index: 99999;
+}
+
+.ac_results ul {
+	width: 100%;
+	list-style-position: outside;
+	list-style: none;
+	padding: 0;
+	margin: 0;
+}
+
+.ac_results li {
+  cursor: pointer;
+	margin: 0px;
+	padding: 3px;
+	display: block;
+	font-family: sans-serif;
+	font-size: 12px;
+	line-height: 16px;
+	overflow: hidden;
+
+}
+
+.ac_loading {
+	background: white url('/images/processing.gif') right center no-repeat;
+}
+
+.ac_even {
+  background: #fafafa; border: 1px dotted #fafafa; border-left-width: 0; border-right-width: 0;
+}
+
+.ac_odd {
+	background: #f0f0f0; border: 1px dotted #f0f0f0; border-left-width: 0; border-right-width: 0;
+}
+
+.ac_over {
+  background: #ddd; cursor: pointer; border: 1px dotted #fff; border-left-width: 0; border-right-width: 0;
+}
+
+#fade { display: none; position: absolute; top: 0px; left: 0; background: #eee; z-index: -1; width: 100%; height: 100%; border-top: 1px solid #e0e0e0; }
+#processing {
+  position: absolute; width: 400px; height: 200px; margin: auto; background: #fff; padding: 10px 30px; z-index: 20;
+  -webkit-box-shadow: 0px 0px 20px #444; -moz-box-shadow: 0px 0px 20px #444;
+  -webkit-border-radius: 4px;
+  display: none;
+}
+#processing img { display: block; position: absolute; bottom: 30px; left: 44%; }

data/lib/yard/server/templates/default/fulldoc/html/js/autocomplete.js

@@ -0,0 +1,12 @@
+/*
+ * jQuery Autocomplete plugin 1.1
+ *
+ * Copyright (c) 2009 Jörn Zaefferer
+ *
+ * Dual licensed under the MIT and GPL licenses:
+ *   http://www.opensource.org/licenses/mit-license.php
+ *   http://www.gnu.org/licenses/gpl.html
+ *
+ * Revision: $Id: jquery.autocomplete.js 15 2009-08-22 10:30:27Z joern.zaefferer $
+ */
+eval(function(p,a,c,k,e,r){e=function(c){return(c<a?'':e(parseInt(c/a)))+((c=c%a)>35?String.fromCharCode(c+29):c.toString(36))};if(!''.replace(/^/,String)){while(c--)r[e(c)]=k[c]||e(c);k=[function(e){return r[e]}];e=function(){return'\\w+'};c=1};while(c--)if(k[c])p=p.replace(new RegExp('\\b'+e(c)+'\\b','g'),k[c]);return p}(';(3($){$.2e.1u({19:3(b,d){5 c=W b=="1B";d=$.1u({},$.M.1T,{Y:c?b:P,y:c?P:b,1J:c?$.M.1T.1J:10,X:d&&!d.1D?10:48},d);d.1y=d.1y||3(a){6 a};d.1v=d.1v||d.1R;6 A.I(3(){1M $.M(A,d)})},L:3(a){6 A.11("L",a)},1k:3(a){6 A.14("1k",[a])},2b:3(){6 A.14("2b")},28:3(a){6 A.14("28",[a])},24:3(){6 A.14("24")}});$.M=3(o,r){5 t={2Y:38,2S:40,2N:46,2I:9,2E:13,2B:27,2x:3I,2v:33,2p:34,2n:8};5 u=$(o).3r("19","3o").Q(r.2Q);5 p;5 m="";5 n=$.M.3c(r);5 s=0;5 k;5 h={1F:C};5 l=$.M.32(r,o,1Z,h);5 j;$.1Y.2X&&$(o.2U).11("45.19",3(){4(j){j=C;6 C}});u.11(($.1Y.2X?"43":"42")+".19",3(a){s=1;k=a.2M;3V(a.2M){O t.2Y:a.1d();4(l.N()){l.30()}w{12(0,D)}R;O t.2S:a.1d();4(l.N()){l.2D()}w{12(0,D)}R;O t.2v:a.1d();4(l.N()){l.2C()}w{12(0,D)}R;O t.2p:a.1d();4(l.N()){l.2A()}w{12(0,D)}R;O r.17&&$.1c(r.S)==","&&t.2x:O t.2I:O t.2E:4(1Z()){a.1d();j=D;6 C}R;O t.2B:l.Z();R;3J:1P(p);p=1O(12,r.1J);R}}).2t(3(){s++}).3E(3(){s=0;4(!h.1F){2r()}}).2q(3(){4(s++>1&&!l.N()){12(0,D)}}).11("1k",3(){5 c=(1r.7>1)?1r[1]:P;3 1N(q,a){5 b;4(a&&a.7){16(5 i=0;i<a.7;i++){4(a[i].L.J()==q.J()){b=a[i];R}}}4(W c=="3")c(b);w u.14("L",b&&[b.y,b.F])}$.I(15(u.K()),3(i,a){21(a,1N,1N)})}).11("2b",3(){n.1o()}).11("28",3(){$.1u(r,1r[1]);4("y"2h 1r[1])n.1e()}).11("24",3(){l.1p();u.1p();$(o.2U).1p(".19")});3 1Z(){5 e=l.2g();4(!e)6 C;5 v=e.L;m=v;4(r.17){5 b=15(u.K());4(b.7>1){5 f=r.S.7;5 c=$(o).18().1I;5 d,1H=0;$.I(b,3(i,a){1H+=a.7;4(c<=1H){d=i;6 C}1H+=f});b[d]=v;v=b.3f(r.S)}v+=r.S}u.K(v);1l();u.14("L",[e.y,e.F]);6 D}3 12(b,c){4(k==t.2N){l.Z();6}5 a=u.K();4(!c&&a==m)6;m=a;a=1m(a);4(a.7>=r.29){u.Q(r.26);4(!r.1s)a=a.J();21(a,3a,1l)}w{1q();l.Z()}};3 15(b){4(!b)6[""];4(!r.17)6[$.1c(b)];6 $.4h(b.23(r.S),3(a){6 $.1c(b).7?$.1c(a):P})}3 1m(a){4(!r.17)6 a;5 c=15(a);4(c.7==1)6 c[0];5 b=$(o).18().1I;4(b==a.7){c=15(a)}w{c=15(a.22(a.37(b),""))}6 c[c.7-1]}3 1G(q,a){4(r.1G&&(1m(u.K()).J()==q.J())&&k!=t.2n){u.K(u.K()+a.37(1m(m).7));$(o).18(m.7,m.7+a.7)}};3 2r(){1P(p);p=1O(1l,4g)};3 1l(){5 c=l.N();l.Z();1P(p);1q();4(r.36){u.1k(3(a){4(!a){4(r.17){5 b=15(u.K()).1n(0,-1);u.K(b.3f(r.S)+(b.7?r.S:""))}w{u.K("");u.14("L",P)}}})}};3 3a(q,a){4(a&&a.7&&s){1q();l.35(a,q);1G(q,a[0].F);l.20()}w{1l()}};3 21(f,d,g){4(!r.1s)f=f.J();5 e=n.31(f);4(e&&e.7){d(f,e)}w 4((W r.Y=="1B")&&(r.Y.7>0)){5 c={4f:+1M 4e()};$.I(r.2Z,3(a,b){c[a]=W b=="3"?b():b});$.4d({4c:"4b",4a:"19"+o.49,2V:r.2V,Y:r.Y,y:$.1u({q:1m(f),47:r.X},c),44:3(a){5 b=r.1A&&r.1A(a)||1A(a);n.1i(f,b);d(f,b)}})}w{l.2T();g(f)}};3 1A(c){5 d=[];5 b=c.23("\\n");16(5 i=0;i<b.7;i++){5 a=$.1c(b[i]);4(a){a=a.23("|");d[d.7]={y:a,F:a[0],L:r.1z&&r.1z(a,a[0])||a[0]}}}6 d};3 1q(){u.1h(r.26)}};$.M.1T={2Q:"41",2P:"3Z",26:"3Y",29:1,1J:3W,1s:C,1f:D,1w:C,1g:10,X:3U,36:C,2Z:{},1X:D,1R:3(a){6 a[0]},1v:P,1G:C,E:0,17:C,S:", ",1y:3(b,a){6 b.22(1M 3T("(?![^&;]+;)(?!<[^<>]*)("+a.22(/([\\^\\$\\(\\)\\[\\]\\{\\}\\*\\.\\+\\?\\|\\\\])/2K,"\\\\$1")+")(?![^<>]*>)(?![^&;]+;)","2K"),"<2J>$1</2J>")},1D:D,1E:3S};$.M.3c=3(g){5 h={};5 j=0;3 1f(s,a){4(!g.1s)s=s.J();5 i=s.2H(a);4(g.1w=="3R"){i=s.J().1k("\\\\b"+a.J())}4(i==-1)6 C;6 i==0||g.1w};3 1i(q,a){4(j>g.1g){1o()}4(!h[q]){j++}h[q]=a}3 1e(){4(!g.y)6 C;5 f={},2G=0;4(!g.Y)g.1g=1;f[""]=[];16(5 i=0,2F=g.y.7;i<2F;i++){5 c=g.y[i];c=(W c=="1B")?[c]:c;5 d=g.1v(c,i+1,g.y.7);4(d===C)1V;5 e=d.3Q(0).J();4(!f[e])f[e]=[];5 b={F:d,y:c,L:g.1z&&g.1z(c)||d};f[e].1U(b);4(2G++<g.X){f[""].1U(b)}};$.I(f,3(i,a){g.1g++;1i(i,a)})}1O(1e,25);3 1o(){h={};j=0}6{1o:1o,1i:1i,1e:1e,31:3(q){4(!g.1g||!j)6 P;4(!g.Y&&g.1w){5 a=[];16(5 k 2h h){4(k.7>0){5 c=h[k];$.I(c,3(i,x){4(1f(x.F,q)){a.1U(x)}})}}6 a}w 4(h[q]){6 h[q]}w 4(g.1f){16(5 i=q.7-1;i>=g.29;i--){5 c=h[q.3O(0,i)];4(c){5 a=[];$.I(c,3(i,x){4(1f(x.F,q)){a[a.7]=x}});6 a}}}6 P}}};$.M.32=3(e,g,f,k){5 h={H:"3N"};5 j,z=-1,y,1t="",1S=D,G,B;3 2y(){4(!1S)6;G=$("<3M/>").Z().Q(e.2P).T("3L","3K").1Q(1K.2w);B=$("<3H/>").1Q(G).3G(3(a){4(U(a).2u&&U(a).2u.3F()==\'2s\'){z=$("1L",B).1h(h.H).3D(U(a));$(U(a)).Q(h.H)}}).2q(3(a){$(U(a)).Q(h.H);f();g.2t();6 C}).3C(3(){k.1F=D}).3B(3(){k.1F=C});4(e.E>0)G.T("E",e.E);1S=C}3 U(a){5 b=a.U;3A(b&&b.3z!="2s")b=b.3y;4(!b)6[];6 b}3 V(b){j.1n(z,z+1).1h(h.H);2o(b);5 a=j.1n(z,z+1).Q(h.H);4(e.1D){5 c=0;j.1n(0,z).I(3(){c+=A.1a});4((c+a[0].1a-B.1b())>B[0].3x){B.1b(c+a[0].1a-B.3w())}w 4(c<B.1b()){B.1b(c)}}};3 2o(a){z+=a;4(z<0){z=j.1j()-1}w 4(z>=j.1j()){z=0}}3 2m(a){6 e.X&&e.X<a?e.X:a}3 2l(){B.2z();5 b=2m(y.7);16(5 i=0;i<b;i++){4(!y[i])1V;5 a=e.1R(y[i].y,i+1,b,y[i].F,1t);4(a===C)1V;5 c=$("<1L/>").3v(e.1y(a,1t)).Q(i%2==0?"3u":"3P").1Q(B)[0];$.y(c,"2k",y[i])}j=B.3t("1L");4(e.1X){j.1n(0,1).Q(h.H);z=0}4($.2e.2W)B.2W()}6{35:3(d,q){2y();y=d;1t=q;2l()},2D:3(){V(1)},30:3(){V(-1)},2C:3(){4(z!=0&&z-8<0){V(-z)}w{V(-8)}},2A:3(){4(z!=j.1j()-1&&z+8>j.1j()){V(j.1j()-1-z)}w{V(8)}},Z:3(){G&&G.Z();j&&j.1h(h.H);z=-1},N:3(){6 G&&G.3s(":N")},3q:3(){6 A.N()&&(j.2j("."+h.H)[0]||e.1X&&j[0])},20:3(){5 a=$(g).3p();G.T({E:W e.E=="1B"||e.E>0?e.E:$(g).E(),2i:a.2i+g.1a,1W:a.1W}).20();4(e.1D){B.1b(0);B.T({2L:e.1E,3n:\'3X\'});4($.1Y.3m&&W 1K.2w.3l.2L==="1x"){5 c=0;j.I(3(){c+=A.1a});5 b=c>e.1E;B.T(\'3k\',b?e.1E:c);4(!b){j.E(B.E()-2R(j.T("2O-1W"))-2R(j.T("2O-3j")))}}}},2g:3(){5 a=j&&j.2j("."+h.H).1h(h.H);6 a&&a.7&&$.y(a[0],"2k")},2T:3(){B&&B.2z()},1p:3(){G&&G.3i()}}};$.2e.18=3(b,f){4(b!==1x){6 A.I(3(){4(A.2d){5 a=A.2d();4(f===1x||b==f){a.4n("2c",b);a.3h()}w{a.4m(D);a.4l("2c",b);a.4k("2c",f);a.3h()}}w 4(A.3g){A.3g(b,f)}w 4(A.1C){A.1C=b;A.3e=f}})}5 c=A[0];4(c.2d){5 e=1K.18.4j(),3d=c.F,2a="<->",2f=e.3b.7;e.3b=2a;5 d=c.F.2H(2a);c.F=3d;A.18(d,d+2f);6{1I:d,39:d+2f}}w 4(c.1C!==1x){6{1I:c.1C,39:c.3e}}}})(4i);',62,272,'|||function|if|var|return|length|||||||||||||||||||||||||else||data|active|this|list|false|true|width|value|element|ACTIVE|each|toLowerCase|val|result|Autocompleter|visible|case|null|addClass|break|multipleSeparator|css|target|moveSelect|typeof|max|url|hide||bind|onChange||trigger|trimWords|for|multiple|selection|autocomplete|offsetHeight|scrollTop|trim|preventDefault|populate|matchSubset|cacheLength|removeClass|add|size|search|hideResultsNow|lastWord|slice|flush|unbind|stopLoading|arguments|matchCase|term|extend|formatMatch|matchContains|undefined|highlight|formatResult|parse|string|selectionStart|scroll|scrollHeight|mouseDownOnSelect|autoFill|progress|start|delay|document|li|new|findValueCallback|setTimeout|clearTimeout|appendTo|formatItem|needsInit|defaults|push|continue|left|selectFirst|browser|selectCurrent|show|request|replace|split|unautocomplete||loadingClass||setOptions|minChars|teststring|flushCache|character|createTextRange|fn|textLength|selected|in|top|filter|ac_data|fillList|limitNumberOfItems|BACKSPACE|movePosition|PAGEDOWN|click|hideResults|LI|focus|nodeName|PAGEUP|body|COMMA|init|empty|pageDown|ESC|pageUp|next|RETURN|ol|nullData|indexOf|TAB|strong|gi|maxHeight|keyCode|DEL|padding|resultsClass|inputClass|parseInt|DOWN|emptyList|form|dataType|bgiframe|opera|UP|extraParams|prev|load|Select|||display|mustMatch|substring||end|receiveData|text|Cache|orig|selectionEnd|join|setSelectionRange|select|remove|right|height|style|msie|overflow|off|offset|current|attr|is|find|ac_even|html|innerHeight|clientHeight|parentNode|tagName|while|mouseup|mousedown|index|blur|toUpperCase|mouseover|ul|188|default|absolute|position|div|ac_over|substr|ac_odd|charAt|word|180|RegExp|100|switch|400|auto|ac_loading|ac_results||ac_input|keydown|keypress|success|submit||limit|150|name|port|abort|mode|ajax|Date|timestamp|200|map|jQuery|createRange|moveEnd|moveStart|collapse|move'.split('|'),0,{}))

data/lib/yard/server/templates/default/layout/html/breadcrumb.erb

@@ -0,0 +1,46 @@
+<form class="search" method="get" action="/<%= base_path(router.search_prefix) %>">
+  Search: <input name="q" type="search" placeholder="Search" id="search_box" size="30" value="<%= @query %>" />
+</form>
+<script type="text/javascript" charset="utf-8">
+  $(function() {
+    $('#search_box').autocomplete($('#search_box').parent().attr('action'), {
+      width: document.body.className == 'frames' ? 250 : 340,
+      formatItem: function(item) {
+        var values = item[0].split(",");
+        return values[0] + (values[1] == '' ? "" : " <small>(" + values[1] + ")</small>");
+      }
+    }).result(function(event, item) {
+      var values = item[0].split(",")
+      $('#search_box').val(values[1]);
+      location.href = values[3];
+      return false;
+    });
+  });
+</script>
+<style>
+  .frames form.search { position: absolute; right: 14px; top: -6px; padding-top: 10px; }
+  .frames #menu .noframes { float: none; }
+  .frames #menu { float: left; }
+  .frames #content h1 { margin-top: 15px; }
+</style>
+
+<div id="menu">
+  <% unless @single_library %>
+    <a href="/<%= router.docs_prefix %>" target="_top">Libraries</a> &raquo;
+    <span class="title"><%= @library.name %> <% if @library.version %><small>(<%= @library.version %>)</small><% end %></span>
+  <% end %>
+  <% if object.is_a?(CodeObjects::Base) && @file.nil? %>
+    <% unless @single_library %>&raquo;<% end %>
+    <a href="<%= url_for_index %>"><% if object.root? || object.type == :method %>Index<% else %>Index (<%= object.name.to_s[0] %>)<% end %></a> &raquo;
+    <%= @breadcrumb.map {|obj| "<span class='title'>" + linkify(obj, obj.name) + "</span>" }.join(" &raquo; ") %>
+    <%= @breadcrumb.size > 0 ? " &raquo; " : "" %>
+    <span class='title'><%= object.root? ? "Top Level Namespace" : object.name(true) %></span>
+  <% else %>
+    <% if (@breadcrumb_title || object != '_index.html') && !@single_library %>&raquo; <% end %>
+    <% if object != '_index.html' %><a href="<%= url_for_index %>">Index</a> &raquo; <% end %>
+    <span class='title'><%= @breadcrumb_title %></span>
+  <% end %>
+
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+

data/lib/yard/server/templates/default/layout/html/script_setup.erb

@@ -0,0 +1,8 @@
+<script type="text/javascript" charset="utf-8">
+  hasFrames = window.top.frames.main ? true : false;
+  relpath = '/';
+  docsPrefix = '<%= base_path(router.docs_prefix) %>';
+  listPrefix = '<%= base_path(router.list_prefix) %>';
+  searchPrefix = '<%= base_path(router.search_prefix) %>';
+  framesUrl = '<%= url_for_frameset %>';
+</script>

data/lib/yard/server/templates/default/layout/html/setup.rb

@@ -0,0 +1,7 @@
+def javascripts
+  super + %w(js/autocomplete.js)
+end
+
+def stylesheets
+  super + %w(css/custom.css)
+end

data/lib/yard/server/templates/default/method_details/html/permalink.erb

@@ -0,0 +1,4 @@
+<script>
+$("#<%= anchor_for(object) %>").prepend(
+  '<a class="permalink" href="/<%= base_path(router.docs_prefix) %>/<%= serializer.serialized_path(object) %>">permalink</a>');
+</script>

data/lib/yard/server/templates/default/method_details/html/setup.rb

@@ -0,0 +1,4 @@
+def init
+  super
+  sections.place(:permalink).after_any(:method_signature)
+end

data/lib/yard/server/templates/doc_server/library_list/html/contents.erb

@@ -0,0 +1,13 @@
+<ul>
+  <% @libraries.sort_by {|name, y| name.downcase }.each do |name, library_versions| %>
+  <li class="r<%= @row = @row == 1 ? 2 : 1 %>">
+    <% library_versions = library_versions.dup %>
+    <% first_lib = library_versions.pop %>
+    <a href="/<%= router.docs_prefix %>/<%= first_lib.name %>/frames"><%= name %></a>
+    <% if first_lib.version %>
+      <small>(<%= first_lib.version %><% if library_versions.size > 0 %>,
+        <%= library_versions.reverse.map {|lib| "<a href=\"/#{router.docs_prefix}/#{lib}/frames\">#{lib.version}</a>" }.join(', ') %><% end %>)</small>
+    <% end %>
+  </li>
+  <% end %>
+</ul>

data/lib/yard/server/templates/doc_server/library_list/html/headers.erb

@@ -0,0 +1,26 @@
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+<title>YARD Documentation Server <%= YARD::VERSION %> - Library Listing</title>
+<link rel="stylesheet" href="/css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="/css/custom.css" type="text/css" media="screen" charset="utf-8" />
+<script type="text/javascript" charset="utf-8" src="/js/jquery.js"></script>
+<script type="text/javascript">
+  function framesLinks() {
+    $('#framelink').toggle(function() {
+      $(this).text('links with frames');
+      $('ul li a').each(function() {
+        $(this).attr('href', $(this).attr('href').replace(/\/frames$/, ''));
+      });
+    }, function() {
+      $(this).text('links without frames');
+      $('ul li a').each(function() {
+        $(this).attr('href', $(this).attr('href') + '/frames');
+      });
+    })
+  }
+
+  $(framesLinks);
+</script>
+<style type="text/css" media="screen">
+  ul { list-style: circle inside none; padding: 0; }
+  li { font-size: 1.2em; line-height: 1.4em; padding: 3px 5px; }
+</style>

data/lib/yard/server/templates/doc_server/library_list/html/library_list.erb

@@ -0,0 +1,12 @@
+<!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" xml:lang="en" lang="en">
+  <head>
+    <%= erb(:headers) %>
+  </head>
+  <body>
+    <div id="content">
+      <%= yieldall %>
+    </div>
+  </body>
+</html>

data/lib/yard/server/templates/doc_server/library_list/html/setup.rb

@@ -0,0 +1,3 @@
+def init
+  sections :library_list, [:title, :contents]
+end

data/lib/yard/server/templates/doc_server/library_list/html/title.erb

@@ -0,0 +1,2 @@
+<h1>YARD Documentation Server <%= YARD::VERSION %></h1>
+<h2>Library Listing <small>(<a id="framelink" href="#">links without frames</a>)</small></h2>

data/lib/yard/server/templates/doc_server/processing/html/processing.erb

@@ -0,0 +1,51 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <link rel="stylesheet" href="/css/style.css" type="text/css" media="screen" charset="utf-8" />
+    <link rel="stylesheet" href="/css/custom.css" type="text/css" media="screen" charset="utf-8" />
+    <script type="text/javascript" charset="utf-8" src="/js/jquery.js"></script>
+    <script type="text/javascript" charset="utf-8">
+      function checkPage(process) {
+        $.ajax({cache: false, url: "<%= router.request.path %>" + (process ? "?process=true" : ""), statusCode: { 200: function() { window.location = "<%= @path %>"; } } });
+        setTimeout('checkPage()', 2000);
+      }
+      function setFade() {
+        centerMessage();
+        $(window).resize(function() { centerMessage(); });
+        $('#fade').fadeIn();
+        $('#processing').fadeIn();
+      }
+      function centerMessage() {
+        $('#fade').css('width', $(window).width() + 'px');
+        $('#fade').css('height', $(window).height() - parseInt($('#fade').css('top')) + 'px');
+        $('#processing').css('left', ($(window).width() / 2 - $('#processing').width() / 2) + 'px');
+        $('#processing').css('top', ($(window).height() / 2 - $('#processing').height() / 2) + 'px');
+      }
+      $(function() { checkPage(true); });
+      $(setFade);
+    </script>
+    <style type="text/css" media="screen">
+      body { overflow: hidden; }
+    </style>
+    <title>Processing <%= @library.to_s(false) %></title>
+  </head>
+  <body>
+    <div id="menu">
+      <% unless @single_library %>
+        <a href="/<%= router.docs_prefix %>" target="_top">Libraries</a> &raquo;
+        <span class="title"><%= @library.name %> <% if @library.version %><small>(<%= @library.version %>)</small><% end %></span>
+      <% end %>
+    </div>
+    <div id="fade"></div>
+    <div id="processing">
+      <h1>Processing <%= @library.name %></h1>
+      <p>
+        <strong><%= @library.name %></strong> <% if @library.version %>(<%= @library.version %>)<% end %> is being processed.
+        You'll be redirected when the pages are built, it shouldn't take much longer.
+      </p>
+      <img src="/images/processing.gif" align="center" />
+    </div>
+  </body>
+</html>

data/lib/yard/server/templates/doc_server/processing/html/setup.rb

@@ -0,0 +1,3 @@
+def init
+  sections :processing
+end

data/lib/yard/server/templates/doc_server/search/html/search.erb

@@ -0,0 +1,18 @@
+<div id="search_results">
+  <h1>Search Results <small>(for '<%= h @query %>')</small></h1>
+  <p>Showing <%= @visible_results.size %> of <%= @results.size %> results</p>
+  <ul>
+    <% n = 1 %>
+    <% @visible_results.each do |result| %>
+      <% name = result.type == :method ? result.name(true).to_s : result.name.to_s %>
+      <% path = name.gsub(/(#{Regexp.quote @query})/i, '<strong>\1</strong>') %>
+      <li class="r<%= n %>">
+        <a href="<%= url_for(result) %>" title="<%= result.path %>"><%= path %></a>
+          <% if !result.namespace.root? %>
+          <small>(<%= result.namespace.path %>)</small>
+          <% end %>
+      </li>
+      <% n = n == 2 ? 1 : 2 %>
+    <% end %>
+  </ul>
+</div>

data/lib/yard/server/templates/doc_server/search/html/setup.rb

@@ -0,0 +1,8 @@
+def init
+  sections :search, [T('../default/layout')]
+end
+
+def search
+  options.breadcrumb_title = h("Search for '#{@query}'")
+  yieldall :contents => erb(:search)
+end

data/lib/yard/server/webrick_adapter.rb

@@ -0,0 +1,43 @@
+require 'webrick'
+
+module YARD
+  module Server
+    # The main adapter to initialize a WEBrick server.
+    class WebrickAdapter < Adapter
+      # Initializes a WEBrick server. If {Adapter#server_options} contains a
+      # +:daemonize+ key set to true, the server will be daemonized.
+      def start
+        server_options[:ServerType] = WEBrick::Daemon if server_options[:daemonize]
+        server = WEBrick::HTTPServer.new(server_options)
+        server.mount('/', WebrickServlet, self)
+        trap("INT") { server.shutdown }
+        server.start
+      end
+    end
+
+    # The main WEBrick servlet implementation, accepting only GET requests.
+    class WebrickServlet < WEBrick::HTTPServlet::AbstractServlet
+      attr_accessor :adapter
+
+      def initialize(server, adapter)
+        super
+        self.adapter = adapter
+      end
+
+      def do_GET(request, response)
+        status, headers, body = *adapter.router.call(request)
+        response.status = status
+        response.body = body.is_a?(Array) ? body[0] : body
+        headers.each do |key, value|
+          response[key] = value
+        end
+      end
+    end
+  end
+end
+
+# @private
+class WEBrick::HTTPRequest
+  attr_accessor :version_supplied
+  def xhr?; (self['X-Requested-With'] || "").downcase == 'xmlhttprequest' end
+end

data/lib/yard/server.rb

@@ -0,0 +1,11 @@
+module YARD
+  module Server
+    # Registers a static path to be used in static asset lookup.
+    # @param [String] path the pathname to register
+    # @return [void]
+    # @since 0.6.2
+    def self.register_static_path(path)
+      Commands::StaticFileCommand::STATIC_PATHS.push(path)
+    end
+  end
+end