toc2 -- Full url in links | #skip tag to skip headers from being inserted

[jfbercher]

• [toc2] with github html preview #1023 - add full URL in links

• [toc2] Distinguish between (unnumbered) title and (numbered) section headings #1027 - add a #skip tag for skipping header insertion in toc. Just put

## This is a title #skip

and this will be rendered as

This is a title

without numbering and will not be inserted in toc.

[jcb91]

ah, I hadn't understood your #skip suggestion, then! I think I prefer the other implementation though, so as not to add weird tags for people opening the notebook without toc2 enabled...

[jfbercher]

think I prefer the other implementation though, so as not to add weird tags for people opening the notebook without toc2 enabled...

Yes, you are right with that. Let's go with the other solution.

--

[jfbercher]

I pushed a variant where any html tag with class "tocSkip" will prevent the corresponding header to be numbered and inserted in toc.

• This tag will not be displayed if the toc2 extension is not present,
• this can be employed at any heading level, as many times as necessary ,
• this will not affect conversion to eg LateX (html tags are removed).

An example is as follows

## A title <a class='tocSkip'>

which will be displayed as

A title

[jcb91]

I pushed a variant where any html tag with class "tocSkip" will prevent the corresponding header to be numbered and inserted in toc

Looks like a good plan to me. This can also work in parallel with the automatic solution I've implemented in #1029, I think?

[jcb91]

Although, line 537 should be amended to not include the skipped headers in calculating the numbering levels

[jcb91]

ok, I'm going to merge this as is, then address line 537 in #1027, since both approaches should work in parallel

[parthi2929]

Hi

Adding <a class='tocSkip'> kind of looks hacky and not many could be aware. Instead, some short hand like #* could be used?