Hi everyone,
I made some changes to tobibeer/split
<http://tobibeer.github.io/tw5-plugins/#split>:
1. It can now retrieve titles by parsing any stringified list or list
fields.
2. I modified the *prefix* and *suffix* syntax in a
*non-backwards-compatible* way.
- I only decided to do that, because *split* has not been around for
very long yet.
- So, please excuse my being this blunt!
Get version 0.7.0 <https://github.com/tobibeer/tw5-split/releases/tag/0.7.0>
for tobibeer/split <http://tobibeer.github.io/tw5-plugins/#split> here:
- http://tobibeer.github.io/tw5-plugins/#split
Compatibility
Should you be using tobibeer/split
<http://tobibeer.github.io/tw5-plugins/#split> by now,
please check if you need to fix the (introduced) compatibility issue
by updating any occurrences using a *prefix *or *suffix* like so:
- +(prefix)to:
+\prefix\
- (suffix)+ to:
\suffix\+
I did this so as to keep round brackets out of the operand *suffix* and
make room for this issue:
*#2122 Allow Operand Listings to Include 'Titles With Spaces'*
https://github.com/Jermolene/TiddlyWiki5/issues/2122
Lists
I decided to add list parsing capabilities to the *split* filter,
since it already implements a lot of goodies to further do something with
retrieved titles.
So, the *split* filter can now...
1. interpret the operand <http://tiddlywiki.com/#Filter%20Parameter>,
especially "soft" operands, as a stringified list and split that into
listed titles
2. operate on titles from the *list* field of any input titles
3. operate on titles in any *list* field of given input titles
Examples:
- [split:list{SomeTiddler!!some-field}]
- interprets *some-field* of *SomeTiddler* as a list field (comparable
to the *tags *or list field) and splits that into its titles
- [split:list<some-variable>]
- splits *some-variable* into titles, likewise interpreting its contents
as a stringified list
-
- [split:list{MyData##some-index}]
- splits *some-index* in the data tiddler *MyData* into titles, again
interpreting the contents as a stringified list
-
- [tag[Foo]split:list[]]
- retrieves the *list* field of *all tiddlers* tagged *Foo*, however
*allowing* duplicates
- use the suffix *unique *to enforce uniqueness: [tag[Foo]split:list
unique[]]
- [tag[Foo]split:list=bar[]]
- retrieves list field *bar* of all tiddlers tagged *Foo*
- you can combine this with other *split* options, e.g.:
- [tag[Foo]split:list=bar first[]]
- retrieves only the *first* item in the list field *bar* of
each tiddler tagged *Foo*
In other words, using the *split* filter with the *list* suffix possibly is
how you may have wanted the core *list[]* filter
<http://tiddlywiki.com/#list%20Operator> to behave.
For more details on using lists, see...
- syntax
- http://tobibeer.github.io/tw5-plugins/#split-Lists
- examples
- http://tobibeer.github.io/tw5-plugins/#split-Examples
Best wishes,
Tobias.
--
You received this message because you are subscribed to the Google Groups
"TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit
https://groups.google.com/d/msgid/tiddlywiki/1912b088-5b2a-4b60-b40e-5b9fa1a18f5b%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
