From: Adam Porter <adam@alphapapa.net>
To: emacs-orgmode@gnu.org
Subject: Re: [ANN] org-sidebar-tree: Sidebar tree-view buffer for outline navigation
Date: Thu, 03 Oct 2019 12:56:11 -0500 [thread overview]
Message-ID: <87r23tbtms.fsf@alphapapa.net> (raw)
In-Reply-To: 874l0r1e7n.fsf@ucl.ac.uk
"Fraga, Eric" <e.fraga@ucl.ac.uk> writes:
> Hi Adam,
>
> I've had a chance to play with it a little bit. Works very well
> generally. Some notes:
Hi Eric,
> - a way to exit the sidebar-tree mode to get back to the full buffer
> (e.g. to run commands that require the whole file). The documentation
> seems to indicate that 'q' should do this but it didn't work for
> me. I do use evil mode but q didn't work whether in evil or emacs
> states.
Please note that it's not a mode, it's just a side window displaying an
indirect buffer in Org mode (like how org-tree-to-indirect-buffer
works). You can do anything in the tree-view buffer that you can do in
any other Org buffer, including inputting characters, calling Org
commands, switching windows, killing the buffer, deleting the window,
etc.
The only difference is that certain keys are bound by default to
commands which are more appropriate for the tree-view buffer, e.g. the
cycle commands don't show body text, and RET/mouse-1 jump to headings in
the source window.
"q" is no longer bound differently, and the readme has been updated.
> - hitting RET on a headline which has subtrees doesn't show the
> subtrees. Can this be customized? It might be nice to have two
> different bindings to allow for recursion and not.
Like other Org buffers, <tab> is used to cycle headings by default. As
documented, the keymap org-sidebar-tree-map is used, which you're free
to customize.
I recently improved the tree-view cycling command to work more like
org-cycle. Please let me know if you think it needs more work.
> - invoking org-sidebar-tree when point is at the top of the file,
> e.g. on the #+title: line of a document, gives an error:
> outline-back-to-heading: Before first heading.
That bug is fixed.
Note as well that the tree-view can be activated for narrowed Org
buffers, in which case it is also narrowed to the visible portion of the
buffer. So you can, e.g.:
1. "M-x customize-option RET org-sidebar-tree-jump-fn RET", and set it to
use indirect buffers when jumping to headings.
2. "M-x org-sidebar-tree RET" in an Org buffer.
3. Move point to a heading and press RET to display that heading in the
other window.
4. "M-x org-sidebar-tree RET" to display only that subtree in the
tree-view buffer.
This makes it easy to treat subtrees as separate projects or entities.
Thanks for your feedback!
next prev parent reply other threads:[~2019-10-03 17:56 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-10-01 14:01 [ANN] org-sidebar-tree: Sidebar tree-view buffer for outline navigation Adam Porter
2019-10-01 14:53 ` Fraga, Eric
2019-10-02 13:14 ` Fraga, Eric
2019-10-03 17:56 ` Adam Porter [this message]
2019-10-04 8:14 ` Fraga, Eric
2019-10-07 1:42 ` stardiviner
2019-10-11 3:31 ` Adam Porter
2019-10-23 5:49 ` Adam Porter
2019-10-23 16:07 ` Adam Porter
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87r23tbtms.fsf@alphapapa.net \
--to=adam@alphapapa.net \
--cc=emacs-orgmode@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).