PageOutline macro should have an option to specify whether the outline is numbered

[Ryan J Ollos <ryano@…>]

The PageOutline macro numbers the items in the outline by default, as seen in the example that follows. It seems desirable to have this behavior controlled by a macro argument.

This would be particularly useful when the macro is used with the ​th:NumberedHeadlinesPlugin, since numbered headlines already have the sections numbered.

[[PageOutline(2-5,Contents,inline)]]
= Section 1 =
== Section 1.1 ==
=== Section 1.1.1 ===
==== Section 1.1.1.1 ====
==== Section 1.1.1.2 ====
=== Section 1.1.2 ===
== Section 1.2 ==

Contents

1. Section 1.1
   1. Section 1.1.1
      1. Section 1.1.1.1
      2. Section 1.1.1.2
   2. Section 1.1.2
2. Section 1.2

Section 1

Section 1.1

Section 1.1.1

Section 1.1.1.1

Section 1.1.1.2

Section 1.1.2

Section 1.2

[Ryan J Ollos <ryano@…>]

I've taken a cut at a patch, and hoping to get some feedback since I have no doubts it will need some work.

There are no tests for the PageOutline macro in test/macros.py so I didn't add a test for the case of this new argument. If it is worthwhile to add some tests, I could take a try at that task as well.

[Ryan J Ollos <ryano@…>]

Patch #1

[Remy Blank]

Thanks for the patch.

[Remy Blank]

Patch applied (with cosmetic changes) in [10550].