ROS Resources: Documentation | Support | Discussion Forum | Index | Service Status | ros @ Robotics Stack Exchange
Ask Your Question

Error in wiki tutorial template. <Table of content> macro doesn't include <TutorialCSHeaderTemplate> Header

asked 2012-11-27 05:03:05 -0600

updated 2012-11-27 09:52:25 -0600

Hi, I'm currently writing a tutorial and i've found that in template given, there are two macros in this order:

<< IncludeCSTemplate(TutorialCSHeaderTemplate)>>
<< TableOfContents(5)>>

The first one, adds a header (with number '1.'), then in my content I add another header and this is indexed as '2.', but in the table of contents, it starts counting from my header as '1.' and so on.

Reading about macros, I think this is due to << IncludeCSTemplate() >> doesn't set 'generates_headings' to True in order to be included in Table of contents.

A solution could be to write a new template setting this parameter to true, but I think would be better to correct this issue in the existent macro, if this is the problem.

Anyone have another solution to this?


@dornhege As you said, the template creates a header, description, level, notes, etc... But that header starts as '1. templateHeader' and next headers will be '2. myHeaderBla', '3.AnotherHeaderFoo'.

But in the Table of Contents template, the header generated by the HeaderTemplate does not appear. Instead of this, the numeration starts with '1.myHeaderBla', '2.AnotherHeaderFoo'. This is just a issue of page view.

edit retag flag offensive close merge delete


I see, what you mean. That seems wrong. When using Level 3 headers (===), the TOC seems to strip the higher level an numerates the subsections 1.1, 1.2 as 1, 2. Maybe this is the intended usage.

dornhege gravatar image dornhege  ( 2012-11-27 22:18:25 -0600 )edit

1 Answer

Sort by ยป oldest newest most voted

answered 2012-11-27 05:27:37 -0600

dornhege gravatar image

I'm not really sure, what you want to achieve, but if you just want the headings in the tutorial to look nice, use the == section blah == syntax.

The template creates the tutorial header with description, tutorial level, etc. Do you want multiple of those in one tutorial?

edit flag offensive delete link more

Question Tools


Asked: 2012-11-27 05:03:05 -0600

Seen: 155 times

Last updated: Nov 27 '12