1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
// Copied from from BurntSushi's dotfiles
// Ref: https://raw.githubusercontent.com/BurntSushi/dotfiles/214aab9fdc45e7a507d41b564a1136eea9b298c9/.config/tridactyl/rustdoc-condensed.js
(function() {
// This function forces rustdoc to collapse documentation for all items,
// except for the methods defined in an impl block and the primary type's
// declaration. This is the most natural view IMO, since it provides the
// primary type along with an easy to scan overview of available methods.
//
// rustdoc does seemingly have user settings that purport to make this the
// default, but I could never cause them to work in a reliably consistent
// way. This is especially useful when writing documents, where you commonly
// want to refresh and look at the docs for the specific item you're working
// on. This mini-script will automatically scroll to and expand the currently
// selected method.
//
// I used the tridactyl Firefox extension to bind this script to `,z` with
// the following in my tridactylrc:
//
// bind ,z composite jsb tri.native.run('cat path/to/rustdoc-condensed.js') | js -p eval(JS_ARG.content)
// get the currently selected doc item from URL's hash fragment
// e.g., in `struct.BStr.html#method.words`, this returns `method.words`.
function getPageId() {
const id = document.location.href.split("#")[1];
if (id) {
return id.split("?")[0].split("&")[0];
}
return null;
}
// collapse everything, with an extra click in case things are partially
// collapased already
const toggleAll = document.getElementById("toggle-all-docs");
if (toggleAll.className.indexOf("will-expand") > -1) {
toggleAll.click();
}
toggleAll.click();
// re-expand primary impls
const impls = document.getElementsByClassName("impl");
for (let i = 0; i < impls.length; i++) {
// but don't expand every impl, just the ones on this type
if (!/^impl(-\d+)?$/.test(impls[i].id)) {
continue;
}
const toggles = impls[i].getElementsByClassName("collapse-toggle");
for (let j = 0; j < toggles.length; j++) {
// If it's already expanded, then let it be. In newer versions of
// rustdoc, collapsing everything doesn't collapse the methods, so we
// don't need to do anything.
if (toggles[j].innerText === "[−]") {
continue;
}
toggles[j].click();
}
}
// expand type declaration docs
const main = document.getElementById("main");
const wrapper = document.getElementsByClassName("toggle-wrapper")[0];
wrapper.getElementsByTagName("a")[0].click();
// re-expand specific method declaration, and scroll to it
const pageId = getPageId();
if (pageId !== null) {
const method = document.getElementById(pageId);
method.getElementsByClassName("collapse-toggle")[0].click();
method.scrollIntoView();
}
})();
|