(TW5) How to create Tabbed Internal TOC

[Jon]

Hi, 

I've looked at tiddliwiki.com about the Tabbed Internal style for a Table of Contents but I can't understand how to actually do it.

Can anyone point me in the right direction?

Regards

Jon

[Mark S.]

Your question is a little vague. What exactly don't you understand?

If you take the sample code and put it into your own TW file:

<$macrocall
        $name="toc-tabbed-internal-nav"
        tag="TableOfContents"
        selectedTiddler="$:/temp/toc/selectedTiddler"
        unselectedText="<p>Select a topic in the table of contents. Click the arrow to expand a topic.</p>"
        missingText="<p>Missing tiddler.</p>"
/>

but change tag="TableOfContents" to whatever your top-level tiddler is, then it should form the TOC for you automatically.

Just keep in mind that the TOC macros are based on a tag-tree. That means each tiddler is the name of a tag which is used by the "children" tiddlers. And each of those children in turn are names of tags used by their "children". These relationships can be formed easily starting from your top tiddler by using the "new here" option available from the drop-down menu of each tiddler. The "new here" menu item will create a new tiddler tagged with the name of the current tiddler.

Have fun

-- Mark

[Jon]

Hi Mark,

I was trying not to be too critical of the information on Tiddlywiki.com as I am forever grateful for this tool and all the hard work that goes into the development by JR and everyone on here.

When you ask what is it I don't understand, I realise I'm approaching this from a different point of view - i.e. I'm going over to the site for some instructions in terms of how to do something rather than understand it.

I've seen the result which I want to reproduce in my own wiki  - so how do I do that?

I've got no computer/coding knowledge so I'll never really 'understand' how it works - I just want to copy & paste and make it happen.

Sorry if that sounds lazy, but I'm sure there are loads of people who come across TW with the same aims as me but get frustrated at the simple lack of instruction and give up.

Sometimes, all it would take would be a few more explanatory lines to point people in the right direction.

But again, I don't want to seem ungrateful.

Anyway, back to your original question, when I had previously pasted the text into my wiki, it showed my existing TOC but when I changed "TableOfContents" to the name of any tiddler, I was just left with a partial version of the existing TableOfContents.

I'll play around with it some more with what you've said.

Cheers

Jon

[Mark S.]

On Tuesday, December 11, 2018 at 10:43:22 AM UTC-8, Jon wrote:

Anyway, back to your original question, when I had previously pasted the text into my wiki, it showed my existing TOC but when I changed "TableOfContents" to the name of any tiddler, I was just left with a partial version of the existing TableOfContents.

You can't just point at any tiddler. There has to be a "tree" of tagged tiddlers, with the "root" tiddler at the top. Like

   MyTiddler

       TiddlerA (tagged with MyTiddler)

           TiddlerA-1 (tagged with TiddlerA)

       TiddlerB (tagged with MyTiddler)

          TiddlerB-1 (tagged with TiddlerB)

Hopefuly GG won't mangle that too badly. So, are your tiddlers structured as tag-trees ? Only tiddlers that are part of the tree will show up.

Good luck

-- Mark

[Jon]

Got it!

Thanks for your help Mark.

As has been said before, it's a shame this instruction now gets sort of lost.

Jon.

[Jeremy Ruston]

Just a reminder that as of the release of v5.1.18 we plan to maintain the ability to issue rapid updates to the documentation that won’t need to wait for the next release.

Best wishes

Jeremy

-- 
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 https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/47ba1e8e-5fb5-4d2e-a921-a83a436c7380%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[Mark S.]

Hi Jeremy,

Is there a new on-ramp for documentation, or is it still via the GitHub PR process?

Thanks!

-- Mark

[Jeremy Ruston]

Hi Mark

The process will be the same for contributors at this point.

Best wishes

Jeremy.

To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/f5a025e0-8c96-4892-a006-4f3ec2aa0f29%40googlegroups.com.

[Mark S.]

@Jon

Ok! Great that it's working for you. Some feedback might be useful.

I'm looking at "Table-of-Contents Macros" on TiddlyWiki.com, which ideally would have been your first stop when studying the TOC macros.

What do you think should have been in the document there that would have been more helpful?

Thanks!

-- Mark

[Jon]

Hi Mark,

It's a long time since I've looked at TW.com for instruction but when I looked at the section on creating a TOC in the sidebar, the instructions for doing that are all there and explain it very clearly from one step to the next - fabulous!

If the same can be applied to the Internal/External tabbed style (with perhaps an explanation of the difference between these two) then that would have ticked all the boxes for me.

If I'd seen the first set of instructions yesterday, I wouldn't have been as frustrated, thinking the lack for this style, was representative of the whole site.

Regards

Jon

[S. S.]

Work in progress with the aim to include it on TW.com: Table of Contents for Beginners

[Mohammad]

Great stuff.

Hope you improve and finish it! It is good to announce it in a separate post and also ask Dave Gifford add to TW toolmap.

-Mohammad

[TonyM]

SS

Looks great for beginners.

I just wanted mention, although It is not for beginners but TOC like hierarchies operates using "recursion" where a macro calls itself, as many times as needs be.

It perhaps could belong in another place for beginners along with sequence, iteration and selection which I have written on previously.

Good work, just what our beginners need.

Regards

Tony