Issue: TOC Placement

Issue Tools
- View Changes

July 4, 2009 11:47 AM

tommythejoat

Regular Member

TOC Placement

Placing the toc command at the bottom of the article still leaves it at the top.

If the toc command is placed at the bottom of the text, it results in two copies of the toc. One immediately after the first heading and the second at the bottom of the text.

If the toc command has an argument, it is placed in the normal position even though the command was entered at the bottom of the text.

Documentation is needed for multiple modifiers of the toc command. Should the command be used multiple times, or are the value arguments separated by "|" as in other multiple argument commands.

We tried using [toc]no[/toc] at the top with [toc]nonum[/toc] at the bottom with no toc appearing. When we add [toc]force[/toc] to the bottom, the toc appears at the top.

Here is a link to the article we have been experimenting with.

Issue Details

Issue Number 659

Issue Type Feature

Project VaultWiki 3.x Series

Category BB-Code Parsing

Status Implemented

Priority 5 - Minor Bugs / Small Tweaks

Suggested Version 2.3.1

Implemented Version 2.3.2

Milestone (none)

Software DependencyAny

Votes for this feature 0

Votes against this feature 0

Attachments 1

Assigned Users (none)

Tags (none)

July 4, 2009 12:55 PM

pegasus

VaultWiki Team

This is working as designed. In Special:WikiCodeList, it says the following:

The tag [toc] can customize how an article's table of contents is displayed. It takes one or no pre-defined flags as a value. Normally, the table of contents will appear below the first paragraph when there are at least four (4) sections created using [h].

It goes on to list the flags along with their functions, and finally says that [toc][/toc] (no flags) "places a table of contents at the current position".

As a feature request, we can add the capability to include multiple flags using "|", but this is Not a Bug. This functionality has been added for the next build by replacing the function handle_bbcode_toc in vault/special_class_bbcode.

Reply
July 6, 2009 11:46 AM

tommythejoat

Regular Member

This is not a high priority for us, but it is sometimes useful to place the unnumbered table of contents at a position other than the top. As it works now, that does not seem to be possible.

If TOC is given one argument can multiple occurrences of TOC be present in the same article? Your statement above and the wiki codes article do not make this clear, in my opinion. A short sentence on the effect of multiple occurrences would settle the issue.

Reply
July 6, 2009 1:10 PM
pegasus

VaultWiki Team
You can do the following:

Code:

[noparse] [comment]Stop the TOC from appearing at the top[/comment] [toc]NO[/toc] [comment]Un-number the TOC[/comment] [toc]NONUM[/toc] [comment]Place the un-numbered TOC here[/comment] [toc][/toc][/noparse]

Like any BB-Code, it can be used multiple times with different values. However, the flags used will affect all TOCs, so you can't have a regular TOC and a NONUM TOC in the same article.
Reply
July 6, 2009 4:13 PM

tommythejoat

Regular Member

I see it is now implemented, but I wanted to show what the current behavior is with a single TOC no argument placed in the middle of the article does.

update=============

The use of the no form of toc at the top does not affect the behavior in the screen snapshot.

Reply

+ Reply

All times are GMT -4. The time now is 7:00 AM.

This site uses cookies to help personalize content, to tailor your experience, and to keep you logged in if you register.
By continuing to use this site, you are consenting to our use of cookies.

Learn more… Accept Remind me later

Welcome to VaultWiki.org, home of the wiki add-on for vBulletin and XenForo!

Issue: TOC Placement

Issue Tools