Re: Initial node tagging support -- functionally complete
Great news!!! Thank you, Jacob. Please keep developing the tag functionality. -- You received this message because you are subscribed to the Google Groups leo-editor group. To unsubscribe from this group and stop receiving emails from it, send an email to leo-editor+unsubscr...@googlegroups.com. To post to this group, send email to leo-editor@googlegroups.com. Visit this group at http://groups.google.com/group/leo-editor. For more options, visit https://groups.google.com/d/optout.
Re: Initial node tagging support -- functionally complete
Hi Mehrdad,
I'll look into adding wildcards today. Shouldn't be too hard... (famous
last words). It's a good idea, and adding wildcards would definitely
allow freeform tag hierarchy :)
The second bit -- linking tags with an external Leo file -- would be a
bit difficult. I suppose a change could be made to store the tags in
the global database (g.db), but that would make tags break if the user
shared their outlines. In short, I think the *easiest* thing that could
work is what we have now -- per-outline taglists. But, the tagging
plugin offers a tag API, so others could manipulate it as they see fit,
with custom scripts and such. It's not a feature I see myself
developing, because I think it would be a bit fragile, but someone else
may wish to pick this up?
But yes, I'll see about adding wildcards :)
Thanks,
--Jake
On 1/21/2015 10:55 AM, Mehrdad Mirreza wrote:
Hi Jacob,
missing the tagging capability was the only reason I didn't want to
use Leo for managing my private data over years. Now you have solved
the problem. Thank you for that, but tagging will be an even more
powerful feature, if you would provide tag hierarchies.
Of course, I can already define my tag hierarchy now having a naming
convention like taga/subtag1/subsubtagx, but this is only usable as
an hierarchy if I could search for taga/* and so I would get all
subtags of taga
I would really appreciate it, if you could extend the tag search to a
match with wildcards (*) . I don't think this is a big deal.
Another nice to have feature could be to have the tags in a separate
leo file as an outline, and then apply them like the syntax above
(with an separator like /) to the nodes of other files, but this is
not a trivial thing, I guess.
Best regards
Mehrdad
Am Mittwoch, 6. August 2014 21:47:45 UTC+2 schrieb Jacob Peck:
Hi all,
I've put the last bit of planned functionality into the Tagging UI
(nodetags.py plugin) today. It's available in the latest commit.
Here's
the new docstring:
Provides node tagging capabilities to Leo
By Jacob M. Peck
API
===
This plugin registers a controller object to c.theTagController,
which
provides the following API::
tc = c.theTagController
tc.get_all_tags() # return a list of all tags used in the
current
outline, automatically updated to be consistent
tc.get_tagged_nodes('foo') # return a list of positions
tagged 'foo'
tc.get_tags(p) # return a list of tags applied to the node at
position p; returns [] if node has no tags
tc.add_tag(p, 'bar') # add the tag 'bar' to the node at
position p
tc.remove_tag(p, 'baz') # remove the tag 'baz' from p if it
is in
the tag list
Internally, tags are stored in
`p.v.unknownAttributes['__node_tags']` as
a set.
UI
==
The Tags tab in the Log pane is the UI for this plugin. The bar at
the top is a search bar, editable to allow complex search queries.
It
is pre-populated with all existing tags in the outline, and remembers
your custom searches within the given session. It also acts
double duty
as an input box for the add (+) button, which adds the contents of
the
search bar as a tag to the currently selected node.
The list box in the middle is a list of headlines of nodes which
contain
the tag(s) defined by the current search string. These are
clickable,
and doing so will center the focus in the outline pane on the
selected node.
Below the list box is a dynamic display of tags on the currently
selected node. Left-clicking on any of these will populate the
search
bar with that tag, allowing you to explore similarly tagged nodes.
Right-clicking on a tag will remove it from the currently selected
node.
The status line at the bottom is purely informational.
The tag browser has set-algebra querying possible. Users may
search for
strings like 'foobar', to get nodes with both tags foo and bar, or
'foo|bar' to get nodes with either or both. Set difference (-) and
symmetric set difference (^) are supported as well. These queries
are
left-associative, meaning they are read from left to right, with no
other precedence. Parentheses are not supported. See below for more
details.
Searching
-
Searching on tags in the UI is based on set algebra. The following
syntax is used::
tagtag - return nodes tagged with both the given tags
tag|tag - return nodes tagged with either of the given
tags (or
both)
tag-tag - return nodes tagged with the first tag, but not
the
second tag
tag^tag - return nodes tagged with either of the given tags
(but *not* both)
These may be combined, and are applied left-associatively,
building the
set from the left, such that the query
Re: Initial node tagging support -- functionally complete
Hi all,
I went one further and added full regex support for tag searching.
You can now search for things like taga/*, as well as *blah*. Also,
the set-algebra still works.
There are likely corner cases I didn't suss out, but this should be
'good enough' for most uses.
Enjoy!
--Jake
On 1/23/2015 9:21 AM, Jacob Peck wrote:
Hi Mehrdad,
I'll look into adding wildcards today. Shouldn't be too hard...
(famous last words). It's a good idea, and adding wildcards would
definitely allow freeform tag hierarchy :)
The second bit -- linking tags with an external Leo file -- would be a
bit difficult. I suppose a change could be made to store the tags in
the global database (g.db), but that would make tags break if the user
shared their outlines. In short, I think the *easiest* thing that
could work is what we have now -- per-outline taglists. But, the
tagging plugin offers a tag API, so others could manipulate it as they
see fit, with custom scripts and such. It's not a feature I see
myself developing, because I think it would be a bit fragile, but
someone else may wish to pick this up?
But yes, I'll see about adding wildcards :)
Thanks,
--Jake
On 1/21/2015 10:55 AM, Mehrdad Mirreza wrote:
Hi Jacob,
missing the tagging capability was the only reason I didn't want to
use Leo for managing my private data over years. Now you have solved
the problem. Thank you for that, but tagging will be an even more
powerful feature, if you would provide tag hierarchies.
Of course, I can already define my tag hierarchy now having a naming
convention like taga/subtag1/subsubtagx, but this is only usable as
an hierarchy if I could search for taga/* and so I would get all
subtags of taga
I would really appreciate it, if you could extend the tag search to a
match with wildcards (*) . I don't think this is a big deal.
Another nice to have feature could be to have the tags in a separate
leo file as an outline, and then apply them like the syntax above
(with an separator like /) to the nodes of other files, but this is
not a trivial thing, I guess.
Best regards
Mehrdad
Am Mittwoch, 6. August 2014 21:47:45 UTC+2 schrieb Jacob Peck:
Hi all,
I've put the last bit of planned functionality into the Tagging UI
(nodetags.py plugin) today. It's available in the latest commit.
Here's
the new docstring:
Provides node tagging capabilities to Leo
By Jacob M. Peck
API
===
This plugin registers a controller object to c.theTagController,
which
provides the following API::
tc = c.theTagController
tc.get_all_tags() # return a list of all tags used in the
current
outline, automatically updated to be consistent
tc.get_tagged_nodes('foo') # return a list of positions
tagged 'foo'
tc.get_tags(p) # return a list of tags applied to the node at
position p; returns [] if node has no tags
tc.add_tag(p, 'bar') # add the tag 'bar' to the node at
position p
tc.remove_tag(p, 'baz') # remove the tag 'baz' from p if it
is in
the tag list
Internally, tags are stored in
`p.v.unknownAttributes['__node_tags']` as
a set.
UI
==
The Tags tab in the Log pane is the UI for this plugin. The
bar at
the top is a search bar, editable to allow complex search
queries. It
is pre-populated with all existing tags in the outline, and
remembers
your custom searches within the given session. It also acts
double duty
as an input box for the add (+) button, which adds the contents
of the
search bar as a tag to the currently selected node.
The list box in the middle is a list of headlines of nodes which
contain
the tag(s) defined by the current search string. These are
clickable,
and doing so will center the focus in the outline pane on the
selected node.
Below the list box is a dynamic display of tags on the currently
selected node. Left-clicking on any of these will populate the
search
bar with that tag, allowing you to explore similarly tagged nodes.
Right-clicking on a tag will remove it from the currently
selected node.
The status line at the bottom is purely informational.
The tag browser has set-algebra querying possible. Users may
search for
strings like 'foobar', to get nodes with both tags foo and bar, or
'foo|bar' to get nodes with either or both. Set difference (-) and
symmetric set difference (^) are supported as well. These
queries are
left-associative, meaning they are read from left to right, with no
other precedence. Parentheses are not supported. See below for more
details.
Searching
-
Searching on tags in the UI is based on set algebra. The following
syntax is used::
tagtag - return nodes tagged with both the given tags
tag|tag - return nodes tagged with either of the
Re: Initial node tagging support -- functionally complete
Hi Jacob,
missing the tagging capability was the only reason I didn't want to use Leo
for managing my private data over years. Now you have solved the problem.
Thank you for that, but tagging will be an even more powerful feature, if
you would provide tag hierarchies.
Of course, I can already define my tag hierarchy now having a naming
convention like taga/subtag1/subsubtagx, but this is only usable as an
hierarchy if I could search for taga/* and so I would get all subtags of
taga
I would really appreciate it, if you could extend the tag search to a match
with wildcards (*) . I don't think this is a big deal.
Another nice to have feature could be to have the tags in a separate leo
file as an outline, and then apply them like the syntax above (with an
separator like /) to the nodes of other files, but this is not a trivial
thing, I guess.
Best regards
Mehrdad
Am Mittwoch, 6. August 2014 21:47:45 UTC+2 schrieb Jacob Peck:
Hi all,
I've put the last bit of planned functionality into the Tagging UI
(nodetags.py plugin) today. It's available in the latest commit. Here's
the new docstring:
Provides node tagging capabilities to Leo
By Jacob M. Peck
API
===
This plugin registers a controller object to c.theTagController, which
provides the following API::
tc = c.theTagController
tc.get_all_tags() # return a list of all tags used in the current
outline, automatically updated to be consistent
tc.get_tagged_nodes('foo') # return a list of positions tagged 'foo'
tc.get_tags(p) # return a list of tags applied to the node at
position p; returns [] if node has no tags
tc.add_tag(p, 'bar') # add the tag 'bar' to the node at position p
tc.remove_tag(p, 'baz') # remove the tag 'baz' from p if it is in
the tag list
Internally, tags are stored in `p.v.unknownAttributes['__node_tags']` as
a set.
UI
==
The Tags tab in the Log pane is the UI for this plugin. The bar at
the top is a search bar, editable to allow complex search queries. It
is pre-populated with all existing tags in the outline, and remembers
your custom searches within the given session. It also acts double duty
as an input box for the add (+) button, which adds the contents of the
search bar as a tag to the currently selected node.
The list box in the middle is a list of headlines of nodes which contain
the tag(s) defined by the current search string. These are clickable,
and doing so will center the focus in the outline pane on the selected
node.
Below the list box is a dynamic display of tags on the currently
selected node. Left-clicking on any of these will populate the search
bar with that tag, allowing you to explore similarly tagged nodes.
Right-clicking on a tag will remove it from the currently selected node.
The status line at the bottom is purely informational.
The tag browser has set-algebra querying possible. Users may search for
strings like 'foobar', to get nodes with both tags foo and bar, or
'foo|bar' to get nodes with either or both. Set difference (-) and
symmetric set difference (^) are supported as well. These queries are
left-associative, meaning they are read from left to right, with no
other precedence. Parentheses are not supported. See below for more
details.
Searching
-
Searching on tags in the UI is based on set algebra. The following
syntax is used::
tagtag - return nodes tagged with both the given tags
tag|tag - return nodes tagged with either of the given tags (or
both)
tag-tag - return nodes tagged with the first tag, but not the
second tag
tag^tag - return nodes tagged with either of the given tags
(but *not* both)
These may be combined, and are applied left-associatively, building the
set from the left, such that the query `foobar^baz` will return only
nodes tagged both 'foo' and 'bar', or nodes tagged with 'baz', but *not*
tagged with all three.
Tag Limitations
---
The API is unlimited in tagging abilities. If you do not wish to use
the UI, then the API may be used to tag nodes with any arbitrary
strings. The UI, however, due to searching capabilities, may *not* be
used to tag (or search for) nodes with tags containing the special
search characters, `|-^`. The UI also cannot search for tags of
zero-length, and it automatically removes surrounding whitespace
(calling .strip()).
Any comments would be welcome -- thanks!
--Jake
--
You received this message because you are subscribed to the Google Groups
leo-editor group.
To unsubscribe from this group and stop receiving emails from it, send an email
to leo-editor+unsubscr...@googlegroups.com.
To post to this group, send email to leo-editor@googlegroups.com.
Visit this group at http://groups.google.com/group/leo-editor.
For more options, visit https://groups.google.com/d/optout.
Initial node tagging support -- functionally complete
Hi all,
I've put the last bit of planned functionality into the Tagging UI
(nodetags.py plugin) today. It's available in the latest commit. Here's
the new docstring:
Provides node tagging capabilities to Leo
By Jacob M. Peck
API
===
This plugin registers a controller object to c.theTagController, which
provides the following API::
tc = c.theTagController
tc.get_all_tags() # return a list of all tags used in the current
outline, automatically updated to be consistent
tc.get_tagged_nodes('foo') # return a list of positions tagged 'foo'
tc.get_tags(p) # return a list of tags applied to the node at
position p; returns [] if node has no tags
tc.add_tag(p, 'bar') # add the tag 'bar' to the node at position p
tc.remove_tag(p, 'baz') # remove the tag 'baz' from p if it is in
the tag list
Internally, tags are stored in `p.v.unknownAttributes['__node_tags']` as
a set.
UI
==
The Tags tab in the Log pane is the UI for this plugin. The bar at
the top is a search bar, editable to allow complex search queries. It
is pre-populated with all existing tags in the outline, and remembers
your custom searches within the given session. It also acts double duty
as an input box for the add (+) button, which adds the contents of the
search bar as a tag to the currently selected node.
The list box in the middle is a list of headlines of nodes which contain
the tag(s) defined by the current search string. These are clickable,
and doing so will center the focus in the outline pane on the selected node.
Below the list box is a dynamic display of tags on the currently
selected node. Left-clicking on any of these will populate the search
bar with that tag, allowing you to explore similarly tagged nodes.
Right-clicking on a tag will remove it from the currently selected node.
The status line at the bottom is purely informational.
The tag browser has set-algebra querying possible. Users may search for
strings like 'foobar', to get nodes with both tags foo and bar, or
'foo|bar' to get nodes with either or both. Set difference (-) and
symmetric set difference (^) are supported as well. These queries are
left-associative, meaning they are read from left to right, with no
other precedence. Parentheses are not supported. See below for more
details.
Searching
-
Searching on tags in the UI is based on set algebra. The following
syntax is used::
tagtag - return nodes tagged with both the given tags
tag|tag - return nodes tagged with either of the given tags (or
both)
tag-tag - return nodes tagged with the first tag, but not the
second tag
tag^tag - return nodes tagged with either of the given tags
(but *not* both)
These may be combined, and are applied left-associatively, building the
set from the left, such that the query `foobar^baz` will return only
nodes tagged both 'foo' and 'bar', or nodes tagged with 'baz', but *not*
tagged with all three.
Tag Limitations
---
The API is unlimited in tagging abilities. If you do not wish to use
the UI, then the API may be used to tag nodes with any arbitrary
strings. The UI, however, due to searching capabilities, may *not* be
used to tag (or search for) nodes with tags containing the special
search characters, `|-^`. The UI also cannot search for tags of
zero-length, and it automatically removes surrounding whitespace
(calling .strip()).
Any comments would be welcome -- thanks!
--Jake
--
You received this message because you are subscribed to the Google Groups
leo-editor group.
To unsubscribe from this group and stop receiving emails from it, send an email
to leo-editor+unsubscr...@googlegroups.com.
To post to this group, send email to leo-editor@googlegroups.com.
Visit this group at http://groups.google.com/group/leo-editor.
For more options, visit https://groups.google.com/d/optout.
Re: Initial node tagging support -- functionally complete
Thank-you for this.
Chris
On Wednesday, August 6, 2014 12:47:45 PM UTC-7, Jacob Peck wrote:
Hi all,
I've put the last bit of planned functionality into the Tagging UI
(nodetags.py plugin) today. It's available in the latest commit. Here's
the new docstring:
Provides node tagging capabilities to Leo
By Jacob M. Peck
API
===
This plugin registers a controller object to c.theTagController, which
provides the following API::
tc = c.theTagController
tc.get_all_tags() # return a list of all tags used in the current
outline, automatically updated to be consistent
tc.get_tagged_nodes('foo') # return a list of positions tagged 'foo'
tc.get_tags(p) # return a list of tags applied to the node at
position p; returns [] if node has no tags
tc.add_tag(p, 'bar') # add the tag 'bar' to the node at position p
tc.remove_tag(p, 'baz') # remove the tag 'baz' from p if it is in
the tag list
Internally, tags are stored in `p.v.unknownAttributes['__node_tags']` as
a set.
UI
==
The Tags tab in the Log pane is the UI for this plugin. The bar at
the top is a search bar, editable to allow complex search queries. It
is pre-populated with all existing tags in the outline, and remembers
your custom searches within the given session. It also acts double duty
as an input box for the add (+) button, which adds the contents of the
search bar as a tag to the currently selected node.
The list box in the middle is a list of headlines of nodes which contain
the tag(s) defined by the current search string. These are clickable,
and doing so will center the focus in the outline pane on the selected
node.
Below the list box is a dynamic display of tags on the currently
selected node. Left-clicking on any of these will populate the search
bar with that tag, allowing you to explore similarly tagged nodes.
Right-clicking on a tag will remove it from the currently selected node.
The status line at the bottom is purely informational.
The tag browser has set-algebra querying possible. Users may search for
strings like 'foobar', to get nodes with both tags foo and bar, or
'foo|bar' to get nodes with either or both. Set difference (-) and
symmetric set difference (^) are supported as well. These queries are
left-associative, meaning they are read from left to right, with no
other precedence. Parentheses are not supported. See below for more
details.
Searching
-
Searching on tags in the UI is based on set algebra. The following
syntax is used::
tagtag - return nodes tagged with both the given tags
tag|tag - return nodes tagged with either of the given tags (or
both)
tag-tag - return nodes tagged with the first tag, but not the
second tag
tag^tag - return nodes tagged with either of the given tags
(but *not* both)
These may be combined, and are applied left-associatively, building the
set from the left, such that the query `foobar^baz` will return only
nodes tagged both 'foo' and 'bar', or nodes tagged with 'baz', but *not*
tagged with all three.
Tag Limitations
---
The API is unlimited in tagging abilities. If you do not wish to use
the UI, then the API may be used to tag nodes with any arbitrary
strings. The UI, however, due to searching capabilities, may *not* be
used to tag (or search for) nodes with tags containing the special
search characters, `|-^`. The UI also cannot search for tags of
zero-length, and it automatically removes surrounding whitespace
(calling .strip()).
Any comments would be welcome -- thanks!
--Jake
--
You received this message because you are subscribed to the Google Groups
leo-editor group.
To unsubscribe from this group and stop receiving emails from it, send an email
to leo-editor+unsubscr...@googlegroups.com.
To post to this group, send email to leo-editor@googlegroups.com.
Visit this group at http://groups.google.com/group/leo-editor.
For more options, visit https://groups.google.com/d/optout.
