Prerelease of 5.1.8

[Jeremy Ruston]

I'm about to be away from the mailing list for a couple of weeks, so I thought it might be useful to draw attention to the current prerelease of the 5.1.8, the upcoming version of TiddlyWiki:

http://tiddlywiki.com/prerelease

Hopefully it goes without saying, but please don't start using the prerelease for anything important.

Besides the changes enumerated in the release note, there are many, many updates to the documentation, thanks to an enormous effort by many people, led by Astrid Elocson and Tobias Beer. My gratitude to everyone involved.

Please take some time to have a look through the new documentation. We would welcome comments and of course contributions. More and more people are managing to brave GitHub to make contributions, and it makes an enormous difference.

Comments and questions welcome,

Best wishes

Jeremy.

--

Jeremy Ruston
mailto:jeremy...@gmail.com

[Felix Küppers]

Hi Jeremy,

I'm about to be away from the mailing list for a couple of weeks,

Just to be clear, does this also include being away from github and not accepting pull requests or handling issues?

And congrats on the over 1000 Github stars :)

-Felix

[Astrid Elocson]

> there are many, many updates to the documentation

And be aware that further changes* to the documentation of filter syntax are in the pipeline – including a thorough overhaul of the step-by-step introduction – but my incompetence with the Git command line meant that these narrowly missed making it into the new prerelease.

* https://github.com/Jermolene/TiddlyWiki5/pull/1360

Git is rightly named :)

– æ

[Felix Küppers]

@Astrid, Great job on the railroad plugin. It is a nice addition.

-Felix

[Jeremy Ruston]

Hi Felix

Just to be clear, does this also include being away from github and not accepting pull requests or handling issues?

Yes, I'll be away from GitHub, too, I'm afraid. But looking forward to getting back to a lots of well-polished pull requests :)

 

And congrats on the over 1000 Github stars :)

Thank you. Now for the next 999,000 stars...

Best wishes

Jeremy

 

-Felix

[Tobias Beer]

@Astrid, Great job on the railroad plugin. It is a nice addition.

And, a highly usefule one at that, I must say.

Best wishes, Tobias. 

[Tobias Beer]

999,000 stars...

in theoretical physics, that comes close to an all-fed-up-blackish-hole type of nonexistent fictional entity :D 

Best wishes, Tobias.

[Felix Küppers]

Hi Jeremy,
 

Yes, I'll be away from GitHub, too, I'm afraid. But looking forward to getting back to a lots of well-polished pull requests :)

Hehe, then I look forward to having you back soon :) Sometimes I am scared that the truck factor is pretty high for tiddlywiki. So please stay healthy and alive.
 

 Thank you. Now for the next 999,000 stars...

Great attitude! Let's reach for the stars.

-Felix

[Jeremy Ruston]

I've uploaded a new prerelease that incorporates the latest pull requests from Astrid:

http://tiddlywiki.com/prerelease

Best wishes

Jeremy

[Astrid Elocson]

Awesome, Jeremy. Many thanks.

– æ

[Alex Hough]

Astrid,

love the railroad stuff, thank you

Alex

On 12 January 2015 at 08:46, Astrid Elocson <aelo...@gmail.com> wrote:

Awesome, Jeremy. Many thanks.

– æ

--
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 tiddlywiki+...@googlegroups.com.
To post to this group, send email to tiddl...@googlegroups.com.
Visit this group at http://groups.google.com/group/tiddlywiki.
For more options, visit https://groups.google.com/d/optout.

[Tobias Beer]

railroads => awesome usefulness

Best wishes, Tobias.

[Astrid Elocson]

I've just added a feature that I think greatly improves the readability of the railroad diagrams. Where the diagram loops back on itself, it now has an arrow to make it clear that the track runs from right to left at that point.

http://ae-railroad.tiddlyspot.com/

The arrow can be turned off by setting the $railroad widget's arrow attribute to "no".

– æ

[Tobias Beer]

http://ae-railroad.tiddlyspot.com/
The arrow can be turned off by setting the $railroad widget's arrow attribute to "no".

Who would ever want to turn that off? ^^

Best wishes, Tobias. 

[Astrid Elocson]

Indeed. But the author of the JavaScript library underlying the widget was aiming to reproduce the appearance of the railroad diagrams on the JSON site, and those lack arrows. So the widget makes the arrows optional.

– æ

[Tobias Beer]

Indeed. But the author of the JavaScript library underlying the widget was aiming to reproduce the appearance of the railroad diagrams on the JSON site, and those lack arrows. So the widget makes the arrows optional.

Sure, technically you don't need them.

It just pops out quite nicely.

They could even be shorter,

if that's feasible.

Best wishes, Tobias.

[Astrid Elocson]

Hi Tobias,

> They could even be shorter, if that's feasible.

Good idea – done.

The shorter arrow also means I no longer need to artificially increase the height of the backward arc to avoid a cramped appearance.

– æ

[Branimir Braykov]

Railroad looks pretty much to what Oracle Docs are using. Extremely useful. I will now use it to document my shell scripts with options and parameters.

Thank you.

[Astrid Elocson]

Hi Branimir,

You're very welcome.

Note, if it's not already obvious, that the diagrams' colours, line thicknesses, etc can be adjusted via CSS. The plugin contains a default CSS tiddler.

Do people like the default colour scheme? It's simply what came with the underlying diagram library, but could be modified if desired.

– æ

[Tobias Beer]

Do people like the default colour scheme? It's simply what came with the underlying diagram library, but could be modified if desired.

If that is the case, I certainly wouldn't make t black.

Here's what I would do...

svg.railroad-diagram path,
svg.railroad-diagram rect {
stroke-width: 2;
stroke: #333;
}

svg.railroad-diagram path.arrow {
stroke-width: 2;
}

It's a bit of a bummer that the text is actually controlled via stroke and stroke-width,

but well, there's gotta be some limitations. ;-)

...or can that be wrapped in something with a class "text"?

Best wishes, Tobias.

[Tobias Beer]

Perhaps a wee less background?

...adding some back on-hover.

svg.railroad-diagram {
background-color: hsl(30,20%,98%);
border-radius: 5px;
}

svg.railroad-diagram:hover {
background-color: hsl(30,20%,96%);
}

Best wishes, Tobias.

[Astrid Elocson]

Hi Tobias,

Thanks for those CSS suggestions. They're great improvements, that make the diagrams feel much less heavy and clunky.

> It's a bit of a bummer that the text is actually controlled via stroke and stroke-width

Eh? It's an SVG text element, controlled by normal CSS font properties. I've removed the bold setting.

The result can be seen at http://ae-railroad.tiddlyspot.com/

– æ

[Tobias Beer]

Eh? It's an SVG text element, controlled by normal CSS font properties. I've removed the bold setting.

The result can be seen at http://ae-railroad.tiddlyspot.com/

An oversight...

I could swear I saw the text change too when I changed that stroke width of the rect.

Mysterious. ^^

Best wishes, Tobias.