Skip to content

Commit 94b50f3

Browse files
committed
improve entries and display of parameters
1 parent 09e47c4 commit 94b50f3

File tree

3 files changed

+33
-9
lines changed

3 files changed

+33
-9
lines changed

lib/docs/filters/trio/clean_html.rb

Lines changed: 25 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,24 @@ def call
1010
css('.headerlink').remove
1111

1212
css('dt').each do |node|
13-
if node.parent.classes.include? 'class'
14-
new_node = doc.document.create_element 'h2'
13+
node.name = 'h3'
14+
if node.parent.classes.include? 'field-list'
15+
node.name = 'h4'
16+
node['style'] = 'margin: 0'
17+
if node.text == 'Parameters' or node.text == 'Raises'
18+
node.next_element.css('strong').each do |n|
19+
n.name = 'code'
20+
end
21+
end
1522
else
16-
new_node = doc.document.create_element "h3"
23+
code = doc.document.create_element 'code'
24+
if em = node.at_css('.property')
25+
code.inner_html = "<em>#{em.text.strip}</em> "
26+
em.remove
27+
end
28+
code.inner_html += node.inner_text.strip
29+
node.inner_html = code
1730
end
18-
new_node['id'] = node['id']
19-
new_node.content = node.inner_text
20-
node.replace new_node
2131
end
2232

2333
css('pre').each do |node|
@@ -28,6 +38,15 @@ def call
2838
end
2939
node.parent.parent.replace(node)
3040
end
41+
42+
css('.admonition').each do |node|
43+
node.name = 'blockquote'
44+
node.at_css('.admonition-title').name = 'h4'
45+
# new_node = node.document.create_element 'blockquote'
46+
# new_node.inner_html = node.inner_html
47+
# node.replace new_node
48+
end
49+
3150
doc
3251
end
3352
end

lib/docs/filters/trio/entries.rb

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,14 @@ def additional_entries
2020

2121
dl = node.parent.parent
2222

23-
if dl.classes.include?('attribute') or dl.classes.include?('method')
23+
if dl.classes.include?('attribute') \
24+
or dl.classes.include?('method') \
25+
or dl.classes.include?('data')
2426
parent = dl.parent.previous_element
2527
cls = ''
28+
if n = parent.at_css('.descclassname')
29+
cls += n.text
30+
end
2631
if n = parent.at_css('.descname')
2732
if n.text == "The nursery interface"
2833
cls += "Nursery."

public/docs/docs.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@
6363
"code": "https://github.com/python-trio/trio"
6464
},
6565
"release": "0.11",
66-
"mtime": 1556275385,
67-
"db_size": 746040
66+
"mtime": 1556279513,
67+
"db_size": 757201
6868
}
6969
]

0 commit comments

Comments
 (0)