Przeglądaj źródła

Update Less documentation (1.7.3)

Thibaut 11 lat temu
rodzic
commit
9033145f18

+ 7 - 2
lib/docs/filters/less/clean_html.rb

@@ -2,13 +2,18 @@ module Docs
   class Less
     class CleanHtmlFilter < Filter
       def call
-        css('.source-link').remove
+        css('.anchor-target').each do |node|
+          node.parent['id'] = node['id']
+          node.remove
+        end
+
+        css('.source-link', 'a[id$="md"]', 'br').remove
 
         css('#functions-overview').each do |node|
           node.ancestors('.docs-section').remove
         end
 
-        css('.docs-section', 'blockquote').each do |node|
+        css('.docs-content', '.docs-section', '.section-content', 'blockquote').each do |node|
           node.before(node.children).remove
         end
 

+ 11 - 13
lib/docs/filters/less/entries.rb

@@ -2,7 +2,7 @@ module Docs
   class Less
     class EntriesFilter < Docs::EntriesFilter
       def name
-        at_css('h1').content
+        at_css('h2').content
       end
 
       def type
@@ -16,13 +16,13 @@ module Docs
       def language_entries
         entries = []
 
-        css('h1').each do |node|
-          name = node.content
+        css('h2').each do |node|
+          name = node.content.strip
           name = 'Rulesets' if name == 'Passing Rulesets to Mixins'
           entries << [name, node['id']] unless name == 'Overview'
         end
 
-        css('h2[id^="import-options-"]').each do |node|
+        css('h3[id^="import-options-"]').each do |node|
           entries << ["@import #{node.content}", node['id']]
         end
 
@@ -33,9 +33,9 @@ module Docs
           ['@property',         'variables-feature-properties'],
           ['@@var',             'variables-feature-variable-names'],
           [':extend()',         'extend-feature'],
-          [':extend(all)',      'extend-feature-extend-quotallquot'],
-          ['@arguments',        'mixins-parametric-feature-the-codeargumentscode-variable'],
-          ['@rest',             'mixins-parametric-feature-advanced-arguments-and-the-coderestcode-variable'],
+          [':extend(all)',      'extend-feature-extend-all-'],
+          ['@arguments',        'mixins-parametric-feature-the-arguments-variable'],
+          ['@rest',             'mixins-parametric-feature-advanced-arguments-and-the-rest-variable'],
           ['@import',           'import-directives-feature'],
           ['when',              'mixin-guards-feature'],
           ['.loop()',           'loops-feature'],
@@ -48,13 +48,11 @@ module Docs
         entries = []
         type = nil
 
-        css('.docs-section').each do |section|
-          if title = section.at_css('h1')
-            type = title.content
+        css('*').each do |node|
+          if node.name == 'h2'
+            type = node.content
             type.sub! %r{(.+) Functions}, 'Functions: \1'
-          end
-
-          section.css('h3').each do |node|
+          elsif node.name == 'h4'
             entries << [node.content, node['id'], type]
           end
         end

+ 2 - 2
lib/docs/scrapers/less.rb

@@ -1,12 +1,12 @@
 module Docs
   class Less < UrlScraper
     self.type = 'less'
-    self.version = '1.7.0'
+    self.version = '1.7.3'
     self.base_url = 'http://lesscss.org'
     self.root_path = '/features'
     self.initial_paths = %w(/functions)
 
-    html_filters.push 'less/entries', 'less/clean_html', 'title'
+    html_filters.push 'less/clean_html', 'less/entries', 'title'
 
     options[:title] = 'Less'
     options[:container] = 'div[role=main]'