What Emacs utilities can provide better browsing and navigation of reST documents? Alternatively, how to configure existing utilities to work with reST? What I mean, why I ask:
Of the lightweight markups I lately mostly compose reST [1], and of course I do so with God's Own Editor (currently version='GNU Emacs 24.4.1' as packaged for Debian stable). Some of my reST docs are rather large, hence I seek better ways to
- high-level-view reST doc sections. E.g., un/folding at section headings, or (better yet) providing a
speedbar
-like tree browser. - navigate between doc sections. Again,
speedbar
for reST would be great, but even anoccur
-like view would be helpful. (Unfortunately I lack sufficient multiline-regexp-fu to telloccur
how to match reST section headings--your assistance is appreciated!)
Unfortunately
- the otherwise-quite-useful
rst-mode
does not currently provide this functionality, though I am also pinging its maintainer regarding this. It does providerst-backward-section
(C-M-a
) andrst-forward-section
(C-M-e
), but linear navigation is well short of what I want. - When I
M-x speedbar
from anrst-mode
buffer, I get basically an empty frame. - When I
M-x imenu
from anrst-mode
buffer, it seems only able to find the first-level headers. (Am I missing something?) set-selective-display
(e.g.,M-1 C-x $
) seems quite confused: it folds some sections and list items but not others, apparently at random (at least, I'm seeing no sense to it).- As noted above, I don't know the correct regexp to give
occur
to parse reST section heads.
[1] except when on an SE site :-(
What Emacs utilities can provide better browsing and navigation of reST documents?
Alternatively, how would you make it more clear?