TOC within tiddler

[Scott Mead]

Hey all, 

   I love TiddlyWiki!  I love that it's self-contained and gives me what I need to keep my personal knowledgebase Organized.  

   I'm looking for a feature now that evernote doesn't have, I *think* TiddlyWiki does, I just can't find it in the doc.

   I frequently write technical documentation, a lot of times to be consumed by others.  I've really come to love Markdown for this task and I rely heavily on click-able TOC's that are auto-updated based on my headings:

H1

  H2

    H3

H1

  H2

H1

etc... 

  I've gotten a lot of traction with the tag-based TOC lately, but, it's a lot of overhead for what I'm trying to do.  Is it possible to create a TOC within a single tiddler so that I can click the link and be taken to that section?

Thanks

--Scott

[Eric Shulman]

On Tuesday, April 12, 2016 at 11:11:08 AM UTC-7, Scott Mead wrote:

Hey all, 

   I frequently write technical documentation, a lot of times to be consumed by others.  I've really come to love Markdown for this task and I rely heavily on click-able TOC's that are auto-updated based on my headings:

H1

  H2

    H3

H1

  H2

H1

  I've gotten a lot of traction with the tag-based TOC lately, but, it's a lot of overhead for what I'm trying to do.  Is it possible to create a TOC within a single tiddler so that I can click the link and be taken to that section?

TW5 does not have the concept of addressable "sections" of a tiddler.  Thus there is no support for defining a link that "takes you to a section" of a tiddler, nor is there the ability to automatically scroll to a location within a rendered tiddler.

While you can create large tiddlers with entire "documents" in each, that's not the way that TiddlyWiki is intended to work.  Rather, tiddlers are supposed to be the *smallest* effective units of information... i.e., a few paragraphs of text, an embedded image, or even just a single word value... depending on the use case.  Larger blocks of information are then assembled from the small pieces, using transclusion, macros, list widgets, etc.  The <<toc>> macro is an example of a macro that works in this way.

-e

[Evolena]

I have the feeling that something could be done with the concept of substories (using the navigatorWidget).

You can open links inside the substory. You can also have a list of the tiddlers opened in the substory by adding for example

{{{[list[MySubStoryList]]}}}

just below the navigator widget.

However... once opened in the substory, a tiddler cannot be navigated to with links...
So it is very near a section approach, except that the navigation doesn't work inside the substory.
The substory history list does have tiddler positions, so something could probably be done, but I don't know what.