Update Sass documentation (3.5.1)

Thibaut Courouble committed 9 years ago

Commit 3e0193c1 parent f89c9ae4 files · +43 −29Browse files

Unified · Split

4 files

assets/stylesheets/pages/_yard.scss +1 −12
lib/docs/filters/sass/clean_html.rb +13 −1
lib/docs/filters/sass/entries.rb +24 −15
lib/docs/scrapers/sass.rb +5 −1

assets/stylesheets/pages/_yard.scss+1−12

@@ -1,16 +1,5 @@
1	._yard {	1	._yard {
2	> h2 { @extend %block-heading; }	2	@extend %simple;
3	.signature { @extend %block-label, %label-blue; }
4
5	> .method_details {
6	padding-left: 1rem;
7
8	> .signature { margin-left: -1rem; }
9	> .signature .overload { display: block; }
10
11	h3 { font-size: inherit; }
12	ul, pre { margin: 1em 0; }
13	}
14		3
15	.tag_title { font-weight: $boldFontWeight; }	4	.tag_title { font-weight: $boldFontWeight; }
16	}	5	}

lib/docs/filters/sass/clean_html.rb+13−1

           node.name = 'code'
         end
+        css('pre').each do |node|
+          node.content = node.content
+        end
         root_page? ? root : other
         doc
       end
       def root
-        at_css('.maruku_toc').remove
+        at_css('h1 + ul').remove
       end
       def other
         css('.type > code').each do |node|
           node.before(node.content.remove('Sass::Script::Value::').remove('Sass::Script::')).remove
         end
+        css('li > span.signature').each do |node|
+          node.name = 'p'
+        end
+        css('h3 strong', 'span.overload').each do |node|
+          node.before(node.children).remove
+        end
       end
     end
   end

lib/docs/filters/sass/entries.rb+24−15

         'The !optional Flag' => '!optional'
       }
-      def include_default_entry?
+      def get_name
-        false
+        'Functions'
+      end
+      def get_type
+        'Functions'
       end
       def additional_entries
         entries = []
         type = ''
-        css('> [id]').each do |node|
+        css('*').each do |node|
           if node.name == 'h2'
             type = node.content.strip
+            type.remove! %r{\s#.*}
+            node['id'] = type.parameterize
             if type == 'Function Directives'
               entries << ['@function', node['id'], '@-Rules and Directives']
             end
             next
-          end
+          elsif node.name == 'h3' || node.name == 'h4'
+            next unless TYPES.include?(type)
-          next unless TYPES.include?(type)
+            name = node.content.strip
+            name.remove! %r{\A.+?: }
+            name.remove! %r{\s#.*}
-          name = node.content.strip
+            node['id'] = name.parameterize
-          name.remove! %r{\A.+?: }
-          next if SKIP_NAMES.include?(name)
+            next if SKIP_NAMES.include?(name)
-          name = REPLACE_NAMES[name] if REPLACE_NAMES[name]
+            name = REPLACE_NAMES[name] if REPLACE_NAMES[name]
-          name.gsub!(/ [A-Z]/) { |str| str.downcase! }
+            name.gsub!(/ [A-Z]/) { |str| str.downcase! }
-          if type == '@-Rules and Directives'
+            if type == '@-Rules and Directives'
-            next unless name =~ /\A@[\w\-]+\z/ || name == '!optional'
+              next unless name =~ /\A@[\w\-]+\z/ || name == '!optional'
-          end
+            end
-          entries << [name, node['id'], type]
+            entries << [name, node['id'], type]
+          end
         end
         entries
       def function_entries
         css('.method_details > .signature').inject [] do |entries, node|
-          name = node.at_css('strong').content.strip
+          name = node.content.strip.remove(%r{\(.*})
           unless name == entries.last.try(:first)
             entries << [name, node['id'], 'Functions']

lib/docs/scrapers/sass.rb+5−1

 module Docs
   class Sass < UrlScraper
     self.type = 'yard'
-    self.release = '3.4.22'
+    self.release = '3.5.1'
     self.base_url = 'http://sass-lang.com/documentation/'
     self.root_path = 'file.SASS_REFERENCE.html'
+    self.links = {
+      home: 'http://sass-lang.com/',
+      code: 'https://github.com/sass/sass'
+    }
     html_filters.push 'sass/clean_html', 'sass/entries', 'title'