markup icon indicating copy to clipboard operation
markup copied to clipboard

Published 20 hours ago • verified publisher icon github

Adjust initial_header_level for TOC

Open sjbronner opened this issue 8 years ago • 3 comments

The initial_header_level, set to 2, causes 2 problems:

  1. When including a TOC, it will have an empty first level, which just looks really bad.
  2. It differs from the way headings are handled in MarkDown.

sjbronner avatar Jul 05 '17 10:07 sjbronner

What's the issue

smokenasty4u avatar Oct 20 '17 08:10 smokenasty4u

The issue is not apparent on github because the generation of a table of contents is not available for restructuredText there. The issue appeared in my company's blog on pages written in restructuredText and looks something like this (table of contents):

    • First Section Title
    • Second Section Title
      • Subsection Title
      • Another Subsection Title
    • Third Section Title

It should look like this, and this is what results from my pull request:

  • First Section Title
  • Second Section Title
    • Subsection Title
    • Another Subsection Title
  • Third Section Title

sjbronner avatar Oct 20 '17 08:10 sjbronner

NToyKala

3572 avatar Feb 22 '18 01:02 3572

This pull request has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

github-actions[bot] avatar Dec 10 '24 12:12 github-actions[bot]

في ثلاثاء، 10 ديسمبر، 2024 في 3:11 م، كتب github-actions[bot] < @.***>:

This pull request has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

— Reply to this email directly, view it on GitHub https://github.com/github/markup/pull/1080#issuecomment-2531465179, or unsubscribe https://github.com/notifications/unsubscribe-auth/A66NWB4SIKMQOPAMULZFZQL2E3LALAVCNFSM6AAAAABTLAP4LKVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDKMZRGQ3DKMJXHE . You are receiving this because you are subscribed to this thread.Message ID: @.***>

10728811 avatar Dec 10 '24 12:12 10728811

@panderson02 You reviewed this issue in February, but it is still marked as "Review required". Is something missing?

sjbronner avatar Dec 11 '24 10:12 sjbronner

This pull request has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

github-actions[bot] avatar Feb 10 '25 12:02 github-actions[bot]