History

Update Sass documentation (3.3.0)

Thibaut committed 12 years ago

Commit 2f17c051 parent 2e4a38f5 files · +25 −20Browse files

Unified · Split

5 files
  1. assets/javascripts/templates/pages/about_tmpl.coffee +1 −1
  2. assets/stylesheets/pages/_yard.scss +2 −0
  3. lib/docs/filters/sass/clean_html.rb +14 −9
  4. lib/docs/filters/sass/entries.rb +3 −3
  5. lib/docs/scrapers/sass.rb +5 −7
assets/javascripts/templates/pages/about_tmpl.coffee+1−1
@@ -192,7 +192,7 @@ credits = [ · 191 unmodified lines
192192 'https://raw.github.com/rails/rails/master/activerecord/MIT-LICENSE'
193193 ], [
194194 'Sass',
195− '2006-2013 Hampton Catlin, Nathan Weizenbaum, and Chris Eppstein',
195+ '2006-2014 Hampton Catlin, Nathan Weizenbaum, and Chris Eppstein',
196196 'MIT',
197197 'https://raw.github.com/nex3/sass/master/MIT-LICENSE'
198198 ], [
assets/stylesheets/pages/_yard.scss+2−0
@@ -11,4 +11,6 @@ · 10 unmodified lines
1111 h3 { font-size: inherit; }
1212 ul, pre { margin: 1em 0; }
1313 }
14+
15+ .tag_title { font-weight: bold; }
1416 }
lib/docs/filters/sass/clean_html.rb+14−9
@@ -20,26 +20,31 @@ module Docs · 19 unmodified lines
2020
2121 css('.showSource', '.source_code').remove
2222
23+ css('div.docstring', 'div.discussion').each do |node|
24+ node.before(node.children).remove
25+ end
26+
2327 # Remove "See Also"
2428 css('.see').each do |node|
2529 node.previous_element.remove
2630 node.remove
2731 end
2832
29− # Un-indent code blocks
30− css('pre.example').each do |node|
31− node.inner_html = node.inner_html.strip_heredoc
33+ # Remove "- ([...])" before method names
34+ css('.signature', 'span.overload', 'span.signature').each do |node|
35+ next if node.at_css('.overload')
36+ node.child.remove while node.child.name != 'strong'
3237 end
3338
34− # Remove "- " before method names
35− css('.signature', 'span.overload').each do |node|
36− node.child.content = node.child.content.sub(/\A\s*-\s*/, '')
39+ # Clean up .inline divs
40+ css('div.inline').each do |node|
41+ node.content = node.content
42+ node.name = 'span'
3743 end
3844
3945 # Remove links to type classes (e.g. Number)
40− css('.type > code > a, .signature > code > a, span.overload > code > a').each do |node|
41− node.before(node.content)
42− node.remove
46+ css('.type > code').each do |node|
47+ node.before(node.content.sub('Sass::Script::Value::', '').sub('Sass::Script::', '')).remove
4348 end
4449 end
4550 end
lib/docs/filters/sass/entries.rb+3−3
@@ -11,7 +11,7 @@ module Docs · 10 unmodified lines
1111 '%foo' => '%placeholder selector',
1212 '&' => '& parent selector',
1313 '$' => '$ variables',
14− '#{}' => '#{} interpolation',
14+ '`' => '#{} interpolation',
1515 'The !optional Flag' => '!optional'
1616 }
1717
@@ -35,7 +35,7 @@ module Docs · 17 unmodified lines
3535 entries << ['@function', node['id'], '@-Rules and Directives']
3636 end
3737
38− if type.end_with? 'Directives'
38+ if type.include? 'Directives'
3939 type = '@-Rules and Directives'
4040 elsif type == 'Output Style'
4141 type = 'Output Styles'
@@ -55,7 +55,7 @@ module Docs · 13 unmodified lines
5555 name.gsub!(/ [A-Z]/) { |str| str.downcase! }
5656
5757 if type == '@-Rules and Directives'
58− next unless name =~ /\A@\w+\z/ || name == '!optional'
58+ next unless name =~ /\A@[\w\-]+\z/ || name == '!optional'
5959 end
6060
6161 entries << [name, node['id'], type]
lib/docs/scrapers/sass.rb+5−7
@@ -1,24 +1,22 @@
11 module Docs
22 class Sass < UrlScraper
33 self.type = 'yard'
4− self.version = '3.2.12'
5− self.base_url = 'http://sass-lang.com/docs/yardoc/'
4+ self.version = '3.3.0'
5+ self.base_url = 'http://sass-lang.com/documentation/'
66 self.root_path = 'file.SASS_REFERENCE.html'
77
88 html_filters.push 'sass/clean_html', 'sass/entries', 'title'
99
1010 options[:only] = %w(Sass/Script/Functions.html)
11+ options[:root_title] = false
12+ options[:title] = 'Sass Functions'
1113
1214 options[:container] = ->(filter) do
1315 filter.root_page? ? '#filecontents' : '#instance_method_details'
1416 end
1517
16− options[:title] = ->(filter) do
17− 'Sass Functions' if filter.slug == 'Sass/Script/Functions'
18− end
19−
2018 options[:attribution] = <<-HTML
21− &copy; 2006&ndash;2013 Hampton Catlin, Nathan Weizenbaum, and Chris Eppstein<br>
19+ &copy; 2006&ndash;2014 Hampton Catlin, Nathan Weizenbaum, and Chris Eppstein<br>
2220 Licensed under the MIT License.
2321 HTML
2422 end

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t