saqimtiaz / streams

TiddlyWiki plugin for rapid data entry with a keyboard driven workflow. Divide content into smaller tiddlers as you write.
BSD 3-Clause "New" or "Revised" License
58 stars 6 forks source link

Improve breadcrumbs to not abridge words #23

Open saqimtiaz opened 3 years ago

saqimtiaz commented 3 years ago

From https://groups.google.com/g/tiddlywiki/c/-xTFWPwzq6g/m/K98n6_NZAgAJ

I have made the following tweak to the text display for the breadcrumbs. It's a very minor thing, but in my opinion looks nicer than just cutting off the title mid-word:

<$text text={{{ [<display-title>length[]compare:number:lt[40]then<display-title>] ~[<display-title>split[]first[40]join[]trim[]addsuffix[...]] }}}/>

That is definitely a nice idea. I wonder if we might take it a step further and just drop the last word (which may be incomplete). This is untested:

<$text text={{{ [<display-title>length[]compare:number:lt[40]then<display-title>] ~[<display-title>split[]first[40]join[]trim[]search-replace:g:regexp[(.*)\s(\w+)$],[$1]] }}}/>

saqimtiaz commented 3 years ago

Improvements on the filter expression:

[[Unlike conventional online services, TiddlyWiki lets you choose where to keep your data, guaranteeing that in the decades to come you will still be able to use the notes you take today.]search-replace:g:regexp[(.{40}).*],[$1]search-replace:g:regexp[(.*)\s(\w+)$],[$1]]

or

[[Unlike conventional online services, TiddlyWiki lets you choose where to keep your data, guaranteeing that in the decades to come you will still be able to use the notes you take today.]search-replace:g:regexp[^(.{30,45})\s.*$],[$1]]

The latter is potentially more brittle if there is no word boundary between 30th and 45th character.

saqimtiaz commented 3 years ago

Can also check for only whitespace in the text body and avoid the recursive macro while we are at it:


\whitespace trim
\define stream-show-breadcrumbs()
<$list filter="[<currentTiddler>has[stream-type]]">
    <$list filter="[<currentTiddler>get-stream-root:includeall[]]">
        <$wikify name="display-title" text={{{ [<currentTiddler>!is[binary]get[text]trim[]!is[blank]] ~[{!!title}] }}}>
            <span class="sq-breadcrumbs-fragment">
            <$link to=<<currentTiddler>>>
                <$text text={{{ [<display-title>split[]first[50]join[]] }}}/>
            </$link>>
            </span>
        </$wikify>
    </$list>
</$list>
\end
<$list filter="[{$:/config/sq/streams/enable-breadcrumbs}match[yes]]" variable="_NULL">
<<stream-show-breadcrumbs>>
</$list>

This does not include the above breadcrumb improvements. Also, use :reduce.

zhangxiubo commented 3 years ago

One thing I have noted when tweaked this macro myself for improved readability was that just testing whether text field is blank can occasionally lead to a blank fragment when the wikified text field is "effectively" blank, e.g. when the tiddler only contains a image tag or some macros.

To circumvent the issue, I prepared a regex pattern that detects some common non-blank content. The breadcrumb shall only fall back to using the title field if the text field appears to contain effectively blank content:

<$set name="pattern" value="^\s*(\w|\[\[|`|''|//|__)">
  <$wikify name="display-title" text={{{ [<currentTiddler>!is[binary]regexp:text<pattern>get[text]] ~[{!!title}] }}}>
    <span class="sq-breadcrumbs-fragment">
    <$link to=<<currentTiddler>>>
      <$text text={{{ [<display-title>split[]first[50]join[]] }}}/>
    </$link>>
    </span>
  </$wikify>
</$set>
saqimtiaz commented 3 years ago

@zhangxiubo thank you for the input, it is very helpful.

You have helped me to realize that there is a better way to check for blank fragments, since wikify will always return plain text. So we should check if the text is blank after we wikify. This will be more reliable and accurate than a regular expression.

Something like this (untested):


<$wikify name="display-title" text={{{ [<currentTiddler>!is[binary]get[text]trim[]] }}}>
    <span class="sq-breadcrumbs-fragment">
    <$link to=<<currentTiddler>>>
        <$text text={{{ [<display-title>!is[blank]else<currentTiddler>split[]first[50]join[]] }}}/>
    </$link>>
    </span>
</$wikify>
zhangxiubo commented 3 years ago

@saqimtiaz That's definitely a better solution!