Reusing the TW5 official site's documentation macros

[Hegart Dmishiv]

While I'm in the process of developing my own suite of templates for my implementation of TW, I might as well take advantage of things that have already been done by others, rather than reinventing the wheel. One thing I've come across that I really like the look of is the Documentation Macros listed on the official TW5 website. I tried invoking one of them in my own TW wiki, but the underlying macro clearly isn't installed by default.

To try to get them to work, I have tried just copying the contents of http://tiddlywiki.com/#$:/editions/tw5.com/doc-macros and http://tiddlywiki.com/#$:/editions/tw5.com/doc-macros to my own TW wiki as new tiddlers with the same names. I also copied http://tiddlywiki.com/#Documentation Macros to my own TW wiki. Some, but not all, of the examples on that page on my TW wiki are showing properly. It seems I'm missing some other dependencies, but I cannot work out which ones are required. Can anyone point me in the right direction please?

[PMario]

Hi Hegart,

if you import: http://tiddlywiki.com/#%24%3A%2Feditions%2Ftw5.com%2Fdoc-styles too, it will fix the styling problems. ... There may be other things missing. ... I didn't run a full test. but the styling looked ok for me.

have fun!
mario

[Hegart Dmishiv]

On Monday, September 14, 2015 at 11:41:05 PM UTC+12, PMario wrote:

Hi Hegart,

if you import: http://tiddlywiki.com/#%24%3A%2Feditions%2Ftw5.com%2Fdoc-styles too, it will fix the styling problems. ... There may be other things missing. ... I didn't run a full test. but the styling looked ok for me.

Sorry, my second link in the previous post was supposed to be for http://tiddlywiki.com/#$:/editions/tw5.com/doc-styles but it seems to have inserted the same link twice. I have both of those macro tiddlers in my online (dev) wiki, but the #Documentation Macros demonstration tiddler still doesn't have all the formatting showing properly, with some, such as .flink, .keycombo, and .toc-tab not displaying at all. I must be missing some other dependency.

[Evolena]

You may also need $:/editions/tw5.com/if-macro.js

[Hegart Dmishiv]

On Tuesday, September 15, 2015 at 12:48:37 AM UTC+12, Evolena wrote:

You may also need $:/editions/tw5.com/if-macro.js

Thanks, I've added that one now too, but the three examples I mentioned in my previous post, .flink, .keycombo, and .toc-tab are still not displaying at all.

[Pau Deluca]

.keycombo seems to work fine for me

.toc-tab works fine as well since I created a TableOfContents tab in the SideBar (http://tiddlywiki.com/#How%20to%20add%20a%20new%20tab%20to%20the%20sidebar)

.flink only works with ListField (<<.flink ListField>>) Any other field linked gives no display at all. I don't know why. If I open http://tiddlywiki.com/#TiddlerFields, I see there that only the tiddler ListField exists. All the rest XxField are missing tiddlers. I thought this could be the reason, bu If I create, for instance, a TitleField tiddler, .flink won't work with that field name either. Any idea about why is .flink not working but with ListField?

[Birthe C]

The tiddler ListField has a field caption and value list.  Use another tiddlername and see the link to the content i the caption field.

Birthe

[Pau Deluca]

Thank you Birthe. I still need to train my eyes :)

I've tried making a tiddler named TitleField tagged as Fields and "Title" as the value of caption-field and <<.flink TitleField>> now works fine. This explains me why it didn't work before and I think this gives Hegart a proper reply, as well as it puts a new item in the to-do list for those working on TW documentation.

Thank you again.
P.-)